IKCreateImage

This function creates a new raster image.

[C++Builder] HANDLE IKCreateImage(long Width, long Height, short BitCount, BYTE Red, BYTE Green, BYTE Blue, IKPROCESSPROC UserProc, LPCTSTR Caption, LPCTSTR Message, LPCTSTR Button);

[Delphi] function IKCreateImage(Width, Height: Longint; BitCount: Smallint; Red, Green, Blue: Byte; UserProc: LONG_PTR; Caption, Message, Button: PChar): THandle;

Parameters

Name	Explanation
Width	The width of the created image in pixels
Height	The height of the created image in pixels
BitCount	The bit count of the created image (1, 4, 8, 16, 24, 32, 40, 80) * 4 represents 4 bit color, 40 is for 4 bit grayscale, 8 is for 8 bit color, and 80 is for 8 bit grayscale
Red	The red value of the color in the created image ( from 0 to 255)
Green	The green value of the color in the created image ( from 0 to 255)
Blue	The blue value of the color in the created image ( from 0 to 255)
UserProc	The address of the user function (set to 0 if the user function is not used)
Caption	The text displayed in the title bar of the progress dialog box
Message	The message displayed in the center of the progress dialog box
Button	The text displayed in the button in the progress dialog box

Return Value

If successful, the image handle of the created raster image is returned. If unsuccessful, 0 is returned

Explanation

The IKCreateImage function creates a new raster image in the memory. Depending on the bit count of the created image, the RGB values set in the Red, Green, and Blue parameters may not be effective. In such cases, the nearest values will be assigned. (For images with bit counts higher than 24, the RGB values are effective as they are.)

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 functions please refer to the Definition of User Function in the Ik9Com.dll, Ik9ComA.dll, Ik9Com64.dll, Ik9Com64A.dll section.