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);

?>

Результатом выполнения данного примера будет что-то подобное:

Вывод примера: imagechar()

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