Name

clf — clear or reset the current graphic figure (window) to default values

Calling Sequence

clf(<opt_job_arg>)
clf(h,<opt_job_arg>)
clf(num,<opt_job_arg>)

Parameters

h

a handle, the figure handle

num

a number, the figure_id

<opt_job_arg>

a string ( 'clear' or 'reset' ) specifying the job for clf.

Description

The clf command is used to reset a figure to its default values and/or to delete all its children.

If opt_job_arg string value is 'clear' then all children of the specified figure are deleted.

If opt_job_arg string value is 'reset' then not only all children of the specified figure are deleted but the figure properties are reset to their default values using the default figure model (see gdf). The only exception are the axes_size and figure_size properties which can not be reset if the figure is docked with other elements.

clf(num) clear or reset the figure with figure_id==num.

clf(h) clear or reset the figure pointed to by the handle h.

clf() clear or reset the current figure.

clf function delete every children of specified windows including menus and uicontrols added by user. To prevent menus and uicontrols from being deleted, the delete(gca()) command might be used instead.

Examples

 
f4=scf(4);  //creates figure with id==4 and make it the current one
f4.color_map = jetcolormap(64);
f4.figure_size = [400, 200];
plot2d()
clf(f4,'reset')
   
f0=scf(0); //creates figure with id==0 and make it the current one
f0.color_map=hotcolormap(128); // change color map
t=-%pi:0.3:%pi;
plot3d1(t,t,sin(t)'*cos(t));

clf() // equivalent to clf(gcf(),'clear')
plot3d1(t,t,sin(t)'*cos(t));  // color_map unchanged
   
clf(gcf(),'reset')
plot3d1(t,t,sin(t)'*cos(t));  // color_map changed (back to the default one with 32 colors)
 

See Also

set , get , gcf , gdf , scf , graphics_entities

Authors

S. Steer & F.Leray INRIA