XRCompositionLayer: needsRedraw property

Khả dụng hạn chế

This feature is not Baseline because it does not work in some of the most widely-used browsers.

Experimental: This is an experimental technology
Check the Browser compatibility table carefully before using this in production.

Thuộc tính chỉ đọc needsRedraw của giao diện XRCompositionLayer là một giá trị boolean báo hiệu rằng layer cần được kết xuất lại trong frame tiếp theo.

Nhu cầu kết xuất lại có thể xảy ra khi các tài nguyên bên dưới của một layer bị mất do texture có thể đã bị compositor giải phóng âm thầm. Điều này có thể xảy ra khi thiết bị vào chế độ ngủ hoặc khi trình duyệt chuyển ngữ cảnh (đến một hộp thoại hệ điều hành hoặc tương tự) và sau đó quay lại.

Kết xuất lại không phải là vấn đề đối với các layer được cập nhật mỗi frame. Tuy nhiên, đối với các layer được cập nhật không thường xuyên, hoặc các layer tĩnh (nơi bạn chỉ có thể vẽ một lần sau khi tạo hoặc sau sự kiện redraw), nội dung của layer có thể bị mất và cần được vẽ lại. Nếu tài nguyên của layer bị mất, thuộc tính needsRedraw sẽ là true và sự kiện redraw được kích hoạt trên layer.

Giá trị

Một giá trị boolean. true cho biết cần kết xuất lại trong frame tiếp theo, false cho biết không cần kết xuất lại.

Ví dụ

Kết xuất lại các layer

Sử dụng thuộc tính needsRedraw để kiểm tra xem một layer có cần được vẽ lại hay không và sau đó vẽ lại nó.

js
function onXRFrame(time, frame) {
  // …

  if (quadLayer.needsRedraw) {
    // redraw the layer
  }
}

Thông số kỹ thuật

Thông số kỹ thuật
WebXR Layers API Level 1
# dom-xrcompositionlayer-needsredraw

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

Xem thêm