DOMPointReadOnly: DOMPointReadOnly() Konstruktor

Hinweis: Dieses Feature ist verfügbar in Web Workers.

Der DOMPointReadOnly() Konstruktor gibt ein neues DOMPointReadOnly Objekt zurück, das einen Punkt im 2D- oder 3D-Raum repräsentiert, optional mit Perspektive, dessen Werte durch Skriptcode nicht verändert werden können.

Syntax

js
new DOMPointReadOnly()
new DOMPointReadOnly(x)
new DOMPointReadOnly(x, y)
new DOMPointReadOnly(x, y, z)
new DOMPointReadOnly(x, y, z, w)

Parameter

x Optional

Der Wert der horizontalen Koordinate, x, als Gleitkommazahl. Der Standardwert ist 0.

y Optional

Der Wert der vertikalen Koordinate, y, als Gleitkommazahl. Der Standardwert ist 0.

z Optional

Der Wert der Tiefenkoordinate, z, als Gleitkommazahl. Der Standardwert ist 0.

w Optional

Der Wert der Perspektive, w, als Gleitkommazahl. Der Standardwert ist 1.

Hinweis: Jeder dieser Werte wird als unbeschränkt bezeichnet. Neben jedem endlichen Gleitkommawert können Sie spezielle Werte wie ±Infinity und NaN verwenden.

Rückgabewert

Ein neues DOMPointReadOnly Objekt, das die angegebene Position im Raum repräsentiert.

Beispiele

Der folgende Code zeigt die Erstellung von 2D- und 3D-Punkten.

js
const point2D = new DOMPointReadOnly(50, 25);
const point3D = new DOMPointReadOnly(50, 0, 10);
const perspectivePoint3D = new DOMPointReadOnly(50, 50, 25, 0.5);

Spezifikationen

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

Browser-Kompatibilität

BCD tables only load in the browser