[graphics] actual removal of isoview(xmin,ymin,xmax,ymax) syntax 02/19602/5
Samuel GOUGEON [Sun, 10 Dec 2017 18:59:48 +0000 (19:59 +0100)]
  Code already cleaned up @ https://codereview.scilab.org/#/c/18166/

Change-Id: I247f9829ce2db292d76049b4cd11aff0df14b0a5

scilab/modules/graphics/help/en_US/axes_operations/isoview.xml
scilab/modules/graphics/help/fr_FR/axes_operations/isoview.xml
scilab/modules/graphics/macros/isoview.sci

index 82a113e..a5a9867 100644 (file)
     </refnamediv>
     <refsynopsisdiv>
         <title>Syntax</title>
-        <synopsis>isoview
+        <synopsis>
+            isoview
             isoview on
             isoview off
-            isoview(idGraphics [,"on"|"off"])
-            isoview(xmin, xmax, ymin, ymax)    // DEPRECATED. use replot()
+            isoview(idGraphics)
+            isoview(idGraphics,"on"|"off")
         </synopsis>
     </refsynopsisdiv>
     <refsection role="arguments">
                     <para/>
                 </listitem>
             </varlistentry>
-            <varlistentry>
-                <term>xmin, xmax, ymin, ymax</term>
-                <listitem>
-                    Four decimal numbers: new axes bounds.
-                    <warning>These parameters will be removed from Scilab 6.1.
-                        Please use <link linkend="replot">replot</link>
-                        after <function>isoview</function> instead.
-                    </warning>
-                    <para/>
-                </listitem>
-            </varlistentry>
         </variablelist>
     </refsection>
     <refsection role="description">
                 </listitem>
             </itemizedlist>
         </para>
-        <para>
-            <literal>isoview(xmin, xmax, ymin, ymax)</literal> sets the current
-            axes in isometric mode, and then sets its bounds to the given values.
-            <warning>
-                This usage is deprecated and will be removed from Scilab 6.1 onwards. Please use
-                <link linkend="replot">replot</link> after
-                <function>isoview</function> instead.
-            </warning>
-        </para>
         <note>
             The current axes graphical entity is still the same after calling <literal>isoview(..)</literal>.
         </note>
@@ -281,7 +262,6 @@ xtitle("with frameflag=4")
             </member>
         </simplelist>
     </refsection>
-
     <refsection role="history">
         <title>History</title>
         <revhistory>
@@ -304,6 +284,12 @@ xtitle("with frameflag=4")
                     "isoview off" forces .cube_scaling="on".
                 </revdescription>
             </revision>
+            <revision>
+                <revnumber>6.1</revnumber>
+                <revdescription>
+                    The syntax <literal>isoview(xmin, xmax, ymin, ymax)</literal> is no longer available.
+                </revdescription>
+            </revision>
         </revhistory>
     </refsection>
-</refentry>
+</refentry>
\ No newline at end of file
index 3e742e7..e79a7fc 100644 (file)
     </refnamediv>
     <refsynopsisdiv>
         <title>Syntaxe</title>
-        <synopsis>isoview
+        <synopsis>
+            isoview
             isoview on
             isoview off
-            isoview(idGraphics [,"on"|"off"])
-            isoview(xmin, xmax, ymin, ymax)    // OBSOLETE. utiliser replot()
+            isoview(idGraphics)
+            isoview(idGraphics, "on"|"off")
         </synopsis>
     </refsynopsisdiv>
     <refsection role="arguments">
         <variablelist>
             <varlistentry>
                 <term>"on" | "off" | &lt;none&gt;</term>
-                <listitem>Active, désactive ou commute la vue isométrique pour
-                    les repères graphiques considérés.
-                    <para/>
+                <listitem>
+                    Active, désactive ou commute la vue isométrique pour les repères graphiques
+                    considérés.
                 </listitem>
             </varlistentry>
             <varlistentry>
                 <term>idGraphics</term>
                 <listitem>
