Figure Properties - SERC

newplot
2newplot
Purpose Determine where to draw graphics objects
Syntax newplot
h = newplot
h = newplot(hsave)
Description newplot prepares a figure and axes for subsequent graphics commands.
2-1522
h = newplot prepares a figure and axes for subsequent graphics commands
and returns a handle to the current axes.
h = newplot(hsave) prepares and returns an axes, but does not delete any
objects whose handles appear in hsave. If hsave is specified, the figure and axes
containing hsave are prepared for plotting instead of the current axes of the
current figure. If hsave is empty, newplot behaves as if it were called without
any inputs.
Remarks Use newplot at the beginning of high-level graphics M-files to determine which
figure and axes to target for graphics output. Calling newplot can change the
current figure and current axes. Basically, there are three options when you
are drawing graphics in existing figures and axes:
Add the new graphics without changing any properties or deleting any
objects.
Delete all existing objects whose handles are not hidden before drawing the
new objects.
Delete all existing objects regardless of whether or not their handles are
hidden, and reset most properties to their defaults before drawing the new
objects (refer to the following table for specific information).
The figure and axes NextPlot properties determine how newplot behaves. The
following two tables describe this behavior with various property values.