L_SetPaintContrast

#include "l_bitmap.h"

L_INT EXT_FUNCTION L_SetPaintContrast(pBitmap, nValue)

pBITMAPHANDLE pBitmap;

/* pointer to the bitmap handle */

L_INT nValue;

/* amount of contrast change */

Sets the contrast value for the specified bitmap. This value can be retrieved using the L_GetPaintContrast function.

Parameter

Description

pBitmap

Pointer to the bitmap handle that references the bitmap to be affected. This cannot be NULL.

nValue

Amount of contrast change. Valid values are -1000 to +1000.

Returns

SUCCESS

The function was successful.

< 1

An error occurred. Refer to Return Codes.

Comments

When applying contrast, gamma, and intensity changes to a bitmap, LEAD applies the changes in the following order:

Contrast

Intensity

Gamma

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_GetPaintContrast, L_GetPaintGamma, L_SetPaintGamma, L_GetPaintIntensity, L_SetPaintIntensity

Topics:

Raster Image Functions: Displaying Images

 

Changing Brightness and Contrast

 

Raster Image Functions: Changing Brightness and Contrast

Example

/* This example sets the increases the current paint settings */
/* by 100 and then forces a repaint */
L_INT nContrast;
L_UINT uGamma;
L_INT nIntensity;
BITMAPHANDLE LeadBitmap; /* you must load the bitmap before using the following code */

/* Get the values */
nContrast = L_GetPaintContrast (&LeadBitmap);
uGamma = L_GetPaintGamma (&LeadBitmap);
nIntensity = L_GetPaintIntensity (&LeadBitmap);
/* Set the new values */
L_SetPaintContrast 
(&LeadBitmap, nContrast + 100);
L_SetPaintGamma
 (&LeadBitmap, uGamma + 100);
L_SetPaintIntensity
 (&LeadBitmap, nIntensity + 100);