Page 80 Table of Contents Index Page 82
Chapters
1, 2, 3, 4, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15, 16, 17, 18, 19, 20, 21, 22, 23, 24, 25, 26, 27, 28, 29, 30
A, B, C, D, E



CHAPTER 10. DRAWING OPTIONS

The :ink ink drawing option temporarily changes the value of (medium-ink medium) to ink,
replacing the previous ink; the new and old inks are not combined in any way.

=> :transformation [Option]
This transforms the coordinates used as arguments to drawing functions to the coordinate system
of the drawing plane. The default value is +identity-transformation+. See Chapter 5 for a
complete description of transformations.

The :transformation xform drawing option temporarily changes the value of(medium-transformation
medium) to (compose-transformations (medium-transformation medium) xform).

=> :clipping-region [Option]
The drawing functions do not affect the drawing plane outside this region. The clipping region
must be an area. Furthermore, some implementations might signal an error if the clipping
region is not a rectangle or a region set composed entirely of rectangles. Rendering is clipped
both by this clipping region and by other clipping regions associated with the mapping from the
target drawing plane to the viewport that displays a portion of the drawing plane. The default is
+everywhere+, or in other words, no clipping occurs in the drawing plane, only in the viewport.

The :clipping-region region drawing option temporarily changes the value of (medium-clipping-
region
medium) to (region-intersection (transform-region (medium-transformation medium)
region) (medium-clipping-region medium)). If both a clipping region and a transformation
are supplied in the same set of drawing options, the clipping region argument is transformed by
the newly composed transformation before calling region-intersection.

Minor issue: A better explanation is needed. It does the right thing, but it's hard to tell that
from this description. That is, the clipping region is expressed in user coordinates. | DCPL

=> :line-style [Option]
The line and arc drawing functions render according to this line style. The line style suboptions
and default are defined in Section 10.3.

The :line-style ls drawing option temporarily changes the value of (medium-line-style
medium) to ls, replacing the previous line style; the new and old line styles are not combined in
any way.

If line style suboptions are supplied, they temporarily change the value of (medium-line-style
medium) to a line style constructed from the specified suboptions. Components not specified by
suboptions are defaulted from the :line-style drawing option, if it is supplied, or else from
the previous value of (medium-line-style medium). That is, if both the :line-style option
and line style suboptions are supplied, the suboptions take precedence over the components of
the :line-style option.

=> :text-style [Option]
The text drawing functions, including ordinary stream output, render text as directed by this
text style merged against the default text style. The default value has all null components. See


Page 80 Table of Contents Index Page 82
Chapters
1, 2, 3, 4, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15, 16, 17, 18, 19, 20, 21, 22, 23, 24, 25, 26, 27, 28, 29, 30
A, B, C, D, E