LCCObject::raycastFromOrigin

自定义起点和方向的射线检测。

支持自定义 origin 和 direction，在世界空间下检测 LCC 模型数据。

版本要求

SDK v0.3.0+

引擎支持

Three.js / CesiumJS

API

LCCObject::raycastFromOrigin(param: RaycastFromOriginParam): IPoint3 | null

参数

参数	类型	必选	默认值	描述
`param.origin`	`{ x: number, y: number, z: number }`	是	-	射线原点，世界空间坐标。
`param.direction`	`{ x: number, y: number, z: number }`	是	-	射线方向，可以是归一化或非归一化向量。
`param.maxDistance`	`number`	是	-	检测距离，单位为米。
`param.radius`	`number`	是	-	检测精度，单位为米。
`param.opacityThreshold`	`number`	否	`0.5`	高精度检测时的 opacity 阈值，取值范围 `[0, 1]`。仅当 `usePrecisionRaycast` 为 `true` 时生效。SDK v0.6.3+

返回值

IPoint3 | null — 检测到的点坐标（包含 x、y、z），值为世界坐标空间的坐标。未检测到时返回 null。

使用示例

const origin = { x: 10, y: 10, z: 10 };
const startPos = { x: 10, y: 10, z: 10 };
const endPos = { x: 50, y: 50, z: 50 };
const direction = {
    x: endPos.x - startPos.x,
    y: endPos.y - startPos.y,
    z: endPos.z - startPos.z
};
const maxDistance = 100;
const radius = 0.01;

let checkPos = lccObject.raycastFromOrigin({ origin, direction, maxDistance, radius });
if (checkPos) {
    console.log('checkPos: ', checkPos.x, checkPos.y, checkPos.z);
} else {
    // No point detected
}

注意事项

此接口需在 LCCRender.load() 的成功回调函数触发后调用。
direction 可以是归一化或非归一化的向量。
如果 radius 值为 0.01 检测不到数据，可以适当调大，例如 0.1。