LCCObject::useShcoef

开启或关闭球谐渲染。

首次开启球谐数据会有一段加载时间。如需一开始就采用球谐渲染，可以在模型加载后立即同步调用。

版本要求

SDK v0.2.0+

引擎支持

Three.js / CesiumJS

API

LCCObject::useShcoef(value: boolean, loadingCallback?: Function): void

参数

参数	类型	必选	默认值	描述
`value`	`boolean`	是	-	`true` 开启球谐渲染，`false` 关闭球谐渲染。
`loadingCallback`	`Function`	否	-	球谐数据加载进度回调，参数为加载百分比（0~1）。

返回值

void

使用示例

// Enable spherical harmonics rendering
lccObject.useShcoef(true, (percent) => {
    console.log('loading ' + (percent * 100).toFixed(1) + '%');
});

// Disable spherical harmonics rendering
lccObject.useShcoef(false);

注意事项

此接口可以在 LCCRender.load() 后立即同步调用。
首次开启球谐渲染需要加载额外数据，可能需要一定时间。
开启球谐渲染可以提升 LCC 场景的光影细节，提高渲染质量。