---
title: WebGLRenderingContext.bindRenderbuffer()
slug: Web/API/WebGLRenderingContext/bindRenderbuffer
tags:
  - API
  - Method
  - Reference
  - WebGL
  - WebGLRenderingContext
translation_of: Web/API/WebGLRenderingContext/bindRenderbuffer
---
<div>{{APIRef("WebGL")}}</div>

<p><a href="/en-US/docs/Web/API/WebGL_API">WebGL API</a> 的 <strong><code>WebGLRenderingContext.bindRenderbuffer()</code></strong> 方法将给定的 {{domxref("WebGLRenderbuffer")}} 绑定到一个目标，它必须是 gl.RENDERBUFFER 。</p>

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

<pre class="syntaxbox">void <var>gl</var>.bindRenderbuffer(<var>target</var>, <var>renderbuffer</var>);
</pre>

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

<dl>
 <dt>target</dt>
 <dd>{{domxref("GLenum")}} 指定绑定点（目标）。 可能的值：
 <ul>
  <li><code>gl.RENDERBUFFER</code>: 以可渲染的内部格式对单个图像进行缓冲数据存储。</li>
 </ul>
 </dd>
 <dt>renderbuffer</dt>
 <dd>要绑定的 {{domxref("WebGLRenderbuffer")}} 对象。</dd>
</dl>

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

<p>None.</p>

<h3 id="抛出错误">抛出错误</h3>

<p>如果 <code>target</code> 不是 <code>gl.RENDERBUFFER</code>，则抛出 <code>gl.INVALID_ENUM </code>错误。</p>

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

<h3 id="绑定一个渲染缓冲区">绑定一个渲染缓冲区</h3>

<pre class="brush: js">var canvas = document.getElementById('canvas');
var gl = canvas.getContext('webgl');
var renderbuffer = gl.createRenderbuffer();

gl.bindRenderbuffer(gl.RENDERBUFFER, renderbuffer);
</pre>

<h3 id="获取当前绑定">获取当前绑定</h3>

<p>要检查当前的渲染缓冲区绑定，请查询 <code>RENDERBUFFER_BINDING </code>常量。</p>

<pre class="brush: js">gl.getParameter(gl.RENDERBUFFER_BINDING);
</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('WebGL', "#5.14.7", "bindRenderbuffer")}}</td>
   <td>{{Spec2('WebGL')}}</td>
   <td>初始定义.</td>
  </tr>
  <tr>
   <td>{{SpecName('OpenGL ES 2.0', "glBindRenderbuffer.xml", "glBindRenderbuffer")}}</td>
   <td>{{Spec2('OpenGL ES 2.0')}}</td>
   <td>OpenGL API手册.</td>
  </tr>
 </tbody>
</table>

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

<p>{{Compat("api/WebGLRenderingContext", "WebGLRenderingContext.bindRenderbuffer")}}</p>

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

<ul>
 <li>{{domxref("WebGLRenderingContext.createRenderbuffer()")}}</li>
 <li>{{domxref("WebGLRenderingContext.deleteRenderbuffer()")}}</li>
 <li>{{domxref("WebGLRenderingContext.isRenderbuffer()")}}</li>
 <li>Other buffers: {{domxref("WebGLBuffer")}}, {{domxref("WebGLFramebuffer")}}</li>
</ul>