Data Mapping Table

Related topics include:

• The data structure, PEXDataMappingValues
• Table Types, Availability, and Definitions

For an overview and a list of lookup tables, see Lookup Tables.

Use data mapping lookup tables to define how the implementation maps color or other application-specific data in order to determine the intrinsic color of fill area output primitives with extended data.

---------------------------------------------------------------------------------------------------------------------
Table Value Mask                                        Description                            Fallback           PEX
 
---------------------------------------------------------------------------------------------------------------------
PEXLUTVDataMappingMethod                                                                                           5.2
                                                        data mapping method          PEXDMMNone
PEXLUTVDataMappingSourceSelectors                                                                                  5.2
                                                        number of source selectors             3
                                                        prioritized list of source selectors   {PEXVertexColor,
                                                                                                PEXFacetColor,
                                                                                                PEXSurfaceColor}
PEXLUTVDataMappingAll5_2 (selects entire table entry)                                                              5.2
---------------------------------------------------------------------------------------------------------------------

Data mapping is the first stage in the color pipeline.

The superseded functions PEXSetTableEntries, PEXGetTableEntries, PEXGetTableEntry, and PEXGetPredefinedEntries do not operate on data mapping lookup tables.

PEXlib defines the following values:

data mapping method:

PEXDMMNone -

indicates no data mapping method.

PEXDMMColor -

maps color, or other application-specific data, to intrinsic color.

The data mapping table is accessed during rendering whenever the pipeline state's data map method ASF or bf data map method ASF entry is PEXBundled. The values of the pipeline state's data map index and bf data map index select the desired entries of the table.

If you specify an unsupported data mapping method, if the data record size doesn't match the method, or if the method is PEXDMMColor and you specify an undefined source selector, then the implementation issues a BadValue error.

Valid data mapping table indices are in the range [1, 65535]. The fallback entry is entry 1.