Table Types, Availability, and Definitions


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

The following section describes each table in terms of its table entry, the table semantics, and the PEXlib data structure used to manipulate the table entries. Some of the functions described in the following section require a table type argument. The complete list of table types and their corresponding table entry data structure names are:

Table Types and Data Structures
----------------------------------------------------------------------
Table Type         Table Value Data Structure   PEX
----------------------------------------------------------------------
PEXLUTColor           PEXColorValues           5.0
PEXLUTColorApprox     PEXColorApproxValues     5.0
PEXLUTDataMapping     PEXDataMappingValues     5.2
PEXLUTDepthCue        PEXDepthCueValues        5.0
PEXLUTEdgeBundle      PEXEdgeBundleValues      5.0
PEXLUTExtentSize      PEXExtentSizeValues      5.2
PEXLUTHighlight       PEXHighlightValues       5.2
PEXLUTInteriorBundle  PEXInteriorBundleValues  5.0
PEXLUTLight           PEXLightValues           5.0
PEXLUTLineBundle      PEXLineBundleValues      5.0
PEXLUTMarkerBundle    PEXMarkerBundleValues    5.0
PEXLUTMarkerGlyph     PEXMarkerGlyphValues     5.2
PEXLUTPattern         PEXPatternValues         5.0
PEXLUTTextBundle      PEXTextBundleValues      5.0
PEXLUTTextFont        PEXTextFontValues        5.0
PEXLUTTextureMapping  PEXTMValues              5.2
PEXLUTView            PEXViewValues            5.0
 
----------------------------------------------------------------------

The table entries are described in terms of table values, where one or several table items (structure members) are grouped under a table value. For example, matrices which appear in table entries are grouped with their corresponding matrix hints because they logically depend on each other and need to be changed simultaneously by the application. The name of each table value is the PEXlib symbol (beginning with PEXLUTV) that you should use when building the bitmask needed for the table entry manipulation functions PEXChangeTableValues and PEXGetTableValues. If you intend to change or get an entire table entry (all values), there is a convenience symbol for setting all the bits.

For table types where some of the values have corresponding attribute output commands, the Description column in the table in the LUT sections includes a cross-reference for that output command. Please see the specification of the output command for more information about the behavior and allowed values for the corresponding table value. Otherwise, the table value is explained in the text following the table.

To get or set the values you are interested in, use the PEXlib table value data structure. You only need to get or set the members of the structure that correspond to table entry values that you have indicated interest in through the use of the bitmask.

Note: Applications should always use the PEX<table name>Values data structures when manipulating table values with the PEXChangeTableValues and PEXGetTableValues functions. Do not use the PEX<table name>Entry data structures. You should only use the PEX<table name>Entry data structures with the old table entry manipulation functions described in Lookup Table Requests for PEXlib 5.0 and 5.1 Compatibility.