update japanese translation of core module.
[scilab.git] / scilab / modules / graphics / help / ja_JP / lighting / light_properties.xml
1 <?xml version="1.0" encoding="UTF-8"?>
2
3
4
5 <!--
6
7  * Scilab ( http://www.scilab.org/ ) - This file is part of Scilab
8
9  * Copyright (C) Pedro SOUZA
10
11  *
12
13  * This file must be used under the terms of the CeCILL.
14
15  * This source file is licensed as described in the file COPYING, which
16
17  * you should have received as part of this distribution.  The terms
18
19  * are also available at
20
21  * http://www.cecill.info/licences/Licence_CeCILL_V2.1-en.txt
22
23  *
24
25  -->
26
27
28
29 <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_properties">
30     
31     
32     
33     <refnamediv>
34         
35         
36         
37         <refname>light properties</refname>
38         
39         
40         
41         <refpurpose>光源の概要</refpurpose>
42         
43         
44         
45     </refnamediv>
46     
47     
48     
49     <refsection>
50         
51         
52         
53         <title>説明</title>
54         
55         
56         
57         <para>
58             
59             
60             
61             lightエンティティは外観照明を変更するためのプロパティを有します.
62             
63             
64             
65             照明は軸内では不可視ですが,曲面の外観に影響を与えます.
66             
67             
68             
69             (照明の詳細については<link linkend="lighting">照明</link>を参照ください).
70             
71             
72             
73         </para>
74         
75         
76         
77         <para>
78             
79             
80             
81             光源は
82             
83             
84             
85             <link linkend="light">light</link> 関数により作成でき,
86             
87             
88             
89             <link linkend="delete">delete</link> 関数により削除されます.
90             
91             
92             
93         </para>
94         
95         
96         
97         <scilab:image>
98             
99             
100             
101             plot3d();
102             
103             
104             
105             l = light();
106             
107             
108             
109             s = gce();
110             
111             
112             
113             s.diffuse_color = [0 0 0.8];
114             
115             
116             
117             s.ambient_color = [0 0 1];
118             
119             
120             
121             s.use_color_material = "off";
122             
123             
124             
125         </scilab:image>
126         
127         
128         
129     </refsection>
130     
131     
132     
133     <refsection>
134         
135         
136         
137         <title>lightプロパティのリスト</title>
138         
139         
140         
141         <variablelist>
142             
143             
144             
145             <varlistentry>
146                 
147                 
148                 
149                 <term>visible: </term>
150                 
151                 
152                 
153                 <listitem>
154                     
155                     
156                     
157                     <para>
158                         
159                         
160                         
161                         このフィールドは光源の有効(<literal>"on"</literal>)または
162                         
163                         
164                         
165                         無効(<literal>"off"</literal>)を定義します.
166                         
167                         
168                         
169                     </para>
170                     
171                     
172                     
173                 </listitem>
174                 
175                 
176                 
177             </varlistentry>
178             
179             
180             
181             <varlistentry>
182                 
183                 
184                 
185                 <term>light_type: </term>
186                 
187                 
188                 
189                 <listitem>
190                     
191                     
192                     
193                     <para>
194                         
195                         
196                         
197                         このフィールドは使用される光の型を定義します.
198                         
199                         
200                         
201                         以下の2種類の光を利用できます:
202                         
203                         
204                         
205                         <literal>"directional"</literal> および <literal>"point"</literal>.
206                         
207                         
208                         
209                         方向性(directional)光源は,曲面から無限遠に位置する光源で,平行線となります.
210                         
211                         
212                         
213                     </para>
214                     
215                     
216                     
217                     <para>
218                         
219                         
220                         
221                         点(point)光源は,全ての方向に放射する空間の点として
222                         
223                         
224                         
225                         定義されます.
226                         
227                         
228                         
229                         デフォルト値は <literal>"point"</literal>です.
230                         
231                         
232                         
233                     </para>
234                     
235                     
236                     
237                 </listitem>
238                 
239                 
240                 
241             </varlistentry>
242             
243             
244             
245             <varlistentry>
246                 
247                 
248                 
249                 <term>direction: </term>
250                 
251                 
252                 
253                 <listitem>
254                     
255                     
256                     
257                     <para>
258                         
259                         
260                         
261                         このフィールドは方向性光源の光線方向を定義します.
262                         
263                         
264                         
265                         方向は,原点からのベクトルを表す
266                         
267                         
268                         
269                         3要素ベクトル<literal>"[x, y, z]"</literal>により変更できます.
270                         
271                         
272                         
273                     </para>
274                     
275                     
276                     
277                     <para>
278                         
279                         
280                         
281                         デフォルト値は <literal>"[0 0 1]"</literal>です.
282                         
283                         
284                         
285                     </para>
286                     
287                     
288                     
289                 </listitem>
290                 
291                 
292                 
293             </varlistentry>
294             
295             
296             
297             <varlistentry>
298                 
299                 
300                 
301                 <term>position: </term>
302                 
303                 
304                 
305                 <listitem>
306                     
307                     
308                     
309                     <para>
310                         
311                         
312                         
313                         このフィールドは,点光源の光源位置を定義します.
314                         
315                         
316                         
317                         位置は3要素ベクトル<literal>"[x, y, z]"</literal>により変更できます.
318                         
319                         
320                         
321                     </para>
322                     
323                     
324                     
325                     <para>
326                         
327                         
328                         
329                         デフォルト値は<literal>"[0 0 1]"</literal>です.
330                         
331                         
332                         
333                     </para>
334                     
335                     
336                     
337                 </listitem>
338                 
339                 
340                 
341             </varlistentry>
342             
343             
344             
345             <varlistentry>
346                 
347                 
348                 
349                 <term>ambient_color: </term>
350                 
351                 
352                 
353                 <listitem>
354                     
355                     
356                     
357                     <para>
358                         
359                         
360                         
361                         このフィールドは光源のアンビエント色を定義します.
362                         
363                         
364                         
365                         この色は3要素ベクトル<literal>"[red, green, blue]"</literal>
366                         
367                         
368                         
369                         (各要素の範囲は[0, 1])により定義されます.
370                         
371                         
372                         
373                     </para>
374                     
375                     
376                     
377                     <para>
378                         
379                         
380                         
381                         デフォルト値は<literal>"[0.1 0.1 0.1]"</literal>です.
382                         
383                         
384                         
385                     </para>
386                     
387                     
388                     
389                 </listitem>
390                 
391                 
392                 
393             </varlistentry>
394             
395             
396             
397             <varlistentry>
398                 
399                 
400                 
401                 <term>diffuse_color: </term>
402                 
403                 
404                 
405                 <listitem>
406                     
407                     
408                     
409                     <para>
410                         
411                         
412                         
413                         このフィールドは光源の拡散色を定義します.
414                         
415                         
416                         
417                         この色は3要素ベクトル<literal>"[red, green, blue]"</literal>
418                         
419                         
420                         
421                         (各要素の範囲は[0, 1])により定義されます.
422                         
423                         
424                         
425                     </para>
426                     
427                     
428                     
429                     <para>
430                         
431                         
432                         
433                         デフォルト値は<literal>"[1 1 1]"</literal>です.
434                         
435                         
436                         
437                     </para>
438                     
439                     
440                     
441                 </listitem>
442                 
443                 
444                 
445             </varlistentry>
446             
447             
448             
449             <varlistentry>
450                 
451                 
452                 
453                 <term>specular_color: </term>
454                 
455                 
456                 
457                 <listitem>
458                     
459                     
460                     
461                     <para>
462                         
463                         
464                         
465                         このフィールドは光源の鏡面反射色を定義します.
466                         
467                         
468                         
469                         この色は3要素ベクトル<literal>"[red, green, blue]"</literal>
470                         
471                         
472                         
473                         (各要素の範囲は[0, 1])により定義されます.
474                         
475                         
476                         
477                     </para>
478                     
479                     
480                     
481                     <para>
482                         
483                         
484                         
485                         デフォルト値は <literal>"[1 1 1]"</literal>です.
486                         
487                         
488                         
489                     </para>
490                     
491                     
492                     
493                 </listitem>
494                 
495                 
496                 
497             </varlistentry>
498             
499             
500             
501         </variablelist>
502         
503         
504         
505     </refsection>
506     
507     
508     
509     <refsection>
510         
511         
512         
513         <title>例</title>
514         
515         
516         
517         <programlisting role="example"><![CDATA[
518
519         // 点光源
520
521         plot3d;l=light();s=gce();
522
523         for i=0:1000
524
525             sleep(5);
526
527             x = 2*cos(i*%pi/180);
528
529             y = 2*sin(i*%pi/180);
530
531             z = 2;
532
533             l.position = [x y z];
534
535         end
536
537
538
539         // 方向性光源に光源を変更
540
541         l.light_type = "directional";
542
543         l.direction = [1 0 1];
544
545         l.ambient_color = [0.1 0.1 0.1];
546
547         s.diffuse_color = [0.4 0.4 0.4];
548
549         s.use_color_material = "off";
550
551         s.color_flag = 0;
552
553         s.thickness = 0;
554
555         s.hiddencolor = -1;
556
557         s.specular_color = [0.6 0.6 0.6];
558
559         sleep(5000);
560
561
562
563         l2 = light(ambient_color=[0 0 0], diffuse_color = [0.8 0.8 1], type="point", position=[0 3 4]);
564
565         sleep(5000);
566
567         delete(l);
568
569         l2.specular_color = [1 0.6 0];
570
571         ]]></programlisting>
572         
573         
574         
575     </refsection>
576     
577     
578     
579     <refsection role="see also">
580         
581         
582         
583         <title>参照</title>
584         
585         
586         
587         <simplelist type="inline">
588             
589             
590             
591             <member>
592                 
593                 
594                 
595                 <link linkend="lighting">照明</link>
596                 
597                 
598                 
599             </member>
600             
601             
602             
603             <member>
604                 
605                 
606                 
607                 <link linkend="light">light</link>
608                 
609                 
610                 
611             </member>
612             
613             
614             
615             <member>
616                 
617                 
618                 
619                 <link linkend="delete">delete</link>
620                 
621                 
622                 
623             </member>
624             
625             
626             
627         </simplelist>
628         
629         
630         
631     </refsection>
632     
633     
634     
635 </refentry>
636
637
638