7602c4b328d43e1bcc0a0819dc08ddd8fe988616
[scilab.git] / scilab / modules / graphics / help / ja_JP / 3d_plot / plot3d2.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
5  * 
6  * This file must be used under the terms of the CeCILL.
7  * This source file is licensed as described in the file COPYING, which
8  * you should have received as part of this distribution.  The terms
9  * are also available at    
10  * http://www.cecill.info/licences/Licence_CeCILL_V2-en.txt
11  *
12  -->
13 <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" version="5.0-subset Scilab" xml:lang="ja" xml:id="plot3d2">
14     <refnamediv>
15         <refname>plot3d2</refname>
16         <refpurpose>矩形の小平面により定義された曲面をプロット</refpurpose>
17     </refnamediv>
18     <refsynopsisdiv>
19         <title>呼び出し手順</title>
20         <synopsis>plot3d2(X,Y,Z [,vect,theta,alpha,leg,flag,ebox])
21             plot3d2(X,Y,Z, &lt;opt_args&gt;)
22         </synopsis>
23     </refsynopsisdiv>
24     <refsection>
25         <title>パラメータ</title>
26         <variablelist>
27             <varlistentry>
28                 <term>X, Y, Z:</term>
29                 <listitem>
30                     <para>データ構造を定義する実数行列.</para>
31                 </listitem>
32             </varlistentry>
33             <varlistentry>
34                 <term>vect</term>
35                 <listitem>
36                     <para>実数ベクトル.</para>
37                 </listitem>
38             </varlistentry>
39             <varlistentry>
40                 <term>&lt;opt_args&gt;</term>
41                 <listitem>
42                     <para>
43                         一連の命令<literal>key1=value1,
44                             key2=value2
45                         </literal>
46                         ,...を表し, <literal>key1</literal>,
47                         <literal>key2,...</literal> は以下のどれかとすることができます: theta,
48                         alpha ,leg,flag,ebox (以下の定義を参照).
49                     </para>
50                 </listitem>
51             </varlistentry>
52             <varlistentry>
53                 <term>theta, alpha</term>
54                 <listitem>
55                     <para>観測点の球座標を指定する実数値(単位:度).</para>
56                 </listitem>
57             </varlistentry>
58             <varlistentry>
59                 <term>leg</term>
60                 <listitem>
61                     <para>各軸のラベルを定義する文字列. @ をフィールドセパレータとし,
62                         "X@Y@Z"のようになります.
63                     </para>
64                 </listitem>
65             </varlistentry>
66             <varlistentry>
67                 <term>flag</term>
68                 <listitem>
69                     <para>大きさ3の実数ベクトル.
70                         <literal>flag=[mode,type,box]</literal>.
71                     </para>
72                     <variablelist>
73                         <varlistentry>
74                             <term>mode</term>
75                             <listitem>
76                                 <para>整数 (曲面の色).</para>
77                                 <variablelist>
78                                     <varlistentry>
79                                         <term>mode&gt;0</term>
80                                         <listitem>
81                                             <para>
82                                                 曲面は色<literal>"mode"</literal>で塗られます ;
83                                                 小平面の境界はカレントの線種と色で描画されます.
84                                             </para>
85                                         </listitem>
86                                     </varlistentry>
87                                     <varlistentry>
88                                         <term>mode=0:</term>
89                                         <listitem>
90                                             <para>曲面のメッシュが描画されます.</para>
91                                         </listitem>
92                                     </varlistentry>
93                                     <varlistentry>
94                                         <term>mode&lt;0:</term>
95                                         <listitem>
96                                             <para>
97                                                 曲面は色<literal>"-mode"</literal>で塗られます ;
98                                                 小平面の境界は描画されません.
99                                             </para>
100                                             <para>曲面の色の取り扱いは,
101                                                 surfaceエンティティプロパティによる
102                                                 <literal>color_mode</literal>および
103                                                 <literal>color_flag</literal>オプションを用いて
104                                                 行われることに注意してください (<link linkend="surface_properties">surface_properties</link>参照).
105                                             </para>
106                                         </listitem>
107                                     </varlistentry>
108                                 </variablelist>
109                             </listitem>
110                         </varlistentry>
111                         <varlistentry>
112                             <term>type</term>
113                             <listitem>
114                                 <para>整数 (スケール).</para>
115                                 <variablelist>
116                                     <varlistentry>
117                                         <term>type=0:</term>
118                                         <listitem>
119                                             <para>プロットは
120                                                 (前の<literal>param3d</literal>,
121                                                 <literal>plot3d</literal>, <literal>contour</literal> または
122                                                 <literal>plot3d1</literal>のコールで設定された)
123                                                 カレントの3次元スケールで行われます.
124                                             </para>
125                                         </listitem>
126                                     </varlistentry>
127                                     <varlistentry>
128                                         <term>type=1:</term>
129                                         <listitem>
130                                             <para>
131                                                 3次元ボックスのスケールがアスペクト比の最大値に基づき
132                                                 自動的に調整され,
133                                                 境界はオプションの引数<literal>ebox</literal>の値で
134                                                 指定されます.
135                                             </para>
136                                         </listitem>
137                                     </varlistentry>
138                                     <varlistentry>
139                                         <term>type=2:</term>
140                                         <listitem>
141                                             <para>
142                                                 3次元ボックスのスケールがアスペクト比の最大値に基づき
143                                                 自動的に調整され,境界は指令したデータにより計算されます.
144                                             </para>
145                                         </listitem>
146                                     </varlistentry>
147                                     <varlistentry>
148                                         <term>type=3:</term>
149                                         <listitem>
150                                             <para>
151                                                 オプション<literal>ebox</literal>で指定したボックス境界を有する
152                                                 3次元等軸プロットで,<literal>type=1</literal>に似ています.
153                                             </para>
154                                         </listitem>
155                                     </varlistentry>
156                                     <varlistentry>
157                                         <term>type=4:</term>
158                                         <listitem>
159                                             <para>データで定義された境界に基づく3次元等軸プロットで,
160                                                 <literal>type=2</literal>に似ています.
161                                             </para>
162                                         </listitem>
163                                     </varlistentry>
164                                     <varlistentry>
165                                         <term>type=5:</term>
166                                         <listitem>
167                                             <para>
168                                                 オプション<literal>ebox</literal>で指定されたボックス境界で
169                                                 定義された境界に基づく3次元拡張等軸プロットで,
170                                                 <literal>type=1</literal>に似ています.
171                                             </para>
172                                         </listitem>
173                                     </varlistentry>
174                                     <varlistentry>
175                                         <term>type=6:</term>
176                                         <listitem>
177                                             <para>
178                                                 データで定義された境界に基づく3次元拡張等軸プロットで,
179                                                 <literal>type=2</literal>に似ています.
180                                                 軸の境界は axes エンティティプロパティによりカスタマイズできる
181                                                 ことに注意してください(<link linkend="axes_properties">axes_properties</link>参照).
182                                             </para>
183                                         </listitem>
184                                     </varlistentry>
185                                 </variablelist>
186                             </listitem>
187                         </varlistentry>
188                         <varlistentry>
189                             <term>box</term>
190                             <listitem>
191                                 <para>整数 (プロットの周囲のフレーム).</para>
192                                 <variablelist>
193                                     <varlistentry>
194                                         <term>box=0:</term>
195                                         <listitem>
196                                             <para>プロットの周囲に何も描画されません.</para>
197                                         </listitem>
198                                     </varlistentry>
199                                     <varlistentry>
200                                         <term>box=1:</term>
201                                         <listitem>
202                                             <para>実装されていません (box=0と同様).</para>
203                                         </listitem>
204                                     </varlistentry>
205                                     <varlistentry>
206                                         <term>box=2:</term>
207                                         <listitem>
208                                             <para>曲面の背後の軸のみが描画されます.</para>
209                                         </listitem>
210                                     </varlistentry>
211                                     <varlistentry>
212                                         <term>box=3:</term>
213                                         <listitem>
214                                             <para>曲面を囲うボックスが描画され,キャプションが追加されます.</para>
215                                         </listitem>
216                                     </varlistentry>
217                                     <varlistentry>
218                                         <term>box=4:</term>
219                                         <listitem>
220                                             <para>
221                                                 曲面を囲うボックスが描画され,キャプションと軸が追加されます.
222                                             </para>
223                                             <para>
224                                                 軸のアスペクトもaxesエンティティのプロパティによりカスタマイズ
225                                                 できることに注意してください (<link linkend="axes_properties">axes_properties</link>参照).
226                                             </para>
227                                         </listitem>
228                                     </varlistentry>
229                                 </variablelist>
230                             </listitem>
231                         </varlistentry>
232                     </variablelist>
233                 </listitem>
234             </varlistentry>
235             <varlistentry>
236                 <term>ebox</term>
237                 <listitem>
238                     <para>
239                         プロットの境界をベクトル
240                         <literal>[xmin,xmax,ymin,ymax,zmin,zmax]</literal>で指定します. 
241                         この引数は,<literal>flag</literal>の<literal>type</literal>が<literal>1</literal>,
242                         <literal>3</literal> または <literal>5</literal>に設定された場合,
243                         使用されます (対応する動作については上記参照). 
244                         <literal>flag</literal> が指定されない場合
245                         <literal>ebox</literal> は無視されます. 
246                     </para>
247                     <para>
248                         指定された場合, <literal>ebox</literal>引数は,
249                         <literal>data_bounds</literal>に基づいて動作し,
250                         axesエンティティのプロパティによりリセットすることも可能であることに
251                         注意してください. ebox のデフォルト値は[0,1,0,1,0,1]です.(<link linkend="axes_properties">axes_properties</link>参照)
252                     </para>
253                 </listitem>
254             </varlistentry>
255         </variablelist>
256     </refsection>
257     <refsection>
258         <title>説明</title>
259         <para>
260             <literal>plot3d2</literal> は矩形の小平面で定義された曲面をプロットします.
261             (X,Y,Z) は曲面を記述する3つの行列です.
262             曲面は4角形のポリゴンから構成されます.
263         </para>
264         <para>
265             小平面のX座標は
266             X(i,j), X(i+1,j), X(i+1,j+1) および X(i,j+1)で指定されます. 同様に
267             Y および Z 行列は Y および Z座標を有します.
268         </para>
269         <para>
270             <literal>vect</literal> ベクトルは,同じ(X,Y,Z)行列に複数の曲面が
271             コード化される場合に使用されます.
272             <literal>vect(j)</literal> はj番目の曲面が開始されるコードの場所の
273             行番号です.
274             <literal>plot3d</literal>と同じプロパティが編集可能です
275             (
276             <link linkend="surface_properties">surface_properties</link> および
277             <link linkend="axes_properties">axes_properties</link>を参照ください).
278         </para>
279     </refsection>
280     <refsection>
281         <title>例</title>
282         <programlisting role="example"><![CDATA[ 
283 u = linspace(-%pi/2,%pi/2,40);
284 v = linspace(0,2*%pi,20);
285 X = cos(u)'*cos(v);
286 Y = cos(u)'*sin(v);
287 Z = sin(u)'*ones(v);
288 plot3d2(X,Y,Z);
289 e=gce();
290 e.color_mode=4; // 色を変更
291 f=e.data;
292 TL = tlist(["3d" "x" "y" "z" "color"],f.x,f.y,f.z,10*(f.z)+1);
293 e.data=TL;
294 e.color_flag=2;
295  ]]></programlisting>
296     </refsection>
297     <refsection role="see also">
298         <title>参照</title>
299         <simplelist type="inline">
300             <member>
301                 <link linkend="plot3d">plot3d</link>
302             </member>
303             <member>
304                 <link linkend="genfac3d">genfac3d</link>
305             </member>
306         </simplelist>
307     </refsection>
308 </refentry>