// この見出しの中に以下のIncludeが入らないように、これをインデントする必要があります。

illuminance(position, [axis], [angle], [light_typemask], [lightmask])
{
    // ここのClとLが現在の光源の値/方向に設定されます。

    // 強制的にshadowシェーダをコールするために、以下の関数を使用します:
    // shadow(Cl);
}

shadowシェーダは、明示的にコールしない限りコールされません。しかし、一度shadowシェーダをコールしてしまえば、surfaceシェーダがコールされている間はClの値が変わります。 ビルトインのライティングコール(例えば、diffuse、specular、ambient)のどれかを使うと、shadowシェーダが自動的にコールされます。

軸のデフォルト値は、サーフェス法線です。角度のデフォルト値は、PI/2です。light maskのデフォルト値は、LIGHT_DIFFUSE|LIGHT_SPECULAR(ライトの定義に関しては、shading.hを参照)です。

illuminanceステートメントは、dot(L, axis) > cos(angle)の光源すべてをループします。

illuminanceに文字列/値のペアの引数を追加すれば、名前を付けた値を各ライトのシェーダに渡すことができます。例えば、N変数の値をorgNとして渡すには、以下のように記述します:

illuminance (P, nf, M_PI/2, "orgN", N) {
...
}

ライトのシェーダでは、simport関数によってilluminanceループから値を受け取ることができます。

vector orgN;
simport("orgN", orgN);

simport関数は、値をインポートできれば1を返し、そうでないなら0を返します。つまり、ifステートメントの条件に、この関数を使うことができます。

以下に完全なサンプルを載せます:

surface
exporter()
{
vector nf = frontface(normalize(N), I);
Cf = 0;
illuminance(P, nf, M_PI/2, "orgN", N)
{
Cf += Cl;
}
}

light
importer()
{
vector orgN;
if (!simport("orgN", orgN))
orgN = N;
// 元のNを使用します。
Cl = orgN;
}

illuminanceループ内ではlimport関数によってlightシェーダから値を取得することができます。

lightシェーダは、simport関数によってilluminanceステートメントに渡された“キーワード”の引数を受け取ることができます。

例えば、vectorの変数uvをlightシェーダに送信するには以下のように記述します。

vector uv = set(s, t, 0);
illuminance(P, dir, "uv", uv) { ... }

lightシェーダは、以下の記述によって、uv変数を読むことができます。

vector uv;
if (simport("uv", uv))
printf("Imported: %g from surface\n", uv);

追加文字列引数の"lightexport"の後に、ループ内に割り当てるためのエクスポートされる変数の名前を含んだ文字列引数を指定することができます。

いくつかのシェーダでは、複数のilluminanceループを使って別々のライトの寄与度を定義することができます。 lightexport引数は、異なるループからエクスポートする変数を指定するために、それらの場合で役に立ちます。

lightexportの値は、スペース区切りのリストにワイルドカードのパターンを使うことができます。 例えば、illuminance(pos, dir, "lightexport", "Front*")は、Frontで始まる名前の変数をエクスポートします。

surface
light_export_test(export vector diff=0;
export vector spec=0)
{
vector     nn = normalize(frontface(N, I));
vector     vv = -normalize(I);
vector     clr;

Cf = 0;
// このilluminanceループは、"diff"変数にのみエクスポートします。
illuminance(P, nn, "lightexport", "diff")
{
clr = Cl * diffuseBRDF(normalize(L), nn);
Cf += clr;
diff = clr;
}
// このilluminanceループは、"spec"変数にのみエクスポートします。
illuminance(P, nn, "lightexport", "spec")
{
clr = Cl * specularBRDF(normalize(L), nn, vv, 0.1);
Cf += clr;
spec = clr;
}
}