Previous Next

                                               401
     SECTION 5.2                                       Text State Param eters and Operators



5.2.5 Text Rendering Mode

     The text rendering mode, Tmode , 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
     4.4.3, “Clipping Path Operators”), although they are specified in an entirely dif-
     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
     Section 5.5.4, “Type 3 Fonts”).

     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.

Previous Next