Class: Entity

Entity

new Entity(options)

实体实例类,它将多种可视化对象聚合到单个高级对象中。 实体可以手动创建并添加到Viewer#entities中,或由数据源(如CzmlDataSourceGeoJsonDataSource)生成。

Name Type Description
options Object 可选

Object 包含以下属性的对象:

Name Type Description
id String 可选

对象的唯一标识符。如果没有提供,则生成GUID。

name String 可选

向用户显示的可读名称,名称可不必唯一。

availability TimeIntervalCollection 可选

是否显示实体对象及其子项。

show Boolean 可选

是否显示实体对象及其子项。

description Property 可选

实体的HTML描述。

position PositionProperty 可选

实体的位置。

orientation Property 可选

实体的方向。

viewFrom Property 可选

查看此实体对象的建议初始偏移量

parent Entity 可选

与此实体关联的父实体。

billboard BillboardGraphics 可选

与此实体关联的布告板。

box BoxGraphics 可选

与此实体关联的盒子对象。

corridor CorridorGraphics 可选

与实体关联的走廊对象。

cylinder CylinderGraphics 可选

与实体关联的圆柱体对象。

ellipse EllipseGraphics 可选

与实体关联的椭圆形对象。

ellipsoid EllipsoidGraphics 可选

与实体关联的椭球体对象。

label LabelGraphics 可选

与实体关联的标签对象。

model ModelGraphics 可选

与实体关联的模型对象。

path PathGraphics 可选

与实体关联的路径对象。

plane PlaneGraphics 可选

与实体关联的平面对象。

point PointGraphics 可选

与实体关联的点对象。

polygon PolygonGraphics 可选

与实体关联的多边形对象。

polyline PolylineGraphics 可选

与实体关联的折线对象

properties PropertyBag 可选

与实体关联的任意属性。

polylineVolume PolylineVolumeGraphics 可选

与实体关联的多段线柱体对象。

rectangle RectangleGraphics 可选

与实体关联的矩形对象。

wall WallGraphics 可选

与实体关联的围墙对象。

Members

availabilityTimeIntervalCollection

对象的可用性。如果可用性未定义,假定该对象的其他属性将在任何时间内返回有效数据。如果存在可用性,对象的其他属性将只在查询给定的时间间隔内提供有效数据。

获取或设置布告板对象。

获取或设置长方体对象。

获取或设置走廊对象。

获取或设置圆柱体对象。

readonly definitionChangedEvent

获取属性或子属性发生变化修改时触发的事件。

descriptionProperty

获取或设置实体描述。

获取或设置椭圆对象。

获取或设置椭球体对象。

entityCollectionEntityCollection

获取或设置此实体所属的实体集合。

idString

获取实体的唯一标识符。

isShowingBoolean

获取此实体的可见性,此可见性属性考虑了其所属实体集合以及父实体的可见性。

获取或设置标签。

获取或设置模型对象。

nameString

获取或设置对象的名称。名称供最终用户使用,名称不需要是唯一的。

orientationProperty

获取或设置实体的方向。

parentEntity

获取或设置实体的父对象。

获取或设置路径对象。

获取或设置平面对象。

获取或设置点图形对象。

获取或设置多边形对象。

获取或设置折线对象。

polylineVolumePolylineVolumeGraphics

获取或设置多段线柱体对象。

获取或设置实体的位置。

propertiesPropertyBag

获取或设置与实体对象关联的任意属性包。

propertyNamesArray

获取实例对象的所有属性名称。

获取或设置矩形对象。

scaleProperty

获取或设置实体的缩放比。

showBoolean

获取或设置实体对象的可见性。如果设置为true,只有在其父实体的显示属性show也设置为true时此实体才显示。

viewFromProperty

获取或设置用相机查看此对象时的建议初始偏移。偏移在“东-北-上”坐标系中定义。

获取或设置围墙对象。

Methods

static supportsMaterialsforEntitiesOnTerrain(scene){Boolean}

检查指定场景是否支持处理纯色外的材质贴地,贴3d Tiles。如果不支持,实体将以非纯色材质渲染,但是高度将被渲染为0。

Name Type Description
scene Scene

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
scene Scene

当前场景。

Returns:
Type Description
Boolean 给定场景是否支持线贴地,3DTiles。

addProperty(propertyName)

为实体添加一个属性。

Name Type Description
propertyName String

待添加的属性名称。

Throws:
  • "propertyName"已被保留。

    Type
    DeveloperError
  • "propertyName"已被注册。

    Type
    DeveloperError

computeModelMatrix(time, result){Matrix4}

计算实体在给定时间的模型矩阵。如果position与orientation未定义,将返回undefined。

Name Type Description
time JulianDate

给定的时间。

result Matrix4 可选

存储结果的对象

Returns:
Type Description
Matrix4 如果position与orientation未定义,将返回undefined。如果定义了position或者orientation,并且提供输入参数, 将返回修改的输入对象。反之创建一个新的实例存储结果。

isAvailable(time){Boolean}

指定时间,如果该对象在指定时间内包含数据,则返回true。

Name Type Description
time JulianDate

检查可用性的时间。

Returns:
Type Description
Boolean 如果对象在指定的时间内包含数据,则返回true,否则返回false。

merge(source)

为对象每个未赋值的属性分配与源对象相同的属性值。

Name Type Description
source Entity

待合并到目标对象中的对象。

removeProperty(propertyName)

删除之前通过addProperty功能添加的属性名称。

Name Type Description
propertyName String

The name of the property to remove.

Throws:
  • "propertyName"已被保留。

    Type
    DeveloperError
  • "propertyName"已被注册。

    Type
    DeveloperError

setPolygonOffset(polyOffsetFactor, polyOffsetUnits)

设置Entity多边形偏移(目前仅支持面)。

Name Type Description
polyOffsetFactor Number

多边形的偏移常量。当值为正值时表示多边形朝屏幕外偏移,为负值时表示朝屏幕内测偏移

polyOffsetUnits Number

多边形缩放因子。多边形缩放因子和偏移常量共同决定了多边形对象在屏幕深度方向的偏移量,可用于解决多边形重叠时闪烁的问题。