L_DicomGetVOILUTData

#include "ltdic.h"

L_LTDIC_API L_UINT16 L_DicomGetVOILUTData(hDS, uVOILUTIndex, pLUTData, uDataSize, uFlags)

HDICOMDS hDS;	/* a DICOM handle */
L_UINT uVOILUTIndex;	/* the VOI LUT index*/
L_UINT16 *pLUTData;	/* pointer to the target buffer */
L_UINT uDataSize;	/* size of the target buffer */
L_UINT uFlags;	/* reserved for future use */

Retrieves "LUT Data" for an item under "VOI LUT Sequence".

Parameter	Description
hDS	A DICOM handle.
uVOILUTIndex	Index to the VOI LUT to be retrieved. According to the DICOM standard one or more items could exist under one VOI LUT Sequence (0028,3010), use this index to specify which item to use in order to fill the pLUTData buffer. This index is zero-based.
pLUTData	Pointer to the buffer to be updated with the "LUT Data". You must allocate the buffer before calling this function, and the buffer must be large enough to hold the "LUT Data".
uDataSize	Size of the buffer pointed to by pLUTData.
uFlags	Reserved for future use. Pass 0.

Returns

0	The function was successful.
>0	An error occurred. Refer to Return Codes.

Comments

This function will retrieve the "LUT Data" (0028,3006) for an item under the "VOI LUT Sequence" (0028,3010).

Before calling this function you must call L_DicomGetVOILUT to retrieve the attributes of the VOI LUT of the item for which you are trying to get the "LUT Data". You can then use pVOILUTAttributes.LUTDescriptor.uNumberOfEntries to determine the size of the pLUTData buffer passed to this function.

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

Functions:	L_DicomGetWindowCount, L_DicomGetVOILUTCount, L_DicomGetWindow, L_DicomSetWindow, L_DicomDeleteWindow, L_DicomGetVOILUT, L_DicomSetVOILUT, L_DicomDeleteVOILUT, L_ApplyVOILUT
Topics:	LUT Encoding Overview
	LUT Encoding: VOI LUT