This function loads raw image data.
Parameters
| Name | Explanation |
|---|---|
| Handle | The raw image data to be loaded |
| Page | The page number of the file that is loaded into the memory (starts from 0) |
| Width | The width of the loaded image (in pixels) |
| Height | The height of the loaded image (in pixels) |
| UserProc | The address of the user function (If not using the user function then set to 0) |
| Caption | Sets the text displayed in the title bar of the progress dialog box |
| Message | Sets the message displayed in the progress dialog box |
| Button | Sets the name of the button displayed in the progress dialog box |
Return Value
Returns the image handle of the raster image or vector image if successful. Returns 0 if unsuccessful.
Explanation
The IKFileLoadMem function loads raw image data. This function automatically recognizes the following formats: BMP, DXF, EMF, FPX, GIF, JPEG, JPEG200, PCX, PNG, SXF, SVG, TIFF, and WMF. NOTE: For TIFF(JPEG Compression), some TIFF(JPEG) images cannot be loaded by the ImageKit.
When loading multi-page image files or multi-resolution image files (FPX), the Page parameter determines which page will be loaded. If the image is a single page image file then the Page parameter is disabled. When loading a raster image, the values in the Width and Height parameters are ignored. These parameters are only enabled when loading vector images. If the Width parameter is 0 or less and the image is DXF, SXF, or WMF, then the default image width of 800 is used. If the image is EMF or SVG then the width is retrieved from the EMF or SVG raw data. Likewise, if the Height parameter is 0 or less and the image is DXF, SXF, or WMF, then the default image height of 600 is used. If the image is EMF or SVG then the Height is retrieved from the EMF or SVG raw data.
If the user function is set or if the Caption, Message, and Button parameters are blank then the Progress dialog box is not displayed. If the Progress dialog box is displayed, it indicates the percentage of the current process completed. For more information about the user function please refer to the Definition of User Function in the Ik10File.dll, Ik10FileA.dll, Ik10File64.dll, Ik10File64A.dll section.
Except for the fact that the vector image is loaded from raw image data, this function operates in the same way as the IKFileLoad function.
To execute this function, you must first execute the Ik10VectCom.dll, Ik10VectComA.dll, Ik10VectCom64.dll, and Ik10VectCom64A.dll's IKVectorGdipStart function.
Note: When a vector image is loaded, the ratio of the height and width of the original image is maintained and the largest pixel size of the image is scaled within the area defined by the Height and Width parameters.