cesium动画实现语言CZML的最小单元中文翻译--packet

最新推荐文章于 2024-03-01 10:50:16 发布

Alice爱俪丝

最新推荐文章于 2024-03-01 10:50:16 发布

阅读量2.5k

点赞数 2

分类专栏： Cesium webGIS

本文链接：https://blog.csdn.net/qq_18144905/article/details/80809933

版权

Cesium 同时被 2 个专栏收录

27 篇文章 16 订阅

订阅专栏

webGIS

25 篇文章 2 订阅

订阅专栏

下面记录一下我对packet的翻译笔记：

packet

本页记录了CZML文件或数据流可能包含的内容。如果想了解CZML文件是如何组装在一起的，请阅读CZML结构的介绍。

packet描述了场景中某一个对象的各种属性，例如一架飞机。pocket数据包如下：

{
    "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 ]
    }
}

属性

扩展：可插值的属性（InterpolatableProperty，不可变）；基本模式：属性值可以通过对提供时间标记的样本进行插值来确定。

epoch - string

epoch用以表示从一个指定时间增加指定秒数的时间。

interpolationAlgorithm -string （默认值：LINEAR）

插值时使用的插值算法。有效值为“LINEAR”，“LAGRANGE”和“HERMITE”。

interpolationDegree - number （默认值：1）

插值时使用的插值等级。

forwardExtrapolationType - string（默认值：none）

在任何可用样本之后的某一时间请求该值时采用的外插法，有效值为“NONE”，“HOLD”和“EXTRAPOLATE”。

forwardExtrapolationDuration - number（默认值：0.0）

在属性变成未定义之前向前推断的时间，值0将永远推断。

backwardExtrapolationType - string（默认值：NONE）

在任何可用样本之前的某一时间请求该值时执行的外推类型。有效值为“NONE”，“HOLD”和“EXTRAPOLATE”。

backwardExtrapolationDuration - number（默认值：0.0）

在属性变得未定义之前向后推断的时间量。值0将永远推断。

id - string

上面的packet数据包中定义了对象的ID，ID无需定义为一个GUID号，但是在同一个CZML源文件以及者同一个场景中加载的所有CZML文件中，必须是唯一的。如果packet数据包中没有定义ID，客户端会自动为该对象产生一个唯一的ID，但是自动添加ID的情况下，不支持对象加载后的引用，例如为对象添加更多数据。

delete - Boolean

按照ID号进行区分，表明客户端是否需要算出该对象现存的所有数据。如果属性值为TRUE，pocket包中的其他属性将会被忽略。

即：该ID对应的对象，在场景中不会显示。

name - string

对象的名称，名称不必是唯一的，并且是为了用户使用而设计。

parent - string

父对象的ID，如果有的话。

description - string

对象的HTML描述。

clock - Clock

整个数据集时钟的设置，只对文档对象有效。

{
    "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"
    }
}

currentTime - Time

当前时间

multiplier - number（默认为1.0）

乘数：step设置为TICK_DEPENDENT时，表示每个时钟刻度前进的秒数（使用中验证是每个tick前进的分钟数）；

step设置为SYSTEM_CLOCK_DEPENDENT，表示乘以时钟刻度之间经过的系统时间（系统时间每个Tick应该是1秒）；

step设置为SYSTEM_CLOCK 时，忽略改值。

range - ClockRange

当前时间到达其开始或结束时间的行为。

有三个取值：UNBOUNDED 时钟将继续沿当前方向前进

CLAMPED 时钟将停止

LOOP_STOP 当结束时间到达，并且是前进方向时，时钟将跳转到开始时间；

当结束时间到达，但是后退方向，时钟将停止。

step - ClockStep（默认 SYSTEM_CLOCK_MULTIPLIER）

规定当前时间每个刻度前进时间的模式

三个取值：TICK_DEPENDENT 当前时间每个刻度前进 multiplier 个秒数（实际是分钟数，不知道原因）；

SYSTEM_CLOCK_MULTIPLIER 当前时间每个刻度前进的时间 = 上一个刻度前进的系统时间量 * multiplier

SYSTEM_CLOCK 时钟时钟设置为当前系统时间。

version - string

CZML编写的版本号，仅在文档对象中有效。

availability - TimeIntervalCollection（默认值：0000-00-00T00:00:00Z/9999-12-31T24:00:00Z）

一组对象的数据可用的时间间隔。该属性可以是指定单个时间间隔的单个字符串，也可以是代表时间间隔的字符串数组。如果更改或发现错误，稍后的Cesium数据包可以更新此可用性。例如，SGP4传播者最初可能会报告所有时间可用，但稍后传播器抛出异常，可以调整此时的可用性以结束。如果此可选属性未设置，则假定该对象始终可用。可用性范围限定于特定CZML流，因此两个不同的数据流可以为单个对象设置不同的可用性。在单个数据流中，为对象声明的最后一个可用性是有效的，并且之前数据包中的任何可用性都将被忽略。如果一个对象在某个时刻不可用，则客户端将不会绘制该对象。

properties - CustomProperties

对象的自定义属性集。CustomProperties类型表示键值映射，其中值的类型为CustomProperty。

