LDicomDS::ConvertLEADAnnObjToDicomAnnObjs

#include "Ltdic.h"

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

HANNOBJECT hAnnObject;

/* handle to the LEAD annotation object to convert */

pDICOMELEMENT pGraphicAnnSQItem;

/* pointer to a DICOMELEMENT structure */

L_UINT uFlags;

/* reserved for future use */

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

Parameter

Description

hAnnObject

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

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 dont want the resulting objects to be added to the dataset.

uFlags

Reserved for future use. Pass 0.

Returns

0

SUCCESS

>0

An error occurred. Refer to Return Codes.

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

See Also

Functions:

LDicomDS::ConvertLEADAnnObjToDicomAnnObjs, LDicomDS::ConvertDicomAnnObjToLEADAnnObj, Class Members

Topics:

Working with DICOM Annotations

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;
}