In This Topic ▼

LDicomDS::AddPresStateImageRefByDS

Summary

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

Syntax

#include "Ltdic.h"

L_UINT16 LDicomDS::AddPresStateImageRefByDS(pDS, pFrameNumbers = NULL, uFramesCount = 0)

Parameters

LDicomDS* pDS

Dataset which represents 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 a dataset, which represents 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

Example

L_INT LDicomDS_AddPresStateImageRefByDSExample(LDicomDS& PresStateDS, LDicomDS& ImageDS)  
{ 
   L_INT       nRet; 
   L_UINT      uFramesCount = 2;  
   L_INT32*    FrameNumbers = new L_INT32[uFramesCount];  
 
   FrameNumbers[0] = 1;  
   FrameNumbers[1] = 12;  
 
   nRet = PresStateDS.AddPresStateImageRefByDS( &ImageDS,  
                                                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; 
}