LCCObject::setMaxNodeSplats
设置节点最大高斯椭球数量。
SDK 会根据该值自动调整 LOD 进行适应。在低性能平台可以设置较小值以便流畅渲染。
版本要求
SDK v0.5.0+
引擎支持
Three.js / CesiumJS
API
LCCObject::setMaxNodeSplats(value: number): void
参数
| 参数 | 类型 | 必选 | 默认值 | 描述 |
|---|---|---|---|---|
value | number | 是 | - | 节点最大高斯椭球数量，例如 1500000。 |
返回值
void
使用示例
lccObject.setMaxNodeSplats(1500000);
注意事项
- 此接口可以在
LCCRender.load()后立即同步调用。 - 该接口仅适用于 LCC 格式，加载 LCC2 格式时会忽略该配置。
- 注意区别：
setMaxSplats()用于设置全局最大渲染点数预算，实际渲染的 Gaussian Splats 总数不会超过该限制。setMaxNodeSplats()用于设置单个节点的最大点数预算。由于 LCC 格式采用分块（Tile）结构，设置setMaxNodeSplats()可以避免单个节点包含过多的 Gaussian Splats，否则可能影响整体的渲染质量和清晰度。
相关 API
LCCObject::setMaxSplats()LCCObject::setMaxDistance()