com.supermap.data

类 AltitudeMode

java.lang.Object

com.supermap.data.Enum

com.supermap.data.AltitudeMode

public class AltitudeMode
extends Enum

该类定义了高度模式类型常量，高度模式用于指示 SuperMap 组件产品解析三维数据海拔高度值的方式。目前 SuperMap 组件产品提供了如下几种高度模式：贴地表模式（CLAMP_TO_GROUND）、相对地表模式（RELATIVE_TO_GROUND）、绝对海拔模式（ABSOLUTE）、地下相对模式（RELATIVE_TO_UNDERGROUND）、地下绝对模式（ABSOLUTE_UNDER_GROUND），其中地表层高度模式（CLAMP_TO_GROUND）为 SuperMap 组件产品默认的高度模式。

下图给出了不同高度模式对应的基准面以及高度值（Z 值）设置后对应的几何对象所放置的高度区域，由下图可知，ABSOLUTE 高度模式的海拔高度基准面为海平面，正方向与下图中箭头方向一致；CLAMP_TO_GROUND 模式下，对象将附着在地形表面，RELATIVE_TO_GROUND、RELATIVE_TO_UNDERGROUND 高度模式的海拔高度基准面为地形表面，正方向与下图中箭头方向一致。

字段概要

字段

限定符和类型	字段和说明
static AltitudeMode	ABSOLUTE 绝对海拔模式。
static AltitudeMode	ABSOLUTE_UNDER_GROUND 地下绝对模式。
static AltitudeMode	CLAMP_TO_GROUND 贴地表模式。
static AltitudeMode	CLAMP_TO_OBJECT 依模型模式。
static AltitudeMode	MODIFY_TERRAIN 修改地形模式。
static AltitudeMode	RELATIVE_TO_GROUND 相对地表模式。
static AltitudeMode	RELATIVE_TO_UNDERGROUND
static AltitudeMode	RELATIVE_UNDER_GROUND 地下相对模式。

方法概要

从类继承的方法 com.supermap.data.Enum

equals, getEnums, getNameByValue, getNames, getPredefineValues, getValueByName, getValues, hashCode, isDefined, isDefined, name, parse, parse, toString, value

从类继承的方法 java.lang.Object

getClass, notify, notifyAll, wait, wait, wait

字段详细资料

CLAMP_TO_GROUND

public static final AltitudeMode CLAMP_TO_GROUND

贴地表模式。

使用该高度模式时，三维数据的海拔高度将完全被忽略（即所有三维对象的 Z 值不起作用），各三维对象将依据其经纬度信息，根据地形起伏状态附着在地形表面，即相对于地形表面的高度为零。如下图所示，当前高度模式为地表层高度模式，将三维面几何对象（GeoRegion3D 对象，对应下图绿色面对象）添加到具有地形数据的三维场景中，此时，三维面几何对象的海拔高度信息将被忽略，该三维面对象根据经纬度坐标信息，根据地形起伏贴合在起伏的地形表面。

此高度模式为 SuperMap 组件产品默认的高度模式。

RELATIVE_TO_GROUND

public static final AltitudeMode RELATIVE_TO_GROUND

相对地表模式。

该模式下的海拔高度值是以经纬度坐标值正下方的地平面（即地形表面）为基准的海拔高度。例如，在山区中架设电线杆，每根电线杆的高度假设为25米，选择距地相对高度模式，就可以实现与客观现实一致的效果，即每根电线杆的底端位置随着地形上下起伏，效果如下图所示，其中，黄色的垂直线表示电线杆，黄色的水平线表示电线。

ABSOLUTE

public static final AltitudeMode ABSOLUTE

绝对海拔模式。

该模式将忽略地形的实际海拔高度，其海拔高度值是相对于海平面的海拔高度，若三维数据包含精确的海拔高度值，该高度模式将非常有用。如下图所示，当前高度模式为绝对高度模式，将三维面几何对象（GeoRegion3D 对象，对应下图绿色面对象）添加到具有地形数据的三维场景中，该三维面几何对象边界节点的高程值均为 5800 米，则该对象将忽略地形起伏，在距离水平面 5800 米高度处显示，具体显示效果如下图所示。

RELATIVE_TO_UNDERGROUND

public static final AltitudeMode RELATIVE_TO_UNDERGROUND

RELATIVE_UNDER_GROUND

public static final AltitudeMode RELATIVE_UNDER_GROUND

地下相对模式。

该高度模式以地形表面为基准，与 RELATIVE_UNDER_GROUND 高度模型正好相反，用于地下场景的浏览。

当调用 GeoStyle3D.setAltitudeMode(AltitudeMode.RELATIVE_UNDER_GROUND) 方法将三维场景中的几何对象设置为地下高度模式，此时，再调用 GeoStyle3D.setBottomAltitude() 方法将参数设置为负值，则可将几何对象放置于地表以下，如 GeoStyle3D.setBottomAltitude(-100) 时，将对象放置于地下 100 米处，基准面为地形表面。

ABSOLUTE_UNDER_GROUND

public static final AltitudeMode ABSOLUTE_UNDER_GROUND

地下绝对模式。

该模式将忽略地形的实际海拔高度，其海拔高度值是相对于海平面的海拔高度。

当设置为此模式时，位于地下的物体可以通过调节地表透明度或者挖方来实现可见。

MODIFY_TERRAIN

public static final AltitudeMode MODIFY_TERRAIN

修改地形模式。

CLAMP_TO_OBJECT

public static final AltitudeMode CLAMP_TO_OBJECT

依模型模式。