RasterShadedReliefRenderer

RasterShadedReliefRenderer 可在 ImageryLayer 或 ImageryTileLayer 上生成一个灰度或彩色的 3D 表面表示，同时考虑太阳的相对位置以着色图像。此渲染器使用 altitude 和 azimuth 属性来指定太阳的位置。默认情况下，灰度色带用于显示山体阴影高程模型。

该渲染器使用山体阴影技术来可视化由光源和高程表面的坡度和坡向确定的地形。它是可视化地形的定性方法，不提供绝对高程值。该渲染器提供了两种生成山体阴影的选项：traditional 和 multi-directional。以下图像显示了使用传统山体阴影类型和 multi-directional 山体阴影类型的高程模型。

传统的	多方向

构造函数

new RasterShadedReliefRenderer(properties)

参数

properties Object optional 有关可能传递给构造函数的所有属性的列表，请参见属性。

属性概述

属性详细信息

altitude Number

地平线之上的太阳高程角，范围为 0 至 90 度。0 度值表示太阳位于地平线上，即，与参考框架位于同一水平面中。90 度值表示太阳处于头顶正上方。

默认值：45

azimuth Number

太阳在地平线上的相对位置，范围为 0 至 360 度。此位置由从正北方向开始按顺时针进行测量的太阳角度指示。0 度方位角表示北，东为 90 度，南为 180 度，西为 270 度。

默认值：315

colorRamp ColorRamp

用于显示地貌晕渲的色带。默认情况下为灰度值。

默认值：null

declaredClass Stringreadonly inherited

类的名称。声明的类名称格式化为 geoscene.folder.className。

hillshadeType String

在高程表面上应用的山体阴影类型。

值	描述
traditional	使用来自一个方向的光源计算山体阴影，使用高度和方位角属性来指定太阳的位置。
multi-directional	可将多个源的光线进行融合，以表示山体阴影地形。与使用传统的山体阴影方法相比，多方向山体阴影方法的优点是能够在受过饱和度和深阴影影响的区域显示更多细节。

可能值："traditional"|"multi-directional"

默认值："traditional"

pixelSizeFactor Number

当查看器在地图显示上放大和缩小时，像素大小因子解释了比例的变化。它控制 Z 因子变化的速率。该参数仅在 scalingType 为 adjusted 时有效。

默认值：0.024

pixelSizePower Number

在查看器在地图显示中放大和缩小时，像素大小倍数可兼顾高度角变化（或比例）。它是应用于方程中像素大小项目的指数，用于控制 Z 因子的变化速率，以避免重大的晕渲损失。该参数仅在 scalingType 为 adjusted 时有效。

默认值：0.664

scalingType String

根据分辨率变化应用常量或调整后的 z 因子。通过使用两个选项之一调整 z 因子来动态缩放阴影结果。

可能值

值	描述
none	不应用缩放。这对于覆盖局部区域的单个栅格数据集非常理想。对于高程变化较大的全球数据集或多比例地图，不建议这样做，因为它会产生在小比例下变化很小的地形起伏。
adjusted	使用 pixelSizePower 和 pixelSizeFactor 值应用非线性校正，当查看器放大和缩小时，它们适应各种高度变化 (比例)。使用全球数据集时建议使用校正选项。

可能值："none"|"adjusted"

默认值：none

type Stringreadonly

渲染器的类型。

对于 RasterShadedReliefRenderer，类型总是 "raster-shaded-relief"。

zFactor Number

z 单位 / xy 单位的比率，具有可选的夸大因素。如果 z (高程) 单位与 x,y (线性) 单位相同，则 z 转换因子为 1。如果您的数据集使用投影坐标系并且高程单位和线性单位不同，则需要定义 z 转换因子来解释差异。

默认值：1

方法概述

方法详细说明

addHandles(handleOrHandles, groupKey)inherited

起始版本：GeoScene Maps SDK for JavaScript 4.25

添加一个或多个与对象的生命周期相关联的句柄。当对象被销毁时，将移除句柄。

// Manually manage handles
const handle = reactiveUtils.when(
  () => !view.updating,
  () => {
    wkidSelect.disabled = false;
  },
  { once: true }
);

// Handle gets removed when the object is destroyed.
this.addHandles(handle);

参数

handleOrHandles WatchHandle|WatchHandle[] 对象销毁后，标记为要移除的句柄。

groupKey * optional 标识句柄应添加到的组的键。组中的所有句柄稍后都可使用 Accessor.removeHandles() 进行删除。如果未提供键，则句柄将被添加到默认组。

clone(){RasterShadedReliefRenderer}

创建 renderer 的深度克隆。

返回

类型	描述
RasterShadedReliefRenderer	调用此方法的对象的深度克隆。

示例

// Creates a deep clone of the first layer's renderer
let renderer = view.map.layers.getItemAt(0).renderer.clone();

fromJSON(json){*}static

创建此类的新实例并使用从 GeoScene 产品生成的 JSON 对象值对其进行初始化。传入到输入 json 参数的对象通常来自对 REST API 中查询操作的响应或来自另一个 GeoScene 产品的 toJSON() 方法。有关何时以及如何使用该函数的详细信息和示例，请参阅指南中的使用 fromJSON() 主题。

参数

json Object GeoScene 格式实例的 JSON 表示。有关各种输入 JSON 对象的结构示例，请参阅 GeoScene REST API 文档。

返回

类型	描述
*	返回该类的新实例。

hasHandles(groupKey){Boolean}inherited

起始版本：GeoScene Maps SDK for JavaScript 4.25

如果存在指定的句柄组，则返回 true。

参数

groupKey * optional 组键。

返回

类型	描述
Boolean	如果存在指定的句柄组，则返回 true。

示例

// Remove a named group of handles if they exist.
if (obj.hasHandles("watch-view-updates")) {
  obj.removeHandles("watch-view-updates");
}

removeHandles(groupKey)inherited

起始版本：GeoScene Maps SDK for JavaScript 4.25

移除对象拥有的句柄组。

参数

groupKey * optional 要移除的组键或组键的数组或集合。

示例

obj.removeHandles(); // removes handles from default group

obj.removeHandles("handle-group");
obj.removeHandles("other-handle-group");

toJSON(){Object}

将此类的实例转换为 GeoScene Portal JSON 表示。有关详细信息，请参阅使用 fromJSON() 指南主题。

返回

类型	描述
Object	此类实例的 GeoScene Portal JSON 表示。