(PHP 4 >= 4.0.7, PHP 5, PHP 7, PHP 8)
imagegd — Вывод GD-изображения в браузер или в файл
imageОбъект GdImage, который возвращает одна из функций, создающих изображения, например, imagecreatetruecolor().
fileПуть, или открытый потоковый ресурс (который автоматически закрывается после завершения функции), для сохранения файла. Если не установлен или равен null, изображение будет выведено в поток вывода в бинарном виде.
Функция возвращает true, если выполнилась успешно, или false, если возникла ошибка.
Однако,
если libgd не может вывести изображения, эта функция вернёт true.
| Версия | Описание |
|---|---|
| 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);
// Освобождаем память
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-совместимых приложениях.
Форматы изображений GD и GD2 являются проприетарными форматами изображений libgd. Они должны рассматриваться как устаревшие и должны использоваться только для целей разработки и тестирования.