CustomProperty类型：自定义属性（可变）

属性：

boolean - BooleanValue

指定为布尔值的属性。

boundingRectangle - BoundingRectangleValue

指定为四个值[X，Y，宽度，高度]的远近标量值，如果数组有四个元素，则该值是常量。如果它具有五个或更多元素，则它们是时

间标记的样本，排列为[时间，X，Y，宽度，高度，时间，X，Y，宽度，高度，...]，其中时间是ISO 8601格式的日期和时间的字

符串或 epoch指定时间以来的秒数。

边界矩形例如：

            [
                0, 45, 90, 10, 10,
                300, 45, 90, 15, 10,
                600, 45, 90, 10, 14
             ]

cartesian - Cartesian3Value

该属性指定为三维笛卡尔值[X，Y，Z]。

三维笛卡尔值指定为[X，Y，Z]。如果数组有三个元素，则该值是常量。如果它具有四个或更多元素，则它们是时间标记的样本，排列为[Time，X，Y，Z，Time，X，Y，Z，...]，其中Time是ISO 8601标准的日期和时间字符串或自开epoch指定时间以来的秒数。

cartographicRadians - CartographicValue

该属性指定为WGS84 制图坐标[Longitude, Latitude, Height]，其中Longitude 和Latitude是度数。

cartesian2 - Cartesian2Value

该属性被指定为二维笛卡尔值[X，Y]。

spherical - SphericalValue

该属性指定为球形值[Clock，Cone，Magnitude]，角度以弧度表示；幅度以米为单位；时钟角度是在XY平面上从正X轴向正Y轴测量的。锥角是从正Z轴向负Z轴的角度。

unitSpherical - UnitSphericalValue

该属性指定为单位球形值[Clock，Cone]。测量方式同上。

rgba - RgbaValue

该属性为颜色数组[Red, Green, Blue, Alpha]，其中每个成分为0-255的整数。Alpha为透明度。

rgbaf - RgbafValue

该属性为颜色数组[Red, Green, Blue, Alpha]，其中每个成分为0.0-1.0的双精度值。Alpha为透明度。

colorBlendMode - ColorBlendModeValue

指定用于在目标颜色和实体的源颜色之间进行混合的不同模式。

三种取值：HIGHLIGHT 将源颜色与目标颜色相乘

REPLACE 用目标颜色替换源颜色。

MIX 将源颜色和目标颜色混合在一起。

cornerType - CornerTypeValue

拐角样式。

三种取值：ROUNDED 拐角有一个光滑的边缘（圆角）。

MITERED 拐角是邻边的交点（直角）。

BEVELED 拐角为斜面。

heightReference - HeightReferenceValue

对象的高度参考，指示对象的位置是否相对于地形。

三种取值：NONE 绝对位置

CLAMP_TO_GROUND 该位置被固定在地形上。

RELATIVE_TO_GROUND 位置高度是地形上方的高度

horizontalOrigin - HorizontalOriginValue

原点相对于物体位置的水平位置。

三种取值：LEFT 原点位于对象左侧

CENTER 原点位于对象水平位置的中心

RIGHT 原点位于对象右侧

labelStyle - LabelStyleValue

标签格式。

三种取值：FILL 文字充满标签，没有边框

OUTLINE 文字标签有边框，未充满

ILL_AND_OUTLINE 文字充满标签且有边框

number - DoubleValue

浮点数

nearFarScalar - NearFarScalarValue（不知道有何作用）

指定为四个值的远近标量值[NearDistance, NearValue, FarDistance, FarValue]

unitQuaternion - UnitQuaternionValue

该属性被指定为4维单位量级四元数，用于表示三维空间中的旋转动作的一组4维坐标，表示为[X，Y，Z，W]

[
    0, 0.45652188368372576, -0.049580035995243577, -0.8819344359461565, 0.10640131785324795,
    300, 0.309688526062018, -0.0592870464529779, -0.945283886004075, 0.0837641797515638,
    600, 0.15524757622990795, -0.06613430791377527, -0.9841132393764626, 0.05518673278488507
]

shadowMode - ShadowModeValue

该属性指定阴影模式。当启用阴影时是否投射或接收来自每个光源的阴影。

四种取值：DISABLED 该对象不会投射或接收阴影。

ENABLED 该对象投射并且接收阴影。

CAST_ONLY 该对象只能投射阴影。

RECEIVE_ONLY 该对象只接收阴影。

string - StringValue

字符串值

stripeOrientation - StripeOrientationValue

指定为条纹材质中条纹方向的属性。

wsen - CartographicRectangleValue

指定为制图矩形[WestLongitude，SouthLatitude，EastLongitude，NorthLatitude]的属性，值以度为单位。指定一

个二维区域。

uri - UriValue

地址字符串。

verticalOrigin - VerticalOriginValue

原点相对于物体位置的垂直位置。

四种取值：BASELINE 如果对象包含文本，则原点位于文本的基线，否则原点位于对象的底部。

BOTTOM 原点位于对象的底部。

CENTER 原点是在基线和顶部之间的垂直中心。

TOP 原点位于对象的顶部。

