Skip to content

开始

什么是cesium2s?

cesium2s是一款用于快速搭建三维场景的js包,它基于cesiumjs构建,并提供了cesiumjs没有提供的一套高级功能,包括交互式绘制、测量、模型编辑等,无论是简单还是复杂的三维场景构建,cesium2s都可以胜任。

快速上手

下面是一个最基本的示例

vue
<template>
   <div
      ref="globe"
      class="globe"
    ></div>
</template>

<script lang="ts">
import { Viewer } from "cesium2s"

export default {
  mounted() {
    this.initGlobe(this.$refs.globe as HTMLElement)
  },
  methods: {
    initGlobe(el: HTMLElement) {
      return new Viewer(el, {
        baseLayer: new Cesium.ImageryLayer(
          new Cesium.UrlTemplateImageryProvider({
            url: 'https://yoururl/{Time}/{z}/{y}/{x}.png'
          })
    	),
      })
    },
  },
}
</script>

<style lang="scss" scoped>
 .globe {
    height: 100%;
    width: 100%;
  }
</style>

结果展示

image-20251023161249725

上面的示例展示了Viewer的最基本能力,通过new Viewer(),并传入绑定的dom,配置底图瓦片资源路径,即可渲染出一个漂亮的三维地球。

初始化配置

使用Cesium2s.Viewer初始化创建地球时,可以传入参数控制初始化行为,在Cesium.Viewer原生配置的基础上,还支持以下配置项:

参数名称默认值参数说明
allowCameraUndergroundfalse允许相机进入地下
asMapboxControlfalse滚轮缩放,右键旋转
lensFlarefalse配置对象或bool类型,控制是否开启透镜眩光后处理