* Bug #13974 fixed - isoview(xmin, xmax, ymin, ymax) was unhandy.
[scilab.git] / scilab / modules / graphics / help / pt_BR / 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:ns4="http://www.w3.org/1999/xhtml" xmlns:mml="http://www.w3.org/1998/Math/MathML" xmlns:db="http://docbook.org/ns/docbook" xmlns:scilab="http://www.scilab.org" xml:id="isoview" xml:lang="pt">
17     <refnamediv>
18         <refname>isoview</refname>
19         <refpurpose>ajusta escalas para esboço isométrico (não muda o tamanho da janela)
20         </refpurpose>
21     </refnamediv>
22     <refsynopsisdiv>
23         <title>Seqüência de Chamamento</title>
24         <synopsis>isoview
25             isoview on
26             isoview off
27             isoview(idGraphics [,"on"|"off"])
28             isoview(xmin, xmax, ymin, ymax)    // DEPRECATED. use replot()
29         </synopsis>
30     </refsynopsisdiv>
31     <refsection role="arguments">
32         <title>Parâmetros</title>
33         <variablelist>
34             <varlistentry>
35                 <term>"on" | "off" | &lt;none&gt;</term>
36                 <listitem>Enables, disables, or switches the isometric rendering
37                     for all considered axes.
38                 </listitem>
39             </varlistentry>
40             <varlistentry>
41                 <term>idGraphics</term>
42                 <listitem>
43                     Vector of graphic handles. All the related axes are processed.
44                     By default, the current axes is processed.
45                 </listitem>
46             </varlistentry>
47             <varlistentry>
48                 <term>xmin, xmax, ymin, ymax</term>
49                 <listitem>
50                     Quatro valores reais: new axes bounds.
51                     <warning>These parameters will be removed from Scilab 6.1.
52                         Please used <link linkend="replot">replot</link>
53                         after <function>isoview</function> instead.
54                     </warning>
55                 </listitem>
56             </varlistentry>
57         </variablelist>
58     </refsection>
59     <refsection role="description">
60         <title>Descrição</title>
61         <para>
62             <function>isoview</function> is used to set or relax isometric rendering scales
63             on the x, y (and z) axes, without changing the size of the graphic window.
64         </para>
65         <para>
66             <literal>isoview()</literal> or simply <literal>isoview</literal>
67             switches the isoview status of the current axes, and keeps its current
68             bounds: isometric scales are set whenever
69             they were free, or scales are relaxed whenever they were isometric.
70         </para>
71         <para>
72             <literal>isoview("on")</literal> or <literal>isoview on</literal>
73             sets isometric scales for the current axes.
74         </para>
75         <para>
76             <literal>isoview("off")</literal> or <literal>isoview off</literal>
77             relaxes x, y (and z)  scales for the current axes.
78         </para>
79         <para>
80             <literal>isoview(idGraphics,..)</literal> runs on axes related
81             to each graphic object listed in the vector <varname>idGraphics</varname>:
82             <itemizedlist>
83                 <listitem>
84                     If <varname>idGraphics(i)</varname> is a figure's handle,
85                     all its Axes are considered.
86                 </listitem>
87                 <listitem>
88                     If <varname>idGraphics(i)</varname> is an Axes,
89                     it is considered as is.
90                 </listitem>
91                 <listitem>
92                     If <varname>idGraphics(i)</varname> is the handle of a
93                     sub-axes component(such as a polyline, a compound, etc),
94                     its hosting axes is considered.
95                 </listitem>
96             </itemizedlist>
97         </para>
98         <para>
99             <literal>isoview(xmin, xmax, ymin, ymax)</literal> sets the current
100             axes in isometric mode, and then sets its bounds to the given values.
101             <warning>
102                 This usage
103                 will be removed from Scilab 6.1. Please used
104                 <link linkend="replot">replot</link> after
105                 <function>isoview</function> instead.
106             </warning>
107         </para>
108         <note>The current axes is still the same after calling
109             <literal>isoview(..)</literal>, even when several axes have been processed.
110         </note>
111         <note>To plot some curves directly in isometric mode without calling
112             <function>isoview</function> afterwards, the <literal>plot2d(...,frameflag=4)</literal>
113             option may be used at call time.
114         </note>
115     </refsection>
116     <refsection role="examples">
117         <title>Exemplos</title>
118         <programlisting role="example"><![CDATA[
119 t = [0:0.1:2*%pi]';
120 clf
121 nc = 3;
122
123 subplot(2,nc,1)
124 plot2d(cos(t),sin(t))
125 xtitle("True circle")
126 a1 = gca();
127
128 subplot(2,nc,nc+1)
129 plot2d(cos(t),sin(t))
130 isoview
131
132 subplot(2,nc,2)
133 plot2d(7*cos(t),2*sin(t))
134 xtitle("True ellipse")
135 a2 = gca();
136
137 subplot(2,nc,nc+2)
138 plot2d(7*cos(t),2*sin(t))
139 isoview
140
141 // plot of a sphere using facets computed by eval3dp
142 deff("[x,y,z] = sph(alp,tet)",[
143       "x = r*cos(alp).*cos(tet)+orig(1)*ones(tet)"; ..
144       "y = r*cos(alp).*sin(tet)+orig(2)*ones(tet)"; ..
145       "z = r*sin(alp)+orig(3)*ones(tet)"]);
146 r = 3; orig = [0 0 0];
147 [xx,yy,zz] = eval3dp(sph,linspace(-%pi/2,%pi/2,40),linspace(0,%pi*2,40));
148 subplot(2,nc,3)
149 plot3d(xx, yy, zz, alpha=60, flag=[color("green") 8 4])
150 xtitle("True sphere")
151 a3 = gca();
152 subplot(2,nc,nc+3)
153 plot3d(xx, yy, zz, alpha=60, flag=[color("green") 8 4])
154 isoview
155
156 // Switching isoview status for all axes of the current figure
157 isoview(gcf())
158
159 // Forcing isoview for all its axes
160 isoview(gcf(), "on")
161
162 // Relaxing isoview for the current axes
163 isoview off
164
165 // Setting isoview for top axes
166 isoview(gcf(),"off")
167 isoview([a1 a2 a3], "on")
168  ]]></programlisting>
169         <scilab:image>
170             t = [0:0.1:2*%pi]';
171             clf
172             f = gcf();
173             f.axes_size = [850 400];
174             nc = 3;
175             subplot(2,nc,1)
176             plot2d(cos(t),sin(t))
177             xtitle("True circle")
178             a1 = gca();
179             subplot(2,nc,nc+1)
180             plot2d(cos(t),sin(t))
181             isoview
182             
183             subplot(2,nc,2)
184             plot2d(7*cos(t),2*sin(t))
185             xtitle("True ellipse")
186             a2 = gca();
187             subplot(2,nc,nc+2)
188             plot2d(7*cos(t),2*sin(t))
189             isoview
190             
191             // plot of a sphere using facets computed by eval3dp
192             deff("[x,y,z] = sph(alp,tet)",["x = r*cos(alp).*cos(tet)+orig(1)*ones(tet)"; ..
193             "y = r*cos(alp).*sin(tet)+orig(2)*ones(tet)"; ..
194             "z = r*sin(alp)+orig(3)*ones(tet)"]);
195             r = 3; orig = [0 0 0];
196             [xx,yy,zz] = eval3dp(sph,linspace(-%pi/2,%pi/2,40),linspace(0,%pi*2,40));
197             subplot(2,nc,3)
198             plot3d(xx, yy, zz, alpha=60, flag=[color("green") 8 4])
199             xtitle("True sphere")
200             a3 = gca();
201             subplot(2,nc,nc+3)
202             plot3d(xx, yy, zz, alpha=60, flag=[color("green") 8 4])
203             isoview
204         </scilab:image>
205         
206         <programlisting role="example"><![CDATA[
207 // Using plot2d(..., frameflag=4) :
208 r = linspace(1,10,200);
209 t = r*3;
210 scf();
211 subplot(1,2,1)
212 plot2d(r.*sin(t),r.*cos(t))
213 xtitle("plot2d(..)")
214
215 subplot(1,2,2)
216 plot2d(r.*sin(t),r.*cos(t),frameflag=4)
217 xtitle("with frameflag=4")
218  ]]></programlisting>
219         <scilab:image>
220             r = linspace(1,10,200);
221             t = r*3;
222             scf();
223             subplot(1,2,1)
224             plot2d(r.*sin(t),r.*cos(t))
225             xtitle("plot2d(..)")
226             
227             subplot(1,2,2)
228             plot2d(r.*sin(t),r.*cos(t),frameflag=4)
229             xtitle("with frameflag=4")
230         </scilab:image>
231     </refsection>
232     <refsection role="see also">
233         <title>Ver Também</title>
234         <simplelist type="inline">
235             <member>
236                 <link linkend="square">square</link>
237             </member>
238             <member>
239                 <link linkend="replot">replot</link>
240             </member>
241             <member>
242                 <link linkend="axes_properties">Axes properties</link>
243             </member>
244         </simplelist>
245     </refsection>
246     
247     <refsection role="history">
248         <title>Histórico</title>
249         <revhistory>
250             <revision>
251                 <revnumber>6.0</revnumber>
252                 <revdescription>
253                     <itemizedlist>
254                         <listitem>input flags "on"|"off" added.</listitem>
255                         <listitem>input parameters &lt;none&gt; or idGraphics added.</listitem>
256                     </itemizedlist>
257                 </revdescription>
258             </revision>
259         </revhistory>
260     </refsection>
261 </refentry>