L_DicomAddPresStateImageRefByFileName

#include "l_bitmap.h"

L_LTDIC_API L_UINT16 L_DicomAddPresStateImageRefByFileName(hDS, pszImageFileName, pFrameNumbers, uFramesCount)

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

Parameters

HDICOMDS hDS

A DICOM handle.

L_TCHAR* pszImageFileName

File name of the image(SOP Instance) to be referenced.

L_INT32* pFrameNumbers

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 the file name of the image (SOP Instance) to be referenced.

Required DLLs and Libraries

Platforms

Win32, x64, Linux.

See Also

Functions

Topics

Example

L_INT DicomAddPresStateImageRefByFileNameExample(HDICOMDS hPresStateDS) 
{ 
   L_UINT   uFramesCount      = 2; 
   L_INT32*pFrameNumbers     = NULL; 
   L_TCHAR pszImageFileName[256];  
   lstrcpy(pszImageFileName,MAKE_IMAGE_PATH(TEXT("IMAGE2.dcm"))); 
 
   L_UINT16 nRet; 
 
   pFrameNumbers = (L_INT32*)malloc(sizeof(L_INT32) * uFramesCount); 
   if(pFrameNumbers == NULL) 
      return ERROR_NOT_ENOUGH_MEMORY; 
 
   pFrameNumbers[0]   = 1; 
   pFrameNumbers[1]   = 12; 
 
   nRet = L_DicomAddPresStateImageRefByFileName(hPresStateDS, 
                                                pszImageFileName, 
                                                pFrameNumbers, 
                                                uFramesCount); 
   if (nRet == DICOM_SUCCESS) 
   { 
      MessageBox( NULL,  
                  TEXT("Image was successfully added to the referenced image sequence."), 
                  TEXT("Success"), 
                  MB_OK); 
   } 
   if (pFrameNumbers) 
      free(pFrameNumbers); 
   return nRet; 
} 
Help Version 20.0.2020.4.2
Products | Support | Contact Us | Intellectual Property Notices
© 1991-2020 LEAD Technologies, Inc. All Rights Reserved.

LEADTOOLS DICOM C API Help