predominance

方法概述

方法详细说明

cloneScheme(scheme){PredominanceScheme}

克隆众数渲染方案对象。

参数

scheme PredominanceScheme 要克隆的众数渲染方案对象。

返回

类型	描述
PredominanceScheme	返回给定众数渲染方案对象的克隆。

示例

// clones the primary scheme returned from the getSchemes() method
const predominanceScheme = primaryScheme.clone();

getSchemeByName(params){PredominanceScheme}

起始版本：GeoScene Maps SDK for JavaScript 4.12

返回具有提供名称的众数渲染方案。

参数

规范

params Object 有关可能传递给此函数的每个参数的详细信息，请参阅下表。 规范 name String 要检索的方案的名称。 basemap String|Basemap optional 与可视化配对的底图。此值表示使用给定底图进行可视化要素的最佳符号颜色。 basemapTheme String optional 如果您具有非 GeoScene 底图 (例如，具有自定义样式的 VectorTileLayer 底图) 或根本没有底图，则可使用此参数来表示可视化的背景是 light 还是 dark。 可能值："light"|"dark" geometryType String 要可视化的要素的几何类型。 可能值："point"|"multipoint"|"polyline"|"polygon"|"mesh"|"multipatch" numColors Number 在众数渲染可视化中包含的唯一值的数量。 theme String optional 默认值： default 确定要返回的主要和次要配色方案集。 值通常是 "default"。 worldScale Boolean optional 表示方案的尺寸单位是否以米为单位。当方案用于 3D 体积符号时，这应为 true。如果此属性设置为 true，则必须提供 view。 view SceneView optional 将在其中使用方案的 SceneView 实例。此属性仅适用于将方案与 3D 符号结合使用时。

返回

类型	描述
PredominanceScheme	返回具有给定名称的众数渲染方案。

示例

// Returns the Flower Field scheme
let flowerFieldScheme = colorSchemes.getSchemeByName({
  name: "Flower Field",
  basemap: map.basemap,
  geometryType: featureLayer.geometryType
});

getSchemes(params){PredominanceSchemes}

返回主要方案和次要方案，这些方案定义了图层中基于众数渲染的数据驱动型可视化的符号属性。basemap 参数可确定用于可视化每个要素的符号颜色。geometryType 可确定要返回的符号类型。

参数

规范

params Object 有关可能传递给此函数的每个参数的详细信息，请参阅下表。 规范 basemap String|Basemap optional 与可视化配对的底图。此值表示针对给定底图进行可视化要素的最佳符号颜色。如果您具有非 GeoScene 底图 (例如，具有自定义样式的 VectorTileLayer 底图) 或根本没有底图，则可使用 basemapTheme 参数而不是此参数。 basemapTheme String optional 如果您具有非 GeoScene 底图 (例如，具有自定义样式的 VectorTileLayer 底图) 或根本没有底图，则可使用此参数来表示可视化的背景是 light 还是 dark。 可能值："light"|"dark" geometryType String 要可视化的要素的几何类型。 可能值："point"|"multipoint"|"polyline"|"polygon"|"mesh"|"multipatch" numColors Number 在众数渲染可视化中包含的唯一值的数量。 theme String optional 默认值： default 确定要返回的主要和次要配色方案集。 值通常是 "default"。 worldScale Boolean optional 表示方案的尺寸单位是否以米为单位。当方案用于 3D 体积符号时，这应为 true。如果此属性设置为 true，则必须提供 view。 view SceneView optional 将在其中使用方案的 SceneView 实例。此属性仅适用于将方案与 3D 符号结合使用时。

返回

类型	描述
PredominanceSchemes	返回一个对象，其中包含要用于给定底图的最佳类型方案；它还包含次要方案。

示例

// gets the primary scheme for the features of the given geometry type and basemap
const schemes = predominanceSchemes.getSchemes({
  basemap: map.basemap,
  geometryType: featureLayer.geometryType
});

// the best default scheme for the layer and basemap
const primaryScheme = schemes.primaryScheme;

getSchemesByTag(params){PredominanceScheme[]}

起始版本：GeoScene Maps SDK for JavaScript 4.12

返回具有所提供标签的众数渲染方案数组。这些方案定义了可使用 Renderer 渲染的任何图层中的众数渲染可视化的符号属性。

参数

规范

