LDicomDS::AddPresStateImageRefByFileName

#include "Ltdic.h"

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

L_CHAR* pszImageFileName;	/* file name of the Image to be added */
L_INT32* pFrameNumbers ;	/* array of frame numbers */
L_UINT uFramesCount;	/* size of the array */

adds a new item into the "Referenced Image Sequence" (0008,1140).

Parameter	Description
pszImageFileName	File name of 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 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

See Also

Functions:	LDicomDS::SetPresStateInfo, LDicomDS::GetPresStateInfo, LDicomDS::AddPresStateImageRefByDS, LDicomDS::RemovePresStateImageRefBySOPInstance, LDicomDS::RemoveAllPresStateImageRefs, LDicomDS::GetPresStateImageRefSOPInstance, LDicomDS::GetPresStateImageRefCount, LDicomDS::FindFirstPresStateRefSeriesItem, LDicomDS::FindNextPresStateRefSeriesItem, LDicomDS::GetPresStateImageRefBySOPInstance
Topics:	Working with DICOM Annotations

Example

L_VOID AddReferencedImage(LDicomDS& PresStateDS)
{
   L_UINT   uFramesCount = 2;
   L_INT32* FrameNumbers = new L_INT32[uFramesCount];
   L_CHAR*  pszImageFileName = NULL;

   FrameNumbers[0]   = 1;
   FrameNumbers[1]   = 12;
   pszImageFileName  = "E:\\Patient-1.dcm";
   L_UINT16 nRet = PresStateDS.AddPresStateImageRefByFileName (pszImageFileName,
                                                               FrameNumbers,
                                                               uFramesCount);
   if (nRet == DICOM_SUCCESS)
   {
      MessageBox( NULL,
                  "Image was successfully added to the referenced image sequence.",
                  "Success",
                  MB_OK);
   }
   if (FrameNumbers)
   {
      delete [] FrameNumbers;
   }
}