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类型。
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),
}
});
效果:
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
}
});
效果:
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
}
});
效果:
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
}
});
效果:
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匹配则说明选中。