Panorama (ImageKit Control/ Effect Method)

This method composes a panorama image from two raster images.

[C++Builder] [ bool = ]imagekitcontrolname->Effect->Panorama(NativeUInt Handle1, NativeUInt Handle2, short CutMode, int Px11, int Py11, int Px12, int Py12, int Px21, int Py21, int Px22, int Py22, short Red, short Green, short Blue)

[Delphi] [ Boolean = ]imagekitcontrolname.Effect.Panorama(Handle1, Handle2: THandle; CutMode:Smallint; Px11, Py11, Px12, Py12, Px21, Py21, Px22, Py22: Integer; Red, Green, Blue: Smallint)

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 RGB value of the background color (from 0 to 255) This is the area of the panorama image that is not part of either Handle1 or Handle2
Green	Sets the green component of the RGB value of the background color (from 0 to 255) This is the area of the panorama image that is not part of either Handle1 or Handle2
Blue	Sets the blue component of the RGB value of the background color (from 0 to 255) This is the area of the panorama image that is not part of either Handle1 or Handle2

Return Value

Returns True if successful, otherwise returns False.

Explanation

The Panorama method composes a panorama from two raster images.

To execute the Panorama method, 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 Panorama method 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.

If successful the resulting raster image data is set in the LayerNo property (the ImageHandle property or the Layer(LayerNo).ImageHandle property. If unsuccessful, 0 is returned. Note: The memory blocks of the input images are not freed after this method is executed.

When the Caption, Message, and ButtonName properties are blank, the progress dialog box will not be displayed. When the progress dialog box is displayed, the percentage that the processing has completed will be shown in the dialog box.