Image::FromFile method

The Image::FromFile method creates an Image object based on a file.

Syntax

Image * FromFile(
  IN const WCHAR *filename,
  IN BOOL        useEmbeddedColorManagement
);

Parameters

filename

Type: const WCHAR*

Pointer to a wide-character string that specifies the name of the file.

useEmbeddedColorManagement

Type: BOOL

Optional. Boolean value that specifies whether the new Image object applies color correction according to color management information that is embedded in the image file. Embedded information can include International Color Consortium (ICC) profiles, gamma values, and chromaticity information. TRUE specifies that color correction is enabled, and FALSE specifies that color correction is not enabled. The default value is FALSE.

Return Value

Type: Type: Image*

This method returns a pointer to the new Image object.

Remarks

You can create Image objects based on files of a variety of types including BMP, GIF, JPEG, PNG, TIFF, and EMF.

Requirements

   
Minimum supported client Windows XP, Windows 2000 Professional [desktop apps only]
Minimum supported server Windows 2000 Server [desktop apps only]
Target Platform Windows
Header gdiplusheaders.h (include Gdiplus.h)
Library Gdiplus.lib
DLL Gdiplus.dll

See Also

Bitmap

Drawing, Positioning, and Cloning Images

Image

Image Constructors

Image::Clone

Image::FromStream

Loading and Displaying Bitmaps