WebGLRenderingContext: метод drawElements()

Метод WebGLRenderingContext.drawElements() API WebGL отрисовывает примитивы из данных массива.

mode

Значение GLenum, определяющее тип примитива для отрисовки. Возможные значения:

• gl.POINTS: Рисует одну точку.
• gl.LINE_STRIP: Рисует прямую линию до следующей вершины.
• gl.LINE_LOOP: Рисует прямую линию до следующей вершины и соединяет последнюю вершину с первой.
• gl.LINES: Рисует линию между парой вершин.
• gl.TRIANGLE_STRIP
• gl.TRIANGLE_FAN
• gl.TRIANGLES: Рисует треугольник для группы из трёх вершин.

count

Значение GLsizei, определяющее количество элементов связанного буфера массива элементов, которые нужно отрисовать. Например, для отрисовки каркасного треугольника с gl.LINES, количество должно быть 2 конечными точками на линию × 3 линии = 6 элементов. Однако, для отрисовки того же каркасного треугольника с gl.LINE_STRIP, буфер массива элементов не повторяет индексы для конца первой линии/начала второй линии и конца второй линии/начала третьей линии, поэтому count будет четыре. Для отрисовки того же треугольника с gl.LINE_LOOP, буфер массива элементов также не повторяет первую/последнюю вершину, поэтому count будет три.

type

Значение GLenum, определяющее тип значений в буфере массива элементов. Возможные значения:

• gl.UNSIGNED_BYTE
• gl.UNSIGNED_SHORT

При использовании расширения OES_element_index_uint:

• gl.UNSIGNED_INT

offset

Значение GLintptr, определяющее байтовый смещение в буфере массива элементов. Должно быть допустимым кратным размеру указанного type.

Ничего (undefined).

• Если mode не соответствует допустимым значениям, выбрасывается ошибка gl.INVALID_ENUM.
• Если offset не является допустимым кратным размеру данного типа, выбрасывается ошибка gl.INVALID_OPERATION.
• Если count отрицательно, выбрасывается ошибка gl.INVALID_VALUE.

• WebGLRenderingContext.drawArrays()
• OES_element_index_uint
• WEBGL_multi_draw.multiDrawElementsWEBGL()