Products | Support | Send comments on this topic. | Email a link to this topic. | Back to Getting Started | Help Version 18.0.11.1
LEADTOOLS Raster Imaging C DLL Help

L_SetUserMatchTable

Show in webframe

#include "l_bitmap.h"

L_LTKRN_API L_UINT* L_SetUserMatchTable(pTable)

L_UINT* pTable;

/* pointer to the table */

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

Parameter

Description

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.

Products | Support | Contact Us | Copyright Notices
© 2006-2014 All Rights Reserved. LEAD Technologies, Inc.