DICOMTEXTOBJECT

typedef struct tagDICOMTEXTOBJECT 
{ 
   L_UINT uStructSize; 
   L_TCHAR *pszLayerName; 
   L_TCHAR *pszTextValue; 
   L_FLOAT *pTLHCorner; 
   L_FLOAT *pBRHCorner; 
   L_UINT uBoundingBoxUnits; 
   L_UINT uTextJustification; 
   L_FLOAT *pAnchorPoint; 
   L_UINT uAnchorPointUnits; 
   L_BOOL bAnchorPointVisible; 
   L_VOID *pReserved; 
   L_UINT uCompoundGraphicInstanceId; 
   L_UINT uOptions; 
   pDICOMTEXTSTYLE pTextStyle; 
   L_UINT uGraphicGroupId; 
} DICOMTEXTOBJECT, *pDICOMTEXTOBJECT; 

The DICOMTEXTOBJECT describes the attributes of a "Text Annotation" object.

Member Description
uStructSize The size of the structure (use sizeof (DICOMTEXTOBJECT)).
pszLayerName Pointer to the "Graphic Layer" (0070,0002) attribute value in the "Graphic Annotation Sequence" (0070,0001).
pszTextValue Pointer to the "Unformatted Text Value" (0070,0006) attribute value.
pTLHCorner Pointer to the "Bounding Box Top Left Hand Corner" (0070,0010) attribute value.
pBRHCorner Pointer to the "Bounding Box Bottom Right Hand Corner" (0070,0011) attribute value.
uBoundingBoxUnits "Bounding Box Annotation Units" (0070,0003) attribute value. Enumerated values are:
Value Meaning
DICANN_UNIT_PIXEL [0x00000001] "PIXEL".
DICANN_UNIT_DISPLAY [0x00000002] "DISPLAY"
uTextJustification "Bounding Box Text Horizontal Justification" (0070,0012) attribute value. Enumerated values are:
Value Meaning
DICANN_TEXT_LEFT [0x00000000] "LEFT"
DICANN_TEXT_RIGHT [0x00000001] "RIGHT"
DICANN_TEXT_CENTER [0x00000002] "CENTER"
pAnchorPoint Pointer to the "Anchor Point"(0070,0014) attribute value.
uAnchorPointUnits "Anchor Point Annotation Units" (0070,0004) attribute value. Enumerated values are:
Value Meaning
DICANN_UNIT_PIXEL [0x00000001] "PIXEL"
DICANN_UNIT_DISPLAY [0x00000002] "DISPLAY"
bAnchorPointVisible "Anchor Point Visibility" (0070,0015) attribute value. Possible values are:
Value Meaning
TRUE "Y"
FALSE "N"
pReserved Reserved for internal use -- Pass 0.
uCompoundGraphicInstanceId TAG_COMPOUND_GRAPHIC_INSTANCE_ID
uOptions DICANN_OPTIONS_NONE, DICANN_OPTIONS_TEXT_STYLE
pTextStyle TAG_TEXT_STYLE_SEQUENCE
uGraphicGroupId TAG_GRAPHIC_GROUP_ID

Comments

The members of this structure are based on some of the attributes of the "Graphic Annotation Module", please see "Graphic Annotation Module Attributes" in the DICOM standard for more details.

Special note about the following members: pszLayerName, pszTextValue, pTLHCorner, pBRHCorner and pAnchorPoint:

When you call a function, which updates this structure (ex. L_DicomGetTextObjectInfo), LEADTOOLS will fill these members with pointers to the internal memory, which LEADTOOLS manages. You must not free these pointers. When you call a function, which updates internal data from the structure you provide (ex. L_DicomSetTextObjectInfo), LEADTOOLS expects you to fill these members with pointers to memory that you have allocated and that you manage. You must free these pointers when they are no longer needed.

Help Version 19.0.2017.10.27
Products | Support | Contact Us | Copyright Notices
© 1991-2017 LEAD Technologies, Inc. All Rights Reserved.
LEADTOOLS DICOM C API Help