update japanese translation of core module.
[scilab.git] / scilab / modules / graphics / help / ja_JP / geometric_shapes / xarrows.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  * This file must be used under the terms of the CeCILL.
12
13  * This source file is licensed as described in the file COPYING, which
14
15  * you should have received as part of this distribution.  The terms
16
17  * are also available at    
18
19  * http://www.cecill.info/licences/Licence_CeCILL_V2.1-en.txt
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: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="xarrows">
26     
27     <refnamediv>
28         
29         <refname>xarrows</refname>
30         
31         <refpurpose>2Dまたは3Dで矢印を描画</refpurpose>
32         
33     </refnamediv>
34     
35     <refsynopsisdiv>
36         
37         <title>呼び出し手順</title>
38         
39         <synopsis>xarrows(nx, ny [,nz] [,arsize, color])</synopsis>
40         
41     </refsynopsisdiv>
42     
43     <refsection>
44         
45         <title>引数</title>
46         
47         <variablelist>
48             
49             <varlistentry>
50                 
51                 <term>nx, ny, nz</term>
52                 
53                 <listitem>
54                     
55                     <para>同じ大きさの実数のベクトルまたは行列.</para>
56                     
57                 </listitem>
58                 
59             </varlistentry>
60             
61             <varlistentry>
62                 
63                 <term>arsize</term>
64                 
65                 <listitem>
66                     
67                     <para>実数スカラー, 矢じりの大きさ. 
68                         
69                         デフォルト値は <varname>arsize</varname> を -1 に設定することにより得られます.
70                         
71                     </para>
72                     
73                 </listitem>
74                 
75             </varlistentry>
76             
77             <varlistentry>
78                 
79                 <term>color</term>
80                 
81                 <listitem>
82                     
83                     <para>行列またはスカラー. 
84                         
85                         <varname>color</varname>が正のスカラーの場合,
86                         
87                         この値は全ての矢印に使用される色を指定します.
88                         
89                         負のスカラーの場合,カレントの色が使用されます.
90                         
91                         ベクトルの場合,<literal>color(i)</literal> は <literal>i</literal>番目の
92                         
93                         矢印に使用される色を指定します.
94                         
95                     </para>
96                     
97                 </listitem>
98                 
99             </varlistentry>
100             
101         </variablelist>
102         
103     </refsection>
104     
105     <refsection>
106         
107         <title>説明</title>
108         
109         <para>
110             
111             <function>xarrows</function>は<varname>nx</varname>,
112             
113             <varname>ny</varname>および <varname>nz</varname>により指定される矢印の集合を描画します.
114             
115             <varname>nz</varname>が指定されない場合, 2Dで矢印を描画します.
116             
117             <varname>nx</varname>, <varname>ny</varname>および<varname>nz</varname>
118             
119             がベクトルの場合,i番目の矢印は
120             
121             <literal>(nx(i),ny(i),nz(i))--&gt;(nx(i+1),ny(i+1),nz(i+1))</literal>
122             
123             により定義されます.
124             
125             <varname>nx</varname> および <varname>ny</varname> が行列の場合:
126             
127         </para>
128         
129         <programlisting role="no-scilab-exec"><![CDATA[
130
131 nx=[xi_1 x1_2 ...; xf_1 xf_2 ...]
132
133 ny=[yi_1 y1_2 ...; yf_1 yf_2 ...]
134
135 nz=[zi_1 z1_2 ...; zf_1 zf_2 ...]
136
137  ]]></programlisting>
138         
139         <para>
140             
141             <literal>k</literal>番目の矢印は,
142             
143             <literal>(xi_k,yi_k,zi_k)--&gt;(xf_k,yf_k,zf_k)</literal>
144             
145             により定義されます.
146             
147         </para>
148         
149         <para>
150             
151             <function>xarrows</function>は,
152             
153             <function>plot2d</function>のような高レベル関数をコールすることにより
154             
155             設定可能なカレントのグラフィックスケールを使用します.
156             
157         </para>
158         
159     </refsection>
160     
161     <refsection>
162         
163         <title>例</title>
164         
165         <programlisting role="example"><![CDATA[
166
167 x = 2*%pi*(0:7)/8
168
169 x1 = [sin(x); 9*sin(x)];
170
171 y1 = [cos(x); 9*cos(x)];
172
173 plot2d([-10,10], [-10,10], [-1,-1], "022")
174
175 xset("clipgrf")
176
177 xarrows(x1, y1, -1, [1:7,9]) //8番目の色は白
178
179 xset("clipoff")
180
181  ]]></programlisting>
182         
183         <scilab:image>
184             
185             x = 2*%pi*(0:7)/8
186             
187             x1 = [sin(x); 9*sin(x)];
188             
189             y1 = [cos(x); 9*cos(x)];
190             
191             plot2d([-10,10], [-10,10], [-1,-1], "022")
192             
193             xset("clipgrf")
194             
195             xarrows(x1, y1, -1, [1:7,9])
196             
197             xset("clipoff")
198             
199         </scilab:image>
200         
201         <programlisting role="example"><![CDATA[
202
203 N = 100;
204
205 zi = linspace(-1,2,N);
206
207 zf = zi;
208
209 theta = (zi - min(zi))/(max(zi)-min(zi))*720;
210
211 xi = zeros(1,N);  xf = cosd(theta);
212
213 yi = zeros(1,N);  yf = sind(theta);
214
215 clf, plot3d([-1 1 1 1],[-1 -1 -1 1],[-1 -1 2 2])
216
217 xarrows([xi;xf],[yi;yf],[zi;zf],0.7, 32*rand(1,N))
218
219  ]]></programlisting>
220         
221         <scilab:image>
222             
223             N = 100;
224             
225             zi = linspace(-1,2,N);
226             
227             zf = zi;
228             
229             theta = (zi - min(zi))/(max(zi)-min(zi))*720;
230             
231             xi = zeros(1,N);  xf = cosd(theta);
232             
233             yi = zeros(1,N);  yf = sind(theta);
234             
235             clf, plot3d([-1 1 1 1],[-1 -1 -1 1],[-1 -1 2 2])
236             
237             xarrows([xi;xf],[yi;yf],[zi;zf],0.7, 32*rand(1,N))
238             
239         </scilab:image>
240         
241     </refsection>
242     
243     <refsection>
244         
245         <title>履歴</title>
246         
247         <revhistory>
248             
249             <revision>
250                 
251                 <revnumber>5.5.0</revnumber>
252                 
253                 <revremark>矢印を3次元で描画できるようになりました.</revremark>
254                 
255             </revision>
256             
257         </revhistory>
258         
259     </refsection>
260     
261 </refentry>
262