In This Topic ▼

LDicomDS::AddPresStateImageRefByFileName

#include "Ltdic.h"

L_UINT16 LDicomDS::AddPresStateImageRefByFileName(pszImageFileName, pFrameNumbers = NULL, uFramesCount = 0)

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

Parameters

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
0	SUCCESS
>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

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

Functions

Topics

Example

L_INT LDicomDS_AddPresStateImageRefByFileNameExample(LDicomDS& PresStateDS) 
{ 
   L_INT       nRet; 
   L_UINT      uFramesCount = 2;  
   L_INT32*    FrameNumbers = new L_INT32[uFramesCount];  
   L_TCHAR*    pszImageFileName = NULL;  
 
   FrameNumbers[0]   = 1;  
   FrameNumbers[1]   = 12;  
   pszImageFileName  = MAKE_IMAGE_PATH(TEXT("Image1.dcm")); 
 
   nRet = PresStateDS.AddPresStateImageRefByFileName (pszImageFileName,  
                                                      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; 
}

Download our FREE evaluation

Help Version 20.0.2020.4.2

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

Appendix