LCCObject::intersectsRayExt

Kollisionskörperbasiertes Raycasting, das die Ermittlung von Koordinatenpositionen durch Bildschirmklicks unterstützt.

Versionsanforderung

SDK v0.5.0+

Engine-Unterstützung

Three.js

API

LCCObject::intersectsRayExt(param: IntersectsRayExtParam): IntersectsResult | null

Parameter

Parameter	Typ	Erforderlich	Standard	Beschreibung
`param.evt`	`MouseEvent` / `PointerEvent`	Ja	-	Mausklick-Ereignis.
`param.maxDistance`	`number`	Ja	-	Erkennungsdistanz, in Metern.

Rückgabewert

Gibt bei Erfolg ein Objekt mit point und normal zurück; gibt bei Fehler null zurück.

Eigenschaft	Typ	Beschreibung
`point`	`{ x: number, y: number, z: number }`	Kollisionspunktkoordinaten im Weltraum.
`normal`	`{ x: number, y: number, z: number }`	Normale des Kollisionspunkts im Weltraum.

Verwendungsbeispiel

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
}

Hinweise

Diese Methode muss nach dem Auslösen des Erfolgs-Callbacks von LCCRender.load() aufgerufen werden.
Prüfen Sie vor der Verwendung die Kollisionsunterstützung über hasCollision().
Das SDK lädt nur Kollisionsdaten in der Nähe der Kameraposition.