L_SetUserMatchTable (original) (raw)

Summary

Selects a table that speeds conversion when using a palette that you create.

Syntax

#include "l_bitmap.h"

L_LTKRN_API L_UINT* L_SetUserMatchTable(pTable)

Parameters

L_UINT* pTable

The pointer to the table.

Returns

The pointer to the previous table.

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

Win32, x64, Linux.

See Also

Functions

• L_ColorResBitmap
• L_DefaultDithering
• L_CreateUserMatchTable
• L_FreeUserMatchTable

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 L_CreateUserMatchTable.

LEADTOOLS Raster Imaging C API Help