LCCObject::intersectsRayExt
Raycasting basado en cuerpos de colisión que permite obtener posiciones de coordenadas mediante clics en pantalla.
Requisito de versión
SDK v0.5.0+
Compatibilidad de motor
Three.js
API
LCCObject::intersectsRayExt(param: IntersectsRayExtParam): IntersectsResult | null
Parámetros
| Parámetro | Tipo | Obligatorio | Predeterminado | Descripción |
|---|---|---|---|---|
param.evt | MouseEvent / PointerEvent | Sí | - | Evento de clic del ratón. |
param.maxDistance | number | Sí | - | Distancia de detección, en metros. |
Valor de retorno
Devuelve un objeto con point y normal en caso de éxito; devuelve null en caso de fallo.
| Propiedad | Tipo | Descripción |
|---|---|---|
point | { x: number, y: number, z: number } | Coordenadas del punto de colisión en espacio mundial. |
normal | { x: number, y: number, z: number } | Normal del punto de colisión en espacio mundial. |
Ejemplo de uso
const cond = lccObject.hasCollision();
if (cond) {
document.addEventListener('mousedown', (evt) => {
let ret = lccObject.intersectsRayExt({ evt: evt, maxDistance: 10 });
if (ret) {
console.log('point: ', ret.point.x, ret.point.y, ret.point.z);
console.log('normal: ', ret.normal.x, ret.normal.y, ret.normal.z);
} else {
// No point detected
}
});
} else {
// Collision function not supported
}
Notas
- Este método debe llamarse después de que se haya activado el callback de éxito de
LCCRender.load(). - Verifique el soporte de colisiones mediante
hasCollision()antes de usarlo. - El SDK solo carga datos de colisión en las proximidades de la posición de la cámara.
APIs relacionadas
LCCObject::hasCollision()LCCObject::intersectsRayFromOriginExt()LCCObject::raycast()