Loads a FreeImage bitmap. In case the loading format is FIF_UNKNOWN the files real format is being analysed. If no plugin can read the file, format remains FIF_UNKNOWN and 0 is returned. Load flags can be provided by the flags parameter.

Namespace:  FreeImageAPI
Assembly:  FreeImageNET (in FreeImageNET.dll)

Syntax

C#
public static FIBITMAP LoadEx(
	string filename,
	FREE_IMAGE_LOAD_FLAGS flags,
	ref FREE_IMAGE_FORMAT format
)
Visual Basic (Declaration)
Public Shared Function LoadEx ( _
	filename As String, _
	flags As FREE_IMAGE_LOAD_FLAGS, _
	ByRef format As FREE_IMAGE_FORMAT _
) As FIBITMAP
Visual C++
public:
static FIBITMAP LoadEx(
	String^ filename, 
	FREE_IMAGE_LOAD_FLAGS flags, 
	FREE_IMAGE_FORMAT% format
)

Parameters

filename
Type: System..::.String
The complete name of the file to load.
flags
Type: FreeImageAPI..::.FREE_IMAGE_LOAD_FLAGS
Flags to enable or disable plugin-features.
format
Type: FreeImageAPI..::.FREE_IMAGE_FORMAT %
Format of the image. If the format is unknown use FIF_UNKNOWN. In case a suitable format was found by LoadEx it will be returned in format.

Return Value

Handle to a FreeImage bitmap.

Exceptions

ExceptionCondition
System.IO..::.FileNotFoundException filename does not exists.

Version Information

FreeImage.NET

Supported in: 3.11.0, 3.12.0, 3.13.0, 3.13.1

See Also