LAnnPolyRuler::SetPoints

#include "ltwrappr.h"

virtual L_INT LAnnPolyRuler::SetPoints(pPoints, uCount)

pANNPOINT pPoints;

/* pointer to the array of LEADTOOLS ANNPOINT structures */

L_UINT uCount;

/* number of points in the array */

Defines the shape of the annotation object.

Parameter

Description

pPoints

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.

uCount

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

Returns

SUCCESS

The function was successful.

< 1

An error occurred. Refer to Return Codes.

Comments

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 LAnnotation::Define function to specify the array of points interactively.

Required DLLs and Libraries

LTANN

For a listing of the exact DLLs and Libraries needed, based on the toolkit version, refer to Files To Be Included With Your Application.

Platforms

Win32, x64.

See Also

Functions:

Class Members

Topics:

Annotation Functions: Getting and Setting Geometric Properties

 

Annotation Functions: Using Window Coordinates to Define an Object

 

Key Annotation Features

 

Calibrating Annotation Ruler Objects

Example

For an example, refer to LAnnPolyRuler::GetPoints.