#include "l_bitmap.h"

L_LTANN_API L_INT L_AnnSetPoints(hObject, pPoints, uCount)

Defines the shape of an annotation object, such as a polygon, that requires multiple points.



Handle to the annotation object.


Pointer to the array of LEADTOOLS ANNPOINT structures that specifies the shape of the annotation.

The ANNPOINT structure is like a Windows POINT structure, except that it uses double-precision floating point values.

Coordinates of an object's points are relative to its container object. The coordinates are interpreted using the container's scaling factors and offsets, which are described in Low-Level Coordinate System for Annotations.

L_UINT uCount

The number of points in the array that you specify in the pPoints parameter.


Value Meaning
SUCCESS The function was successful.
< 1 An error occurred. Refer to Return Codes.


You call this function once, passing an array of points, which must be in the order in which the vertices are connected. To define the line that closes a polygon, the last point in the array is connected to the first point of the array.

Alternatively, you can use the L_AnnDefine function to specify the array of points interactively.

L_AnnSetPoints works only with the following types of objects:

For annotation objects that are defined by a rectangle, use the L_AnnSetRect function.

You can position a Point object using the following:

L_AnnSetPoints(hPoint, apt, 1); 

where apt contains the desired position.

To set the points of a cross-product object, do the following:

ANNPOINT apt[5]; 
L_AnnGetPoints(hPoint, apt, 5); 

hPoint is the handle to the cross-product object. apt[0] and apt[1] are the points for the primary ruler. apt[2] is the intersection point. apt[3] and apt[4] are the points for the secondary ruler.

To set the points of a protractor object, do the following:

ANNPOINT apt [3]; 
L_AnnSetPoints(hPoint, apt, 3); 

hPoint is the handle to the protractor object. apt[0] and apt[2] are the endpoints for the two rulers. apt[1] is the intersection point. This is shown below:

Handle to the protractor object

When calling L_AnnSetPoints on an ANNOBJECT_TEXTPOINTER object, specify three points. The three points are (Upper Left), (Lower Right), (Anchor).

Note: You can not create a line of two points which they are the same.

Required DLLs and Libraries


Win32, x64.

Help Version 21.0.2021.4.7
Products | Support | Contact Us | Intellectual Property Notices
© 1991-2021 LEAD Technologies, Inc. All Rights Reserved.

LEADTOOLS Raster Imaging C API Help