IonSnapService
Cesium v1.147 · 中文

提供基于 Cesium ion 3D Tiles 资产的互动式几何捕捉功能。 由 BIM/CAD 数据库模型支持,使用 ion REST API 的元素捕捉功能。 端点。 此类处理源 BIM/CAD 数据库参考框架与视依赖屏幕空间像素坐标之间的转换。 每次捕捉时,均使用 ion 资产的源参考框架、相机变换和画布尺寸进行转换,以确保视依赖特性——如像素孔径、最近位置或表面跟踪——能够正确工作。 此对象通常不直接实例化,请使用 IonSnapService.fromAssetId。 该特性并非最终定稿,可能根据 Cesium 的标准弃用政策发生变化。 const snapper = await Cesium.IonSnapService.fromAssetId(123456); const canvas = viewer.scene.canvas; This object is normally not instantiated directly, use IonSnapService.fromAssetId.

new Cesium.IonSnapService(options)

Name Type Description
options object Object with the following properties:
Name Type Description
assetId number 离子资产 ID。
resource Resource 资产的 ion API 资源。
ecefTransform Matrix4 从源 BIM/CAD 数据库参考框架到世界固定参考框架的 4x4 变换矩阵。
Example:
testPoint: pickedPosition,
camera: viewer.camera,
canvasWidth: canvas.clientWidth,
canvasHeight: canvas.clientHeight,
if (Cesium.defined(result)) {
console.log("snapped to", result.snapPoint);
对象包含以下属性:
canvasHeight: canvas.clientHeight,
});
if (Cesium.defined(result)) {
console.log("snapped to", result.snapPoint);
}
Experimental

This elementId: "0x30000000df2",

See:

Members

static constant Cesium.IonSnapService.DEFAULT_SNAP_APERTURE : number

The default snap tolerance used by IonSnapService#snap when 未提供 options.snapAperture 时,由 IonSnapService#snap 使用的默认捕捉容差,以 CSS 像素为单位,表示世界到视图输出空间的尺寸。此值在此实现中对应 SnapService 的 world-to-view output space. This is SnapService's 该功能尚未定稿,可能会根据 Cesium 的标准弃用政策进行变更。
Experimental

This feature is not final and is subject to change without Cesium's standard deprecation policy.

readonly assetId : number

此 snapper 操作的离子资产 ID。

readonly ecefTransform : Matrix4

从源 BIM/CAD 数据库参考框架到世界固定参考框架的 4x4 变换矩阵。

Methods

async static Cesium.IonSnapService.fromAssetId(assetId, options) → Promise.<IonSnapService>

为给定离子资产创建 IonSnapService,从 ion REST API 获取 资产的 ECEF 变换。
Name Type Description
assetId number 由 BIM/CAD 数据库模型支持的 3D Tiles 资产的离子 ID。
options object optional 具有以下属性的对象:
Name Type Default Description
accessToken string Ion.defaultAccessToken optional 使用的离子访问令牌。
server string | Resource Ion.defaultServer optional 使用的 ion API 服务器。
Returns:
A 绑定到该资产的 snapper。
Throws:
  • RuntimeError : The 资产没有地理定位,因此无法进行视图正确的捕捉。
Experimental

This 该功能尚未最终确定,可能根据 Cesium 的标准弃用政策进行变更。

async snap(options) → Promise.<(IonSnapService.Result|undefined)>

针对该资产的元素请求捕捉。 视图正确的世界到视图矩阵由以下参数组成: options.camera、options.canvasWidth 和 options.canvasHeight,以便根据视图进行捕捉(最近 排序、像素开口、表面跟踪)与当前视图匹配。 仅支持 3D 视图:相机必须处于 SceneMode.SCENE3D。
Name Type Description
options object 具有以下属性的对象:
Name Type Default Description
elementId string 要捕捉的元素 ID,以十六进制字符串表示,例如 "0x30000000df2"。
testPoint Cartesian3 要捕捉的点,通常是选中的光标位置。
camera Camera 定义当前视图的相机。必须处于 SceneMode.SCENE3D 模式下。
canvasWidth number Canvas 宽度,以 CSS 像素为单位。
canvasHeight number Canvas 高度,以 CSS 像素为单位。
closePoint Cartesian3 options.testPoint optional 靠近目标几何体的参考点,用于启动捕捉搜索。
snapAperture number IonSnapService.DEFAULT_SNAP_APERTURE optional 捕捉容差,以 CSS 像素为单位,表示世界到视图输出空间的尺寸。
snapMode IonSnapMode IonSnapMode.NEAREST optional 要执行的捕捉类型。
Returns:
The 捕捉结果;如果元素未找到或无法进行捕捉,则返回 undefined。
Experimental

This 该功能尚未最终确定,可能根据 Cesium 的标准弃用政策进行变更。

Type Definitions

Cesium.IonSnapService.Result

成功执行 IonSnapService#snap 的结果。扩展 SnapService.Result 并添加 ion 特有的字段。
Properties:
Name Type Attributes Description
snapPoint Cartesian3 <optional>
被捕捉的点。这是需要使用的点。
hitPoint Cartesian3 <optional>
光标与几何体的接触点:在捕捉范围内为最近边缘点,否则为光标下的表面点。
heat IonSnapHeat <optional>
捕捉点与视图空间中的闭合点之间的接近程度。
geometryType IonSnapGeometryType <optional>
被捕捉的几何体类型。
parentGeometryType IonSnapParentGeometryType <optional>
被捕捉的父几何体类型。
normal object <optional>
捕捉点处的表面法线,以模型的局部笛卡尔坐标系表示。
curve object <optional>
靠近捕捉点的曲线几何体,点以 WGS84 度坐标形式呈现。
Need help? The fastest way to get answers is from the community and team on the Cesium Forum.