ImageEn, unit imageenio

TImageEnIO.LoadFromFileGIF

TImageEnIO.LoadFromFileGIF


Declaration

function LoadFromFileGIF(const FileName: WideString): integer;


Description

Loads an image from a GIF file (87a, 89a or animated GIF).

FileName is the file name including extension.

Returns the number of images contained in GIF file (if this is an animated GIF) or -1 if an error was encountered while loading, such as the file not being GIF format (Aborting will be true). Loading errors due to a file not being available will raise an exception.

Note:
 You can abort loading by setting Aborting to true
 If AsyncMode=True the result will always be -1
 If you are loading from a multi-frame GIF, enable GIFFrameCaching to speed up loading
 By default, GIF_RawLoad is enabled, so the frame returned will be merged to ensure it is a valid image (contains needed content from prior frames)


Example

// Loads the third frame of an animated gif
ImageEnView1.IO.Params.GIF_ImageIndex := 2;
ImageEnView1.IO.LoadFromFileGIF('D:\anim.gif');


See Also

 LoadFromStreamGIF
 SaveToFileGIF
 InsertToFileGIF
 ReplaceFileGIF
 GIF_ImageIndex
 GIF_ImageCount
 EnumGifIm (Image Count)
 CheckAniGIF
 Global Image Methods