If no figures exist, gco returns [].

See also GCBO, GCF, GCA, GCBF.

GCF Get handle to current figure.

H = GCF returns the handle of the current figure. The current figure is the window into which graphics commands like PLOT, TITLE, SURF, etc. will draw.

The handle of the current figure is stored in the root property CurrentFigure, and can be queried directly using GET, and modified using FIGURE or SET.

Clicking on uimenus and uicontrols contained within a figure, or clicking on the drawing area of a figure cause that figure to become current.

The current figure is not necessarily the frontmost figure on the screen.

GCF should not be relied upon during callbacks to obtain the handle of the figure whose callback is executing - use GCBO for that purpose.

See also FIGURE, CLOSE, CLF, GCA, GCBO, GCO, GCBF.

GCA Get handle to current axis.

H = GCA returns the handle to the current axis in the current figure. The current axis is the axis that graphics commands like PLOT, TITLE, SURF, etc. draw to if issued.

Use the commands AXES or SUBPLOT to change the current axis to a different axis, or to create new ones.

See also AXES, SUBPLOT, DELETE, CLA, HOLD, GCF, GCBO, GCO, GCBF.

GCBF Get handle to current callback figure.

FIG = GCBF returns the handle of the figure that contains the object whose callback is currently executing. If the current callback object is the figure, the figure is returned.

When no callbacks are executing, GCBF returns [].

The return value of GCBF is identical to the FIGURE output argument of GCBO.

See also GCBO, GCO, GCF, GCA.

CLA Clear current axis.

CLA deletes all children of the current axes with visible handles.

CLA RESET deletes all objects (including ones with hidden handles) and also resets all axes properties, except Position and Units, to their default values.

See also CLF, RESET, HOLD.

CLF Clear current figure.

CLF deletes all children of the current figure with visible handles.

CLF RESET deletes all children (including ones with hidden handles) and also resets all figure properties, except Position and Units, to their default values.

See also CLA, RESET, HOLD.

FEVAL Execute the specified function

FEVAL(F,x1,...,xn) evaluates the function specified by a function handle or function name, F, at the given arguments, x1,...,xn.

For example, if F = @foo, FEVAL(F,9.64) is the same as foo(9.64).

If a function handle is bound to more than one built-in or M-file, (that is, it represents a set of overloaded functions), then the data type of the arguments x1 through xn, determines which function is executed.

FEVAL is usually used inside functions which take function handles or function strings as arguments. Examples include FZERO and EZPLOT.

[y1,..,yn] = FEVAL(F,x1,...,xn) returns multiple output arguments.

Within methods that overload built-in functions, use BUILTIN(F,...) to execute the original built-in function. Note that when using BUILTIN, F must be a function name and not a function handle.

See also BUILTIN.

Overloaded methods

help inline/feval.m

BUILTIN Execute built-in function from overloaded method.

BUILTIN is used in methods that overload built-in functions to execute the original built-in function. If F is a string containing the name of a built-in function then BUILTIN(F,x1,...,xn) evaluates that function at the given arguments.

BUILTIN(...) is the same as FEVAL(...) except that it will call the original built-in version of the function even if an overloaded one exists (for this to work, you must never overload BUILTIN).

[y1,..,yn] = BUILTIN(F,x1,...,xn) returns multiple output arguments.

See also FEVAL.

FIGURE Create figure window.

FIGURE, by itself, creates a new figure window, and returns its handle.

FIGURE(H) makes H the current figure, forces it to become visible, and raises it above all other figures on the screen. If Figure H does not exist, and H is an integer, a new figure is created with handle H.

GCF returns the handle to the current figure.

Execute GET(H) to see a list of figure properties and their current values. Execute SET(H) to see a list of figure properties and their possible values.

See also SUBPLOT, AXES, GCF, CLF.