您现在的位置是:首页 > 诗句大全

Cesium入门之五:认识Cesium中的Viewer

作者:往北时间:2024-03-28 09:40:41分类:诗句大全

简介  文章浏览阅读3.8k次,点赞4次,收藏11次。详细介绍了Viewer类的构造函数、成员变量及常用方法_new cesium.viewer

点击全文阅读

Viewer是Cesium中用于显示3D场景的组件。它提供了创建和控制3D场景所需的所有基本功能,包括加载3D模型、添加图像覆盖物、设置相机位置和方向、处理用户输入等。

在创建Viewer时,可以指定要使用的HTML元素(例如canvas),该元素将用于呈现3D场景。一旦创建了Viewer对象,就可以通过调用其方法来添加实体、图像覆盖物和其他元素,并对相机进行操作。

构造函数

new Cesium.Viewer(container, options):是用来创建一个新的 Cesium 视图器(Viewer)实例的构造函数。

它包含两个参数:

container:必需,表示视图器容器元素的ID字符串或HTML元素。options:可选,是一个包含所有初始选项的JavaScript对象,可以控制如何呈现三维场景、哪些数据源可用以及视图控制器的行为等方面。
下面代码在名为“cesiumContainer”的HTML元素中创建一个新的Cesium Viewer
  const viewer = new Cesium.Viewer('cesiumContainer',{    animation:false,//动画小部件    baseLayerPicker:false,//地图图层组件    fullscreenButton:false,//全屏组件    geocoder:false,//地理编码搜索组件    homeButton:false,//首页组件    infoBox:false,//信息框    sceneModePicker:false,//场景模式    selectionIndicator:false,//选取指示器组件    timeline:false,//时间轴    navigationHelpButton:false,//帮助按钮    navigationInstructionsInitiallyVisible:false,   })

成员变量:

animation: Animation实例,表示动画控制器,可以用于控制动画的播放和暂停。baseLayerPicker: BaseLayerPicker实例,用于选择底图图层。bottomContainer: HTMLElement实例,表示Viewer中底部的HTML容器元素。camera: Camera实例,表示当前的相机,可以通过该实例控制相机的位置、姿态等属性。canvas: HTMLCanvasElement实例,表示Viewer中渲染3D场景的Canvas元素。cesiumWidget: CesiumWidget实例,Viewer的基础构建块。clock: Clock实例,表示时钟,可以用于控制时间相关的可视化效果。clockViewModel: ClockViewModel实例,表示时钟视图模型,用于控制时间相关的可视化效果。container: HTMLElement实例,表示Viewer的HTML容器元素。creditContainer: HTMLElement实例,表示Viewer中版权信息的HTML容器元素。dataSourceDisplay: DataSourceDisplay实例,用于显示数据源中的实体。entities: EntityCollection实例,用于管理所有的实体对象。fullscreenButton: FullscreenButton实例,用于全屏显示Viewer的内容。geocoder: Geocoder实例,用于地名搜索和定位。homeButton: HomeButton实例,用于将相机位置和姿态重置为默认值。imageryLayers: ImageryLayerCollection实例,表示图像图层集合,可以添加或删除不同的图层。infoBox: InfoBox实例,用于显示实体的详细信息和属性。navigationHelpButton: NavigationHelpButton实例,用于显示Viewer中的导航帮助信息。postProcessStages: PostProcessStageCollection实例,表示后处理阶段的集合,可以添加或删除不同的后处理效果。projectionPicker: ProjectionPicker实例,用于选择不同的地球投影方式。scene: Scene实例,表示三维场景,包含了所有的3D对象和图层以及相机参数等信息。screenSpaceEventHandler: ScreenSpaceEventHandler实例,用于处理鼠标和触摸事件。selectedEntity: Entity实例,表示当前选中的实体。selectionIndicator: SelectionIndicator实例,用于显示当前选中实体的指示器。shadowMap: ShadowMap实例,用于生成和渲染阴影图。skyBox: SkyBox实例,用于设置天空盒。skyBoxEllipsoid: Cartesian3实例,表示天空盒所在的椭球体。sun: Sun实例,用于控制太阳的位置和光照效果。targetFrameRate: Number类型,表示目标帧率。terrainProvider: TerrainProvider实例,表示当前使用的地形提供程序。terrainShadows: ShadowMode类型,表示地形产生阴影的模式。useDefaultRenderLoop: Boolean类型,表示是否使用默认的渲染循环。useBrowserRecommendedResolution: Boolean类型,表示是否使用浏览器推荐的分辨率。

常用方法:

destroy(): 销毁Viewer实例。flyTo(target, options): 使相机飞行到指定的目标位置,并设置相应的动画效果和参数。forceResize(): 强制刷新Viewer的大小和位置。isDestroyed(): 判断Viewer是否已经销毁。render(): Promise: 渲染3D场景并返回Promise对象,用于异步等待渲染结果。resize(): undefined: 调整Viewer的大小和位置。zoomTo(target, offset): 用于将视图缩放到指定的范围或尺寸的函数,target:定位到的实体、实体集合、数据源等。 offset:偏移量。

Viewer构造函数的初始化选项

animation: 是否显示动画控制面板,默认为true。当启用时,动画小部件会在场景下方展示当前时间和时间轴,可以通过鼠标交互来改变时间。baseLayerPicker: 是否显示底图选择器,默认为true。底图选择器小部件可以让用户在不同的影像图层之间进行选择切换。fullscreenButton: 是否显示全屏按钮,默认为true。全屏按钮允许用户将Viewer切换到全屏模式。vrButton: 是否显示VR按钮,默认为false。(需要支持WebVR才能生效)。当用户在支持WebVR的设备中使用时,可以启用VR模式以获得更加沉浸式的体验。geocoder:控制是否显示地理编码器小部件,默认为true。地理编码器小部件允许用户输入地址或地名来定位场景视角。homeButton: 是否显示回到初始位置按钮,默认为true。Home按钮允许用户重置场景视角到初始状态。infoBox: 是否显示信息框,默认为true。信息框小部件可以展示实体、位置、高程等详细信息。sceneModePicker: 是否显示场景模式选择器,默认为true。场景模式选择器小部件可以让用户在三种场景模式之间进行切换:2D、3D、哥伦布视图。selectionIndicator: 是否显示选择指示器,默认为true。选择指示器可用于显示场景中所选对象的轮廓或边框。timeline: 是否显示时间轴控制面板,默认为true。时间轴小部件可以让用户拖动时间来改变场景的显示。navigationHelpButton: 是否显示导航帮助按钮,默认为true。导航帮助按钮允许用户查看控制场景的快捷键和鼠标操作。navigationInstructionsInitiallyVisible: 导航帮助是否一开始就可见,默认为true。如果设置为false,则需要用户手动点击导航帮助按钮才能查看导航说明。scene3DOnly: 是否仅允许3D场景模式,默认为false。shouldAnimate:是否应该在每一帧之间循环播放场景动画。如果设置为true,则会循环播放动画,否则将保持静态不动。通过设置此属性,可以控制场景动画是否自动播放。clockViewModel: 时钟视图模型,用于配置时间轴和动画控制面板。selectedImageryProviderViewModel: 默认选中的底图提供者视图模型。imageryProviderViewModels: 底图提供者视图模型数组。selectedTerrainProviderViewModel: 默认选中的地形提供者视图模型。terrainProviderViewModels: 地形提供者视图模型数组。imageryProvider: 底图提供者,可以是Cesium.UrlTemplateImageryProviderCesium.WebMapTileServiceImageryProvider等类型。baseLayer:指定在场景中使用的初始图层。默认情况下,这个属性设置为ImageryLayer集合中的第一项,通常是显示卫星影像的底图。可以将自己的ImageryProvider传递给baseLayer属性,从而更改初始图层。此外,如果需要同时显示多个图层,则可以创建一个ImageryLayerCollection,并将多个图层添加到其中,然后将其中一个图层设置为基础图层。terrainProvider: 地形提供者,可以是Cesium.CesiumTerrainProviderCesium.GoogleEarthEnterpriseTerrainProvider等类型。terrain:指定一个地形提供者(TerrainProvider),用于加载和显示场景中的地形数据。默认情况下,Cesium会加载一些全球高程数据,并使用这些数据来生成场景中的地形。如果想要更改或增强地形数据,则可以将自己的地形提供者传递给terrain属性。例如,可以使用ArcGIS Server、Mapbox或OpenTopography等服务,来获取更准确或更详细的地形数据。需要注意的是,使用地形数据会增加场景的复杂性和资源消耗,因此需要谨慎使用。skyBox: 天空盒样式,可以是Cesium.SkyBox或者Cesium.Color类型。skyAtmosphere: 大气层设置,可用于控制大气层渲染效果。fullscreenElement: 全屏元素,默认为undefined,表示使用全局document.documentElement进行全屏。useDefaultRenderLoop: Boolean类型,表示是否使用默认的渲染循环。targetFrameRate: Number类型,表示目标帧率。showRenderLoopErrors: 是否显示渲染循环错误信息,默认为true。useBrowserRecommendedResolution: Boolean类型,表示是否使用浏览器推荐的分辨率。automaticallyTrackDataSourceClocks: 是否自动跟踪数据源时钟,当设置为true时,数据源始终与场景时钟同步,如果数据源没有时钟,则不会跟踪。默认为true。contextOptions: WebGL上下文参数,可以设置antialias、depth、stencil、alpha、premultipliedAlpha等属性。sceneMode: 场景模式,有Cesium.SceneMode.SCENE3DCesium.SceneMode.COLUMBUS_VIEWCesium.SceneMode.SCENE2D三种,默认为SCENE3D。mapProjection: 地图投影方式,可以是Cesium.WebMercatorProjection或者Cesium.GeographicProjection类型,默认为WebMercatorProjection。globe: 地球对象,可以用于控制地球的旋转、缩放和其他属性。orderIndependentTranslucency: 是否启用独立透明度排序,默认为true。creditContainer: 显示数据源的HTML元素,默认为undefined,表示使用内置元素。creditViewport: 显示数据源的矩形区域,默认为undefined,表示使用整个视窗。dataSources: 数据源数组,包括所有可视化实体和图层。shadows: 是否启用阴影渲染,默认为false。terrainShadows: ShadowMode类型,表示地形产生阴影的模式。mapMode2D: 在2D场景模式下是否显示地图,默认为true。projectionPicker: 是否显示投影方式选择器,默认为true。blurActiveElementOnCanvasFocus:控制当用户点击或悬停在Cesium Viewer的画布上时,是否将焦点从当前DOM元素中移出。如果设置为true,则会自动将焦点从当前的DOM元素中移开,以便Cesium Viewer可以接收键盘事件和鼠标事件。
这个属性对于在Web应用程序中使用Cesium Viewer时很有用,因为用户可能需要与其他DOM元素进行交互,例如输入文本或单击按钮。如果不把焦点从当前元素移开,用户将不能使用键盘或鼠标来与Cesium Viewer进行交互。
需要注意的是,默认情况下,此属性被设置为true,因此当用户点击或悬停在Cesium Viewer的画布上时,焦点将会自动从当前的DOM元素中移开。如果您想要保留焦点,请将该属性设置为false。requestRenderMode: 请求渲染模式,有RequestRenderMode.AUTOMATICRequestRenderMode.MANUAL两种,默认为AUTOMATIC。maximumRenderTimeChange: 最大帧率限制,表示相邻两帧之间最多允许刷新的时间差(毫秒),如果超过该值则自动降低帧率。默认为0,表示不限制帧率。depthPlaneEllipsoidOffset:可以指定深度测试平面相对于椭球体表面的偏移量。这个属性通常用于解决多个三维模型重叠时出现的Z-fighting问题,即两个或多个物体处于同一深度位置,导致图像闪烁或不清晰。
通过将depthPlaneEllipsoidOffset设置为一个Cartesian3类型的向量,可以将深度测试平面上移或下移一定距离。需要注意的是,改变深度测试平面的偏移量可能会影响场景中的渲染效果和性能。因此,应该谨慎使用这个属性,并进行必要的测试和优化。
另外,需要注意的是,在Viewer对象中设置depthPlaneEllipsoidOffset属性并不会影响到所有场景中的实体。如果想要对单独的场景实体进行深度测试平面的偏移量设置,需要参考Scene对象的depthPlaneEllipsoidOffset属性。msaaSamples:控制多重采样(Multisample Anti-Aliasing,简称MSAA)的采样数。MSAA是一种抗锯齿技术,可以减少物体边缘出现的锯齿和走样效果,提高渲染图像的质量。
通过将msaaSamples属性设置为一个正整数,您可以指定每个像素采样的次数。默认情况下,这个属性被设置为4,表示每个像素采样4次,以获得更平滑的边缘效果。如果您将这个值设置为0或1,将禁用MSAA,将不会进行多重采样,从而降低了渲染质量。
需要注意的是,增加MSAA采样数会增加GPU的计算负担和内存消耗,可能会影响场景的性能。因此,在使用MSAA时应该谨慎选择采样数,并进行必要的测试和优化。

使用flyTo方法飞行到指定位置

// 定义目标位置和视角  var targetPosition = Cesium.Cartesian3.fromDegrees(-75.62898254394531, 40.02804946899414, 1500);  var heading = Cesium.Math.toRadians(90.0);  var pitch = Cesium.Math.toRadians(-45.0);  var roll = Cesium.Math.toRadians(0.0);  // 相机飞到目标点  viewer.camera.flyTo({    destination: targetPosition,    orientation: {      heading:heading,      pitch:pitch,      roll:roll    },    duration: 3 // 飞行动画时长  });

刷新浏览器,可以看到飞行的过渡效果
在这里插入图片描述
Viewer类是Cesium中非常重要的类,它提供了许多常用的功能,如地形数据加载、影像数据加载、高度测量以及绘制几何图形等,后面会进行介绍,这次先介绍到这里,喜欢的小伙伴点赞关注加收藏哦

点击全文阅读

郑重声明:

本站所有活动均为互联网所得,如有侵权请联系本站删除处理

我来说两句