Skip to content

Interface: LightsManager

Defined in: packages/viewer-core/src/public/managers/LightsManager.ts:15

灯光 manager。

职责域:移除内置默认灯光(removeDefaults)、添加用户自定义灯光 (addAmbient / addDirectional / addPoint,返回 LightHandle)、 按句柄移除(remove)或全部清空(clearUserLights)。

Remarks

经 Viewer 实例上的 viewer.lights 访问,不要直接构造。

Methods

addAmbient()

addAmbient(opts?): LightHandle

Defined in: packages/viewer-core/src/public/managers/LightsManager.ts:36

添加环境光(默认白色,强度 0.7),返回可用于 remove() 的句柄。

Parameters

opts?
color?

Color

intensity?

number

Returns

LightHandle


addDirectional()

addDirectional(opts): LightHandle

Defined in: packages/viewer-core/src/public/managers/LightsManager.ts:43

添加平行光,direction 为光照射方向(默认白色,强度 1.0),返回句柄。

Parameters

opts
color?

Color

direction

Vec3

intensity?

number

Returns

LightHandle


addPoint()

addPoint(opts): LightHandle

Defined in: packages/viewer-core/src/public/managers/LightsManager.ts:51

添加点光源,range 为衰减距离(0 = 不限,默认 0;默认白色,强度 1.0),返回句柄。

Parameters

opts
color?

Color

intensity?

number

position

Vec3

range?

number

Returns

LightHandle


clearUserLights()

clearUserLights(): void

Defined in: packages/viewer-core/src/public/managers/LightsManager.ts:68

移除全部用户添加的灯光(不影响默认灯光组)。

Returns

void


remove()

remove(handle): void

Defined in: packages/viewer-core/src/public/managers/LightsManager.ts:59

按句柄移除一盏用户灯光;句柄无效时静默返回。

Parameters

handle

LightHandle

Returns

void


removeDefaults()

removeDefaults(): void

Defined in: packages/viewer-core/src/public/managers/LightsManager.ts:29

移除 Viewer 创建时内置的默认灯光组(不影响用户添加的灯光)。

Returns

void