ImageGear for C and C++ on Windows v21.0 - Updated
API Reference Guide / MD Component API Reference / MD Component Functions Reference / Presentation State Functions / MED_PS_GSDF_LUT_build
In This Topic
    MED_PS_GSDF_LUT_build
    In This Topic

    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.