-                    Vecteur d'identifiants graphiques. Tous les repères
-                    graphiques afférents sont traités. Par défaut, le repère
-                    actif est traité.
-                    <para/>
-               </listitem>
-            </varlistentry>
-            <varlistentry>
-                <term>xmin, xmax, ymin, ymax</term>
-                <listitem>
-                    4 nombres décimaux : nouvelles bornes du repère actif.
-                    <warning>
-                        Ces paramètres seront supprimés de <literal>isoview()</literal>
-                        dans Scilab 6.1. SVP désormais utiliser
-                        <link linkend="replot">replot</link>
-                        à la suite de <function>isoview</function>.
-                    </warning>
-                    <para/>
+                    Vecteur d'identifiants graphiques. Tous les repères graphiques afférents sont
+                    traités. Par défaut, le repère actif est traité.
                 </listitem>
             </varlistentry>
         </variablelist>
     <refsection role="description">
         <title>Description</title>
         <para>
-            <function>isoview</function> est utilisée pour activer ou désactiver
-            l'affichage graphique en échelles isométriques sur les axes
-            x, y, voire z, sans modifier la taille de la fenêtre graphique.
+            <function>isoview</function> est utilisée pour activer ou désactiver l'affichage
+            graphique en échelles isométriques sur les axes x, y, voire z, sans modifier la taille
+            de la fenêtre graphique.
         </para>
         <para>
-            <literal>isoview()</literal> ou simplement <literal>isoview</literal>
-            commute la vue isométrique/normale pour le repère actif, en conservant
-            ses bornes.
+            <literal>isoview()</literal> ou simplement <literal>isoview</literal> commute la vue
+            isométrique/normale pour le repère actif, en conservant ses bornes.
         </para>
         <para>
-            <literal>isoview("on")</literal> ou <literal>isoview on</literal>
-            active la vue isométrique pour le repère actif.
+            <literal>isoview("on")</literal> ou <literal>isoview on</literal> active la vue
+            isométrique pour le repère actif.
         </para>
         <para>
-            <literal>isoview("off")</literal> ou <literal>isoview off</literal>
-            relaxe les échelles en x, y (voire z) pour le repère actif.
+            <literal>isoview("off")</literal> ou <literal>isoview off</literal> relaxe les échelles
+            en x, y (voire z) pour le repère actif.
         </para>
         <para>
-            <literal>isoview(idGraphics,..)</literal> agit sur tous les repères
-            graphiques impliqués dans le vecteur d'identifiants graphiques donné :
+            <literal>isoview(idGraphics,..)</literal> agit sur tous les repères graphiques
+            impliqués dans le vecteur d'identifiants graphiques donné :
             <itemizedlist>
                 <listitem>
-                    Si <varname>idGraphics(i)</varname> désigne une figure,
-                    tous ses repères graphiques sont considérés.
+                    Si <varname>idGraphics(i)</varname> désigne une figure, tous ses repères
+                    graphiques sont considérés.
                 </listitem>
                 <listitem>
-                    Si <varname>idGraphics(i)</varname> représente un repère
-                    graphique, il est modifié comme tel.
+                    Si <varname>idGraphics(i)</varname> représente un repère graphique, il est
+                    modifié comme tel.
                 </listitem>
                 <listitem>
