In This Topic ▼

L_DicomAddLayerImageRef

#include "l_bitmap.h"

L_LTDIC_API L_UINT16 L_DicomAddLayerImageRef(hDS, pGraphicAnnSQItem, pszImageSOPInstance)

Adds a new item under the "Referenced Image Sequence" for the specified item under the "Graphic Annotation Sequence".

Parameters

HDICOMDS hDS

A DICOM handle.

pDICOMELEMENT pGraphicAnnSQItem

Pointer to an item element under the "Graphic Annotation Sequence" (0008,1115) in the "Graphic Annotation Module".

L_TCHAR* pszImageSOPInstance

SOP Instance UID of the image to be added.

Returns

Value	Meaning
DICOM_SUCCESS	The function was successful.
>0	An error occurred. Refer to Return Codes.

Comments

This function adds a referenced image to the "Referenced Image Sequence" (0008,1140) in the specified "Graphic Annotation Sequence" (0070,0001) item in the "Graphic Annotation Module". This image should be defined previously in the "Presentation State Module".

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, Linux.

Functions

Topics

Example

L_INT DicomAddLayerImageRefExample(HDICOMDS hPresStateDS) 
{ 
   pDICOMELEMENT pGraphicAnnSQItem = L_DicomFindFirstGraphicAnnSQItem(hPresStateDS); 
 
   L_TCHAR* pszSOPInstanceUID = L_DicomGetPresStateImageRefSOPInstance(  hPresStateDS, 
                                                                        L_DicomFindFirstPresStateRefSeriesItem(hPresStateDS),0); 
   L_UINT16 nRet = L_DicomAddLayerImageRef(  hPresStateDS, 
                                             pGraphicAnnSQItem,  
                                             pszSOPInstanceUID); 
   if (nRet == DICOM_SUCCESS) 
   { 
      MessageBox( NULL,  
                  TEXT("Referenced Image has been added successfully to the Graphic Annotation Sequence item."),  
                  TEXT("Note"),  
                  MB_OK);  
   } 
   return nRet; 
}

Download our FREE evaluation

Help Version 20.0.2020.4.2

LEADTOOLS DICOM C API Help

Introduction

Version History

Getting Started

Features of LEADTOOLS DICOM

Redistributables/Files To Be Included With Your Application

Quick Reference

Function References

Appendix