Bitmap::FromFile method (gdiplusheaders.h)

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

Syntax

Bitmap * FromFile(
  [in] const WCHAR *filename,
  [in] BOOL        useEmbeddedColorManagement
);

Parameters

[in] filename

Type: const WCHAR*

Pointer to a null-terminated string that specifies the path name of the image file. The graphics file formats supported by GDI+ are BMP, GIF, JPEG, PNG, TIFF, Exif, WMF, and EMF.

[in] useEmbeddedColorManagement

Type: BOOL

Optional. Boolean value that specifies whether the new Bitmap 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: Bitmap*

This method returns a pointer to the new Bitmap object.

Requirements

Requirement Value
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

Bitmap Constructors

Image

Images, Bitmaps, and Metafiles

Using Images, Bitmaps, and Metafiles