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匹配则说明选中。
网友评论