cesium 几种定位、定向实体的基本类型.txt

cesium 几种定位、定向实体的基本类型.txt
参考：https://cesium.com/cesiumjs/
以下是在三维中定位和定向 cesium 对象所必需的基本类型，并且具有许多有用的转换方法。

1.笛卡尔坐标系（即，地球直角坐标系）
1.1.Cartesian3:
    三维笛卡尔坐标 – 用作位置时 它相对于地球中心，以“米”为单位 使用地球固定框架(ECEF)。
    new Cesium.Cartesian3(x, y, z) -> 三维笛卡尔坐标点。
    把大地坐标转换成三维笛卡尔坐标：
    Cesium.Cartesian3.fromDegrees(longitude, latitude, height, ellipsoid, result) → Cartesian3
1.2.地球直角坐标系的定义是：
    原点O与地球质心重合，Z轴指向地球北极，X轴指向地球赤道面与格林尼治子午线的交点，
    Y轴在赤道平面里与XOZ构成右手坐标系。


2.WGS 84椭球面坐标系
2.1.Cartographic: 由WGS 84椭球面的经度、纬度(弧度)和高度确定的位置。
    new Cesium.Cartographic(longitude, latitude, height) -> 由经度、纬度和高度定义的位置。
        Name	    Type	Default	Description
        longitude	Number	0.0	    optional The longitude, in radians.
        latitude	Number	0.0	    optional The latitude, in radians.
        height	    Number	0.0	    optional The height, in meters, above the ellipsoid.
2.2.把笛卡尔坐标转换成WGS84坐标：
    Cesium.Cartographic.fromCartesian(cartesian, ellipsoid, result) → Cartographic
2.3.从以度为单位的WGS84坐标构造WGS84坐标。
    Cesium.Cartographic.fromDegrees(longitude, latitude, height, result) → Cartographic
2.4.经纬网的原点 (0,0) 定义在赤道和本初子午线的交点处。
    经度范围：[-180, +180]度，纬度范围：[-90, +90]度。


3.Cesium.HeadingPitchRoll() && Cesium.HeadingPitchRange() (用来表示视角)
3.1 new Cesium.HeadingPitchRoll(heading, pitch, roll)
    在本地坐标系中，规定镜头的朝向，俯仰，旋转。
    本地坐标系：右手笛卡尔坐标系，x（正方向东）, y（正方向北）, z（正方向，垂直于地面朝上）。
    Name	Type	Default	Description
    heading	Number	0.0	    optional The heading component in radians.
    pitch	Number	0.0	    optional The pitch component in radians.
    roll	Number	0.0	    optional The roll component in radians.
    heading（朝向角）：0代表正北方向。在水平面内，顺时针旋转为正角；逆时针旋转为负角。
    pitch（俯仰角）：视线和水平面之间的夹角。仰角为正，俯角为负。
    roll（左右摇摆）：0表示xoz面，在竖直方向。顺时针旋转为正角；逆时针旋转为负角。
3.2. Cesium.HeadingPitchRoll.fromDegrees(heading, pitch, roll, result) → HeadingPitchRoll
    Returns a new HeadingPitchRoll instance from angles given in degrees.
    Name	Type	Description
    heading	Number	the heading in degrees
    pitch	Number	the pitch in degrees
    roll	Number	the heading in degrees
    result	HeadingPitchRoll	optional The object in which to store the result. If not provided, a new instance is created and returned.
    注：在原生 cesium 里，用“弧度”作为第一单位，在 MarsGis 里，用“度”作为第一单位。

3.3. new Cesium.HeadingPitchRange(heading, pitch, range)
    在本地坐标系中，定义一个朝向角、俯仰角、镜头和实体中心距离 的一个对象。
    本地坐标系：原点 o 在要观察实体的包容球的中心，右手笛卡尔坐标系，x（正方向东）, y（正方向北）, z（正方向，垂直于地面朝上）。
    Name	Type	Default	Description
    heading	Number	0.0	    optional The heading angle in radians.
    pitch	Number	0.0	    optional The pitch angle in radians.
    range	Number	0.0	    optional The distance from the center in meters.
    heading（朝向角）：0代表正北方向。在水平面内，顺时针方向旋转为正角；逆时针方向旋转为负角。
    pitch（俯仰角）：视线和水平面之间的夹角。仰视角为正，俯视角为负。
    range（距离）：指镜头（x:0,y:0,z:0）和实体中心的距离。如果为0，将展示整个实体的包容球。


4.Quaternion:
表示为4d坐标的三维旋转。