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 mit dem
DOMPointReadOnly()
Konstruktor erstellen.
Syntax
DOMPointReadOnly.fromPoint(sourcePoint)
Parameter
sourcePoint
-
Eine Instanz von
DOMPoint
oderDOMPointReadOnly
, oder ein Objekt mit den folgenden Eigenschaften, 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 im Allgemeinen 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 ohne Anwendungen von Transformationen am Koordinatensystem sind positive Werte nach unten und negative Werte nach oben zur oberen Bildschirmkante hin. Der Standard ist0
. z
-
Ein uneingeschränkter Gleitkommawert, der die
z
-Koordinate des Punktes angibt, welche (angenommen es gibt keine Transformationen, die die Situation ändern) die Tiefenkoordinate ist; positive Werte sind näher beim Benutzer und negative Werte ziehen sich in den Bildschirm zurück. Der Standardwert ist0
. w
-
Der
w
-Perspektivenwert des Punktes, angegeben als uneingeschränkte Gleitkommazahl. Der Standard ist1
.
Rückgabewert
Ein neues DOMPointReadOnly
Objekt (das identisch mit dem Quellpunkt ist).
Beispiele
Erstellen eines 2D-Punktes
Erstellen eines 3D-Punktes mit einem vorhandenen Punkt
In diesem Beispiel wird ein Punkt namens origPoint
vom Typ DOMPoint
erstellt, indem DOMPoint()
verwendet wird. Dieser Punkt wird dann als Eingabe für fromPoint()
verwendet, um einen neuen Punkt namens 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 |
Browser-Kompatibilität
BCD tables only load in the browser