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