Arguments: stream graphics-context
Sets the various drawing style options of stream to the values that have been saved in graphics-context. 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.
Note: incompatible change in release 6.0: in releases prior
to 6.0, when a frame-with-single-child instance
was passed to this operator, the operator was actually applied to the
child (the result of applying frame-child to the
frame-with-single-child instance). In release 6.0, this redirection no
longer occurs. If you intend this operator to apply to the
frame-child, pass that to this operator rather than the parent. This
is a non-backward-compatible-change. See the release notes for more
information.
Common Graphics and IDE documentation is described in About Common Graphics and IDE documentation in cgide.htm.
The documentation is described in introduction.htm and the index is in index.htm.
Copyright (c) 1998-2000, Franz Inc. Berkeley, CA., USA. All rights reserved.
Created 2000.10.5.