• geoscene/smartMapping

stretch

AMD: require(["geoscene/smartMapping/raster/renderers/stretch"], (rasterStretchCreator) => { /* code goes here */ });
ESM: import * as rasterStretchCreator from "@geoscene/core/smartMapping/raster/renderers/stretch";
类: geoscene/smartMapping/raster/renderers/stretch
起始版本:GeoScene Maps SDK for JavaScript 4.20

此对象包含为栅格图层 (例如 ImageryLayerImageryTileLayerWCSLayer) 生成单波段拉伸可视化的辅助方法。

此模块中的 createRenderer 方法可生成一个可以直接应用于输入图层的渲染器。

方法概述

名称 返回值类值 描述 对象
Promise<RasterStretchColorrampResult>

生成 RasterStretchRenderer 来渲染单个栅格波段的数据。

更多详情
stretch

方法详细说明

createRenderer(params){Promise<RasterStretchColorrampResult>}

生成 RasterStretchRenderer 来渲染单个栅格波段的数据。

参数
规范
params Object

用于生成单波段拉伸可视化的输入参数。各参数的详细信息见下表。colorRampgammauseGammadynamicRangeAdjustment 参数与拉伸类型无关。如果需要,可将它们传入以保留现有的渲染器设置。

规范

为其生成渲染器的输入图层。

renderingRule RasterFunction
optional

指定应如何渲染请求影像的规则。当应用 renderingRule 时,服务器将返回更新的服务信息,该信息反映了渲染规则定义的自定义处理。如果未提供,则使用图层的 renderingRule 创建输出渲染器。

stretchType String
optional

提供首选的拉伸类型。有关详细信息,请参阅 RasterStretchRenderer.stretchType

可能值"none"|"min-max"|"standard-deviation"|"histogram-equalization"|"percent-clip"|"sigmoid"

bandId Number
optional

所选波段的从 0 开始的索引。

optional

要应用于渲染器的色带。

variableName String
optional

仅适用于多维数据集,在该数据集中,栅格图层可包含多个具有不同统计数据的变量 (例如温度、湿度、风速)。在此指明变量名称。

gamma Number[]
optional

如果 useGammatrue,则为要使用的 gamma 值。Gamma 是指栅格数据集的中间灰度值之间的对比度程度。它不会影响栅格数据集中的黑色或白色值,只会影响中间值。通过应用 gamma 校正,您可控制 ImageryLayer 的整体亮度。Gamma 拉伸仅在 stretchTypenonestandard-deviationmin-max 时有效。有关详细信息,请参阅 RasterStretchRenderer.gamma

useGamma Boolean
optional

表示是否应使用 gamma 值。当为 false 时,gamma 将基于数据的统计数据和直方图进行计算。

dynamicRangeAdjustment Boolean
optional

当为 true 时,将根据当前显示范围计算渲染器的统计信息,并在缩放和平移影像时重新计算它们。

estimateStatistics Boolean
optional

在影像服务没有统计信息的情况下很有用。当为 true 时,此函数会估计全局统计信息以在平移和缩放时保持恒定的视觉效果,这与 dynamicRangeAdjustment 不同,它会重新计算每个范围变化的统计信息。

optional

允许可取消的请求。如果取消,则承诺将被拒绝,并返回一个名为 AbortError 的错误。另请参见 AbortController

返回
类型 描述
Promise<RasterStretchColorrampResult> 解析为一个包含拉伸渲​​染器的对象,该渲染器可以在输入渲染器上设置。

类型定义

RasterStretchColorrampResult

createRenderer() 方法的结果对象。各属性的详细信息见下表。

属性

应用于输入图层的 RasterStretchRenderer 渲染器。

bandId Number

由渲染器表示的波段的从零开始的索引。

您的浏览器不再受支持。请升级您的浏览器以获得最佳体验。请参阅浏览器弃用帖子以获取更多信息