help: fix minor typos and warnings on Scilab code colorization
[scilab.git] / scilab / modules / graphics / help / fr_FR / axes_operations / isoview.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 - Serge Steer
5  * Copyright (C) 2016, 2018 - Samuel GOUGEON
6  *
7  * Copyright (C) 2012 - 2016 - Scilab Enterprises
8  *
9  * This file is hereby licensed under the terms of the GNU GPL v2.0,
10  * pursuant to article 5.3.4 of the CeCILL v.2.1.
11  * This file was originally licensed under the terms of the CeCILL v2.1,
12  * and continues to be available under such terms.
13  * For more information, see the COPYING file which you should have received
14  * along with this program.
15  *
16  -->
17 <refentry xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink"
18           xmlns:svg="http://www.w3.org/2000/svg" xmlns:mml="http://www.w3.org/1998/Math/MathML"
19           xmlns:db="http://docbook.org/ns/docbook" xmlns:scilab="http://www.scilab.org"
20           xml:lang="fr" xml:id="isoview">
21     <refnamediv>
22         <refname>isoview</refname>
23         <refpurpose>Règle la vue isométrique des repères graphiques
24         </refpurpose>
25     </refnamediv>
26     <refsynopsisdiv>
27         <title>Syntaxe</title>
28         <synopsis>isoview
29             isoview on
30             isoview off
31             isoview(idGraphics [,"on"|"off"])
32             isoview(xmin, xmax, ymin, ymax)    // OBSOLETE. utiliser replot()
33         </synopsis>
34     </refsynopsisdiv>
35     <refsection role="arguments">
36         <title>Paramètres</title>
37         <variablelist>
38             <varlistentry>
39                 <term>"on" | "off" | &lt;none&gt;</term>
40                 <listitem>Active, désactive ou commute la vue isométrique pour
41                     les repères graphiques considérés.
42                     <para/>
43                 </listitem>
44             </varlistentry>
45             <varlistentry>
46                 <term>idGraphics</term>
47                 <listitem>
48                     Vecteur d'identifiants graphiques. Tous les repères
49                     graphiques afférents sont traités. Par défaut, le repère
50                     actif est traité.
51                     <para/>
52                </listitem>
53             </varlistentry>
54             <varlistentry>
55                 <term>xmin, xmax, ymin, ymax</term>
56                 <listitem>
57                     4 nombres décimaux : nouvelles bornes du repère actif.
58                     <warning>
59                         Ces paramètres seront supprimés de <literal>isoview()</literal>
60                         dans Scilab 6.1. SVP désormais utiliser
61                         <link linkend="replot">replot</link>
62                         à la suite de <function>isoview</function>.
63                     </warning>
64                     <para/>
65                 </listitem>
66             </varlistentry>
67         </variablelist>
68     </refsection>
69     <refsection role="description">
70         <title>Description</title>
71         <para>
72             <function>isoview</function> est utilisée pour activer ou désactiver
73             l'affichage graphique en échelles isométriques sur les axes
74             x, y, voire z, sans modifier la taille de la fenêtre graphique.
75         </para>
76         <para>
77             <literal>isoview()</literal> ou simplement <literal>isoview</literal>
78             commute la vue isométrique/normale pour le repère actif, en conservant
79             ses bornes.
80         </para>
81         <para>
82             <literal>isoview("on")</literal> ou <literal>isoview on</literal>
83             active la vue isométrique pour le repère actif.
84         </para>
85         <para>
86             <literal>isoview("off")</literal> ou <literal>isoview off</literal>
87             relaxe les échelles en x, y (voire z) pour le repère actif.
88         </para>
89         <para>
90             <literal>isoview(idGraphics,..)</literal> agit sur tous les repères
91             graphiques impliqués dans le vecteur d'identifiants graphiques donné :
92             <itemizedlist>
93                 <listitem>
94                     Si <varname>idGraphics(i)</varname> désigne une figure,
95                     tous ses repères graphiques sont considérés.
96                 </listitem>
97                 <listitem>
98                     Si <varname>idGraphics(i)</varname> représente un repère
99                     graphique, il est modifié comme tel.
100                 </listitem>
101                 <listitem>
102                     Si <varname>idGraphics(i)</varname> désigne un
103                     sous-composant d'un repère (telle qu'une courbe polyline, un agrégat
104                     compound, etc), son repère graphique parent est considéré.
105                 </listitem>
106             </itemizedlist>
107         </para>
108         <para>
109             <literal>isoview(xmin, xmax, ymin, ymax)</literal> sets the current
110             axes in isometric mode, and then sets its bounds to the given values.
111             <warning>
112                 Cette utilisation sera supprimée à partir de Scilab 6.1. Merci d'utiliser
113                 <link linkend="replot">replot</link> après
114                 <function>isoview</function> à la place.
115             </warning>
116         </para>
117         <note>
118             Après l'appel à <literal>isoview(..)</literal>, le repère actif
119             reste le même, y compris lorsque plusieurs repères ont été traités.
120         </note>
121         <note>Il est possible de tracer directement des courbes en échelles isométriques
122             en utilisant l'option <literal>plot2d(...,frameflag=4)</literal> lors
123             de l'appel, sans devoir utiliser <function>isoview</function> après coup.
124         </note>
125         <refsect3>
126             <title>Affichage selon .isoview et .cube_scaling</title>
127             <para>
128             <table align="middle">
129                 <tr>
130                     <th>isoview(..)</th><th>gca().isoview</th>
131                                        <th>gca().cube_scaling</th>
132                                        <td><emphasis role="bold">Rendu graphique</emphasis></td>
133                 </tr>
134                 <tr>
135                     <th>on</th><td align="center">on</td>
136                                <td align="center">off</td>
137                                <td>X, Y sont Z are isométriques</td>
138                 </tr>
139                 <tr>
140                     <th>off</th><td align="center">off</td>
141                                 <td align="center">on</td>
142                                 <td>Echelles en X, Y and Z indépendantes. En 3D, facteur de forme
143                                     amélioré lorsque les étendues en X/Y/Z sont très différentes.</td>
144                 </tr>
145                 <tr>
146                     <th></th><td align="center">off</td>
147                             <td align="center">off</td>
148                             <td>Echelles en X, Y, Z indépendantes. En 3D, les facteurs d'échelles
149                                 X/Y/Z rendus en perspective sont similaires à ceux des données.</td>
150                 </tr>
151                 <tr>
152                     <th></th><td align="center">on</td>
153                              <td align="center">on</td>
154                              <td>Les échelles graphiques sont fixées de sorte que le repère
155                                  graphique apparaisse carré ou cubique.
156                              </td>
157                 </tr>
158             </table>
159             </para>
160         </refsect3>
161     </refsection>
162     <refsection role="examples">
163         <title>Exemples</title>
164         <programlisting role="example"><![CDATA[
165 t = [0:0.1:2*%pi]';
166 clf
167 nc = 3;
168
169 subplot(2,nc,1)
170 plot2d(cos(t),sin(t))
171 xtitle("Véritable cercle")
172 a1 = gca();
173
174 subplot(2,nc,nc+1)
175 plot2d(cos(t),sin(t))
176 isoview
177
178 subplot(2,nc,2)
179 plot2d(7*cos(t),2*sin(t))
180 xtitle("Véritable ellipse")
181 a2 = gca();
182
183 subplot(2,nc,nc+2)
184 plot2d(7*cos(t),2*sin(t))
185 isoview
186
187 // Dessinons une sphère à facettes calculées avec eval3dp()
188 deff("[x,y,z] = sph(alp,tet)",[
189       "x = r*cos(alp).*cos(tet)+orig(1)*ones(tet)"; ..
190       "y = r*cos(alp).*sin(tet)+orig(2)*ones(tet)"; ..
191       "z = r*sin(alp)+orig(3)*ones(tet)"]);
192 r = 3; orig = [0 0 0];
193 [xx,yy,zz] = eval3dp(sph,linspace(-%pi/2,%pi/2,40),linspace(0,%pi*2,40));
194 subplot(2,nc,3)
195 plot3d(xx, yy, zz, alpha=60, flag=[color("green") 8 4])
196 zlabel("isoview off", "rotation", -90, "fontsize",4)
197 xtitle("Véritable sphère")
198 a3 = gca();
199 subplot(2,nc,nc+3)
200 plot3d(xx, yy, zz, alpha=60, flag=[color("green") 8 4])
201 zlabel("isoview on", "rotation", -90, "fontsize",4)
202 isoview
203
204 // Commutation en vue isométrique/normale pour tous les repères de la fenêtre
205 isoview(gcf())
206
207 // Passage en vue isométrique de tous les repères de la fenêtre graphique
208 isoview(gcf(), "on")
209
210 // Passage en vue normale du repère actif
211 isoview off
212
213 // Passage en vue isométrique des repères graphiques du haut
214 isoview(gcf(),"off")
215 isoview([a1 a2 a3], "on")
216  ]]></programlisting>
217         <scilab:image>
218             t = [0:0.1:2*%pi]';
219             clf
220             f = gcf();
221             f.axes_size = [850 400];
222             nc = 3;
223             subplot(2,nc,1)
224             plot2d(cos(t),sin(t))
225             xtitle("True circle")
226             a1 = gca();
227             subplot(2,nc,nc+1)
228             plot2d(cos(t),sin(t))
229             isoview
230
231             subplot(2,nc,2)
232             plot2d(7*cos(t),2*sin(t))
233             xtitle("True ellipse")
234             a2 = gca();
235             subplot(2,nc,nc+2)
236             plot2d(7*cos(t),2*sin(t))
237             isoview
238
239             // plot of a sphere using facets computed by eval3dp
240             deff("[x,y,z] = sph(alp,tet)",["x = r*cos(alp).*cos(tet)+orig(1)*ones(tet)"; ..
241             "y = r*cos(alp).*sin(tet)+orig(2)*ones(tet)"; ..
242             "z = r*sin(alp)+orig(3)*ones(tet)"]);
243             r = 3; orig = [0 0 0];
244             [xx,yy,zz] = eval3dp(sph,linspace(-%pi/2,%pi/2,40),linspace(0,%pi*2,40));
245             subplot(2,nc,3)
246             plot3d(xx, yy, zz, alpha=60, flag=[color("green") 8 4])
247             zlabel("isoview off", "rotation", -90, "fontsize",4)
248             xtitle("True sphere")
249             a3 = gca();
250             subplot(2,nc,nc+3)
251             plot3d(xx, yy, zz, alpha=60, flag=[color("green") 8 4])
252             zlabel("isoview on", "rotation", -90, "fontsize",4)
253             isoview
254         </scilab:image>
255         <programlisting role="example"><![CDATA[
256 // Utilisation de l'option frameflag=4  de plot2d() :
257 r = linspace(1,10,200);
258 t = r*3;
259 scf();
260 subplot(1,2,1)
261 plot2d(r.*sin(t),r.*cos(t))
262 xtitle("plot2d(..)")
263
264 subplot(1,2,2)
265 plot2d(r.*sin(t),r.*cos(t),frameflag=4)
266 xtitle("with frameflag=4")
267  ]]></programlisting>
268         <scilab:image localized="true">
269             r = linspace(1,10,200);
270             t = r*3;
271             scf();
272             subplot(1,2,1)
273             plot2d(r.*sin(t),r.*cos(t))
274             xtitle("plot2d(..)")
275
276             subplot(1,2,2)
277             plot2d(r.*sin(t),r.*cos(t),frameflag=4)
278             xtitle("avec frameflag=4")
279         </scilab:image>
280     </refsection>
281     <refsection role="see also">
282         <title>Voir aussi</title>
283         <simplelist type="inline">
284             <member>
285                 <link linkend="replot">replot</link>
286             </member>
287             <member>
288                 <link linkend="axes_properties">Axes properties</link>
289             </member>
290         </simplelist>
291     </refsection>
292
293     <refsection role="history">
294         <title>Historique</title>
295         <revhistory>
296             <revision>
297                 <revnumber>6.0</revnumber>
298                 <revdescription>
299                     <itemizedlist>
300                         <listitem>Ajout des drapeaux "on", "off".</listitem>
301                         <listitem>Ajout des paramètres d'entrée &lt;none&gt; et idGraphics.</listitem>
302                     </itemizedlist>
303                 </revdescription>
304             </revision>
305             <revision>
306                 <revnumber>6.0.2</revnumber>
307                 <revdescription>
308                     "isoview on" désormais fixe .cube_scaling="off", et
309                     "isoview off" fixe .cube_scaling="on".
310                 </revdescription>
311             </revision>
312         </revhistory>
313     </refsection>
314
315 </refentry>