L_FreeUserMatchTable
#include "l_bitmap.h"
L_INT EXT_FUNCTION L_FreeUserMatchTable(pTable)
/* pointer to the table */ |
Frees the table that is used to speed conversion when using a palette that you create.
Parameter |
Description |
pTable |
The pointer to the table. |
Returns
SUCCESS |
The function was successful. |
< 1 |
An error occurred. Refer to Return Codes. |
Comments
This function is used with other functions in the following sequence:
1. |
Call L_CreateUserMatchTable to create the table. |
2. |
Call L_SetUserMatchTable to make this the current table. (Having this as a separate function allows you to save tables in files and get the one you need, without creating it again.) |
3. |
Call L_ColorResBitmap with the CRF_USERPALETTE and CRF_FASTMATCHPALETTE options. |
4. |
Call L_FreeUserMatchTable when the table is no longer needed. |
The completed table occupies 64K bytes of memory. Creation of the table is a slow, memory-intensive process that is useful only if you are using your own palette more than once. For example, you may want to create the table once, save it to a file, and ship that file with your application.
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: |
L_ColorResBitmap, L_DefaultDithering, L_CreateUserMatchTable, L_SetUserMatchTable |
Topics: |
|
|
|
|
Example
Refer to L_CreateUserMatchTable.