DOMPoint
Baseline
Weitgehend verfügbar
Diese Funktion ist gut etabliert und funktioniert auf vielen Geräten und in vielen Browserversionen. Sie ist seit Januar 2020 browserübergreifend verfügbar.
Hinweis: Diese Funktion ist in Web Workers verfügbar.
Ein DOMPoint-Objekt repräsentiert einen 2D- oder 3D-Punkt in einem Koordinatensystem. Es enthält Koordinatenwerte für bis zu drei Dimensionen sowie einen optionalen Perspektivwert. DOMPoint basiert auf DOMPointReadOnly, erlaubt aber die Änderung seiner Eigenschaftswerte.
Im Allgemeinen beschreibt eine positive x-Komponente eine Position rechts vom Ursprung, eine positive y-Komponente eine Position unterhalb des Ursprungs und eine positive z-Komponente eine Position, die aus dem Bildschirm herausragt (also in Richtung der nutzenden Person).
Konstruktor
DOMPoint()-
Erstellt ein neues
DOMPoint-Objekt anhand der Werte von null oder mehr seiner Koordinatenkomponenten und optional des Perspektivwertswund gibt es zurück. Sie können auch einen vorhandenenDOMPoint, einenDOMPointReadOnlyoder ein Objekt verwenden, um durch Aufruf der statischen MethodeDOMPoint.fromPoint()einen neuen Punkt zu erstellen.
Instanzeigenschaften
DOMPoint kann außerdem Eigenschaften von seiner übergeordneten Schnittstelle DOMPointReadOnly erben.
DOMPoint.x-
Die
x-Koordinate desDOMPoint. DOMPoint.y-
Die
y-Koordinate desDOMPoint. DOMPoint.z-
Die
z-Koordinate desDOMPoint. DOMPoint.w-
Der Perspektivwert des
DOMPoint.
Statische Methoden
DOMPoint kann außerdem statische Methoden von seiner übergeordneten Schnittstelle DOMPointReadOnly erben.
DOMPoint.fromPoint()-
Erstellt ein neues veränderbares
DOMPoint-Objekt anhand eines vorhandenen Punkts (oder eines Objekts mit entsprechenden Eigenschaften), der die Werte für dessen Eigenschaften liefert.
Instanzmethoden
DOMPoint erbt Instanzmethoden von seiner übergeordneten Schnittstelle DOMPointReadOnly.
Beispiele
In der WebXR Device API repräsentieren DOMPointReadOnly-Werte Positionen und Ausrichtungen. Im folgenden Codeausschnitt kann die Pose des XR-Geräts (beispielsweise eines VR-Headsets oder eines AR-fähigen Smartphones) abgerufen werden, indem während eines Animationsframes einer XRSession XRFrame.getViewerPose() aufgerufen wird. Anschließend wird auf die Eigenschaft transform der zurückgegebenen XRPose zugegriffen. Sie enthält zwei DOMPointReadOnly-Attribute: position als Vektor und orientation als Quaternion.
function onXRFrame(time, xrFrame) {
let viewerPose = xrFrame.getViewerPose(xrReferenceSpace);
if (viewerPose) {
let position = viewerPose.transform.position;
let orientation = viewerPose.transform.orientation;
console.log(
`XR Viewer Position: {x: ${roundToTwo(position.x)}, y: ${roundToTwo(
position.y,
)}, z: ${roundToTwo(position.z)}`,
);
console.log(
`XR Viewer Orientation: {x: ${roundToTwo(orientation.x)}, y: ${roundToTwo(
orientation.y,
)}, z: ${roundToTwo(orientation.z)}, w: ${roundToTwo(orientation.w)}`,
);
}
}
Spezifikationen
| Spezifikation |
|---|
| Geometry Interfaces Module Level 1 # DOMPoint |