---
title: ANGLE_instanced_arrays
slug: Web/API/ANGLE_instanced_arrays
translation_of: Web/API/ANGLE_instanced_arrays
---
<div>{{APIRef("WebGL")}}</div>

<div><code><strong>ANGLE_instanced_arrays</strong>是</code>属于 <a href="/zh-CN/docs/Web/API/WebGL_API">WebGL API </a><code>的一个扩展API，</code>它允许多次绘制相同的对象或相似对象组，前提是它们共享相同的顶点数据、基本图形的个数和类型。</div>

<div></div>

<div>WebGL的扩展都能使用{{domxref("WebGLRenderingContext.getExtension()")}} 这个方法。更多详细信息，请参考 <a href="/zh-CN/docs/Web/API/WebGL_API/Tutorial">WebGL tutorial</a><em>（WebGL使用教程）里的</em><a href="/zh-CN/docs/Web/API/WebGL_API/Using_Extensions">Using Extensions</a> <em>（使用扩展）</em>。</div>

<div></div>

<div class="note">
<p><strong>实用性:</strong> 这个扩展仅仅能使用在 {{domxref("WebGLRenderingContext", "WebGL1", "", 1)}} 上下文中。在 {{domxref("WebGL2RenderingContext", "WebGL2", "", 1)}}，默认情况下这个扩展的在WebGL2的上下文中起作用，它的常量以及方法使用过程中没有“ANGEL”后缀。</p>

<p>尽管名字叫“ANGLE”，只要硬件支持，它可以运行在任意设备上，而不仅是在Windows上起作用。 "ANGLE"只是表明了这个扩展是被ANGLE这个库的作者书写的，并没有更多的含义。</p>
</div>

<h2 id="常量">常量</h2>

<p>这个扩展提供了一个新常量，它能被 {{domxref("WebGLRenderingContext.getVertexAttrib()", "gl.getVertexAttrib()")}} 这个方法所使用:</p>

<dl>
 <dt><code>ext.VERTEX_ATTRIB_ARRAY_DIVISOR_ANGLE</code></dt>
 <dd>当这个常量在{{domxref("WebGLRenderingContext.getVertexAttrib()", "gl.getVertexAttrib()")}}中作为pname参数使用时，将返回一个用于实例渲染的频率因子{{domxref("GLint")}}。</dd>
</dl>

<h2 id="方法">方法</h2>

<p>这个扩展提供了三个新的方法。</p>

<dl>
 <dt>{{domxref("ANGLE_instanced_arrays.drawArraysInstancedANGLE()", "ext.drawArraysInstancedANGLE()")}}</dt>
 <dd>
 <p>作用与{{domxref("WebGLRenderingContext.drawArrays()", "gl.drawArrays()")}} 相同，除了元素范围的多实例的执行以及每次迭代时的实例扩展。</p>
 </dd>
 <dt>{{domxref("ANGLE_instanced_arrays.drawElementsInstancedANGLE()", "ext.drawElementsInstancedANGLE()")}}</dt>
 <dd>
 <p>作用与{{domxref("WebGLRenderingContext.drawElements()", "gl.drawElements()")}}相同，除了元素集中的多实例的计算以及每个集之间的实例扩展。</p>
 </dd>
 <dt>{{domxref("ANGLE_instanced_arrays.vertexAttribDivisorANGLE()", "ext.vertexAttribDivisorANGLE()")}}</dt>
 <dd>当用{{domxref("ANGLE_instanced_arrays.drawArraysInstancedANGLE()", "ext.drawArraysInstancedANGLE()")}}和{{domxref("ANGLE_instanced_arrays.drawElementsInstancedANGLE()", "ext.drawElementsInstancedANGLE()")}}渲染基本图元的多实例时，会提升通用的顶点属性的速度。</dd>
</dl>

<h2 id="示例">示例</h2>

<p>启用扩展：</p>

<pre class="brush: js">var ext = gl.getExtension("ANGLE_instanced_arrays");
</pre>

<h2 id="规范">规范</h2>

<table class="standard-table">
 <tbody>
  <tr>
   <th scope="col">Specification</th>
   <th scope="col">Status</th>
   <th scope="col">Comment</th>
  </tr>
  <tr>
   <td>{{SpecName('ANGLE_instanced_arrays', '', 'ANGLE_instanced_arrays')}}</td>
   <td>{{Spec2('ANGLE_instanced_arrays')}}</td>
   <td>初始定义。</td>
  </tr>
 </tbody>
</table>

<h2 id="浏览器兼容性">浏览器兼容性</h2>

<p>{{Compat("api.ANGLE_instanced_arrays")}}</p>

<h2 id="相关链接">相关链接</h2>

<ul>
 <li>{{domxref("WebGLRenderingContext.getExtension()")}}</li>
 <li>{{domxref("WebGL2RenderingContext.drawArraysInstanced()")}}</li>
 <li>{{domxref("WebGL2RenderingContext.drawElementsInstanced()")}}</li>
 <li>{{domxref("WebGL2RenderingContext.vertexAttribDivisor()")}}</li>
</ul>