params Object 有关可能传递给此函数的每个参数的详细信息，请参阅下表。 规范 includedTags String[] optional 提供后，将仅返回包含所有匹配标记的方案。 已知标签： light | dark | reds | yellows | oranges | greens | blues | purples | pinks | browns | grays | bright | subdued | deuteranopia | protanopia | tritanopia | grayscale | types | dot-density excludedTags String[] optional 提供后，将仅返回缺少所有已提供标记的方案。 已知标签： light | dark | reds | yellows | oranges | greens | blues | purples | pinks | browns | grays | bright | subdued | deuteranopia | protanopia | tritanopia | grayscale | types | dot-density basemap String|Basemap optional 与可视化配对的底图。此值表示使用给定底图进行可视化要素的最佳符号颜色。 basemapTheme String optional 如果您具有非 GeoScene 底图 (例如，具有自定义样式的 VectorTileLayer 底图) 或根本没有底图，则可使用此参数来表示可视化的背景是 light 还是 dark。 可能值："light"|"dark" geometryType String 要可视化的要素的几何类型。 可能值："point"|"multipoint"|"polyline"|"polygon"|"mesh"|"multipatch" numColors Number 在众数渲染可视化中包含的唯一值的数量。 theme String optional 默认值： default 确定要返回的主要和次要配色方案集。 值通常是 "default"。 worldScale Boolean optional 表示方案的尺寸单位是否以米为单位。当方案用于 3D 体积符号时，这应为 true。如果此属性设置为 true，则必须提供 view。 view SceneView optional 将在其中使用方案的 SceneView 实例。此属性仅适用于将方案与 3D 符号结合使用时。

返回

类型	描述
PredominanceScheme[]	返回包含或排除所提供标记的众数渲染方案数组。

示例

let schemes = predominanceSchemes.getSchemesByTag({
  includedTags: [ "types" ],
  basemap: map.basemap,
  geometryType: featureLayer.geometryType
});

getThemes(basemap){Theme[]}

返回可用主题的元数据。如果提供了底图，则返回与给定底图最匹配的主题。

参数

basemap String|Basemap optional GeoScene 底图字符串或将与返回的主题一起使用的对象。

返回

类型	描述
Theme[]	回一个对象，其中包含有关给定底图的可用主题的信息。

类型定义

PredominanceScheme PredominanceSchemeForPoint|PredominanceSchemeForPolyline|PredominanceSchemeForPolygon|PredominanceSchemeForMesh

根据图层的几何类型定义符号系统方案，该方案用于可视化众数渲染。

PredominanceSchemeForMesh

定义符号系统方案的属性，该方案用于可视化网格要素的优势。

属性

name String 方案的唯一名称。

tags String[] 与方案相关的标签。

colors Color[] 用于每个类别的网格符号的填充颜色。

noDataColor Color 填充符号的颜色，用于表示没有数据的要素。

opacity Number 符号的不透明度 (0-1)。

PredominanceSchemeForPoint

定义符号系统方案的属性，该方案用于可视化点要素的优势。

属性

name String 方案的唯一名称。

tags String[] 与方案相关的标签。

colors Color[] 用于每个类别的点符号的填充颜色。

noDataColor Color 点符号的颜色，用于表示没有数据的要素。

outline Object 用于定义标记符号轮廓的属性。 规范 color Color 标记符号的轮廓颜色。 width Number 标记符号的宽度，以磅为单位。

opacity Number 点符号的不透明度 (0 - 1)。

sizeScheme SizeSchemeForPoint 如果包含在众数渲染可视化中，则为定义大小视觉变量的方案。

PredominanceSchemeForPolygon

定义符号系统方案的属性，该方案用于可视化多边形要素的优势。

属性

name String 方案的唯一名称。

tags String[] 与方案相关的标签。

colors Color[] 用于每个类别的面符号的填充颜色。

noDataColor Color 填充符号的颜色，用于表示没有数据的要素。

outline Object 用于定义填充符号轮廓的属性。 规范 color Color 填充符号的轮廓颜色。 width Number 填充符号轮廓的宽度，以像素或磅为单位。

opacity Number 符号的不透明度 (0-1)。

sizeScheme SizeSchemeForPolygon 如果包含在众数渲染可视化中，则为定义大小视觉变量的方案。

PredominanceSchemeForPolyline

定义符号系统方案的属性，该方案用于可视化折线要素的优势。

属性

name String 方案的唯一名称。

tags String[] 与方案相关的标签。

colors Color[] 用于每个类别的线符号的颜色。

noDataColor Color 该线符号颜色用于表示没有数据的要素和超出范围的要素。

width Number 线符号的默认宽度，以像素或磅为单位。

opacity Number 线符号的不透明度 (0 - 1)。

sizeScheme SizeSchemeForPolyline 如果包含在众数渲染可视化中，则为定义大小视觉变量的方案。

PredominanceSchemes

getSchemes() 方法返回的对象。

属性

primaryScheme PredominanceScheme 最适合给定底图和几何类型的众数渲染方案。

secondarySchemes PredominanceScheme[] 可用于可视化给定几何类型数据 (叠加在给定底图上) 的其他众数渲染方案。

basemapId String 与给定方案相关联的底图 ID。

basemapTheme String 表示平均底图颜色是 light 还是 dark。