L_SetPaintContrast

#include "l_bitmap.h"

L_LTDIS_API L_INT 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 2000 / XP/Vista, 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 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;
   nRet = L_SetPaintIntensity (pBitmap, nIntensity + 100);
   if(nRet != SUCCESS)
      return nRet;
   return SUCCESS;
}