imagegd2
(PHP 4 >= 4.0.7, PHP 5, PHP 7)
imagegd2 — Вывод GD2 изображения в браузер или файл
Описание
$image
, mixed $to
= NULL
, int $chunk_size
= 128
, int $type
= IMG_GD2_RAW
) : bool
Выводит GD2 изображение в заданный файл to
.
Список параметров
-
image
-
Ресурс изображения, возвращаемый одной из функций создания изображений, например, такой как imagecreatetruecolor().
-
to
-
Путь, или открытый потоковый ресурс (который автоматически закрывается после завершения функции), для сохранения файла. Если не установлен или равен
null
, изображение будет выведено в поток вывода в бинарном виде. -
chunk_size
-
Размер части изображения.
-
type
-
Либо
IMG_GD2_RAW
, либоIMG_GD2_COMPRESSED
. По умолчаниюIMG_GD2_RAW
.
Возвращаемые значения
Возвращает true
в случае успешного завершения или false
в случае возникновения ошибки.
Однако, если libgd не может вывести изображения, эта функция вернет true
.
Примеры
Пример #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. Они должны рассматриваться как устаревшие и должны использоваться только для целей разработки и тестирования.
Смотрите также
- imagegd() - Вывод GD-изображения в браузер или в файл