Collapse All Expand All

L_DicomGetPaletteColorLUTAttributes

#include "ltdic.h"

L_LTDIC_API L_UINT16 L_DicomGetPaletteColorLUTAttributes(hDS, pPaletteColorLUTAttributes, uStructSize, uFlags)

HDICOMDS hDS;	/* a DICOM handle */
pDICOMPALCOLORLUTATTRIBS pPaletteColorLUTAttributes;	/* pointer to a Palette Color LUT attributes structure */
L_UINTuStructSize;	/* the size of the DICOMPALCOLORLUTATTRIBS structure */
L_UINT uFlags;	/* reserved for future use */

Retrieves the attributes that describe "Palette Color Lookup Table".

Parameter	Description
hDS	A DICOM handle.
pPaletteColorLUTAttributes	Pointer to a structure to be updated with the "Palette Color Lookup Table" attributes.
uStructSize	Size of the DICOMPALCOLORLUTATTRIBS structure. Pass sizeof(DICOMPALCOLORLUTATTRIBS).
uFlags	Reserved for future use. Pass 0.

Returns

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

Comments

This function will retrieve the attributes of the "Palette Color Lookup Table" and store their values in the structure pointed to by pPaletteColorLUTAttributes.

pPaletteColorLUTAttributes->uStructSize will be set to the value of the parameter uStructSize.

The function will fail and return DICOM_ERROR_LUT_DESCRIPTOR_MISSING if any of the following elements are missing from the DICOM dataset:

"Red Palette Color Lookup Table Descriptor" (0028,1101)," Green Palette Color Lookup Table Descriptor" (0028,1102) or "Blue Palette Color Lookup Table Descriptor" (0028,1103).

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_DicomGetPaletteColorLUTData, L_DicomSetPaletteColorLUTAttributes, L_DicomSetPaletteColorLUTData, L_DicomDeletePaletteColorLUT
Topics:	LUT Encoding Overview
	LUT Encoding: Palette Color Table

Example

For an example, refer to L_DicomGetPaletteColorLUTData.