figure create a figure

## Syntax

                f = figure(num);
                f = figure("PropertyName1", Propertyvalue1, ..., ..., "PropertyNameN", PropertyvalueN);

## Description

This routine creates a figure. If an ID is given, the figure corresponding to this ID is created. Otherwise, the window is created with the first free ID, that is the lowest integer not already used by a window.

## Arguments

num

  ID of the window to create. If not specified, the first free ID is used.

PropertyName{1, ..., N}

  character string: Name of a property to set, among all existing ones.

  - `'dockable'`, `'toolbar'` and `'menubar'` properties can be set only at figure's creation.
  - `'resizefcn'`: when it is set at figure's creation, the callback is first executed while building the initial figure. Hence it must already be defined and callable.
PropertyValue{1, ..., N}

  scilab object value to give to the corresponding property.

f

  handle of the newly created window.

## Examples

    // Create figure having figure_id==3
    h=figure(3);
    // Add a text uicontrol in figure 3
    uicontrol(h, "style", "text", ...
                 "string", "This is a figure", ...
                 "position", [50 70 100 100], ...
                 "fontsize",15);

    // Create figure having figure_id==1
    figure();
    // Add a text uicontrol in figure 1
    uicontrol("style", "text", ...
              "string", "Another figure", ...
              "position", [50 70 100 100], ...
              "fontsize", 15);

    // Close current figure (ie figure 1)
    close();
    // close figure 3
    close(h);

## See also

- scf
- gcf
- createWindow
- figure_properties
- close