首页 / deck.gl / API 文档

OrbitView

先看结论

围绕一个中心点旋转的三维视图，适合点云、模型与抽象数据。

最后验证 2026-11-03 · deck.gl 9.0 · 更新 2026-10-27 · 引用本文

new deck.OrbitView(props)

视角参数

参数	默认	说明
`target`	`[0, 0, 0]`	旋转中心
`rotationX`	`0`	俯仰角，正数向下看
`rotationOrbit`	`0`	绕竖轴旋转角
`zoom`	`0`	缩放级别，每级对应两倍
`minZoom` / `maxZoom`	`-1` / `10`	缩放区间
`orthographic`	`false`	正交投影，无近大远小
`fovy`	`50`	透视投影的视场角

坐标约定

OrbitView 使用笛卡尔坐标，单位由数据自己决定。配合 coordinateSystem: deck.COORDINATE_SYSTEM.CARTESIAN 的图层使用，不要传经纬度，否则所有点会挤在同一个位置。

new deck.Deck({
  views: new deck.OrbitView({ target: [0, 0, 0], rotationX: 25 }),
  initialViewState: {
    target: [0, 0, 0],
    rotationX: 25,
    rotationOrbit: -30,
    zoom: 1
  },
  layers: [
    new deck.PointCloudLayer({
      data: points,
      coordinateSystem: deck.COORDINATE_SYSTEM.CARTESIAN,
      getPosition: function (d) { return d.pos; }
    })
  ]
});

视角与光照

轨道视图里相机位置持续变化，固定方向的光照会让背面发黑。需要均匀亮度时提高 material.ambient，或用 parameters 关掉光照计算。

正交投影更适合尺寸对比。透视投影下达标的柱体会因为离相机近而显得更高，读图时容易误判。

引用本文

经纬志（2026）。《OrbitView》。https://www.jingweizhi.com/deckgl/api/orbit-view.html（访问日期 2026-11-03）。