Text Bundle Table


Related topics include:

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

Text bundle lookup tables contain collections of text attribute values.

-------------------------------------------------------------------------------------------------------------------
Table Value                                         Description                       Fallback                  PEX
Mask
-------------------------------------------------------------------------------------------------------------------
PEXLUTVTextBundleFontIndex                                                                                      5.0
                                                    text font index                   1
PEXLUTVTextBundlePrecision                                                                                      5.0
                                                    text precision                   PEXStringPrecision
PEXLUTVTextBundleCharExpansion                                                                                  5.0
                                                    char expansion factor             1.0
PEXLUTVTextBundleCharSpacing                                                                                    5.0
                                                    char spacing                      0.0
PEXLUTVTextBundleColor                                                                                          5.0
                                                    text color                        (PEXColorTypeIndexed, 1)
PEXLUTVTextBundleAll (selects entire table entry)                                                               5.0
-------------------------------------------------------------------------------------------------------------------

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

For more information about each text attribute, see the corresponding text attribute output command. (These output commands set the pipeline state which is used whenever the aspect source flag for a text 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 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 text precision or if a text font index of zero, then the implementation issues a BadValue error.

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