L_DicomAddPresStateImageRefByDS

Summary

Adds a new item to the "Referenced Image Sequence" under the "Presentation State Module".

Syntax

#include "ltdic.h"

L_LTDIC_API L_UINT16 L_DicomAddPresStateImageRefByDS(hDS, hRefImageDS, FrameNumbers, uFramesCount)

Parameters

HDICOMDS hDS

A DICOM handle.

HDICOMDS hRefImageDS

Dataset which represents the image(SOP Instance) to be referenced.

L_INT32* FrameNumbers

An array which represents the frame numbers inside the image (SOP Instance) to which the presentation state will be applied.

L_UINT uFramesCount

Number of frames being set.

Returns

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

Comments

This function will add a new item into the "Referenced Image Sequence" (0008,1140) under the "Presentation State Module", by passing a dataset, which represents the image (SOP Instance) to be referenced.

Required DLLs and Libraries

Platforms

Win32, x64, Linux.

See Also

Functions

Topics

Example

L_INT DicomAddPresStateImageRefByDSExample(HDICOMDS hPresStateDS, HDICOMDS hImageDS) 
{ 
   L_UINT16    nRet = DICOM_SUCCESS; 
   L_UINT      uFramesCount = 2;  
   L_INT32*    FrameNumbers = new L_INT32[uFramesCount];  
   FrameNumbers[0] = 1;  
   FrameNumbers[1] = 12;  
   nRet = L_DicomAddPresStateImageRefByDS( hPresStateDS, hImageDS, FrameNumbers, uFramesCount);  
   if (nRet == DICOM_SUCCESS)  
   { 
      MessageBox( NULL,  
                  TEXT("Image was successfully added to the referenced image sequence."),  
                  TEXT("Success"),  
                  MB_OK);           
   } 
   if (FrameNumbers)  
   { 
      delete [] FrameNumbers;  
   } 
   return nRet; 
} 
Help Version 23.0.2024.7.1
Products | Support | Contact Us | Intellectual Property Notices
© 1991-2024 LEAD Technologies, Inc. All Rights Reserved.

LEADTOOLS DICOM C API Help
Products | Support | Contact Us | Intellectual Property Notices
© 1991-2023 LEAD Technologies, Inc. All Rights Reserved.