update banners
[scilab.git] / scilab / modules / graphics / help / ja_JP / 3d_plot / param3d.xml
1 <?xml version="1.0" encoding="UTF-8"?>
2
3 <!--
4
5  * Scilab ( http://www.scilab.org/ ) - This file is part of Scilab
6
7  * Copyright (C) ENPC - Jean-Philippe Chancelier
8
9  *
10
11
12  * Copyright (C) 2012 - 2016 - Scilab Enterprises
13  *
14  * This file is hereby licensed under the terms of the GNU GPL v2.0,
15  * pursuant to article 5.3.4 of the CeCILL v.2.1.
16  * This file was originally licensed under the terms of the CeCILL v2.1,
17  * and continues to be available under such terms.
18  * For more information, see the COPYING file which you should have received
19  * along with this program.
20
21  *
22
23  -->
24
25 <refentry xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink" xmlns:svg="http://www.w3.org/2000/svg" xmlns:ns5="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="param3d" xml:lang="ja">
26
27     <refnamediv>
28
29         <refname>param3d</refname>
30
31         <refpurpose>パラメータ表現の曲線の3次元プロット</refpurpose>
32
33     </refnamediv>
34
35     <refsynopsisdiv>
36
37         <title>呼び出し手順</title>
38
39         <synopsis>param3d(x,y,z,[theta,alpha,leg,flag,ebox])</synopsis>
40
41     </refsynopsisdiv>
42
43     <refsection>
44
45         <title>引数</title>
46
47         <variablelist>
48
49             <varlistentry>
50
51                 <term>x,y,z</term>
52
53                 <listitem>
54
55                     <para>同じ大きさのベクトル (パラメータ表現の曲線の点).</para>
56
57                 </listitem>
58
59             </varlistentry>
60
61             <varlistentry>
62
63                 <term>theta, alpha</term>
64
65                 <listitem>
66
67                     <para>観測点の球座標を指定する実数値(単位:度).
68
69                         <emphasis>デフォルト値はT 35 度および 45度です.</emphasis>
70
71                     </para>
72
73                 </listitem>
74
75             </varlistentry>
76
77             <varlistentry>
78
79                 <term>leg</term>
80
81                 <listitem>
82
83                     <para>各軸のラベルを定義する文字列. @ をフィールドセパレータとし,
84
85                         "X@Y@Z"のようになります.
86
87                     </para>
88
89                 </listitem>
90
91             </varlistentry>
92
93             <varlistentry>
94
95                 <term>flag=[type,box]</term>
96
97                 <listitem>
98
99                     <para>
100
101                         <literal>type</literal> および <literal>box</literal> の意味は
102
103                         <literal>plot3d</literal>と同じ意味になります:
104
105                     </para>
106
107                     <variablelist>
108
109                         <varlistentry>
110
111                             <term>type</term>
112
113                             <listitem>
114
115                                 <para>整数 (スケール).</para>
116
117                                 <variablelist>
118
119                                     <varlistentry>
120
121                                         <term>type=0</term>
122
123                                         <listitem>
124
125                                             <para>プロットは
126
127                                                 (前の<literal>param3d</literal>,
128
129                                                 <literal>plot3d</literal>, <literal>contour</literal> または
130
131                                                 <literal>plot3d1</literal>のコールで設定された)
132
133                                                 カレントの3次元スケールで行われます.
134
135                                             </para>
136
137                                         </listitem>
138
139                                     </varlistentry>
140
141                                     <varlistentry>
142
143                                         <term>type=1</term>
144
145                                         <listitem>
146
147                                             <para>
148
149                                                 3次元ボックスのスケールがアスペクト比の最大値に基づき
150
151                                                 自動的に調整され,
152
153                                                 境界はオプションの引数<literal>ebox</literal>の値で
154
155                                                 指定されます.
156
157                                             </para>
158
159                                         </listitem>
160
161                                     </varlistentry>
162
163                                     <varlistentry>
164
165                                         <term>type=2</term>
166
167                                         <listitem>
168
169                                             <para>
170
171                                                 3次元ボックスのスケールがアスペクト比の最大値に基づき
172
173                                                 自動的に調整され,
174
175                                                 境界は指令したデータにより計算されます.
176
177                                                 <emphasis>これがデフォルト値です.</emphasis>
178
179                                             </para>
180
181                                         </listitem>
182
183                                     </varlistentry>
184
185                                     <varlistentry>
186
187                                         <term>type=3</term>
188
189                                         <listitem>
190
191                                             <para>
192
193                                                 オプション<literal>ebox</literal>で指定したボックス境界を有する
194
195                                                 3次元等軸プロットで,<literal>type=1</literal>に似ています.
196
197                                             </para>
198
199                                         </listitem>
200
201                                     </varlistentry>
202
203                                     <varlistentry>
204
205                                         <term>type=4</term>
206
207                                         <listitem>
208
209                                             <para>データで定義された境界に基づく3次元等軸プロットで,
210
211                                                 <literal>type=2</literal>に似ています.
212
213                                             </para>
214
215                                         </listitem>
216
217                                     </varlistentry>
218
219                                     <varlistentry>
220
221                                         <term>type=5</term>
222
223                                         <listitem>
224
225                                             <para>
226
227                                                 オプション<literal>ebox</literal>で指定されたボックス境界で
228
229                                                 定義された境界に基づく3次元拡張等軸プロットで,
230
231                                                 <literal>type=1</literal>に似ています.
232
233                                             </para>
234
235                                         </listitem>
236
237                                     </varlistentry>
238
239                                     <varlistentry>
240
241                                         <term>type=6</term>
242
243                                         <listitem>
244
245                                             <para>
246
247                                                 データで定義された境界に基づく3次元拡張等軸プロットで,
248
249                                                 <literal>type=2</literal>に似ています.
250
251                                                 軸の境界は axes エンティティプロパティによりカスタマイズできる
252
253                                                 ことに注意してください(<link linkend="axes_properties">axes_properties</link>参照).
254
255                                             </para>
256
257                                         </listitem>
258
259                                     </varlistentry>
260
261                                 </variablelist>
262
263                             </listitem>
264
265                         </varlistentry>
266
267                         <varlistentry>
268
269                             <term>box</term>
270
271                             <listitem>
272
273                                 <para>整数 (プロットの周囲のフレーム).</para>
274
275                                 <variablelist>
276
277                                     <varlistentry>
278
279                                         <term>box=0</term>
280
281                                         <listitem>
282
283                                             <para>プロットの周囲に何も描画されませ.</para>
284
285                                         </listitem>
286
287                                     </varlistentry>
288
289                                     <varlistentry>
290
291                                         <term>box=1</term>
292
293                                         <listitem>
294
295                                             <para>実装されていません (box=0と同様).</para>
296
297                                         </listitem>
298
299                                     </varlistentry>
300
301                                     <varlistentry>
302
303                                         <term>box=2</term>
304
305                                         <listitem>
306
307                                             <para>曲面の背後の軸のみが描画されます.</para>
308
309                                         </listitem>
310
311                                     </varlistentry>
312
313                                     <varlistentry>
314
315                                         <term>box=3</term>
316
317                                         <listitem>
318
319                                             <para>
320
321                                                 曲面を囲うボックスが描画され,キャプションが追加されます.
322
323                                             </para>
324
325                                         </listitem>
326
327                                     </varlistentry>
328
329                                     <varlistentry>
330
331                                         <term>box=4</term>
332
333                                         <listitem>
334
335                                             <para>
336
337                                                 曲面を囲うボックスが描画され,キャプションと軸が追加されます.
338
339                                                 軸のアスペクトもaxesエンティティのプロパティによりカスタマイズ
340
341                                                 できることに注意してください (<link linkend="axes_properties">axes_properties</link>参照).
342
343                                                 <emphasis>これがデフォルト値です.</emphasis>
344
345                                             </para>
346
347                                         </listitem>
348
349                                     </varlistentry>
350
351                                 </variablelist>
352
353                             </listitem>
354
355                         </varlistentry>
356
357                     </variablelist>
358
359                 </listitem>
360
361             </varlistentry>
362
363             <varlistentry>
364
365                 <term>ebox</term>
366
367                 <listitem>
368
369                     <para>
370
371                         プロットの境界をベクトル
372
373                         <literal>[xmin,xmax,ymin,ymax,zmin,zmax]</literal>で指定します.
374
375
376
377                         この引数は,<literal>flag</literal>の<literal>type</literal>が<literal>1</literal>,
378
379                         <literal>3</literal> または <literal>5</literal>に設定された場合,
380
381                         使用されます (対応する動作については上記参照).
382
383                         <literal>flag</literal> が指定されない場合
384
385                         <literal>ebox</literal> は無視されます.
386
387                         指定された場合, <literal>ebox</literal>引数は,
388
389                         <literal>data_bounds</literal>に基づいて動作し,
390
391                         axesエンティティのプロパティによりリセットすることも可能であることに
392
393                         注意してください(<link linkend="axes_properties">axes_properties</link>参照).
394
395                         ebox のデフォルト値は[0,1,0,1,0,1]です.
396
397                     </para>
398
399                 </listitem>
400
401             </varlistentry>
402
403         </variablelist>
404
405     </refsection>
406
407     <refsection>
408
409         <title>説明</title>
410
411         <para>
412
413             <literal>param3d</literal> はその座標<literal>x</literal>,
414
415             <literal>y</literal> および<literal>z</literal>により定義される
416
417             3次元曲線をプロットするために使用されます.
418
419             データは surface エンティティのプロパティにより取得または修正できることに
420
421             注意してください (<link linkend="surface_properties">surface_properties</link>を参照ください).
422
423         </para>
424
425         <para>プロットされる曲線の
426
427             <literal>rotation angles</literal>,
428
429             <literal>colors</literal> および <literal>thickness</literal> のような
430
431             プロパティも polyline エンティティプロパティにより取得または修正することが
432
433             できます
434
435             (<link linkend="polyline_properties">polyline_properties</link>参照).
436
437         </para>
438
439         <para>
440
441             複数のプロットを行うには<literal>param3d1</literal> を使用してください.
442
443         </para>
444
445         <para>
446
447             コマンド <literal>param3d()</literal> を入力するとデモを参照できます.
448
449         </para>
450
451     </refsection>
452
453     <refsection>
454
455         <title>例</title>
456
457         <programlisting role="example"><![CDATA[
458
459 t=0:0.1:5*%pi;
460
461 param3d(sin(t),cos(t),t/10,35,45,"X@Y@Z",[2,3])
462
463
464
465 e=gce() //3次元ポリラインのハンドル
466
467
468
469 e.foreground=color('red');
470
471
472
473 a=gca(); //軸のハンドル
474
475 a.rotation_angles=[10 70];
476
477  ]]></programlisting>
478
479         <scilab:image>
480
481             t=0:0.1:5*%pi;
482
483             param3d(sin(t),cos(t),t/10,35,45,"X@Y@Z",[2,3])
484
485
486
487             e=gce() //the handle on the 3D polyline
488
489
490
491             e.foreground=color('red');
492
493
494
495             a=gca(); //the handle on the axes
496
497             a.rotation_angles=[10 70];
498
499         </scilab:image>
500
501     </refsection>
502
503     <refsection role="see also">
504
505         <title>参照</title>
506
507         <simplelist type="inline">
508
509             <member>
510
511                 <link linkend="param3d1">param3d1</link>
512
513             </member>
514
515             <member>
516
517                 <link linkend="plot3d">plot3d</link>
518
519             </member>
520
521         </simplelist>
522
523     </refsection>
524
525 </refentry>
526