Image::Image(constWCHAR*,BOOL) method (gdiplusheaders.h)

Creates an Image::Image object based on a file.

Syntax

void Image(
  [in] const WCHAR *filename,
  [in] BOOL        useEmbeddedColorManagement
);

Parameters

[in] filename

Type: const WCHAR*

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

[in] useEmbeddedColorManagement

Type: BOOL

Optional. Boolean value that specifies whether the new Image::Image object applies color correction according to color management information that is embedded in the image file. Embedded information can include ICC profiles, gamma values, and chromaticity information.

FALSE

Default. Specifies that color correction is enabled

TRUE

Specifies that color correction is not enabled

Return value

None

Remarks

You can construct Image::Image objects based on files of a variety of types including BMP, Graphics Interchange Format (GIF), JPEG, PNG, TIFF, and EMF.

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

Drawing, Positioning, and Cloning Images

Image

Image Constructors

Image::Clone

Image::FromFile

Image::FromStream

Loading and Displaying Bitmaps