参考 directionalLight()

directionalLight()

创建一个朝单一方向照射的光。

方向光不是从特定点发出的。它们就像一轮太阳,从屏幕外的某个地方照射进来。光的方向由三个介于 -1 和 1 之间的 (x, y, z)<code> 值设置。例如,将光的方向设置为 <code>(1, 0, 0)<code> 将从左侧照亮 <ahref=" reference="" p5="" p5.geometry"="">p5.Geometry 对象,因为光线直接指向右侧。</ahref="></code></code></code>

<code><code> <p>有四种调用 <code>directionalLight()<code> 的方法,用于设置光源的颜色和方向。</code></code></p><code><code> <p>调用 <code>directionalLight()</code> 的第一种方式有六个参数。前三个参数 <code>v1</code>、 <code>v2</code> 和 <code>v3</code> 使用当前的 <a href="/reference/p5/colorMode">colorMode()</a> 来设置光的颜色。最后三个参数 <code>x</code>、 <code>y</code> 和 <code>z</code> 设置光的方向。例如, <code>directionalLight(255, 0, 0, 1, 0, 0)</code> 创建一个红色 <code>(255, 0, 0)</code> 的光,朝向右边 <code>(1, 0, 0)</code>。</p> <p>调用 <code>directionalLight()</code> 的第二种方式有四个参数。前三个参数 <code>v1</code>、 <code>v2</code> 和 <code>v3</code> 使用当前的 <a href="/reference/p5/colorMode">colorMode()</a> 来设置光的颜色。最后一个参数 <code>direction</code> 使用一个 <a href="/reference/p5/p5.Geometry">p5.Geometry</a> 对象来设置光的方向。例如, <code>directionalLight(255, 0, 0, lightDir)</code> 创建一个红色 <code>(255, 0, 0)</code> 的光,其方向是 <code>lightDir</code> 向量所指的方向。</p> <p>调用 <code>directionalLight()</code> 的第三种方式有四个参数。第一个参数 <code>color</code> 使用一个 <ahref=" reference="" p5="" p5.color"="">p5.Color 对象或颜色值数组来设置光的颜色。最后三个参数 <code>x</code>、 <code>y</code> 和 <code>z</code> 设置光的方向。例如, <code>directionalLight(myColor, 1, 0, 0)</code> 创建一个颜色为 <code>myColor</code> 的光,朝向右边 <code>(1, 0, 0)</code>。</ahref="></p> <p>调用 <code>directionalLight()</code> 的第四种方式有两个参数。第一个参数 <code>color</code> 使用一个 <ahref=" reference="" p5="" p5.color"="">p5.Color 对象或颜色值数组来设置光的颜色。第二个参数 <code>direction</code> 使用一个 <ahref=" reference="" p5="" p5.color"="">p5.Color 对象来设置光的方向。例如, <code>directionalLight(myColor, lightDir)</code> 创建一个颜色为 <code>myColor</code> 的光,其方向是 <code>lightDir</code> 向量所指的方向。</ahref="></ahref="></p> </code></code></code></code>

示例

语法

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

参数

v1
数字:

当前 colorMode() 中的红色或色相值。

v2
数字:

当前 colorMode() 中的绿色或饱和度值。

v3
数字:

当前 colorMode() 中的蓝色、亮度或明度值。

x
数字:

光的方向的 x 分量,范围在 -1 到 1 之间。

y
数字:

光的方向的 y 分量,范围在 -1 到 1 之间。

z
数字:

光的方向的 z 分量,范围在 -1 到 1 之间。

direction
p5.Vector:

光的方向作为一个 p5.Vector 的对象。

color
p5.Color|数字[]|字符串:

颜色作为一个 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!

相关参考