See Also Examples Applies To
Creates a new GdPicture Image based on an image file. This function uses embedded color management (ICM).
Syntax
object.CreateImageFromFileICM (sFilePath)
The CreateImageFromFileICM syntax has these parts:
| Part | Description |
| object | Required. An object expression that evaluates to an object in the Applies To list. |
| sFilePath | Required. String. The path of the file to open. If this parameter is empty, prompts the user to select a file. |
Returns
Long.
0: The image could not created. Use the GetStat() function to determine the
reason this function failed.
Non-zero: GdPicture Image handle. Handle of the created image.
Remarks
If success, set the created image as the native GdPicture image.
Supported formats are BMP, DIB, RLE, ICO, EMF, WMF, GIF, ANIMATED GIF, JPEG, JPG, JPE, JFIF, PNG, TIFF, MULTIPAGE TIFF, PNM, PPM, PBM, PFM, PGM, RPPM, RPGM, RPBM, PCX.
Redistributing the optional gdimgplug.dll library you will also be able to read XPM, XBM, WBMP, TGA, SGI, RAW, PICT, 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) for reading and writing creating a GdPicture image marked as editable multipage.
However this way is a bit slower than creating a GdPicture image marked as non editable multipage.
If you want to open multipage images as read only, you should call the TiffOpenMultiPageAsReadOnly() function for tiff files or the GifOpenMultiPageAsReadOnly() function for gif files.
Category
Load, Import & Create an image