Skip to content

Interface: QualityOptions

Defined in: packages/viewer-core/src/public/types.ts:218

构造期渲染质量选项(ViewerOptions.quality);运行时经 viewer.quality 调整。

Properties

ambientOcclusion?

optional ambientOcclusion?: boolean | { enabled?: boolean; intensity?: number; radius?: number; }

Defined in: packages/viewer-core/src/public/types.ts:222

环境光遮蔽(GTAO):布尔或细化参数(radius / intensity)。默认关——GTAO 是每帧开销最大的 pass,需要时显式开启。


antialias?

optional antialias?: boolean

Defined in: packages/viewer-core/src/public/types.ts:220

SMAA 后处理抗锯齿开关(默认 false:SMAA 会把 1px 特征边线羽化变灰;对标 cmvision/HOOPS 改用 MSAA+全 DPR 超采样、不要 SMAA,边线更脆。运行时可经 viewer.quality.setAntialias(true) 开)。区别于顶层 ViewerOptions.antialias(硬件 MSAA,仍在 composer RT 上常开)。


environmentIntensity?

optional environmentIntensity?: number

Defined in: packages/viewer-core/src/public/types.ts:228

IBL 环境光强度,默认 0.5。


shadingStyle?

optional shadingStyle?: ShadingStyle

Defined in: packages/viewer-core/src/public/types.ts:232

着色风格,默认 "matte"(哑光技术视图,对标 HOOPS);"showcase" 为光泽金属。运行时可经 viewer.quality.setShadingStyle 切换。


tier?

optional tier?: QualityTier

Defined in: packages/viewer-core/src/public/types.ts:230

质量档,默认 "auto"(帧时 EMA 自适应)。


toneMapping?

optional toneMapping?: ToneMappingMode

Defined in: packages/viewer-core/src/public/types.ts:224

色调映射模式,默认 "aces"


toneMappingExposure?

optional toneMappingExposure?: number

Defined in: packages/viewer-core/src/public/types.ts:226

色调映射曝光,默认 1.0(原 0.7 偏暗、压低对比;1.0 提亮哑光面、增强暗边线反衬,对标 cmvision)。