Drawing options can be any of the following, plus any of the line-style or text-style suboptions.
:ink
Summary: The drawing functions draw with the color and pattern that this ink specifies. The default value is +foreground-ink+ . Chapter 5, Drawing in Color for a complete description of inks.
The
:ink
drawing option temporarily changes the value of
(medium-ink
medium
)
to
ink
, replacing (not combining) the previous ink.
:transformation
Summary: 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 3.5, The Transformations Used by CLIM 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
Summary: The drawing functions do not affect the drawing plane outside this region, which must be an area . 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-transformationmedium)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 .
:line-style
Summary: The line- and arc-drawing functions render according to this line style. The line style suboptions and default are defined in 3.3, CLIM Line Styles
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 default 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
Summary: 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 Chapter 4, Text Styles for a complete description of text styles, including the text style suboptions.
The
:text-style
ts
drawing option temporarily changes the value of
(medium-text-style
medium
)
to:
(merge-text-styles
ts
(medium-text-style
medium
))
If text-style suboptions are supplied, they temporarily change the value of
(medium-text-style
medium
)
to a text style constructed from the specified suboptions, merged with the
:text-style
drawing option if it is specified, and then merged with the previous value of
(medium-text-style
medium
)
. That is, if both the
:text-style
option and text-style suboptions are supplied, the suboptions take precedence over the components of the
:text-style
option.