Class: HillshadeParameter

HillshadeParameter

阴影面分析参数类。此类可用于设置阴影面分析中的光源高度角、光源方位角、z 因子等参数。
HILLSHADE 即山体阴影,通过考虑照明源的角度和阴影,根据表面栅格创建地貌晕渲。

new HillshadeParameter(options)

Usage
// 浏览器
<script type="text/javascript" src="https://iclient.supermap.io/dist/leaflet/iclient-leaflet.js"></script>
<script>
  new L.supermap.HillshadeParameter(options);
  
  // 弃用的写法
  new SuperMap.HillshadeParameter(options);

</script>

// ES6 Import
import { HillshadeParameter } from '@supermapgis/iclient-leaflet';

new HillshadeParameter(options);

common/iServer/HillshadeParameter.js, line 8
Name Type Description
options Object

可选参数。

Name Type Default Description
altitude number 45 可选

高于地平线的光源高度角。高度角由正度数表示,0 度代表地平线,而 90 度代表头顶正上方。

azimuth number 315 可选

光源的方位角。方位角由 0 到 360 度之间的正度数表示,以北为基准方向按顺时针进行测量。

zFactor number 1 可选

一个表面 z 单位中地面 x,y 单位的数量。z 单位与输入表面的 x,y 单位不同时,可使用 z 因子调整 z 单位的测量单位。 计算最终输出表面时,将用 z 因子乘以输入表面的 z 值。
1.如果 x,y 单位和 z 单位采用相同的测量单位,则 z 因子为 1。这是默认设置。
2.如果 x,y 单位和 z 单位采用不同的测量单位,则必须将 z 因子设置为适当的因子,否则会得到错误的结果。例如,如果 z 单位是英尺而 x,y 单位是米,则应使用 z 因子 0.3048 将 z 单位从英尺转换为米(1 英尺 = 0.3048 米)。
3.如果输入栅格位于球面坐标系中(如十进制度球面坐标系),则生成的山体阴影可能看起来很独特。这是因为水平地面单位与高程 z 单位之间的测量值存在差异。由于经度的长度随着纬度而变化,因此需要为该纬度指定一个适当的 z 因子。如果 x,y 单位是十进制度而 z 单位是米,特定纬度的一些合适的 z 因子为:
Latitude Z-factor
0 0.00000898
10 0.00000912
20 0.00000956
30 0.00001036
40 0.00001171
50 0.00001395
60 0.00001792
70 0.00002619
80 0.00005156

Extends

Members

altitudenumber

高于地平线的光源高度角。高度角由正度数表示,0 度代表地平线,而 90 度代表头顶正上方。

Default Value:
45

azimuthnumber

光源的方位角。方位角由 0 到 360 度之间的正度数表示,以北为基准方向按顺时针进行测量。

Default Value:
315

栅格分析方法。

zFactornumber

一个表面 z 单位中地面 x,y 单位的数量。z 单位与输入表面的 x,y 单位不同时,可使用 z 因子调整 z 单位的测量单位。计算最终输出表面时,将用 z 因子乘以输入表面的 z 值。

Default Value:
1

Methods

inherited destroy()

common/iServer/HillshadeParameter.js, line 66

释放资源,将资源的属性置空。

toJSON(){string}

common/iServer/HillshadeParameter.js, line 76

将 HillshadeParameter 对象转化为 JSON 字符串。

Returns:
Type Description
string 返回转换后的 JSON 字符串。