<?xml version="1.0" encoding="UTF-8"?>
<!--
 * Scilab ( https://www.scilab.org/ ) - This file is part of Scilab
 * Copyright (C) INRIA - Serge Steer
 *
 * Copyright (C) 2012 - 2016 - Scilab Enterprises
 *
 * This file is hereby licensed under the terms of the GNU GPL v2.0,
 * pursuant to article 5.3.4 of the CeCILL v.2.1.
 * This file was originally licensed under the terms of the CeCILL v2.1,
 * and continues to be available under such terms.
 * For more information, see the COPYING file which you should have received
 * along with this program.
 *
 -->
<refentry xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink" xmlns:svg="http://www.w3.org/2000/svg" xmlns:mml="http://www.w3.org/1998/Math/MathML" xmlns:db="http://docbook.org/ns/docbook" xmlns:scilab="http://www.scilab.org"  xml:lang="en" xml:id="sca">
    <refnamediv>
        <refname>sca</refname>
        <refpurpose>set the current axes entity</refpurpose>
    </refnamediv>
    <refsynopsisdiv>
        <title>Syntax</title>
        <synopsis>a=sca(a)</synopsis>
    </refsynopsisdiv>
    <refsection>
        <title>Arguments</title>
        <variablelist>
            <varlistentry>
                <term>a</term>
                <listitem>
                    <para>a handle, the handle on the Axes entity</para>
                </listitem>
            </varlistentry>
        </variablelist>
    </refsection>
    <refsection>
        <title>Description</title>
        <para>
            <literal>sca(a)</literal> is used to set the current <literal>Axes</literal> entity (see
            <link linkend="graphics_entities">graphics_entities</link>) to the one pointed to by the handle
            <literal>a</literal>. The drawing functions generally use the
            current axes entity.
        </para>
    </refsection>
    <refsection>
        <title>Examples</title>
        <programlisting role="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 second axes current
legend('sinh')
 ]]></programlisting>
        <scilab:image>

            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);
            plot(t,asinh(t),'g')
            legend(['acosh','asinh'])
            sca(a2);
            legend('sinh')

        </scilab:image>

    </refsection>
    <refsection role="see also">
        <title>See also</title>
        <simplelist type="inline">
            <member>
                <link linkend="subplot">subplot</link>
            </member>
            <member>
                <link linkend="gda">gda</link>
            </member>
            <member>
                <link linkend="newaxes">newaxes</link>
            </member>
        </simplelist>
    </refsection>
</refentry>
