IKPanorama

This function composes a panorama from two raster images.

[C++Builder] HANDLE IKPanorama(HANDLE Handle1, HANDLE Handle2, BYTE CutMode, int Px11, int Py11, int Px12, int Py12, int Px21, int Py21, int Px22, int Py22, BYTE Red, BYTE Green, BYTE Blue, IKPROCESSPROC UserProc, LPCTSTR Caption, LPCTSTR Message, LPCTSTR Button);

[Delphi] function IKPanorama(Handle1, Handle2: THandle; CutMode: Byte; Px11, Py11, Px12, Py12, Px21, Py21, Px22, Py22: Integer; Red, Green, Blue: Byte; UserProc: LONG_PTR; Caption, Message, Button: PChar): THandle;

Parameters

Name	Explanation
Handle1	The handle of the image on which another image is attached (24 bit only)
Handle2	The handle of the image that is attached (24 bit only)
CutMode	Sets whether or not Handle2 will be cut at the attachment location and if so which portion of Handle2 will be cut For horizontal attachments (0: no cut, 1: cut left portion, 2: cut right portion) For vertical attachments (0: no cut, 1: cut lower portion, 2: cut upper portion)
Px11,Py11	The location of the first point of attachment for Handle1 (in pixels)
Px12,Py12	The location of the second point of attachment for Handle1 (in pixels)
Px21,Py21	The location of the first point of attachment for Handle2 (in pixels)
Px22,Py22	The location of the second point of attachment for Handle2 (in pixels)
Red	Sets the red component of the color painted in the area outside the lens (from 0 to255)
Green	Sets the green component of the color painted in the area outside the lens (from 0 to255)
Blue	Sets the blue component of the color painted in the area outside the lens (from 0 to255)
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 raster image handle if successful (24 bit image). Returns 0 if unsuccessful.

Explanation

The IKPanorama function composes a panorama from two raster images.

To execute the IKPanorama function, set the image handle of the base image into the Handle1 parameter. Set the image handle of the image you wish to attach to the base image into the Handle2 parameter. Set the attachment location on Handle1 and Handle2. The IKPanorama function will attach the Handle2 image to the Handle1 image at the location specified.

The CutMode parameter determines if any portion of Handle2 will be cut off. If CutMode=0 then no portion of Handle2 will be cut.

If the attachment is horizontal, i.e. the first attachment point is to the left of the second attachment point, then if CutMode=1, the portion of Handle2 to the left of the attachment location will be cut off. If CutMode=2, the portion of Handle2 to the right of the attachment location will be cut off.

If the attachment is vertical, i.e. the first attachment point is to the above the second attachment point, then if CutMode=1, the portion of Handle2 below the attachment location will be cut off. If CutMode=2, the portion of Handle2 above the attachment location will be cut off.

Note: the image handles passed to this function are NOT automatically freed after execution.

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 Ik10Effect.dll, Ik10EffectA.dll, Ik10Effect64.dll, Ik10Effect64A.dlll section.