Packet
本页描述CZML文档或流的可能内容。请阅读CZML结构文档说明以了解如何将CZML文档组合在一起。
Packet
描述场景中单个对象(例如单个飞机)的图形属性。
可插值: no
例子:
{
"id": "Facility/AGI",
"name": "AGI",
"availability": "2012-03-15T10:00:00Z/2012-03-16T10:00:00Z",
"description": "<p>Analytical Graphics, Inc. (AGI) develops commercial modeling and analysis software.</p>",
"billboard": {
"eyeOffset": {
"cartesian": [ 0, 0, 0 ]
},
"horizontalOrigin": "CENTER",
"image": "data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAABAAAAAQCAYAAAAf8/9hAAAAAXNSR0IArs4c6QAAAARnQU1BAACxjwv8YQUAAAAJcEhZcwAADsMAAA7DAcdvqGQAAACvSURBVDhPrZDRDcMgDAU9GqN0lIzijw6SUbJJygUeNQgSqepJTyHG91LVVpwDdfxM3T9TSl1EXZvDwii471fivK73cBFFQNTT/d2KoGpfGOpSIkhUpgUMxq9DFEsWv4IXhlyCnhBFnZcFEEuYqbiUlNwWgMTdrZ3JbQFoEVG53rd8ztG9aPJMnBUQf/VFraBJeWnLS0RfjbKyLJA8FkT5seDYS1Qwyv8t0B/5C2ZmH2/eTGNNBgMmAAAAAElFTkSuQmCC",
"pixelOffset": {
"cartesian2": [ 0, 0 ]
},
"scale": 1.5,
"show": true,
"verticalOrigin": "CENTER"
},
"label": {
"fillColor": {
"rgba": [ 0, 255, 255, 255 ]
},
"font": "11pt Lucida Console",
"horizontalOrigin": "LEFT",
"outlineColor": {
"rgba": [ 0, 0, 0, 255 ]
},
"outlineWidth": 2,
"pixelOffset": {
"cartesian2": [ 12, 0 ]
},
"show": true,
"style": "FILL_AND_OUTLINE",
"text": "AGI",
"verticalOrigin": "CENTER"
},
"position": {
"cartesian": [ 1216469.9357990976, -4736121.71856379, 4081386.8856866374 ]
}
}
{
"id": "document",
"name": "My Document",
"version": "1.0",
"clock": {
"interval": "2012-03-15T10:00:00Z/2012-03-16T10:00:00Z",
"currentTime": "2012-03-15T10:00:00Z",
"multiplier": 60,
"range": "LOOP_STOP",
"step": "SYSTEM_CLOCK_MULTIPLIER"
}
}
{
"id": "My Object",
"delete": true
}
Properties
id - string
该数据包描述的对象的ID。ID不必是GUID,但它们确实需要唯一地标识CZML源中的单个对象以及加载到同一作用域中的任何其他CZML源。如果未指定此属性,则客户端将自动生成一个唯一的属性。但是,这阻止了以后的数据包引用该对象以向其添加更多数据。
delete - boolean
客户端是否应删除该对象的所有现有数据(由ID标识)。如果为true,则将忽略此数据包中的所有其他属性。
name - string
对象的名称。它不必是唯一的,仅供用户使用。
parent - string
父对象的ID(如果有)。
description - String
对象的HTML描述。
clock - Clock
整个数据集的时钟设置。仅对文档对象有效。
version - string
正在编写CZML版本。仅对文档对象有效。
availability - TimeIntervalCollection
一组时间间隔,对象数据可用。该属性可以是指定单个间隔的单个字符串,也可以是表示间隔的字符串数组。如果更高版本的CZML数据包发生更改或发现不正确,则可以更新此可用性。例如,SGP4传播者可能最初报告所有时间的可用性,但随后传播者抛出异常,并且可以将可用性调整为在那时终止。如果此可选属性不存在,则假定该对象一直可用。可用性范围仅限于特定的CZML流,因此两个不同的流可以为单个对象列出不同的可用性。在单个流中,为对象声明的最后一个可用性是有效的那个,并且忽略先前数据包中的任何可用性。
Default:0000-00-00T00:00:00Z/9999-12-31T24:00:00Z
properties - CustomProperties
此对象的一组定制属性。
position - Position
对象在世界上的位置。该位置没有直接的视觉表示,但是用于定位广告牌,标签和附加到对象的其他图形项。
例子:
{
"id": "MyObject",
"position": {
"cartographicDegrees": [
-75.0, 40.0, 0.0
]
}
}
{
"id": "InternationalSpaceStation",
"position": {
"interpolationAlgorithm": "LAGRANGE",
"interpolationDegree": 5,
"referenceFrame": "INERTIAL",
"epoch": "2012-05-02T12:00:00Z",
"cartesian": [
0.0, -6668447.2211117, 1201886.45913705, 146789.427467256,
60.0, -6711432.84684144, 919677.673492462, -214047.552431458,
90.0, -6721319.92231553, 776899.784034099, -394198.837519575,
150.0, -6717826.447064, 488820.628328182, -752924.980158179,
180.0, -6704450.41462847, 343851.784836767, -931084.800346031,
240.0, -6654518.44949696, 52891.726433174, -1283967.69137678
]
}
}
orientation - Orientation
物体在世界上的方向。方向没有直接的视觉表示,但是用于定向模型,圆锥体,金字塔和附加到对象的其他图形项。
viewFrom - ViewFrom
观看此对象时建议的摄像机位置。该属性被指定为相对于对象位置的东(x),北(y),上(z)参考系中的笛卡尔位置。
billboard - Billboard
广告牌或视口对齐的图像,有时也称为标记。广告牌由position属性放置在场景中。
box - Box
一个盒子,是一个封闭的矩形长方体。该框使用position和orientation属性定位和定向。
corridor - Corridor
走廊,是由中心线和宽度定义的形状。
cylinder - Cylinder
圆柱,圆锥台或由长度,顶部半径和底部半径定义的圆锥。使用position和orientation属性定位和定向圆柱体。
ellipse - Ellipse
椭圆,是地球表面上的闭合曲线。使用position属性定位椭圆。
ellipsoid - Ellipsoid
椭圆体,它是一个闭合的二次曲面,是椭圆的三维类似物。使用position和orientation属性来定位和定向椭球。
label - Label
一串文字。标签通过position属性放置在场景中。
model - Model
3D模型。使用position和orientation属性定位和定向模型。
path - Path
路径,是由对象随时间的运动定义的折线。路径的可能顶点由position属性指定。
point - Point
点或视口对齐的圆。该点由position属性定位在场景中。
polygon - Polygon
多边形,是地球表面上的闭合图形。
polyline - Polyline
折线,这是场景中由多个线段组成的线。
rectangle - Rectangle
符合地球曲率的制图矩形,可以沿着表面或在高空放置。
tileset - Tileset
3D Tiles tileet。
wall - Wall
符合地球曲率的二维墙,可以沿着地面或在高处放置。
agi_conicSensor - ConicSensor
考虑到椭圆体(例如球形)的遮挡的圆锥形传感器体积。使用position和orientation属性定位和定向传感器。
agi_customPatternSensor - CustomPatternSensor
自定义的传感器体积,考虑到椭圆体(例如地球仪)的遮挡。使用position和orientation属性定位和定向传感器。
agi_rectangularSensor - RectangularSensor
考虑到椭圆体(即地球)的遮挡的矩形金字塔传感器体积。使用position和orientation属性定位和定向传感器。
agi_fan - Fan
定义一个风扇,该风扇从一个点或顶点开始,并在从顶点开始的指定方向列表中延伸。每对方向形成一个风扇面,该面延伸到指定的半径。使用position和orientation属性定位和定向风扇。
agi_vector - Vector
定义一个图形矢量,该矢量起源于该position属性,并沿所提供的方向延伸了所提供的长度。使用position属性定位矢量。