#include "l_bitmap.h"
L_LTANN_API L_INT L_AnnGetRect(hObject, pRect, pRectName)
Gets the current defining rectangle of the specified annotation object. Every object has a defining rectangle, which intersects the object's outermost points.
Handle to the annotation object.
Address of the variable to be updated with the annotation object's current rectangle. Pass NULL if you do not wish to retrieve this information.
Address of the variable to be updated with the bounding rectangle of the name of the annotation object. Pass NULL if you do not wish to retrieve this information.
Value | Meaning |
---|---|
SUCCESS | The function was successful. |
< 1 | An error occurred. Refer to Return Codes. |
The defining rectangle, which is used to size and position objects, is different from the bounding rectangle as follows:
The defining rectangle intersects the outermost points that define the object. If a line is more than one pixel wide, its defining points are in the middle of the line.
The bounding rectangle accounts for line width and is used as the rectangle to be invalidated when displaying an object. If the line width is an even number, the bounding rectangle is enlarged slightly to allow for variations in how the center of the line is defined on different systems. Refer to the L_AnnGetBoundingRect function.
Half the width of an object's outer line is outside its defining rectangle, as shown in the following diagram:
If the annotation object name is being displayed (see L_AnnSetNameOptions and L_AnnGetNameOptions for more information on annotation object names), it can appear far away from the annotation object itself. For this reason, a separate defining rectangle for the annotation object name can be obtained by passing the address of a variable of data type RECT for the argument pRectName
.
The ANNRECT structure is like a Windows RECT structure, except that it uses double-precision floating point values.
Coordinates of an object's rectangle 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.
Required DLLs and Libraries
Win32, x64.
This example displays the defining rectangle for an annotation object,
and the defining rectangle for the annotation object's name.
L_INT AnnGetRectExample(HANNOBJECT hObject )
{
L_INT nRet;
ANNRECT rcAnnObjectBounds;
ANNRECT rcAnnNameBounds;
L_TCHAR szMsg[200];
nRet = L_AnnGetRect(hObject, &rcAnnObjectBounds, &rcAnnNameBounds);
if(nRet != SUCCESS)
return nRet;
_stprintf_s(szMsg, TEXT("L_AnnGetRect\n\tObject Bounds[%lf, %lf, %lf, %lf]\n\tName Bounds[%lf,%lf,%lf,%lf]"),
rcAnnObjectBounds.left, rcAnnObjectBounds.top, rcAnnObjectBounds.right, rcAnnObjectBounds.bottom,
rcAnnNameBounds.left, rcAnnNameBounds.top, rcAnnNameBounds.right, rcAnnNameBounds.bottom);
MessageBox(NULL, szMsg, TEXT(""), MB_OK);
return SUCCESS;
}
Help Collections
Raster .NET | C API | C++ Class Library | HTML5 JavaScript
Document .NET | C API | C++ Class Library | HTML5 JavaScript
Medical .NET | C API | C++ Class Library | HTML5 JavaScript
Medical Web Viewer .NET
Multimedia
Direct Show .NET | C API | Filters
Media Foundation .NET | C API | Transforms
Supported Platforms
.NET, Java, Android, and iOS/macOS Assemblies
Imaging, Medical, and Document
C API/C++ Class Libraries
Imaging, Medical, and Document
HTML5 JavaScript Libraries
Imaging, Medical, and Document