light 默认插件

该插件用于创建光源，支持三种光源：环境光(AmbientLight) 、 平行光(DirectionalLight) 、 聚光灯(SpotLight) 。环境光会均匀照亮场景中的所有物体，平行光是沿着特定方向发射的光线，聚光灯的光线从一个点沿着一个方向射出，随着距离变远，光线圆锥体的尺寸也逐渐增大。

提示

该插件为默认插件，在 meta 实例化后会自动挂载 两个 该插件，分别是 一个环境光 和 一个平行光 。

• 插件名称

  light

• 初始参数

  • props: DTLight 光源配置参数

    • 参考: DTLight

    • 注: 初始参数可以为空，若传入了初始参数，则会在插件挂载后，立即创建一个光源

• 示例

import { webglPlugin } from "@tslfe/dt-enging"
...省略获取meta实例的步骤...

const lightPlugin = meta.plugin.use(webglPlugin.light({
    type: "SpotLight",
    color: "0xffffff",
    intensity: 0.8
}))

属性

lights

光源数组

• 类型: Light

• 说明: 用于保存该插件创建的所有光源

方法

createLight( )

创建光源

function createLight: (options: DTLight) => Light

• 参数

  • options: 光源配置参数

    • 参考: DTLight

• 返回值

  • light: 光源实例

    • 参考: Light

• 示例

...省略挂载light插件的步骤...

const light1 = lightPlugin.createLight({
    type: "AmbientLight",
    color: "0xffffff",
    intensity: 0.8
});

remove( )

删除指定光源

function remove: (light: Light) => void

• 参数

  • light: 光源实例

    • 参考: Light

• 返回值

  • 无

• 示例

...省略挂载light插件的步骤...

lightPlugin.remove(light1);

clear( )

清除该插件创建的所有光源

function clear: () => void

• 参数

  • 无

• 返回值

  • 无

• 示例

...省略挂载light插件的步骤...

lightPlugin.clear();