imagestring

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

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

Описание

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

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

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

image

Объект GdImage, который вернула функция imagecreatetruecolor() или другая функция генерации изображений.

font

Принимает значения 1, 2, 3, 4, 5 для встроенных шрифтов в кодировке latin2 (более высокое число соответствует большему шрифту) или экземпляр класса GdFont, который возвращает функция imageloadfont().

x

Координата верхнего левого угла по оси x.

y

Координата верхнего левого угла по оси y.

string

Строка текста.

color

Идентификатор цвета, который добавила в палитру изображения функция imagecolorallocate().

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

Функция возвращает логическое значение true.

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

Версия Описание
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);

// Устанавливаем заголовок с MIME-типом изображения и выводим результат
header('Content-type: image/png');
imagepng($im);

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

Вывод примера: Изображение с отрисовкой текста функцией imagestring()

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

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