LCCObject::intersectsRayExt
Raycasting basato su corpo di collisione che supporta l'ottenimento delle coordinate di posizione tramite clic sullo schermo.
Requisito di versione
SDK v0.5.0+
Supporto motore
Three.js
API
LCCObject::intersectsRayExt(param: IntersectsRayExtParam): IntersectsResult | null
Parametri
| Parametro | Tipo | Obbligatorio | Predefinito | Descrizione |
|---|---|---|---|---|
param.evt | MouseEvent / PointerEvent | Sì | - | Evento di clic del mouse. |
param.maxDistance | number | Sì | - | Distanza di rilevamento, in metri. |
Valore di ritorno
Restituisce un oggetto contenente point e normal in caso di successo; restituisce null in caso di fallimento.
| Proprietà | Tipo | Descrizione |
|---|---|---|
point | { x: number, y: number, z: number } | Coordinate del punto di collisione nello spazio mondo. |
normal | { x: number, y: number, z: number } | Normale del punto di collisione nello spazio mondo. |
Esempio di utilizzo
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
}
Note
- Questo metodo deve essere chiamato dopo che il callback di successo di
LCCRender.load()è stato attivato. - Verificare il supporto alla collisione tramite
hasCollision()prima dell'uso. - L'SDK carica solo i dati di collisione nelle vicinanze della posizione della camera.
API correlate
LCCObject::hasCollision()LCCObject::intersectsRayFromOriginExt()LCCObject::raycast()