* Bug 10723 fixed [doc]: subplot() page improved
[scilab.git] / scilab / modules / graphics / help / fr_FR / axes_operations / subplot.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
5  * Copyright (C) 2012 - 2016 - Scilab Enterprises
6  * Copyright (C) 2019 - Samuel GOUGEON
7  *
8  * This file is hereby licensed under the terms of the GNU GPL v2.0,
9  * pursuant to article 5.3.4 of the CeCILL v.2.1.
10  * This file was originally licensed under the terms of the CeCILL v2.1,
11  * and continues to be available under such terms.
12  * For more information, see the COPYING file which you should have received
13  * along with this program.
14  *
15  -->
16 <refentry xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink"
17           xmlns:svg="http://www.w3.org/2000/svg" xmlns:mml="http://www.w3.org/1998/Math/MathML"
18           xmlns:db="http://docbook.org/ns/docbook" xmlns:scilab="http://www.scilab.org"
19           xml:lang="fr" xml:id="subplot">
20     <refnamediv>
21         <refname>subplot</refname>
22         <refpurpose>
23             fixe le repère graphique actif dans une case choisie de la figure courante quadrillée
24         </refpurpose>
25     </refnamediv>
26     <refsynopsisdiv>
27         <title>Séquence d'appel</title>
28         <synopsis>
29             subplot(m,n,p)
30             subplot(mnp)
31         </synopsis>
32     </refsynopsisdiv>
33     <refsection>
34         <title>Paramètres</title>
35         <variablelist>
36             <varlistentry>
37                 <term>m, n, p  </term>
38                 <listitem>
39                     <para>entiers positifs
40                     </para>
41                 </listitem>
42             </varlistentry>
43             <varlistentry>
44                 <term>mnp  </term>
45                 <listitem>
46                     <para>
47                         un entier avec <literal>mnp</literal> comme notation décimale
48                     </para>
49                 </listitem>
50             </varlistentry>
51         </variablelist>
52     </refsection>
53     <refsection>
54         <title>Description</title>
55         <para>
56             subplot(m,n,p) ou subplot(mnp) divise la fenêtre graphique courante
57             en une matrice m x n de sous fenêtres, et sélectionne la p-ième sous-fenêtre
58             comme zone de dessin active.  Le numéro de la sous-fenêtre
59             est compté ligne par ligne, c'est à dire que l'emplacement
60             (i,j) de la matrice porte le numéro (i-1)*n + j.
61         </para>
62         <para>
63             Dans la grille virtuelle de sous-fenêtres, les zones sont numérotées de la gauche vers
64             la droite, et de haut en bas. Ainsi, la dernière zone à droite sur la 1ère ligne a
65             le n° p = n. La zone située sur la ligne n°i colonne n°j est la n°
66             <literal>p=(i-1)*n+j</literal>.
67         </para>
68         <para>
69             Lorsque la zone sélectionnée correspond exactement à celle d'un repère graphique existant,
70             <literal>subplot(…)</literal> fixe celui-ci comme repère actif.
71         </para>
72         <para>
73             Sinon, <literal>subplot(…)</literal> crée un repère graphique vide couvrant la zone
74             sélectionnée, prêt à recevoir les graphiques à venir.
75         </para>
76     </refsection>
77     <refsection>
78         <title>Exemples</title>
79         <programlisting role="example"><![CDATA[
80             clf
81             subplot(221)
82             plot2d()
83
84             subplot(222)
85             plot3d()
86
87             subplot(2,2,3)
88             param3d()
89
90             subplot(2,2,4)
91             hist3d()
92  ]]></programlisting>
93         <scilab:image>
94             subplot(221)
95             plot2d()
96             subplot(222)
97             plot3d()
98             subplot(2,2,3)
99             param3d()
100             subplot(2,2,4)
101             hist3d()
102         </scilab:image>
103         <para/>
104         <para>
105             <emphasis role="bold">Placements plus complexes</emphasis>, mais toujours quadrillables :
106         </para>
107         <programlisting role="example"><![CDATA[
108             clf
109             subplot(1,2,2)
110             Matplot1()
111             xtitle("Matplot1() example","","")
112
113             subplot(2,2,1)
114             histplot
115             delete(findobj("type","Legend"))
116
117             subplot(2,2,3)
118             title("Smaller plots:", "fontsize",3)
119
120             subplot(2,4,5)
121             polarplot()
122
123             subplot(2,4,6)
124             param3d()
125             xtitle("","","","")
126  ]]></programlisting>
127         <scilab:image>
128             clf
129             subplot(1,2,2)
130             Matplot1()
131             xtitle("Matplot1() example","","")
132
133             subplot(2,2,1)
134             histplot
135             delete(findobj("type","Legend"))
136
137             subplot(2,2,3)
138             title("Smaller plots:", "fontsize",3)
139
140             subplot(2,4,5)
141             polarplot()
142
143             subplot(2,4,6)
144             param3d()
145             xtitle("","","","")
146             gcf().axes_size = [670 400];
147         </scilab:image>
148     </refsection>
149     <refsection role="see also">
150         <title>Voir aussi</title>
151         <simplelist type="inline">
152             <member>
153                 <link linkend="xsetech">xsetech</link>
154             </member>
155             <member>
156                 <link linkend="newaxes">newaxes</link>
157             </member>
158             <member>
159                 <link linkend="axes_properties">axes_properties</link>
160             </member>
161             <member>
162                 <link linkend="plotframe">plotframe</link>
163             </member>
164         </simplelist>
165     </refsection>
166 </refentry>