imagettfbbox

(PHP 4, PHP 5, PHP 7, PHP 8)

imagettfbbox — Отримання параметрів рамки, що обрамляє текст написаний TrueType шрифтом

Опис

imagettfbbox(    float $size,    float $angle,    string $font_filename,    string $string,    array $options = []): array|false

Ця функція розраховує та повертає параметри рамки навколо тексту TrueType у пікселах.

Зауваження :

До PHP 8.0.0imageftbbox() - це розширений варіант imagettfbbox() який додатково підтримує extrainfo. Починаючи з PHP 8.0.0, **imagettfbbox()**является псевдонимомimageftbbox()

Список параметрів

size

Розмір шрифту у типографських пунктах.

angle

Кут у градусах у якому буде виміряний string

fontfile

Шлях до шрифту TrueType, який потрібно використовувати.

Залежно від того, яка бібліотека GD завантажена в PHP, якщо параметр fontfile не починається із символу , то к имени файла будет добавлено расширение.ttf і бібліотека намагатиметься шукати це ім'я файлу за певною бібліотекою шляху шрифтів.

При роботі з бібліотекою GD версії нижче 2.0.18 як роздільник шляхів для різних файлів шрифтів буде використано символ пробілу, а не крапка з комою. Ненавмисне використання цієї особливості призведе до попередження: Warning: Could not find/open font. Єдиним коректним рішенням для цих версій бібліотек буде переміщення файлів шрифтів до директорії, що не містить пробілів.

У багатьох випадках, коли шрифт знаходиться в тому ж каталозі, що і PHP скрипт, допоможе наступний трюк.

Loading...
▶

Зауваження :

Обратите внимание, чтоopen_basedir неприменяется кfontfile

string

Вимірюваний рядок.

Значення, що повертаються

imagettfbbox() повертає масив з 8 елементів, що представляють координати чотирьох точок - вершин рамки навколо тексту. У разі помилки функція поверне false

ключ	содержимое
	нижній лівий кут, X координата
	нижній лівий кут, Y координата
	нижній правий кут, X координата
3	нижній правий кут, Y координата
4	верхній правий кут, X координата
5	верхній правий кут, Y координата
6	верхній лівий кут, X координата
7	верхній лівий кут, Y координата

Крапки розраховані щодо тексту textи независимо от углаangle. . Тобто верхній лівий означає верхній лівий кут, якщо дивитися на текст горизонтально.

список змін

Версия	Опис
8.0.0	Добавлен параметрoptions

Приклади

Приклад #1 Приклад використання imagettfbbox()****

Loading...
▶

Примітки

Зауваження: Ця функція доступна лише у випадку, якщо PHP був скомпільований з підтримкою freetype (--with-freetype-dir=DIR) .

Дивіться також

• imagettftext() - Малювання тексту на зображенні шрифтом TrueType
• imageftbbox() - Визначення меж тексту, що виводиться шрифтом freetype2