<?xml version="1.0" encoding="ISO-8859-1" standalone="no"?>
<!DOCTYPE MAN SYSTEM "../../manrev.dtd">
<MAN>
  <LANGUAGE>eng</LANGUAGE>
  <TITLE>sca</TITLE>
  <TYPE>Scilab Function</TYPE>
  <DATE>December 2005</DATE>
  <SHORT_DESCRIPTION name="sca">set the current axes entity</SHORT_DESCRIPTION>
  <CALLING_SEQUENCE>
    <CALLING_SEQUENCE_ITEM>a=sca(a)  </CALLING_SEQUENCE_ITEM>
  </CALLING_SEQUENCE>
  <PARAM>
    <PARAM_INDENT>
      <PARAM_ITEM>
        <PARAM_NAME>a</PARAM_NAME>
        <PARAM_DESCRIPTION>
          <SP>: a handle, the handle on the Axes entity</SP>
        </PARAM_DESCRIPTION>
      </PARAM_ITEM>
    </PARAM_INDENT>
  </PARAM>
  <DESCRIPTION>
    <SP><VERB>sca(a)</VERB> is used to set the current <VERB>Axes</VERB> entity (see
      <LINK>graphics_entities</LINK>) to the one pointed to by the handle
      <VERB>a</VERB>. The drawing functions generaly use the
      current axes entity.</SP>
  </DESCRIPTION>
  <EXAMPLE>
<![CDATA[
clf()
a1=newaxes(); 
a1.axes_bounds=[0,0,1.0,0.5];
t=0:0.1:20;
plot(t,acosh(t),'r')
a2=newaxes();
a2.axes_bounds=[0,0.5,1.0,0.5];
x=0:0.1:4;
plot(x,sinh(x))


sca(a1); //make first axes current
plot(t,asinh(t),'g')
legend(['acosh','asinh'])
sca(a2); //make secoçnd axes current
legend('sinh')
 ]]>
  </EXAMPLE>
  <SEE_ALSO>
    <SEE_ALSO_ITEM>
      <LINK>subplot</LINK>
    </SEE_ALSO_ITEM>
    <SEE_ALSO_ITEM>
      <LINK>gda</LINK>
    </SEE_ALSO_ITEM>
    <SEE_ALSO_ITEM>
      <LINK>newaxes</LINK>
    </SEE_ALSO_ITEM>
  </SEE_ALSO>
  <AUTHOR>S. Steer, INRIA</AUTHOR>
</MAN>
