WebGLRenderingContext: enableVertexAttribArray() method

Cú pháp

enableVertexAttribArray(index)

Thông số

index

Một GLuint xác định số chỉ mục xác định duy nhất thuộc tính đỉnh để kích hoạt. Nếu bạn biết tên thuộc tính nhưng không biết chỉ mục của nó, bạn có thể lấy chỉ mục bằng cách gọi getAttribLocation().

Giá trị trả về

Không có (undefined).

Lỗi

Để kiểm tra lỗi sau khi gọi enableVertexAttribArray(), hãy gọi getError().

WebGLRenderingContext.INVALID_VALUE

index được chỉ định không hợp lệ; nghĩa là nó lớn hơn hoặc bằng số lượng mục nhập tối đa được phép trong danh sách thuộc tính đỉnh của ngữ cảnh, được biểu thị bằng giá trị của WebGLRenderingContext.MAX_VERTEX_ATTRIBS.

Ví dụ

Mã này — một đoạn trích từ ví dụ đầy đủ Một ví dụ hoạt hình WebGL 2D cơ bản — cho thấy việc sử dụng enableVertexArray() để kích hoạt thuộc tính sẽ được lớp WebGL sử dụng để chuyển các đỉnh riêng lẻ từ bộ đệm đỉnh vào hàm đổ bóng đỉnh.

gl.bindBuffer(gl.ARRAY_BUFFER, vertexBuffer);

aVertexPosition = gl.getAttribLocation(shaderProgram, "aVertexPosition");

gl.enableVertexAttribArray(aVertexPosition);
gl.vertexAttribPointer(
  aVertexPosition,
  vertexNumComponents,
  gl.FLOAT,
  false,
  0,
  0,
);

gl.drawArrays(gl.TRIANGLES, 0, vertexCount);

[!GHI CHÚ] Đoạn mã này được lấy từ hàm TOK0 trong "Ví dụ hoạt hình WebGL 2D cơ bản." Nhìn thấy bài viết đó để biết mẫu đầy đủ và xem hoạt ảnh thu được đang hoạt động.

Mã này thiết lập vùng đệm của các đỉnh sẽ được sử dụng để vẽ các hình tam giác bằng cách gọi bindBuffer(). Sau đó, chỉ số của thuộc tính vị trí đỉnh được lấy từ chương trình đổ bóng bằng cách gọi getAttribLocation().

Với chỉ mục của thuộc tính vị trí đỉnh hiện có sẵn trong aVertexPosition, chúng ta gọi enableVertexAttribArray() để kích hoạt thuộc tính vị trí để nó có thể được sử dụng bởi chương trình đổ bóng (đặc biệt là bởi trình đổ bóng đỉnh).

Sau đó, bộ đệm đỉnh được liên kết với thuộc tính aVertexPosition bằng cách gọi vertexAttribPointer(). Bước này không rõ ràng vì ràng buộc này gần như là một tác dụng phụ. Nhưng kết quả là, việc truy cập aVertexPosition bây giờ lấy được dữ liệu từ bộ đệm đỉnh.

Với sự kết hợp giữa bộ đệm đỉnh cho hình dạng của chúng ta và thuộc tính aVertexPosition được sử dụng để phân phối từng đỉnh một vào trình đổ bóng đỉnh, chúng ta đã sẵn sàng vẽ hình bằng cách gọi drawArrays().

Thông số kỹ thuật

Khả năng tương thích của trình duyệt

Xem thêm

• Dữ liệu trong WebGL
• Thêm nội dung 2D vào ngữ cảnh WebGL
• Mẫu hoạt hình 2D WebGL cơ bản
• disableVertexAttribArray()