RasterShadedReliefRenderer

RasterShadedReliefRenderer 在 ImageryLayer or ImageryTileLayer上生成曲面的灰度或彩色 3D，并在对图像着色时考虑太阳的相对位置。该渲染器使用高度和方位角属性指定太阳的位置。默认情况下，灰度颜色渐变用于显示山体阴影高程模型。

该渲染器使用山体阴影技术来可视化由光源和立面曲面的坡度和坡向确定的地形。它是可视化地形的定性方法，不提供绝对高程值。该渲染器提供了两种生成山体阴影的选项：traditional 和 multi-directional。以下图像显示了使用 traditional 和 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"

默认值:"multi-directional"

pixelSizeFactor Number

像素大小因子考虑了查看器在地图显示上放大和缩小时的比例变化。它控制 Z 因子变化的速率。该参数仅在缩放类型为 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

方法列表

方法详细说明

clone(){RasterShadedReliefRenderer}

创建渲染器的深拷贝。

返回值:

类型	描述
RasterShadedReliefRenderer	调用此方法对象的深拷贝。

示例代码:

// 创建第一个图层渲染器的深拷贝
let renderer = view.map.layers.getItemAt(0).renderer.clone();

fromJSON(json){*}static

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

参数:

json Object 实例的 json 表达式，以 geoscene 格式显示。

返回值:

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

toJSON(){Object}

将此类的实例转换为 GeoScene portal JSON 格式。 有关更多信息，请参阅使用 fromJSON() 指南。

返回值:

类型	描述
Object	此类实例的 GeoScene portal JSON 格式。