L_DefaultDithering
#include "l_bitmap.h"
L_INT EXT_FUNCTION L_DefaultDithering(uMethod)
L_UINT uMethod; |
/* dithering method to use */ |
Specifies the default dithering method to use when converting an image from 64, 48, 32, 24, or 16 bits per pixel to 8 bits per pixel or fewer.
Parameter |
Description |
|
uMethod |
The dithering method to use. Valid values are: |
|
|
Value |
Meaning |
|
NO_DITHERING |
[0] Use no dithering. |
|
FLOYD_STEIN_DITHERING |
[1] Use the Floyd-Steinberg method. |
|
BURKES_DITHERING |
[3] Use the Burkes method. |
|
STUCKI_DITHERING |
[2] Use the Stucki method. |
|
SIERRA_DITHERING |
[4] Use the Sierra method. |
|
STEVENSON_ARCE_DITHERING |
[5] Use the Stevenson-Arce method. |
|
JARVIS_DITHERING |
[6] Use the Jarvis method. |
|
ORDERED_DITHERING |
[7] Use ordered dithering, which is faster than other methods but is lower in quality. |
|
CLUSTERED_DITHERING |
[8] Use clustered dithering. |
Returns
SUCCESS |
The function was successful. |
< 0 |
An error occurred. Refer to Return Codes. |
Comments
Some LEADTOOLS functions automatically dither an image when necessary for display. Those functions use the default dithering method that this function specifies.
For general information about dithering, refer to Color Resolution and Dithering.
Required DLLs and Libraries
LTKRN 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 95 / 98 / Me, Windows 2000 / XP, Windows CE.
See Also
Functions: |
|
|
|
Topics: |
|
|
|
|
|
|
|
|
Example
/* This example sets NO_DITHERING as the default before loading a
24-bit image at 8 bits per pixel. This overrides the normal default, which is
to use Floyd-Steinberg dithering. */
BITMAPHANDLE LeadBitmap; /* Bitmap handle for the final image */
void TestFunction(HWND hWnd)
{
/* Set the default dithering */
L_DefaultDithering(NO_DITHERING);
/* Load the bitmap at 8 bits per pixel */
L_LoadBitmap (TEXT("IMAGE3.CMP"), &LeadBitmap, sizeof(BITMAPHANDLE), 8, 0, NULL, NULL);
/* Update the paint palette */
SendMessage (hWnd, WM_QUERYNEWPALETTE, 0, 0L);
return;
}