Appearance
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?
intensity?
number
Returns
addDirectional()
addDirectional(
opts):LightHandle
Defined in: packages/viewer-core/src/public/managers/LightsManager.ts:43
添加平行光,direction 为光照射方向(默认白色,强度 1.0),返回句柄。
Parameters
opts
color?
direction
intensity?
number
Returns
addPoint()
addPoint(
opts):LightHandle
Defined in: packages/viewer-core/src/public/managers/LightsManager.ts:51
添加点光源,range 为衰减距离(0 = 不限,默认 0;默认白色,强度 1.0),返回句柄。
Parameters
opts
color?
intensity?
number
position
range?
number
Returns
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
Returns
void
removeDefaults()
removeDefaults():
void
Defined in: packages/viewer-core/src/public/managers/LightsManager.ts:29
移除 Viewer 创建时内置的默认灯光组(不影响用户添加的灯光)。
Returns
void