GetArrayPointsXY (ImageKit Control/Edit Method)

This method retrieves the coordinate values for each of the points used to define the selection area drawn using the Select or the FreeSelect tools in the image-editing toolbar

Parameters

* In C++Builder, the Points_Size array is passed as the number of elements -1

Return Value

Returns True if successful. Returns False if unsuccessful.

Explanation

The GetArrayPointsXY method retrieves the coordinate values for each of the points used to define the selection area drawn using the Select or the FreeSelect tools in the image-editing toolbar.

In the image editing toolbar, the Select tool and the FreeSelect tool can be used to select an area on an image. This selected area is defined by a set of points. In the case of the Select tool, a rectangular selection area is drawn so only 4 points are needed to define that area. In the case of the FreeSelect tool, however, the selection area can be defined by a large number of points. The GetArrayPointsNum method can be used to retrieve the number of points that define the selection area. The GetArrayPointsXY method can be used to retrieve each of the point's X,Y coordinates. The values are in pixels.

In C++Builder:
     TPoint *Points;
     bool ret
     int count;

     count = VImageKit1->Edit->GetArrayPointsNum();
     if (count == 0) return;
     Points = new TPoint[count];
     ret = VImageKit1->Edit->GetArrayPointsXY(Points, count - 1);
     // Various processing code goes here
     delete[] Points;

In Delphi:
     Points: array of TPoint;
     ret: Boolean;
     count: Integer;

     count := VImageKit1.Edit.GetArrayPointsNum;
     if count = 0 then Exit;
     SetLength(Points, count);
     ret := VImageKit1.Edit.GetArrayPointsXY(Points);

Differences from ImageKit 7/8/9/10 ActiveX

The x, y parameters have been changed to type TPoint