scf

Arguments

h

a handle, the figure handle

num

a number, the figure_id

f

the handle of the current figure

Description

The current figure is the destination of the graphic drawing. The scf function allows to change this current figure or to create it if it does not already exist.

scf(num) set the figure with figure_id==num as the current figure. If it does not already exist it is created.

scf(h) set the figure pointed to by the handle h as the current figure. If it does not already exist it is created.

scf() is equivalent to scf(max(winsid())+1). It may be used to create a new graphic window.

Examples

f4=scf(4); //creates figure with id==4 and make it the current one
f0=scf(0); //creates figure with id==0 and make it the current one
plot2d() //draw in current figure (id=0)
scf(f4); // set first created figure as current one
plot3d() //draw in current figure (id=4)

See also

• set — set a property value of a graphic entity object or of a User Interface object.
• get — Retrieve a property value from a graphics entity or an User Interface object.
• gcf — Return handle of current graphic window.
• clf — Clears and resets a figure or a frame uicontrol
• get_figure_handle — get a figure handle from its id
• graphics_entities — description of the graphics entities data structures