begin-drawing-path

Arguments: stream

Begins collecting subsequent line-drawing function calls on stream into a "path". Must be followed by a call to end-drawing-path at some point, which actually draws the entire path. stream should be a cg-stream.

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, end-drawing-path, and with-drawing-path.

GTK Note

Drawing paths are not implemented on GTK. If you need to draw a connected series of lines with the proper line-join effect, you may need to call draw-polyline instead of multiple calls to draw-line, though the line-join setting may have no effect on some machines in any case.

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.