リファレンス directionalLight()

directionalLight()

一方向に光を放つライトを作成します。

指向性ライトは特定の点から光を放つわけではありません。画面外のどこかから照らす太陽のようなものです。ライトの方向は、-1から1の間の3つの(x, y, z)値を使って設定されます。例えば、ライトの方向を(1, 0, 0)に設定すると、ライトが右方向を向いているため、p5.Geometryオブジェクトは左側から照らされます。

directionalLight()を呼び出す際、ライトの色と方向を設定するパラメータには4つの方法があります。

directionalLight()を呼び出す最初の方法は6つのパラメータを使用します。最初の3つのパラメータ、v1v2v3は、現在のcolorMode()を使用してライトの色を設定します。残りの3つのパラメータ、xyzは、ライトの方向を設定します。例えば、directionalLight(255, 0, 0, 1, 0, 0)は、赤色(255, 0, 0)で右方向(1, 0, 0)に光を放つライトを作成します。

directionalLight()を呼び出す2つ目の方法は4つのパラメータを使用します。最初の3つのパラメータ、v1v2v3は、現在のcolorMode()を使用してライトの色を設定します。最後のパラメータ、directionは、p5.Geometryオブジェクトを使用してライトの方向を設定します。例えば、directionalLight(255, 0, 0, lightDir)は、赤色(255, 0, 0)lightDirベクトルが指す方向に光を放つライトを作成します。

directionalLight()を呼び出す3つ目の方法は4つのパラメータを使用します。最初のパラメータ、colorは、p5.Colorオブジェクトまたは色の値の配列を使用してライトの色を設定します。残りの3つのパラメータ、xyzは、ライトの方向を設定します。例えば、directionalLight(myColor, 1, 0, 0)は、myColorの色値で右方向(1, 0, 0)に光を放つライトを作成します。

directionalLight()を呼び出す4つ目の方法は2つのパラメータを使用します。最初のパラメータ、colorは、p5.Colorオブジェクトまたは色の値の配列を使用してライトの色を設定します。2つ目のパラメータ、directionは、p5.Colorオブジェクトを使用してライトの方向を設定します。例えば、directionalLight(myColor, lightDir)は、myColorの色値でlightDirベクトルが指す方向に光を放つライトを作成します。

実例

シンタックス

directionalLight(v1, v2, v3, x, y, z)
directionalLight(v1, v2, v3, direction)
directionalLight(color, x, y, z)
directionalLight(color, direction)

パラメーター

v1
Number:

現在のcolorMode()での赤または色相の値。

v2
Number:

現在のcolorMode()での緑または彩度の値。

v3
Number:

現在のcolorMode()での青、明度、または輝度の値。

x
Number:

ライトの方向のx成分(-1から1の間)。

y
Number:

ライトの方向のy成分(-1から1の間)。

z
Number:

ライトの方向のz成分(-1から1の間)。

direction
p5.Vector:

p5.Vectorオブジェクトとしてのライトの方向。

color
p5.Color|Number[]|String:

p5.Colorオブジェクト、色の値の配列、またはCSS文字列としての色。

Notice any errors or typos? Please let us know. Please feel free to edit src/webgl/light.js and open a pull request!

関連するリファレンス