LBitmapBase::SetDisplayMode

#include "ltwrappr.h"

L_INT LBitmapBase::SetDisplayMode(uFlagPos, uFlagSet)

L_UINT32 uFlagPos;	/* flag or flags to be changed */
L_UINT32 uFlagSet;	/* flags (of those in uFlagPos) to be turned on */

Sets flags that control the speed, quality, and style of painting operations.

Parameter	Description
uFlagPos	The flag or flags to be changed. You can use a bitwise OR ( \| ) to specify more than one flag. You can use DISPLAYMODE_RESETPOSITIONS to indicate all flags.
	Refer to Flags for the LBitmapBase::SetDisplayMode Function for descriptions of the flags.
uFlagSet	The flags (of those specified in the uFlagPos parameter) to be turned on. You can use a bitwise OR ( \| ) to include more than one flag. You can use 0 to turn off all the flags specified in the uFlagPos parameter.
	Refer to Flags for the LBitmapBase::SetDisplayMode Function for descriptions of the flags.

Returns

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

Comments

This will be the local display mode setting for the class object and is used when painting the bitmap.

The first parameter specifies which flags are affected, and the second specifies which of those to turn on. The other affected flags are turned off.

Therefore:

To turn a flag on, specify it in the first parameter and the second.
To turn a flag off, specify it in the first parameter, but not the second.

For example, the following statement turns on fast painting, turns off dithered painting, and leaves all other flags as they were:

MyBitmapBase::SetDisplayMode(DISPLAYMODE_FASTPAINT | DISPLAYMODE_DITHEREDPAINT, DISPLAYMODE_FASTPAINT );

Required DLLs and Libraries

LTDIS
LTFIL

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

See Also

Functions:	LBitmapBase::GetDisplayMode, LBitmapBase::EnableLocalSettings, LBitmapBase::IsLocalSettingsEnabled, Class Members
Topics:	Raster Image Functions: Displaying Images
	Raster Image Functions: Palettes
	Handling Palette Changes

Example

L_INT LBitmapBase__SetDisplayModeExample()
{
   L_INT nRet;
   LBitmapBase MyBitmap;
   nRet =MyBitmap.Load(TEXT("%UserProfile%\\My Documents\\LEADTOOLS Images\\image1.cmp"),24);
   if(nRet !=SUCCESS)
      return nRet;
   nRet =MyBitmap.SetDisplayMode(DISPLAYMODE_SCALETOGRAY, DISPLAYMODE_SCALETOGRAY);
   if(nRet !=SUCCESS)
      return nRet;
   return SUCCESS;
}