* Bug 2247 fixed [doc]: axes_properties page updated/improved 73/20673/4
Samuel GOUGEON [Sun, 23 Dec 2018 17:55:22 +0000 (18:55 +0100)]
  http://bugzilla.scilab.org/2247

  PDF page: http://bugzilla.scilab.org/attachment.cgi?id=4868

Change-Id: If847ea95131784a9dcaac976ae082059096229b8

scilab/CHANGES.md
scilab/modules/graphics/help/en_US/axes_operations/axes_properties.xml
scilab/modules/graphics/help/ja_JP/axes_operations/axes_properties.xml
scilab/modules/graphics/help/pt_BR/axes_operations/axes_properties.xml
scilab/modules/helptools/etc/images_md5.txt
scilab/modules/helptools/images/axes_properties_en_US_1.png [new file with mode: 0644]
scilab/modules/helptools/images/axes_properties_fr_FR_1.png [new file with mode: 0644]
scilab/modules/helptools/images/axes_properties_ja_JP_1.png [new file with mode: 0644]
scilab/modules/helptools/images/axes_properties_pt_BR_1.png [new file with mode: 0644]
scilab/modules/helptools/images/axes_properties_ru_RU_1.png [new file with mode: 0644]

index 018e956..eb0e9b6 100644 (file)
@@ -402,6 +402,7 @@ Known issues
 
 
 ### Bugs fixed in 6.0.2:
