GPURenderPassEncoder: phương thức setScissorRect()
Limited availability
This feature is not Baseline because it does not work in some of the most widely-used browsers.
Secure context: This feature is available only in secure contexts (HTTPS), in some or all supporting browsers.
Note: This feature is available in Web Workers.
Phương thức setScissorRect() của giao diện GPURenderPassEncoder đặt hình chữ nhật cắt được sử dụng trong giai đoạn rasterization. Sau khi biến đổi sang tọa độ viewport, bất kỳ mảnh nào nằm ngoài hình chữ nhật cắt sẽ bị loại bỏ.
Cú pháp
setScissorRect(x, y, width, height)
Tham số
x-
Một số biểu diễn giá trị X tối thiểu của hình chữ nhật cắt, tính bằng pixel.
y-
Một số biểu diễn giá trị Y tối thiểu của hình chữ nhật cắt, tính bằng pixel.
width-
Một số biểu diễn chiều rộng của hình chữ nhật cắt, tính bằng pixel.
height-
Một số biểu diễn chiều cao của hình chữ nhật cắt, tính bằng pixel.
Note:
Nếu không có lệnh gọi setScissorRect() nào được thực hiện, các giá trị mặc định là (0, 0, chiều rộng tệp đính kèm, chiều cao tệp đính kèm) cho mỗi lần thực thi kết xuất.
Giá trị trả về
Không có (Undefined).
Xác thực
Các tiêu chí sau phải được đáp ứng khi gọi setViewport(), nếu không GPUValidationError sẽ được tạo ra và GPURenderPassEncoder sẽ không hợp lệ:
x+widthnhỏ hơn hoặc bằng chiều rộng của các tệp đính kèm kết xuất của lần thực thi kết xuất (xem ghi chú bên dưới).y+heightnhỏ hơn hoặc bằng chiều cao của các tệp đính kèm kết xuất của lần thực thi kết xuất (xem ghi chú bên dưới).
Note:
Xem các tệp đính kèm màu sắc và độ sâu/stencil được chỉ định trong descriptor của GPUCommandEncoder.beginRenderPass(); chiều rộng và chiều cao dựa trên GPUTexture mà các view của chúng xuất phát.
Ví dụ
Đoạn mã cơ bản
Trong một lần kết xuất canvas thông thường, có thể sử dụng đoạn mã sau để loại bỏ bất kỳ nội dung kết xuất nào nằm ngoài góc trên bên trái của canvas:
passEncoder.setScissorRect(0, 0, canvas.width / 2, canvas.height / 2);
Thông số kỹ thuật
| Specification |
|---|
| WebGPU # dom-gpurenderpassencoder-setscissorrect |