SECTION 5.2
401
Text State Param eters and Operators
5.2.5 Text Rendering Mode
The text rendering mode,
T
mode
, determines whether showing text causes glyph
outlines to be stroked, filled, used as a clipping boundary, or some combination
of the three. Stroking, filling, and clipping have the same effects for a text object
as they do for a path object (see Sections 4.4.2, “Path-Painting Operators,” and
ferent way. The graphics state parameters affecting those operations, such as line
width, are interpreted in user space rather than in text space.
Note:
The text rendering mode has no effect on text displayed in a Type 3 font (see
The text rendering modes are shown in Table 5.3. In the examples, a stroke color
of black and a fill color of light gray are used. For the clipping modes (4 to 7), a
series of lines has been drawn through the glyphs to show where the clipping
occurs.
If the text rendering mode calls for filling, the current nonstroking color in the
graphics state is used; if it calls for stroking, the current stroking color is used. In
modes that perform both filling and stroking, the effect is as if each glyph outline
were filled and then stroked in separate operations. If any of the glyphs overlap,
the result is equivalent to filling and stroking them one at a time, producing the
appearance of stacked opaque glyphs, rather than first filling and then stroking
them all at once (see implementation note 57 in Appendix H). In the transparent
imaging model, these combined filling and stroking modes are subject to further
considerations; see “Special Path-Painting Considerations” on page 569.
The behavior of the clipping modes requires further explanation. Glyph outlines
begin accumulating if a
BT
operator is executed while the text rendering mode is
set to a clipping mode or if it is set to a clipping mode within a text object. Glyphs
accumulate until the text object is ended by an
ET
operator; the text rendering
mode must not be changed back to a nonclipping mode before that point.