DOMPointReadOnly: fromPoint() static method

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.

Note: This feature is available in Web Workers.

Phương thức tĩnh DOMPointReadOnly fromPoint() tạo và trả về một đối tượng DOMPointReadOnly mới từ một điểm nguồn.

Bạn cũng có thể tạo một đối tượng DOMPointReadOnly mới bằng cách sử dụng hàm khởi tạo DOMPointReadOnly().

Cú pháp

js
DOMPointReadOnly.fromPoint(sourcePoint)

Tham số

sourcePoint

Một đối tượng DOMPoint hoặc DOMPointReadOnly, hoặc một đối tượng chứa các thuộc tính sau, từ đó lấy các giá trị cho thuộc tính của điểm mới:

x

Một giá trị số thực không bị giới hạn chỉ định tọa độ x của điểm trong không gian. Đây thường là tọa độ ngang, với các giá trị dương là bên phải và giá trị âm là bên trái. Giá trị mặc định là 0.

y

Một số thực không bị giới hạn cung cấp tọa độ y của điểm. Đây là tọa độ dọc, với các giá trị dương hướng xuống và giá trị âm hướng lên phía trên màn hình. Giá trị mặc định là 0.

z

Một giá trị số thực không bị giới hạn cung cấp tọa độ z của điểm, là tọa độ độ sâu; các giá trị dương gần người dùng hơn và các giá trị âm lùi vào màn hình. Giá trị mặc định là 0.

w

Giá trị phối cảnh w của điểm, được cung cấp dưới dạng số thực không bị giới hạn. Giá trị mặc định là 1.

Giá trị trả về

Một đối tượng DOMPointReadOnly mới (giống hệt điểm nguồn).

Ví dụ

Tạo một điểm 2D

Ví dụ này tạo một điểm 2D, chỉ định một đối tượng nội tuyến bao gồm các giá trị cho xy. Các thuộc tính zw được phép giữ giá trị mặc định (01 tương ứng).

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

Tạo một điểm 3D sử dụng một điểm hiện có

Ví dụ này tạo một điểm origPoint kiểu DOMPoint, sử dụng DOMPoint(). Điểm đó sau đó được sử dụng làm đầu vào cho fromPoint() để tạo điểm mới newPoint.

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

const newPoint = DOMPointReadOnly.fromPoint(origPoint);

Thông số kỹ thuật

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

Tương thích trình duyệt