LBitmapSettings::SetDisplayMode

#include "ltwrappr.h"

static L_UINT32 LBitmapSettings::SetDisplayMode(uFlagPos, uFlagSet)

L_UINT32 uFlagPos;

/* flag */

L_UINT32 uFlagSet;

/* flags 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 LBitmapSettings::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 LBitmapSettings::SetDisplayMode Function for descriptions of the flags.

Returns

None

Comments

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:

image\sqrblit.gif To turn a flag on, specify it in the first parameter and the second.

image\sqrblit.gif 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:

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

For the fastest paint, neither DISPLAYMODE_BICUBIC nor DISPLAYMODE_RESAMPLE should be set.

DISPLAYMODE_RESAMPLE and DISPLAYMODE_BICUBIC cannot be combined.

When painting 1BPP images, DISPLAYMODE_FAVORBLACK and DISPLAYMODE_SCALETOGRAY take precedence over DISPLAYMODE_RESAMPLE and DISPLAYMODE_BICUBIC.

DISPLAYMODE_RESAMPLE is faster than DISPLAYMODE_BICUBIC, but DISPLAYMODE_BICUBIC produces better results when zooming in on images. When zooming out, DISPLAYMODE_BICUBIC and DISPLAYMODE_RESAMPLE produce the same effect.

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.

See Also

Functions:

LBitmapSettings::GetDisplayMode

Topics:

Raster Image Functions: Displaying Images

 

Raster Image Functions: Palettes

 

Handling Palette Changes

Example

For an example, refer to LBitmapSettings::GetDisplayMode.