frame                package:graphics                R Documentation

Create / Start a New Plot Frame

Description:

     This function ('frame' is an alias for 'plot.new') causes the
     completion of plotting in the current plot (if there is one) and
     an advance to a new graphics frame.  This is used in all
     high-level plotting functions and also useful for skipping plots
     when a multi-figure region is in use.

Usage:

     plot.new()
     frame()

Details:

     The new page is painted with the background colour ('par("bg")'),
     which is often transparent.  For devices with a _canvas_ colour
     (the on-screen devices 'X11', 'windows' and 'quartz'), the window
     is first painted with the canvas colour and then the background
     colour.

     There is a hook called '"plot.new"' (see 'setHook') called
     immediately after advancing the frame, which is used in the
     testing code to annotate the new page.  The hook function(s) are
     called with no argument.  (If the value is a character string,
     'get' is called on it from within the 'graphics' name space.)

References:

     Becker, R. A., Chambers, J. M. and Wilks, A. R. (1988) _The New S
     Language_. Wadsworth & Brooks/Cole. ('frame'.)

See Also:

     'plot.window', 'plot.default'.

