L_DicomGetPaletteColorLUTAttributes
#include "ltdic.h"
L_UINT16 EXT_FUNCTION 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
0 |
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 |
See Also
Functions: |
L_DicomGetPaletteColorLUTData, L_DicomSetPaletteColorLUTAttributes, L_DicomSetPaletteColorLUTData, L_DicomDeletePaletteColorLUT |
Topics: |
|
|
Example
For an example, refer to L_DicomGetPaletteColorLUTData.