在定义如何镶嵌单个影像时指定镶嵌规则。它指定选择,镶嵌方法,排序顺序,重叠像素分辨率等。镶嵌规则适用于镶嵌数据集中的镶嵌栅格。镶嵌规则用于定义:
- 选择将参与镶嵌的栅格(使用 where 子句)。
- 镶嵌方法,例如所选栅格的排序方式。
- 镶嵌操作,例如如何解析同一位置的重叠像素。
new MosaicRule({
ascending: true,
method: "center",
operation: "last"
});
构造函数
属性列表
属性 | 类型 | 描述 | 类 | |
---|---|---|---|---|
Boolean | 更多信息 指示排序是否应升序。 | 更多信息 | MosaicRule | |
String | 更多信息 类名。 | 更多信息 | Accessor | |
RasterFunction | 更多信息 在镶嵌之前应用于项目的渲染规则。 | 更多信息 | MosaicRule | |
Number[] | 更多信息 栅格 ID 的数组。 | 更多信息 | MosaicRule | |
String | 更多信息 镶嵌方法用于确定所选栅格的排序方式。 | 更多信息 | MosaicRule | |
DimensionalDefinition[] | 更多信息 多维服务可以具有一个或多个变量的多个维度。 | 更多信息 | MosaicRule | |
Number[] | 更多信息 使用一组对象 ID 定义选定内容。 | 更多信息 | MosaicRule | |
String | 更多信息 定义用于解析重叠像素的镶嵌操作。 | 更多信息 | MosaicRule | |
String | 更多信息 当镶嵌 method 设置为 | 更多信息 | MosaicRule | |
String|Number | 更多信息 当镶嵌 method 设置为 | 更多信息 | MosaicRule | |
Point | 更多信息 定义根据与视点的距离和栅格的最低点定义排序的视点位置。 | 更多信息 | MosaicRule | |
String | 更多信息 where 子句用于确定哪些栅格将参与镶嵌。 | 更多信息 | MosaicRule |
属性详细说明
-
起始版本: GeoScene API for JavaScript 4.22
-
类名。类的名称声明格式为
geoscene.folder.className
。
-
itemRenderingRule RasterFunction
-
在镶嵌之前应用于项目的渲染规则。
-
栅格 ID 的数组。将选择具有给定栅格 ID 列表的所有栅格以参与镶嵌。无论锁定栅格的最小和最大像素大小范围如何,栅格在所有像素大小下都将可见。
- 默认值:null
示例代码:let mosaicRule = new MosaicRule(); mosaicRule.method = "lock-raster"; mosaicRule.lockRasterIds = [32,454,14];
-
method String
-
镶嵌方法用于确定所选栅格的排序方式。镶嵌方法定义了如何根据这些输入栅格创建镶嵌影像。
值 描述 none 根据镶嵌数据集属性表中 objectId 的顺序对栅格进行排序。 center 允许根据栅格的 ZOrder 和 PixelSize 进行排序,然后按默认顺序对栅格进行排序,其中其中心最靠近视图中心的栅格放置在顶部。 nadir 允许按 ZOrder、PixelSize 和最低点位置与视图中心之间的距离对栅格进行排序。这类似于"最接近中心"方法,但使用栅格的最低点,该点可能与中心不同,特别是对于倾斜影像。 viewpoint 根据 ZOrder 对栅格进行排序,然后根据 PixelSize 排序,然后使用视点对栅格进行用户定义的位置和最低点位置进行排序。 attribute 启用基于 ZOrder 的栅格排序,然后基于 PixelSize,然后基于定义的元数据属性及其与基值的差异进行排序。 lock-raster 使用户能够根据 lockRasterIds 锁定单个或多个栅格的显示。 northwest 启用栅格排序,依次为 ZOrder、PixelSize,然后按栅格中心与西北位置之间的最短距离排序。 seamline 使用每个栅格的预定义接缝线形状切割栅格,沿接缝使用可选的羽化,并根据 ZOrder 和属性表中的 SOrder 字段对影像进行排序。 可选值:"none"|"center"|"nadir"|"viewpoint"|"attribute"|"lock-raster"|"northwest"|"seamline"
示例代码:let mosaicRule = new MosaicRule(); mosaicRule.method = "lock-raster";
-
multidimensionalDefinition DimensionalDefinition[]
-
多维服务可以具有一个或多个变量的多个维度。 使用 multiDimensionalDefinitions 根据切片或数据范围过滤数据。 例如,单个 ImageryLayer 可能具有存储不同深度的相同像素位置的海水温度的
depth
维度。 另一个维度可能是time
,其中同一个像素基于时间窗口存储多个值。此属性可用于过滤和显示这些维度中特定"切片"的 ImageryLayer 像素(例如,显示一年中特定一周海平面以下 1000 米处的海温)。
示例代码:// 显示特定时间点的水盐度。
// 在这个示例中 - 2009 年 11 月 30 日
let mosaicRule = new MosaicRule(); mosaicRule.multidimensionalDefinition = []; mosaicRule.multidimensionalDefinition.push(new DimensionalDefinition({ variableName: "Salinity", dimensionName: "StdTime", values: [1259625600000] })); layer.mosaicRule = mosaicRule;
-
使用一组对象 ID 定义选定内容。此属性适用于所有镶嵌方法。
-
operation String
-
定义用于解析重叠像素的镶嵌操作。
可选值
值 描述 first 重叠区域将包含源中列出的第一个栅格数据集中的像元。 last 重叠区域将包含源中列出的最后一个栅格数据集中的像元。 min 重叠区域将包含所有重叠像元中的最小像元值。 max 重叠区域将包含所有重叠像元的最大像元值。 mean 重叠区域将包含所有重叠像元的平均像元值。 blend 重叠区域将是重叠的像元值的混合。此混合值依赖于基于权重的算法,该算法依赖于从像元到重叠区域内边缘的距离。 sum 重叠区域将包含所有重叠像元中像元值的总和。 可选值:"first"|"last"|"min"|"max"|"mean"|"blend"|"sum"
-
sortField String
-
当镶嵌 method 设置为
attribute
时,与常量 sortValue 一起使用以定义镶嵌顺序的属性字段的名称。 排序由指定排序字段值与排序基值之间的差值的绝对值定义。 例如,如果排序字段为Month
,排序值为7 (July)
,则排序由ABS(Month -7)
定义。- 默认值:null
-
当镶嵌 method 设置为
attribute
时,定义排序字段的参考值或基值的常量值。- 默认值:null
-
viewpoint Point
-
定义根据与视点的距离和栅格的最低点定义排序的视点位置。
示例代码:let mosaicRule = new MosaicRule(); mosaicRule.method = "viewpoint"; mosaicRule.viewpoint = inPoint; layer.mosaicRule = mosaicRule;
-
where String
-
where 子句用于确定哪些栅格将参与镶嵌。此属性适用于所有镶嵌方法。如果同时设置了两个属性,则此属性将被 ImageryLayer 的定义 definitionExpression 属性覆盖。
方法列表
属性 | 返回值类型 | 描述 | 类 | |
---|---|---|---|---|
MosaicRule | 更多信息 创建 MosaicRule 对象的克隆。 | 更多信息 | MosaicRule | |
* | 更多信息 创建此类的新实例并使用从 GeoScene产品生成的 JSON 对象的值对其进行初始化。 | 更多信息 | MosaicRule | |
Object | 更多信息 将此类的实例转换为其 GeoScene portal JSON 格式。 | 更多信息 | MosaicRule |
方法详细说明
-
clone(){MosaicRule}
-
创建 MosaicRule 对象的克隆。
返回值:类型 描述 MosaicRule 调用此方法的对象的克隆。 示例代码:// 创建镶嵌规则的克隆
let mosaicRule = layer.mosaicRule.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 格式。