Cesium快速上手10-Viewer Entities组合

2024-01-08 17:09:46

Viewer/Entities的作用：

方便创建直观的对象，同时做到性能优化（billboard、point等）
提供一些方便使用的函数：flyTo/zoomTo
赋予Entity对象时间这个属性，对象具备动态特性/Primitive不具备
提供一些UI（homeButton/sceneModePicker/projectionPicker/baseLayerPicker)
大量的快捷方式，camera等未必是好事。。
Datasource模式来加载大规模数据：Geojson
Datasource结构
Entities是一个快捷方式，其实返回的是viewer.dataSourceDisplay.defaultDatasource.entities ;

Entity结构

image.png

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

示例可参考 Geometries

image.png

box示例

http://localhost:8080/Apps/Sandcastle/index.html?src=Box.html&label=Geometries

image.png

box 就是立方体
cylinder 是圆锥圆柱

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

var blueBox = viewer.entities.add({
    name : 'Blue box',
    position: Cesium.Cartesian3.fromDegrees(-114.0, 40.0, 300000.0),
    box : {
        dimensions : new Cesium.Cartesian3(400000.0, 300000.0, 500000.0),
        material : Cesium.Color.BLUE
    }
});

var redBox = viewer.entities.add({
    name : 'Red box with black outline',
    position: Cesium.Cartesian3.fromDegrees(-107.0, 40.0, 300000.0),
    box : {
        dimensions : new Cesium.Cartesian3(400000.0, 300000.0, 500000.0),
        material : Cesium.Color.RED.withAlpha(0.5),
        outline : true,
        outlineColor : Cesium.Color.BLACK
    }
});

var outlineOnly = viewer.entities.add({
    name : 'Yellow box outline',
    position: Cesium.Cartesian3.fromDegrees(-100.0, 40.0, 300000.0),
    box : {
        dimensions : new Cesium.Cartesian3(400000.0, 300000.0, 500000.0),
        fill : false,
        outline : true,
        outlineColor : Cesium.Color.YELLOW
    }
});

viewer.zoomTo(viewer.entities);

圆锥圆柱

http://localhost:8080/Apps/Sandcastle/index.html?src=Cylinders%20and%20Cones.html&label=Geometries

image.png

topRadius = bottomRadius 是圆柱
topRadius=0， bottomRadius 大于0 是圆锥

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

var greenCylinder = viewer.entities.add({
    name : 'Green cylinder with black outline',
    position: Cesium.Cartesian3.fromDegrees(-100.0, 40.0, 200000.0),
    cylinder : {
        length : 400000.0,
        topRadius : 200000.0,
        bottomRadius : 200000.0,
        material : Cesium.Color.GREEN.withAlpha(0.5),
        outline : true,
        outlineColor : Cesium.Color.DARK_GREEN
    }
});

var redCone = viewer.entities.add({
    name : 'Red cone',
    position: Cesium.Cartesian3.fromDegrees(-105.0, 40.0, 200000.0),
    cylinder : {
        length : 400000.0,
        topRadius : 0.0,
        bottomRadius : 200000.0,
        material : Cesium.Color.RED
    }
});

viewer.zoomTo(viewer.entities);

API文档

Entity
Cesium.EntityCollection

对比primitives 与Entity

1. 与primitives 相比，entity 使用更简便。一个entity可能是由多个primitives组合完成的。
1. entity内部实现的时候还是用primitives实现的；entity更高层一点。primitive需要关注更多的细节；
3.单个Primitive只能绑定一个材质Appearance，所有的GeometryInstance都使用这一个Appearance；要更换不同的Appearance，就得用不同的Primitive；初始化时还涉及坐标旋转以使绘制的图形在地图表面显示出来。