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
DOMPointReadOnly.fromPoint(sourcePoint)
Parameter
sourcePoint
-
Eine Instanz von
DOMPoint
oderDOMPointReadOnly
, 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 ist0
. 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 ist0
. 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 ist0
. w
-
Der
w
-Perspektivenwert des Punktes, angegeben als uneingeschränkte Gleitkommazahl. Der Standardwert ist1
.
Rückgabewert
Ein neues DOMPointReadOnly
Objekt (das mit dem Quellpunkt identisch ist).
Beispiele
Erstellen eines 2D-Punktes
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.
const origPoint = new DOMPoint(25, 25, 100, 0.5);
const newPoint = DOMPointReadOnly.fromPoint(origPoint);
Spezifikationen
Specification |
---|
Geometry Interfaces Module Level 1 # dom-dompointreadonly-frompoint |