3.2.1 Set of CLIM Drawing Options

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-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 .

: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.