color

方法列表

方法详细说明

cloneScheme(scheme){ColorScheme}

克隆一个配色方案对象。

参数:

scheme ColorScheme 要克隆的配色方案对象。

返回值:

类型	描述
ColorScheme	返回给定配色方案对象的克隆。

示例代码:

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

flipColors(scheme){ColorScheme}

以与输入配色方案相反的顺序翻转颜色。

参数:

scheme ColorScheme 要反转的配色方案。

返回值:

类型	描述
ColorScheme	返回输入配色方案及其颜色的顺序相反。

示例代码:

// reverses the order of colors in a primary scheme
// obtained from the getSchemes() method
let flippedScheme = colorSchemes.flipColors(primaryScheme);

getMatchingSchemes(params){ColorScheme[]}

起始版本: GeoScene API for JavaScript 4.22

返回与给定色带匹配的所有方案。

参数:

规范:

params Object 有关可能传递给此函数的每个参数的详细信息，请参见下表。 规范: theme String 要从中获取配色方案的主题的名称。 可选值:"high-to-low"|"above-and-below"|"centered-on"|"extremes" colors Color[] 用于与给定主题的方案匹配的颜色数组。 geometryType String 将应用配色方案的图层的几何类型。 worldScale Boolean optional 表示是否将在可视化中使用 3D 体积符号。 view SceneView optional 用于计算符号的建议大小的 SceneView 实例。这是 3D 可视化所必需的。

返回值:

类型	描述
ColorScheme[]	与给定颜色匹配的配色方案数组。

getSchemeByName(params){ColorScheme}

起始版本: GeoScene API for JavaScript 4.22

返回具有提供的名称的配色方案。

参数:

规范:

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" theme String 主题决定了在连续斜坡和地图中将强调哪些值。 下面列出了可能的值。 值 描述 示例 high-to-low 用深色强调高值。 above-and-below 以给定点为中心的值（例如平均值）用浅色显示，而其他值用深色强调。 centered-on 以给定点为中心的值（例如平均值）用深色强调，而其他值用浅色显示。 extremes 用浓烈的颜色强调高值和低值。 所有其他都用浅色显示。 可选值:"high-to-low"|"above-and-below"|"centered-on"|"extremes" view SceneView optional 方案所在的 SceneView 实例 将会被使用。 此属性仅适用于方案将与 3D 符号结合使用时。 worldScale Boolean optional 表示方案的尺寸单位是否以米为单位。 当方案用于 3D 体积符号时，这应该是 true。 如果此属性设置为 true，则必须提供 view。

返回值:

类型	描述
ColorScheme	返回具有给定名称的配色方案。

示例代码:

// Returns the Red Extremes 1 scheme
const redExtremesScheme = colorSchemes.getSchemeByName({
  basemapTheme: "light",
  geometryType: featureLayer.geometryType,
  theme: "extremes",
  name: "Red Extremes 1"
});

getSchemes(params){ColorSchemes}

返回主方案和辅助方案，这些方案定义了 FeatureLayer 中数据驱动的颜色可视化的符号属性。 basemap参数确定用于可视化每个要素的图形的配色方案。 geometryType 确定要返回的符号类型。

参数:

规范:

params Object 有关可能传递给此函数的每个参数的详细信息，请参见下表。 规范: basemap String|Basemap optional 与可视化配对的 GeoScene 底图。 这值表示用于根据给定底图可视化要素的最佳符号颜色。 如果你有一个 非 GeoScene 底图（例如具有自定义样式的 VectorTileLayer 底图）或根本没有底图，然后使用 basemapTheme 参数 而不是这个参数。 basemapTheme String optional 如果你有 非 GeoScene 底图（例如具有自定义样式的 VectorTileLayer 底图）或根本没有底图，使用此参数表示 可视化的背景是 light 还是 dark。 可选值:"light"|"dark" geometryType String 要可视化的要素的几何类型。 可选值:"point"|"multipoint"|"polyline"|"polygon"|"mesh"|"multipatch" theme String 主题决定了在连续斜坡和地图中将强调哪些值。 下面列出了可能的值。 值 描述 示例 high-to-low 用深色强调高值。 above-and-below 以给定点为中心的值（例如平均值）用浅色显示，而其他值用深色强调。 centered-on 以给定点为中心的值（例如平均值）用深色强调，而其他值用浅色显示。 extremes 用浓烈的颜色强调高值和低值。 所有其他都用浅色显示。 可选值:"high-to-low"|"above-and-below"|"centered-on"|"extremes" view SceneView optional 方案所在的 SceneView 实例 将会被使用。 此属性仅适用于方案将与 3D 符号结合使用时。 worldScale Boolean optional 表示方案的尺寸单位是否以米为单位。 当方案用于 3D 体积符号时，这应该是 true。 如果此属性设置为 true，则必须提供 view。

