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

Platforms

Win32, x64

See Also

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

Example

For an example, refer to L_DicomSetVOILUT.