<?xml version="1.0" encoding="ISO-8859-1" standalone="no"?>
<!DOCTYPE MAN SYSTEM "../../manrev.dtd">
<MAN>
  <LANGUAGE>eng</LANGUAGE>
  <TITLE>gca</TITLE>
  <TYPE>Scilab Function  </TYPE>
  <DATE>12-Nov-2003</DATE>
  <SHORT_DESCRIPTION name="gca">  Return handle of current axes. </SHORT_DESCRIPTION>

  <CALLING_SEQUENCE>
  <CALLING_SEQUENCE_ITEM>a = gca()</CALLING_SEQUENCE_ITEM>
  </CALLING_SEQUENCE>

  <PARAM>
  <PARAM_INDENT>

    <PARAM_ITEM>
    <PARAM_NAME>a</PARAM_NAME>
    <PARAM_DESCRIPTION>
       <SP>: handle, the handle of the current axes entity.</SP>
    </PARAM_DESCRIPTION>
    </PARAM_ITEM>
  </PARAM_INDENT>
  </PARAM>
 
  <DESCRIPTION>
  <P>
   This routine returns the handle of the current axes for the current figure.
  </P>
  </DESCRIPTION>

  <EXAMPLE><![CDATA[
   
    set("figure_style","new") //create a figure
    subplot(211)
    a=gca() //get the current axes
    a.box="off";
    t=-%pi:0.3:%pi;plot3d(t,t,sin(t)'*cos(t),80,50,'X@Y@Z',[5,2,4]);
    subplot(212)
    plot2d(); //simple plot
    a=gca() //get the current axes
    a.box="off";
    a.x_location="middle";
    a.parent.background=4;
    delete(gca()) // delete the current axes    
    xdel(0) //delete a graphics window 

  ]]></EXAMPLE>

  <SEE_ALSO>
  <SEE_ALSO_ITEM> <LINK>gda</LINK> </SEE_ALSO_ITEM>
    <SEE_ALSO_ITEM> <LINK>gcf</LINK> </SEE_ALSO_ITEM>
    <SEE_ALSO_ITEM> <LINK>gce</LINK> </SEE_ALSO_ITEM>
    <SEE_ALSO_ITEM> <LINK>get</LINK> </SEE_ALSO_ITEM>
    <SEE_ALSO_ITEM> <LINK>graphics_entities</LINK> </SEE_ALSO_ITEM>
  </SEE_ALSO>

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