LDicomDS::ConvertLEADAnnObjToDicomAnnObjs

Summary

Converts a LEAD Annotation object into one or more DICOM annotation objects, and (optionally) adds the new DICOM annotation objects into the dataset.

Syntax

L_UINT16 LDicomDS::ConvertLEADAnnObjToDicomAnnObjs(hAnnObject, pGraphicAnnSQItem, uFlags)

Parameters

HANNOBJECT hAnnObject

Handle to the LEAD annotation object to be converted, cannot be NULL.

pDICOMELEMENT pGraphicAnnSQItem

Pointer to an item element under the "Graphic Annotation Sequence" (0070,0001) in the "Graphic Annotation Module". If this parameter is not NULL then the resulting DICOM annotation objects will be added to the dataset under the item pointed to by this parameter. Pass NULL, if you do not want the resulting objects to be added to the dataset.

L_UINT uFlags

Reserved for future use. Pass 0.

Returns

Comments

This function will convert a LEAD Annotation object into one or more DICOM annotation objects (text and graphic). For each resulting DICOM annotation object the callback function pConversionProc will be called.

If the parameter pGraphicAnnSQItem is not NULL, then the function will automatically add the resulting DICOM annotation objects into the dataset. If the resulting DICOM annotation object is a "Text Object" then it will be added under the "Text Object Sequence" under the item pointed to by pGraphicAnnSQItem. If the resulting DICOM annotation object is a "Graphic Object" then it will be added under the "Graphic Object Sequence" under the item pointed to by pGraphicAnnSQItem.

Currently, a subset of the LEADTOOLS annotation objects can be converted (mapped) into DICOM objects, this includes:

• Line object
• Rectangle object
• Ellipse object
• Poly-line object
• Polygon object
• Pointer object
• Freehand object
• Text object
• Protractor object
• Point object
• Curve object (Interpolated lines)
• Curve Closed Object
• Text Pointer Object

Required DLLs and Libraries

• LTDIC
• For a listing of the exact DLLs and Libraries needed, based on the toolkit version, refer to Files To Be Included With Your Application

Platforms

Win32, x64

See Also

Functions

• LDicomDS::ConvertDicomAnnObjToLEADAnnObj
• Class Members

Topics

• Working with DICOM Annotations
• How to Disable the Automatic Loading of the default DICOM IOD Table

Example

L_INT LDicomDS_ConvertLEADAnnObjToDicomAnnObjsExample(LDicomDS& PresStateDS, pDICOMELEMENT pGraphicAnnSQItem,  HANNOBJECT hAnnObject) 
{ 
   L_INT nRet; 
 
   nRet = PresStateDS.ConvertLEADAnnObjToDicomAnnObjs(hAnnObject, pGraphicAnnSQItem, 0);  
 
   if (nRet == DICOM_SUCCESS)  
   { 
      MessageBox( NULL,  
                  TEXT("LEAD annotation object  has been successfully converted."),  
                  TEXT("Note"),  
                  MB_OK);  
   } 
 
   return nRet; 
}