Interior Bundle Table


Related topics include:

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

Interior bundle lookup tables hold collections of interior attribute values.

----------------------------------------------------------------------------------------------------------------------------------------------------------
Table Value Mask                                Description                           Fallback                  PEX
 
----------------------------------------------------------------------------------------------------------------------------------------------------------
PEXLUTVInteriorBundleStyle                                                                                       5.0
                                                  interior style                      PEXInteriorStyleHollow
PEXLUTVInteriorBundleIndex                                                                                       5.0
                                                  interior style index                1
PEXLUTVInteriorBundleReflectionModel                                                                             5.0
                                                  reflection model                    PEXRMNone
PEXLUTVInteriorBundleInterpMethod                                                                                5.0
                                                  surface interpolation method        PEXSurfaceInterpNone
PEXLUTVInteriorBundleBFStyle                                                                                     5.0
                                                  back-facing interior style             PEXInteriorStyleHollow
PEXLUTVInteriorBundleBFIndex                                                                                     5.0
                                                  back-facing interior style index       1
PEXLUTVInteriorBundleBFReflectionModel                                                                           5.0
                                                  back-facing reflection model           PEXRMNone
PEXLUTVInteriorBundleBFInterpMethod                                                                              5.0
                                                  back-facing surface interp. method     PEXSurfaceInterpNone
PEXLUTVInteriorBundleSurfaceApprox                                                                               5.0
                                                  surface approximation               (1 (imp-dep), n/a, n/a)
PEXLUTVInteriorBundleSurfaceColor                                                                                5.0
                                                  surface color                       (PEXColorTypeIndexed, 1)
 
PEXLUTVInteriorBundleReflectionAttributes                                                                        5.0
                                                  reflection attributes               (1.0, 1.0, 1.0, 0.0, 0,0,
                                                                                       (PEXIndexed, 1))
 
PEXLUTVInteriorBundleBFSurfaceColor                                                                              5.0
                                                  back-facing surface color              (PEXColorTypeIndexed, 1)
 
PEXLUTVInteriorBundleBFReflectionAttributes                                                                      5.0
                                                  back-facing reflection attributes      (1.0, 1.0, 1.0, 0.0, 0.0,
                                                                                      (PEXIndexed, 1))
 
PEXLUTVInteriorBundleParaSurfCharacteristics(a)                                                                  5.2
                                                  parametric surface characteristics  (PEXPSCNone, n/a)
 
PEXLUTVInteriorBundleAll5_1 (selects entire table entry except 5.2 items)                                        5.0
 
PEXLUTVInteriorBundleAll5_2 (selects entire table entry)                                                         5.2
 
 
----------------------------------------------------------------------------------------------------------------------------------------------------------
(a)
The requests PEXSetTableEntries, PEXGetTableEntries, PEXGetTableEntry, and PEXGetPredefinedEntries do not operate on the parametric surface characteristics value of an interior table entry.

If the renderer's PHIGS interior bundle mode is False, then the implementation accesses the interior bundle table during rendering whenever the aspect source flag of one of the interior attributes stored in the interior bundle table is PEXBundled. The aspect source flag for each attribute is a member of the pipeline state. The value of the pipeline state's interior bundle index selects the desired entry of the table. The implementation ignores the pipeline state's back-facing interior bundle index, reflectance bundle index, back-facing reflectance bundle index, and parametric surface bundle index: the value of the bundled interior attributes in that entry is used to set the values of these interior attributes in the pipeline state.

When the renderer's PHIGS interior bundle mode is True, the implementation still accesses the interior bundle during rendering whenever the aspect source flag of one of the interior attributes stored in the interior bundle table is PEXBundled. However, which pipeline state index is used to select the desired entry of the table depends on which interior attribute is bundled. The following table defines which pipeline index is used for each interior attribute in the Interior Bundle Table.

Indices Used to Select Bundled Interior Attributes in the
                  PHIGS Interior Bundle Mode

------------------------------------------------------------------------------------ Indices Bundled Interior Attributes ------------------------------------------------------------------------------------ interior bundle index Surface Interior Style Surface Interior Style Index Surface Color Surface Interpolation Method back-facing interior bundle index Backface Surface Interior Style Backface Surface Interior Style Index Backface Surface Color Backface Surface Interpolation Method reflectance bundle index Surface Reflection Model Surface Reflection Attributes back-facing reflectance bundle index Backface Surface Reflection Model Backface Surface Reflection Attributes parametric surface bundle index Surface Approximation Parametric Surface Characteristics ------------------------------------------------------------------------------------

For more information about each surface interior attribute, see the corresponding surface interior attribute output command. (These output commands set pipeline state which is used whenever the aspect source flag for a surface interior attribute is PEXIndividual rather than PEXBundled.)

Direct color components that are out of range are treated in an implementation-dependent way. If you specify an unsupported color type, then the implementation issues a BadPEXColorType error. If the color type is PEXColorTypeIndexed and the color index is 65535, then the implementation issues a BadValue error. If you specify an unsupported interior style, back-facing interior style, reflection model, back-facing reflection model, surface interpolation method, back-facing surface interpolation method, surface approximation method, or parametric surface characteristics type, if a chordal size or chordal deviation surface approximation method tolerance is non-positive, if a relative surface approximation method tolerance is outside of the range [0.0, 1.0], if the parametric surface characteristics data record size doesn't match the type, if you specify an isoparametric curve parametric surface characterization placement value that is unsupported, or if a level curves parametric surface characterization direction vector has a zero length, then the implementation issues a BadValue error.

Valid interior bundle lookup table indices are in the range [1, 65535]. The fallback entry is entry 1.