DOMPointReadOnly: fromPoint() statische Methode

Baseline Widely available

This feature is well established and works across many devices and browser versions. It’s been available across browsers since January 2020.

Hinweis: Diese Funktion ist in Web Workers verfügbar.

Die statische DOMPointReadOnly Methode fromPoint() erstellt und gibt ein neues DOMPointReadOnly Objekt zurück, basierend auf einem Quellpunkt.

Sie können auch ein neues DOMPointReadOnly Objekt mithilfe des DOMPointReadOnly() Konstruktors erstellen.

Syntax

js
DOMPointReadOnly.fromPoint(sourcePoint)

Parameter

sourcePoint

Eine Instanz von DOMPoint oder DOMPointReadOnly, oder ein Objekt, das die folgenden Eigenschaften enthält, aus denen die Werte der neuen Punkt-Eigenschaften übernommen werden:

x

Ein uneingeschränkter Gleitkommawert, der die x-Koordinate des Punktes im Raum angibt. Dies ist in der Regel die horizontale Koordinate, wobei positive Werte nach rechts und negative Werte nach links zeigen. Der Standardwert ist 0.

y

Eine uneingeschränkte Gleitkommazahl, die die y-Koordinate des Punktes angibt. Dies ist die vertikale Koordinate, und abgesehen von jeglichen an das Koordinatensystem angelegten Transformationen, sind positive Werte nach unten und negative Werte nach oben in Richtung der Oberseite des Bildschirms. Der Standardwert ist 0.

z

Ein uneingeschränkter Gleitkommawert, der die z-Koordinate des Punktes angibt, was (unter der Annahme, dass keine Transformationen die Situation ändern) die Tiefenkoordinate ist; positive Werte sind näher am Benutzer und negative Werte gehen zurück in den Bildschirm. Der Standardwert ist 0.

w

Der w-Perspektivenwert des Punktes, angegeben als uneingeschränkte Gleitkommazahl. Der Standardwert ist 1.

Rückgabewert

Ein neues DOMPointReadOnly Objekt (das mit dem Quellpunkt identisch ist).

Beispiele

Erstellen eines 2D-Punktes

Dieses Beispiel erstellt einen 2D-Punkt, indem es ein Inline-Objekt angibt, das die zu verwendenden Werte für x und y enthält. Die Eigenschaften z und w können ihre Standardwerte (0 und 1 jeweils) beibehalten.

js
const point2D = DOMPointReadOnly.fromPoint({ x: 25, y: 25 });

Erstellen eines 3D-Punktes unter Verwendung eines vorhandenen Punktes

Dieses Beispiel erstellt einen Punkt origPoint vom Typ DOMPoint unter Verwendung von DOMPoint(). Dieser Punkt wird dann als Eingabe für fromPoint() verwendet, um einen neuen Punkt newPoint zu erstellen.

js
const origPoint = new DOMPoint(25, 25, 100, 0.5);

const newPoint = DOMPointReadOnly.fromPoint(origPoint);

Spezifikationen

Specification
Geometry Interfaces Module Level 1
# dom-dompointreadonly-frompoint

Browser-Kompatibilität