+* [#2247](http://bugzilla.scilab.org/show_bug.cgi?id=2247): The axes_properties page did not show how to yield vertical x-tick labels. `.grid_style`, `.grid_thickness`, and `.axes_bounds` inside a uicontrol frame were not documented. 
 * [#2464](http://bugzilla.scilab.org/show_bug.cgi?id=2464): `null()` was poorly documented.
 * [#4050](http://bugzilla.scilab.org/show_bug.cgi?id=4050): `ged()` did not support graphical texts with a font size > 5.
 * [#4953](http://bugzilla.scilab.org/show_bug.cgi?id=4953): The `clean` function does not work when the matrix contains %inf.
index 6d09589..5754cf5 100644 (file)
@@ -22,8 +22,7 @@
     <refnamediv>
         <refname>axes properties</refname>
         <refpurpose>
-            description of the axes entity
-            properties
+            description of the axes entity properties
         </refpurpose>
     </refnamediv>
     <refsection>
                             <term>grid: </term>
                             <listitem>
                                 <para>
-                                    The field value is a vector
-                                    <literal>[x-grid,y-grid,z-grid]</literal> where <literal>x-grid</literal>
-                                    controls a grid drawning for the x-axis and <literal>
-                                        y-grid,
-                                        z-grid
-                                    </literal>
-                                    respecting to the y-axis, z-axis. The default values
-                                    is <literal>-1</literal> grids are not drawn, else the grids are drawn
-                                    using the color given indexed by the grid value.
+                                    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>
-                                    This character string specifies the grid position compared with other graphic entities.
-                                    Its value can be either <literal>"foreground"</literal>
-                                    to draw the grid ahead other graphic entities or <literal>"background"</literal> to draw the grid behind.
+                                    <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>
                                                 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>
+                                                <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>
                             <term>axes_bounds: </term>
                             <listitem>
                                 <para>
-                                    A vector <literal>[x_left,y_up,width,height]</literal> specifying
-                                    the portion of figure used by this axes. Where
-                                    <literal>x_left</literal>, <literal>y_up</literal>, <literal>width</literal> and
-                                    <literal>height</literal> are numbers in [0 1] give respectively the
-                                    position of the upper-left corner and the dimension of the axes
-                                    (these numbers are ratio relative to the corresponding figure
-                                    <literal>figure_size</literal> property values).
+                                    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.figure_size(3:4)</literal>
+                                    or to the <literal>gca().parent.position(3:4)</literal>
+                                    dimensions of the figure or of the Uicontrol frame
+                                    embedding the axes.
                                 </para>
                             </listitem>
                         </varlistentry>
@@ -1040,8 +1079,8 @@ sda() // back to default axes model
 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>";
+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"]);
 
@@ -1051,15 +1090,40 @@ a.y_ticks = tlist(["ticks", "locations", "labels"], (-2:0.5:2)', ["0";"1";"2";"3
  ]]>
         </programlisting>
         <para/>
-        <programlisting role="example">
-            <![CDATA[
-m=[66.425514; 66.425513];
+        <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>
+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" "Febuary" "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" "Febuary" "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>
@@ -1068,7 +1132,7 @@ a.ticks_st=[1 1;0 m(2)];
                 <link linkend="axis_properties">axis_properties</link>
             </member>
             <member>
-                <link linkend="lines">lines</link>
+                <link linkend="drawaxis">drawaxis</link>
             </member>
             <member>
                 <link linkend="set">set</link>
@@ -1083,16 +1147,10 @@ a.ticks_st=[1 1;0 m(2)];
                 <link linkend="gda">gda</link>
             </member>
             <member>
-                <link linkend="gcf">gcf</link>
-            </member>
-            <member>
                 <link linkend="sda">sda</link>
             </member>
             <member>
-                <link linkend="sdf">sdf</link>
-            </member>
-            <member>
-                <link linkend="scf">scf</link>
+                <link linkend="polyline_properties">polyline_properties</link>
             </member>
             <member>
                 <link linkend="graphics_entities">graphics_entities</link>
@@ -1104,23 +1162,38 @@ a.ticks_st=[1 1;0 m(2)];
         <revhistory>
             <revision>
                 <revnumber>5.4.0</revnumber>
-                <revremark>line_style value 0 is obsolete, use 1 instead (both are equivalent for SOLID).
-                  Using value 0 will produce an error in Scilab 5.4.1.</revremark>
+                <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 property added.</listitem>
-                        <listitem>.line_style values 9 and 10 can be used to have respectively long blank 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>.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>
+                <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>
         </revhistory>
     </refsection>
index 31d611c..e055156 100644 (file)
@@ -3,8 +3,8 @@
  * Scilab ( http://www.scilab.org/ ) - This file is part of Scilab
  * Copyright (C) INRIA - Djalel Abdemouche
  * Copyright (C) 2009 - DIGITEO - Pierre Lando
- *
  * Copyright (C) 2012 - 2016 - Scilab Enterprises
+ * Copyright (C) 2013, 2018 - Samuel GOUGEON
  *
  * 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.
                             </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>Haxes.y_ticks.labels = Labels</literal> または
                                                 <literal>Haxes.y_ticks.labels(j) = newLabelJ</literal>のように
                                                 (y軸に関して)変更できます.
+                                                <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>
                             <term>axes_bounds: </term>
                             <listitem>
                                 <para>
-                                    ベクトル <literal>[x_left,y_up,width,height]</literal> はこの軸で
-                                    使用される図の部分を指定します.
-                                    ただし, <literal>x_left</literal>, <literal>y_up</literal>, <literal>width</literal>
-                                    および<literal>height</literal>は[0 1]の範囲の数値で,
-                                    それぞれ左上隅の位置と軸の寸法を指定します.
-                                    (これらの数値は対応する図<literal>figure_size</literal>プロパティの値
-                                    に対する比です.)
+                                    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.figure_size(3:4)</literal>
+                                    or to the <literal>gca().parent.position(3:4)</literal>
+                                    dimensions of the figure or of the Uicontrol frame
+                                    embedding the axes.
                                 </para>
                             </listitem>
                         </varlistentry>
@@ -1019,8 +1064,8 @@ sda() // デフォルトの軸モデルに戻す
 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>";
+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>";
 // LaTeX 式のみ
 a.x_ticks = tlist(["ticks", "locations", "labels"], (0:6)', [mathml;"1";"$\sin(x)$";"3";"$\cos(a) - test$";"5";"6"]);
 // 式の混用: MathML と LaTex
@@ -1037,6 +1082,32 @@ 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" "Febuary" "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);
+]]></programlisting>
+    <scilab:image localized="true">
+rain_Nice  = [51  45  39 69 45 34 12 18 73 133 104 93 ];
+months = _(["January" "Febuary" "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>参照</title>
@@ -1045,7 +1116,7 @@ a.ticks_st=[1 1;0 m(2)];
                 <link linkend="axis_properties">axis_properties</link>
             </member>
             <member>
-                <link linkend="lines">lines</link>
+                <link linkend="drawaxis">drawaxis</link>
             </member>
             <member>
                 <link linkend="set">set</link>
@@ -1060,16 +1131,10 @@ a.ticks_st=[1 1;0 m(2)];
                 <link linkend="gda">gda</link>
             </member>
             <member>
-                <link linkend="gcf">gcf</link>
-            </member>
-            <member>
                 <link linkend="sda">sda</link>
             </member>
             <member>
-                <link linkend="sdf">sdf</link>
-            </member>
-            <member>
-                <link linkend="scf">scf</link>
+                <link linkend="polyline_properties">polyline_properties</link>
             </member>
             <member>
                 <link linkend="graphics_entities">graphics_entities</link>
@@ -1081,7 +1146,7 @@ a.ticks_st=[1 1;0 m(2)];
         <revhistory>
             <revision>
                 <revnumber>5.4.0</revnumber>
-                <revremark>line_style の値 0 が廃止対象となりましたので,代わりに1を使用してください
+                <revremark>.line_style の値 0 が廃止対象となりましたので,代わりに1を使用してください
                     (両者は共に実線であり,等価です).
                     値0は Scilab 5.4.1でエラーとなります.
                 </revremark>
@@ -1090,7 +1155,7 @@ a.ticks_st=[1 1;0 m(2)];
                 <revnumber>5.5.0</revnumber>
                 <revremark>
                     <itemizedlist>
-                        <listitem>.grid_style property added.</listitem>
+                        <listitem>.grid_style and .grid_thickness properties added.</listitem>
                         <listitem>.line_style の値 9 と 10 を使用でき,
                             それぞれlongblank dot および bigblank dot 形式を意味します.
                         </listitem>
@@ -1100,9 +1165,21 @@ a.ticks_st=[1 1;0 m(2)];
                         <listitem>.ticks_format と .ticks_st プロパティが追加され,
                             目盛ラベルの表示が改善されました.
                         </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>
         </revhistory>
     </refsection>
 </refentry>
index e1091b7..53c1abc 100644 (file)
@@ -2,8 +2,8 @@
 <!--
  * Scilab ( http://www.scilab.org/ ) - This file is part of Scilab
  * Copyright (C) INRIA - Djalel Abdemouche
- *
  * Copyright (C) 2012 - 2016 - Scilab Enterprises
+ * Copyright (C) 2013, 2018 - Samuel GOUGEON
  *
  * 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.
  * 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:ns3="http://www.w3.org/1999/xhtml" xmlns:mml="http://www.w3.org/1998/Math/MathML" xmlns:db="http://docbook.org/ns/docbook" xmlns:scilab="http://www.scilab.org" xml:id="axes_properties" xml:lang="pt">
+<refentry xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink"
+          xmlns:svg="http://www.w3.org/2000/svg" xmlns:ns3="http://www.w3.org/1999/xhtml"
+          xmlns:mml="http://www.w3.org/1998/Math/MathML" xmlns:db="http://docbook.org/ns/docbook"
+          xmlns:scilab="http://www.scilab.org" xml:id="axes_properties" xml:lang="pt">
     <refnamediv>
         <refname>axes_properties</refname>
-        <refpurpose>descrição das propriedades de entidades Axes (de
-            eixos)
+        <refpurpose>descrição das propriedades de entidades Axes (de eixos)
         </refpurpose>
     </refnamediv>
     <refsection>
                             </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>Este string determina a posição do grido comparada às
                                             <listitem>
                                                 é um vetor de textos contendo as etiquetas a serem exibidos na frente de cada um dos principais graduação relacionados. Quanto aos locais de formaturas, Locations podem ser tratadas com (por exemplo, ao longo de y)
                                                 <literal>Haxes.y_ticks.labels = Labels</literal> ou <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>
                             </listitem>
                         </varlistentry>
                         <varlistentry>
-                            <term>axes_bounds:</term>
+                            <term>axes_bounds: </term>
                             <listitem>
                                 <para>
-                                    um vetor <literal>[x_left,y_up,width,height]</literal>
-                                    especificando a porção da figura usada por estes eixos, onde
-                                    <literal>x_left</literal>, <literal>y_up</literal>,
-                                    <literal>width</literal> e <literal>height</literal> são
-                                    números em [0 1] fornecendo respectivamente a posição do canto
-                                    superior esquerdo e a dimensão dos eixos (testes números são
-                                    razões relativas aos valores correspondentes da propriedade de
-                                    figura <literal>figure_size</literal>).
+                                    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.figure_size(3:4)</literal>
+                                    or to the <literal>gca().parent.position(3:4)</literal>
+                                    dimensions of the figure or of the Uicontrol frame
+                                    embedding the axes.
                                 </para>
                             </listitem>
                         </varlistentry>
@@ -934,6 +981,32 @@ 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() // de volta aos eixos modelos padrões
  ]]></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" "Febuary" "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);
+]]></programlisting>
+    <scilab:image localized="true">
+rain_Nice  = [51  45  39 69 45 34 12 18 73 133 104 93 ];
+months = _(["January" "Febuary" "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>
         <title>Ver Também </title>
@@ -942,10 +1015,7 @@ sda() // de volta aos eixos modelos padr
                 <link linkend="axis_properties">axis_properties</link>
             </member>
             <member>
-                <link linkend="graphics_entities">graphics_entities</link>
-            </member>
-            <member>
-                <link linkend="lines">lines</link>
+                <link linkend="drawaxis">drawaxis</link>
             </member>
             <member>
                 <link linkend="set">set</link>
@@ -960,17 +1030,54 @@ sda() // de volta aos eixos modelos padr
                 <link linkend="gda">gda</link>
             </member>
             <member>
-                <link linkend="gcf">gcf</link>
-            </member>
-            <member>
                 <link linkend="sda">sda</link>
             </member>
             <member>
-                <link linkend="sdf">sdf</link>
+                <link linkend="polyline_properties">polyline_properties</link>
             </member>
             <member>
-                <link linkend="scf">scf</link>
+                <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>
+        </revhistory>
+    </refsection>
 </refentry>
index ab02bfb..830e015 100644 (file)
@@ -653,6 +653,11 @@ asind_1.png=228e297136b7b30666241d462f5c58c8
 asinh_1.png=487c5932acafb700ce3ff3da7dc485a3
 atand_1.png=8c5dae12354712ac3fab90999228771c
 autumncolormap_1.png=826c2a0572e5c987444f8bb7d9e66b
+axes_properties_en_US_1.png=4969e3dd46c4d3d557cae0944088f2c3
+axes_properties_fr_FR_1.png=4969e3dd46c4d3d557cae0944088f2c3
+axes_properties_ja_JP_1.png=4969e3dd46c4d3d557cae0944088f2c3
+axes_properties_pt_BR_1.png=4969e3dd46c4d3d557cae0944088f2c3
+axes_properties_ru_RU_1.png=4969e3dd46c4d3d557cae0944088f2c3
 bar_1.png=968aa7a4f076bc4bd450f5ad25845434
 bar_2.png=f4c4662565d146bc03ba40b0344897aa
 bar_3.png=e658d6bd8080ca95d71ef70c5431f7c8
diff --git a/scilab/modules/helptools/images/axes_properties_en_US_1.png b/scilab/modules/helptools/images/axes_properties_en_US_1.png
new file mode 100644 (file)
index 0000000..ccd285f
Binary files /dev/null and b/scilab/modules/helptools/images/axes_properties_en_US_1.png differ
diff --git a/scilab/modules/helptools/images/axes_properties_fr_FR_1.png b/scilab/modules/helptools/images/axes_properties_fr_FR_1.png
new file mode 100644 (file)
index 0000000..d7866bc
Binary files /dev/null and b/scilab/modules/helptools/images/axes_properties_fr_FR_1.png differ
diff --git a/scilab/modules/helptools/images/axes_properties_ja_JP_1.png b/scilab/modules/helptools/images/axes_properties_ja_JP_1.png
new file mode 100644 (file)
index 0000000..35498fa
Binary files /dev/null and b/scilab/modules/helptools/images/axes_properties_ja_JP_1.png differ
diff --git a/scilab/modules/helptools/images/axes_properties_pt_BR_1.png b/scilab/modules/helptools/images/axes_properties_pt_BR_1.png
new file mode 100644 (file)
index 0000000..dae3bfa
Binary files /dev/null and b/scilab/modules/helptools/images/axes_properties_pt_BR_1.png differ
diff --git a/scilab/modules/helptools/images/axes_properties_ru_RU_1.png b/scilab/modules/helptools/images/axes_properties_ru_RU_1.png
new file mode 100644 (file)
index 0000000..cbcc2bf
Binary files /dev/null and b/scilab/modules/helptools/images/axes_properties_ru_RU_1.png differ