OES_draw_buffers_indexed: colorMaskiOES() method

Baseline Widely available

This feature is well established and works across many devices and browser versions. It’s been available across browsers since December 2022.

Phương thức colorMaskiOES() của phần mở rộng WebGL OES_draw_buffers_indexed đặt các thành phần màu nào được bật hoặc tắt khi vẽ hoặc kết xuất cho một bộ đệm vẽ cụ thể. Đây là phiên bản có chỉ mục của phương thức WebGLRenderingContext.colorMask() trong WebGL 1.

Cú pháp

js
colorMaskiOES(buf, r, g, b, a)

Tham số

buf

Một số nguyên i chỉ định bộ đệm vẽ liên kết với hằng số gl.DRAW_BUFFERi, xem hằng số bộ đệm vẽ WebGL.

r

Một GLboolean chỉ định liệu thành phần màu đỏ có nên được ghi vào bộ đệm vẽ hay không.

g

Một GLboolean chỉ định liệu thành phần màu xanh lá có nên được ghi vào bộ đệm vẽ hay không.

b

Một GLboolean chỉ định liệu thành phần màu xanh dương có nên được ghi vào bộ đệm vẽ hay không.

a

Một GLboolean chỉ định liệu thành phần alpha (độ trong suốt) có nên được ghi vào bộ đệm vẽ hay không.

Giá trị trả về

Không có (undefined).

Ngoại lệ

  • Nếu buf, r, b, g hoặc a không phải là các giá trị hợp lệ, lỗi gl.INVALID_VALUE được ném ra.

Ví dụ

Đặt và lấy mặt nạ màu

Bạn có thể đặt mặt nạ màu cho bộ đệm vẽ gl.DRAW_BUFFER0gl.DRAW_BUFFER1 như sau:

js
const ext = gl.getExtension("OES_draw_buffers_indexed");

ext.colorMaskiOES(0, 1, 0, 0, 0);
ext.colorMaskiOES(1, 0, 1, 0, 0);

Để lấy mặt nạ màu cho bộ đệm vẽ gl.DRAW_BUFFER0gl.DRAW_BUFFER1, truy vấn hằng số COLOR_WRITEMASK bằng WebGL2RenderingContext.getIndexedParameter():

js
gl.getIndexedParameter(gl.COLOR_WRITEMASK, 0);
gl.getIndexedParameter(gl.COLOR_WRITEMASK, 1);

Thông số kỹ thuật

Thông số kỹ thuật
WebGL OES_draw_buffers_indexed Extension Specification

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

Xem thêm