XRRay: XRRay() Konstruktor
Eingeschränkt verfügbar
Diese Funktion ist nicht Baseline, da sie in einigen der am weitesten verbreiteten Browser nicht funktioniert.
Want more browser support for this feature? Tell us why.
Experimentell: Dies ist eine experimentelle Technologie
Überprüfen Sie die Browser-Kompatibilitätstabelle sorgfältig vor der Verwendung auf produktiven Webseiten.
Sicherer Kontext: Diese Funktion ist nur in sicheren Kontexten (HTTPS) in einigen oder allen unterstützenden Browsern verfügbar.
Der XRRay() Konstruktor erstellt ein neues XRRay Objekt, das durch einen geometrischen Strahl beschrieben wird, der aus einem Ursprungspunkt und einem Richtungsvektor besteht.
Syntax
new XRRay()
new XRRay(origin)
new XRRay(origin, direction)
new XRRay(transform)
Parameter
originOptional-
Ein Punktobjekt, das den dreidimensionalen Punkt im Raum definiert, von dem der Strahl ausgeht, in Metern. Alle Dimensionen sind optional, jedoch muss, wenn angegeben, die
w-Eigenschaft des Ursprungs 1.0 sein. Das Objekt wird standardmäßig mit{ x: 0.0, y: 0.0, z: 0.0, w: 1.0 }initialisiert. directionOptional-
Ein Vektorobjekt, das den dreidimensionalen Richtungsvektor des Strahls definiert. Alle Dimensionen sind optional, jedoch muss, wenn angegeben, die
w-Eigenschaft der Richtung 0.0 sein. Das Objekt wird standardmäßig mit{ x: 0.0, y: 0.0, z: -1.0, w: 0.0 }initialisiert. transformOptional-
Ein
XRRigidTransformObjekt, das die Position und Orientierung des Strahls darstellt.
Rückgabewert
Ein neu erstelltes XRRay Objekt.
Ausnahmen
TypeError-
Wird ausgelöst, wenn eine der folgenden Bedingungen erfüllt ist:
- alle
x-,y- undz-Koordinaten vondirectionsind null. - die
w-Koordinate vondirectionist nicht 0.0. - die
w-Koordinate vonoriginist nicht 1.0.
- alle
Beispiele
Erstellen von XRRay Objekten
Der XRRay() Konstruktor ermöglicht es Ihnen, neue Strahlen zu erstellen, indem Sie entweder einen origin Punkt und einen direction Vektor angeben oder ein XRRigidTransform Objekt übergeben.
// Default configuration
let ray1 = new XRRay();
// Specifying origin, leaving direction as default
let ray2 = new XRRay({ y: 0.5 });
// Specifying both, origin and direction
let origin = { x: 10.0, y: 10.0, z: 10.0, w: 1.0 };
let direction = { x: 10.0, y: 0.0, z: 0.0, w: 0.0 };
let ray3 = new XRRay(origin, direction);
// Using DOMPoint.fromPoint
let ray4 = new XRRay(DOMPoint.fromPoint(origin), DOMPoint.fromPoint(direction));
// Using rigid transform
let rigidTransform = new XRRigidTransform(
DOMPoint.fromPoint(origin),
DOMPoint.fromPoint(direction),
);
let ray5 = new XRRay(rigidTransform);
Spezifikationen
| Spezifikation |
|---|
| WebXR Hit Test Module # dom-xrray-xrray |