(PHP 4, PHP 5, PHP 7, PHP 8)
imagegif — Выводит изображение в браузер или записывает в файл
Функция imagegif() создаёт изображение в формате GIF
в файле или ресурсе потока, который указали в аргументе file.
Функция берёт за основу изображение image.
Аргумент image — изображение, которое возвращает
функция imagecreate() или функции семейства
imagecreatefrom*.
Функция создаст файл в формате GIF87a, если только изображение не сделали прозрачным функцией imagecolortransparent(), тогда функция создаст изображение в формате GIF89a.
imagefileПуть или ресурс открытого потока, который функция автоматически закрывает
после возврата значения, для сохранения файла. Функция выведет поток необработанного изображения напрямую,
если параметр не установили или передали в аргументе значение null.
Функция возвращает true, если выполнилась успешно, или false, если возникла ошибка.
Функция вернёт значение true, если вывести изображение средствами библиотеки libgd невозможно.
| Версия | Описание |
|---|---|
| 8.0.0 |
Параметр image теперь принимает объект GdImage;
раньше параметр принимал корректный gd-ресурс (resource).
|
Пример #1 Пример вывода изображения функцией imagegif()
<?php
// Создание изображения
$im = imagecreatetruecolor(100, 100);
// Создание белого фона
imagefilledrectangle($im, 0, 0, 99, 99, 0xFFFFFF);
// Отрисовка текста на изображении
imagestring($im, 3, 40, 20, 'GD библиотека', 0xFFBA00);
// Вывод изображения в браузер
header('Content-Type: image/gif');
imagegif($im);
?>Пример #2 Пример преобразования PNG-изображения в формат GIF функцией imagegif()
<?php
// Загрузка PNG-файла
$png = imagecreatefrompng('./php.png');
// Сохранение файла в формате GIF
imagegif($png, './php.gif');
// Готово
echo 'Преобразование PNG-файла в GIF-файл завершилось успешно!';
?>Замечание:
Следующий фрагмент кода помогает писать переносимые PHP-приложения и автоматически определяет доступный тип GD-изображения. Замените строки
header ("Content-Type: image/gif"); imagegif ($im);на более гибкую последовательность:<?php
// Создание нового изображения
$im = imagecreatetruecolor(100, 100);
// Какие-либо операции с изображением
// Обработка вывода
if (function_exists('imagegif')) {
// Для GIF-файлов
header('Content-Type: image/gif');
imagegif($im);
} elseif (function_exists('imagejpeg')) {
// Для JPEG-файлов
header('Content-Type: image/jpeg');
imagejpeg($im, NULL, 100);
} elseif (function_exists('imagepng')) {
// Для PNG-файлов
header('Content-Type: image/png');
imagepng($im);
} elseif (function_exists('imagewbmp')) {
// Для WBMP-файлов
header('Content-Type: image/vnd.wap.wbmp');
imagewbmp($im);
} else {
die('На этом PHP-сервере нет поддержки изображений');
}
?>
Замечание:
Проверить поддержку формата помогает функция imagetypes():
<?php
if (imagetypes() & IMG_GIF) {
header('Content-Type: image/gif');
imagegif($im);
} elseif (imagetypes() & IMG_JPG) {
/* ... и т. д. */
}
?>