In This Topic ▼

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.

Platforms

Win32, x64.

Example

L_INT LBitmapBase__SetDisplayModeExample() 
{ 
   L_INT nRet; 
   LBitmapBase MyBitmap; 
 
   nRet =MyBitmap.Load(MAKE_IMAGE_PATH(TEXT("image1.cmp")),24); 
   if(nRet !=SUCCESS) 
      return nRet; 
   nRet =MyBitmap.SetDisplayMode(DISPLAYMODE_SCALETOGRAY, DISPLAYMODE_SCALETOGRAY); 
   if(nRet !=SUCCESS) 
      return nRet; 
 
   return SUCCESS; 
}

Download our FREE evaluation

Help Version 20.0.2020.4.5

LEADTOOLS Raster Imaging C++ Class Library Help

Introduction

Version History

Getting Started

LEADTOOLS Raster Imaging Features

Redistributables/Files To Be Included With Your Application

Quick Reference

Tutorials

Classes and Member Functions

Summary of Features

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