DotDensityRenderer

layer.renderer = {
  type: "dot-density",  // autocasts as new DotDensityRenderer()
  dotValue: 1000,  // 1 dot = 1,000 people when the view.scale is 1:1,000,000
  referenceScale: 1000000,  // view.scale
  attributes: [{
    field: "ELEMENTARY_SCHOOL",
    label: "Elementary School",
    color: "red"
  }, {
    field: "MIDDLE_SCHOOL",
    label: "Middle School",
    color: "blue"
  }, {
    field: "HIGH_SCHOOL",
    label: "High School",
    color: "orange"
  }, {
    valueExpression: "$feature.ASSOCIATES_DEGREE + $feature.BACHELOR_DEGREE + $feature.MASTER_DEGREE + $feature.DOCTORATE_DEGREE",
    valueExpressionTitle: "People who completed university",
    label: "University"
    color: "green"
  }]
}

属性概览

属性详细信息

attributes AttributeColorInfo[]

定义用于可视化密度的变量。这是一个对象数组，每个对象都引用用于驱动密度的数值字段值或 Arcade 表达式。还必须设置与每个值对应的颜色。

如果设置单个属性，POPULATION 并将其与 black 匹配，且 dotValue 为 100，则为每个要素渲染的黑点数将大约等于 POPULATION 值除以 100。

此属性限制为不超过 8 个属性。

另请参阅：

• Arcade 可视化配置文件

示例：

renderer.attributes = [{
  field: "POPULATION",
  label: "Population (2019)",
  color: "gray"
}];

authoringInfo AuthoringInfoautocast inherited

编写元数据仅包含在从智能制图创建者方法之一生成的渲染器中，例如 sizeRendererCreator.createContinuousRenderer() 或 colorRendererCreator.createContinuousRenderer()。这包括来自 UI 元素（如滑块）和所选分类方法和主题的信息。这允许创作客户端保存特定的可重写设置，以便下次通过 UI 访问它时，可以记住它们的选择。

backgroundColor Colorautocast

Autocasts from Object|Number[]|String

用于对点后面的面填充进行着色的颜色。这可以用一个命名字符串自动转换；十六进制字符串；rgb 或 rgba 值的数组；具有 r、g、b 和 a 属性的对象；或颜色对象。

默认值：[0, 0, 0, 0.25] - black, semitransparent

示例：

// CSS color string
renderer.backgroundColor = "dodgerblue";

// HEX string
renderer.backgroundColor = "#33cc33";

// array of RGBA values
renderer.backgroundColor = [51, 204, 51, 0.3];

// object with rgba properties
renderer.backgroundColor = {
  r: 51,
  g: 51,
  b: 204,
  a: 0.7
};

declaredClass Stringreadonly inherited

类的名称。声明的类名的格式为 geoscene.folder.className。

dotBlendingEnabled Boolean

仅当指定了两个或多个属性时才适用。当 true，表示重叠点的颜色将混合。例如，在高密度红点之上存在高密度蓝点的要素中，如果此属性为 true，则某些点可能显示为紫色点。当 false 只有一种颜色在渲染中比其他颜色更受青睐时。

混合已启用	混合已禁用

默认值：true

dotSize Number

起始版本：GeoScene API for JavaScript 4.23

定义点的大小（以磅为单位）。

默认值：1

示例：

renderer.dotSize = 0.5;

dotValue Number

定义用于可视化密度的初始点值。如果提供了 referenceScale，则此值指示 view.scale 上每个点的值与 referenceScale 中的值匹配。如果设置了 referenceScale，则点值将根据视图比例重新计算。请注意，即使在这种情况下，dotValue 的值也将保持不变。图例中显示的变量点值使用 calculateDotValue() 重新计算。如果未提供 referenceScale，则此属性中指定的值将应用于所有比例下的点。

示例：

// Indicates that 1 dot = 100 people at any view scale
renderer.dotValue = 100;
renderer.legendOptions = {
  unit: "people"
};

// Indicates that 1 dot = 100 people only when the view's scale is 1:500,000
// And a new dot value is computed as the scale changes.
renderer.dotValue = 100;
renderer.legendOptions = {
  unit: "people"
};
renderer.referenceScale = 500000;