返回值:

类型	描述
ColorSchemes	返回一个对象，其中包含要用于给定底图的最佳配色方案和也可以使用的辅助方案。

示例代码:

// gets the primary scheme for the features of the given geometry type and basemap
let schemes = colorSchemes.getSchemes({
  basemap: map.basemap,
  geometryType: featureLayer.geometryType,
  theme: "extremes"
});

// the best default scheme for the layer, basemap, and theme
let primaryScheme = schemes.primaryScheme;

getSchemesByTag(params){ColorScheme[]}

起始版本: GeoScene API for JavaScript 4.22

返回带有所提供标记的配色方案数组。这些方案定义了可使用 Renderer 渲染的任何图层中数据驱动的颜色可视化的符号属性。

参数:

规范:

params Object 有关可能传递给此函数的每个参数的详细信息，请参见下表。 规范: includedTags String[] optional 提供后，将仅返回包含所有匹配标记的方案。 已知标签: light | dark | reds | yellows | oranges | greens | blues | purples | pinks | browns | grays | bright | subdued | colorblind-friendly | diverging | sequential | 3d excludedTags String[] optional 提供后，将仅返回缺少所有已提供标记的方案。 已知标签: light | dark | reds | yellows | oranges | greens | blues | purples | pinks | browns | grays | bright | subdued | colorblind-friendly | diverging | sequential | 3d basemap String|Basemap optional 与可视化配对的底图。 这 值表示根据给定底图可视化要素的最佳符号颜色。 basemapTheme String optional 如果你有 非 GeoScene 底图（例如具有自定义样式的 VectorTileLayer 底图）或根本没有底图，使用此参数表示 可视化的背景是 light 还是 dark。 可选值:"light"|"dark" geometryType String 要可视化的要素的几何类型。 可选值:"point"|"multipoint"|"polyline"|"polygon"|"mesh"|"multipatch" theme String 主题决定了在连续斜坡和地图中将强调哪些值。 下面列出了可能的值。 值 描述 示例 high-to-low 用深色强调高值。 above-and-below 以给定点为中心的值（例如平均值）用浅色显示，而其他值用深色强调。 centered-on 以给定点为中心的值（例如平均值）用深色强调，而其他值用浅色显示。 extremes 用浓烈的颜色强调高值和低值。 所有其他都用浅色显示。 可选值:"high-to-low"|"above-and-below"|"centered-on"|"extremes" view SceneView optional 方案所在的 SceneView 实例 将会被使用。 此属性仅适用于方案将与 3D 符号结合使用时。 worldScale Boolean optional 表示方案的尺寸单位是否以米为单位。 当方案用于 3D 体积符号时，这应该是 true。 如果此属性设置为 true，则必须提供 view。

返回值:

类型	描述
ColorScheme[]	返回包含或排除所提供标记的配色方案数组。

示例代码:

// Returns all the red color schemes that are color-blind friendly
let schemes = colorSchemes.getSchemesByTag({
  basemap: map.basemap,
  geometryType: featureLayer.geometryType,
  theme: "extremes",
  includedTags: [ "reds", "deuteranopia", "protanopia", "tritanopia" ]
});

getThemes(basemap){Theme[]}

返回可用主题的元数据。 如果提供了底图，则返回效果最佳的主题使用给定的底图。

参数:

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

返回值:

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

类型定义

ColorScheme ColorSchemeForPoint|ColorSchemeForPolyline|ColorSchemeForPolygon|ColorSchemeForMesh

定义符号系统方案的属性，该方案用于可视化具有属性数据驱动颜色的要素。

ColorSchemeForMesh

定义符号系统方案的属性，该方案用于可视化具有属性数据驱动颜色的网格要素。

属性:

name String 方案的唯一名称。

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

id String 要在可视化中使用的配色方案的唯一 ID。 身份证是 根据以下模板分配：<themeName>/<basemapName>/<schemeName>。

theme String 表示将在连续斜坡和地图中强调哪些值。 下面列出了可能的值。 值 描述 示例 high-to-low 用深色强调高值。 above-and-below 以给定点为中心的值（例如平均值）用浅色显示，而其他值用深色强调。 centered-on 以给定点为中心的值（例如平均值）用深色强调，而其他值用浅色显示。 extremes 用浓烈的颜色强调高值和低值。 所有其他都用浅色显示。

colors Color[] 将应用于可视化的连续色带。

noDataColor Color 用于表示符号颜色没有数据的特征和超出范围的特征。

