SimpleMarkerSymbol

AMD: require(["geoscene/symbols/SimpleMarkerSymbol"], (SimpleMarkerSymbol) => { /* 代码 */ });
ESM: import SimpleMarkerSymbol from "@geoscene/core/symbols/SimpleMarkerSymbol";
类: geoscene/symbols/SimpleMarkerSymbol
继承于: SimpleMarkerSymbol MarkerSymbol Symbol Accessor
起始版本: GeoScene API for JavaScript 4.22

SimpleMarkerSymbol 用于在 MapView 或 SceneView 中渲染具有简单形状和 color 的 2D Point 几何图形。它可以用纯 color 填充,并具有可选的 outline,该轮廓是用 SimpleLineSymbol 定义的。

SimpleMarkerSymbols 可应用于 FeatureLayer 或单个 graphics中的点要素或面要素。标记符号可在 3D SceneView使用。但是,建议您改用 PointSymbol3D。下图描述了一个 FeatureLayer,其点要素使用 SimpleMarkerSymbols 设置样式。

sms-samplesms-sample

示例:
示例代码:
let symbol = {
  type: "simple-marker",  // 转换成 new SimpleMarkerSymbol()
  style: "square",
  color: "blue",
  size: "8px",  // pixels
  outline: {  // 转换成 new SimpleLineSymbol()
    color: [ 255, 255, 0 ],
    width: 3  // points
  }
};

构造函数

new SimpleMarkerSymbol(properties)
参数:
properties Object
optional

所有可传入构造函数的属性,请参见属性列表

属性列表

可以设置、检索或监听的属性。参见 使用属性
展示继承属性 隐藏继承属性
属性 类型 描述
Number更多信息

标记相对于屏幕的角度,以度为单位。

更多信息MarkerSymbol
Color更多信息

符号的颜色。

更多信息SimpleMarkerSymbol
String更多信息

类名。

更多信息Accessor
SimpleLineSymbol更多信息

标记符号的轮廓。

更多信息SimpleMarkerSymbol
String更多信息

图标的 SVG 路径。

更多信息SimpleMarkerSymbol
Number更多信息

标记的大小(以磅为单位)。

更多信息SimpleMarkerSymbol
String更多信息

标记样式。

更多信息SimpleMarkerSymbol
String更多信息

符号类型。

更多信息SimpleMarkerSymbol
Number更多信息

x 轴上的偏移量。

更多信息MarkerSymbol
Number更多信息

y 轴上的偏移量。

更多信息MarkerSymbol

属性详细说明

标记相对于屏幕的角度,以度为单位。

已知限制

3D SceneViews 目前不支持此属性。

默认值:0
自动转换自 Object|number[]|string

符号的颜色。 这可以使用 rgb(a) 值数组、命名字符串、十六进制字符串或 hsl(a) 字符串进行自动转换, 具有 rgba 属性或 颜色对象。

color 属性不适用于使用 cross 或 x style定义的标记符号。由于这些样式完全由轮廓组成,因此必须修改 outline.color 属性以设置具有这些样式的符号的颜色。

默认值:[255, 255, 255, 0.25] - white, semitransparent
示例代码:
// CSS color string
symbol.color = "dodgerblue";
// HEX string
symbol.color = "#33cc33";
// array of RGBA values
symbol.color = [51, 204, 51, 0.3];
// object with rgba properties
symbol.color = {
  r: 51,
  g: 51,
  b: 204,
  a: 0.7
};
declaredClass Stringreadonly inherited
起始版本: GeoScene API for JavaScript 4.22

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

标记符号的轮廓。 color 对象的属性直接修改使用 crossx style 定义的标记符号的整体颜色。

示例代码:
let sym = {
  type: "simple-marker",  // 转换成 new SimpleMarkerSymbol()
  color: "red",
  outline: {  // 转换成 new SimpleLineSymbol()
    color: [ 128, 128, 128, 0.5 ],
    width: "0.5px"
  }
};
path String

图标的 SVG 路径。

已知限制

此属性仅适用于 2D。

自动转换自 String|Number

标记的大小(以磅为单位)。此值可以是自动转换的,其字符串以磅或像素表示大小(例如 12px)。

默认值:12
示例代码:
// size in points
symbol.size = 14;
// size in pixels
symbol.size = "20px";
// size in points
symbol.size = "14pt";
style String

标记样式。下表中列出了可能的值。

描述
circle sms_circle
cross sms_cross
diamond sms_diamond
square sms_square
triangle sms_triangle
x sms_x

可选值:"circle"|"square"|"cross"|"x"|"diamond"|"triangle"|"path"

默认值:circle
type Stringreadonly

符号类型。

对于SimpleMarkerSymbol ,类型始终是 "simple-marker"。

自动转换自 Number|String

x 轴上的偏移量,以磅为单位。 此值可以使用字符串自动转换 以磅或像素表示大小(例如 12px)。

默认值:0
示例代码:
// xoffset in points
symbol.xoffset = 4;
// xoffset in pixels
symbol.xoffset = "2px";
// xoffset in points
symbol.xoffset = "4pt";
自动转换自 Number|String

y 轴上的偏移量,以磅为单位。 此值可以使用字符串自动转换 以磅或像素表示大小(例如 12px)。

默认值:0
示例代码:
// yoffset in points
symbol.yoffset = 4;
// yoffset in pixels
symbol.yoffset = "2px";
// yoffset in points
symbol.yoffset = "4pt";

方法列表

展示继承方法 隐藏继承方法
属性 返回值类型 描述
SimpleMarkerSymbol更多信息

创建符号的深层克隆。

更多信息SimpleMarkerSymbol
*更多信息

创建此类的新实例并使用从 GeoScene产品生成的 JSON 对象的值对其进行初始化。

更多信息Symbol
Object更多信息

将此类的实例转换为其 GeoScene portal JSON 格式。

更多信息Symbol

方法详细说明

创建符号的深层克隆。

返回值:
类型 描述
SimpleMarkerSymbol 返回调用此方法对象的深拷贝。
示例代码:
// Creates a deep clone of the graphic's symbol
let symLyr = graphic.symbol.clone();
fromJSON(json){*}static

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

参数:
json Object

实例的 json 表达式,以geoscene 格式显示。

返回值:
类型 描述
* 返回一个该类的新实例。
toJSON(){Object}inherited

将此类的实例转换为 GeoScene portal JSON 格式。 有关更多信息,请参阅 使用 fromJSON() 指南。

返回值:
类型 描述
Object 此类实例的 GeoScene portal JSON 格式。

Your browser is no longer supported. Please upgrade your browser for the best experience. See our browser deprecation post for more details.