LDicomDS::AddPresStateImageRefByDS

#include "Ltdic.h"

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

LDicomDS* pDS;	data set to be referenced
L_INT32* pFrameNumbers;	array of frame numbers
L_UINT uFramesCount;	size of the array

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

Parameter	Description
pDS	Dataset which represents the image(SOP Instance) to be referenced.
pFrameNumbers	An array which represents the frame numbers inside the image (SOP Instance) to which the presentation state will be applied.
uFramesCount	Number of frames being set.

Returns

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; 
}

Help Version 19.0.2017.10.27

Products | Support | Contact Us | Copyright Notices
© 1991-2017 Apryse Sofware Corp. All Rights Reserved.

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

CallBack Functions

Appendix

Functions:	LDicomDS::SetPresStateInfo, LDicomDS::GetPresStateInfo, LDicomDS::RemovePresStateImageRefBySOPInstance, LDicomDS::RemoveAllPresStateImageRefs, LDicomDS::GetPresStateImageRefSOPInstance, LDicomDS::GetPresStateImageRefCount, LDicomDS::FindFirstPresStateRefSeriesItem, LDicomDS::FindNextPresStateRefSeriesItem, LDicomDS::GetPresStateImageRefBySOPInstance
Topics:	Working with DICOM Annotations
	How to Disable the Automatic Loading of the default DICOM IOD Table