colorsForClassBreaks Object[] 用于可视化的预定义分类配色方案。 规范: colors Color[] 十六进制颜色字符串数组。 每种颜色都是 分配给分类颜色可视化中的特定中断。 numClasses Number 分类颜色可视化中使用的类数。

opacity Number 符号的不透明度。

ColorSchemeForPoint

定义符号系统方案的属性，该方案用于使用属性数据驱动颜色可视化点要素。

属性:

name String 方案的唯一名称。

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

id String 要在可视化中使用的配色方案的唯一 ID。 身份证是 根据以下模板分配：<themeName>/<basemapName>/<schemeName>。

theme String 表示将在连续斜坡和地图中强调哪些值。 下面列出了可能的值。 值 描述 示例 high-to-low 用深色强调高值。 above-and-below 以给定点为中心的值（例如平均值）用浅色显示，而其他值用深色强调。 centered-on 以给定点为中心的值（例如平均值）用深色强调，而其他值用浅色显示。 extremes 用浓烈的颜色强调高值和低值。 所有其他都用浅色显示。

colors Color[] 将应用于可视化的连续色带。

noDataColor Color 用于表示的符号颜色 没有数据的特征和超出范围的特征。

colorsForClassBreaks Object[] 用于可视化的预定义分类配色方案。 规范: colors Color[] 十六进制颜色字符串数组。 每种颜色都是 分配给分类颜色可视化中的特定中断。 numClasses Number 分类颜色可视化中使用的类数。

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

size Number 符号的默认大小（以像素或磅为单位）。

opacity Number 符号的不透明度。

ColorSchemeForPolygon

定义符号系统方案的属性，该方案用于可视化具有属性数据驱动颜色的面要素。

属性:

name String 方案的唯一名称。

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

id String 要在可视化中使用的配色方案的唯一 ID。 身份证是 根据以下模板分配：<themeName>/<basemapName>/<schemeName>。

theme String 表示将在连续斜坡和地图中强调哪些值。 下面列出了可能的值。 值 描述 示例 high-to-low 用深色强调高值。 above-and-below 以给定点为中心的值（例如平均值）用浅色显示，而其他值用深色强调。 centered-on 以给定点为中心的值（例如平均值）用深色强调，而其他值用浅色显示。 extremes 用浓烈的颜色强调高值和低值。 所有其他都用浅色显示。

colors Color[] 将应用于可视化的连续色带。

noDataColor Color 用于表示的符号颜色 没有数据的特征和超出范围的特征。

colorsForClassBreaks Object[] 用于可视化的预定义分类配色方案。 规范: colors Color[] 十六进制颜色字符串数组。 每种颜色都是 分配给分类颜色可视化中的特定中断。 numClasses Number 分类颜色可视化中使用的类数。

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

opacity Number 符号的不透明度。

ColorSchemeForPolyline

定义符号系统方案的属性，该方案用于可视化具有属性数据驱动颜色的折线要素。

属性:

name String 方案的唯一名称。

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

id String 要在可视化中使用的配色方案的唯一 ID。 身份证是 根据以下模板分配：<themeName>/<basemapName>/<schemeName>。

theme String 表示将在连续斜坡和地图中强调哪些值。 下面列出了可能的值。 值 描述 示例 high-to-low 用深色强调高值。 above-and-below 以给定点为中心的值（例如平均值）用浅色显示，而其他值用深色强调。 centered-on 以给定点为中心的值（例如平均值）用深色强调，而其他值用浅色显示。 extremes 用浓烈的颜色强调高值和低值。 所有其他都用浅色显示。

colors Color[] 将应用于可视化的连续色带。

noDataColor Color 用于表示的符号颜色 没有数据的特征和超出范围的特征。

colorsForClassBreaks Object[] 用于可视化的预定义分类配色方案。 规范: colors Color[] 十六进制颜色字符串数组。 每种颜色都是 分配给分类颜色可视化中的特定中断。 numClasses Number 分类颜色可视化中使用的类数。

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

opacity Number 符号的不透明度。

ColorSchemes

getSchemes() 方法的返回对象。

属性:

primaryScheme ColorScheme 最适合给定底图和几何类型的配色方案。

secondarySchemes ColorScheme[] 可用于可视化叠加在给定底图上的给定几何类型的数据的其他配色方案。

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

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

Theme

描述与给定底图完美匹配的主题。有关此对象中属性的更多详细信息，请参阅下表。

属性:

name String 主题的名称。

label String 标识 UI 元素中主题的标签。

description String 描述 UI 中主题的文本。

basemaps String[] 与给定主题完美匹配的 GeoScene 底图。