Panorama (ImageKit Control/ Effect Method)

This method composes a panorama image from two raster images.

[Visual Basic] [ Boolean = ]imagekitcontrolname.Effect.Panorama(Handle1 As LONG_PTR, Handle2 As LONG_PTR, CutMode As Integer, Px11 As Long, Py11 As Long, Px12 As Long, Py12 As Long, Px21 As Long, Py21 As Long, Px22 As Long, Py22 As Long, Red As Integer, Green As Integer, Blue As Integer)

[Visual C++] [ BOOL = ]imagekitcontrolname.GetEffect().Panorama(LONG_PTR Handle1, LONG_PTR Handle2, short CutMode, long Px11, long Py11, long Px12, long Py12, long Px21, long Py21, long Px22, long Py22, short Red, short Green, short Blue)

[VB.NET] [ Boolean = ]imagekitcontrolname.Effect.Panorama(Handle1 As Integer(x86) or Long(x64), Handle2 As Integer(x86) or Long(x64), CutMode As Short, Px11 As Integer, Py11 As Integer, Px12 As Integer, Py12 As Integer, Px21 As Integer, Py21 As Integer, Px22 As Integer, Py22 As Integer, Red As Short, Green As Short, Blue As Short)

[C#.NET] [ bool = ]imagekitcontrolname.Effect.Panorama(int(x86) or long(x64) Handle1, int(x86) or long(x64) 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)

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

(x86) refers to the 32 bit version, (x64) refers to the 64 bit version.

Return Value

Returns True (nonzero) if successful, otherwise returns False (0).

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.

Defferences between ImageKit7/8

Handle1 and Handle2 arguments have a different type.