update japanese translation of core module.
[scilab.git] / scilab / modules / graphics / help / ja_JP / lighting / lighting.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="lighting">
26     
27     <refnamediv>
28         
29         <refname>lighting</refname>
30         
31         <refpurpose>照明の概要</refpurpose>
32         
33     </refnamediv>
34     
35     <refsection>
36         
37         <title>説明</title>
38         
39         <para>
40             
41             scilabにおける照明は実世界の照明を近似するもので,
42             
43             曲面の外観は光線と曲面の物質特性の相互関係により指定されます.
44             
45         </para>
46         
47         <para>
48             
49             実世界の光源を模擬することは複雑で計算負荷が高いため,
50             
51             簡易的なモデルを使用します.
52             
53         </para>
54         
55         <para>
56             
57             光源は主にその色で表されます: アンビエント, 拡散, 鏡面反射.
58             
59             <link linkend="light">light</link> 関数により作成でき,
60             
61             <link linkend="delete">delete</link> 関数により削除されます.
62             
63         </para>
64         
65         <para>
66             
67             曲面の物性は色(アンビエント, 拡散および鏡面反射)と輝度によっても表されます.
68             
69         </para>
70         
71         <para>
72             
73             曲面は,拡散色として曲面の色を有効にする
74             
75             <literal>color_material</literal>プロパティを有します.
76             
77         </para>
78         
79         <para>
80             
81             最終的な曲面の色は,曲面と光源色の積に適用される光線モデル方程式により
82             
83             指定されます.以下に光線モデル方程式を示します:
84             
85         </para>
86         
87         <scilab:image>
88             
89             xset("font",1,4);
90             
91             xstring(0.0, 0.4, '$Color = Ambient_{term} + Diffuse_{term} + Specular_{term} \\ Ambient_{term} = L_{ambient}*S_{ambient} \\ Diffuse_{term} = L_{diffuse}*S_{diffuse}*(L_{direction} \cdot S_{normal}) \\ Specular_{term} = L_{specular}*S_{specular}*(S_{normal} \cdot (L_{direction}+View_{direction}) ))^{S_{shininess}}$');
92             
93             f=gcf();
94             
95             f.figure_size = [750,280];
96             
97         </scilab:image>
98         
99         <listitem>
100             
101             <para>
102                 
103                 アンビエント色は,曲面に間接的にさした光をモデル化するもので,
104                 
105                 面の法線または光の方向に依存しません.
106                 
107             </para>
108             
109         </listitem>
110         
111         <listitem>
112             
113             <para>
114                 
115                 拡散色は直接さす光をモデル化するもので,
116                 
117                 光線方向および面の法線に依存します.
118                 
119             </para>
120             
121         </listitem>
122         
123         <listitem>
124             
125             <para>
126                 
127                 鏡面反射色は鏡面反射ハイライト色を定義します.
128                 
129             </para>
130             
131         </listitem>
132         
133         <para>
134             
135             以下に照明のあるまたはない面を比較します:
136             
137         </para>
138         
139         <para>
140             
141             <scilab:image>
142                 
143                 plot3d();
144                 
145                 l = light();
146                 
147             </scilab:image>
148             
149         </para>
150         
151         <para>
152             
153             <scilab:image>
154                 
155                 plot3d();
156                 
157             </scilab:image>
158             
159         </para>
160         
161     </refsection>
162     
163     <refsection>
164         
165         <title>光源プロパティのリスト</title>
166         
167         <variablelist>
168             
169             <varlistentry>
170                 
171                 <term>kightプロパティ</term>
172                 
173                 <listitem>
174                     
175                     <variablelist>
176                         
177                         <varlistentry>
178                             
179                             <term>visible: </term>
180                             
181                             <listitem>
182                                 
183                                 <para>
184                                     
185                                     このフィールドは光の有効(<literal>"on"</literal>)または
186                                     
187                                     無効(<literal>"off"</literal>)を定義します.
188                                     
189                                 </para>
190                                 
191                             </listitem>
192                             
193                         </varlistentry>
194                         
195                         <varlistentry>
196                             
197                             <term>light_type: </term>
198                             
199                             <listitem>
200                                 
201                                 <para>
202                                     
203                                     このフィールドは使用される光の型を定義します.
204                                     
205                                     以下の2種類の光を利用できます:
206                                     
207                                     <literal>"directional"</literal> および <literal>"point"</literal>.
208                                     
209                                     方向性(directional)光源は,曲面から無限遠に位置する光源で,平行線となります.
210                                     
211                                 </para>
212                                 
213                                 <para>
214                                     
215                                     点光源は,全ての方向に放射する空間の点として
216                                     
217                                     定義されます.
218                                     
219                                     デフォルト値は <literal>"point"</literal>です.
220                                     
221                                 </para>
222                                 
223                             </listitem>
224                             
225                         </varlistentry>
226                         
227                         <varlistentry>
228                             
229                             <term>direction: </term>
230                             
231                             <listitem>
232                                 
233                                 <para>
234                                     
235                                     このフィールドは方向性光源の光線方向を定義します.
236                                     
237                                     方向は,原点からのベクトルを表す
238                                     
239                                     3要素ベクトル<literal>"[x, y, z]"</literal>により変更できます.
240                                     
241                                 </para>
242                                 
243                                 <para>
244                                     
245                                     デフォルト値は <literal>"[0 0 1]"</literal>です.
246                                     
247                                 </para>
248                                 
249                             </listitem>
250                             
251                         </varlistentry>
252                         
253                         <varlistentry>
254                             
255                             <term>position: </term>
256                             
257                             <listitem>
258                                 
259                                 <para>
260                                     
261                                     このフィールドは,点光源の光源位置を定義します.
262                                     
263                                     位置は3要素ベクトル<literal>"[x, y, z]"</literal>により変更できます.
264                                     
265                                 </para>
266                                 
267                                 <para>
268                                     
269                                     デフォルト値は<literal>"[0 0 1]"</literal>です.
270                                     
271                                 </para>
272                                 
273                             </listitem>
274                             
275                         </varlistentry>
276                         
277                         <varlistentry>
278                             
279                             <term>ambient_color: </term>
280                             
281                             <listitem>
282                                 
283                                 <para>
284                                     
285                                     このフィールドは光源のアンビエント色を定義します.
286                                     
287                                     この色は3要素ベクトル<literal>"[red, green, blue]"</literal>
288                                     
289                                     (各要素の範囲は[0, 1])により定義されます.
290                                     
291                                 </para>
292                                 
293                                 <para>
294                                     
295                                     デフォルト値は<literal>"[0.1 0.1 0.1]"</literal>です.
296                                     
297                                 </para>
298                                 
299                             </listitem>
300                             
301                         </varlistentry>
302                         
303                         <varlistentry>
304                             
305                             <term>diffuse_color: </term>
306                             
307                             <listitem>
308                                 
309                                 <para>
310                                     
311                                     このフィールドは光源の拡散色を定義します.
312                                     
313                                     この色は3要素ベクトル<literal>"[red, green, blue]"</literal>
314                                     
315                                     (各要素の範囲は[0, 1])により定義されます.
316                                     
317                                 </para>
318                                 
319                                 <para>
320                                     
321                                     デフォルト値は<literal>"[1 1 1]"</literal>です.
322                                     
323                                 </para>
324                                 
325                             </listitem>
326                             
327                         </varlistentry>
328                         
329                         <varlistentry>
330                             
331                             <term>specular_color: </term>
332                             
333                             <listitem>
334                                 
335                                 <para>
336                                     
337                                     このフィールドは光源の鏡面反射色を定義します.
338                                     
339                                     この色は3要素ベクトル<literal>"[red, green, blue]"</literal>
340                                     
341                                     (各要素の範囲は[0, 1])により定義されます.
342                                     
343                                 </para>
344                                 
345                                 <para>
346                                     
347                                     デフォルト値は <literal>"[1 1 1]"</literal>です.
348                                     
349                                 </para>
350                                 
351                             </listitem>
352                             
353                         </varlistentry>
354                         
355                     </variablelist>
356                     
357                 </listitem>
358                 
359             </varlistentry>
360             
361             
362             
363             <varlistentry>
364                 
365                 <term>曲面のプロパティ</term>
366                 
367                 <listitem>
368                     
369                     <variablelist>
370                         
371                         <varlistentry>
372                             
373                             <term>use_color_material: </term>
374                             
375                             <listitem>
376                                 
377                                 <para>
378                                     
379                                     このフィールドは曲面の色を拡散色として使用することを有効にします.
380                                     
381                                     デフォルト値は<literal>"on"</literal>です.
382                                     
383                                 </para>
384                                 
385                             </listitem>
386                             
387                         </varlistentry>
388                         
389                         <varlistentry>
390                             
391                             <term>material_shininess: </term>
392                             
393                             <listitem>
394                                 
395                                 <para>
396                                     
397                                     このフィールドは曲面の輝度を定義します.
398                                     
399                                     このパラメータは曲面内で散らばる輝度色を制御します.
400                                     
401                                     正の値を使用できます.
402                                     
403                                 </para>
404                                 
405                                 <para>
406                                     
407                                     [0 10]の範囲の値を使用すると良く, 小さい値は強いハイライト,
408                                     
409                                     大きな値はわずかに認識できるハイライトを生成します.
410                                     
411                                     デフォルト値は<literal>"2"</literal>です.
412                                     
413                                 </para>
414                                 
415                             </listitem>
416                             
417                         </varlistentry>
418                         
419                         <varlistentry>
420                             
421                             <term>ambient_color: </term>
422                             
423                             <listitem>
424                                 
425                                 <para>
426                                     
427                                     このフィールドは光源のアンビエント色を定義します.
428                                     
429                                     この色は3要素ベクトル<literal>"[red, green, blue]"</literal>
430                                     
431                                     (各要素の範囲は[0, 1])により定義されます.
432                                     
433                                 </para>
434                                 
435                                 <para>
436                                     
437                                     デフォルト値は<literal>"[1 1 1]"</literal>です.
438                                     
439                                 </para>
440                                 
441                             </listitem>
442                             
443                         </varlistentry>
444                         
445                         <varlistentry>
446                             
447                             <term>diffuse_color: </term>
448                             
449                             <listitem>
450                                 
451                                 <para>
452                                     
453                                     このフィールドは光源の拡散色を定義します.
454                                     
455                                     この色は3要素ベクトル<literal>"[red, green, blue]"</literal>
456                                     
457                                     (各要素の範囲は[0, 1])により定義されます.
458                                     
459                                     このフィールドはuse_color_materialが無効の場合の
460                                     
461                                     使用されることに注意してください.
462                                     
463                                 </para>
464                                 
465                                 <para>
466                                     
467                                     デフォルト値は<literal>"[1 1 1]"</literal>です.
468                                     
469                                 </para>
470                                 
471                             </listitem>
472                             
473                         </varlistentry>
474                         
475                         <varlistentry>
476                             
477                             <term>specular_color: </term>
478                             
479                             <listitem>
480                                 
481                                 <para>
482                                     
483                                     このフィールドは光源の鏡面反射色を定義します.
484                                     
485                                     この色は3要素ベクトル<literal>"[red, green, blue]"</literal>
486                                     
487                                     (各要素の範囲は[0, 1])により定義されます.
488                                     
489                                 </para>
490                                 
491                                 <para>
492                                     
493                                     デフォルト値は <literal>"[1 1 1]"</literal>です.
494                                     
495                                 </para>
496                                 
497                             </listitem>
498                             
499                         </varlistentry>
500                         
501                     </variablelist>
502                     
503                 </listitem>
504                 
505             </varlistentry>
506             
507         </variablelist>
508         
509     </refsection>
510     
511     <refsection>
512         
513         <title>例</title>
514         
515         <para>
516             
517             color_materialなしの点光源:
518             
519         </para>
520         
521         <programlisting role="example"><![CDATA[
522
523 plot3d();
524
525 s=gce();
526
527 s.color_flag=0;
528
529 s.thickness=0;
530
531 s.hiddencolor = -1;
532
533 light();
534
535 //拡散色をオレンジに変更
536
537 s.diffuse_color = [1, 0.6, 0];
538
539 s.use_color_material="off";
540
541 //黒の点を暗いオレンジに変更
542
543 s.ambient_color = [1, 0.6, 0];
544
545          ]]></programlisting>
546         
547         <para>
548             
549             方向性光源:
550             
551         </para>
552         
553         <programlisting role="example"><![CDATA[
554
555 plot3d();
556
557 s=gce();
558
559 l = light();
560
561 s.color_flag=0;
562
563 s.thickness=0;
564
565 l.light_type = "directional";
566
567 l.direction = [0 0 1];
568
569 l.diffuse_color = [1 0.9 0.9];
570
571 l.ambient_color = [0.5 0.4 0.4];
572
573 l.specular_color = [0.5 0.3 0.7];
574
575          ]]></programlisting>
576         
577     </refsection>
578     
579     <refsection role="see also">
580         
581         <title>参照</title>
582         
583         <simplelist type="inline">
584             
585             <member>
586                 
587                 <link linkend="light">light</link>
588                 
589             </member>
590             
591             <member>
592                 
593                 <link linkend="light_properties">lightプロパティ</link>
594                 
595             </member>
596             
597             <member>
598                 
599                 <link linkend="surface_properties">surfaceプロパティ</link>
600                 
601             </member>
602             
603             <member>
604                 
605                 <link linkend="delete">delete</link>
606                 
607             </member>
608             
609         </simplelist>
610         
611     </refsection>
612     
613 </refentry>
614