Interface: QualityOptions

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

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

Properties

ambientOcclusion?

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

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

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

---

antialias?

optional antialias?: boolean

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

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:436

IBL 环境光强度,默认 0.2(IBL 仅作暗部兜底,主光是 camera-space 头灯;调高会抹掉面间明暗对比)。

---

shadingStyle?

optional shadingStyle?: ShadingStyle

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

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

---

tier?

optional tier?: QualityTier

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

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

---

toneMapping?

optional toneMapping?: ToneMappingMode

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

色调映射模式,默认 "none"(色彩精确:ACES 会去饱和并偏色,CAD 场景优先保真;需要电影感时显式设 "aces")。

---

toneMappingExposure?

optional toneMappingExposure?: number

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

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