API reference / Common / Engine types / TextRegularRun

Interface: TextRegularRun

One text-showing operator — Tj, TJ, ' or " — of a TextObject, placed by its own text matrix.

A run's glyphs are stored as their original PDF encoding bytes in chunks — the render / save truth, untouched by import. Unicode and codepoint offsets (for selection / copy / search / editing) are a projection off those bytes via the font's ToUnicode, never stored.

nonstroking_style and stroking_style are always present even when text_style.render_mode indicates the run paints neither — preserving the gs state at the run gives round-trip emit the colors / line widths it needs and makes editor toggles like "turn on stroke" a one-line change.

Properties

Property	Description
textStyle TextStyle	-
nonstrokingStyle NonstrokingStyle	-
strokingStyle StrokingStyle	-
renderStyle RenderStyle	-
softMask string | null	-
chunks TextChunk[]	-
textMatrix Affine	The text matrix (Tm) at the operator, in the object's Y-down local space: where the run's pen starts, and the scale, skew and rotation its glyphs are set with.
markedContent MarkedContent | null	The marked-content sequence around exactly this operator, or None: a /Span <</ActualText …>> around a ligature, say.