newplot
Determine where to draw graphics objects
Syntax
newplot
h = newplot
h = newplot(sv)
Description
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 thesv
argument, which can be a vector of graphics objects. The figure and axes containing the objects insv
are prepared for plotting instead of the current axes of the current figure. Ifsv
is empty,newplot
behaves as if it were called without any inputs.
Tips
To create a simple 2-D plot, use theplot
function instead.
Usenewplot
at the beginning of high-level graphics code to determine which figure and axes to target for graphics output. Callingnewplot
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.
删除所有现有的对象处理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 axesNextPlot
properties determine hownewplot
behaves. The following two tables describe this behavior with various property values.
First,newplot
reads the current figure'sNextPlot
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 |
Afternewplot
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 oney-axes, the |