L_DicomGetVOILUTData

Summary

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

Syntax

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

Parameters

HDICOMDS hDS

A DICOM handle.

L_UINT 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.

L_UINT16 *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".

L_UINT uDataSize

Size of the buffer pointed to by pLUTData.

L_UINT uFlags

Reserved for future use. Pass 0.

Returns

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, Linux.

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.