LBitmapSettings::SetUserMatchTable

Summary

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

Syntax

#include "ltwrappr.h"

static L_UINT * LBitmapSettings::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 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

Platforms

Win32, x64.

See Also

Functions

Topics

Example

For an example, refer to LBitmapSettings::CreateUserMatchTable.

Help Version 22.0.2023.2.2
Products | Support | Contact Us | Intellectual Property Notices
© 1991-2023 LEAD Technologies, Inc. All Rights Reserved.

LEADTOOLS Raster Imaging C++ Class Library Help
Introduction
Version History
Getting Started
LEADTOOLS Raster Imaging Features
Redistributables/Files To Be Included With Your Application
Quick Reference
Classes and Member Functions
Summary of Features
Products | Support | Contact Us | Intellectual Property Notices
© 1991-2023 LEAD Technologies, Inc. All Rights Reserved.