c0ba51d22febaca81bbd50f158be5a1b3e8cae4d
[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 - Samuel GOUGEON
6  * Copyright (C) 2012 - 2016 - Scilab Enterprises
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" xmlns:svg="http://www.w3.org/2000/svg" xmlns:mml="http://www.w3.org/1998/Math/MathML" xmlns:db="http://docbook.org/ns/docbook" xmlns:scilab="http://www.scilab.org"  xml:lang="fr" xml:id="isoview">
17     <refnamediv>
18         <refname>isoview</refname>
19         <refpurpose>Règle la vue isométrique des repères graphiques
20         </refpurpose>
21     </refnamediv>
22     <refsynopsisdiv>
23         <title>Syntaxe</title>
24         <synopsis>isoview
25             isoview on
26             isoview off
27             isoview(idGraphics [,"on"|"off"])
28             isoview(xmin, xmax, ymin, ymax)    // OBSOLETE. utiliser replot()
29         </synopsis>
30     </refsynopsisdiv>
31     <refsection role="arguments">
32         <title>Paramètres</title>
33         <variablelist>
34             <varlistentry>
35                 <term>"on" | "off" | &lt;none&gt;</term>
36                 <listitem>Active, désactive ou commute la vue isométrique pour
37                     les repères graphiques considérés.
38                 </listitem>
39             </varlistentry>
40             <varlistentry>
41                 <term>idGraphics</term>
42                 <listitem>
43                     Vecteur d'identifiants graphiques. Tous les repères
44                     graphiques afférents sont traités. Par défaut, le repère
45                     actif est traité.
46                 </listitem>
47             </varlistentry>
48             <varlistentry>
49                 <term>xmin, xmax, ymin, ymax</term>
50                 <listitem>
51                     4 nombres décimaux : nouvelles bornes du repère actif.
52                     <warning>
53                         Ces paramètres seront supprimés de <literal>isoview()</literal>
54                         dans Scilab 6.1. SVP désormais utiliser
55                         <link linkend="replot">replot</link>
56                         à la suite de <function>isoview</function>.
57                     </warning>
58                 </listitem>
59             </varlistentry>
60         </variablelist>
61     </refsection>
62     <refsection role="description">
63         <title>Description</title>
64         <para>
65             <function>isoview</function> est utilisée pour activer ou désactiver
66             l'affichage graphique en échelles isométriques sur les axes
67             x, y, voire z, sans modifier la taille de la fenêtre graphique.
68         </para>
69         <para>
70             <literal>isoview()</literal> ou simplement <literal>isoview</literal>
71             commute la vue isométrique/normale pour le repère actif, en conservant
72             ses bornes.
73         </para>
74         <para>
75             <literal>isoview("on")</literal> ou <literal>isoview on</literal>
76             active la vue isométrique pour le repère actif.
77         </para>
78         <para>
79             <literal>isoview("off")</literal> ou <literal>isoview off</literal>
80             relaxe les échelles en x, y (voire z) pour le repère actif.
81         </para>
82         <para>
83             <literal>isoview(idGraphics,..)</literal> agit sur tous les repères
84             graphiques impliqués dans le vecteur d'identifiants graphiques donné :
85             <itemizedlist>
86                 <listitem>
87                     Si <varname>idGraphics(i)</varname> désigne une figure,
88                     tous ses repères graphiques sont considérés.
89                 </listitem>
90                 <listitem>
91                     Si <varname>idGraphics(i)</varname> représente un repère
92                     graphique, il est modifié comme tel.
93                 </listitem>
94                 <listitem>
95                     Si <varname>idGraphics(i)</varname> désigne un
96                     sous-composant d'un repère (telle qu'une courbe polyline, un agrégat
97                     compound, etc), son repère graphique parent est considéré.
98                 </listitem>
99             </itemizedlist>
100         </para>
101         <para>
102             <literal>isoview(xmin, xmax, ymin, ymax)</literal> sets the current
103             axes in isometric mode, and then sets its bounds to the given values.
104             <warning>
105                 Cette utilisation sera supprimée à partir de Scilab 6.1. Merci d'utiliser
106                 <link linkend="replot">replot</link> après
107                 <function>isoview</function> à la place.
108             </warning>
109         </para>
110         <note>
111             Après l'appel à <literal>isoview(..)</literal>, le repère actif
112             reste le même, y compris lorsque plusieurs repères ont été traités.
113         </note>
114         <note>Il est possible de tracer directement des courbes en échelles isométriques
115             en utilisant l'option <literal>plot2d(...,frameflag=4)</literal> lors
116             de l'appel, sans devoir utiliser <function>isoview</function> après coup.
117         </note>
118     </refsection>
119     <refsection role="examples">
120         <title>Exemples</title>
121         <programlisting role="example"><![CDATA[
122 t = [0:0.1:2*%pi]';
123 clf
124 nc = 3;
125
126 subplot(2,nc,1)
127 plot2d(cos(t),sin(t))
128 xtitle("Véritable cercle")
129 a1 = gca();
130
131 subplot(2,nc,nc+1)
132 plot2d(cos(t),sin(t))
133 isoview
134
135 subplot(2,nc,2)
136 plot2d(7*cos(t),2*sin(t))
137 xtitle("Véritable ellipse")
138 a2 = gca();
139
140 subplot(2,nc,nc+2)
141 plot2d(7*cos(t),2*sin(t))
142 isoview
143
144 // Dessinons une sphère à facettes calculées avec eval3dp()
145 deff("[x,y,z] = sph(alp,tet)",[
146       "x = r*cos(alp).*cos(tet)+orig(1)*ones(tet)"; ..
147       "y = r*cos(alp).*sin(tet)+orig(2)*ones(tet)"; ..
148       "z = r*sin(alp)+orig(3)*ones(tet)"]);
149 r = 3; orig = [0 0 0];
150 [xx,yy,zz] = eval3dp(sph,linspace(-%pi/2,%pi/2,40),linspace(0,%pi*2,40));
151 subplot(2,nc,3)
152 plot3d(xx, yy, zz, alpha=60, flag=[color("green") 8 4])
153 xtitle("Véritable sphère")
154 a3 = gca();
155 subplot(2,nc,nc+3)
156 plot3d(xx, yy, zz, alpha=60, flag=[color("green") 8 4])
157 isoview
158
159 // Commutation en vue isométrique/normale pour tous les repères de la fenêtre
160 isoview(gcf())
161
162 // Passage en vue isométrique de tous les repères de la fenêtre graphique
163 isoview(gcf(), "on")
164
165 // Passage en vue normale du repère actif
166 isoview off
167
168 // Passage en vue isométrique des repères graphiques du haut
169 isoview(gcf(),"off")
170 isoview([a1 a2 a3], "on")
171  ]]></programlisting>
172         <scilab:image>
173             t = [0:0.1:2*%pi]';
174             clf
175             f = gcf();
176             f.axes_size = [850 400];
177             nc = 3;
178             subplot(2,nc,1)
179             plot2d(cos(t),sin(t))
180             xtitle("True circle")
181             a1 = gca();
182             subplot(2,nc,nc+1)
183             plot2d(cos(t),sin(t))
184             isoview
185
186             subplot(2,nc,2)
187             plot2d(7*cos(t),2*sin(t))
188             xtitle("True ellipse")
189             a2 = gca();
190             subplot(2,nc,nc+2)
191             plot2d(7*cos(t),2*sin(t))
192             isoview
193
194             // plot of a sphere using facets computed by eval3dp
195             deff("[x,y,z] = sph(alp,tet)",["x = r*cos(alp).*cos(tet)+orig(1)*ones(tet)"; ..
196             "y = r*cos(alp).*sin(tet)+orig(2)*ones(tet)"; ..
197             "z = r*sin(alp)+orig(3)*ones(tet)"]);
198             r = 3; orig = [0 0 0];
199             [xx,yy,zz] = eval3dp(sph,linspace(-%pi/2,%pi/2,40),linspace(0,%pi*2,40));
200             subplot(2,nc,3)
201             plot3d(xx, yy, zz, alpha=60, flag=[color("green") 8 4])
202             xtitle("True sphere")
203             a3 = gca();
204             subplot(2,nc,nc+3)
205             plot3d(xx, yy, zz, alpha=60, flag=[color("green") 8 4])
206             isoview
207         </scilab:image>
208         <programlisting role="example"><![CDATA[
209 // Utilisation de l'option frameflag=4  de plot2d() :
210 r = linspace(1,10,200);
211 t = r*3;
212 scf();
213 subplot(1,2,1)
214 plot2d(r.*sin(t),r.*cos(t))
215 xtitle("plot2d(..)")
216
217 subplot(1,2,2)
218 plot2d(r.*sin(t),r.*cos(t),frameflag=4)
219 xtitle("with frameflag=4")
220  ]]></programlisting>
221         <scilab:image>
222             r = linspace(1,10,200);
223             t = r*3;
224             scf();
225             subplot(1,2,1)
226             plot2d(r.*sin(t),r.*cos(t))
227             xtitle("plot2d(..)")
228
229             subplot(1,2,2)
230             plot2d(r.*sin(t),r.*cos(t),frameflag=4)
231             xtitle("with frameflag=4")
232         </scilab:image>
233     </refsection>
234     <refsection role="see also">
235         <title>Voir aussi</title>
236         <simplelist type="inline">
237             <member>
238                 <link linkend="replot">replot</link>
239             </member>
240             <member>
241                 <link linkend="axes_properties">Axes properties</link>
242             </member>
243         </simplelist>
244     </refsection>
245
246     <refsection role="history">
247         <title>Historique</title>
248         <revhistory>
249             <revision>
250                 <revnumber>6.0</revnumber>
251                 <revdescription>
252                     <itemizedlist>
253                         <listitem>Ajout des drapeaux "on", "off".</listitem>
254                         <listitem>Ajout des paramètres d'entrée &lt;none&gt; et idGraphics.</listitem>
255                     </itemizedlist>
256                 </revdescription>
257             </revision>
258         </revhistory>
259     </refsection>
260
261 </refentry>