Cesium Workshop

2019/08/02 17:16
阅读数 58

参考资料:
https://cesiumjs.org/tutorials/Cesium-Workshop/

https://github.com/geoadmin/workshop-cesium3d
https://github.com/AnalyticalGraphicsInc/cesium-workshop

概述

通过该教程,能够大致了解Cesium的功能,包括:

  • 配置1个Cesium viewer
  • 加载各种数据集
  • 创建几何和设置样式
  • 加载3D Tiles
  • 控制相机
  • 添加鼠标交互

1. 设置和准备工作

设置

  • 确认你的浏览器支持Cesium
  • 确认已安装Node.js
  • 下载代码 $ git clone https://github.com/AnalyticalGraphicsInc/cesium-workshop
  • 切换到cesium-workshop根目录
  • 使用node.js服务运行web应用
$ npm install
$ npm start
Cesium development server running locally.  Connect to http://localhost:8080

也可以使用python简易HTTP服务程序运行该web应用:

// Python2
$ python -m SimpleHTTPServer 8080
// Python3
$ python -m http.server 8080

打开浏览器,输入地址: http://localhost:8080
app目录简介:

  • index.html - 主页面. 在本地web server中部署,打开该文件就可以运行示例程序.
  • Source - 包括index.html中引用的App.js, 这是app的代码所在位置.
  • ThirdParty - 第三方库,这里只有CesiumJS库.
  • server.js - 简单node.js 服务器程序,用于运行程序.
  • package.json - node.js 服务器的依赖库.
  • LICENSE - 授权信息,Apache 2.0.
  • .gitignore - git仓库中不包括的文件列表.

CesiumJS与现有JavaScript库和框架兼容,如:

页面结构:

index.html: Cesium widget本身是1个div,关键代码包括:
包含CesiumJS,定义Cesium对象

<script src="ThirdParty/Cesium/Cesium.js"></script> 

也可以在生产环境仅仅包含Cesium的某个模块 ThirdParty/Cesium/Source/ , 以便减少应用大小.
为Cesium Viewer widget创建1个div

<div id="cesiumContainer"></div>

添加app代码:

<script src="Source/App.js"></script> 

在<head>标签中添加html元素样式(使用index.css文件)

<link rel="stylesheet" href="index.css" media="screen"> 

Cesium自带系列CSS,也可以引入

@import url(ThirdParty/Cesium/Widgets/widgets.css);

另外的样式可以用来覆盖Cesium的CSS.

流程

  1. 使用最喜欢的文本编辑器打开Source/App.js并删除内容.
  2. 复制 Source/AppSkeleton.jsSource/App.js.
  3. 确认 cesium-workshop 服务正在运行
  4. 线上web浏览器和切换到localhost:8080.
  5. 修改Source/App.js 并刷新页面

创建viewer

任何Cesium应用的基础都是Viewer, 一个交互的三维球,创建1个viewer并绑定到id 为"cesiumContainer" 的div上.

var viewer = new Cesium.Viewer('cesiumContainer');

默认情况下,场景能够处理鼠标和触控输入事件,如相机控制:

  • 鼠标左键单击和拖动 - 在地球表面移动相机.
  • 鼠标右键单击和拖动 - 放大、缩小(相机拉近或拉远)
  • 鼠标中键滚轮 - 放大、缩小
  • 鼠标中键单击和拖动 - 以地球表面某个点旋转相机

触控事件:

  • 一个手指拖曳- 平移视图(One finger drag - Pan view)
  • 两个手指捏放- 缩放视图(Two finger pinch - Zoom view)
  • 两个手指拖曳,相同方向- 俯仰视图(Two finger drag, same direction - Tilt view)
  • 两个手指拖曳,相反方向- 旋转视图(Two finger drag, opposite direction - Rotate view)

除球外,Viewer还默认提供了一些widget.


 
默认的Cesium Viewer
  1. 地名搜索 : 地名搜索工具,相机飞行到查询地点. 默认使用Bing Maps数据.
  2. 默认视图 : 视图复位,回到默认视图.
  3. 场景模式 : 切换模式3D, 2D 或2.5D (Columbus View).
  4. 基础图层 : 选择影像或地形图层.
  5. 帮助 : 帮助,提供默认相机控制方法.
  6. 动画 : 控制动画播放速度.
  7. 鸣谢 : 显示数据归属.
  8. 时间线 : 指示当前时间,允许用户跳到指定时间.
  9. 全屏 : 全屏.

这些widget的显示可以在创建Viewer时进行配置,详细参数见Viewer文档

var viewer = new Cesium.Viewer('cesiumContainer', {
    scene3DOnly: true, selectionIndicator: false, baseLayerPicker: false }); 

