imagefttext
(PHP 4 >= 4.0.7, PHP 5, PHP 7, PHP 8)
imagefttext — Нанесення тексту на зображення за допомогою шрифтів FreeType 2
Опис
imagefttext( GdImage $image, float $size, float $angle, int $x, int $y, int $color, string $font_filename, string $text, array $options = []): array|false
Зауваження :
До PHP 8.0.0imagefttext() - це розширений варіант imagettftext(), який додатково підтримує
extrainfo. Починаючи з PHP 8.0.0, imagettftext()является псевдонимомimagefttext()
Список параметрів
image
Об'єкт GdImage, що повертається однією з функцій створення зображень, наприклад, такий як imagecreatetruecolor()
size
Розмір шрифту у пунктах.
angle
Кут у градусах, 0 градусів означає розташування тексту зліва направо. Позитивні значення означає поворот тексту проти годинникової стрілки. Наприклад, текст, повернутий на 90 градусів, потрібно буде читати знизу вгору.
x
Координати xиy визначають відправну точку першого символу тексту (конкретно, лівий нижній кут символу). Тут є відмінність від функції imagestring(), в якій xиy визначають лівий верхній кут першого символу. Наприклад, верхній лівий має координати 0,0.
y
y-координат. Це позиція базової лінії шрифту, у випадку вона не збігається з нижчою точкою в символі.
color
Индекс требуемого цвета текста, смотритеimagecolorexact()
font_filename
Шлях до TrueType шрифту, який потрібно використовувати.
Залежно від версії GD бібліотеки якщо font_filename не починається з , то в конец названия файла будет добавлено расширение.ttf, та бібліотека намагатиметься знайти цей файл за адресою, визначеною в налаштуваннях бібліотеки.
Найчастіше розміщення файлів шрифтів у директорії скрипта вирішує подібні проблеми включення файлів.
text
Текст для вставлення зображення.
options
Можливі значення масиву options
| Ключ | Тип | Значение |
|---|---|---|
linespacing | float | Визначає малювання нижнього підкреслення |
Значення, що повертаються
Ця функція повертає масив, який визначає чотири точки рамки тексту. Текст усередині цих кордонів починається з лівого нижнього кута і повертається проти годинникової стрілки:
| 0 | нижняя левая x-координата |
| 1 | нижняя левая y-координата |
| 2 | нижняя правая x-координата |
| 3 | нижняя правая y-координата |
| 4 | верхняя правая x-координата |
| 5 | верхняя правая y-координата |
| 6 | верхняя левая x-координата |
| 7 | верхняя левая y-координата |
У разі виникнення помилки повертає false
список змін
| Версия | Опис |
|---|---|
| 8.0.0 | image тепер чекає екземпляр GdImage; раніше очікувався коректний gd ресурс (Resource). |
Приклади
Приклад #1 Приклад використання imagefttext()****
Примітки
Зауваження: Ця функція доступна лише у випадку, якщо PHP був скомпільований з підтримкою freetype (--with-freetype-dir=DIR) .
Дивіться також
- imageftbbox() - Визначення меж тексту, що виводиться шрифтом freetype2
- imagettftext() - Малювання тексту на зображенні шрифтом TrueType