WEBGL_multi_draw расширение

Расширение WEBGL_multi_draw является частью WebGL API и позволяет отрисовать более чем один примитив с помощью одного вызова функции. Это может улучшить производительность WebGL-приложения, так как оно снижает затраты на привязку в рендерере и ускоряет время работы потока GPU с однородными данными.

При включенном этом расширении:

• Добавлены новые методы, обрабатывающие несколько списков аргументов в одном вызове (см. список методов ниже).
• В язык шейдеров добавлен gl_DrawID встроенный элемент.

ext.multiDrawArraysWEBGL()

Отрисовывает несколько примитивов из данных массива (аналогично нескольким вызовам drawArrays).

ext.multiDrawElementsWEBGL()

Отрисовывает несколько примитивов из данных массива элементов (аналогично нескольким вызовам drawElements).

ext.multiDrawArraysInstancedWEBGL()

Отрисовывает несколько примитивов из данных массива (аналогично нескольким вызовам drawArraysInstanced).

ext.multiDrawElementsInstancedWEBGL()

Отрисовывает несколько примитивов из данных массива элементов (аналогично нескольким вызовам drawElementsInstanced).

Примечание: Несмотря на то, что имя расширения WEBGL_multi_draw, расширение должно быть включено с помощью директивы #extension GL_ANGLE_multi_draw для использования в шейдере.

При включенном расширении, в коде шейдера можно использовать встроенный элемент gl_DrawID. Для любого варианта вызова multi* вывода, индекс вывода i может быть прочитан вершинным шейдером как gl_DrawID. Для вызовов, не являющихся multi*, значение gl_DrawID равно 0.

<script type="x-shader/x-vertex">
  #extension GL_ANGLE_multi_draw : require
  void main() {
    gl_Position = vec4(gl_DrawID, 0, 0, 1);
  }
</script>

WebGL-расширения доступны с помощью метода WebGLRenderingContext.getExtension(). Дополнительную информацию можно найти также в Использование расширений в учебнике по WebGL.

let ext = gl.getExtension("WEBGL_multi_draw");

Примеры вызовов для ext.multiDrawArraysWEBGL() и ext.multiDrawArraysInstancedWEBGL():

// multiDrawArrays variant
const firsts = new Int32Array(/* … */);
const counts = new Int32Array(/* … */);
ext.multiDrawArraysWEBGL(gl.TRIANGLES, firsts, 0, counts, 0, firsts.length);

// multiDrawArraysInstanced variant
const firsts = new Int32Array(/* … */);
const counts = new Int32Array(/* … */);
const instanceCounts = new Int32Array(/* … */);
ext.multiDrawArraysInstancedWEBGL(
  gl.TRIANGLES,
  firsts,
  0,
  counts,
  0,
  instanceCounts,
  0,
  firsts.length,
);

Примеры вызовов для ext.multiDrawElementsWEBGL() и ext.multiDrawElementsInstancedWEBGL().

Предполагается, что индексы, которые были ранее загружены в ELEMENT_ARRAY_BUFFER, будут интерпретироваться как UNSIGNED_SHORT.

// multiDrawElements variant
const counts = new Int32Array(/* … */);
const offsets = new Int32Array(/* … */);
ext.multiDrawElementsWEBGL(
  gl.TRIANGLES,
  counts,
  0,
  gl.UNSIGNED_SHORT,
  offsets,
  0,
  counts.length,
);

// multiDrawElementsInstanced variant
const counts = new Int32Array(/* … */);
const offsets = new Int32Array(/* … */);
const instanceCounts = new Int32Array(/* … */);
ext.multiDrawElementsInstancedWEBGL(
  gl.TRIANGLES,
  counts,
  0,
  gl.UNSIGNED_SHORT,
  offsets,
  0,
  instanceCounts,
  0,
  counts.length,
);

• WebGLRenderingContext.drawArrays()
• WebGLRenderingContext.drawElements()
• ANGLE_instanced_arrays.drawArraysInstancedANGLE() или в WebGL 2: WebGL2RenderingContext.drawArraysInstanced()
• ANGLE_instanced_arrays.drawElementsInstancedANGLE() или в WebGL 2: WebGL2RenderingContext.drawElementsInstanced()