Cesium中Entity讲解

1、查看第一个例子:

  viewer.entities.add({
       position : Cesium.Cartesian3.fromDegrees(-75.59777, 40.03883),
       point : {
           pixelSize : 10,
           color : Cesium.Color.YELLOW
       }
   });

可以看到entity通过viewer中的entities加载到场景中,entities是entity的集合对象。这是一个最简单的示例,在场景中加一个点,可以看到需要以下属性:
position :点在场景中位置
point:指明该entity对象为point类型,其中大小为10、颜色为黄色。

2、Entity官方文档

在帮助文档中查看entity,可以看到entity的属性:id、name、availability、show、description、position、orientation、viewFrom、parent等其他表示entity类型。


image.png

image.png

3、深入了解下entity接口,例如材质、填充、边框、贴图、垂直拉伸、场景中entity管理、选择等。

1 材质

空间对象可视化,不仅需要知道对象的空间位置,还需要知道对象的显示样式。显示样式就是通过材质来控制,比如说颜色、透明度、纹理贴图、更高级的光照等等。我们常用到就是颜色和透明度。
以下代码为绘制一个半透明的红色椭圆,设置material为Cesium.Color.RED.withAlpha(0.5)透明度为0.5的红色:

   viewer.entities.add({
       position:Cesium.Cartesian3.fromDegrees(103.0, 40.0),
       name:'Red ellipse on surface with outline',
       ellipse:{
           semiMinorAxis:250000.0,
           semiMajorAxis:400000.0,
           material:Cesium.Color.RED.withAlpha(0.5),
       }
   });

效果:


image.png
2 填充和边框

填充和边框共同组成了面状对象的样式,通过制定属性fill(默认为true)和outline(默认为false)来确定是否显示填充和边框,material对应填充样式,outlineColor和outlineWidth对应边框的颜色和宽度。如下内容绘制一个填充半透明红色边框为蓝色的椭圆:

    viewer.entities.add({
        position:Cesium.Cartesian3.fromDegrees(103.0, 40.0),
        name:'Red ellipse on surface with outline',
        ellipse:{
            semiMinorAxis:300000.0,
            semiMajorAxis:300000.0,
            height:200000.0,
            fill:true,
            material:Cesium.Color.RED.withAlpha(0.5),
            outline:true, //必须设置height,否则ouline无法显示
            outlineColor:Cesium.Color.BLUE.withAlpha(0.5),
            outlineWidth:10.0//不能设置,固定为1
        }
    });

效果:


image.png
3 贴图

通过设置material为图片url,可以将图片填充到对象中:

      viewer.entities.add({
           position:Cesium.Cartesian3.fromDegrees(103.0, 40.0),
           name:'Red ellipse on surface with outline',
           ellipse:{
               semiMinorAxis:250000.0,
               semiMajorAxis:400000.0,
               height:200000.0,
               fill:true,
               material:"./sampledata/images/globe.jpg",
               outline:true, //必须设置height,否则ouline无法显示
               outlineColor:Cesium.Color.BLUE.withAlpha(0.5),
               outlineWidth:10.0//windows系统下不能设置固定为1
           }
       });

效果:


image.png
4 垂直拉伸

有时候我们需要将面在垂直方向进行拉伸形成体,通过extrudedHeight即可实现这种效果,形成的体积任然符合它拉伸面的地球曲率。

      viewer.entities.add({
            position:Cesium.Cartesian3.fromDegrees(103.0, 40.0),
            name:'Red ellipse on surface with outline',
            ellipse:{
                semiMinorAxis:250000.0,
                semiMajorAxis:400000.0,
                height:200000.0,
                extrudedHeight:400000.0,
                fill:true,
                material:Cesium.Color.RED.withAlpha(0.5),
                outline:true, //必须设置height,否则ouline无法显示
                outlineColor:Cesium.Color.BLUE.withAlpha(0.5),
                outlineWidth:10.0//windows系统下不能设置固定为1
            }
        });

效果:


image.png
5 场景中entity管理

viewer.entities属性实际上是一个EntityCollecton对象,是entity的一个集合,提供了add、remove、removeAll等等接口来管理场景中的entity。
查看帮助文档,提供以下接口:

Cesium.EntityCollection.collectionChangedEventCallback(collection,added, removed, changed)
add(entity) → Entity
computeAvailability() → TimeInterval
contains(entity) → Boolean
getById(id) → Entity
getOrCreateEntity(id) → Entity
remove(entity) → Boolean
removeAll()
removeById(id) → Boolean
resumeEvents()
suspendEvents()
6 选择

在多数应用场景中,我们不仅需要绘制出空间对象还需要用鼠标拾取对象,cesium为我们提供了scene.pick接口,如下代码实现坐标左键单击实现对象的拾取:

      viewer.entities.add({
            id:'obj_id_110',
            position:Cesium.Cartesian3.fromDegrees(103.0, 40.0),
            name:'Red ellipse on surface with outline',
            ellipse:{
                semiMinorAxis:250000.0,
                semiMajorAxis:400000.0,
                height:200000.0,
                extrudedHeight:400000.0,
                fill:true,
                material:Cesium.Color.RED.withAlpha(0.5),
                outline:true, //必须设置height,否则ouline无法显示
                outlineColor:Cesium.Color.BLUE.withAlpha(0.5),
                outlineWidth:10.0//windows系统下不能设置固定为1
            }
        });
 
        varhandler = new Cesium.ScreenSpaceEventHandler(viewer.scene.canvas);
        handler.setInputAction(function(movement) {
            varpick = viewer.scene.pick(movement.position);
            if(Cesium.defined(pick) && (pick.id.id === 'obj_id_110')) {
                alert('picked!');
            }
        },Cesium.ScreenSpaceEventType.LEFT_CLICK);

以上代码,在添加的entity中加入id唯一标识,然后利用ScreenSpaceEventHandler接口监听鼠标事件,在左键单击事件中,通过viewer.scene.pick获取点击出的对象,如果对象不为空且id匹配则说明选中。


你可能感兴趣的:(Cesium中Entity讲解)