In This Topic ▼

L_SetPaintContrast

Summary

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

Syntax

#include "l_bitmap.h"

L_LTDIS_API L_INT L_SetPaintContrast(pBitmap, nValue)

Parameters

pBITMAPHANDLE pBitmap

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

L_INT nValue

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

Returns

Value	Meaning
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

Win32, x64, Linux.

Example

This example sets the increases the current paint settings by 100 and then forces a repaint.

L_INT SetPaintContrastExample(pBITMAPHANDLE pBitmap) 
{ 
   L_INT    nRet; 
   L_INT    nContrast; 
   L_UINT   uGamma; 
   L_INT    nIntensity; 
 
   /* Get the values */ 
   nContrast = L_GetPaintContrast(pBitmap); 
   uGamma = L_GetPaintGamma(pBitmap); 
   nIntensity = L_GetPaintIntensity(pBitmap); 
 
   /* Set the new values */ 
   nRet = L_SetPaintContrast(pBitmap, nContrast + 100); 
   if (nRet != SUCCESS) 
      return nRet; 
 
   nRet = L_SetPaintGamma(pBitmap, uGamma + 100); 
   if (nRet != SUCCESS) 
      return nRet; 
 
   return L_SetPaintIntensity(pBitmap, nIntensity + 100); 
}