figure window generator fig.m, version 3.1

fig() opens a new figure window of specified size, creates an axes object within the window, and applies any additional figure window properties that are specified. The window size may be given in units of either screen dimensions (i.e., as fractions of the width and height of the screen) or pixels. The calling program may also specify the color of the region inside the axes, the color of the frame around the axes, and any parameters that would be passed to Matlab's figure() function.

Syntax:

handle= fig(w, h, option1, value1, ... );

All calling arguments are optional. Arguments must be specified in pairs. In particular, one cannot specify w without also specifying h.

- w is the window width specified either as a fraction (0 to 1) of the screen width or in pixels (a whole number greater than or equal to 200). The default width is 0.8.

- h is the window height specified either as a fraction (0 to 1) of the screen height or in pixels (a whole number greater than or equal to 100). The default height is 0.6.

Note: The units of w and h must be the same, i.e., you must not specify one as a fraction of the screen dimension and the other in pixels.

Any arguments following w and h are option/value pairs. The options are always strings. Allowed options and corresponding values are as follows:

- AxesColor specifies the color of the region inside the axes.

- BackgroundColor specifies the color of the frame around the axes.

Each color specification must be an RGB 3-tuple, the name of a color (lower-case string), or a color index (1-21). Default colors are white.