L_AnnConvert

Summary

Use this function to convert back and forth between container coordinates and client coordinates.

Syntax

#include "l_bitmap.h"

L_LTANN_API L_INT L_AnnConvert(hContainer, pPoints, pAnnPoints, nCount, nConvert)

Parameters

HANNOBJECT hContainer

Handle to the annotation container

LPPOINT pPoints

Array of points in client coordinates. Client coordinates factor in the current zoom factor, and the horizontal and vertical scrolling

pANNPOINT pAnnPoints

Array of points in container coordinates. Container coordinates are typically the same dimensions of the underlying bitmap, and are independent of zooming and scrolling.

L_INT nCount

Number of points in the arrays (pPoints, pAnnPoints)

L_INT nConvert

A value that specifies the direction of the conversion. Possible values are:

Value Meaning
ANNCONVERT_TO_CONTAINER [1] Convert to container coordinates
ANNCONVERT_TO_CLIENT [2] Convert to client coordinates

Returns

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

Comments

Use this function to convert back and forth between container coordinates and client coordinates.

The number of elements in both the pPoints and pAnnPoints arrays must be AT LEAST equal to nCount.

When nConvert is ANNCONVERT_TO_CONTAINER, the pPoints array must contain valid entries. If successful, pAnnPoints will contain the converted points.

When nConvert is ANNCONVERT_TO_CLIENT, the pAnnPoints array must contain valid entries. If successful, pPoints will contain the converted points.

Required DLLs and Libraries

Platforms

Win32, x64.

See Also

Functions

Topics

Example

For an example, refer to L_AnnRestrictCursor.

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

LEADTOOLS Raster Imaging C API Help
Products | Support | Contact Us | Intellectual Property Notices
© 1991-2023 LEAD Technologies, Inc. All Rights Reserved.