public enum AltitudeMode extends java.lang.Enum<AltitudeMode>
高度模式常量,用来设置高度模式。
高度模式主要用来表示三维地理信息系统如何解析三维数据的海拔高度值。共有五种高度模式,分别是地表层高度模式(CLAMP_TO_GROUND
)、距地相对高度模式(RELATIVE_TO_GROUND
)、绝对高度模式(ABSOLUTE
)、地下相对高度模式(RELATIVE_TO_UNDERGROUND
)、地下绝对高度模式(ABSOLUTE_UNDER_GROUND
)。
枚举常量和说明 |
---|
ABSOLUTE
绝对高度模式,即:海拔值。
|
ABSOLUTE_UNDER_GROUND
地下绝对高度模式。
|
CLAMP_TO_GROUND
地表层高度模式,即:地表层的海拔值。
|
CLAMP_TO_OBJECT
依对象模式。
|
MODIFY_TERRAIN
修改地形模式。
|
RELATIVE_TO_GROUND
距地相对高度模式, 即:在地表之上的高度值。
|
RELATIVE_TO_UNDERGROUND
地下相对高度模式。
|
限定符和类型 | 方法和说明 |
---|---|
static AltitudeMode |
valueOf(java.lang.String name)
返回带有指定名称的该类型的枚举常量。
|
static AltitudeMode[] |
values()
按照声明该枚举类型的常量的顺序, 返回 包含这些常量的数组。
|
public static final AltitudeMode CLAMP_TO_GROUND
地表层高度模式,即:地表层的海拔值。
当使用地表层高度模式(ClampToGround)时,三维数据的海拔高度会完全被忽略, 各个三维对象将依据其经纬度信息,同时依地形表面的起伏状态附着在地形表面, 即相对于地形表面的高度为零,如下图所示,将一个三维面几何对象(类型为 GeometryType.REGION
的Geometry
对象,下图绿色所示)添加到具有地形数据的三维场景中,在使用地表层高度模式(CLAMP_TO_GROUND
)时, 该三维面几何对象的海拔高度信息则被忽略了,三维面几何对象将依据经纬度坐标信息, 依地形起伏的趋势附着在高低起伏的地形表面。
CLAMP_TO_GROUND
高度模式为默认的高度模式。
public static final AltitudeMode RELATIVE_TO_GROUND
距地相对高度模式, 即:在地表之上的高度值。
距地相对高度模式(RelativeToGround)下的海拔高度值是以经纬度坐标值正下方的地平面(地形表面)为基准的海拔高度。例如,在山区中架设电线杆,用此高度模式放置电线杆,每根电线杆的高度假设为25米,则每个电线杆的顶端的位置都会随着地形而上下移动,如下图所示,黄色的垂直线为电线杆,黄色的水平线为电线。
public static final AltitudeMode ABSOLUTE
绝对高度模式,即:海拔值。
绝对高度模式(Absolute)下的海拔高度值是相对于海平面的海拔高度,该模式会忽略地形的实际海拔高度,当知道精确的海拔高度值时,这种高度模式非常有用。如下图所示,将一个三维面几何对象(GeoRegion3D类对象,如下图中绿色所示)添加到具有地形数据的三维场景中,该三维面几何对象边界节点的高程值均为5800米,在使用绝对高度模式(Absolute)时,该三维面几何对象的显示状态如下图所示。
public static final AltitudeMode RELATIVE_TO_UNDERGROUND
地下相对高度模式。
当 GeoStyle3D.altitudeMode 为 RELATIVE_TO_UNDERGROUND 时,再将 GeoStyle3D.bottomAltitude 设置为负值,则可将几何对象放置于地表以下,如 GeoStyle3D.bottomAltitude=-100 时,将对象放置于地下 100 米处,基准面为地形表面。
public static final AltitudeMode ABSOLUTE_UNDER_GROUND
地下绝对高度模式。
该模式将忽略地形的实际海拔高度,其海拔高度值是相对于海平面的海拔高度。当设置为此模式时,位于地下的物体可以通过调节地表透明度或者挖方来实现可见。
public static final AltitudeMode MODIFY_TERRAIN
修改地形模式。
public static final AltitudeMode CLAMP_TO_OBJECT
依对象模式。
public static AltitudeMode[] values()
for (AltitudeMode c : AltitudeMode.values()) System.out.println(c);
public static AltitudeMode valueOf(java.lang.String name)
name
- 要返回的枚举常量的名称。