ApplyLinearVOILUT Method (ILEADRasterProcess)

Visual Basic example

Visual C++ example

 

Syntax

short ApplyLinearVOILUT (LPDISPATCH pRaster, double dCenter, double dWidth, VOILUTConstants Flags);

Overview

Refer to Examining and Altering Bitmaps.

Remarks

Sets up the paint or paint and image processing functions' window leveling options for a specific bitmap through a linear transformation described by window center and width. In DICOM world, this is referred to as "applying a linear VOI LUT".

This method will remap the LUT used to display and process a bitmap by applying the linear transformation described by window center and window width, in the DICOM world this is referred to as applying a "linear VOI LUT". The DICOM standard states:

"Window Center and Window Width specify a linear conversion from stored pixel values (after any Modality LUT or Rescale Slope and Intercept specified in the IOD have been applied) to values to be displayed. Window Center contains the input value that is the center of the window. Window Width contains the width of the window." Please see "VOI LUT Module Attributes" in the DICOM standard for more details.

This method doesn’t change the image data; it only updates the entries inside the bitmap LUT.

It’s 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 function supports signed data images.

See Also

Elements:

ApplyVOILUT method, RemapIntensity method, ApplyModalityLUT method, ApplyLinearModalityLUT method

Topics:

Raster Image Functions: Modifying Intensity Values

 

Changing Brightness and Contrast