set-graphics-context

Arguments: stream graphics-context

Sets the various drawing style options of stream to the values that have been saved in graphics-context. stream should be a cg-stream.

The graphics-context passed in should have been returned by a call to copy-graphics-context, and graphics-context-p should return true for that stream and graphics-context (as it always will if the graphics-context were created from the same stream).

The graphics-context feature allows the various drawing styles such as line-width and font that are currently being used by a drawing stream to be saved into a single graphics-context object, and for that object to later be restored to that stream or another stream whenever that particular combination of drawing styles is desired once again. This can be more convenient than re-specifying each individual drawing style explicitly.

See copy-graphics-context (where all the information in a graphics-context object is described), make-graphics-context, graphics-context-p, and restoring-graphics-context.

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.