GdPictureImaging.CreateGdPictureImageFromFileICM Method

Creates a new GdPicture Image based on an image file. This function uses embedded color management (ICM).

public int CreateGdPictureImageFromFileICM(
    String FilePath
);

Visual Basic

Public Function CreateGdPictureImageFromFileICM(
    ByVal FilePath As String
) As Integer

Parameters

Parameters	Description
FilePath	The path of the file to open. If this parameter is empty, prompts the user to select a file.

Returns

0: The image could not created. Use the GetStat() function to determine the reason this function failed.

Non-zero: GdPicture Image Identifier. The created image.

Remarks

If success, set the created image as a GdPicture image.

Supported formats are RAW, PICT, BMP, DIB, RLE, ICO, EMF, WMF, GIF, ANIMATED GIF, JPEG, JPG, JPE, JFIF, PNG, TIFF, MULTIPAGE TIFF, PNM, PPM, PBM, PGM, PFM, RPPM, RPGM, RPBM, PCX, XPM, XBM, WBMP, TGA, SGI, Sun RAS, PSD, MNG, Kodak PhotoCD files, KOALA files, JP2, J2K, JNG, JBIG, IFF, HDR, Raw Fax G3, EXR, DDS and Dr. Halo files. 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.

Note for multipage images (TIFF and GIF):

By default, the class loads multipage images (GIF and TIFF) as read only.

If you want to open multipage images as read & write, you should the TiffOpenMultiPageForWrite() function for tiff files or the GifOpenMultiFrameForWrite() function for gif files.