Flags for the L_SetDisplayMode Function

The following are the possible values for the L_SetDisplayMode function:

Value

Meaning

DISPLAYMODE_ORDEREDDITHER

[0x00000001] Enables or disables ordered dithering when painting. Ordered dithering is faster than the default dithering method, which uses error diffusion, but the quality of the image is not as good.

DISPLAYMODE_FASTPAINT

[0x00000002] Enables or disables fast painting. Fast painting should be performed only if the current video driver is good, and the image does not need to be dithered or resized to paint. No safety check for a faulty driver is performed.

DISPLAYMODE_INDEXEDPAINT

[0x00000004] Enables or disables painting that is mapped directly to the selected palette. This is enabled by default; you can set this flag to disable it and let Windows do color matching between the paint palette and the selected palette. Indexed painting uses the colors from the currently selected palette. It is not used if the image is not palettized.

DISPLAYMODE_DITHEREDPAINT

[0x00000008] Enables or disables dithered painting. This is enabled by default, but you can set this flag to false to disable it. When enabled, Floyd-Steinberg dithering is used to dither true color or high color images on devices that are 8 bits per pixel or less. When disabled, the device is responsible for color reduction. If this flag is set, LEADTOOLS handles the dithering. If this flag is not set, the display driver or the printer driver handles the dithering.

DISPLAYMODE_SCALETOGRAY

[0x00000010] (Document and Medical Imaging toolkits) Enables grayscaling of 1-bit images when they are displayed. This improves the readability of the images when they are zoomed in or zoomed out, but it slows down the display. If you enable grayscaling, you must call L_CreatePaintPalette, then select and realize the palette before painting an image.

DISPLAYMODE_HALFTONEPRINT

[0x00000020] Enables use of the printing halftone (rather than the viewing halftone) when painting to a 1-bit device. This is useful if you are using the L_PaintDC function for printing.

DISPLAYMODE_FAVORBLACK

[0x00000040] (Document and Medical Imaging toolkits) Enables a bias in preserving black objects when displaying zoomed-out 1-bit images. This can prevent the disappearance of fine lines and details, but it slows down the display.

DISPLAYMODE_FIXEDPALETTE

[0x00000080] Forces the use of a fixed palette when painting to a device that supports 256 colors or less. When this flag is off, the bitmap handle controls palette usage. When this flag is on, the default is the LEAD fixed palette, but on 256-color devices, the Netscape palette is used if the DISPLAYMODE_NETSCAPEPALETTE flag is also set.

DISPLAYMODE_NETSCAPEPALETTE

[0x00000100] Sets the Netscape fixed palette as the preferred fixed palette when painting to a device that supports 256 colors. This fixed palette is employed by both Netscape Navigator and Microsoft Internet Explorer.

DISPLAYMODE_RESAMPLE

[0x00000200] Use bilinear interpolation (resample) if the paint process needs to resize the image. (slower than regular resize)

DISPLAYMODE_BICUBIC

[0x00000400] Use bicubic interpolation if the paint process needs to resize the image. (slower than DISPLAYMODE_RESAMPLE)

DISPLAYMODE_IGNORECOLORORDER

[0x00000800] Paint RGB bitmaps the same way as BGR bitmaps on 24-bit displays. Set this flag only if you want RGB bitmaps to be painted the same way as BGR bitmaps.

DISPLAYMODE_GDIPLUS

[0x00001000] Paint using GDI+. When this mode is set, LEADTOOLS will use GDI+ internally to paint the image instead of normal Windows GDI. GDI+ painting is generally slower than GDI however it offers support for painting the alpha channel values of 32-bit and 64-bit images as well as support for transparent colors if the bitmap has the Transparency flag set.

Note that setting this flag will internally load the Microsoft GDI+ runtime (gdiplus.dll).

DISPLAYMODE_RESETPOSITIONS

[0xFFFFFFFF] (Used only in the uFlagPos parameter) Applies the function to all flags.