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.

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-2016, Franz Inc. Oakland, CA., USA. All rights reserved.
This page was not revised from the 8.1 page.
Created 2010.1.21.