LDicomDS::CreateGraphicObject

#include "Ltdic.h"

L_UINT16 LDicomDS::CreateGraphicObject(pGraphicAnnSQItem, pGraphicObject, bCheckLayer)

pDICOMELEMENT pGraphicAnnSQItem;

pointer to a DICOMELEMENT structure

pDICOMGRAPHICOBJECT pGraphicObject;

pointer to the graphic object attributes structure

L_BOOL bCheckLayer;

flag that indicates whether to verify that the layer (to which the graphic object will be added) exists or not

Creates a new graphic annotation object.

Parameter Description
pGraphicAnnSQItem Pointer to an item element under the "Graphic Annotation Sequence" (0070,0001) in the "Graphic Annotation Module".
pGraphicObject Pointer to the graphic object attributes structure.
bCheckLayer Flag that indicates whether to verify that the layer (to which the graphic object will be added) exists or not.
  Value Meaning
  TRUE Check if the layer exists before adding the object. If it does not exist, then return an error.
  FALSE Add the new object without checking the existence of the layer.

Returns

0

SUCCESS

>0

An error occurred. Refer to Return Codes.

Comments

Before calling this function, initialize pDICOMGRAPHICOBJECT->uStructSize to be sizeof(DICOMGRAPHICOBJECT) and initialize all the structure members.

When the parameter bCheckLayer is set to TRUE, then this function checks if the layer specified in the member variable pszLayerName exists or not. If it does not exist, an error will be returned.

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::FindFirstGraphicAnnSQItem, LDicomDS::CreateGraphicAnnSQItem, LDicomDS::RemoveGraphicObject, LDicomDS::GetGraphicObjectInfo, LDicomDS::SetGraphicObjectInfo, LDicomDS::GetGraphicObjectCount, LDicomDS::RemoveAllGraphicObjects, LDicomDS::GetGraphicObjPointCount, LDicomDS::GetGraphicObjElement, LDicomDS::ConvertLEADAnnObjToDicomAnnObjs, LDicomDS::ConvertLEADAnnObjToDicomAnnObjs, 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_CreateGraphicObjectExample(LDicomDS& PresStateDS) 
{ 
   L_INT                nRet; 
   DICOMGRAPHICOBJECT   GraphicObject; 
   L_UINT               nCount = 5; 
   memset(&GraphicObject, 0, sizeof(DICOMGRAPHICOBJECT)); 
   GraphicObject.pAnnPoints = new DICOMANNPOINT[nCount]; 
   GraphicObject.pAnnPoints [0].fX = (L_FLOAT)480.00; 
   GraphicObject.pAnnPoints [0].fY = (L_FLOAT)226.00; 
   GraphicObject.pAnnPoints [1].fX = (L_FLOAT)480.00; 
   GraphicObject.pAnnPoints [1].fY = (L_FLOAT)418.00; 
   GraphicObject.pAnnPoints [2].fX = (L_FLOAT)488.00; 
   GraphicObject.pAnnPoints [2].fY = (L_FLOAT)418.00; 
   GraphicObject.pAnnPoints [3].fX = (L_FLOAT)488.00; 
   GraphicObject.pAnnPoints [3].fY = (L_FLOAT)226.00; 
   GraphicObject.pAnnPoints [4].fX = (L_FLOAT)480.00; 
   GraphicObject.pAnnPoints [4].fY = (L_FLOAT)226.00; 
   GraphicObject.bFilled      = TRUE; 
   GraphicObject.uType        = DICANN_TYPE_POLYLINE; 
   GraphicObject.pszLayerName = TEXT("First Layer"); 
   GraphicObject.nPointCount  = (L_UINT16)nCount; 
   GraphicObject.uUnits       = DICANN_UNIT_PIXEL; 
   GraphicObject.uStructSize  = sizeof(DICOMGRAPHICOBJECT); 
   nRet = PresStateDS.CreateGraphicObject(PresStateDS.FindFirstGraphicAnnSQItem(), &GraphicObject); 
   if (nRet == DICOM_SUCCESS) 
   { 
      MessageBox( NULL, 
      TEXT("Object has been successfully created."), 
      TEXT("Note"), 
      MB_OK); 
   } 
   if (GraphicObject.pAnnPoints) 
   { 
      delete [] GraphicObject.pAnnPoints; 
   } 
   return nRet; 
}

Help Version 19.0.2017.10.27
Products | Support | Contact Us | Copyright Notices
© 1991-2017 LEAD Technologies, Inc. All Rights Reserved.
LEADTOOLS DICOM C++ Class Library Help
Introduction
Version History
Getting Started
LEADTOOLS DICOM Features
Redistributables/Files To Be Included With Your Application
Quick Reference
Classes and Member Functions
CallBack Functions
Appendix