<?xml version="1.0" encoding="UTF-8"?>

<!--

 * Scilab ( https://www.scilab.org/ ) - This file is part of Scilab

 * Copyright (C) Pedro SOUZA

 *


 * Copyright (C) 2012 - 2016 - Scilab Enterprises
 *
 * This file is hereby licensed under the terms of the GNU GPL v2.0,
 * pursuant to article 5.3.4 of the CeCILL v.2.1.
 * This file was originally licensed under the terms of the CeCILL v2.1,
 * and continues to be available under such terms.
 * For more information, see the COPYING file which you should have received
 * along with this program.

 *

 -->

<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">

    <refnamediv>

        <refname>lighting</refname>

        <refpurpose>照明の概要</refpurpose>

    </refnamediv>

    <refsection>

        <title>説明</title>

        <para>

            scilabにおける照明は実世界の照明を近似するもので,

            曲面の外観は光線と曲面の物質特性の相互関係により指定されます.

        </para>

        <para>

            実世界の光源を模擬することは複雑で計算負荷が高いため,

            簡易的なモデルを使用します.

        </para>

        <para>

            光源は主にその色で表されます: アンビエント, 拡散, 鏡面反射.

            <link linkend="light">light</link> 関数により作成でき,

            <link linkend="delete">delete</link> 関数により削除されます.

        </para>

        <para>

            曲面の物性は色(アンビエント, 拡散および鏡面反射)と輝度によっても表されます.

        </para>

        <para>

            曲面は,拡散色として曲面の色を有効にする

            <literal>color_material</literal>プロパティを有します.

        </para>

        <para>

            最終的な曲面の色は,曲面と光源色の積に適用される光線モデル方程式により

            指定されます.以下に光線モデル方程式を示します:

        </para>

        <scilab:image>
            
            set(gca(), "font_style", 1, "font_size", 4);
            
            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}}$');

            f=gcf();

            f.figure_size = [750,280];

        </scilab:image>

        <listitem>

            <para>

                アンビエント色は,曲面に間接的にさした光をモデル化するもので,

                面の法線または光の方向に依存しません.

            </para>

        </listitem>

        <listitem>

            <para>

                拡散色は直接さす光をモデル化するもので,

                光線方向および面の法線に依存します.

            </para>

        </listitem>

        <listitem>

            <para>

                鏡面反射色は鏡面反射ハイライト色を定義します.

            </para>

        </listitem>

        <para>

            以下に照明のあるまたはない面を比較します:

        </para>

        <para>

            <scilab:image>

                plot3d();

                l = light();

            </scilab:image>

        </para>

        <para>

            <scilab:image>

                plot3d();

            </scilab:image>

        </para>

    </refsection>

    <refsection>

        <title>光源プロパティのリスト</title>

        <variablelist>

            <varlistentry>

                <term>kightプロパティ</term>

                <listitem>

                    <variablelist>

                        <varlistentry>

                            <term>visible: </term>

                            <listitem>

                                <para>

                                    このフィールドは光の有効(<literal>"on"</literal>)または

                                    無効(<literal>"off"</literal>)を定義します.

                                </para>

                            </listitem>

                        </varlistentry>

                        <varlistentry>

                            <term>light_type: </term>

                            <listitem>

                                <para>

                                    このフィールドは使用される光の型を定義します.

                                    以下の2種類の光を利用できます:

                                    <literal>"directional"</literal> および <literal>"point"</literal>.

                                    方向性(directional)光源は,曲面から無限遠に位置する光源で,平行線となります.

                                </para>

                                <para>

                                    点光源は,全ての方向に放射する空間の点として

                                    定義されます.

                                    デフォルト値は <literal>"point"</literal>です.

                                </para>

                            </listitem>

                        </varlistentry>

                        <varlistentry>

                            <term>direction: </term>

                            <listitem>

                                <para>

                                    このフィールドは方向性光源の光線方向を定義します.

                                    方向は,原点からのベクトルを表す

                                    3要素ベクトル<literal>"[x, y, z]"</literal>により変更できます.

                                </para>

                                <para>

                                    デフォルト値は <literal>"[0 0 1]"</literal>です.

                                </para>

                            </listitem>

                        </varlistentry>

                        <varlistentry>

                            <term>position: </term>

                            <listitem>

                                <para>

                                    このフィールドは,点光源の光源位置を定義します.

                                    位置は3要素ベクトル<literal>"[x, y, z]"</literal>により変更できます.

                                </para>

                                <para>

                                    デフォルト値は<literal>"[0 0 1]"</literal>です.

                                </para>

                            </listitem>

                        </varlistentry>

                        <varlistentry>

                            <term>ambient_color: </term>

                            <listitem>

                                <para>

                                    このフィールドは光源のアンビエント色を定義します.

                                    この色は3要素ベクトル<literal>"[red, green, blue]"</literal>

                                    (各要素の範囲は[0, 1])により定義されます.

                                </para>

                                <para>

                                    デフォルト値は<literal>"[0.1 0.1 0.1]"</literal>です.

                                </para>

                            </listitem>

                        </varlistentry>

                        <varlistentry>

                            <term>diffuse_color: </term>

                            <listitem>

                                <para>

                                    このフィールドは光源の拡散色を定義します.

                                    この色は3要素ベクトル<literal>"[red, green, blue]"</literal>

                                    (各要素の範囲は[0, 1])により定義されます.

                                </para>

                                <para>

                                    デフォルト値は<literal>"[1 1 1]"</literal>です.

                                </para>

                            </listitem>

                        </varlistentry>

                        <varlistentry>

                            <term>specular_color: </term>

                            <listitem>

                                <para>

                                    このフィールドは光源の鏡面反射色を定義します.

                                    この色は3要素ベクトル<literal>"[red, green, blue]"</literal>

                                    (各要素の範囲は[0, 1])により定義されます.

                                </para>

                                <para>

                                    デフォルト値は <literal>"[1 1 1]"</literal>です.

                                </para>

                            </listitem>

                        </varlistentry>

                    </variablelist>

                </listitem>

            </varlistentry>



            <varlistentry>

                <term>曲面のプロパティ</term>

                <listitem>

                    <variablelist>

                        <varlistentry>

                            <term>use_color_material: </term>

                            <listitem>

                                <para>

                                    このフィールドは曲面の色を拡散色として使用することを有効にします.

                                    デフォルト値は<literal>"on"</literal>です.

                                </para>

                            </listitem>

                        </varlistentry>

                        <varlistentry>

                            <term>material_shininess: </term>

                            <listitem>

                                <para>

                                    このフィールドは曲面の輝度を定義します.

                                    このパラメータは曲面内で散らばる輝度色を制御します.

                                    正の値を使用できます.

                                </para>

                                <para>

                                    [0 10]の範囲の値を使用すると良く, 小さい値は強いハイライト,

                                    大きな値はわずかに認識できるハイライトを生成します.

                                    デフォルト値は<literal>"2"</literal>です.

                                </para>

                            </listitem>

                        </varlistentry>

                        <varlistentry>

                            <term>ambient_color: </term>

                            <listitem>

                                <para>

                                    このフィールドは光源のアンビエント色を定義します.

                                    この色は3要素ベクトル<literal>"[red, green, blue]"</literal>

                                    (各要素の範囲は[0, 1])により定義されます.

                                </para>

                                <para>

                                    デフォルト値は<literal>"[1 1 1]"</literal>です.

                                </para>

                            </listitem>

                        </varlistentry>

                        <varlistentry>

                            <term>diffuse_color: </term>

                            <listitem>

                                <para>

                                    このフィールドは光源の拡散色を定義します.

                                    この色は3要素ベクトル<literal>"[red, green, blue]"</literal>

                                    (各要素の範囲は[0, 1])により定義されます.

                                    このフィールドはuse_color_materialが無効の場合の

                                    使用されることに注意してください.

                                </para>

                                <para>

                                    デフォルト値は<literal>"[1 1 1]"</literal>です.

                                </para>

                            </listitem>

                        </varlistentry>

                        <varlistentry>

                            <term>specular_color: </term>

                            <listitem>

                                <para>

                                    このフィールドは光源の鏡面反射色を定義します.

                                    この色は3要素ベクトル<literal>"[red, green, blue]"</literal>

                                    (各要素の範囲は[0, 1])により定義されます.

                                </para>

                                <para>

                                    デフォルト値は <literal>"[1 1 1]"</literal>です.

                                </para>

                            </listitem>

                        </varlistentry>

                    </variablelist>

                </listitem>

            </varlistentry>

        </variablelist>

    </refsection>

    <refsection>

        <title>例</title>

        <para>

            color_materialなしの点光源:

        </para>

        <programlisting role="example"><![CDATA[

plot3d();

s=gce();

s.color_flag=0;

s.thickness=0;

s.hiddencolor = -1;

light();

//拡散色をオレンジに変更

s.diffuse_color = [1, 0.6, 0];

s.use_color_material="off";

//黒の点を暗いオレンジに変更

s.ambient_color = [1, 0.6, 0];

         ]]></programlisting>

        <para>

            方向性光源:

        </para>

        <programlisting role="example"><![CDATA[

plot3d();

s=gce();

l = light();

s.color_flag=0;

s.thickness=0;

l.light_type = "directional";

l.direction = [0 0 1];

l.diffuse_color = [1 0.9 0.9];

l.ambient_color = [0.5 0.4 0.4];

l.specular_color = [0.5 0.3 0.7];

         ]]></programlisting>

    </refsection>

    <refsection role="see also">

        <title>参照</title>

        <simplelist type="inline">

            <member>

                <link linkend="light">light</link>

            </member>

            <member>

                <link linkend="light_properties">lightプロパティ</link>

            </member>

            <member>

                <link linkend="surface_properties">surfaceプロパティ</link>

            </member>

            <member>

                <link linkend="delete">delete</link>

            </member>

        </simplelist>

    </refsection>

</refentry>

