L_WindowLevel

#include "l_bitmap.h"

L_INT EXT_FUNCTION L_WindowLevel (pBitmap, nLowBit, nHighBit, pLUT, uLUTLength, uFlags)

pBITMAPHANDLE pBitmap;	/* pointer to the bitmap handle */
L_INT nLowBit;	/* low bit to use */
L_INT nHighBit;	/* high bit to use */
RGBQUAD L_HUGE *pLUT;	/* lookup table */
L_UINT uLUTLength;	/* number of entries */
L_UINT uFlags;	/* flags */

Sets up the paint or paint and image processing functions' window leveling options for a specific bitmap. This function is available in Document/Medical toolkits only.

Parameter	Description
pBitmap	Pointer to the bitmap handle referencing the bitmap to be leveled.
nLowBit	Value indicating the low bit used for leveling. 0 <= nLowBit <= nHighBit <= (11 for 12-bit grayscale or 15 for 16-bit grayscale).
nHighBit	Value indicating the high bit used for leveling. 0 <= nLowBit <= nHighBit <= (11 for 12-bit grayscale or 15 for 16-bit grayscale).
pLUT	Optional lookup table that can be used to implement a user defined conversion. For every intensity value between 0 and 2 raised to the power of (nHighBit - nLowBit + 1)-1 there should be a corresponding entry in the lookup table that contains an RGB quad. If pLUT is NULL, the conversion is a normal shift (right or left) and the painted bitmap is 8-bit grayscale. If pLUT is not NULL, the painted bitmap is a 24-bit bitmap.
uLUTLength	Value indicating the number of entries pointed to by pLUT. If pLUT is NULL, then set this to NULL too.
uFlags	Value indicating whether pLUT is used by the paint and image processing functions or only by the paint functions. Possible values are:
	WINDOWLEVEL_PAINT	[0x00] pLUT is used only by the paint functions.
	WINDOWLEVEL_PAINT_AND_PROCESSING	[0x01] pLUT is used for both paint and image processing routines.

Returns

SUCCESS	The function was successful.
< 1	An error occurred. Refer to Return Codes.

Comments

Provides "on demand" window leveling for the paint functions and does not alter the image data. To convert the image data to a window leveled bitmap, use L_WindowLevelBitmap.

If WINDOWLEVEL_PAINT_AND_PROCESSING is specified, then all image processing functions will take the pLUT into account.

For information on saving bitmaps that have been window leveled, refer to Saving Window-Leveled Bitmaps.

Required DLLs and Libraries

LTDIS

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 95 / 98 / Me, Windows 2000 / XP, Windows CE.

See Also

Functions:	L_WindowLevelBitmap, L_PaintDC, L_PaintDCBuffer, L_PaintDCEffect, L_PaintRgnDC, L_PaintRgnDCBuffer, L_PaintRgnDCEffect, L_WindowLevelFillLUT, L_ChannelMix, L_DeinterlaceBitmap, L_DesaturateBitmap, L_EdgeDetectStatisticalBitmap, L_LightControlBitmap, L_SmoothEdgesBitmap, L_LocalHistoEqualizeBitmap, L_AddWeightedBitmaps, L_ColorMergeBitmap, L_ColorSeparateBitmap, L_ConvertColorSpace, L_MultiplyBitmap, L_AutoColorLevelBitmap, L_ColorLevelBitmap, L_CorrelationBitmap, L_GrayScaleToDuotone, L_GrayScaleToMultitone, L_HolesRemovalBitmapRgn, L_SelectiveColorBitmap, L_SkeletonBitmap, L_ChangeHueSatIntBitmap, L_ColorReplaceBitmap, L_ColorThresholdBitmap, L_MathFunctionBitmap, L_SegmentBitmap, L_AdaptiveContrastBitmap, L_ApplyMathLogicBitmap, L_ColorIntensityBalance, L_ColorizeGrayBitmap, L_ContBrightIntBitmap, L_DigitalSubtractBitmap, L_DynamicBinaryBitmap, L_EdgeDetectEffectBitmap, L_FunctionalLightBitmap, L_MultiScaleEnhancementBitmap, L_SelectBitmapData, L_ShiftBitmapData
Topics:	Raster Image Functions: Palettes
	Raster Image Functions: Displaying and Printing
	Color Halftone and Halftone Images
	Grayscale Images
	Saving Window-Leveled Bitmaps
	Raster Image Functions: Processing an Image

Example

This example sets the window level values for painting and processing the bitmap with a custom palette.

void TestFunction(HWND hWnd, pBITMAPHANDLE pBitmap)
{
L_UINT32 x;
RGBQUAD L_HUGE* ptmp;
RGBQUAD L_HUGE* pLUT;
L_INT nLowBit;
L_INT nHighBit;
L_INT nLow;
L_INT nHigh;
L_UINT32 nSize;

/* Change the bitmap to 16-bit grayscale */
L_GrayScaleBitmap(pBitmap, 16 );

L_GetMinMaxBits(pBitmap, &nLowBit, &nHighBit);
L_GetMinMaxVal(pBitmap, &nLow, &nHigh);

nSize = (L_UINT32)(1L<<(pBitmap->HighBit - pBitmap->LowBit + 1));
pLUT = (RGBQUAD L_HUGE*)GlobalAllocPtr(GHND, nSize * sizeof(RGBQUAD));

ptmp = pLUT;
/* fill the first half of the LUT with RED */
for(x=0;x<nSize/2;x++)
{
   ptmp->rgbRed       = 255;
   ptmp->rgbGreen     = 0;
   ptmp->rgbBlue      = 0;
   ptmp->rgbReserved  = 0;
   ptmp++;
}
/* fill the rest with gray values */
for(x=nSize/2;x<nSize;x++)
{
   ptmp->rgbRed       = ((L_UCHAR) ((L_UINT32) (x - nLow) * 255 / (nHigh - nLow)));
   ptmp->rgbGreen     = ptmp->rgbRed;
   ptmp->rgbBlue      = ptmp->rgbGreen;
   ptmp->rgbReserved  = 0;
   ptmp++;
}

L_WindowLevel ( pBitmap, nLowBit, nHighBit,
                (RGBQUAD L_HUGE*)pLUT, nSize, WINDOWLEVEL_PAINT_AND_PROCESSING );

GlobalFreePtr(pLUT);
}