end-drawing-path

Arguments: stream &key (draw t) (fill nil)

Stops collecting line-drawing function calls on stream into a "path", and then draws and/or fills the entire path as a unit. stream should be a cg-stream.

The path is drawn as specified in the intervening line-drawing function calls if and only if draw is true. The path is filled if and only if fill is true. Either draw or fill (or both) should be true, as otherwise any line-drawing done between the call to begin-drawing-path and the call to end-drawing-path is lost.

A path is useful for filling a collection of lines and curves as a unit. It is also needed in Windows 95/98 (as opposed to NT) in order to use line-end and line-join styles other than :round.

To ensure that end-drawing-path is always called for each call to begin-drawing-path, it is convenient to use with-drawing-path instead of separate calls to begin-drawing-path and end-drawing-path.

See also: line-end, with-line-end, line-join, with-line-join, begin-drawing-path, and with-drawing-path.

Copyright (c) 1998-2002, Franz Inc. Oakland, CA., USA. All rights reserved.
Documentation for Allegro CL version 6.2. This page has had minimal revisions compared to the 6.1 page.
Created 2002.2.26.