WebGLRenderingContext: метод enableVertexAttribArray()

Метод WebGLRenderingContext enableVertexAttribArray(), являющийся частью WebGL API, включает в список массивов атрибутов общий массив атрибутов вершин в указанном индексе.

В WebGL значения, применимые к определённой вершине, хранятся в атрибутах. Они доступны только коду JavaScript и вершинному шейдеру. К атрибутам обращаются по номеру индекса в списке атрибутов, поддерживаемом графическим процессором. Некоторые индексы атрибутов вершин могут иметь предопределённые цели в зависимости от платформы и/или графического процессора. Другие назначаются слоем WebGL при создании атрибутов.

В любом случае, поскольку атрибуты нельзя использовать, пока они не включены, и по умолчанию они отключены, необходимо вызвать enableVertexAttribArray() для включения отдельных атрибутов, чтобы они могли быть использованы. После этого другие методы могут быть использованы для доступа к атрибуту, включая vertexAttribPointer(), vertexAttrib*() и getVertexAttrib().

index

Значение типа GLuint, определяющее номер индекса, который однозначно идентифицирует атрибут вершины, который нужно включить. Если вам известны имя атрибута, но не его индекс, вы можете получить индекс, вызвав getAttribLocation().

Ничего (undefined).

Чтобы проверить наличие ошибок после вызова enableVertexAttribArray(), вызовите getError().

WebGLRenderingContext.INVALID_VALUE

Указанный index является недопустимым; то есть, он больше или равен максимальному числу записей, разрешённых в списке атрибутов вершин контекста, как указано значением WebGLRenderingContext.MAX_VERTEX_ATTRIBS.

В этом коде — фрагменте, взятом из полного примера Пример анимации 2D WebGL — показано использование enableVertexArray() для активации атрибута, который будет использован слоем WebGL для передачи отдельных вершин из буфера вершин в функцию вершинного шейдера.

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);

Этот код устанавливает буфер вершин, которые будут использоваться для отрисовки треугольников фигуры, вызвав bindBuffer(). Затем индекс атрибута позиции вершины получаем из программы шейдера, вызвав getAttribLocation().

Теперь, когда индекс атрибута позиции вершины доступен в aVertexPosition, мы вызываем enableVertexAttribArray() для включения атрибута позиции, чтобы он мог быть использован программой шейдера (в частности, вершинным шейдером).

Затем буфер вершин связывается с атрибутом aVertexPosition путём вызова vertexAttribPointer(). Этот шаг не очевиден, поскольку это практически побочный эффект. Но в результате доступ к aVertexPosition теперь получает данные из буфера вершин.

С установленной связью между буфером вершин нашей фигуры и атрибутом aVertexPosition, используемым для передачи вершин по одному в вершинный шейдер, мы готовы отрисовать фигуру, вызвав drawArrays().

• Данные в WebGL
• Добавление 2D-контента в контекст WebGL
• Пример анимации 2D WebGL
• disableVertexAttribArray()