(PHP 4 >= 4.0.7, PHP 5, PHP 7, PHP 8)
imagegd2 — Вывод GD2 изображения в браузер или файл
$image
,$file
= null
,$chunk_size
= 128,$mode
= IMG_GD2_RAW
Выводит GD2 изображение в заданный файл file
.
image
Объект GdImage, возвращаемый одной из функций создания изображений, например, такой как imagecreatetruecolor().
file
Путь, или открытый потоковый ресурс (который автоматически закрывается после завершения функции), для сохранения файла. Если не установлен или равен null
, изображение будет выведено в поток вывода в бинарном виде.
chunk_size
Размер части изображения.
mode
Либо IMG_GD2_RAW
, либо
IMG_GD2_COMPRESSED
. По умолчанию
IMG_GD2_RAW
.
Возвращает true
в случае успешного выполнения или false
в случае возникновения ошибки.
Однако, если libgd не может вывести изображения, эта функция вернёт true
.
Версия | Описание |
---|---|
8.0.3 |
file теперь допускает значение null.
|
8.0.0 |
image теперь ожидает экземпляр GdImage;
ранее ожидался корректный gd ресурс (resource).
|
Пример #1 Вывод GD2 изображения
<?php
// Создание пустого изображения и добавление на него текста
$im = imagecreatetruecolor(120, 20);
$text_color = imagecolorallocate($im, 233, 14, 91);
imagestring($im, 1, 5, 5, "Простая Текстовая Строка", $text_color);
// Вывод изображения
imagegd2($im);
// Освобождение памяти
imagedestroy($im);
?>
Пример #2 Сохранение GD2 изображения
<?php
// Создание пустого изображения и добавление на него текста
$im = imagecreatetruecolor(120, 20);
$text_color = imagecolorallocate($im, 233, 14, 91);
imagestring($im, 1, 5, 5, "Простая Текстовая Строка", $text_color);
// Сохранение изображения
// Формат файлов GD2 - .gd2, смотрите http://www.libgd.org/GdFileFormats
imagegd2($im, 'simple.gd2');
// Освобождение памяти
imagedestroy($im);
?>
Замечание:
Формат GD2 используется в основном для быстрой загрузки частей изображений. Следует учитывать, что GD2 формат может использоваться только в GD2-совместимых приложениях.
Форматы изображений GD и GD2 являются проприетарными форматами изображений libgd. Они должны рассматриваться как устаревшие и должны использоваться только для целей разработки и тестирования.