栅格函数可指定要对影像服务执行的处理。它们允许镶嵌影像服务提供动态镶嵌影像，并且可用于通过应用影像增强和影像代数等处理操作来增强镶嵌影像产品。有关函数及其参数的列表，请参阅栅格函数。下图显示了使用两个链接的客户端栅格函数进行渲染的土地覆盖 ImageryLayer，这些函数用于对像素值进行重分类 (Remap) 并为每个像素分配一个新颜色 (Colormap)。
通过将 functionArguments 属性中的 Raster 参数设置为另一个已定义的栅格函数，可以实现栅格函数的链接。请参阅以下示例，了解如何将重映射栅格函数 (Remap) 与色彩映射表 (Colormap) 链接在一起。
let remapRF = new RasterFunction();
remapRF.functionName = "Remap";
remapRF.functionArguments = {
InputRanges: [-3,10,11,37], // remap pixels with values -3 to 10 to now have value of 1
OutputValues: [1,2], // remap pixel values from 11 to 37 to have a value of 2
Raster: "$$" // Apply remap to the image service
};
remapRF.outputPixelType = "u8";
let colorRF = new RasterFunction();
colorRF.functionName = "Colormap";
colorRF.functionArguments = {
Colormap: [
[1, 255, 0, 0], // Symbolize pixels with value of 1 using red color
[2, 0, 255, 0] // Symbolize pixels with value of 2 using green color
],
Raster : remapRF // Apply Colormap to output raster from the remap rasterFunction
};
imageLayer.renderingRule = colorRF; // Set rendering rule to final raster function
构造函数
属性概述
| 名称 | 类型 | 描述 | 类 |
|---|---|---|---|
| String | 类的名称。 更多详情 | Accessor | |
| Object | 栅格函数的参数。 更多详情 | RasterFunction | |
| String | 栅格函数名称。 更多详情 | RasterFunction | |
| String | 定义输出影像的像素类型。 更多详情 | RasterFunction | |
| Object | 更多详情 | RasterFunction | |
| String | 栅格函数的变量名。 更多详情 | RasterFunction |
属性详细信息
-
起始版本：GeoScene Maps SDK for JavaScript 4.7
-
类的名称。声明的类名称格式化为
geoscene.folder.className。
-
functionArguments Object
-
栅格函数的参数。结构取决于指定的函数。有关函数及其参数的列表，请参阅栅格函数。此外，还分析了 RFT 格式的参数。
示例rasterFunction.functionArguments = { "Azimuth":215.0, "Altitude":75.0, "ZFactor":0.3 };
-
functionName String
-
栅格函数名称。有关函数及其参数的列表，请参阅栅格函数。RFT JSON 格式的栅格函数中的名称也会解析为 functionName。
示例rasterFunction.functionName = "Stretched"; rasterFunction.name = "GrayScale";
-
outputPixelType String
-
定义输出影像的像素类型。
可能值："c128"|"c64"|"f32"|"f64"|"s16"|"s32"|"s8"|"u1"|"u16"|"u2"|"u32"|"u4"|"u8"|"unknown"
- 默认值：unknown
示例rasterFunction.outputPixelType = "u8";
-
rasterFunctionDefinition Object
-
-
variableName String
-
栅格函数的变量名。
示例rasterFunction.variableName = "DEM";
方法概述
| 名称 | 返回值类值 | 描述 | 类 |
|---|---|---|---|
添加一个或多个与对象的生命周期相关联的句柄。 更多详情 | Accessor | ||
| * | 创建此类的新实例并使用从 GeoScene 产品生成的 JSON 对象值对其进行初始化。 更多详情 | RasterFunction | |
| Boolean | 如果存在指定的句柄组，则返回 true。 更多详情 | Accessor | |
移除对象拥有的句柄组。 更多详情 | Accessor | ||
| Object | 将此类的实例转换为 GeoScene Portal JSON 表示。 更多详情 | RasterFunction |
方法详细说明
-
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() 进行删除。如果未提供键，则句柄将被添加到默认组。
-
fromJSON(json){*}static
-
创建此类的新实例并使用从 GeoScene 产品生成的 JSON 对象值对其进行初始化。传入到输入
json参数的对象通常来自对 REST API 中查询操作的响应或来自另一个 GeoScene 产品的 toJSON() 方法。有关何时以及如何使用该函数的详细信息和示例，请参阅指南中的使用 fromJSON() 主题。参数json ObjectGeoScene 格式实例的 JSON 表示。有关各种输入 JSON 对象的结构示例，请参阅 GeoScene REST API 文档。
返回类型 描述 * 返回该类的新实例。
-
起始版本：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 表示。