In This Topic ▼

CONVERTLEADANNOBJTODICOMANNPROC

Summary

Called for each DICOM annotation object generated by L_DicomConvertLEADAnnObjToDicomAnnObjs.

Syntax

#include "ltdic.h"

L_UINT16 pEXT_CALLBACK Your Function(pGraphicObject, pTextObject, pUserData)

Parameters

const pDICOMGRAPHICOBJECT pGraphicObject

Pointer to a DICOMGRAPHICOBJECT structure, which will hold the attributes of the generated DICOM graphic annotation object. If set to NULL, then the resulting object is a DICOM text annotation and in this case pTextObject cannot be NULL.

const pDICOMTEXTOBJECT pTextObject

Pointer to a DICOMTEXTOBJECT structure, which will hold the attributes of the generated DICOM text annotation object. If set to NULL then the resulting object is a DICOM graphic annotation and in this case pGraphicObject cannot be NULL.

L_VOID * pUserData

Void pointer that you can use to access a variable or structure containing data that your callback function needs. This gives you a way to receive data indirectly from the function that uses this callback function. (This is the same pointer that you pass in the pUserData parameter of the calling function.)

Keep in mind that this is a void pointer, which must be cast to the appropriate data type within your callback function.

Returns

Value	Meaning
0	SUCCESS
>0	An error occurred. Refer to Return Codes.

Comments

As a result of calling L_DicomConvertLEADAnnObjToDicomAnnObjs one or more DICOM annotation objects will be generated. For each of the resulting objects this callback function will be called once. If the resulting object is a "Graphic Object", then the parameter pGraphicObject will point to a DICOMGRAPHICOBJECT structure, which describes the new object, and in this case pTextObject will be set to NULL.

If the resulting object is a "Text Object", then the parameter pTextObject will point to a DICOMTEXTOBJECT structure, which describes the new object, and in this case pGraphicObject will be set to NULL. Suppose that a LEAD annotation object will get converted into two DICOM graphic objects and one DICOM text object. This means that this callback function will be called three times, it will be called twice with pGraphicObject != NULL and pTextObject == NULL and will be called once with pGraphicObject == NULL and pTextObject != NULL.

pTextObject and pGraphicObject cannot both be valid or both be NULL at the same time.