All Manuals > CAPI User Guide and Reference Manual > 22 GRAPHICS-PORTS Reference Entries

draw-ellipse Function

Summary

Draws an ellipse.

Package

graphics-ports

Signature

draw-ellipse port x y x-radius y-radius &rest args &key filled

Arguments
port
A graphics port.
A real number.
A real number.
x-radius
A real number.
y-radius
A real number.
args
graphics-state parameters passed as keyword arguments.
filled
A boolean.
Description

The function draw-ellipse draws an ellipse of the given radii x-radius and y-radius centered on (x y). The transform, foreground, background, operation, thickness, scale-thickness, mask, shape-mode and compositing-mode from port's graphics-state are all used, unless overridden in args. When filled is true, the ellipse is filled with the foreground color.

Notes
  1. draw-ellipse does not work properly under a rotation transform when port's drawing-mode is :compatible. A workaround is to use a many-sided polygon drawn by draw-polygon which will be rotated correctly.
  2. draw-ellipse does work properly under any transform when port's drawing-mode is :quality.
  3. See make-transform for information about rotation transforms.
  4. For more information about drawing-mode, see 13.2.1 The drawing mode and anti-aliasing.
Examples
(gp:draw-ellipse port 100 100 20 40)
(gp:draw-ellipse port 100 100 50 10
                       :filled t
                       :foreground :green)
See also

graphics-state
13 Drawing - Graphics Ports


CAPI User Guide and Reference Manual (Macintosh version) - 01 Dec 2021 19:31:44