static L_INT LBitmapSettings::FreeUserMatchTable(pTable)
Frees the table that is used to speed conversion when using a palette that you create.
The pointer to the table.
Value | Meaning |
---|---|
SUCCESS | The function was successful. |
< 0 | An error occurred. Refer to Return Codes. |
This function is used with other functions in the following sequence:
Call LBitmapSettings::CreateUserMatchTable to create the table.
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.)
Call LBitmapBase::ColorRes with the CRF_USERPALETTE and CRF_FASTMATCHPALETTE options.
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.
Win32, x64.
For an example, refer to LBitmapSettings::CreateUserMatchTable.
Help Collections
Raster .NET | C API | C++ Class Library | HTML5 JavaScript
Document .NET | C API | C++ Class Library | HTML5 JavaScript
Medical .NET | C API | C++ Class Library | HTML5 JavaScript
Medical Web Viewer .NET
Multimedia
Direct Show .NET | C API | Filters
Media Foundation .NET | C API | Transforms
Supported Platforms
.NET, Java, Android, and iOS/macOS Assemblies
Imaging, Medical, and Document
C API/C++ Class Libraries
Imaging, Medical, and Document
HTML5 JavaScript Libraries
Imaging, Medical, and Document