Is this page helpful?

In this page

L_AnnGetRotateAngle

Summary

Gets the rotation angle for an annotation object.

Syntax

#include "l_bitmap.h"

L_LTANN_API L_INT L_AnnGetRotateAngle(hObject, pdAngle)

Parameters

HANNOBJECT hObject

Handle to the annotation object.

L_DOUBLE *pdAngle

Pointer to a double variable to be updated with the rotation angle.

Returns

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

Comments

Call this function to get the rotation angle for a particular annotation object.

The angle is in radians, and uses the following convention.

The possible range of rotate values is (-Pi) ... (Pi)

A rotation in the clockwise direction is considered a positive rotation.

A rotation in the counter-clockwise direction is considered a negative rotation.

For example, if a rectangle is rotated 90 degrees in the counter clockwise direction, this function will get (-PI/2) for the rotation angle. If a rectangle is rotated 90 degrees in the clockwise direction, this function will get PI/2 for the rotation angle. If a rectangle is rotated 270 degrees in the counter clockwise direction, this is equivalent to 90 degrees in the clockwise direction so the rotation value returned is PI/2.

This function is only valid for the following annotation object types:

If the function is used with an object that is not listed, it returns SUCCESS with *pdAngle equal to 0.

Required DLLs and Libraries

Platforms

Win32, x64.

See Also

Functions

Topics

Example

This example gets the rotation angle for the annotation hObject in radians and degrees.

Copied to clipboard
L_INT AnnGetRotateAngleExample(HANNOBJECT hObject) 
{ 
   L_INT    nRet; 
   L_DOUBLE dAngle; 
   L_TCHAR  szMsg[200]; 
 
   nRet = L_AnnGetRotateAngle(hObject, &dAngle); 
   if (nRet == SUCCESS) 
   { 
      _stprintf_s(szMsg, TEXT("Angle of rotation:  Radians[%lf]  Degrees[%f]\n"), dAngle, dAngle * 180 / 3.1415926535); 
      _tprintf(_T("%s"), szMsg); 
   } 
 
   return nRet; 
} 

Help Version 23.0.2024.2.29
Products | Support | Contact Us | Intellectual Property Notices
© 1991-2025 Apryse Sofware Corp. All Rights Reserved.

LEADTOOLS Raster Imaging C API Help
Products | Support | Contact Us | Intellectual Property Notices
© 1991-2025 Apryse Sofware Corp. All Rights Reserved.