ImageEn, unit imageenio

TImageEnIO.LoadFromFile

TImageEnIO.LoadFromFile


Declaration


function LoadFromFile(const FileName: WideString; bCheckUnknown: Boolean = True): Boolean; overload;
function LoadFromFile(const FileName: WideString; FileFormat: TIOFileType): Boolean; overload;


Description


Loads an image from the specified file. It recognizes the image format from the filename extension (if ImageFormat is not specified).
The source can be also an URL if it has the form 'http://'.

FileName is the file name including extension.
FileFormat specifies the image format. If specified as ioUnknown, it will use the file's extension.
bCheckUnknown if the file extension is not known or is incorrect (e.g. a GIF file named MyImage.jpg), then loading will be attempted by analyzing the file content (in the same way as LoadFromFileAuto)

Result will be false if the file is not a recognized file type (and Aborting will be true). Loading errors due to a file not being available will raise an exception.

Notes:
- You can abort loading by setting Aborting to true
- By default, this routine will fail for files with an invalid extension (e.g. a GIF file named MyImage.jpg) or unknown extension. To avoid this you can use the bCheckUnknown overload or LoadFromFileAuto
- Can load IEV (TImageEnVect objects) and IEN+IEV formats when AttachedImageEn is TImageEnView or TImageEnVect.


Example


// Load the second image in the MyImage.tif file
ImageEnView1.IO.Params.TIFF_ImageIndex := 1;
ImageEnView1.IO.LoadFromFile('D:\MyImage.tif');

// Load a file even if this file extension is incorrect
ImageEnView1.IO.LoadFromFile(sFilename, True);


See Also


- LoadFromFileAuto
- WicFastLoading
- Aborting