| Name | Type | Description | ||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
options |
object |
Object with the following properties:
|
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
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.
此 snapper 操作的离子资产 ID。
从源 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
具有以下属性的对象:
|
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 |
具有以下属性的对象:
|
Returns:
The 捕捉结果;如果元素未找到或无法进行捕捉,则返回
undefined。
Experimental
This 该功能尚未最终确定,可能根据 Cesium 的标准弃用政策进行变更。
Type Definitions
成功执行
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 度坐标形式呈现。 |
