---
title: WebGL2RenderingContext.drawBuffers()
slug: Web/API/WebGL2RenderingContext/drawBuffers
translation_of: Web/API/WebGL2RenderingContext/drawBuffers
---
<div>{{APIRef("WebGL")}} {{SeeCompatTable}}</div>

<p><a href="/en-US/docs/Web/API/WebGL_API">WebGL 2 API</a>的 <strong><code>WebGL2RenderingContext.drawBuffers()</code></strong>  方法定义了将写入零散数据（fragment colors）的绘制缓存(draw buffer)。绘制缓存设置了上一次绑定帧缓存状态，如果没有帧缓存可用的话，则用绘制缓存。</p>

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

<pre class="syntaxbox notranslate">void <var>gl</var>.drawBuffers(<var>buffers</var>);
</pre>

<h3 id="参数">参数</h3>

<dl>
 <dt><code>buffers</code></dt>
 <dd>一个 <span>{{domxref("GLenum")}}的{{jsxref("Array")}}}</span> 对碎片颜色的说明将被写入缓冲区。可能的值有:
 <ul>
  <li><code>gl.NONE</code>: 碎片着色器的输出没有被写入到任何颜色缓存中。</li>
  <li><code>gl.BACK</code>: 碎片着色器的输出被写入到返回的颜色缓存中。</li>
  <li><code>gl.COLOR_ATTACHMENT{0-15}</code>: 碎片着色器的输出被写入当前帧缓存的第n个颜色缓存中。Fragment shader output is written in the nth color attachment of the current framebuffer.</li>
 </ul>
 </dd>
</dl>

<h3 id="返回值">返回值</h3>

<p>没有。</p>

<h3 id="报错信息">报错信息</h3>

<ul>
 <li>如果<code> buffers</code> 包含了不止一个合法值，  <code>gl.INVALID_ENUM</code>错误会被抛出</li>
</ul>

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

<pre class="brush: js notranslate">gl.drawBuffers([gl.NONE, gl.COLOR_ATTACHMENT1]);
</pre>

<h2 id="详情">详情</h2>

<table class="standard-table">
 <tbody>
  <tr>
   <th scope="col">详情</th>
   <th scope="col">状态</th>
   <th scope="col">用法(Comment)</th>
  </tr>
  <tr>
   <td>{{SpecName('WebGL2', "#3.7.11", "drawBuffers")}}</td>
   <td>{{Spec2('WebGL2')}}</td>
   <td>Initial definition for WebGL.</td>
  </tr>
  <tr>
   <td>{{SpecName('OpenGL ES 3.0', "glDrawBuffers.xhtml", "glDrawBuffers")}}</td>
   <td>{{Spec2('OpenGL ES 3.0')}}</td>
   <td>Man page of the (similar) OpenGL API.</td>
  </tr>
 </tbody>
</table>

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

<p class="hidden">此页面的兼容性表格通过结构数据生成，如果你想对数据做出贡献, 请点击 <a href="https://github.com/mdn/browser-compat-data">https://github.com/mdn/browser-compat-data</a> 并且给我们发邮箱</p>

<p>{{Compat("api/WebGL2RenderingContext", "WebGL2RenderingContext.drawBuffers")}}</p>

<h2 id="详见">详见</h2>

<ul>
 <li>{{domxref("WebGL2RenderingContext.clearBuffer", "WebGL2RenderingContext.clearBuffer[fiuv]()")}}</li>
</ul>