LBitmapSettings::FreeUserMatchTable

Show in webframe

#include "ltwrappr.h"

static L_INT LBitmapSettings::FreeUserMatchTable(pTable)

L_UINT * 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.
< 0	An error occurred. Refer to Return Codes.

Comments

This function is used with other functions in the following sequence:

1.	Call LBitmapSettings::CreateUserMatchTable to create the table.
2.	Call LBitmapSettings::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 LBitmapBase::ColorRes with the CRF_USERPALETTE and CRF_FASTMATCHPALETTE options.
4.	Call LBitmapSettings::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

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.

Platforms

Win32, x64.

See Also

Functions:	LBitmapBase::ColorRes, LBitmapSettings::DefaultDithering, LBitmapSettings::CreateUserMatchTable, LBitmapSettings::SetUserMatchTable, Class Members
Topics:	Raster Image Functions: Doing Color Expansion or Reduction
	Raster Image Functions: Doing Color Space Conversions
	Raster Image Functions: Palettes

Example

For an example, refer to LBitmapSettings::CreateUserMatchTable.