imagegif

(PHP 4, PHP 5, PHP 7, PHP 8)

imagegif — Вивід зображення в браузер чи файл.

Опис

function imagegif(GdImage $image, resource|string|null $file = null): bool

imagegif() creates the GIF file in file from the image image. The image argument is the return from the imagecreate() or imagecreatefrom* function.

The image format will be GIF87a unless the image has been made transparent with imagecolortransparent(), in which case the image format will be GIF89a.

Параметри

image: Об'єкт GdImage, що повертається однією з функцій створення зображення, такою як imagecreatetruecolor().
file: Шлях або відкритий ресурс потоку (котрий автоматично закривається після повернення з цієї функції) для збереження файла. Якщо не встановлено або дорівнює null, буде виведено двійковий код зображення.

Значення, що повертаються

Повертає true у разі успіху або false в разі помилки.

Застереження

Проте, якщо libgd не може вивести зображення, ця функція повертає true.

Журнал змін

Версія	Опис
8.0.0	Тепер `image` має бути примірником GdImage. Раніше очікувався `gd`-resource.

Приклади

Приклад #1 Outputting an image using imagegif()

<?php
// Create a new image instance
$im = imagecreatetruecolor(100, 100);

// Make the background white
imagefilledrectangle($im, 0, 0, 99, 99, 0xFFFFFF);

// Draw a text string on the image
imagestring($im, 3, 40, 20, 'GD Library', 0xFFBA00);

// Output the image to browser
header('Content-Type: image/gif');

imagegif($im);
?>

Приклад #2 Converting a PNG image to GIF using imagegif()

<?php

// Load the PNG
$png = imagecreatefrompng('./php.png');

// Save the image as a GIF
imagegif($png, './php.gif');

// We're done
echo 'Converted PNG image to GIF with success!';
?>

Примітки

Зауваження:

The following code snippet allows you to write more portable PHP applications by auto-detecting the type of GD support which is available. Replace the sequence header ("Content-Type: image/gif"); imagegif ($im); by the more flexible sequence:

<?php
// Create a new image instance
$im = imagecreatetruecolor(100, 100);

// Do some image operations here

// Handle output
if(function_exists('imagegif'))
{
    // For GIF
    header('Content-Type: image/gif');

    imagegif($im);
}
elseif(function_exists('imagejpeg'))
{
    // For JPEG
    header('Content-Type: image/jpeg');

    imagejpeg($im, NULL, 100);
}
elseif(function_exists('imagepng'))
{
    // For PNG
    header('Content-Type: image/png');

    imagepng($im);
}
elseif(function_exists('imagewbmp'))
{
    // For WBMP
    header('Content-Type: image/vnd.wap.wbmp');

    imagewbmp($im);
}
else
{
    die('No image support in this PHP server');
}
?>

Зауваження:
You can use the function imagetypes() for checking the presence of the various supported image formats:
<?php
if(imagetypes() & IMG_GIF)
{
    header('Content-Type: image/gif');
    imagegif($im);
}
elseif(imagetypes() & IMG_JPG)
{
    /* ... etc. */
}
?>

Прогляньте також

imagepng() - Output a PNG image to either the browser or a file
imagewbmp() - Вивід зображення в браузер чи файл.
imagejpeg() - Вивід зображення в браузер чи файл.
imagetypes() - Return the image types supported by this PHP build