L_FreeUserMatchTable

#include "l_bitmap.h"

L_LTKRN_API L_INT L_FreeUserMatchTable(pTable)

Frees the table that is used to speed conversion when using a palette that you create.

Parameters

L_UINT* pTable

The pointer to the table.

Returns

Value	Meaning
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:

Call L_CreateUserMatchTable to create the table.
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.)
Call L_ColorResBitmap with the CRF_USERPALETTE and CRF_FASTMATCHPALETTE options.
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.

L_FreeUserMatchTable

Parameters

L_UINT* pTable

Returns

Comments

Functions

Topics

Example