L_LTANN_API L_INT L_AnnGetRotateAngle(hObject, pdAngle)
Gets the rotation angle for an annotation object.
Handle to the annotation object.
Pointer to a double variable to be updated with the rotation angle.
|SUCCESS||The function was successful.|
|< 1||An error occurred. Refer to Return Codes.|
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
This example displays the rotation angle for the annotation hObject in radians and degrees.
L_INT AnnGetRotateAngleExample(HANNOBJECT hObject)
nRet = L_AnnGetRotateAngle(hObject, &dAngle);
if (nRet == SUCCESS)
_stprintf_s(szMsg, TEXT("Angle of rotation: Radians[%lf] Degrees[%f]\n"),
dAngle *180 / 3.1415926535
MessageBox(NULL, szMsg, TEXT(""), MB_OK);
Medical Web Viewer .NET
.NET, Java, Android, and iOS/macOS Assemblies
C API/C++ Class Libraries