new Entity(options)
实体实例类,它将多种可视化对象聚合到单个高级对象中。
实体可以手动创建并添加到Viewer#entities中,或由数据源(如CzmlDataSource和GeoJsonDataSource)生成。
| Name | Type | Description | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
options |
Object |
可选
Object 包含以下属性的对象:
|
Members
-
availabilityTimeIntervalCollection
-
对象的可用性。如果可用性未定义,假定该对象的其他属性将在任何时间内返回有效数据。如果存在可用性,对象的其他属性将只在查询给定的时间间隔内提供有效数据。
-
billboardBillboardGraphics
-
获取或设置布告板对象。
-
boxBoxGraphics
-
获取或设置长方体对象。
-
corridorCorridorGraphics
-
获取或设置走廊对象。
-
cylinderCylinderGraphics
-
获取或设置圆柱体对象。
-
readonly definitionChangedEvent
-
获取属性或子属性发生变化修改时触发的事件。
-
descriptionProperty
-
获取或设置实体描述。
-
ellipseEllipseGraphics
-
获取或设置椭圆对象。
-
ellipsoidEllipsoidGraphics
-
获取或设置椭球体对象。
-
entityCollectionEntityCollection
-
获取或设置此实体所属的实体集合。
-
idString
-
获取实体的唯一标识符。
-
isShowingBoolean
-
获取此实体的可见性,此可见性属性考虑了其所属实体集合以及父实体的可见性。
-
labelLabelGraphics
-
获取或设置标签。
-
modelModelGraphics
-
获取或设置模型对象。
-
nameString
-
获取或设置对象的名称。名称供最终用户使用,名称不需要是唯一的。
-
orientationProperty
-
获取或设置实体的方向。
-
parentEntity
-
获取或设置实体的父对象。
-
pathPathGraphics
-
获取或设置路径对象。
-
planePlaneGraphics
-
获取或设置平面对象。
-
pointPointGraphics
-
获取或设置点图形对象。
-
polygonPolygonGraphics
-
获取或设置多边形对象。
-
polylinePolylineGraphics
-
获取或设置折线对象。
-
polylineVolumePolylineVolumeGraphics
-
获取或设置多段线柱体对象。
-
positionPositionProperty
-
获取或设置实体的位置。
-
propertiesPropertyBag
-
获取或设置与实体对象关联的任意属性包。
-
propertyNamesArray
-
获取实例对象的所有属性名称。
-
rectangleRectangleGraphics
-
获取或设置矩形对象。
-
scaleProperty
-
获取或设置实体的缩放比。
-
showBoolean
-
获取或设置实体对象的可见性。如果设置为true,只有在其父实体的显示属性show也设置为true时此实体才显示。
-
viewFromProperty
-
获取或设置用相机查看此对象时的建议初始偏移。偏移在“东-北-上”坐标系中定义。
-
wallWallGraphics
-
获取或设置围墙对象。
Methods
-
static supportsMaterialsforEntitiesOnTerrain(scene){Boolean}
-
检查指定场景是否支持处理纯色外的材质贴地,贴3d Tiles。如果不支持,实体将以非纯色材质渲染,但是高度将被渲染为0。
Name Type Description sceneScene The current scene.
Returns:
Type Description Boolean Whether or not the current scene supports materials for entities on terrain. -
static supportsPolylinesOnTerrain(scene){Boolean}
-
检查指定场景是否支持线贴地,3D Tiles。如果不支持,
PolylineGraphics将以给定的高度被渲染,并且使用arcType参数渲染,而不使用贴地参数渲染。Name Type Description sceneScene 当前场景。
Returns:
Type Description Boolean 给定场景是否支持线贴地,3DTiles。 -
addProperty(propertyName)
-
为实体添加一个属性。
Name Type Description propertyNameString 待添加的属性名称。
Throws:
-
-
"propertyName"已被保留。
- Type
- DeveloperError
-
-
-
"propertyName"已被注册。
- Type
- DeveloperError
-
-
-
computeModelMatrix(time, result){Matrix4}
-
计算实体在给定时间的模型矩阵。如果position与orientation未定义,将返回undefined。
Name Type Description timeJulianDate 给定的时间。
resultMatrix4 可选 存储结果的对象
Returns:
Type Description Matrix4 如果position与orientation未定义,将返回undefined。如果定义了position或者orientation,并且提供输入参数, 将返回修改的输入对象。反之创建一个新的实例存储结果。 -
isAvailable(time){Boolean}
-
指定时间,如果该对象在指定时间内包含数据,则返回true。
Name Type Description timeJulianDate 检查可用性的时间。
Returns:
Type Description Boolean 如果对象在指定的时间内包含数据,则返回true,否则返回false。 -
merge(source)
-
为对象每个未赋值的属性分配与源对象相同的属性值。
Name Type Description sourceEntity 待合并到目标对象中的对象。
-
removeProperty(propertyName)
-
删除之前通过addProperty功能添加的属性名称。
Name Type Description propertyNameString The name of the property to remove.
Throws:
-
-
"propertyName"已被保留。
- Type
- DeveloperError
-
-
-
"propertyName"已被注册。
- Type
- DeveloperError
-
-
-
setPolygonOffset(polyOffsetFactor, polyOffsetUnits)
-
设置Entity多边形偏移(目前仅支持面)。
Name Type Description polyOffsetFactorNumber 多边形的偏移常量。当值为正值时表示多边形朝屏幕外偏移,为负值时表示朝屏幕内测偏移
polyOffsetUnitsNumber 多边形缩放因子。多边形缩放因子和偏移常量共同决定了多边形对象在屏幕深度方向的偏移量,可用于解决多边形重叠时闪烁的问题。