Cesium ion

Cesium ion是一个三维数据切片和存储的平台,这里使用ion平台上存储的Sentinal-2 影像和Cesium World Terrain.
需要访问https://cesium.com/ion/ 注册一个免费账户,并在Access Tokens页面创建访问令牌.
Cesium ion默认提供5GB存储空间.

在创建viewer之前设置访问令牌:

Cesium.Ion.defaultAccessToken = '<YOUR ACCESS TOKEN HERE>';

添加影像图层

Cesium支持影像图层的添加、删除、排序、调整.
每个图层的亮度(brightness)、对比度(contrast)、灰度(gamma)、色相(Hue)、 饱和度(Saturation)都支持动态调整.

Cesium提供影像图层操作的很多方法,包括颜色调整(color adjustment)、图层混合(layer blending)等. 代码示例:

Cesium提供了多个影像图层提供者,包括:

其他内置影像图层提供者

当然,也可以通过实现[ImageryProvider接口 定义新的影像接入方式。以 SingleTileImageryProvider 为例简要介绍:

  • url - 图片的url t. Like many imagery providers, this is the only required property. In other imagery providers this url points to the server or the root url of the service.
  • extent - An optional longitude-latitude rectangle that the image should cover. The default is to cover the entire globe.
  • credit - An optional string crediting the data source, which is displayed on the canvas. Some imagery providers, like BingMapsImageryProvider and ArcGIS Server REST API, get a credit logo or string directly from their service.
  • proxy - An optional proxy to use for requests to the service, which brings us to Cross-Origin Resource Sharing.
  • Tile coordinates - Shows how the globe is divided into tiles in a particular tiling scheme by drawing a border around each tile and labeling it with its level, X, and Y coordinates.

示例 - 使用Ion平台的Sentinel-2影像:

// Remove default base layer
viewer.imageryLayers.remove(viewer.imageryLayers.get(0));
// Add Sentinel-2 imagery
viewer.imageryLayers.addImageryProvider(new Cesium.IonImageryProvider({ assetId : 3954 })); 

示例 - 加载ArcGIS Rest影像,打开Hello_world,使用以下代码更换:

var viewer = new Cesium.Viewer('cesiumContainer', {
    imageryProvider : new Cesium.ArcGisMapServerImageryProvider({ url : '//services.arcgisonline.com/ArcGIS/rest/services/World_Street_Map/MapServer' }), baseLayerPicker : false }); 

示例 - 添加TMS影像

var layers = viewer.scene.imageryLayers;
var blackMarble = layers.addImageryProvider(new Cesium.createTileMapServiceImageryProvider({
    url : '//cesiumjs.org/tilesets/imagery/blackmarble', maximumLevel : 8, credit : 'Black Marble imagery courtesy NASA Earth Observatory' })); //调整影像图层透明度、亮度 blackMarble.alpha = 0.5; // 0.0 is transparent. 1.0 is opaque. blackMarble.brightness = 2.0; // > 1.0 increases brightness. < 1.0 decreases. 

示例 - 添加单个图片(给定角点坐标)

layers.addImageryProvider(new Cesium.SingleTileImageryProvider({ url : '../images/Cesium_Logo_overlay.png', rectangle : Cesium.Rectangle.fromDegrees(-75.0, 28.0, -67.0, 29.75) })); 

完整代码

var viewer = new Cesium.Viewer('cesiumContainer', {
    imageryProvider : new Cesium.ArcGisMapServerImageryProvider({ url : '//services.arcgisonline.com/ArcGIS/rest/services/World_Street_Map/MapServer' }), baseLayerPicker : false }); var layers = viewer.scene.imageryLayers; var blackMarble = layers.addImageryProvider(new Cesium.createTileMapServiceImageryProvider({ url : '//cesiumjs.org/tilesets/imagery/blackmarble', maximumLevel : 8, credit : 'Black Marble imagery courtesy NASA Earth Observatory' })); blackMarble.alpha = 0.5; // 0.0 is transparent. 1.0 is opaque. blackMarble.brightness = 2.0; // > 1.0 increases brightness. < 1.0 decreases. layers.addImageryProvider(new Cesium.SingleTileImageryProvider({ url : '../images/Cesium_Logo_overlay.png', rectangle : Cesium.Rectangle.fromDegrees(-75.0, 28.0, -67.0, 29.75) })); 

添加地形图层



作者:布谷李
链接:https://www.jianshu.com/p/f66caf4cb43f
来源:简书
简书著作权归作者所有,任何形式的转载都请联系作者获得授权并注明出处。

展开阅读全文
打赏
0
0 收藏
分享
加载中
更多评论
打赏
0 评论
0 收藏
0
分享
返回顶部
顶部