legendOptions Object

一个对象，提供用于在图例中配置渲染器的选项。

属性：

unit String optional 指示要可视化的数据的单位。这将显示在图例标题中的点值旁边。

示例：

// Legend will display: "1 dot = 50 cows"
renderer.dotValue = 50;
renderer.legendOptions = {
  unit: "cows"
};

outline SimpleLineSymbolautocast

面的轮廓。如果未设置，这将使用默认的 SimpleLineSymbol 进行渲染。最好为每个 DotDensityRenderer 显式设置此项。要么完全删除轮廓，要么将其设置为非常薄的透明样式，这样它就不会偏离点密度。

示例：

// removes the default outline from the renderer
renderer.outline = null;

// sets a thin, transparent outline to the renderer
renderer.outline = {
  color: [ 128,128,128, 0.2 ],
  width: 0.5
};

// disable the default outline
renderer.outline = null;

referenceScale Number

定义后，渲染器将使用 calculateDotValue() 方法根据视图比例的变化线性重新计算点值。渲染将保持在各种比例下以提供的比例绘制的点的密度。但是，点值将随着用户从提供的比例值放大或缩小而更改，尽管 dotValue 的值将保持不变。

当计算出的点值达到 1 时，随着用户进一步放大，点值将不再重新计算。

示例：

// Indicates that 1 dot = 100 people only when the view's scale is 1:500,000
// And a new dot value is computed as the scale changes.
// When the scale is 1:250,000, the dot value will be 50.
renderer.dotValue = 100;
renderer.legendOptions = {
  unit: "people"
};
renderer.referenceScale = 500000;

seed Number

设置为一致值时，假设渲染器中的所有参数都相同，则点放置将保留相同的比例。根据设计，不同比例的相同要素的点放置会有所不同。如果用户希望查看给定比例的不同点位置集，开发人员可以提供备用种子值来重新计算点的随机位置。

默认值：1

type Stringreadonly

渲染器的类型。

对于 DotDensityRenderer，类型始终是"dot-density"。

visualVariables VisualVariable[]autocast

Autocasts from Object[]

大小视觉变量对象的数组。只应提供一个 ScaleDependentStops 视觉变量。此视觉变量用于根据 view.scale 改变轮廓宽度。有关此示例，请参阅下面的代码段。

示例：

renderer.visualVariables = [{
  type: "size",
  target: "outline",
  valueExpression: "$view.scale",
  stops: [
    { size: 1.5, value: 1881217},
    { size: 0.75, value: 5878804},
    { size: 0.375, value: 23515218},
    { size: 0, value: 47030436},
  ]
}];

方法概述

方法详细信息

calculateDotValue(scale){Number}

为提供 referenceScale 的情况计算给定比例的更新点值。这允许图例在用户放大或缩小视图中时更新点值。

参数：

scale Number 用于计算新点值的视图比例。

返回：

类型	说明
Number	用于根据给定视图比例渲染点的点值。

clone(){DotDensityRenderer}

创建渲染器的深度克隆。

返回：

类型	说明
DotDensityRenderer	调用此方法的对象的深度克隆。

示例：

// Creates a deep clone of the first layer's renderer
let renderer = view.map.layers.getItemAt(0).renderer.clone();

fromJSON(json){*}static

创建此类的新实例，并使用从 GeoScene 产品生成的 JSON 对象中的值对其进行初始化。传递到输入 json 参数中的对象通常来自对 REST API 中查询操作的响应或来自其他 GeoScene 产品的 toJSON() 方法。请参阅指南中的使用 fromJSON() 主题，了解有关何时以及如何使用此功能的详细信息和示例。

参数：

json Object GeoScene 格式的实例的 JSON 表示形式。有关各种输入 JSON 对象的结构示例，请参阅 GeoScene REST API documentation。

返回：

类型	说明
*	返回此类的新实例。

toJSON(){Object}inherited

将此类的实例转换为其 GeoScene portal JSON 表示形式。有关详细信息，请参阅使用 fromJSON() 指南主题。

返回：

类型	说明
Object	此类实例的 GeoScene portal JSON 表示形式。