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

# imagestring

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

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

### Описание

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

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

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

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

`↑` and `↓` to navigate • `Enter` to select • `Esc` to close • `/` to open