Marker Glyph Table


Related topics include:

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

Each entry of a marker glyph table defines a marker type.

-------------------------------------------------------------------------------------------------------------------
Table Value                                             Description                   Fallback                  PEX
Mask
-------------------------------------------------------------------------------------------------------------------
PEXLUTVMarkerGlyphType                                                                                          5.2
                                                        marker glyph type             PEXMarkerTypeAsterisk(a)
                                                        size of data                  n/a
                                                        marker glyph data             n/a
PEXLUTVMarkerGlyphAll5_2 (selects entire table entry)                                                           5.2
-------------------------------------------------------------------------------------------------------------------

(a)
Registered marker type PEXMarkerTypeAsterisk of enumerated type PEXMarkerType.

The superseded requests PEXSetTableEntries, PEXGetTableEntries, PEXGetTableEntry, and PEXGetPredefinedEntries do not operate on marker glyph tables.

The implementation accesses the marker glyph table whenever a marker is rendered. Each entry of a marker glyph table consists of a marker glyph type and the data for that glyph.

PEXlib defines the following values:

marker glyph type:
The value of the pipeline state's marker glyph type selects the desired entry of the table.

PEXMarkerGlyphTypeStroke -
Defines the marker glyph through a list of unconnected 2D polylines. The vertices are specified in marker normalized coordinates space which extends from -1.0 to 1.0 in both directions. The glyph is oriented at the marker position by mapping the origin of the glyph to the marker position. Marker normalized coordinates space maps to the nominal marker size. A single-coordinate polyline is rendered as a point.

If you specify an unsupported marker glyph type or if the data for a glyph of type PEXMarkerGlyphTypeStroke contains a polyline with no coordinates, then the implementation issues a BadValue error.

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