LBitmapSettings::SetUserMatchTable
#include "ltwrappr.h"
static L_UINT L_FAR * LBitmapSettings::SetUserMatchTable(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 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. |
See Also
|
Functions: |
LBitmapBase::ColorRes, LBitmapSettings::DefaultDithering, LBitmapSettings::CreateUserMatchTable, LBitmapSettings::FreeUserMatchTable |
|
Topics: |
|
|
|
|
|
|
Example
For an example, refer to LBitmapSettings::CreateUserMatchTable.