旋转视觉变量定义了在 MapView 中使用标记符号或文本符号进行渲染的要素如何旋转。旋转值是通过将值映射到字段中的数据来确定的,或者通过使用 Arcade 表达式的其他算术方法来确定。
此对象可用于描述各种变量,如风向、车辆航向等。
const rotationVisualVariable = {
type: "rotation",
field: "heading",
rotationType: "geographic"
};
renderer.visualVariables = [ rotationVisualVariable ];
构造函数
属性概述
名称 | 类型 | 描述 | 类 |
---|---|---|---|
String | 仅适用于在 SceneView 中工作。 更多详情 | RotationVariable | |
String | 类的名称。 更多详情 | Accessor | |
String | 数字属性字段的名称,包含用于确定每个要素的颜色/不透明度/大小/旋转的数据值。 更多详情 | VisualVariable | |
Object | 对象,可提供用于在 Legend 中显示可视变量的选项。 更多详情 | VisualVariable | |
String | 根据如何测量旋转角度定义旋转的原点和方向。 更多详情 | RotationVariable | |
String | 视觉变量类型。 更多详情 | RotationVariable | |
String | 遵循 Arcade 可视化配置文件定义的规范的 Arcade 表达式 表达式。 更多详情 | VisualVariable | |
String | 标题,用于标识和描述 valueExpression 属性中定义的关联 Arcade 表达式 表达式。 更多详情 | VisualVariable |
属性详细信息
-
axis String
-
仅适用于在 SceneView 中工作。定义在使用 ObjectSymbol3DLayer 渲染要素时应应用于旋转视觉变量的轴。
如果符号资源是对齐的,其前向侧指向 y 轴方向 (y 轴在 WGS84 或 WebMercator 坐标中始终指向北),其向上侧指向 z 轴方向,其右侧指向 x 轴方向 (x 轴在 WGS84 或 WebMercator 坐标中始终指向东),则以下旋转轴将按照其名称所示旋转符号。
可能值 描述 heading 符号在水平面中的旋转 (即围绕 z 轴)。 tilt 符号在纵向垂直平面中的旋转 (即围绕 x 轴)。 roll 符号在横向垂直平面中的旋转 (即围绕 y 轴)。 可能值:"heading"|"tilt"|"roll"
- 默认值:heading
-
类的名称。声明的类名称格式化为
geoscene.folder.className
。
-
数字属性字段的名称,包含用于确定每个要素的颜色/不透明度/大小/旋转的数据值。
-
对象,可提供用于在 Legend 中显示可视变量的选项。
- 属性
-
showLegend Boolean
指定是否在图例中显示可视变量。
title String描述 Legend 中视觉变量可视化的标题。这优先于字段别名或 valueExpressionTitle。
-
rotationType String
-
根据如何测量旋转角度定义旋转的原点和方向。有关可能值列表,请参见下表。此属性仅适用于围绕
heading
轴的旋转。值 描述 geographic 从北按顺时针方向旋转符号。 arithmetic 从东按逆时针方向旋转符号。 可能值:"geographic"|"arithmetic"
- 默认值:geographic
-
type Stringreadonly
-
视觉变量类型。
对于 RotationVariable,类型总是 "rotation"。
-
遵循 Arcade 可视化配置文件定义的规范的 Arcade 表达式 表达式。视觉变量中的表达式可能使用
$feature
配置变量来引用字段值,并且必须返回一个数字。从该表达式返回的值是用于派生在 stops 中定义的可视化的数据。此表达式优先于字段。因此,该属性通常用作视觉变量中字段的替代视觉变量。
- 另请参阅
-
标题,用于标识和描述 valueExpression 属性中定义的关联 Arcade 表达式 表达式。如果 legendOptions 属性中没有提供
title
,则它将在 Legend 中显示为相应视觉变量的标题。
方法概述
名称 | 返回值类值 | 描述 | 类 |
---|---|---|---|
添加一个或多个与对象的生命周期相关联的句柄。 更多详情 | Accessor | ||
RotationVariable | 创建 RotationVariable 的深度克隆。 更多详情 | RotationVariable | |
* | 创建此类的新实例并使用从 GeoScene 产品生成的 JSON 对象值对其进行初始化。 更多详情 | RotationVariable | |
Boolean | 如果存在指定的句柄组,则返回 true。 更多详情 | Accessor | |
移除对象拥有的句柄组。 更多详情 | Accessor | ||
Object | 将此类的实例转换为 GeoScene Portal JSON 表示。 更多详情 | RotationVariable |
方法详细说明
-
addHandles(handleOrHandles, groupKey)inherited起始版本:GeoScene Maps SDK for JavaScript 4.25
-
添加一个或多个与对象的生命周期相关联的句柄。当对象被销毁时,将移除句柄。
// Manually manage handles const handle = reactiveUtils.when( () => !view.updating, () => { wkidSelect.disabled = false; }, { once: true } ); // Handle gets removed when the object is destroyed. this.addHandles(handle);
参数handleOrHandles WatchHandle|WatchHandle[]对象销毁后,标记为要移除的句柄。
groupKey *optional标识句柄应添加到的组的键。组中的所有句柄稍后都可使用 Accessor.removeHandles() 进行删除。如果未提供键,则句柄将被添加到默认组。
-
clone(){RotationVariable}
-
创建 RotationVariable 的深度克隆。
返回类型 描述 RotationVariable 调用此方法的旋转视觉变量的深度克隆。 示例// Creates a deep clone of the visual variable let renderer = renderer.visualVariables[0].clone();
-
fromJSON(json){*}static
-
创建此类的新实例并使用从 GeoScene 产品生成的 JSON 对象值对其进行初始化。传入到输入
json
参数的对象通常来自对 REST API 中查询操作的响应或来自另一个 GeoScene 产品的 toJSON() 方法。有关何时以及如何使用该函数的详细信息和示例,请参阅指南中的使用 fromJSON() 主题。参数json ObjectGeoScene 格式实例的 JSON 表示。有关各种输入 JSON 对象的结构示例,请参阅 GeoScene REST API 文档。
返回类型 描述 * 返回该类的新实例。
-
起始版本:GeoScene Maps SDK for JavaScript 4.25
-
如果存在指定的句柄组,则返回 true。
参数groupKey *optional组键。
返回类型 描述 Boolean 如果存在指定的句柄组,则返回 true
。示例// Remove a named group of handles if they exist. if (obj.hasHandles("watch-view-updates")) { obj.removeHandles("watch-view-updates"); }
-
removeHandles(groupKey)inherited起始版本:GeoScene Maps SDK for JavaScript 4.25
-
移除对象拥有的句柄组。
参数groupKey *optional要移除的组键或组键的数组或集合。
示例obj.removeHandles(); // removes handles from default group obj.removeHandles("handle-group"); obj.removeHandles("other-handle-group");
-
toJSON(){Object}
-
将此类的实例转换为 GeoScene Portal JSON 表示。有关详细信息,请参阅使用 fromJSON() 指南主题。
返回类型 描述 Object 此类实例的 GeoScene Portal JSON 表示。