position - Position

物体在世界上的位置。该位置没有直接的视觉表示，但是它用于定位附在该对象上的广告牌，标签和其他图形元素。

{
    "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
        ]
    }
}

定义一个位置。该位置可以随时间变化。

属性：

referenceFrame - string（默认值：FIXED）

指定笛卡尔位置的参考框架。可能的值是“FIXED”和“INERTIAL”。

cartesian - Cartesian3Value

指定以三维笛卡尔值[X，Y，Z]表示的位置，相对于referenceFrame以米为单位。

            [
                0, 4650397.56551457, -3390535.52275848, -4087729.48877329,
                300, 3169722.12564676, -2787480.80604407, -5661647.74541255,
                600, 1369743.14695017, -1903662.23809705, -6663952.07552171
            ]

cartographicRadians - CartographicValue

WGS84制图坐标[Longitude, Latitude, Height]表示的位置，其中经度和纬度以弧度表示，高度单位为米。

        {
            "position": {
                "cartographicRadians": [ -1.3439035240356338, 0.6457718232379019, 100000 ]
                 }
        }

cartographicDegrees - CartographicValue

WGS84制图坐标[Longitude, Latitude, Height]表示的位置，其中经度和纬度以度为单位，高度以米为单位。

        {
            "position": {
            "cartographicDegrees": [ -77, 37, 100000 ]
            }
        }

cartesianVelocity - Cartesian3VelocityValue

相对于参考框架的三维笛卡尔值及其导数[X，Y，Z，dX，dY，dZ]表示的位置和速度，单位为米。

reference - ReferenceValue

指定为另一个属性的引用的位置。表示对另一个属性的引用。可以使用引用来指定不同对象上的两个属性实际上是同一个属性。

            "object1#billboard.scale"

orientation - Orientation

物体在世界中的方向。方向没有直接的视觉表示，但它用于定位模型，锥体，金字塔和附加到该对象上的其他图形元素。方向是一个旋转，它将一个向量表达在对象的“主体”轴上，并将其转换为地球固定轴。

{
    "orientation": {
        "interpolationAlgorithm": "LINEAR",
        "interpolationDegree": 1,
        "epoch": "2012-03-15T10:00:00Z",
        "unitQuaternion": [
            0, 0.45652188368372576, -0.049580035995243577, -0.8819344359461565, 0.10640131785324795,
            300, 0.309688526062018, -0.0592870464529779, -0.945283886004075, 0.0837641797515638,
            600, 0.15524757622990795, -0.06613430791377527, -0.9841132393764626, 0.05518673278488507
        ]
    }
}

属性：

unitQuaternion - UnitQuaternionValue

指定为4维单位量值四元数的方向，表示为[X，Y，Z，W]。表示三维空间中物体的旋转。

            [
                0, 0.45652188368372576, -0.049580035995243577, -0.8819344359461565, 0.10640131785324795,
                300, 0.309688526062018, -0.0592870464529779, -0.945283886004075, 0.0837641797515638,
                600, 0.15524757622990795, -0.06613430791377527, -0.9841132393764626, 0.05518673278488507
            ]

reference - ReferenceValue

指定为另一个属性的引用的位置。表示对另一个属性的引用。

velocityReference - ReferenceValue

指定为位置属性的归一化速度矢量的方向。参考必须是位置属性。

viewFrom - ViewFrom

查看此对象时建议的相机位置。该属性表示为相对于对象位置的East（x），North（y），Up（z）参考框架中的笛卡尔位置。

{
    "viewFrom": {
        "cartesian": [ 4.3, 0.1, 2.6 ]
    }
}

属性：

cartesian - Cartesian3Value

reference - ReferenceValue

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

一个地图矩形，符合地球的曲率，可以沿着地表或海拔高度放置。

wall - Wall

与地球的曲率一致的二维壁，可沿表面或高度放置。

agi_conicSensor - ConicSensor

圆锥形传感器体积考虑了椭圆体（即球体）的遮挡。传感器使用position 和orientation 属性进行定位和定向。

注意：该属性是扩展属性，不是所有浏览器都支持。

agi_customPatternSensor - CustomPatternSensor

圆锥形传感器体积考虑了椭圆体（即球体）的遮挡。传感器使用position 和orientation 属性进行定位和定向。

agi_rectangularSensor - RectangularSensor

矩形金字塔传感器体积考虑了椭圆体（即球体）的遮挡。

agi_fan - Fan

agi_vector - Vector

定义一个图形矢量，该矢量始于位置属性，并在所提供方向上延伸指定长度。该矢量使用position 属性进行定位。

Alice爱俪丝

关注

2
点赞
踩
6

收藏

觉得还不错? 一键收藏
0
评论
cesium动画实现语言CZML的最小单元中文翻译--packet

下面记录一下我对packet的翻译笔记： packet本页记录了CZML文件或数据流可能包含的内容。如果想了解CZML文件是如何组装在一起的，请阅读CZML结构的介绍。packet描述了场景中某一个对象的各种属性，例如一架飞机。pocket数据包如下： { "id": "Facility/AGI", "name": "AGI", "avai...
复制链接

扫一扫