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>