imagestring

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

imagestring — Рисует строку текста горизонтально

Описание

imagestring(
    GdImage $image,
    GdFont|int $font,
    int $x,
    int $y,
    string $string,
    int $color
): bool

Функция рисует текст string на заданных координатах.

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

image: Объект GdImage, который возвращает одна из функций, создающих изображения, например, imagecreatetruecolor().
font: Принимает значения 1, 2, 3, 4, 5 для встроенных шрифтов в кодировке latin2 (более высокое число соответствует большему шрифту) или экземпляр класса GdFont, который возвращает функция imageloadfont().
x: x-координата верхнего левого угла.
y: y-координата верхнего левого угла.
string: Строка текста.
color: Идентификатор цвета, созданный функцией imagecolorallocate().

Возвращаемые значения

Функция возвращает true, если выполнилась успешно, или false, если возникла ошибка.

Список изменений

Версия	Описание
8.1.0	Параметр `font` теперь принимает как экземпляр класса GdFont, так и целое число (int); раньше параметр принимал только целое число (int).
8.0.0	Параметр `image` теперь ожидает экземпляр класса GdImage; раньше параметр ждал корректный `gd`-ресурс (resource).

Примеры

Пример #1 Пример горизонтальной отрисовки строки текста функцией imagestring()

<?php

// Создание изображения размером 100*30
$im = imagecreate(100, 30);

// Установка белого фона и синего текста
$bg = imagecolorallocate($im, 255, 255, 255);
$textcolor = imagecolorallocate($im, 0, 0, 255);

// Надпись в левом верхнем углу
imagestring($im, 5, 0, 0, 'Hello world!', $textcolor);

// Вывод изображения
header('Content-type: image/png');

imagepng($im);

?>

Вывод приведённого примера будет похож на:

Смотрите также

imagestringup() - Рисует строку текста вертикально
imageloadfont() - Загружает новый шрифт
imagettftext() - Рисует текст на изображении шрифтом TrueType