new-page

Arguments: &optional graphical-stream

Prepares a graphical-stream for drawing on a fresh page.

If graphical-stream is a printer stream, then the physical printer is instructed to eject the current sheet of paper and begin drawing on another one. The current-position-x of the stream is also set to the stream's left-margin, and the current-position-y is set to the top-margin. This allows text stream output to continue at the upper-left margin of the new page.

For other graphical streams (windows, the screen, and bitmap-streams), new-page simply calls clear-page to draw a blank background on which to draw content.

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.