imagecreatefromgif

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

imagecreatefromgifCrea una nueva imagen a partir de un fichero o de una URL

Descripción

imagecreatefromgif(string $filename): GdImage|false

imagecreatefromgif() devuelve un identificador de imagen que representa la imagen obtenida a partir del fichero cuyo nombre es dado por filename.

Precaución

Al leer en memoria ficheros GIF animados, solo el primer frame es devuelto por el objeto de la imagen. El tamaño de la imagen no es necesariamente el que se reporta mediante getimagesize().

Sugerencia

Se puede emplear un URL como nombre de fichero con esta función si las envolturas de fopen han sido activadas. Véase fopen() para más información de cómo especificar el nombre de fichero. Véanse las Protocolos y Envolturas soportados; continen enlaces con información sobre las diferentes capacidades que tienen las envolturas, notas sobre su empleo, e información de cualquier variable predefinida que podría proporcionarse.

Parámetros

filename

Ruta hacia la imagen GIF.

Valores devueltos

En caso de éxito, devuelve un identificador de recurso de imagen, y false en caso de error.

Historial de cambios

Versión Descripción
8.0.0 En caso de éxito, esta función devuelve ahora una instancia de GDImage ; anteriormente, se devolvía un resource.

Ejemplos

Ejemplo #1 Ejemplo de manejo de errores al cargar una imagen GIF

<?php
function LoadGif($imgname)
{
/* Intenta abrir la imagen */
$im = @imagecreatefromgif($imgname);

/* Procesamiento si la apertura falló */
if(!$im)
{
/* Creación de una imagen vacía */
$im = imagecreatetruecolor (150, 30);
$bgc = imagecolorallocate ($im, 255, 255, 255);
$tc = imagecolorallocate ($im, 0, 0, 0);

imagefilledrectangle ($im, 0, 0, 150, 30, $bgc);

/* Muestra un mensaje de error en la imagen */
imagestring ($im, 1, 5, 5, 'Error loading ' . $imgname, $tc);
}

return
$im;
}

header('Content-Type: image/gif');

$img = LoadGif('bogus.image');

imagegif($img);
?>

El resultado del ejemplo sería algo similar a:

Visualización del ejemplo: imagecreatefromgif()