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