imagegd
(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. Они должны рассматриваться как устаревшие и должны использоваться только для целей разработки и тестирования.
Смотрите также
- imagegd2() - Вывод GD2 изображения в браузер или файл
add a note
