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

draw-polygons Function

Summary

Draws several polygons.

Package

graphics-ports

Signature

draw-polygons port description &rest args &key filled closed fill-rule

Arguments
port
A graphics port.
description
A sequence of sequences of real numbers.
args
graphics-state parameters passed as keyword arguments.
filled
A boolean.
closed
A boolean.
fill-rule
A keyword.
Description

The function draw-polygons draws several polygons in port. description should be a sequence containing sequences with alternating x and y values representing the vertices. description consists of groups of points as in draw-polygon.

When closed is true the edge from the last vertex to the first to be drawn.

When filled is true a filled, closed polygons are drawn; closed is ignored if filled is true.

The transform, foreground, background, operation, thickness, scale-thickness, dashed, dash, line-end-style, line-joint-style, mask, pattern, shape-mode and compositing-mode from port's graphics-state are all used, unless overridden in args. Additionally on X11/Motif only, stipple is used.

fill-rule specifies how overlapping regions are filled. Possible values are :even-odd and :winding.

Examples

This draws two hexagons, one inside the other:

(gp:draw-polygons oo 
           '((150 100 200 100 235 150 200 
              200 150 200  115 150)
             (140 90  210 90  250 150  
              210 210  140 210  100 150))
           :closed t)
See also

draw-polygon
graphics-state
13 Drawing - Graphics Ports


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