LineOfSightAnalysisTarget

AMD: require(["geoscene/analysis/LineOfSightAnalysisTarget"], (LineOfSightAnalysisTarget) => { /* code goes here */ });
ESM: import LineOfSightAnalysisTarget from "@geoscene/core/analysis/LineOfSightAnalysisTarget";
类: geoscene/analysis/LineOfSightAnalysisTarget
继承于:LineOfSightAnalysisTarget Accessor
起始版本:GeoScene Maps SDK for JavaScript 4.23

LineOfSightAnalysisTarget 表示 LineOfSightAnalysis 的目标。

使用 position 属性来指定目标的位置。

另请参阅

构造函数

new LineOfSightAnalysisTarget(properties)
参数
properties Object
optional

有关可能传递给构造函数的所有属性的列表,请参见属性

属性概述

可以设置、检索或侦听任何属性。请参阅使用属性主题。
显示继承属性 隐藏继承属性
名称 类型 描述
String

类的名称。

更多详情
Accessor
Object

指定目标在垂直轴 (z) 上的放置方式。

更多详情
LineOfSightAnalysisTarget
Graphic

指定应从交叉测试中排除的要素。

更多详情
LineOfSightAnalysisTarget
Point

表示目标的位置的 Point

更多详情
LineOfSightAnalysisTarget

属性详细信息

declaredClass Stringreadonly inherited

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

elevationInfo Object

指定目标在垂直轴 (z) 上的放置方式。有关如何使用该属性的示例,请参阅 ElevationInfo 示例

属性
mode String

定义目标相对于地形表面或场景中 3D 对象的放置方式。有关可能值列表,请参见下表。

elevation-info

模式 描述
on-the-ground 目标与 Ground 对齐。如果场景包含 IntegratedMeshLayer,则要素将与 IntegratedMeshLayer 对齐。如果要素具有 z 值,则在此模式下会忽略 z 值。带有 2D 符号的要素叠加在 GroundIntegratedMeshLayer 上。这是没有 z 值的图层的默认模式,其中包含使用 ObjectSymbol3DLayer 渲染的 PolylinePolygon 要素或 Point 要素。
absolute-height 目标放置在海平面以上的绝对高程 (z 值) 处。此 z 值由几何的 z 值 (如果存在) 确定。如果定义了 featureExpressionInfo,则使用表达式的结果而不是几何的 z 值。此模式不考虑使用 Ground 或任何其他图层的高程。当目标位置 hasZtrue 时,这是默认值。
relative-to-ground 目标放置在相对于 GroundIntegratedMeshLayer 的高度上。高程由 GroundIntegratedMeshLayer 的高程和几何 z 值 (如果存在) 的总和确定。如果定义了 featureExpressionInfo,则使用表达式的结果而不是目标的 z 值。如果目标没有 z 值,则 relative-to-ground 是使用 IconSymbol3DLayers 渲染的 Point 几何的默认值。
relative-to-scene 目标与拉伸多边形、3D Object SceneLayersBuildingSceneLayers 对齐,具体取决于哪个高程更高。如果要素不在建筑物或任何其他要素的正上方,则将其与 GroundIntegratedMeshLayer 的高程对齐。如果存在,则将目标的 z 值添加到高程中。如果定义了 featureExpressionInfo,则使用表达式的结果而不是几何的 z 值。

可能值"on-the-ground"|"relative-to-ground"|"absolute-height"|"relative-to-scene"

offset Number
optional

添加到目标垂直位置的高程偏移。如果未定义 unit,则偏移量以 meters 为单位。当 mode = "on-the-ground" 时,则此属性无效。

feature Graphic

指定应从交叉测试中排除的要素。在场景几何上放置视线位置时使用此选项。由于细节级别的原因,场景几何可能会发生变化,从而导致分析结果不稳定。通过指定要从交叉测试中排除的要素,可以避免此问题。

请注意,您可分配客户端图形,这些图形将被相应地考虑在内。然而,有关客户端图形的信息将不会持久化,并在反序列化后产生空的引用。

position Pointautocast

表示目标的位置的 Point。一旦设置了位置,新视线分析将同步计算相交点和可见性。

方法概述

显示继承的方法 隐藏继承的方法
名称 返回值类值 描述

添加一个或多个与对象的生命周期相关联的句柄。

更多详情
Accessor
this

创建此对象的深度克隆。

更多详情
LineOfSightAnalysisTarget
Boolean

如果存在指定的句柄组,则返回 true。

更多详情
Accessor

移除对象拥有的句柄组。

更多详情
Accessor

方法详细说明

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(){this}

创建此对象的深度克隆。任何通过引用存储值的属性都将被分配克隆实例上引用值的副本。

返回
类型 描述
this 调用此方法的类实例的深度克隆。
hasHandles(groupKey){Boolean}inherited
起始版本: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");

您的浏览器不再受支持。请升级您的浏览器以获得最佳体验。请参阅浏览器弃用帖子以获取更多信息