WebGLRenderingContext.bindBuffer()

ebGLRenderingContext.bindBuffer() метод WebGL API связывает WebGLBuffer (en-US) c точкой связывания(Атрибут регистром).

Синтаксис

void gl.bindBuffer(target, buffer);

Параметры

target

GLenum (en-US) определяет точку связывания (target). Возможные значения:

  • gl.ARRAY_BUFFER: Буфер содержащий вершинные атрибуты, такие как координаты, текстурные координаты(UV) или цвет вершины.
  • gl.ELEMENT_ARRAY_BUFFER: Буфер использующий для индексирования элементов.
  • When using a WebGL 2 context (en-US), the following values are available additionally:
    • gl.COPY_READ_BUFFER: Buffer for copying from one buffer object to another.
    • gl.COPY_WRITE_BUFFER: Buffer for copying from one buffer object to another.
    • gl.TRANSFORM_FEEDBACK_BUFFER: Buffer for transform feedback operations.
    • gl.UNIFORM_BUFFER: Buffer used for storing uniform blocks.
    • gl.PIXEL_PACK_BUFFER: Buffer used for pixel transfer operations.
    • gl.PIXEL_UNPACK_BUFFER: Buffer used for pixel transfer operations.
buffer

WebGLBuffer (en-US) с которым осуществляется связывание.

Return value

Нет.

Exceptions

Only one target can be bound to a given WebGLBuffer (en-US). An attempt to bind the buffer to another target will throw an INVALID_OPERATION error and the current buffer binding will remain the same.

Examples

Binding a buffer to a target

var canvas = document.getElementById('canvas');
var gl = canvas.getContext('webgl');
var buffer = gl.createBuffer();

gl.bindBuffer(gl.ARRAY_BUFFER, buffer);

Getting current bindings

To check the current buffer bindings, query the ARRAY_BUFFER_BINDING and ELEMENT_ARRAY_BUFFER_BINDING constants.

gl.getParameter(gl.ARRAY_BUFFER_BINDING);
gl.getParameter(gl.ELEMENT_ARRAY_BUFFER_BINDING);

Specifications

Specification Status Comment
WebGL 1.0
Определение 'bindBuffer' в этой спецификации.		 Рекомендация Initial definition for WebGL.
OpenGL ES 2.0
Определение 'glBindBuffer' в этой спецификации.		 Стандарт Man page of the (similar) OpenGL ES 2 API.
WebGL 2.0
Определение 'bindBuffer' в этой спецификации.		 Редакторский черновик Updated definition for WebGL 2.Adds new target buffers: gl.COPY_READ_BUFFER, gl.COPY_WRITE_BUFFER, gl.TRANSFORM_FEEDBACK_BUFFER, gl.UNIFORM_BUFFER, gl.PIXEL_PACK_BUFFER, gl.PIXEL_UNPACK_BUFFER
OpenGL ES 3.0
Определение 'glBindBuffer' в этой спецификации.		 Стандарт Man page of the (similar) OpenGL ES 3 API.

Browser compatibility

BCD tables only load in the browser

See also