MATLAB Function Reference (Volume 2: Graphics)

newplotPurpose2newplotDetermine where to draw graphics objectsSyntaxDescriptionnewploth = newplotnewplot prepares a figure and axes for subsequent graphics commands.h = newplot prepares a figure and axes for subsequent graphics commandsand returns a handle to the current axes.RemarksUse newplot at the beginning of high-level graphics M-files to determine whichfigure and axes to target for graphics output. Calling newplot can change thecurrent figure and current axes. Basically, there are three options whendrawing graphics in existing figures and axes:• Add the new graphics without changing any properties or deleting anyobjects.• Delete all existing objects whose handles are not hidden before drawing thenew objects.• Delete all existing objects regardless of whether or not their handles arehidden and reset most properties to their defaults before drawing the newobjects (refer to the following table for specific information).The figure and axes NextPlot properties determine how nextplot behaves.The following two tables describe this behavior with various property values.First, newplot reads the current figure’s NextPlot property and actsaccordingly.NextPlotaddreplacechildrenWhat HappensDraw to the current figure without clearing anygraphics objects already present.Remove all child objects whose HandleVisibilityproperty is set to on and reset figure NextPlotproperty to add.This clears the current figure and is equivalent toissuing the clf command.2-306