ImageGear for C and C++ on Windows v19.4 - Updated
MED_PS_GSDF_LUT_build
API Reference Guide > MD Component API Reference > MD Component Functions Reference > Presentation State Functions > MED_PS_GSDF_LUT_build

This function builds a look-up table that maps pixel intensities from DICOM GSDF-compliant color space into pixel intensities of the display device.

Declaration:

 
Copy Code
AT_ERRCOUNT ACCUAPI MED_PS_GSDF_LUT_build(
        DWORD dwCharactCurveEntryCount, 
        LPDOUBLE lpCharactCurve, 
        LPAT_MED_LUT_DESC lpLUT 
);

Arguments:

Name Type Description
dwCharactCurveEntryCount DWORD Number of entries in Characteristic Curve.
lpCharactCurve LPDOUBLE Characteristic Curve of the display.
lpLUT LPAT_MED_LUT_DESC GSDF LUT to fill.

Return Value:

Returns the number of ImageGear errors that occurred during the function call.

Supported Raster Image Formats:

This function does not process image pixels.

Remarks:

The user should fill in the members of the lpLUT structure and allocate the lpLUTData buffer. The space necessary for holding the LUT can be calculated using the AM_MED_LUT_SIZE_GET macro.

The LUT obtained from this function can be used for building the 16x8 or 8x8 display LUT. See MED_PS_apply(), MED_PS_display_contrast().

At the moment, ImageGear does not support any display devices that are capable of displaying more than 256 shades of grayscale. Hence, MED_PS_GSDF_LUT_build can only build a LUT consisting of 8-bit entries.