Line Bundle Table

Related topics include:

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

Line bundle lookup tables contain collections of line attribute values. 

------------------------------------------------------------------------------------------------------------------------------------
Table Value Mask                       Description                         Fallback                PEX
 
------------------------------------------------------------------------------------------------------------------------------------
PEXLUTVLineBundleType                                                                               5.0
                                       line type                           PEXLineTypeSolid
 
PEXLUTVLineBundleInterpMethod                                                                       5.0
                                       interpolation method                PEXPolylineInterpNone
 
PEXLUTVLineBundleCurveApprox                                                                        5.0
                                       curve approximation                 (1 (imp-dep), n/a)
 
PEXLUTVLineBundleWidth                                                                              5.0
                                       line width scale factor             1.0
 
PEXLUTVLineBundleColor                                                                              5.0
                                       line color                          (PEXColorTypeIndexed, 1)
 
 
PEXLUTVLineBundleCapStyle(a)                                                                        5.2
                                       wide cap style                      PEXCapStyleButt
 
PEXLUTVLineBundleJoinStyle(a)                                                                       5.2
                                       wide line join style                PEXJoinStyleImpDep
 
PEXLUTVLineBundleAll5_1 (selects entire table entry except 5.2 items) 
                                                                                                    5.0
 
PEXLUTVLineBundleAll5_2 (selects entire table entry)                                                5.2
 
------------------------------------------------------------------------------------------------------------------------------------

(a)
The requests PEXSetTableEntries, PEXGetTableEntries, PEXGetTableEntry, and PEXGetPredefinedEntries do not operate on the line cap style or join style values of a line bundle entry.

The implementation accesses the line bundle table during rendering whenever the aspect source flag of one of the line attributes stored in the line 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 line bundle index selects the desired entry of the table. The value of the bundled line attributes in that entry is then used to set the values of those line attributes in the pipeline state.

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

Direct color components that are out of range are treated in an implementation-dependent way. If you specify a color type that is unsupported, then the implementation issues a PEXBadColorType 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 line type, interpolation method, curve approximation method, cap style, or join style, if a chordal size or chordal deviation curve approximation method tolerance is non-positive, or if a relative curve approximation method tolerance is outside of the range [0.0, 1.0], then the implementation issues a BadValueerror.

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