imagechar

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

imagechar — Рисование символа по горизонтали

Описание

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

imagechar() рисует первый символ аргумента char на изображении с идентификатором image на координатах x,y (координаты отсчитываются с левого верхнего угла) цветом color.

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

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

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

Возвращает true в случае успешного выполнения или false, если возникла ошибка.

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

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

Примеры

Пример #1 Пример использования imagechar()

<?php

$im = imagecreate(100, 100);

$string = 'PHP';

$bg = imagecolorallocate($im, 255, 255, 255);
$black = imagecolorallocate($im, 0, 0, 0);

// печатает чёрный символ "P" в левом верхнем углу
imagechar($im, 1, 0, 0, $string, $black);

header('Content-type: image/png');
imagepng($im);

?>

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

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

imagecharup() - Рисование символа вертикально
imageloadfont() - Загрузка шрифта