Skip to content

Interface: ViewerOptions

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

Viewer.create() 的构造选项;全部可选。

Properties

antialias?

optional antialias?: boolean

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

硬件 MSAA(传给 WebGLRenderer,构造后不可变,默认 true)。SMAA 后处理抗锯齿见 quality.antialias


background?

optional background?: Color | "transparent"

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

初始背景:纯色或 "transparent";不传则用引擎默认浅灰垂直渐变。


debug?

optional debug?: boolean

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

调试开关;当前版本未接线,预留。


environment?

optional environment?: string

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

可选 HDRI 环境贴图 URL(.hdr equirect),用于 IBL;不传则用内置程序化环境。


initialCamera?

optional initialCamera?: object

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

初始相机位姿(位置 / 目标点);不传用引擎默认位姿。

position?

optional position?: Vec3

target?

optional target?: Vec3


optional navCube?: object

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

导航立方体初始配置:enabled 默认 true,anchor 默认 "top-right",size 为 CSS 像素、默认 185。

anchor?

optional anchor?: NavCubeAnchor

enabled?

optional enabled?: boolean

size?

optional size?: number


pixelRatio?

optional pixelRatio?: number

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

渲染像素比;默认取 window.devicePixelRatio(非浏览器环境为 1)。


quality?

optional quality?: QualityOptions

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

渲染质量选项,逐项默认值见 QualityOptions


workerPoolSize?

optional workerPoolSize?: number

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

几何解码 worker 池大小;默认按 CPU 核数减一,钳制在 1–4。