ImageCreateFromGif

ImageCreateFromGif -- create a new image from file or URL

Description

int imagecreatefromgif(string filename);

imagecreatefromgif() returns an image identifier representing the image obtained from the given filename.

imagecreatefromgif() returns an empty string on failure. It also outputs an error message, which unfortunately displays as a broken link in a browser. To ease debugging the following example will produce an error GIF:

Example 1. Example to handle an error during creation (courtesy vic@zymsys.com )

  1 
  2 function LoadGif($imgname)
  3 {
  4   $im = @imagecreatefromgif($imgname); /* Attempt to open */
  5   if ($im == "") { /* See if it failed */
  6     $im = ImageCreate(150,30); /* Create a blank image */
  7     $bgc = ImageColorAllocate($im,255,255,255);
  8     $tc  = ImageColorAllocate($im,0,0,0);
  9     ImageFilledRectangle($im,0,0,150,30,$bgc);
 10     ImageString($im,1,5,5,"Error loading $imgname",$tc); /* Output an errmsg */
 11   }
 12   return $im;
 13 }
 14 

Note: Since all GIF support was removed from the GD library in version 1.6, this function is not available if you are using that version of the GD library.