imagegd

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

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

Описание

imagegd ( resource $image [, mixed $to = NULL ] ) : bool

Вывод GD-изображения в to.

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

image: Ресурс изображения, возвращаемый одной из функций создания изображений, например, такой как imagecreatetruecolor().
to: Путь, или открытый потоковый ресурс (который автоматически закрывается после завершения функции), для сохранения файла. Если не установлен или равен NULL, изображение будет выведено в поток вывода в бинарном виде.

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

Возвращает TRUE в случае успешного завершения или FALSE в случае возникновения ошибки.

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

Однако, если libgd не может вывести изображения, эта функция вернет TRUE.

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

Версия	Описание
7.2.0	Теперь imagegd() позволяет сохранять изображения "truecolor". Раньше они неявно преобразовывались к палитре.
5.4.0	Добавлена возможность использовать потоки типа resource для `to`.

Примеры

Пример #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);

// Освобождаем память
imagedestroy($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');

// Освобождаем память
imagedestroy($im);
?>

Примечания

Замечание:
Формат GD обычно используется для быстрой загрузки деталей изображения. Заметим, что формат GD используется только в GD-совместимых приложениях.

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

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