Выводит GD-изображение в браузер или файл

# imagegd

(PHP 4 >= 4.0.7, PHP 5, PHP 7, PHP 8)

imagegd — Выводит GD-изображение в браузер или файл

### Описание

function imagegd(GdImage `$image`, ?string `$file` = `null`): bool

Функция выводит или сохраняет изображение в формате GD, которое указали в параметре `image`.

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

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

  Путь или ресурс открытого потока, который функция автоматически закрывает после возврата значения, для сохранения файла. Функция выведет поток необработанного изображения напрямую, если параметр не установили или передали в аргументе значение `null`.

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

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

Предостережение

Функция вернёт значение `true`, если вывести изображение средствами библиотеки libgd невозможно.

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

Версия | Описание
--- | ---
8.0.3 | Параметр `file` теперь принимает значение `null`.
8.0.0 | Параметр `image` теперь принимает объект GdImage; раньше параметр принимал корректный `gd`-ресурс (resource).
7.2.0 | Функция imagegd() теперь разрешает выводить полноцветные truecolor-изображения. Раньше функция неявно преобразовывала такие изображения к палитре.

### Примеры

Пример #1 Пример вывода GD-изображения

    <?php

    // Создаём пустое изображение и добавляем текст
    $im = imagecreatetruecolor(120, 20);
    $text_color = imagecolorallocate($im, 233, 14, 91);
    imagestring($im, 1, 5, 5,  "A Simple Text String", $text_color);

    // Выводим изображение
    imagegd($im);

    ?>

Пример #2 Пример сохранения GD-изображения

    <?php

    // Создаём пустое изображение и добавляем текст
    $im = imagecreatetruecolor(120, 20);
    $text_color = imagecolorallocate($im, 233, 14, 91);
    imagestring($im, 1, 5, 5,  "A Simple Text String", $text_color);

    // Сохраняем GD-изображение.
    // Файлы GD-изображений сохраняют в формате .gd,
    // подробнее о формате файлов рассказывает страница http://www.libgd.org/GdFileFormats
    imagegd($im, 'simple.gd');

    ?>

### Примечания

> Замечание:

> В формате GD часто быстро загружают части изображений. Обратите внимание, что формат GD поддерживают только GD-совместимые приложения.

Внимание

Форматы GD и GD2 — проприетарные форматы изображений библиотеки libgd. Форматы устарели и применяются только в целях разработки и тестирования.

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

- imagegd2() - Выводит GD2-изображение в браузер или файл

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