-                    Si <varname>idGraphics(i)</varname> désigne un
-                    sous-composant d'un repère (telle qu'une courbe polyline, un agrégat
-                    compound, etc), son repère graphique parent est considéré.
+                    Si <varname>idGraphics(i)</varname> désigne un sous-composant d'un repère
+                    (telle qu'une courbe polyline, un agrégat compound, etc), son repère graphique
+                    parent est considéré.
                 </listitem>
             </itemizedlist>
         </para>
-        <para>
-            <literal>isoview(xmin, xmax, ymin, ymax)</literal> sets the current
-            axes in isometric mode, and then sets its bounds to the given values.
-            <warning>
-                Cette utilisation sera supprimée à partir de Scilab 6.1. Merci d'utiliser
-                <link linkend="replot">replot</link> après
-                <function>isoview</function> à la place.
-            </warning>
-        </para>
         <note>
-            Après l'appel à <literal>isoview(..)</literal>, le repère actif
-            reste le même, y compris lorsque plusieurs repères ont été traités.
+            Après l'appel à <literal>isoview(..)</literal>, le repère actif reste le même, y compris
+            lorsque plusieurs repères ont été traités.
         </note>
-        <note>Il est possible de tracer directement des courbes en échelles isométriques
-            en utilisant l'option <literal>plot2d(...,frameflag=4)</literal> lors
-            de l'appel, sans devoir utiliser <function>isoview</function> après coup.
+        <note>
+            Il est possible de tracer directement des courbes en échelles isométriques en utilisant
+            l'option <literal>plot2d(...,frameflag=4)</literal> lors de l'appel, sans devoir
+            utiliser <function>isoview</function> après coup.
         </note>
         <refsect3>
             <title>Affichage selon .isoview et .cube_scaling</title>
@@ -309,6 +286,12 @@ xtitle("with frameflag=4")
                     "isoview off" fixe .cube_scaling="on".
                 </revdescription>
             </revision>
+            <revision>
+                <revnumber>6.1</revnumber>
+                <revdescription>
+                    La syntaxe <literal>isoview(xmin, xmax, ymin, ymax)</literal> n'est plus acceptée.
+                </revdescription>
+            </revision>
         </revhistory>
     </refsection>
 
index a0d0ef7..32d8fd7 100644 (file)
@@ -1,7 +1,7 @@
 // Scilab ( http://www.scilab.org/ ) - This file is part of Scilab
 // Copyright (C) INRIA
 // Copyright (C) 2010 - DIGITEO - Pierre Lando <pierre.lando@scilab.org>
-// Copyright (C) 2016 - Samuel GOUGEON
+// Copyright (C) 2016, 2017 - Samuel GOUGEON
 //
 // Copyright (C) 2012 - 2016 - Scilab Enterprises
 //
 // along with this program.
 
 function isoview(varargin)
-    //isoview
-    //isoview on
-    //isoview off
-    //isoview(idGraphics [,"on"|"off"])
-    //isoview(xmin, xmax, ymin, ymax)  // OBSOLETE
+    // isoview
+    // isoview on
+    // isoview off
+    // isoview(idGraphics [,"on"|"off"])
 
     rhs = argn(2)
-    if rhs==3 | rhs>4 then
-        msg = _("%s: Wrong number of input argument(s): 0, 1, 2, or 4 arguments expected.\n")
+    if rhs>2 then
+        msg = _("%s: Wrong number of input argument(s): 0, 1, or 2 arguments expected.\n")
         error(msprintf(msg, "isoview"));
     end
 
     // isoview action to be performed: ""=switch, "on", "off"
     action = ""
-    if rhs>0 & rhs<4 & typeof(varargin($))=="string" then
+    if rhs>0 & typeof(varargin($))=="string" then
         tmp = convstr(varargin($))
         if tmp(1)=="on"
             action = "on"
@@ -38,9 +37,9 @@ function isoview(varargin)
 
     // Set of axes to be processed
     // ---------------------------
-    if rhs==0 | rhs==4 | (rhs==1 & type(varargin(1))==10)
+    if rhs==0 | (rhs==1 & type(varargin(1))==10)
         a = gca()
-    elseif rhs<3 // varargin(1) must be a graphics handle
+    else // varargin(1) must be a graphics handle
         a = varargin(1)
         if type(a)~=9 then
             msg = _("%s: Wrong type for input argument #%d: Graphic handle or string expected.\n")
@@ -69,20 +68,6 @@ function isoview(varargin)
         end
     end
 
-    // isoview(xmin, xmax, ymin, ymax): checking input bounds
-    // ------------------------------------------------------
-    if rhs>2
-        msg = _("isoview: The syntax isoview(xmin, xmax, ymin, ymax) will be removed from Scilab 6.1\nPlease use replot([xmin xmax ymin ymax]) after isoview(..) instead.\n")
-        warning(msprintf(msg))
-        for i = 1:4
-            if type(varargin(i)) <> 1 then
-                msg = _("%s: Wrong type for input argument #%d: A real expected.\n")
-                error(msprintf(msg, "isoview", i))
-            end
-        end;
-        [xmin xmax ymin ymax] = varargin(1:4)
-    end
-
     // Performing actions
     // ------------------
     for i = 1:size(a,"*")
@@ -95,9 +80,6 @@ function isoview(varargin)
             a(i).isoview = "off"
         end
         a(i).clip_state = "clipgrf"
-        if rhs>2 then
-            a(i).data_bounds = [xmin xmax ymin ymax]
-        end
     end
 endfunction