Sphere collision test.
Version Requirement
SDK v0.4.1+
Engine Support
Three.js
API
LCCObject::intersectsSphere(param: IntersectsSphereParam): IntersectsSphereResultParameters
| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
param.center | { x: number, y: number, z: number } | Yes | - | Sphere center position. |
param.radius | number | Yes | - | Sphere radius. |
param.noDelta | boolean | No | - | When true, collision offset is not calculated for faster detection; when false, offset is computed. |
Return Value
| Property | Type | Description |
|---|---|---|
hit | boolean | Whether a collision occurred. |
delta | { x: number, y: number, z: number } | Collision offset, useful for adjusting digital human position. Direction points toward the collider. Only valid when noDelta is false. |
Usage Example
const ret = lccObject.hasCollision();
if (ret) {
const center = { x: 10, y: 10, z: 10 };
const radius = 1;
const noDelta = true;
let intersectResult = lccObject.intersectsSphere({ center, radius, noDelta });
if (intersectResult.hit) {
console.log('Collision occurs');
}
} else {
// Collision function not supported
}Notes
- This method must be called after the success callback of
LCCRender.load()has been triggered. - Check collision support via
hasCollision()before use. - The SDK only loads collision data within the vicinity of the camera position.
Related APIs
LCCObject::hasCollision()LCCObject::intersectsCapsule()
This chapter is from the official XGRIDS user manual. Official source (opens in a new tab) · Updated:
