DICOMTEXTOBJECT

typedef struct tagDICOMTEXTOBJECT
{
   L_UINT uStructSize; 
   L_CHAR *pszLayerName; 
   L_CHAR *pszTextValue; 
   L_FLOAT *pTLHCorner;     
   L_FLOAT *pBRHCorner;    
   L_UINT uBoundingBoxUnits; 
   L_UINT uTextJustification; 
   L_FLOAT *pAnchorPoint;  
   L_UINT uAnchorPointUnits; 
   L_BOOL bAnchorPointVisible; 
} 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"

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. LDicomDS::GetTextObjectInfo), 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. LDicomDS::SetTextObjectInfo), 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.

See Also

Functions:

LDicomDS::CreateTextObject, LDicomDS::GetTextObjectInfo, LDicomDS::SetTextObjectInfo.

Topics:

Working with DICOM Annotations