Interface: RenderQualityManager

Defined in: packages/viewer-core/src/public/managers/RenderQualityManager.ts:18

渲染质量 manager。

职责域:抗锯齿(SMAA 后处理)、环境光遮蔽(GTAO,默认关、须显式开启)、 色调映射与曝光、IBL 环境强度 / HDRI 环境贴图,以及质量档(QualityTier) 切换。典型入口:setTier("high") 锁定质量档,或保持默认 "auto" 由帧时自适应调档。

Remarks

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

Methods

setAmbientOcclusion()

setAmbientOcclusion(opts): void

Defined in: packages/viewer-core/src/public/managers/RenderQualityManager.ts:39

设置环境光遮蔽(GTAO):开关 / 采样半径 / 强度。默认关(GTAO 是每帧 开销最大的 pass),需要时经本方法显式开启;显式关闭后自适应调档不会再开它。

Parameters

opts

enabled?

boolean

intensity?

number

radius?

number

Returns

void

---

setAntialias()

setAntialias(enabled): void

Defined in: packages/viewer-core/src/public/managers/RenderQualityManager.ts:30

开关 SMAA 后处理抗锯齿(运行时可变;区别于构造期的硬件 MSAA ViewerOptions.antialias)。

Parameters

enabled

boolean

Returns

void

---

setEnvironment()

setEnvironment(url): Promise<void>

Defined in: packages/viewer-core/src/public/managers/RenderQualityManager.ts:61

加载 HDRI(.hdr equirect URL)作为 IBL 环境,替换默认程序化环境;返回加载完成 Promise。

Parameters

url

string

Returns

Promise<void>

---

setEnvironmentIntensity()

setEnvironmentIntensity(x): void

Defined in: packages/viewer-core/src/public/managers/RenderQualityManager.ts:55

设置 IBL 环境光强度(乘到环境贴图上)。

Parameters

x

number

Returns

void

---

setShadingStyle()

setShadingStyle(style): void

Defined in: packages/viewer-core/src/public/managers/RenderQualityManager.ts:76

设置着色风格:"matte"(默认,哑光技术视图,对标 HOOPS——高面间对比、清晰) 或 "showcase"(光泽金属 PBR)。立即作用于当前已加载模型,并影响后续加载。

Parameters

style

ShadingStyle

Returns

void

---

setTier()

setTier(tier): void

Defined in: packages/viewer-core/src/public/managers/RenderQualityManager.ts:67

设置质量档("auto" / "high" / "balanced" / "performance")。auto 时由帧时 EMA 自适应调档,显式档关闭自适应。

Parameters

tier

QualityTier

Returns

void

---

setToneMapping()

setToneMapping(mode, exposure?): void

Defined in: packages/viewer-core/src/public/managers/RenderQualityManager.ts:48

设置色调映射模式与可选曝光。"none" / "linear" = 色彩精确模式(关闭 filmic 压缩)。

Parameters

mode

ToneMappingMode

exposure?

number

Returns

void