update japanese translation of core module.
[scilab.git] / scilab / modules / graphics / help / ja_JP / lighting / light.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) Pedro SOUZA
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" scilab:needs-examples="no" xml:id="light">
26     
27     <refnamediv>
28         
29         <refname>light</refname>
30         
31         <refpurpose>指定した軸にライトオブジェクトを作成</refpurpose>
32         
33     </refnamediv>
34     
35     <refsynopsisdiv>
36         
37         <title>呼び出し手順</title>
38         
39         <synopsis>l=light()
40             
41             l=light(&lt;LightProperty&gt;)
42             
43             l=light(axes_handle, &lt;LightProperty&gt;)
44             
45         </synopsis>
46         
47     </refsynopsisdiv>
48     
49     <refsection>
50         
51         <title>引数</title>
52         
53         <variablelist>
54             
55             <varlistentry>
56                 
57                 <term>axes_handle</term>
58                 
59                 <listitem>
60                     
61                     <para>軸のハンドル, 省略した場合はカレントの軸.</para>
62                     
63                 </listitem>
64                 
65             </varlistentry>
66             
67             <varlistentry>
68                 
69                 <term>&lt;LightProperty&gt;</term>
70                 
71                 <listitem>
72                     
73                     <para>
74                         
75                         ライトプロパティを指定するオプション引数.
76                         
77                         オプション引数は以下の構文で指定可能:
78                         
79                         <literal>"light(propname1=propvalue1, propname2=propvalue2, ..., propnameN=propvalueN)"</literal>.
80                         
81                     </para>
82                     
83                     <para>
84                         
85                         以下にオプション引数のリストを示します:
86                         
87                     </para>
88                     
89                     <variablelist>
90                         
91                         <varlistentry>
92                             
93                             <term>visible: </term>
94                             
95                             <listitem>
96                                 
97                                 <para>
98                                     
99                                     このフィールドは光の有効(<literal>"on"</literal>)または
100                                     
101                                     無効(<literal>"off"</literal>)を定義します.
102                                     
103                                 </para>
104                                 
105                             </listitem>
106                             
107                         </varlistentry>
108                         
109                         <varlistentry>
110                             
111                             <term>type: </term>
112                             
113                             <listitem>
114                                 
115                                 <para>
116                                     
117                                     このフィールドは使用される光の型を定義します.
118                                     
119                                     以下の2種類の光を利用できます:
120                                     
121                                     <literal>"directional"</literal> および <literal>"point"</literal>.
122                                     
123                                     方向性(directional)光源は,曲面から無限遠に位置する光源で,平行線となります.
124                                     
125                                 </para>
126                                 
127                                 <para>
128                                     
129                                     点光源は,全ての方向に放射する空間の点として
130                                     
131                                     定義されます.
132                                     
133                                     デフォルト値は <literal>"point"</literal>です.
134                                     
135                                 </para>
136                                 
137                             </listitem>
138                             
139                         </varlistentry>
140                         
141                         <varlistentry>
142                             
143                             <term>direction: </term>
144                             
145                             <listitem>
146                                 
147                                 <para>
148                                     
149                                     このフィールドは方向性光源の光線方向を定義します.
150                                     
151                                     方向は,原点からのベクトルを表す
152                                     
153                                     3要素ベクトル<literal>"[x, y, z]"</literal>により変更できます.
154                                     
155                                 </para>
156                                 
157                                 <para>
158                                     
159                                     デフォルト値は <literal>"[0 0 1]"</literal>です.
160                                     
161                                 </para>
162                                 
163                             </listitem>
164                             
165                         </varlistentry>
166                         
167                         <varlistentry>
168                             
169                             <term>position: </term>
170                             
171                             <listitem>
172                                 
173                                 <para>
174                                     
175                                     このフィールドは,点光源の光源位置を定義します.
176                                     
177                                     位置は3要素ベクトル<literal>"[x, y, z]"</literal>により変更できます.
178                                     
179                                 </para>
180                                 
181                                 <para>
182                                     
183                                     デフォルト値は<literal>"[0 0 1]"</literal>です.
184                                     
185                                 </para>
186                                 
187                             </listitem>
188                             
189                         </varlistentry>
190                         
191                         <varlistentry>
192                             
193                             <term>ambient_color: </term>
194                             
195                             <listitem>
196                                 
197                                 <para>
198                                     
199                                     このフィールドは光源のアンビエント色を定義します.
200                                     
201                                     この色は3要素ベクトル<literal>"[red, green, blue]"</literal>
202                                     
203                                     (各要素の範囲は[0, 1])により定義されます.
204                                     
205                                 </para>
206                                 
207                                 <para>
208                                     
209                                     デフォルト値は<literal>"[0.1 0.1 0.1]"</literal>です.
210                                     
211                                 </para>
212                                 
213                             </listitem>
214                             
215                         </varlistentry>
216                         
217                         <varlistentry>
218                             
219                             <term>diffuse_color: </term>
220                             
221                             <listitem>
222                                 
223                                 <para>
224                                     
225                                     このフィールドは光源の拡散色を定義します.
226                                     
227                                     この色は3要素ベクトル<literal>"[red, green, blue]"</literal>
228                                     
229                                     (各要素の範囲は[0, 1])により定義されます.
230                                     
231                                 </para>
232                                 
233                                 <para>
234                                     
235                                     デフォルト値は<literal>"[1 1 1]"</literal>です.
236                                     
237                                 </para>
238                                 
239                             </listitem>
240                             
241                         </varlistentry>
242                         
243                         <varlistentry>
244                             
245                             <term>specular_color: </term>
246                             
247                             <listitem>
248                                 
249                                 <para>
250                                     
251                                     このフィールドは光源の鏡面反射色を定義します.
252                                     
253                                     この色は3要素ベクトル<literal>"[red, green, blue]"</literal>
254                                     
255                                     (各要素の範囲は[0, 1])により定義されます.
256                                     
257                                 </para>
258                                 
259                                 <para>
260                                     
261                                     デフォルト値は <literal>"[1 1 1]"</literal>です.
262                                     
263                                 </para>
264                                 
265                             </listitem>
266                             
267                         </varlistentry>
268                         
269                     </variablelist>
270                     
271                 </listitem>
272                 
273             </varlistentry>
274             
275         </variablelist>
276         
277     </refsection>
278     
279     <refsection>
280         
281         <title>説明</title>
282         
283         <para>
284             
285             <literal>light</literal> 関数は, 指定した軸の
286             
287             lightエンティティ(lightのエンティティプロパティについては
288             
289             <link linkend="light">light_property</link> を参照)を作成し,オプション引数
290             
291             &lt;LightProperty&gt; で指定したプロパティを設定します.
292             
293         </para>
294         
295         <para>
296             
297             面の見え方を決める照明の効果に関する詳細については,
298             
299             <link linkend="lighting">照明</link>を参照ください.
300             
301         </para>
302         
303     </refsection>
304     
305     <refsection>
306         
307         <title>例</title>
308         
309         <scilab:image>
310             
311             plot3d();
312             
313             l = light(visible="on", type="point", position=[0 0 1]);
314             
315         </scilab:image>
316         
317         <programlisting role="example"><![CDATA[
318
319 plot3d();
320
321 l = light(visible="on", type="point", position=[0 0 1]);
322
323          ]]></programlisting>
324         
325     </refsection>
326     
327     <refsection role="see also">
328         
329         <title>参照</title>
330         
331         <simplelist type="inline">
332             
333             <member>
334                 
335                 <link linkend="lighting">照明</link>
336                 
337             </member>
338             
339             <member>
340                 
341                 <link linkend="light_properties">lightプロパティ</link>
342                 
343             </member>
344             
345             <member>
346                 
347                 <link linkend="surface_properties">surfaceプロパティ</link>
348                 
349             </member>
350             
351             <member>
352                 
353                 <link linkend="delete">delete</link>
354                 
355             </member>
356             
357         </simplelist>
358         
359     </refsection>
360     
361 </refentry>
362