ApplyVOILUT method (Main Control)

C++ Builder example

Delphi example

 

Builder Syntax

int ApplyVOILUT(L_PUINT16 pLUT, unsigned uNumberOfEntries, int nFirstStoredPixelValueMapped, unsigned uEntryBits, unsigned uFlags);

Delphi Syntax

Function ApplyVOILUT (pLUT: L_PUINT16; uNumberOfEntries: L_UINT; nFirstStoredPixelValueMapped: L_INT; uEntryBits: L_UINT; uFlags: L_UINT): L_INT;

Overview

Refer to Changing Brightness and Contrast.

Remarks

(Medical only) Sets up the paint or paint and image processing methods' window leveling options for a specific bitmap through a lookup-table (LUT). In the DICOM world, this is referred to as "applying a non-linear VOI LUT".

This method will remap the LUT used to display and process a bitmap by applying a user-defined lookup table. In the DICOM world this is referred to as applying a "non-linear VOI LUT". The DICOM standard states:

"A VOI LUT defines the transformation of the modality pixel values into pixel values that are meaningful for print, display, etc. This transformation is applied after any Modality LUT". Please see "VOI LUT Module Attributes" in the DICOM standard for more details.

This method does not change the image data; it only updates the entries inside the bitmap display LUT.

It is recommended to always set the VOI_LUT_UPDATE_MIN_MAX flag.

In the DICOM world you will need to set VOI_LUT_REVERSE_ORDER flag if the photometric interpretation of the image is "MONOCHROME1", where the minimum grayscale value is intended to be displayed as white after any VOI gray scale transformations have been performed.

This method supports 12 and 16-bit grayscale images. Support for 12 and 16-bit grayscale images is available only in the Document/Medical toolkits.

This method supports signed data images.

See Also

Elements:

ApplyLinearVOILUT method, RemapIntensity method, ApplyModalityLUT method, ApplyLinearModalityLUT method.

Topics:

Raster Images: Modifying Intensity Values