<?xml version="1.0" encoding="ISO-8859-1" standalone="no"?>
<!DOCTYPE MAN SYSTEM "../../manrev.dtd">
<MAN>
  <LANGUAGE>eng</LANGUAGE>

  <TITLE>gdf</TITLE>

  <TYPE>Scilab Function</TYPE>

  <DATE>13-Jan-2003</DATE>

  <SHORT_DESCRIPTION name="gdf">Return handle of default
  figure.</SHORT_DESCRIPTION>

  <CALLING_SEQUENCE>
    <CALLING_SEQUENCE_ITEM>f = gdf()</CALLING_SEQUENCE_ITEM>

    <CALLING_SEQUENCE_ITEM>f = get("default_figure")</CALLING_SEQUENCE_ITEM>
  </CALLING_SEQUENCE>

  <PARAM>
    <PARAM_INDENT>
      <PARAM_ITEM>
        <PARAM_NAME>f</PARAM_NAME>

        <PARAM_DESCRIPTION>
          <SP>: handle, the handle of the default figure.</SP>
        </PARAM_DESCRIPTION>
      </PARAM_ITEM>
    </PARAM_INDENT>
  </PARAM>

  <DESCRIPTION>
    <P>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.</P>

    <P>The <VERB>gdf</VERB> function returns the handle on the default figure.
    The user can use this handle to set or get the figure properties default
    values.</P>

    <P>Note that an equivalent default graphic entity exists for axes entities
    too (see <VERB>gda</VERB>).</P>
  </DESCRIPTION>

  <EXAMPLE><![CDATA[
   
   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() 

  ]]></EXAMPLE>

  <SEE_ALSO>
    <SEE_ALSO_ITEM>
      <LINK>gda</LINK>
    </SEE_ALSO_ITEM>

    <SEE_ALSO_ITEM>
      <LINK>sdf</LINK>
    </SEE_ALSO_ITEM>

    <SEE_ALSO_ITEM>
      <LINK>sda</LINK>
    </SEE_ALSO_ITEM>

    <SEE_ALSO_ITEM>
      <LINK>gcf</LINK>
    </SEE_ALSO_ITEM>

    <SEE_ALSO_ITEM>
      <LINK>get</LINK>
    </SEE_ALSO_ITEM>

    <SEE_ALSO_ITEM>
      <LINK>scf</LINK>
    </SEE_ALSO_ITEM>

    <SEE_ALSO_ITEM>
      <LINK>set</LINK>
    </SEE_ALSO_ITEM>

    <SEE_ALSO_ITEM>
      <LINK>graphics_entities</LINK>
    </SEE_ALSO_ITEM>
  </SEE_ALSO>

  <AUTHOR>Djalel ABDEMOUCHE</AUTHOR>
</MAN>