Determine where to draw graphics objects
newplot
h = newplot
h = newplot(sv)
newplot prepares a figure
and axes for subsequent graphics commands.
h = newplot prepares a figure and axes for subsequent
graphics commands and returns the current axes.
h = newplot(sv) does not delete any objects specified
by the sv argument, which can be a vector of graphics objects. The
figure and axes containing the objects in sv are prepared for
plotting instead of the current axes of the current figure. If sv is
empty, newplot behaves as if it were called without any
inputs.
To create a simple 2-D plot, use the plot function
instead.
Use newplot at the beginning of high-level
graphics code 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.
First, newplot reads the current figure's NextPlot property
and acts accordingly.
NextPlot | What Happens |
|---|---|
| Create a new figure and use it as the current figure. |
| Draw to the current figure without clearing any graphics objects already present. |
| Remove all child objects whose This clears the current figure
and is equivalent to issuing the |
| Remove all child objects (regardless of the setting of
the
This clears and resets the current figure and
is equivalent to issuing the |
After newplot establishes which figure to
draw in, it reads the current axes' NextPlot property
and acts accordingly.
NextPlot | Description |
|---|---|
| Add new plots to the existing axes. Do not delete existing plots or reset axes properties before displaying the new plot. |
| Delete existing plots before displaying the new plot. Reset the
|
|
Delete existing plots and reset all axes properties, except
|
|
|
Delete existing plots and reset all axes properties, except
For axes with only one y-axes, the
|