L_GetLinearVOILUT

#include "l_bitmap.h"

L_LTIMGCOR_API L_INT L_GetLinearVOILUT(pBitmap, pCenter, pWidth, uFlags);

pBITMAPHANDLE pBitmap;

/* pointer to the bitmap handle */

L_DOUBLE *pCenter;

/* pointer to a variable to be updated */

L_DOUBLE *pWidth;

/* pointer to a variable to be updated */

L_UINT uFlags;

/* flags */

Gets the window center and the window width, if the LUT stored inside pBitmap is linear. If the LUT stored inside pBitmap is not linear, the function will fail.

Parameter

Description

pBitmap

Pointer to the bitmap handle referencing the bitmap.

pCenter

Pointer to a variable to be updated with the center of the range of color intensities that define your window of interest, if the LUT is linear. Cannot be NULL.

pWidth

Pointer to a variable to be updated with the range of color intensities that define your window of interest, if the LUT is linear. Cannot be NULL.

uFlags

Reserved for future use. Pass 0 for now.

Returns

SUCCESS

LUT is Linear (success).

0

LUT is not linear (fail).

<0

An error occurred. Refer to Return Codes.

Comments

You have to pay attention to your signed images LUT. The upper half should contain negative values and lower half contains positive values.

This function 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 does not support 32-bit grayscale images. It returns the error code ERROR_GRAY32_UNSUPPORTED if a 32-bit grayscale image is passed to this function.

Required DLLs and Libraries

LTIMGCOR

For a listing of the exact DLLs and Libraries needed, based on the toolkit version, refer to Files To Be Included With Your Application.

Platforms

Windows 2000 / XP/Vista.

See Also

Functions:

L_WindowLevel, L_WindowLevelFillLUT, L_GetUserLookUpTable, L_RemapBitmapIntensity, L_ApplyLinearVOILUT

Topics:

Raster Image Functions: Palettes

Example

/* check the linearity of  the LUT and computes its window width and center by using L_GetLinearVOILUT function.*/
L_INT GetLinearVOILUTExample(pBITMAPHANDLE pBitmap,L_DOUBLE    * pCenter,L_DOUBLE    * pWidth)
{
   return L_GetLinearVOILUT (pBitmap, pCenter, pWidth, 0);
}