CONVERTLEADANNOBJTODICOMANNPROC

#include "ltdic.h"

L_UINT16 pEXT_CALLBACK Your Function(pGraphicObject, pTextObject, pUserData)

const pDICOMGRAPHICOBJECT pGraphicObject;

/* pointer to a DICOM graphic object */

const pDICOMTEXTOBJECT pTextObject;

/* pointer to a DICOM text object */

L_VOID * pUserData;

/* pointer to additional data */

Called for each DICOM annotation object generated by L_DicomConvertLEADAnnObjToDicomAnnObjs.

Parameter

Description

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.

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.

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

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.

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:

L_DicomConvertLEADAnnObjToDicomAnnObjs, L_DicomConvertDicomAnnObjToLEADAnnObj

Topics:

Working with DICOM Annotations

Example

For an example, refer to L_DicomConvertLEADAnnObjToDicomAnnObjs.