CLIM 2 User Guide

3.4 Medium-level drawing functions in CLIM
The medium-level drawing functions are the lowest level, portable functions for doing graphical output.
They bypass all other high-level facilities, including output recording. They take no drawing options
because these are extracted from the medium. You should use these when performance is the most important.
medium-draw-point*
Arguments: medium x y
[Generic function]
■ Draws a point on the medium medium. The point is drawn at (x,y), transformed by the medium's
current transformation. The ink, clipping region, and line style are gotten from the medium.
medium-draw-points*
[Generic function]
Arguments: medium position-seq
Draws a set of points on the medium medium. position-seq is a sequence of coordinate pairs,
which are real numbers. It is an error if position-seq does not contain an even number of elements.
The coordinates in position-seq are transformed by the medium's current transformation. The ink,
clipping region, and line style are gotten from the medium.
medium-draw-line*
Arguments: medium x1 y1 x2 y2
[Generic function]
■ Draws a line on the medium medium. The line is drawn from (x1,y1) to (x2,y2), with the start
and end positions transformed by the medium's current transformation. The ink, clipping region, and
line style are gotten from the medium.
medium-draw-lines*
Arguments: medium position-seq
[Generic function]
■ Draws a set of disconnected lines on the medium medium. position-seq is a sequence of
coordinate pairs, which are real numbers. It is an error if position-seq does not contain an even
number of elements. The coordinates in position-seq are transformed by the medium's current
transformation. The ink, clipping region, and line style are gotten from the medium.
medium-draw-rectangle*
Arguments: medium x1 y1 x2 y2 filled
[Generic function]
■ Draws a rectangle on the medium medium. The corners of the rectangle are at (x1,y1) and
(x2,y2), with the corner positions transformed by the medium's current transformation. If filled
is t, the rectangle is filled, otherwise it is not. The ink, clipping region, and line style are gotten from
the medium.
medium-copy-area
[Generic function]
Arguments: from-medium from-x from-y width height to-medium to-x to-y
&optional (boole-fun boole-1)
■ Copies the pixels from from-medium starting at the position specified by (from-x,from-y)
to the position (to-x,to-y) onto-medium. A rectangle whose width and height is specified by
width and height is copied. from-x, from-y, to-x, and to-y are specified in user coordinates.
(If medium is a sheet or a stream, then from-x and from-y are transformed by the user
transformation.)
38 CLIM 2.2 User Guide