Appearance
light
LightsController
环境光 均匀照亮整个场景 半球光 天空颜色和地板颜色之间的渐变光，照亮整个场景 定向光 相互平行的太阳光线，无论位置如何，都具有无限范围 点光源 无限小灯笼，从其位置向各个方向照明 聚光灯 手电筒，锥形从亮到暗 矩形区域光 摄影棚灯 性能成本 AmbientLight < HemisphereLight < DirectionalLight < PointLight < SpotLight < RectAreaLight
Kind: global class
new LightsController(opts)
光源调节
| Param | Type | Description |
|---|---|---|
| opts | object | 光源调节参数 |
| opts.viewer | ftthree.Scene | 场景 |
| opts.data | Array | 灯光数组 |
lightsController.addHemisphereLight(skyColor, groundColor, intensity)
半球光 天空颜色和地板颜色之间的渐变光，照亮整个场景
Kind: instance method of LightsController
| Param | Type | Description |
|---|---|---|
| skyColor | string | 天空颜色 |
| groundColor | string | 地板颜色 |
| intensity | number | 强度 |
lightsController.addAmientLight(options)
环境光 均匀照亮整个场景
Kind: instance method of LightsController
| Param | Type | Description |
|---|---|---|
| options | object | 环境光参数 |
| options.visible | boolean | 是否开启 |
| options.intensity | number | 强度 |
| options.color | number | 环境光颜色 |
| options.tabsName | string | BI 环境光名称 |
lightsController.addSpotLight(opts)
添加聚光灯 手电筒，锥形从亮到暗
Kind: instance method of LightsController
| Param | Type | Description |
|---|---|---|
| opts | object | 聚光灯 |
| opts.name | string | 灯名称 |
| opts.tabsName | string | BI 灯名称 |
| opts.color | string | 颜色 |
| opts.intensity | number | 强度 |
| opts.position | Array | 位置 |
| opts.isCastShadow | boolean | 是否接受阴影 |
| opts.distance | number | 光线从亮到暗的范围 |
| opts.isHelper | boolean | 是否开启灯光辅助 |
| opts.normalBias | number | 法线阴影偏移 |
| opts.bias | number | 阴影偏移 |
| opts.target | Array | 目标位置 |
| opts.mapSize | number | 阴影质量，默认 4096 |
| opts.angle | number | 平面，光锥末端的宽度，以弧度为单位 |
| opts.radius | number | 阴影半径 |
| opts.focus | number | -聚焦程度 |
| opts.decay | number | 灯光衰减程度 |
lightsController.getLightShadowMapSize(mapSize)
获取 BI mapSize
Kind: instance method of LightsController
| Param | Type | Description |
|---|---|---|
| mapSize | ||
| opts.mapSize | number | string | Array | 阴影质量 |
lightsController.addPointLight(opts)
添加点光源 无限小灯笼，从其位置向各个方向照明
Kind: instance method of LightsController
| Param | Type | Description |
|---|---|---|
| opts | object | 点光源参数 |
| opts.name | string | 灯名称 |
| opts.tabsName | string | BI 灯名称 |
| opts.color | string | 颜色 |
| opts.intensity | number | 强度 |
| opts.position | Array | 位置 |
| opts.isCastShadow | boolean | 是否接受阴影 |
| opts.distance | number | 光线从亮到暗的范围 |
| opts.isHelper | boolean | 是否开启灯光辅助 |
| opts.mapSize | number | string | Array | 阴影质量 |
| opts.normalBias | number | 法线阴影偏移 |
| opts.bias | number | 阴影偏移 |
| opts.radius | number | 阴影半径 |
| opts.isFllowCamera | boolean | 是否跟随相机,默认为 false |
lightsController.addSunLight(param0)
主光源
Kind: instance method of LightsController
| Param | Type | Description |
|---|---|---|
| param0 | number | 主光源参数 |
| param0.name | number | 主光源名称 |
| param0.tabsName | number | BI 主光源名称 |
| param0.intensity | number | -主光源强度 |
| param0.color | number | 主光源颜色 |
| param0.isCastShadow | number | 是否投射阴影 |
| param0.isHelper | number | 是否开启辅助线开关 |
| param0.near | number | 阴影近平面 |
| param0.far | number | 阴影远平面 |
| param0.bias | number | 主光源阴影偏移 |
| param0.definition | number | 主光源阴影清晰度 2048 默认 |
| param0.scope | number | 主光源阴影范围 默认 2048 |
| param0.position | Array | 主光源坐标数组 |
| param0.target | Array | 目标位置 |
| param0.mapSize | Array | string | 阴影贴图尺寸 |
| param0.radius | number | 阴影半径 |
| param0.focus | number | 阴影采样参数 |
lightsController.lensFlareSW(param0)
太阳光晕
Kind: instance method of LightsController
| Param | Type | Description |
|---|---|---|
| param0 | object | 太阳光晕 |
| param0.isLensflare | boolean | 太阳光晕开关 |
| param0.lensDistance | number | 太阳光晕距离 |
lightsController.addVolumeLight(opts)
体积点光源
Kind: instance method of LightsController
| Param | Type | Description |
|---|---|---|
| opts | object | 参数 |
| opts.color | string | 颜色 |
| opts.intensity | number | 强度 |
| opts.distance | number | 距离 |
| opts.position | Array | 坐标 |
| opts.rotation | Array | 旋转 |