<?xml version="1.0" encoding="UTF-8"?>
<!--
 * Scilab ( https://www.scilab.org/ ) - This file is part of Scilab
 * Copyright (C) INRIA - Djalel Abdemouche
 * Copyright (C) 2009 - DIGITEO - Pierre Lando
 * Copyright (C) 2013, 2018 - Samuel GOUGEON
 *
 * 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="axes_properties">
    <refnamediv>
        <refname>axes properties</refname>
        <refpurpose>
            description of the axes entity properties
        </refpurpose>
    </refnamediv>
    <refsection>
        <title>Description</title>
        <para>
            The Axes entity is the second level of the graphics entities hierarchy.
            This entity defines the parameters allowing the change of coordinates and
            the axes drawing as well as the parameters' default values for the
            children creation.
        </para>
        <variablelist>
            <varlistentry>
                <term>Axes properties</term>
                <listitem>
                    <variablelist>
                        <varlistentry>
                            <term>parent: </term>
                            <listitem>
                                <para>This field contains the handle of the parent figure.</para>
                            </listitem>
                        </varlistentry>
                        <varlistentry>
                            <term>children: </term>
                            <listitem>
                                <para>
                                    FA vector containing the handles of all graphics objects
                                    children of the axes These graphics objects are of type
                                    <literal>"Compound"</literal>, <literal>"Rectangle"</literal>,
                                    <literal>"Polyline"</literal>, <literal>"Segs"</literal>, <literal>"Arc"</literal>,
                                    <literal>"Grayplot"</literal>,.. (see <link linkend="Compound_properties">Compound_properties</link>,
                                    <link linkend="rectangle_properties">rectangle_properties</link>, <link linkend="champ_properties">champ_properties</link>,
                                    <link linkend="axis_properties">axis_properties</link>, <link linkend="polyline_properties">polyline_properties</link>,
                                    <link linkend="segs_properties">segs_properties</link>, <link linkend="grayplot_properties">grayplot_properties</link>,
                                    <link linkend="surface_properties">surface_properties</link>,
                                    <link linkend="fec_properties">fec_properties</link>, <link linkend="text_properties">text_properties</link>,
                                    <link linkend="legend_properties">legend_properties</link>)
                                </para>
                            </listitem>
                        </varlistentry>
                        <varlistentry>
                            <term>visible: </term>
                            <listitem>
                                <para>
                                    This field contains the <literal>visible</literal> property value
                                    for axes . Its value should be <literal>"on" </literal> or
                                    <literal>"off"</literal> . By default, axes is visible <literal>"on"</literal>
                                    in case all "visible" children are displayed on the screen, If
                                    <literal>"off"</literal> the axes and all its children are not
                                    drawn.
                                </para>
                            </listitem>
                        </varlistentry>
                        <varlistentry>
                            <term>axes_visible: </term>
                            <listitem>
                                <para>
                                    A <literal>1x3</literal> string vector. This property specifies
                                    whether each axis is drawn or not. Its value should be
                                    <literal>"on"</literal> or <literal>"off"</literal> for a global setting.To
                                    act on a single axis, the syntax is <literal>axes_visible(N)</literal>
                                    where <literal>N</literal> is <literal>1,2</literal> or <literal>3</literal>
                                    corresponding to the <literal> x,y</literal> or <literal>z</literal> axis. The
                                    scaling data and if required the grids are drawn if the value is
                                    <literal>"on"</literal>. Note that when creating a simple axes entity
                                    using the <literal>gca()</literal> (shortcut for
                                    <literal>get"current_axes")</literal>) or <literal>gcf()</literal> (shortcut
                                    for <literal>get(current_figure)</literal>) commands, the axes
                                    visibility is set to <literal>"off"</literal>.
                                </para>
                            </listitem>
                        </varlistentry>
                        <varlistentry>
                            <term>axes_reverse: </term>
                            <listitem>
                                <para>
                                    A <literal>1x3</literal> string vector corresponding to the three
                                    axes (X,Y,Z). For each axes, the property specifies the direction
                                    of the increasing values. If <literal>"off"</literal>, the default
                                    direction is used. If <literal>"on"</literal>, the direction is reverse.
                                    It is also possible to use only one string, <literal>"on"</literal> or
                                    <literal>"off"</literal>, to set simultaneously the three data.
                                </para>
                            </listitem>
                        </varlistentry>
                        <varlistentry>
                            <term>grid: </term>
                            <listitem>
                                <para>
                                    vector of 3 colors indices <literal>[xCol, yCol, zCol]</literal>
                                    used to draw the grid along respective directions.
                                    To cancel the grid in a direction, use <literal>-1</literal>
                                    as index. Default = <literal>[-1 -1 -1]</literal> (no grid).
                                </para>
                            </listitem>
                        </varlistentry>
                        <varlistentry>
                            <term>grid_style: </term>
                            <listitem>
                                <para>
                                    vector <literal>[xLineStyle, yLineStyle, zLineStyle]</literal>
                                    of 2 or 3 line styles ids from 1 to 10 (solid, dashes, dots, etc)
                                    used to draw the grid along respective directions (in 2D or 3D).
                                    Available line styles are described
                                    <link linkend="polyline_properties">there</link>.
                                </para>
                            </listitem>
                        </varlistentry>
                        <varlistentry>
                            <term>grid_thickness: </term>
                            <listitem>
                                <para>
                                    vector <literal>[xLineThick, yLineThick, zLineThick]</literal>
                                    of 2 or 3 positive decimal numbers setting the thickness of
                                    the grid lines along respective directions (in 2D or 3D).
                               </para>
                            </listitem>
                        </varlistentry>
                        <varlistentry>
                            <term>grid_position: </term>
                            <listitem>
                                <para>
                                    <literal>"background"</literal> (default): the grid is drawn
                                    behind all other graphical components ;
                                    or <literal>"foreground</literal>: the grid is drawn on the top.
                                </para>
                            </listitem>
                        </varlistentry>
                        <varlistentry>
                            <term>x_location: </term>
                            <listitem>
                                <para>
                                    Specify the location of the x-axis. The possible values
                                    are:
                                </para>
                                <itemizedlist>
                                    <listitem>
                                        <para>
                                            <literal>"bottom"</literal>. In this case the x axis is drawn at
                                            the bottom of the axes rectangle.
                                        </para>
                                    </listitem>
                                    <listitem>
                                        <para>
                                            <literal>"top"</literal>. In this case the x axis is drawn at
                                            the top of the axes rectangle.
                                        </para>
                                    </listitem>
                                    <listitem>
                                        <para>
                                            <literal>"middle"</literal>. In this case the x axis is drawn
                                            at the centered position.
                                        </para>
                                    </listitem>
                                    <listitem>
                                        <para>
                                            <literal>"origin"</literal>. In this case the x axis is drawn
                                            at the origin.
                                        </para>
                                    </listitem>
                                </itemizedlist>
                            </listitem>
                        </varlistentry>
                        <varlistentry>
                            <term>y_location: </term>
                            <listitem>
                                <para>
                                    Specify the location of the y-axis. The possible values
                                    are:
                                </para>
                                <itemizedlist>
                                    <listitem>
                                        <para>
                                            <literal>"left"</literal>. In this case the y axis is drawn at
                                            the left of the axes rectangle.
                                        </para>
                                    </listitem>
                                    <listitem>
                                        <para>
                                            <literal>"right"</literal>. In this case the y axis is drawn at
                                            the right of the axes rectangle.
                                        </para>
                                    </listitem>
                                    <listitem>
                                        <para>
                                            <literal>"middle"</literal>. In this case the y axis is drawn
                                            at the centered position.
                                        </para>
                                    </listitem>
                                    <listitem>
                                        <para>
                                            <literal>"origin"</literal>. In this case the y axis is drawn
                                            at the origin.
                                        </para>
                                    </listitem>
                                </itemizedlist>
                            </listitem>
                        </varlistentry>
                        <varlistentry>
                            <term>title: </term>
                            <listitem>
                                <para>
                                    An object attached to the Axes entity and returning a graphic
                                    handle on a Label structure
                                    (see <link linkend="label_properties">label_properties</link>).
                                    This field defines a title with options on this label.
                                </para>
                            </listitem>
                        </varlistentry>
                        <varlistentry>
                            <term>x_label: </term>
                            <listitem>
                                <para>
                                    An object attached to the Axes entity and returning a graphic
                                    handle on a Label structure
                                    (see <link linkend="label_properties">label_properties</link>).
                                    This field defines a label on x axis with options on this
                                    label.
                                </para>
                            </listitem>
                        </varlistentry>
                        <varlistentry>
                            <term>y_label: </term>
                            <listitem>
                                <para>
                                    An object attached to the Axes entity and returning a graphic
                                    handle on a Label structure
                                    (see <link linkend="label_properties">label_properties</link>).
                                    This field defines a label on y axis with options on this
                                    label.
                                </para>
                            </listitem>
                        </varlistentry>
                        <varlistentry>
                            <term>z_label: </term>
                            <listitem>
                                <para>
                                    An object attached to the Axes entity and returning a graphic
                                    handle on a Label structure
                                    (see <link linkend="label_properties">label_properties</link>).
                                    This field defines a label on z axis with options on this
                                    label.
                                </para>
                            </listitem>
                        </varlistentry>
                        <varlistentry>
                            <term>auto_ticks: </term>
                            <listitem>
                                <para>
                                    Default <literal>["on" "on" "on"]</literal>. auto_ticks status
                                    for each x, y and z respective axis.
                                </para>
                                <para>
                                    <literal>"on"</literal> means that the axis is automatically
                                    graduated through a
                                    computational algorithm. Then, resizing the figure and axes
                                    automatically updates accordingly graduations ticks and labels
                                    of the given axis.
                               </para>
                               <para>
                                    On the contrary, <literal>"off"</literal> means that graduations
                                    ticks or/and labels are set by hand. Then resizing the figure and
                                    axes has no effect on existing graduations ticks and labels.
                              </para>
                              <para>Setting <literal>.auto_ticks="on"</literal> or <literal>"off"</literal>
                                sets the same status for the x, y and z axes. Setting
                                <literal>.auto_ticks(2)="off"</literal> sets the status only for the
                                y axis. Etc.
                              </para>
                              <warning>
                                Editing ticks (labels and/or locations) via
                                <literal>x_ticks, y_ticks</literal> or  <literal>z_ticks</literal>
                                automatically sets <literal>auto_ticks</literal> to <literal>"off"</literal>
                                for the corresponding axes.
                              </warning>
                            </listitem>
                        </varlistentry>
                        <varlistentry>
                            <term>x_ticks, y_ticks, z_ticks: </term>
                            <listitem>
                                <para>
                                    Each of these properties is a tlist of type "ticks" with 2 fields named "locations" and "labels":
                                    <literal>tlist(["ticks", "locations", "labels"], Locations, Labels)</literal> where
                                    <variablelist>
                                        <varlistentry>
                                            <term>Locations</term>
                                            <listitem>
                                                is a real vector containing the locations of
                                                graduations along and according to the data scale
                                                of the given x or y or z axis.
                                                When the number of ticks does not need to be changed,
                                                their locations can be set or changed through
                                                the syntax (e.g. along x)
                                                <literal>Haxes.x_ticks.locations = Locations</literal>
                                                where <literal>Haxes = gca();</literal> and
                                                <literal>Locations</literal> is the complete vector
                                                of updated ticks positions. To change just the ith
                                                location, just use:
                                                <literal>Haxes.x_ticks.locations(i) = newLoc</literal>
                                            </listitem>
                                        </varlistentry>
                                        <varlistentry>
                                            <term>Labels</term>
                                            <listitem>
                                                is a text vector containing the labels to be displayed
                                                in front of each related graduation. As for Locations
                                                of ticks, Labels can be addressed with (e.g. along y)
                                                <literal>Haxes.y_ticks.labels = Labels</literal> or
                                                <literal>Haxes.y_ticks.labels(j) = newLabelJ</literal>.
                                                <para>
                                                Vertical or tilted ticks labels can be yielded using
                                                LaTeX formating with
                                                <literal>\rotatebox{angle}{text}</literal>. See the
                                                <link linkend="axes_properties_vertical_xticks">example</link>
                                                below.
                                                </para>
                                            </listitem>
                                        </varlistentry>
                                    </variablelist>
                                    <warning>
                                        <itemizedlist>
                                        <listitem>
                                            For an axis, <literal>Locations</literal> and
                                            <literal>Labels</literal> vectors must have the same
                                            number of components.
                                        </listitem>
                                        <listitem>
                                            When the number of ticks must be changed, their positions
                                            AND labels must be changed at once, in order to avoid
                                            any mismatch: The syntax (e.g. along x)
                                            <literal>Haxes.x_ticks = tlist(["ticks" "locations", "labels"], newLocations, newLabels)</literal>
                                            must then be used.
                                        </listitem>
                                        <listitem>
                                            Changing by hand the <literal>Locations</literal> or/and
                                            <literal>Labels</literal> of an axis automatically sets
                                            its <literal>.auto_ticks</literal> status to
                                            <literal>"off"</literal>. This cancels its
                                            auto-regraduation under resizing of the figure.
                                        </listitem>
                                      </itemizedlist>
                                    </warning>
                                </para>
                            </listitem>
                        </varlistentry>
                        <varlistentry>
                            <term>x_ticks.locations, y_ticks.locations, z_ticks.locations: </term>
                            <listitem>
                                <para>
                                    Each of these properties is a real vector containing the locations
                                  of graduations on the related x or y or z axis.
                                  <varname>x_ticks.locations</varname> must have the same number of
                                  components as <varname>x_ticks.labels</varname>.
                                  See <varname>x_ticks</varname> hereabove for more details.
                                </para>
                            </listitem>
                        </varlistentry>
                        <varlistentry>
                            <term>x_ticks.labels, y_ticks.labels, z_ticks.labels: </term>
                            <listitem>
                                <para>
                                  Each of these properties is a text vector containing the labels
                                  to be displayed in front of ticks on the related x or y or z axis.
                                  <varname>x_ticks.labels</varname> must have the same number of
                                  components as <varname>x_ticks.locations</varname>.
                                  See <varname>x_ticks</varname> hereabove for more details.
                                </para>
                            </listitem>
                        </varlistentry>
                        <varlistentry>
                            <term>ticks_format: </term>
                            <listitem>
                                <para>
                                    This property specifies the format to use for each axes.
                                    It is a row vector with at most 3 columns containing strings
                                    format (as specified for <link linkend="mprintf">mprintf</link>).
                                    Each ticks position will be used to format the string used as label.
                                </para>
                                <para>
                                    So, for example ticks_format="%.2e" will print ticks positions
                                    in using scientific notation with two decimals.
                                </para>
                                <warning>
                                   Labels are actually updated according to the newly set
                                   <literal>.ticks_format(i)</literal> only if the
                                   <literal>.auto_ticks(i)</literal> status of the axis #i is
                                   <literal>"on"</literal>. Otherwise,
                                   <literal>.ticks_format(i)</literal> is recorded without being
                                   immediately used.
                                </warning>
                            </listitem>
                        </varlistentry>
                        <varlistentry>
                            <term>ticks_st: </term>
                            <listitem>
                                <para>
                                  This property specifies scale-translate factors to apply to each
                                  ticks position before to use it in the formatted string used as
                                  label. So if the factors are
                                  <literal>[x_s y_s z_s ; x_t y_t z_t]</literal> and if a x_tick is
                                  positioned at X, the value used to format the label will be
                                  <literal>x_s*(X-x_t)</literal>. It could be particularly useful
                                  when the axes bounds are too closed.
                                    <para>
                                        It is a matrix with 2 rows and at most 3 columns.
                                    </para>
                                </para>
                                <para>
                                    So, for example <literal>base=B</literal>, labels could be
                                    printed with <literal>ticks_format=string(base)+"%+.2e"</literal>
                                    and <literal>ticks_st=[1 base]</literal>
                                </para>
                            </listitem>
                        </varlistentry>
                        <varlistentry>
                            <term>sub_ticks: </term>
                            <listitem>
                                <para>
                                    This field sets the number of tics to draw between two main
                                    tics. The field value is the vector <literal>[nx,ny]</literal> where
                                    <literal>nx</literal> is the number of sub tics for the x-axis and
                                    <literal>ny</literal> respecting to the y-axis.
                                </para>
                            </listitem>
                        </varlistentry>
                        <varlistentry>
                            <term>box: </term>
                            <listitem>
                                <para>
                                    This property specifies whether to enclose the axes in a box.
                                    Its value can be either <literal>"off"</literal>,
                                    <literal>"hidden_axes"</literal>, <literal>"back_half"</literal> or
                                    <literal>"on".</literal> If the property is <literal>"off"</literal>, the box
                                    is not draw. If the property is <literal>"hidden_axes"</literal>, only
                                    the back frame is drawn. If the property is
                                    <literal>"back_half"</literal>, the X, Y and Z axis are also drawn. If
                                    the property is <literal>"on"</literal> the whole box is drawn.
                                </para>
                                <scilab:image><![CDATA[
                                    box = ["on" "back_half" "hidden_axes" "off"];
                                    for i = 1:4
                                        subplot(1,4,i)
                                        plot3d([0 1],[0 1],[0 1])
                                        a = gca();
                                        a.box = box(i);
                                        a.rotation_angles = [235 326];
                                        title(msprintf("%s", box(i)), "fontsize",3)
                                    end
                                    gcf().axes_size = [840 222];
                                ]]></scilab:image>
                            </listitem>
                        </varlistentry>
                        <varlistentry>
                            <term>filled: </term>
                            <listitem>
                                <para>
                                    This property specifies whether the axes background should be
                                    drawn or not.
                                    Its value can be either <literal>"off"</literal> or
                                    <literal>"on".</literal>
                                    If the property is <literal>"off"</literal>, the background
                                    is not drawn, the axes box is transparent. If the property is
                                    <literal>"on"</literal> the
                                    background is drawn using the color specified by the
                                    <literal>background</literal> property.
                                </para>
                            </listitem>
                        </varlistentry>
                        <varlistentry>
                            <term>font_style: </term>
                            <listitem>
                                <para>
                                    Specifies the font used for displaying tics labels. This is a
                                    positive integer referencing one of the loaded fonts.
                                    Its value must be between 0, referencing the first font,
                                    and the number of loaded fonts minus one, referencing the last font.
                                    For more information see <link linkend="graphics_fonts">graphics_fonts</link>.
                                </para>
                            </listitem>
                        </varlistentry>
                        <varlistentry>
                            <term>font_size: </term>
                            <listitem>
                                <para>
                                    It is a scalar specifying the character size of tics labels.
                                    If <literal>fractional_font</literal> property is <literal>"off"</literal>
                                    only the integer part of the value is used.
                                    For more information see <link linkend="graphics_fonts">graphics_fonts</link>.
                                </para>
                            </listitem>
                        </varlistentry>
                        <varlistentry>
                            <term>font_color: </term>
                            <listitem>
                                <para>This property determines the color of the tics labels.</para>
                            </listitem>
                        </varlistentry>
                        <varlistentry>
                            <term>fractional_font: </term>
                            <listitem>
                                <para>
                                    This property specify whether ticks labels are displayed using fractional font sizes.
                                    Its value must be either <literal>"on"</literal> or <literal>"off"</literal>.
                                    If <literal>"on"</literal> the floating point value of <literal>font_size</literal>
                                    is used for display and the font is anti-aliased.
                                    If <literal>"off"</literal> only the integer part is used
                                    and the font is not smoothed.
                                </para>
                            </listitem>
                        </varlistentry>
                        <varlistentry>
                            <term>isoview: </term>
                            <listitem>
                                <para>
                                    This property is used to have isometric scales on the x, y and
                                    z axes (for example to make the display of the curve sin(x) versus
                                    cos(x) be a circle not an ellipse). Its value should be
                                    <literal>"on"</literal> or <literal>"off"</literal>. If the value is
                                    <literal>"on"</literal>, the axes <literal>data_bounds</literal>
                                    automatically change according to the corresponding figure
                                    <literal>figure_size</literal> property values.
                                </para>
                            </listitem>
                        </varlistentry>
                        <varlistentry>
                            <term>cube_scaling:</term>
                            <listitem>
                                <para>
                                    This property is used in <literal>3d mode</literal> to have a
                                    rescaling of the x, y and z axes. Indeed, it allows the
                                    <literal>data</literal> to fit into a 1x1x1 cube ; the goal is to better
                                    display 3d graphics in case axes scales are very different from
                                    one to another. Its value should be <literal>"on" </literal> or
                                    <literal>"off"</literal> (which is the default value). In most cases, it
                                    helps generating Matlab-like 3d view.
                                </para>
                            </listitem>
                        </varlistentry>
                        <varlistentry>
                            <term>view: </term>
                            <listitem>
                                <para>
                                    This field is related to the graphics universe. It takes
                                    <literal>"3d"</literal> as value corresponding to the three-dimensional
                                    views. In the other case its value can be <literal>"2d"</literal> for
                                    initial 2d plotting (default value). This flag also depends on the
                                    plots the user enters : a <literal>plot3d </literal>command, for
                                    example, will switch the <literal>view</literal> flag from
                                    <literal>"2d"</literal> to <literal>"3d"</literal>.
                                </para>
                            </listitem>
                        </varlistentry>
                        <varlistentry>
                            <term>rotation_angles: </term>
                            <listitem>
                                <para>
                                    Spherical coordinates <literal>[alpha, theta]</literal> =
                                    <literal>[polAngle, azimuth]</literal> of the observation point,
                                    in degrees:
                                    <itemizedlist>
                                        <listitem>
                                            <emphasis role="bold">theta</emphasis>: azimuth angle
                                            in the (x,y) plane. Particular angles, for (x,y) seen
                                            from (O,z):
                                            <table>
                                                <tr><td>270 </td><td>: (O,x) to right</td></tr>
                                                <tr><td>0 </td><td>: (O,x) to bottom</td></tr>
                                                <tr><td>90 </td><td>: (O,x) to left</td></tr>
                                                <tr><td>180 </td><td>: (O,x) to top</td></tr>
                                            </table>
                                            <scilab:image><![CDATA[
                                            // gca().rotation_angles:
                                            // Azimuth:
                                            // --------
                                            x = linspace(0,30,100);
                                            y = exp(-x/7).*sin(x);
                                            scf(1);
                                            clf
                                            i = 1;
                                            for a = [270 315 0 90 180]
                                                subplot(1,5,i)
                                                plot(x, y, "b")
                                                gca().rotation_angles(2) = a;
                                                gca().margins = [0.17 0.17 0.25 0.15];
                                                gca().box = "on";
                                                gca().cube_scaling = "on";
                                                title(msprintf("theta = %d\n\r", a), "fontsize",3, "color",color("magenta3"))
                                                i = i + 1;
                                            end
                                            gcf().axes_size = [810 200];
                                            ]]></scilab:image>
                                        </listitem>
                                        <listitem>
                                            <emphasis role="bold">alpha</emphasis>: polar angle from
                                            (Oz), in planes orthogonal to (x,y). Particular values:
                                            <table>
                                                <tr><td>0</td><td>= North pole (O,z)</td><td> view from above</td></tr>
                                                <tr><td>90</td><td>= Equator (x,y)</td><td> view from side</td></tr>
                                                <tr><td>180</td><td>= South pole (O,-z)</td><td> view from below</td></tr>
                                            </table>
                                            <scilab:image><![CDATA[
                                            // gca().rotation_angles:
                                            // polar angle
                                            // -----------
                                            scf(2);
                                            clf
                                            i = 1
                                            for a = [0 30 60 90 120]
                                                subplot(1,5,i)
                                                plot3d()
                                                gce().color_mode = -2;
                                                gca().rotation_angles = [a 300];
                                            //    gca().margins = [0.17 0.17 0.25 0.15];
                                            //    gca().box = "on";
                                                gca().cube_scaling = "on";
                                                title(msprintf("alpha = %d\n", a), "fontsize",3, "color",color("magenta3"))
                                                i = i + 1;
                                            end
                                            gcf().axes_size = [810 220];
                                            ]]></scilab:image>
                                        </listitem>
                                    </itemizedlist>
                                </para>
                            </listitem>
                        </varlistentry>
                        <varlistentry>
                            <term>log_flags: </term>
                            <listitem>
                                <para>
                                    3 character string that sets the scale (linear or logarithmic) along the axes.
                                    Each character specifies the scale for respectively the X, Y and Z axes.
                                    They can be either <literal>'n'</literal> for the
                                    <emphasis role="bold">n</emphasis>ormal scale, or
                                    <literal>'l'</literal> for the
                                    <emphasis role="bold">l</emphasis>ogarithmic one.
                                </para>
                                <scilab:image><![CDATA[
                                    x = linspace(0,10,100)(2:$);
                                    m = ["nn" "ln" "nl" "ll"];
                                    clf
                                    for i = 1:4
                                        subplot(1,4,i)
                                        plot2d(m(i), x, x.^2)
                                        xgrid(color("grey75"),1,7)
                                        title(msprintf("""%s""",m(i)),"fontsize",3)
                                        select i
                                        case 1, gca().sub_ticks = [3 3];
                                        case 2, gca().sub_ticks = [8 3];
                                        case 3, gca().sub_ticks = [3 8];
                                        case 4, gca().sub_ticks = [8 8];
                                        end
                                    end
                                    gcf().axes_size = [800 220];
                                ]]></scilab:image>
                            </listitem>
                        </varlistentry>
                        <varlistentry>
                            <term>tight_limits: </term>
                            <listitem>
                                <para>
                                    A <literal>1x3</literal> string vector giving the tight_limits status
                                    for each axis. This property specifies whether each axis fits exactly with the minima and
                                    maxima values of the data bounds. If an item is <literal>"off"</literal>, the corresponding axis may
                                    enlarge boundaries such as to produce pretty tics labels. For a global setting (all axes at once), you have to set its value
                                    to <literal>"on"</literal> or <literal>"off"</literal> (single string). To act on a single axis,
                                    the syntax is <literal>tight_limits(N)</literal> where <literal>N</literal> is
                                    <literal>1,2</literal> or <literal>3</literal> corresponding to the
                                    <literal>x,y</literal> or <literal>z</literal> axis.
                                </para>
                            </listitem>
                        </varlistentry>
                        <varlistentry>
                            <term>data_bounds: </term>
                            <listitem>
                                <para>
                                    This field contains the boundary values for the x, y and z
                                    coordinates. It is either the matrix or the vector
                                    <literal>[xmin,ymin; xmax,ymax]</literal>,
                                    <literal>[xmin,ymin,zmin; xmax,ymax,zmax]</literal>,
                                    <literal>[xmin,xmax,ymin,ymax]</literal>,
                                    <literal>[xmin,xmax,ymin,ymax,zmin,zmax]</literal>,
                                    <literal>[xmin;xmax;ymin;ymax]</literal> or
                                    <literal>[xmin;xmax;ymin;ymax;zmin;zmax]</literal>. Note that, to strictly have the
                                    specified data bounds, <literal>tight_limits</literal> must be set to
                                    <literal>"on"</literal> value (see above).
                                    To manually set data_bounds set <literal>auto_scale="off"</literal>
                                </para>
                            </listitem>
                        </varlistentry>
                        <varlistentry>
                            <term>zoom_box: </term>
                            <listitem>
                                <para>
                                    This field contains the current zoom box if any coordinates
                                    are given. It is an empty matrix (no zoom) or the vector
                                    <literal>[xmin,ymin,xmax,ymax,zmin,zmax]</literal> (defines a smaller axes box).
                                </para>
                            </listitem>
                        </varlistentry>
                        <varlistentry>
                            <term>margins: </term>
                            <listitem>
                                <para>
                                    A vector
                                    <literal>[margin_left,margin_right,margin_top,margin_bottom]</literal>
                                    specifying the margins portion for this axes. This vector is
                                    composed of numbers between [0 1] with default: [0.125 0.125 0.125
                                    0.125]. These numbers are ratios relative to associated values of the
                                    <literal>axes_bounds</literal> property, which are <literal>width</literal> for
                                    <literal>margin_left</literal> and <literal>margin_right</literal>, and
                                    <literal>height</literal> for <literal>margin_top</literal> and
                                    <literal>margin_bottom</literal>.
                                </para>
                            </listitem>
                        </varlistentry>
                        <varlistentry>
                            <term>auto_margins: </term>
                            <listitem>
                                <para>
                                    A property to allow the automatic computation of the margins accordint to their contents.
                                    If value is <literal>"on"</literal>, then the automatic computation is activated.
                                </para>
                            </listitem>
                        </varlistentry>
                        <varlistentry>
                            <term>axes_bounds: </term>
                            <listitem>
                                <para>
                                    Vector <literal>[x_left, y_top, width, height]</literal> of
                                    four decimal numbers in [0, 1] specifying the portion of figure
                                    or frame used by this axes:
                                    <itemizedlist>
                                        <listitem>
                                            <literal>x_left</literal> and <literal>y_top</literal>
                                            set the position of the top-left corner of the axes area,
                                            with respect to the top-left corner of the embedding
                                            figure or frame.
                                        </listitem>
                                        <listitem>
                                            <literal>width</literal> and <literal>height</literal>
                                            set the dimensions of the axes area. 1 stands for the
                                            full width or height of the embedding figure or frame.
                                        </listitem>
                                    </itemizedlist>
                                </para>
                                <para>
                                    These numbers are relative to the
                                    <literal>gca().parent.position(3:4)</literal> [width, height]
                                    dimensions of the figure or of the Uicontrol frame
                                    embedding the axes.
                                </para>
                            </listitem>
                        </varlistentry>
                        <varlistentry>
                            <term>hidden_axis_color: </term>
                            <listitem>
                                <para>
                                    This property defined the color of the hidden axis. It takes
                                    an index relative to the current colormap.
                                </para>
                            </listitem>
                        </varlistentry>
                        <varlistentry>
                            <term>user_data: </term>
                            <listitem>
                                <para>
                                    This field can be use to store any scilab variable in the axes
                                    data structure, and to retrieve it.
                                </para>
                            </listitem>
                        </varlistentry>
                    </variablelist>
                </listitem>
            </varlistentry>
            <varlistentry>
                <term>Properties for high level functions</term>
                <listitem>
                    <para>
                        The <literal>plot</literal>, <literal>plot2dx</literal>, <literal>grayplot</literal>
                        and <literal>matplot</literal> functions use the following properties to
                        decide how to merge consecutive plots if this is not stated by the
                        <literal>frameflag</literal> calling argument. The result of the merge is
                        decided through these two following properties:
                    </para>
                    <variablelist>
                        <varlistentry>
                            <term>auto_clear: </term>
                            <listitem>
                                <para>
                                    <literal>"on"</literal>: a call to a high level graphic function
                                    targeting the axes
                                    <itemizedlist>
                                        <listitem>
                                            erases all children of the axes,
                                        </listitem>
                                        <listitem>
                                            resets its <literal>.log_flags</literal> and
                                            <literal>.data_bounds</literal> properties to their default value
                                        </listitem>
                                        <listitem>
                                            keeps its other properties
                                        </listitem>
                                    </itemizedlist>
                                    before performing the drawing.
                                </para>
                                <para>
                                    <literal>"off"</literal>: the forthcoming drawings are overplotted
                                    in the axes according to the <literal>"auto_scale"</literal> rule
                                    and other properties.
                                </para>
                            </listitem>
                        </varlistentry>
                        <varlistentry>
                            <term>auto_scale: </term>
                            <listitem>
                                <para>
                                    Property enabling the auto update of <literal>.data_bounds</literal>.
                                    <literal>"on"</literal>: Each new plot enlarges
                                    <literal>.data_bounds</literal> values according to boundaries
                                    of added data.
                                    <literal>"off"</literal>: Default or explicitly initialized values
                                    of <literal>.data_bounds</literal> are not modified.
                                </para>
                            </listitem>
                        </varlistentry>
                        <varlistentry>
                            <term>auto_stretch: </term>
                            <listitem>
                                <para>
                                    Property disabling axis box filling when 3D properties.
                                    <literal>"on"</literal>: Default, each new 3D plot maximize the box according to boundaries
                                    of added data.
                                    <literal>"off"</literal>: Keep 3D box size from a previous computation.
                                </para>
                            </listitem>
                        </varlistentry>
                    </variablelist>
                </listitem>
            </varlistentry>
            <varlistentry>
                <term>Children's default values: </term>
                <listitem>
                    <variablelist>
                        <varlistentry>
                            <term>hiddencolor: </term>
                            <listitem>
                                <para>
                                    This property controls the hidden parts' color. It takes as
                                    value an index relative to the current colormap. In another case,
                                    if it is a negative value, the hidden parts take the same colors
                                    as the surface
                                </para>
                            </listitem>
                        </varlistentry>
                        <varlistentry>
                            <term>line_mode: </term>
                            <listitem>
                                <para>
                                    This field contains the default <literal>line_mode</literal>
                                    property value for Segs Rectangle Legend Axis Plot3d Fac3d and
                                    Polyline objects. Its value should be <literal>"on" </literal>(default)
                                    or <literal>"off"</literal>.
                                </para>
                            </listitem>
                        </varlistentry>
                        <varlistentry>
                            <term>line_style: </term>
                            <listitem>
                                <para>
                                    This field contains the default <literal>line_style</literal>
                                    property value for Segs, Arcs, Rectangle and Polyline objects.
                                    <literal>line_style</literal> selects the type of line to be used to
                                    draw lines . Its value should be an integer in [1 10]. 1
                                    stand for solid, the other values stand for a selection of dashes
                                    (dash, dash dot, longdash dot, bigdash dot, bigdash longdash, dot, double dot, longblank dot, bigblank dot).
                                </para>
                            </listitem>
                        </varlistentry>
                        <varlistentry>
                            <term>thickness: </term>
                            <listitem>
                                <para>
                                    This field contains the default <literal>thickness</literal>
                                    property value for all objects using line drawing. It is a positive real specifying the line width
                                    in pixels. The displayed width is actually determined by rounding the supplied width
                                    to the nearest integer. The only exception is vectorial export where the whole <literal>thickness</literal>
                                    value is considered.
                                </para>
                            </listitem>
                        </varlistentry>
                        <varlistentry>
                            <term>mark_mode: </term>
                            <listitem>
                                <para>
                                    This field contains the default <literal>mark_mode</literal>
                                    property value for Segs Rectangle Legend Axis Plot3d Fac3d and
                                    Polyline objects. Its value should be <literal>"on" </literal> or
                                    <literal>"off"</literal> (default).
                                </para>
                            </listitem>
                        </varlistentry>
                        <varlistentry>
                            <term>mark_style: </term>
                            <listitem>
                                <para>
                                    This field contains the default <literal>mark_style</literal>
                                    property value for Segs Rectangle Legend Axis Plot3d Fac3d and
                                    Polyline objects. <literal>mark_style</literal> selects the type of mark
                                    to be displayed. Its value should be an integer in [0 9] which
                                    stands for: dot, plus, cross, star, filled diamond, diamond,
                                    triangle up, triangle down, trefle and circle.
                                </para>
                            </listitem>
                        </varlistentry>
                        <varlistentry>
                            <term>mark_size_unit: </term>
                            <listitem>
                                <para>
                                    This field contains the default <literal>mark_size_unit</literal>
                                    property value for Segs Rectangle Legend Axis Plot3d Fac3d and
                                    Polyline objects. If <literal>mark_size_unit</literal> is set to
                                    <literal>"point"</literal>, then the <literal>mark_size</literal> value is
                                    directly given in points. When <literal>mark_size_unit</literal> is set
                                    to <literal>"tabulated"</literal>, <literal>mark_size</literal> is computed
                                    relative to the font size array: therefore, its value should be an
                                    integer in [0 5] which stands for 8pt, 10pt, 12pt, 14pt, 18pt and
                                    24pt. Note that <link linkend="plot2d">plot2d</link> and pure scilab functions use
                                    <literal>tabulated</literal> mode as default ; when using
                                    <link linkend="plot">plot</link> function, the <literal>point</literal> mode is
                                    automatically enabled.
                                </para>
                            </listitem>
                        </varlistentry>
                        <varlistentry>
                            <term>mark_size: </term>
                            <listitem>
                                <para>
                                    This field contains the default <literal>mark_size</literal>
                                    property value for Segs Rectangle Legend Axis Plot3d Fac3d and
                                    Polyline objects. <literal>mark_size</literal> selects the font size of
                                    mark to be displayed. Its value should be an integer in [0 5]
                                    which stands for 8pt, 10pt, 12pt, 14pt, 18pt and 24pt.
                                </para>
                                <para>
                                    <warning>In the special case where mark_style and mark_size are 0, a dot of one pixel is drawn.</warning>
                                </para>
                            </listitem>
                        </varlistentry>
                        <varlistentry>
                            <term>mark_foreground: </term>
                            <listitem>
                                <para>
                                    This field contains the default <literal>mark_foreground</literal>
                                    property value for all objects created under this axes. Polyline,
                                    rectangle, legend, surface, segment and axis objects are using
                                    this property to specify a foreground (edge) color for their
                                    marks. Its value should be a color index (relative to the current
                                    color_map) or 0 for transparent edge. Note that the default value is <literal>-1</literal>
                                    (default black) and, even if you change the
                                    <literal>color_map</literal>, this <literal>-1</literal> value will always
                                    point onto the default black color.
                                </para>
                            </listitem>
                        </varlistentry>
                        <varlistentry>
                            <term>mark_background: </term>
                            <listitem>
                                <para>
                                    This property controls the default
                                    <literal>mark_background</literal> property value for all objects
                                    created under this axes. Polyline, rectangle, legend, surface,
                                    segment and axis objects are using this property to specify a
                                    background (face) color for their marks. It takes as value an
                                    index relative to the current colormap or 0 for transparent face. Note that the default value
                                    is <literal>-2</literal> (default white) and, even if you change the
                                    <literal>color_map</literal>, this <literal>-2</literal> value will always
                                    point onto the default white color.
                                </para>
                            </listitem>
                        </varlistentry>
                        <varlistentry>
                            <term>foreground: </term>
                            <listitem>
                                <para>
                                    This field contains the default <literal>foreground</literal>
                                    property value for axes and all objects created under this axes.
                                    Its value should be a color index (relative to the current
                                    color_map). Note that the default value is <literal>-1</literal>
                                    (default black) and, even if you change the
                                    <literal>color_map</literal>, this <literal>-1</literal> value will always
                                    point onto the default black color.
                                </para>
                            </listitem>
                        </varlistentry>
                        <varlistentry>
                            <term>background: </term>
                            <listitem>
                                <para>
                                    This property controls the default <literal>background</literal>
                                    property value for axes and all objects created under this axes.
                                    It takes as value an index relative to the current colormap.Note
                                    that the default value is <literal>-2</literal> (default white) and,
                                    even if you change the <literal>color_map</literal>, this
                                    <literal>-2</literal> value will always point onto the default white
                                    color.
                                </para>
                            </listitem>
                        </varlistentry>
                        <varlistentry>
                            <term>arc_drawing_mode: </term>
                            <listitem>
                                <para>
                                    This property controls the default <literal>arc_drawing_mode</literal>
                                    property value for all created Arc objects under this Axes object.
                                    Its value should be either <literal>"nurbs"</literal> or <literal>"lines"</literal>.
                                </para>
                            </listitem>
                        </varlistentry>
                        <varlistentry>
                            <term>clip_state: </term>
                            <listitem>
                                <para>
                                    This field contains the default <literal>clip_state</literal>
                                    property value for all objects. Its value should be :
                                </para>
                                <itemizedlist>
                                    <listitem>
                                        <para>
                                            <literal>"off"</literal> this means that all objects created
                                            after that are not clipped (default value).
                                        </para>
                                    </listitem>
                                    <listitem>
                                        <para>
                                            <literal>"clipgrf"</literal> this means that all objects created
                                            after that are clipped outside the Axes boundaries.
                                        </para>
                                    </listitem>
                                    <listitem>
                                        <para>
                                            <literal>"on"</literal> this means that all objects created
                                            after that are clipped outside the rectangle given by property
                                            clip_box.
                                        </para>
                                    </listitem>
                                </itemizedlist>
                            </listitem>
                        </varlistentry>
                        <varlistentry>
                            <term>clip_box: </term>
                            <listitem>
                                <para>
                                    This field contains the default <literal>clip_box</literal> property
                                    value for all objects. Its value should be an empty matrix if
                                    clip_state is <literal>"off"</literal>. Other case the clipping is given
                                    by the vector <literal>[x,y,w,h]</literal> (upper-left point width
                                    height).
                                </para>
                            </listitem>
                        </varlistentry>
                        <varlistentry>
                            <term>Note on default values :</term>
                            <listitem>
                                <variablelist>
                                    <varlistentry>
                                        <term/>
                                        <listitem>
                                            <para>
                                                All these listed properties and fields inherit from
                                                default values stored in an axes model. These default values
                                                can be seen and changed. To do so, use the
                                                <literal>get("default_axes")</literal> command : it returns a
                                                graphic handle on the axes model. Note that no graphic window
                                                is created by this command. The next created axes will inherit
                                                from this model (see "Example on axes model" below).
                                            </para>
                                        </listitem>
                                    </varlistentry>
                                </variablelist>
                            </listitem>
                        </varlistentry>
                    </variablelist>
                </listitem>
            </varlistentry>
        </variablelist>
    </refsection>
    <refsection>
        <title>Examples</title>
        <programlisting role="example"><![CDATA[
lines(0) // disables vertical paging
a=get("current_axes")//get the handle of the newly created axes
a.axes_visible="on"; // makes the axes visible
a.font_size=3; //set the tics label font size
a.x_location="top"; //set the x axis position
a.data_bounds=[-100,-2,-1;100,2,1]; //set the boundary values for the x, y and z coordinates.
a.sub_tics=[5,0];
a.labels_font_color=5;
a.grid=[2,2];
a.box="off";

// Example with 3D axes
clf(); //clear the graphics window
x=0.1:0.1:2*%pi;plot2d(x-.3,sin(x)*7+.2);
a=gca(); // get the handle of the current axes
a.grid=[1 -1 -1]; //make x-grid
a.rotation_angles=[70 250]; //turn the axes with giving angles
a.grid=[1 6 -1]; //make y-grid
a.view="2d"; //return te the 2d view
a.box="back_half";
a.labels_font_color=5;
a.children.children.thickness=4;
a.children.children.polyline_style=3;
a.view="3d"; //return te the 3d view
a.children.children.thickness=1;
a.children.children.foreground=2;
a.grid=[1 6 3]; //make z-grid
a.parent.background=4;
a.background=7;
plot2d(cos(x)+1,3*sin(x)-3);
plot2d(cos(x)+7,3*sin(x)+3);
a.children(2).children.polyline_style=2;
a.children(1).children.polyline_style=4;
a.children(1).children.foreground=5;
a.children(2).children.foreground=14;
a.parent.figure_size= [1200,800];
a.box="on";
a.labels_font_size=4;
a.parent.background=8;
a.parent.figure_size= [400,200];
a.rotation_angles=[0 260];
delete(a.children(2));
delete(); // delete current object

a = gca();
a.labels_font_size=1;
a.auto_clear= "on";
x=0:0.1:2.5*%pi;plot2d(10*cos(x),sin(x));

a.data_bounds(:,1) = [1;15] ; // set positive bounds for X axe
a.log_flags = "lnn" ; // set X axes to logarithmic scale
a.log_flags = "nnn" ; // switch back to linear scale

a=gca();
a.rotation_angles=[45 45];
a.data_bounds=[-20,-3,-2;20 3 ,2];
xrect([-4 0.5 8 1]);
a.auto_clear = "off" ;
a.isoview="on"; // isoview mode
xrect([-2 0.25 4 0.5]);
a.children(1).fill_mode="on";
a.axes_visible="off";
a.children(1).data=[-2 0.25 -1 4 0.5];
a.children(2).data=[-4 0.5 1 8 1];
x=2*%pi*(0:7)/8;
xv=[.2*sin(x);.9*sin(x)];yv=[.2*cos(x);.9*cos(x)];
xsegs(10*xv,yv,1:8)
s=a.children(1);
s.arrow_size=1;
s.segs_color=5;
a.data_bounds //the boundary values for the x,y and z coordinates
a.view="2d";
a.data_bounds=[-10,-1; 10,1]; // set the boundary values for the two-dimensional views

// Example on axes model
da=gda() // get the handle on axes model to view and edit the fields
// title by default
da.title.text="My Default@Title"
da.title.foreground = 12;
da.title.font_size = 4;
// x labels default
da.x_label.text="x";
da.x_label.text="x"; // Latex or MathML can be used here also
da.x_label.font_style = 8;
da.x_label.font_size = 2;
da.x_label.foreground = 5;
da.x_location = "middle";
// y labels default
da.y_label.text="y";
da.y_label.font_style = 3;
da.y_label.font_size = 5;
da.y_label.foreground = 3;
da.y_location = "right";
da.thickness = 2;
da.foreground = 7;
// the plot
x=(0:0.1:2*%pi)';
plot2d(x,[sin(x),sin(2*x),sin(3*x)],style=[1,2,3],rect=[0,-2,2*%pi,2]);
sda() // back to default axes model


// Example with LaTeX / MathML ticks:
plot2d();
a=gca();

mathml = "<mrow><mfrac><mrow><mi>d</mi>  <mi>y</mi></mrow><mrow>  <mi>d</mi>  <mi>x</mi></mrow></mfrac> <mo>=</mo>" + ...
    "<mfrac><mn>1</mn><msup> <mi>y</mi>  <mn>2</mn></msup> </mfrac> </mrow>";
// Only LaTeX expression
a.x_ticks = tlist(["ticks", "locations", "labels"], (0:6)', [mathml;"1";"$\sin(x)$";"3";"$\cos(a) - test$";"5";"6"]);

// Mixed expression: MathML and LaTex
a.y_ticks = tlist(["ticks", "locations", "labels"], (-2:0.5:2)', ["0";"1";"2";"3";"$\cos(a)$";"5";"6";mathml;"8"]);

 ]]>
        </programlisting>
        <para/>
        <programlisting role="example"><![CDATA[
m = [66.425514; 66.425513];
plot([69;70], m);
a = gca();
a.ticks_format = ["" sprintf("%.2f", m(2))+"%+.1e"];
a.ticks_st = [1 1;0 m(2)];
]]></programlisting>
        <para>
            Example with vertical x_ticks labels:
        </para>
        <programlisting role="example" id="axes_properties_vertical_xticks"><![CDATA[
rain_Nice  = [51  45  39 69 45 34 12 18 73 133 104 93 ];
months = _(["January" "February" "March" "April" "May" "June" "July" ...
            "August" "September" "October" "November" "December"]);
clf
bar(rain_Nice,1,"cyan");
title(_("Rain - Nice (France)"), "fontsize",3)
ylabel("[mm]")
gca().x_ticks.labels = "$\rotatebox{90}{\mathsf{"+months'+"}}$";
set(gca(), "tight_limits", "on", "font_size", 2);
gcf().axes_size = [460 320];
]]></programlisting>
    <scilab:image localized="true">
rain_Nice  = [51  45  39 69 45 34 12 18 73 133 104 93 ];
months = _(["January" "February" "March" "April" "May" "June" "July" ..
            "August" "September" "October" "November" "December"]);
clf
bar(rain_Nice, 1, "cyan")
title(_("Rain - Nice (France)"), "fontsize",3);
ylabel("[mm]");
gca().x_ticks.labels = "$\rotatebox{90}{\mathsf{"+months'+"}}$";
set(gca(), "tight_limits", "on", "font_size", 2);
gcf().axes_size = [420 320];
    </scilab:image>
    </refsection>
    <refsection role="see also">
        <title>See also</title>
        <simplelist type="inline">
            <member>
                <link linkend="axis_properties">axis_properties</link>
            </member>
            <member>
                <link linkend="drawaxis">drawaxis</link>
            </member>
            <member>
                <link linkend="set">set</link>
            </member>
            <member>
                <link linkend="get">get</link>
            </member>
            <member>
                <link linkend="gca">gca</link>
            </member>
            <member>
                <link linkend="gda">gda</link>
            </member>
            <member>
                <link linkend="sda">sda</link>
            </member>
            <member>
                <link linkend="polyline_properties">polyline_properties</link>
            </member>
            <member>
                <link linkend="graphics_entities">graphics_entities</link>
            </member>
        </simplelist>
    </refsection>
    <refsection>
        <title>History</title>
        <revhistory>
            <revision>
                <revnumber>5.4.0</revnumber>
                <revremark>.line_style value 0 is replaced with 1 (for solid line).</revremark>
            </revision>
            <revision>
                <revnumber>5.5.0</revnumber>
                <revremark>
                    <itemizedlist>
                        <listitem>.grid_style and .grid_thickness properties added.</listitem>
                        <listitem>
                            .line_style values 9 and 10 can be used to have respectively longblank
                            dot and bigblank dot styles.
                        </listitem>
                        <listitem>
                            .auto_margins property added to allow automatic computation of the margins.
                        </listitem>
                        <listitem>
                            .ticks_format and .ticks_st properties added to improve ticks labels
                            display.
                        </listitem>
                        <listitem>
                            For an axes drawn in a uicontrol frame, .axes_bounds now refers to
                            the frame area instead of the figure area.
                        </listitem>
                    </itemizedlist>
                </revremark>
            </revision>
            <revision>
                <revnumber>5.5.2</revnumber>
                <revremark>.tight_limits property can now manage X, Y and Z axis separately.</revremark>
            </revision>
            <revision>
                <revnumber>6.1.0</revnumber>
                <revremark>Default .grid_style is now [7 7] instead of [3 3].</revremark>
            </revision>
            <revision>
                <revnumber>6.1.1</revnumber>
                <revremark>
                    Default .x|y|z_label.font_size=2, instead of 1.
                    Default .title.font_size=3, instead of 1.
                </revremark>
            </revision>
            <revision>
                <revnumber>2023.0.0</revnumber>
                <revremark>
                    <literal>.auto_stretch</literal> property added.
                </revremark>
            </revision>
        </revhistory>
    </refsection>
</refentry>
