* Bug 16320 fixed: typos in blocks interfaces + a few files
[scilab.git] / scilab / modules / graphics / help / en_US / axes_operations / axes_properties.xml
1 <?xml version="1.0" encoding="UTF-8"?>
2 <!--
3  * Scilab ( http://www.scilab.org/ ) - This file is part of Scilab
4  * Copyright (C) INRIA - Djalel Abdemouche
5  * Copyright (C) 2009 - DIGITEO - Pierre Lando
6  * Copyright (C) 2013, 2018 - Samuel GOUGEON
7  *
8  * Copyright (C) 2012 - 2016 - Scilab Enterprises
9  *
10  * This file is hereby licensed under the terms of the GNU GPL v2.0,
11  * pursuant to article 5.3.4 of the CeCILL v.2.1.
12  * This file was originally licensed under the terms of the CeCILL v2.1,
13  * and continues to be available under such terms.
14  * For more information, see the COPYING file which you should have received
15  * along with this program.
16  *
17  -->
18 <refentry xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink"
19           xmlns:svg="http://www.w3.org/2000/svg" xmlns:mml="http://www.w3.org/1998/Math/MathML"
20           xmlns:db="http://docbook.org/ns/docbook" xmlns:scilab="http://www.scilab.org"
21           xml:lang="en" xml:id="axes_properties">
22     <refnamediv>
23         <refname>axes properties</refname>
24         <refpurpose>
25             description of the axes entity properties
26         </refpurpose>
27     </refnamediv>
28     <refsection>
29         <title>Description</title>
30         <para>
31             The Axes entity is the second level of the graphics entities hierarchy.
32             This entity defines the parameters allowing the change of coordinates and
33             the axes drawing as well as the parameters' default values for the
34             children creation.
35         </para>
36         <variablelist>
37             <varlistentry>
38                 <term>Axes properties</term>
39                 <listitem>
40                     <variablelist>
41                         <varlistentry>
42                             <term>parent: </term>
43                             <listitem>
44                                 <para>This field contains the handle of the parent figure.</para>
45                             </listitem>
46                         </varlistentry>
47                         <varlistentry>
48                             <term>children: </term>
49                             <listitem>
50                                 <para>
51                                     FA vector containing the handles of all graphics objects
52                                     children of the axes These graphics objects are of type
53                                     <literal>"Compound"</literal>, <literal>"Rectangle"</literal>,
54                                     <literal>"Polyline"</literal>, <literal>"Segs"</literal>, <literal>"Arc"</literal>,
55                                     <literal>"Grayplot"</literal>,.. (see <link linkend="Compound_properties">Compound_properties</link>,
56                                     <link linkend="rectangle_properties">rectangle_properties</link>, <link linkend="champ_properties">champ_properties</link>,
57                                     <link linkend="axis_properties">axis_properties</link>, <link linkend="polyline_properties">polyline_properties</link>,
58                                     <link linkend="segs_properties">segs_properties</link>, <link linkend="grayplot_properties">grayplot_properties</link>,
59                                     <link linkend="surface_properties">surface_properties</link>,
60                                     <link linkend="fec_properties">fec_properties</link>, <link linkend="text_properties">text_properties</link>,
61                                     <link linkend="legend_properties">legend_properties</link>)
62                                 </para>
63                             </listitem>
64                         </varlistentry>
65                         <varlistentry>
66                             <term>visible: </term>
67                             <listitem>
68                                 <para>
69                                     This field contains the <literal>visible</literal> property value
70                                     for axes . Its value should be <literal>"on" </literal> or
71                                     <literal>"off"</literal> . By default, axes is visible <literal>"on"</literal>
72                                     in case all "visible" children are displayed on the screen, If
73                                     <literal>"off"</literal> the axes and all its children are not
74                                     drawn.
75                                 </para>
76                             </listitem>
77                         </varlistentry>
78                         <varlistentry>
79                             <term>axes_visible: </term>
80                             <listitem>
81                                 <para>
82                                     A <literal>1x3</literal> string vector. This property specifies
83                                     whether each axis is drawn or not. Its value should be
84                                     <literal>"on"</literal> or <literal>"off"</literal> for a global setting.To
85                                     act on a single axis, the syntax is <literal>axes_visible(N)</literal>
86                                     where <literal>N</literal> is <literal>1,2</literal> or <literal>3</literal>
87                                     corresponding to the <literal> x,y</literal> or <literal>z</literal> axis. The
88                                     scaling data and if required the grids are drawn if the value is
89                                     <literal>"on"</literal>. Note that when creating a simple axes entity
90                                     using the <literal>gca()</literal> (shortcut for
91                                     <literal>get"current_axes")</literal>) or <literal>gcf()</literal> (shortcut
92                                     for <literal>get(current_figure)</literal>) commands, the axes
93                                     visibility is set to <literal>"off"</literal>.
94                                 </para>
95                             </listitem>
96                         </varlistentry>
97                         <varlistentry>
98                             <term>axes_reverse: </term>
99                             <listitem>
100                                 <para>
101                                     A <literal>1x3</literal> string vector corresponding to the three
102                                     axes (X,Y,Z). For each axes, the property specifies the direction
103                                     of the increasing values. If <literal>"off"</literal>, the default
104                                     direction is used. If <literal>"on"</literal>, the direction is reverse.
105                                     It is also possible to use only one string, <literal>"on"</literal> or
106                                     <literal>"off"</literal>, to set simultaneously the three data.
107                                 </para>
108                             </listitem>
109                         </varlistentry>
110                         <varlistentry>
111                             <term>grid: </term>
112                             <listitem>
113                                 <para>
114                                     vector of 3 colors indices <literal>[xCol, yCol, zCol]</literal>
115                                     used to draw the grid along respective directions.
116                                     To cancel the grid in a direction, use <literal>-1</literal>
117                                     as index. Default = <literal>[-1 -1 -1]</literal> (no grid).
118                                 </para>
119                             </listitem>
120                         </varlistentry>
121                         <varlistentry>
122                             <term>grid_style: </term>
123                             <listitem>
124                                 <para>
125                                     vector <literal>[xLineStyle, yLineStyle, zLineStyle]</literal>
126                                     of 2 or 3 line styles ids from 1 to 10 (solid, dashes, dots, etc)
127                                     used to draw the grid along respective directions (in 2D or 3D).
128                                     Available line styles are described
129                                     <link linkend="polyline_properties">there</link>.
130                                 </para>
131                             </listitem>
132                         </varlistentry>
133                         <varlistentry>
134                             <term>grid_thickness: </term>
135                             <listitem>
136                                 <para>
137                                     vector <literal>[xLineThick, yLineThick, zLineThick]</literal>
138                                     of 2 or 3 positive decimal numbers setting the thickness of
139                                     the grid lines along respective directions (in 2D or 3D).
140                                </para>
141                             </listitem>
142                         </varlistentry>
143                         <varlistentry>
144                             <term>grid_position: </term>
145                             <listitem>
146                                 <para>
147                                     <literal>"background"</literal> (default): the grid is drawn
148                                     behind all other graphical components ;
149                                     or <literal>"foreground</literal>: the grid is drawn on the top.
150                                 </para>
151                             </listitem>
152                         </varlistentry>
153                         <varlistentry>
154                             <term>x_location: </term>
155                             <listitem>
156                                 <para>
157                                     Specify the location of the x-axis. The possible values
158                                     are:
159                                 </para>
160                                 <itemizedlist>
161                                     <listitem>
162                                         <para>
163                                             <literal>"bottom"</literal>. In this case the x axis is drawn at
164                                             the bottom of the axes rectangle.
165                                         </para>
166                                     </listitem>
167                                     <listitem>
168                                         <para>
169                                             <literal>"top"</literal>. In this case the x axis is drawn at
170                                             the top of the axes rectangle.
171                                         </para>
172                                     </listitem>
173                                     <listitem>
174                                         <para>
175                                             <literal>"middle"</literal>. In this case the x axis is drawn
176                                             at the centered position.
177                                         </para>
178                                     </listitem>
179                                     <listitem>
180                                         <para>
181                                             <literal>"origin"</literal>. In this case the x axis is drawn
182                                             at the origin.
183                                         </para>
184                                     </listitem>
185                                 </itemizedlist>
186                             </listitem>
187                         </varlistentry>
188                         <varlistentry>
189                             <term>y_location: </term>
190                             <listitem>
191                                 <para>
192                                     Specify the location of the y-axis. The possible values
193                                     are:
194                                 </para>
195                                 <itemizedlist>
196                                     <listitem>
197                                         <para>
198                                             <literal>"left"</literal>. In this case the y axis is drawn at
199                                             the left of the axes rectangle.
200                                         </para>
201                                     </listitem>
202                                     <listitem>
203                                         <para>
204                                             <literal>"right"</literal>. In this case the y axis is drawn at
205                                             the right of the axes rectangle.
206                                         </para>
207                                     </listitem>
208                                     <listitem>
209                                         <para>
210                                             <literal>"middle"</literal>. In this case the y axis is drawn
211                                             at the centered position.
212                                         </para>
213                                     </listitem>
214                                     <listitem>
215                                         <para>
216                                             <literal>"origin"</literal>. In this case the y axis is drawn
217                                             at the origin.
218                                         </para>
219                                     </listitem>
220                                 </itemizedlist>
221                             </listitem>
222                         </varlistentry>
223                         <varlistentry>
224                             <term>title: </term>
225                             <listitem>
226                                 <para>
227                                     An object attached to the Axes entity and returning a graphic
228                                     handle on a Label structure (see <link linkend="label_properties">label_properties</link>).
229                                     This field defines a title with options on this label.
230                                 </para>
231                             </listitem>
232                         </varlistentry>
233                         <varlistentry>
234                             <term>x_label: </term>
235                             <listitem>
236                                 <para>
237                                     An object attached to the Axes entity and returning a graphic
238                                     handle on a Label structure (see <link linkend="label_properties">label_properties</link>).
239                                     This field defines a label on x axis with options on this
240                                     label.
241                                 </para>
242                             </listitem>
243                         </varlistentry>
244                         <varlistentry>
245                             <term>y_label: </term>
246                             <listitem>
247                                 <para>
248                                     An object attached to the Axes entity and returning a graphic
249                                     handle on a Label structure (see <link linkend="label_properties">label_properties</link>).
250                                     This field defines a label on y axis with options on this
251                                     label.
252                                 </para>
253                             </listitem>
254                         </varlistentry>
255                         <varlistentry>
256                             <term>z_label: </term>
257                             <listitem>
258                                 <para>
259                                     An object attached to the Axes entity and returning a graphic
260                                     handle on a Label structure (see <link linkend="label_properties">label_properties</link>).
261                                     This field defines a label on z axis with options on this
262                                     label.
263                                 </para>
264                             </listitem>
265                         </varlistentry>
266                         <varlistentry>
267                             <term>auto_ticks: </term>
268                             <listitem>
269                                 <para>
270                                     Default <literal>["on" "on" "on"]</literal>. auto_ticks status
271                                     for each x, y and z respective axis.
272                                 </para>
273                                 <para>
274                                     <literal>"on"</literal> means that the axis is automatically
275                                     graduated through a
276                                     computational algorithm. Then, resizing the figure and axes
277                                     automatically updates accordingly graduations ticks and labels
278                                     of the given axis.
279                                </para>
280                                <para>
281                                     On the contrary, <literal>"off"</literal> means that graduations
282                                     ticks or/and labels are set by hand. Then resizing the figure and
283                                     axes has no effect on existing graduations ticks and labels.
284                               </para>
285                               <para>Setting <literal>.auto_ticks="on"</literal> or <literal>"off"</literal>
286                                 sets the same status for the x, y and z axes. Setting
287                                 <literal>.auto_ticks(2)="off"</literal> sets the status only for the
288                                 y axis. Etc.
289                               </para>
290                               <warning>
291                                 Editing ticks (labels and/or locations) via
292                                 <literal>x_ticks, y_ticks</literal> or  <literal>z_ticks</literal>
293                                 automatically sets <literal>auto_ticks</literal> to <literal>"off"</literal>
294                                 for the corresponding axes.
295                               </warning>
296                             </listitem>
297                         </varlistentry>
298                         <varlistentry>
299                             <term>x_ticks, y_ticks, z_ticks: </term>
300                             <listitem>
301                                 <para>
302                                     Each of these properties is a tlist of type "ticks" with 2 fields named "locations" and "labels":
303                                     <literal>tlist(["ticks", "locations", "labels"], Locations, Labels)</literal> where
304                                     <variablelist>
305                                         <varlistentry>
306                                             <term>Locations</term>
307                                             <listitem>
308                                                 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.
309                                                 When the number of ticks does not need to be changed, their locations can be set or changed through
310                                                 the syntax (e.g. along x) <literal>Haxes.x_ticks.locations = Locations</literal> where <literal>Haxes = gca();</literal>
311                                                 and <literal>Locations</literal> is the complete vector of updated ticks positions. To change just the ith location, just use:
312                                                 <literal>Haxes.x_ticks.locations(i) = newLoc</literal>
313                                             </listitem>
314                                         </varlistentry>
315                                         <varlistentry>
316                                             <term>Labels</term>
317                                             <listitem>
318                                                 is a text vector containing the labels to be displayed
319                                                 in front of each related graduation. As for Locations
320                                                 of ticks, Labels can be addressed with (e.g. along y)
321                                                 <literal>Haxes.y_ticks.labels = Labels</literal> or
322                                                 <literal>Haxes.y_ticks.labels(j) = newLabelJ</literal>.
323                                                 <para>
324                                                 Vertical or tilted ticks labels can be yielded using
325                                                 LaTeX formating with
326                                                 <literal>\rotatebox{angle}{text}</literal>. See the
327                                                 <link linkend="axes_properties_vertical_xticks">example</link>
328                                                 below.
329                                                 </para>
330                                             </listitem>
331                                         </varlistentry>
332                                     </variablelist>
333                                     <warning>
334                                         <itemizedlist>
335                                         <listitem>
336                                             For an axis, <literal>Locations</literal> and
337                                             <literal>Labels</literal> vectors must have the same
338                                             number of components.
339                                         </listitem>
340                                         <listitem>
341                                             When the number of ticks must be changed, their positions
342                                             AND labels must be changed at once, in order to avoid
343                                             any mismatch: The syntax (e.g. along x)
344                                             <literal>Haxes.x_ticks = tlist(["ticks" "locations", "labels"], newLocations, newLabels)</literal>
345                                             must then be used.
346                                         </listitem>
347                                         <listitem>
348                                             Changing by hand the <literal>Locations</literal> or/and
349                                             <literal>Labels</literal> of an axis automatically sets
350                                             its <literal>.auto_ticks</literal> status to
351                                             <literal>"off"</literal>. This cancels its
352                                             auto-regraduation under resizing of the figure.
353                                         </listitem>
354                                       </itemizedlist>
355                                     </warning>
356                                 </para>
357                             </listitem>
358                         </varlistentry>
359                         <varlistentry>
360                             <term>x_ticks.locations, y_ticks.locations, z_ticks.locations: </term>
361                             <listitem>
362                                 <para>
363                                     Each of these properties is a real vector containing the locations
364                                   of graduations on the related x or y or z axis.
365                                   <varname>x_ticks.locations</varname> must have the same number of
366                                   components as <varname>x_ticks.labels</varname>.
367                                   See <varname>x_ticks</varname> hereabove for more details.
368                                 </para>
369                             </listitem>
370                         </varlistentry>
371                         <varlistentry>
372                             <term>x_ticks.labels, y_ticks.labels, z_ticks.labels: </term>
373                             <listitem>
374                                 <para>
375                                   Each of these properties is a text vector containing the labels
376                                   to be displayed in front of ticks on the related x or y or z axis.
377                                   <varname>x_ticks.labels</varname> must have the same number of
378                                   components as <varname>x_ticks.locations</varname>.
379                                   See <varname>x_ticks</varname> hereabove for more details.
380                                 </para>
381                             </listitem>
382                         </varlistentry>
383                         <varlistentry>
384                             <term>ticks_format: </term>
385                             <listitem>
386                                 <para>
387                                     This property specifies the format to use for each axes.
388                                     It is a row vector with at most 3 columns containing strings
389                                     format (as specified for <link linkend="mprintf">mprintf</link>).
390                                     Each ticks position will be used to format the string used as label.
391                                 </para>
392                                 <para>
393                                     So, for example ticks_format="%.2e" will print ticks positions
394                                     in using scientific notation with two decimals.
395                                 </para>
396                                 <warning>
397                                    Labels are actually updated according to the newly set
398                                    <literal>.ticks_format(i)</literal> only if the
399                                    <literal>.auto_ticks(i)</literal> status of the axis #i is
400                                    <literal>"on"</literal>. Otherwise,
401                                    <literal>.ticks_format(i)</literal> is recorded without being
402                                    immediately used.
403                                 </warning>
404                             </listitem>
405                         </varlistentry>
406                         <varlistentry>
407                             <term>ticks_st: </term>
408                             <listitem>
409                                 <para>
410                                   This property specifies scale-translate factors to apply to each
411                                   ticks position before to use it in the formatted string used as
412                                   label. So if the factors are
413                                   <literal>[x_s y_s z_s ; x_t y_t z_t]</literal> and if a x_tick is
414                                   positioned at X, the value used to format the label will be
415                                   <literal>x_s*(X-x_t)</literal>. It could be particularly useful
416                                   when the axes bounds are too closed.
417                                     <para>
418                                         It is a matrix with 2 rows and at most 3 columns.
419                                     </para>
420                                 </para>
421                                 <para>
422                                     So, for example <literal>base=B</literal>, labels could be
423                                     printed with <literal>ticks_format=string(base)+"%+.2e"</literal>
424                                     and <literal>ticks_st=[1 base]</literal>
425                                 </para>
426                             </listitem>
427                         </varlistentry>
428                         <varlistentry>
429                             <term>box: </term>
430                             <listitem>
431                                 <para>
432                                     This property specifies whether to enclose the axes in a box.
433                                     Its value can be either <literal>"off"</literal>,
434                                     <literal>"hidden_axes"</literal>, <literal>"back_half"</literal> or
435                                     <literal>"on".</literal> If the property is <literal>"off"</literal>, the box
436                                     is not draw. If the property is <literal>"hidden_axes"</literal>, only
437                                     the back frame is drawn. If the property is
438                                     <literal>"back_half"</literal>, the X, Y and Z axis are also drawn. If
439                                     the property is <literal>"on"</literal> the whole box is drawn.
440                                 </para>
441                                 <scilab:image><![CDATA[
442                                     box = ["on" "back_half" "hidden_axes" "off"];
443                                     for i = 1:4
444                                         subplot(1,4,i)
445                                         plot3d([0 1],[0 1],[0 1])
446                                         a = gca();
447                                         a.box = box(i);
448                                         a.rotation_angles = [235 326];
449                                         title(msprintf("%s", box(i)), "fontsize",3)
450                                     end
451                                     gcf().axes_size = [840 222];
452                                 ]]></scilab:image>
453                             </listitem>
454                         </varlistentry>
455                         <varlistentry>
456                             <term>filled: </term>
457                             <listitem>
458                                 <para>
459                                     This property specifies whether the axes background should be drawn or not.
460                                     Its value can be either <literal>"off"</literal> or
461                                     <literal>"on".</literal> If the property is <literal>"off"</literal>, the background
462                                     is not drawn, the axes box is transparent. If the property is <literal>"on"</literal> the
463                                     background is drawn using the color specified by the <literal>background</literal> property.
464                                 </para>
465                             </listitem>
466                         </varlistentry>
467                         <varlistentry>
468                             <term>sub_ticks: </term>
469                             <listitem>
470                                 <para>
471                                     This field sets the number of tics to draw between two main
472                                     tics. The field value is the vector <literal>[nx,ny]</literal> where
473                                     <literal>nx</literal> is the number of sub tics for the x-axis and
474                                     <literal>ny</literal> respecting to the y-axis.
475                                 </para>
476                             </listitem>
477                         </varlistentry>
478                         <varlistentry>
479                             <term>font_style: </term>
480                             <listitem>
481                                 <para>
482                                     Specifies the font used for displaying tics labels. This is a positive integer referecing one of the loaded fonts.
483                                     Its value must be between 0, referecing the first font,
484                                     and the number of loaded fonts minus one, referencing the last font.
485                                     For more information see <link linkend="graphics_fonts">graphics_fonts</link>.
486                                 </para>
487                             </listitem>
488                         </varlistentry>
489                         <varlistentry>
490                             <term>font_size: </term>
491                             <listitem>
492                                 <para>
493                                     It is a scalar specifying the character size of tics labels.
494                                     If <literal>fractional_font</literal> property is <literal>"off"</literal>
495                                     only the integer part of the value is used.
496                                     For more information see <link linkend="graphics_fonts">graphics_fonts</link>.
497                                 </para>
498                             </listitem>
499                         </varlistentry>
500                         <varlistentry>
501                             <term>font_color: </term>
502                             <listitem>
503                                 <para>This property determines the color of the tics labels.</para>
504                             </listitem>
505                         </varlistentry>
506                         <varlistentry>
507                             <term>fractional_font: </term>
508                             <listitem>
509                                 <para>
510                                     This property specify whether ticks labels are displayed using fractional font sizes.
511                                     Its value must be either <literal>"on"</literal> or <literal>"off"</literal>.
512                                     If <literal>"on"</literal> the floating point value of <literal>font_size</literal>
513                                     is used for display and the font is anti-aliased. If <literal>"off"</literal> only the integer part is used
514                                     and the font is not smoothed.
515                                 </para>
516                             </listitem>
517                         </varlistentry>
518                         <varlistentry>
519                             <term>isoview: </term>
520                             <listitem>
521                                 <para>
522                                     This property is used to have isometric scales on the x, y and
523                                     z axes (for example to make the display of the curve sin(x) versus
524                                     cos(x) be a circle not an ellipse). Its value should be
525                                     <literal>"on"</literal> or <literal>"off"</literal>. If the value is
526                                     <literal>"on"</literal>, the axes <literal>data_bounds</literal> automatically
527                                     change according to the corresponding figure
528                                     <literal>figure_size</literal> property values.
529                                 </para>
530                             </listitem>
531                         </varlistentry>
532                         <varlistentry>
533                             <term>cube_scaling:</term>
534                             <listitem>
535                                 <para>
536                                     This property is used in <literal>3d mode</literal> to have a
537                                     rescaling of the x, y and z axes. Indeed, it allows the
538                                     <literal>data</literal> to fit into a 1x1x1 cube ; the goal is to better
539                                     display 3d graphics in case axes scales are very different from
540                                     one to another. Its value should be <literal>"on" </literal> or
541                                     <literal>"off"</literal> (which is the default value). In most cases, it
542                                     helps generating Matlab-like 3d view.
543                                 </para>
544                             </listitem>
545                         </varlistentry>
546                         <varlistentry>
547                             <term>view: </term>
548                             <listitem>
549                                 <para>
550                                     This field is related to the graphics universe. It takes
551                                     <literal>"3d"</literal> as value corresponding to the three-dimensional
552                                     views. In the other case its value can be <literal>"2d"</literal> for
553                                     initial 2d plotting (default value). This flag also depends on the
554                                     plots the user enters : a <literal>plot3d </literal>command, for
555                                     example, will switch the <literal>view</literal> flag from
556                                     <literal>"2d"</literal> to <literal>"3d"</literal>.
557                                 </para>
558                             </listitem>
559                         </varlistentry>
560                         <varlistentry>
561                             <term>rotation_angles: </term>
562                             <listitem>
563                                 <para>
564                                     Spherical coordinates <literal>[alpha, theta]</literal> =
565                                     <literal>[polAngle, azimuth]</literal> of the observation point,
566                                     in degrees:
567                                     <itemizedlist>
568                                         <listitem>
569                                             <emphasis role="bold">theta</emphasis>: azimuth angle
570                                             in the (x,y) plane. Particular angles, for (x,y) seen
571                                             from (O,z):
572                                             <table>
573                                                 <tr><td>270 </td><td>: (O,x) to right</td></tr>
574                                                 <tr><td>0 </td><td>: (O,x) to bottom</td></tr>
575                                                 <tr><td>90 </td><td>: (O,x) to left</td></tr>
576                                                 <tr><td>180 </td><td>: (O,x) to top</td></tr>
577                                             </table>
578                                             <scilab:image><![CDATA[
579                                             // gca().rotation_angles:
580                                             // Azimuth:
581                                             // --------
582                                             x = linspace(0,30,100);
583                                             y = exp(-x/7).*sin(x);
584                                             scf(1);
585                                             clf
586                                             i = 1;
587                                             for a = [270 315 0 90 180]
588                                                 subplot(1,5,i)
589                                                 plot(x, y, "b")
590                                                 gca().rotation_angles(2) = a;
591                                                 gca().margins = [0.17 0.17 0.25 0.15];
592                                                 gca().box = "on";
593                                                 gca().cube_scaling = "on";
594                                                 title(msprintf("theta = %d\n\r", a), "fontsize",3, "color",color("magenta3"))
595                                                 i = i + 1;
596                                             end
597                                             gcf().axes_size = [810 200];
598                                             ]]></scilab:image>
599                                         </listitem>
600                                         <listitem>
601                                             <emphasis role="bold">alpha</emphasis>: polar angle from
602                                             (Oz), in planes orthogonal to (x,y). Particular values:
603                                             <table>
604                                                 <tr><td>0</td><td>= North pole (O,z)</td><td> view from above</td></tr>
605                                                 <tr><td>90</td><td>= Equator (x,y)</td><td> view from side</td></tr>
606                                                 <tr><td>180</td><td>= South pole (O,-z)</td><td> view from below</td></tr>
607                                             </table>
608                                             <scilab:image><![CDATA[
609                                             // gca().rotation_angles:
610                                             // polar angle
611                                             // -----------
612                                             scf(2);
613                                             clf
614                                             i = 1
615                                             for a = [0 30 60 90 120]
616                                                 subplot(1,5,i)
617                                                 plot3d()
618                                                 gce().color_mode = -2;
619                                                 gca().rotation_angles = [a 300];
620                                             //    gca().margins = [0.17 0.17 0.25 0.15];
621                                             //    gca().box = "on";
622                                                 gca().cube_scaling = "on";
623                                                 title(msprintf("alpha = %d\n", a), "fontsize",3, "color",color("magenta3"))
624                                                 i = i + 1;
625                                             end
626                                             gcf().axes_size = [810 220];
627                                             ]]></scilab:image>
628                                         </listitem>
629                                     </itemizedlist>
630                                 </para>
631                             </listitem>
632                         </varlistentry>
633                         <varlistentry>
634                             <term>log_flags: </term>
635                             <listitem>
636                                 <para>
637                                     3 character string that sets the scale (linear or logarithmic) along the axes.
638                                     Each character specifies the scale for respectively the X, Y and Z axes.
639                                     They should take a value between <literal>'n'</literal> for linear scale or
640                                     <literal>'l'</literal> for logarithmic scale.
641                                 </para>
642                                 <scilab:image><![CDATA[
643                                     x = linspace(0,10,100)(2:$);
644                                     m = ["nn" "ln" "nl" "ll"];
645                                     clf
646                                     for i = 1:4
647                                         subplot(1,4,i)
648                                         plot2d(m(i), x, x.^2)
649                                         xgrid(color("grey75"),1,7)
650                                         title(msprintf("""%s""",m(i)),"fontsize",3)
651                                         select i
652                                         case 1, gca().sub_ticks = [3 3];
653                                         case 2, gca().sub_ticks = [8 3];
654                                         case 3, gca().sub_ticks = [3 8];
655                                         case 4, gca().sub_ticks = [8 8];
656                                         end
657                                     end
658                                     gcf().axes_size = [800 220];
659                                 ]]></scilab:image>
660                             </listitem>
661                         </varlistentry>
662                         <varlistentry>
663                             <term>tight_limits: </term>
664                             <listitem>
665                                 <para>
666                                     A <literal>1x3</literal> string vector giving the tight_limits status
667                                     for each axis. This property specifies whether each axis fits exactly with the minima and
668                                     maxima values of the data bounds. If an item is <literal>"off"</literal>, the corresponding axis may
669                                     enlarge boundaries such as to produce pretty tics labels. For a global setting (all axes at once), you have to set its value
670                                     to <literal>"on"</literal> or <literal>"off"</literal> (single string). To act on a single axis,
671                                     the syntax is <literal>tight_limits(N)</literal> where <literal>N</literal> is
672                                     <literal>1,2</literal> or <literal>3</literal> corresponding to the
673                                     <literal>x,y</literal> or <literal>z</literal> axis.
674                                 </para>
675                             </listitem>
676                         </varlistentry>
677                         <varlistentry>
678                             <term>data_bounds: </term>
679                             <listitem>
680                                 <para>
681                                     This field contains the boundary values for the x, y and z
682                                     coordinates. It is either the matrix or the vector
683                                     <literal>[xmin,ymin; xmax,ymax]</literal>,
684                                     <literal>[xmin,ymin,zmin; xmax,ymax,zmax]</literal>,
685                                     <literal>[xmin,xmax,ymin,ymax]</literal>,
686                                     <literal>[xmin,xmax,ymin,ymax,zmin,zmax]</literal>,
687                                     <literal>[xmin;xmax;ymin;ymax]</literal> or
688                                     <literal>[xmin;xmax;ymin;ymax;zmin;zmax]</literal>. Note that, to strictly have the
689                                     specified data bounds, <literal>tight_limits</literal> must be set to
690                                     <literal>"on"</literal> value (see above).
691                                     To manually set data_bounds set <literal>auto_scale="off"</literal>
692                                 </para>
693                             </listitem>
694                         </varlistentry>
695                         <varlistentry>
696                             <term>zoom_box: </term>
697                             <listitem>
698                                 <para>
699                                     This field contains the current zoom box if any coordinates
700                                     are given. It is an empty matrix (no zoom) or the vector
701                                     <literal>[xmin,ymin,xmax,ymax,zmin,zmax]</literal> (defines a smaller axes box).
702                                 </para>
703                             </listitem>
704                         </varlistentry>
705                         <varlistentry>
706                             <term>margins: </term>
707                             <listitem>
708                                 <para>
709                                     A vector
710                                     <literal>[margin_left,margin_right,margin_top,margin_bottom]</literal>
711                                     specifying the margins portion for this axes. This vector is
712                                     composed of numbers between [0 1] with default: [0.125 0.125 0.125
713                                     0.125]. These numbers are ratios relative to associated values of the
714                                     <literal>axes_bounds</literal> property, which are <literal>width</literal> for
715                                     <literal>margin_left</literal> and <literal>margin_right</literal>, and
716                                     <literal>height</literal> for <literal>margin_top</literal> and
717                                     <literal>margin_bottom</literal>.
718                                 </para>
719                             </listitem>
720                         </varlistentry>
721                         <varlistentry>
722                             <term>auto_margins: </term>
723                             <listitem>
724                                 <para>
725                                     A property to allow the automatic computation of the margins accordint to their contents.
726                                     If value is <literal>"on"</literal>, then the automatic computation is activated.
727                                 </para>
728                             </listitem>
729                         </varlistentry>
730                         <varlistentry>
731                             <term>axes_bounds: </term>
732                             <listitem>
733                                 <para>
734                                     Vector <literal>[x_left, y_top, width, height]</literal> of
735                                     four decimal numbers in [0, 1] specifying the portion of figure
736                                     or frame used by this axes:
737                                     <itemizedlist>
738                                         <listitem>
739                                             <literal>x_left</literal> and <literal>y_top</literal>
740                                             set the position of the top-left corner of the axes area,
741                                             with respect to the top-left corner of the embedding
742                                             figure or frame.
743                                         </listitem>
744                                         <listitem>
745                                             <literal>width</literal> and <literal>height</literal>
746                                             set the dimensions of the axes area. 1 stands for the
747                                             full width or height of the embedding figure or frame.
748                                         </listitem>
749                                     </itemizedlist>
750                                 </para>
751                                 <para>
752                                     These numbers are relative to the
753                                     <literal>gca().parent.position(3:4)</literal> [width, height]
754                                     dimensions of the figure or of the Uicontrol frame
755                                     embedding the axes.
756                                 </para>
757                             </listitem>
758                         </varlistentry>
759                         <varlistentry>
760                             <term>hidden_axis_color: </term>
761                             <listitem>
762                                 <para>
763                                     This property defined the color of the hidden axis. It takes
764                                     an index relative to the current colormap.
765                                 </para>
766                             </listitem>
767                         </varlistentry>
768                         <varlistentry>
769                             <term>user_data: </term>
770                             <listitem>
771                                 <para>
772                                     This field can be use to store any scilab variable in the axes
773                                     data structure, and to retrieve it.
774                                 </para>
775                             </listitem>
776                         </varlistentry>
777                     </variablelist>
778                 </listitem>
779             </varlistentry>
780             <varlistentry>
781                 <term>Properties for high level functions</term>
782                 <listitem>
783                     <para>
784                         The <literal>plot</literal>, <literal>plot2dx</literal>, <literal>grayplot</literal>
785                         and <literal>matplot</literal> functions use the following properties to
786                         decide how to merge consecutive plots if this is not stated by the
787                         <literal>frameflag</literal> calling argument. The result of the merge is
788                         decided through these two following properties:
789                     </para>
790                     <variablelist>
791                         <varlistentry>
792                             <term>auto_clear: </term>
793                             <listitem>
794                                 <para>
795                                     If this property value is equal to <literal>"on"</literal>, a call
796                                     to a high level graphic will re-initialize the current axes and
797                                     erase all its children before preforming the drawing (log_flags will be reset).
798                                     If the value is <literal>"off"</literal> the drawings will be added to current axes
799                                     according to <literal>"auto_scale"</literal> property.
800                                 </para>
801                             </listitem>
802                         </varlistentry>
803                         <varlistentry>
804                             <term>auto_scale: </term>
805                             <listitem>
806                                 <para>
807                                     A property to update the axes data boundary. If value is
808                                     <literal>"on"</literal>, a new plot will adapt the current axes
809                                     properties to fit with previous and current plots. If its value is
810                                     <literal>"off"</literal> the new plot will be drawn in the current axes
811                                     data boundary.
812                                 </para>
813                             </listitem>
814                         </varlistentry>
815                     </variablelist>
816                 </listitem>
817             </varlistentry>
818             <varlistentry>
819                 <term>Children's default values: </term>
820                 <listitem>
821                     <variablelist>
822                         <varlistentry>
823                             <term>hiddencolor: </term>
824                             <listitem>
825                                 <para>
826                                     This property controls the hidden parts' color. It takes as
827                                     value an index relative to the current colormap. In another case,
828                                     if it is a negative value, the hidden parts take the same colors
829                                     as the surface
830                                 </para>
831                             </listitem>
832                         </varlistentry>
833                         <varlistentry>
834                             <term>line_mode: </term>
835                             <listitem>
836                                 <para>
837                                     This field contains the default <literal>line_mode</literal>
838                                     property value for Segs Rectangle Legend Axis Plot3d Fac3d and
839                                     Polyline objects. Its value should be <literal>"on" </literal>(default)
840                                     or <literal>"off"</literal>.
841                                 </para>
842                             </listitem>
843                         </varlistentry>
844                         <varlistentry>
845                             <term>line_style: </term>
846                             <listitem>
847                                 <para>
848                                     This field contains the default <literal>line_style</literal>
849                                     property value for Segs, Arcs, Rectangle and Polyline objects.
850                                     <literal>line_style</literal> selects the type of line to be used to
851                                     draw lines . Its value should be an integer in [1 10]. 1
852                                     stand for solid, the other values stand for a selection of dashes
853                                     (dash, dash dot, longdash dot, bigdash dot, bigdash longdash, dot, double dot, longblank dot, bigblank dot).
854                                 </para>
855                             </listitem>
856                         </varlistentry>
857                         <varlistentry>
858                             <term>thickness: </term>
859                             <listitem>
860                                 <para>
861                                     This field contains the default <literal>thickness</literal>
862                                     property value for all objects using line drawing. It is a positive real specifying the line width
863                                     in pixels. The displayed width is actually determined by rounding the supplied width
864                                     to the nearest integer. The only exception is vectorial export where the whole <literal>thickness</literal>
865                                     value is considered.
866                                 </para>
867                             </listitem>
868                         </varlistentry>
869                         <varlistentry>
870                             <term>mark_mode: </term>
871                             <listitem>
872                                 <para>
873                                     This field contains the default <literal>mark_mode</literal>
874                                     property value for Segs Rectangle Legend Axis Plot3d Fac3d and
875                                     Polyline objects. Its value should be <literal>"on" </literal> or
876                                     <literal>"off"</literal> (default).
877                                 </para>
878                             </listitem>
879                         </varlistentry>
880                         <varlistentry>
881                             <term>mark_style: </term>
882                             <listitem>
883                                 <para>
884                                     This field contains the default <literal>mark_style</literal>
885                                     property value for Segs Rectangle Legend Axis Plot3d Fac3d and
886                                     Polyline objects. <literal>mark_style</literal> selects the type of mark
887                                     to be displayed. Its value should be an integer in [0 9] which
888                                     stands for: dot, plus, cross, star, filled diamond, diamond,
889                                     triangle up, triangle down, trefle and circle.
890                                 </para>
891                             </listitem>
892                         </varlistentry>
893                         <varlistentry>
894                             <term>mark_size_unit: </term>
895                             <listitem>
896                                 <para>
897                                     This field contains the default <literal>mark_size_unit</literal>
898                                     property value for Segs Rectangle Legend Axis Plot3d Fac3d and
899                                     Polyline objects. If <literal>mark_size_unit</literal> is set to
900                                     <literal>"point"</literal>, then the <literal>mark_size</literal> value is
901                                     directly given in points. When <literal>mark_size_unit</literal> is set
902                                     to <literal>"tabulated"</literal>, <literal>mark_size</literal> is computed
903                                     relative to the font size array: therefore, its value should be an
904                                     integer in [0 5] which stands for 8pt, 10pt, 12pt, 14pt, 18pt and
905                                     24pt. Note that <link linkend="plot2d">plot2d</link> and pure scilab functions use
906                                     <literal>tabulated</literal> mode as default ; when using
907                                     <link linkend="plot">plot</link> function, the <literal>point</literal> mode is
908                                     automatically enabled.
909                                 </para>
910                             </listitem>
911                         </varlistentry>
912                         <varlistentry>
913                             <term>mark_size: </term>
914                             <listitem>
915                                 <para>
916                                     This field contains the default <literal>mark_size</literal>
917                                     property value for Segs Rectangle Legend Axis Plot3d Fac3d and
918                                     Polyline objects. <literal>mark_size</literal> selects the font size of
919                                     mark to be displayed. Its value should be an integer in [0 5]
920                                     which stands for 8pt, 10pt, 12pt, 14pt, 18pt and 24pt.
921                                 </para>
922                                 <para>
923                                     <warning>In the special case where mark_style and mark_size are 0, a dot of one pixel is drawn.</warning>
924                                 </para>
925                             </listitem>
926                         </varlistentry>
927                         <varlistentry>
928                             <term>mark_foreground: </term>
929                             <listitem>
930                                 <para>
931                                     This field contains the default <literal>mark_foreground</literal>
932                                     property value for all objects created under this axes. Polyline,
933                                     rectangle, legend, surface, segment and axis objects are using
934                                     this property to specify a foreground (edge) color for their
935                                     marks. Its value should be a color index (relative to the current
936                                     color_map) or 0 for transparent edge. Note that the default value is <literal>-1</literal>
937                                     (default black) and, even if you change the
938                                     <literal>color_map</literal>, this <literal>-1</literal> value will always
939                                     point onto the default black color.
940                                 </para>
941                             </listitem>
942                         </varlistentry>
943                         <varlistentry>
944                             <term>mark_background: </term>
945                             <listitem>
946                                 <para>
947                                     This property controls the default
948                                     <literal>mark_background</literal> property value for all objects
949                                     created under this axes. Polyline, rectangle, legend, surface,
950                                     segment and axis objects are using this property to specify a
951                                     background (face) color for their marks. It takes as value an
952                                     index relative to the current colormap or 0 for transparent face. Note that the default value
953                                     is <literal>-2</literal> (default white) and, even if you change the
954                                     <literal>color_map</literal>, this <literal>-2</literal> value will always
955                                     point onto the default white color.
956                                 </para>
957                             </listitem>
958                         </varlistentry>
959                         <varlistentry>
960                             <term>foreground: </term>
961                             <listitem>
962                                 <para>
963                                     This field contains the default <literal>foreground</literal>
964                                     property value for axes and all objects created under this axes.
965                                     Its value should be a color index (relative to the current
966                                     color_map). Note that the default value is <literal>-1</literal>
967                                     (default black) and, even if you change the
968                                     <literal>color_map</literal>, this <literal>-1</literal> value will always
969                                     point onto the default black color.
970                                 </para>
971                             </listitem>
972                         </varlistentry>
973                         <varlistentry>
974                             <term>background: </term>
975                             <listitem>
976                                 <para>
977                                     This property controls the default <literal>background</literal>
978                                     property value for axes and all objects created under this axes.
979                                     It takes as value an index relative to the current colormap.Note
980                                     that the default value is <literal>-2</literal> (default white) and,
981                                     even if you change the <literal>color_map</literal>, this
982                                     <literal>-2</literal> value will always point onto the default white
983                                     color.
984                                 </para>
985                             </listitem>
986                         </varlistentry>
987                         <varlistentry>
988                             <term>arc_drawing_mode: </term>
989                             <listitem>
990                                 <para>
991                                     This property controls the default <literal>arc_drawing_mode</literal>
992                                     property value for all created Arc objects under this Axes object.
993                                     Its value should be either <literal>"nurbs"</literal> or <literal>"lines"</literal>.
994                                 </para>
995                             </listitem>
996                         </varlistentry>
997                         <varlistentry>
998                             <term>clip_state: </term>
999                             <listitem>
1000                                 <para>
1001                                     This field contains the default <literal>clip_state</literal>
1002                                     property value for all objects. Its value should be :
1003                                 </para>
1004                                 <itemizedlist>
1005                                     <listitem>
1006                                         <para>
1007                                             <literal>"off"</literal> this means that all objects created
1008                                             after that are not clipped (default value).
1009                                         </para>
1010                                     </listitem>
1011                                     <listitem>
1012                                         <para>
1013                                             <literal>"clipgrf"</literal> this means that all objects created
1014                                             after that are clipped outside the Axes boundaries.
1015                                         </para>
1016                                     </listitem>
1017                                     <listitem>
1018                                         <para>
1019                                             <literal>"on"</literal> this means that all objects created
1020                                             after that are clipped outside the rectangle given by property
1021                                             clip_box.
1022                                         </para>
1023                                     </listitem>
1024                                 </itemizedlist>
1025                             </listitem>
1026                         </varlistentry>
1027                         <varlistentry>
1028                             <term>clip_box: </term>
1029                             <listitem>
1030                                 <para>
1031                                     This field contains the default <literal>clip_box</literal> property
1032                                     value for all objects. Its value should be an empty matrix if
1033                                     clip_state is <literal>"off"</literal>. Other case the clipping is given
1034                                     by the vector <literal>[x,y,w,h]</literal> (upper-left point width
1035                                     height).
1036                                 </para>
1037                             </listitem>
1038                         </varlistentry>
1039                         <varlistentry>
1040                             <term>Note on default values :</term>
1041                             <listitem>
1042                                 <variablelist>
1043                                     <varlistentry>
1044                                         <term/>
1045                                         <listitem>
1046                                             <para>
1047                                                 All these listed properties and fields inherit from
1048                                                 default values stored in an axes model. These default values
1049                                                 can be seen and changed. To do so, use the
1050                                                 <literal>get("default_axes")</literal> command : it returns a
1051                                                 graphic handle on the axes model. Note that no graphic window
1052                                                 is created by this command. The next created axes will inherit
1053                                                 from this model (see "Example on axes model" below).
1054                                             </para>
1055                                         </listitem>
1056                                     </varlistentry>
1057                                 </variablelist>
1058                             </listitem>
1059                         </varlistentry>
1060                     </variablelist>
1061                 </listitem>
1062             </varlistentry>
1063         </variablelist>
1064     </refsection>
1065     <refsection>
1066         <title>Examples</title>
1067         <programlisting role="example"><![CDATA[
1068 lines(0) // disables vertical paging
1069 a=get("current_axes")//get the handle of the newly created axes
1070 a.axes_visible="on"; // makes the axes visible
1071 a.font_size=3; //set the tics label font size
1072 a.x_location="top"; //set the x axis position
1073 a.data_bounds=[-100,-2,-1;100,2,1]; //set the boundary values for the x, y and z coordinates.
1074 a.sub_tics=[5,0];
1075 a.labels_font_color=5;
1076 a.grid=[2,2];
1077 a.box="off";
1078
1079 // Example with 3D axes
1080 clf(); //clear the graphics window
1081 x=0.1:0.1:2*%pi;plot2d(x-.3,sin(x)*7+.2);
1082 a=gca(); // get the handle of the current axes
1083 a.grid=[1 -1 -1]; //make x-grid
1084 a.rotation_angles=[70 250]; //turn the axes with giving angles
1085 a.grid=[1 6 -1]; //make y-grid
1086 a.view="2d"; //return te the 2d view
1087 a.box="back_half";
1088 a.labels_font_color=5;
1089 a.children.children.thickness=4;
1090 a.children.children.polyline_style=3;
1091 a.view="3d"; //return te the 3d view
1092 a.children.children.thickness=1;
1093 a.children.children.foreground=2;
1094 a.grid=[1 6 3]; //make z-grid
1095 a.parent.background=4;
1096 a.background=7;
1097 plot2d(cos(x)+1,3*sin(x)-3);
1098 plot2d(cos(x)+7,3*sin(x)+3);
1099 a.children(2).children.polyline_style=2;
1100 a.children(1).children.polyline_style=4;
1101 a.children(1).children.foreground=5;
1102 a.children(2).children.foreground=14;
1103 a.parent.figure_size= [1200,800];
1104 a.box="on";
1105 a.labels_font_size=4;
1106 a.parent.background=8;
1107 a.parent.figure_size= [400,200];
1108 a.rotation_angles=[0 260];
1109 delete(a.children(2));
1110 delete(); // delete current object
1111
1112 a = gca();
1113 a.labels_font_size=1;
1114 a.auto_clear= "on";
1115 x=0:0.1:2.5*%pi;plot2d(10*cos(x),sin(x));
1116
1117 a.data_bounds(:,1) = [1;15] ; // set positive bounds for X axe
1118 a.log_flags = "lnn" ; // set X axes to logarithmic scale
1119 a.log_flags = "nnn" ; // switch back to linear scale
1120
1121 a=gca();
1122 a.rotation_angles=[45 45];
1123 a.data_bounds=[-20,-3,-2;20 3 ,2];
1124 xrect([-4 0.5 8 1]);
1125 a.auto_clear = "off" ;
1126 a.isoview="on"; // isoview mode
1127 xrect([-2 0.25 4 0.5]);
1128 a.children(1).fill_mode="on";
1129 a.axes_visible="off";
1130 a.children(1).data=[-2 0.25 -1 4 0.5];
1131 a.children(2).data=[-4 0.5 1 8 1];
1132 x=2*%pi*(0:7)/8;
1133 xv=[.2*sin(x);.9*sin(x)];yv=[.2*cos(x);.9*cos(x)];
1134 xsegs(10*xv,yv,1:8)
1135 s=a.children(1);
1136 s.arrow_size=1;
1137 s.segs_color=5;
1138 a.data_bounds //the boundary values for the x,y and z coordinates
1139 a.view="2d";
1140 a.data_bounds=[-10,-1; 10,1]; // set the boundary values for the two-dimensional views
1141
1142 // Example on axes model
1143 da=gda() // get the handle on axes model to view and edit the fields
1144 // title by default
1145 da.title.text="My Default@Title"
1146 da.title.foreground = 12;
1147 da.title.font_size = 4;
1148 // x labels default
1149 da.x_label.text="x";
1150 da.x_label.text="x"; // Latex or MathML can be used here also
1151 da.x_label.font_style = 8;
1152 da.x_label.font_size = 2;
1153 da.x_label.foreground = 5;
1154 da.x_location = "middle";
1155 // y labels default
1156 da.y_label.text="y";
1157 da.y_label.font_style = 3;
1158 da.y_label.font_size = 5;
1159 da.y_label.foreground = 3;
1160 da.y_location = "right";
1161 da.thickness = 2;
1162 da.foreground = 7;
1163 // the plot
1164 x=(0:0.1:2*%pi)';
1165 plot2d(x,[sin(x),sin(2*x),sin(3*x)],style=[1,2,3],rect=[0,-2,2*%pi,2]);
1166 sda() // back to default axes model
1167
1168
1169 // Example with LaTeX / MathML ticks:
1170 plot2d();
1171 a=gca();
1172
1173 mathml = "<mrow><mfrac><mrow><mi>d</mi>  <mi>y</mi></mrow><mrow>  <mi>d</mi>  <mi>x</mi></mrow></mfrac> <mo>=</mo>" + ...
1174     "<mfrac><mn>1</mn><msup> <mi>y</mi>  <mn>2</mn></msup> </mfrac> </mrow>";
1175 // Only LaTeX expression
1176 a.x_ticks = tlist(["ticks", "locations", "labels"], (0:6)', [mathml;"1";"$\sin(x)$";"3";"$\cos(a) - test$";"5";"6"]);
1177
1178 // Mixed expression: MathML and LaTex
1179 a.y_ticks = tlist(["ticks", "locations", "labels"], (-2:0.5:2)', ["0";"1";"2";"3";"$\cos(a)$";"5";"6";mathml;"8"]);
1180
1181  ]]>
1182         </programlisting>
1183         <para/>
1184         <programlisting role="example"><![CDATA[
1185 m = [66.425514; 66.425513];
1186 plot([69;70], m);
1187 a = gca();
1188 a.ticks_format = ["" sprintf("%.2f", m(2))+"%+.1e"];
1189 a.ticks_st = [1 1;0 m(2)];
1190 ]]></programlisting>
1191         <para>
1192             Example with vertical x_ticks labels:
1193         </para>
1194         <programlisting role="example" id="axes_properties_vertical_xticks"><![CDATA[
1195 rain_Nice  = [51  45  39 69 45 34 12 18 73 133 104 93 ];
1196 months = _(["January" "February" "March" "April" "May" "June" "July" ...
1197             "August" "September" "October" "November" "December"]);
1198 clf
1199 bar(rain_Nice,1,"cyan");
1200 title(_("Rain - Nice (France)"), "fontsize",3)
1201 ylabel("[mm]")
1202 gca().x_ticks.labels = "$\rotatebox{90}{\mathsf{"+months'+"}}$";
1203 set(gca(), "tight_limits", "on", "font_size", 2);
1204 gcf().axes_size = [460 320];
1205 ]]></programlisting>
1206     <scilab:image localized="true">
1207 rain_Nice  = [51  45  39 69 45 34 12 18 73 133 104 93 ];
1208 months = _(["January" "February" "March" "April" "May" "June" "July" ..
1209             "August" "September" "October" "November" "December"]);
1210 clf
1211 bar(rain_Nice, 1, "cyan")
1212 title(_("Rain - Nice (France)"), "fontsize",3);
1213 ylabel("[mm]");
1214 gca().x_ticks.labels = "$\rotatebox{90}{\mathsf{"+months'+"}}$";
1215 set(gca(), "tight_limits", "on", "font_size", 2);
1216 gcf().axes_size = [420 320];
1217     </scilab:image>
1218     </refsection>
1219     <refsection role="see also">
1220         <title>See also</title>
1221         <simplelist type="inline">
1222             <member>
1223                 <link linkend="axis_properties">axis_properties</link>
1224             </member>
1225             <member>
1226                 <link linkend="drawaxis">drawaxis</link>
1227             </member>
1228             <member>
1229                 <link linkend="set">set</link>
1230             </member>
1231             <member>
1232                 <link linkend="get">get</link>
1233             </member>
1234             <member>
1235                 <link linkend="gca">gca</link>
1236             </member>
1237             <member>
1238                 <link linkend="gda">gda</link>
1239             </member>
1240             <member>
1241                 <link linkend="sda">sda</link>
1242             </member>
1243             <member>
1244                 <link linkend="polyline_properties">polyline_properties</link>
1245             </member>
1246             <member>
1247                 <link linkend="graphics_entities">graphics_entities</link>
1248             </member>
1249         </simplelist>
1250     </refsection>
1251     <refsection>
1252         <title>History</title>
1253         <revhistory>
1254             <revision>
1255                 <revnumber>5.4.0</revnumber>
1256                 <revremark>.line_style value 0 is replaced with 1 (for solid line).</revremark>
1257             </revision>
1258             <revision>
1259                 <revnumber>5.5.0</revnumber>
1260                 <revremark>
1261                     <itemizedlist>
1262                         <listitem>.grid_style and .grid_thickness properties added.</listitem>
1263                         <listitem>
1264                             .line_style values 9 and 10 can be used to have respectively longblank
1265                             dot and bigblank dot styles.
1266                         </listitem>
1267                         <listitem>
1268                             .auto_margins property added to allow automatic computation of the margins.
1269                         </listitem>
1270                         <listitem>
1271                             .ticks_format and .ticks_st properties added to improve ticks labels
1272                             display.
1273                         </listitem>
1274                         <listitem>
1275                             For an axes drawn in a uicontrol frame, .axes_bounds now refers to
1276                             the frame area instead of the figure area.
1277                         </listitem>
1278                     </itemizedlist>
1279                 </revremark>
1280             </revision>
1281             <revision>
1282                 <revnumber>5.5.2</revnumber>
1283                 <revremark>.tight_limits property can now manage X, Y and Z axis separately.</revremark>
1284             </revision>
1285             <revision>
1286                 <revnumber>6.1.0</revnumber>
1287                 <revremark>Default .grid_style is now [7 7] instead of [3 3].</revremark>
1288             </revision>
1289         </revhistory>
1290     </refsection>
1291 </refentry>