Handle Graphics objects

<figure> - Create figure window.

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.

Reference page in Help browser

doc figure

<axes> - Create axes in arbitrary positions.

AXES Create axes in arbitrary positions.

AXES('position', RECT) opens up an axis at the specified location

and returns a handle to it.

RECT = [left, bottom, width, height] specifies the location and

size of the side of the axis box, relative to the lower-left

corner of the Figure window, in normalized units where (0,0)

is the lower-left corner and (1.0,1.0) is the upper-right.

AXES, by itself, creates the default full-window axis and returns

a handle to it.

AXES(H) makes the axis with handle H current.

Execute GET(H) to see a list of axes object properties and

their current values. Execute SET(H) to see a list of axes

object properties and legal property values.

See also subplot, axis, figure, gca, cla.

Reference page in Help browser

doc axes

<line> - Create line.

LINE Create line.

LINE(X,Y) adds the line in vectors X and Y to the current axes.

If X and Y are matrices the same size, one line per column is added.

LINE(X,Y,Z) creates lines in 3-D coordinates.

LINE returns a column vector of handles to LINE objects,

one handle per line. LINEs are children of AXES objects.

The X,Y pair (X,Y,Z triple for 3-D) can be followed by

parameter/value pairs to specify additional properties of the lines.

The X,Y pair (X,Y,Z triple for 3-D) can be omitted entirely, and

all properties specified using parameter/value pairs.

Execute GET(H), where H is a line handle, to see a list of line

object properties and their current values. Execute SET(H) to see a

list of line object properties and legal property values.

See also patch, text, plot, plot3.

Reference page in Help browser

doc line

<text> - Create text.

TEXT Text annotation.

TEXT(X,Y,'string') adds the text in the quotes to location (X,Y)

on the current axes, where (X,Y) is in units from the current

plot. If X and Y are vectors, TEXT writes the text at all locations

given. If 'string' is an array the same number of rows as the

length of X and Y, TEXT marks each point with the corresponding row

of the 'string' array.

TEXT(X,Y,Z,'string') adds text in 3-D coordinates.

TEXT returns a column vector of handles to TEXT objects, one

handle per text object. TEXT objects are children of AXES objects.

The X,Y pair (X,Y,Z triple for 3-D) can be followed by

parameter/value pairs to specify additional properties of the text.

The X,Y pair (X,Y,Z triple for 3-D) can be omitted entirely, and

all properties specified using parameter/value pairs.

Execute GET(H), where H is a text handle, to see a list of text

object properties and their current values. Execute SET(H) to see a

list of text object properties and legal property values.

See also xlabel, ylabel, zlabel, title, gtext, line, patch.

Reference page in Help browser

doc text

<patch> - Create patch.

PATCH Create patch.

PATCH(X,Y,C) adds the "patch" or filled 2-D polygon defined by

vectors X and Y to the current axes. If X and Y are matrices of

the same size, one polygon ("face") per column is added. C

specifies the color of the face(s) ("flat" coloring), or the

vertices ("interpolated" coloring), for which bilinear interpolation

is used to determine the interior color of the polygon.

For both vector or matrix X and Y, if C is a string, each face

is filled with 'color'. 'color' can be 'r','g','b','c','m','y',

'w', or 'k'. If C is a scalar it specifies the color of the

face(s) by indexing into the colormap. A 1x3 vector C is always

assumed to be an RGB triplet specifying a color directly.

For vector X and Y, if C is a vector of the same length, it

specifies the color of each vertex as indices into the

colormap and bilinear interpolation is used to determine the

interior color of the polygon ("interpolated" shading).

When X and Y are matrices, if C is a 1xn, where n is the number

of columns in X and Y, then each face j=1:n is flat colored by the

colormap index C(j). Note the special case of a 1x3 C is always

assumed to be an RGB triplet ColorSpec and specifies the same

flat color for each face. If C is a matrix the same size as X

and Y, then it specifies the colors at the vertices as colormap

indices and bilinear interpolation is used to color the faces.

If C is 1xnx3, where n is the number of columns of X and Y,

then each face j is flat colored by the RGB triplet C(1,j,:).

If C is mxnx3, where X and Y are mxn, then each vertex

(X(i,j),Y(i,j)) is colored by the RGB triplet C(i,j,:) and the

face is colored using interpolation.

PATCH(X,Y,Z,C) creates a patch in 3-D coordinates. Z must be the

same size as X and Y.

PATCH returns a handle to a Patch object. Patches are children

of AXES objects.

The X,Y,C triple (X,Y,Z,C quad for 3-D) can be followed by

parameter/value pairs to specify additional properties of the

Patch. The X,Y,C triple (X,Y,Z,C quad for 3-D) can be omitted

entirely, and all properties specified using parameter/value

pairs.

Patch objects also support data specified using the properties

Faces, Vertices, and FaceVertexCData (see the reference manual

for more information). These properties do not have a convenience

syntax, but may be specified using param-value pairs. Patch

data specified as XData, YData, ZData, and CData is translated

and stored internally as Faces, Vertices, and FaceVertexCData, and

the original matrices are not stored. When GET is used to query