Scilab Function
Last update : 8/6/2005

gdf - Return handle of default figure.

### Calling Sequence

  `f = gdf()`
  `f = get("default_figure")`

### Parameters

- `f`: handle, the handle of the default figure.

### Description

The default figure is a graphic entity which is never drawn. It is used as a reference for the figure properties default values. These default properties values are used to initialize new figures.

The `gdf` function returns the handle on the default figure. The user can use this handle to set or get the figure properties default values.

Note that an equivalent default graphic entity exists for axes entities too (see `gda`).

### Examples

       set old_style off
       f=gdf() // get the handle of the model figure
       // setting its' properties
       f.background=7;
       f.figure_name="Function gdf()";
       f.figure_position=[-1 100];
       f.auto_resize="off";
       f.figure_size=[300 461];
       f.axes_size=[600 400];
       plot2d() //create a figure
       scf(1);
       plot3d() //create a second figure
       set(f,"default_values",1); // return to the  default values of figure's model
                                  // see sdf() function
       scf(2);
       plot2d()

### See Also

`gda`, `sdf`, `sda`, `gcf`, `get`, `scf`, `set`, `graphics_entities`,

### Author

Djalel ABDEMOUCHE