L_DicomAddPresStateImageRefByDS
#include "l_bitmap.h"
L_UINT16 EXT_FUNCTION L_DicomAddPresStateImageRefByDS(hDS, hRefImageDS, FrameNumbers, uFramesCount)
HDICOMDS hDS; |
/* a DICOM handle */ |
HDICOMDS hRefImageDS; |
/* a DICOM handle for the data set to be referenced */ |
L_INT32* FrameNumbers; |
/* 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 |
hDS |
A DICOM handle. |
hRefImageDS |
Dataset which represents the image(SOP Instance) to be referenced. |
FrameNumbers |
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 |
See Also
Example
L_VOID AddReferencedImage(HDICOMDS hPresStateDS, HDICOMDS hImageDS)
{
L_UINT uFramesCount = 2;
L_INT32* pFrameNumbers = NULL;
L_UINT16 nRet;
pFrameNumbers = (L_INT32*)malloc(sizeof(L_INT32) * uFramesCount);
if(pFrameNumbers == NULL)
{
return;
}
pFrameNumbers[0] = 1;
pFrameNumbers[1] = 12;
nRet = L_DicomAddPresStateImageRefByFileName( hPresStateDS,
hImageDS,
pFrameNumbers,
uFramesCount);
if (nRet == DICOM_SUCCESS)
{
MessageBox( NULL,
"Image was successfully added to the referenced image sequence.",
"Success",
MB_OK);
}
if (pFrameNumbers)
{
free(pFrameNumbers);
}
}