imagecreatefromgif

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

imagecreatefromgifCreate a new image from file or 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

Puede utilizar una URL como nombre de archivo con esta función, si el gestor fopen ha sido activado. Véase fopen() para más detalles sobre cómo especificar el nombre del archivo. Consulte Protocolos y Envolturas soportados para más información sobre las capacidades de los diferentes gestores, las notas sobre su uso, así como la información sobre las variables predefinidas que proporcionan.

Parámetros

filename

Ruta hacia la imagen GIF.

Valores devueltos

Returns an image object on success, false on errors.

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);
?>

Resultado del ejemplo anterior es similar a :

Visualización del ejemplo: imagecreatefromgif()