WebGL中使用的STENCIL_INDEX常量在哪里?

时间:2017-04-17 05:35:12

标签: javascript opengl-es webgl

WebGL 1 specification中,我注意到有一个常量const GLenum STENCIL_INDEX = 0x1901;,并且想知道它是如何使用的。我一直试图将它与纹理或渲染缓冲区一起使用,尽管我尝试过的组合都没有。例如,我尝试在下面的示例中使用STENCIL_INDEX代替STENCIL_INDEX8作为渲染缓冲,或者使用texImage2D作为内部格式调用STENCIL_INDEX8STENCIL_INDEX作为格式。

在WebGL 1或2中(如果需要,启用任何扩展),我想知道常量STENCIL_INDEX可以在纹理,渲染缓冲或某些附件配置中使用的位置。即使这是特定于硬件的,我仍然有兴趣知道它是如何使用的。

例如,我很好奇如何修改下面的代码以使用STENCIL_INDEX not STENCIL_INDEX8 - 请注意,这个常量已经在renderbuffer中使用了) :

const pixel = new Uint8Array([0, 0, 0, 0]);

for (const version of ['webgl', 'webgl2']) {
  const canvas = document.createElement('canvas'),
    gl = canvas.getContext(version, {stencil: true}),
    framebuffer = gl.createFramebuffer(),
    stencilbuffer = gl.createRenderbuffer(),
    texture = gl.createTexture();

  canvas.width = 1;
  canvas.height = 1;

  gl.bindFramebuffer(gl.FRAMEBUFFER, framebuffer);

  gl.bindRenderbuffer(gl.RENDERBUFFER, stencilbuffer);
  gl.renderbufferStorage(gl.RENDERBUFFER, gl.STENCIL_INDEX8, 1, 1);
  gl.framebufferRenderbuffer(gl.FRAMEBUFFER, gl.STENCIL_ATTACHMENT, gl.RENDERBUFFER, stencilbuffer);

  gl.bindTexture(gl.TEXTURE_2D, texture);
  gl.texImage2D(gl.TEXTURE_2D, 0, gl.RGBA, 1, 1, 0, gl.RGBA, gl.UNSIGNED_BYTE, pixel);
  gl.texParameteri(gl.TEXTURE_2D, gl.TEXTURE_MAG_FILTER, gl.NEAREST);
  gl.texParameteri(gl.TEXTURE_2D, gl.TEXTURE_MIN_FILTER, gl.NEAREST);
  gl.framebufferTexture2D(gl.FRAMEBUFFER, gl.COLOR_ATTACHMENT0, gl.TEXTURE_2D, texture, 0);

  const status = gl.checkFramebufferStatus(gl.FRAMEBUFFER);
  if (status !== gl.FRAMEBUFFER_COMPLETE) {
    console.error(status, version);
  }

  gl.deleteTexture(texture);
  gl.deleteRenderbuffer(stencilbuffer);
  gl.deleteFramebuffer(framebuffer);
}

我确实看到了OES_texture_stencil8 extension in OpenGL ES 3.1,尽管它在那里声明STENCIL_INDEX常数已经存在。那么常量在OpenGL ES中的用途是什么?这与WebGL中的用法有什么关系呢?

我还找到this line of commented code referencing STENCIL_INDEX in Chromium,这就是为什么我认为我会在这里提出它以防这种行为已知。同样,Firefox似乎没有列出STENCIL_INDEX in its formats enum,似乎没有引用STENCIL_INDEX,除了一致性测试,确保常量存在并且值为0x1901

1 个答案:

答案 0 :(得分:1)

这是一个很好的问题。我想也许这是WebGL规范中的错误

检查OpenGL ES 2.0 spec似乎没有提及STENCIL_INDEXSTENCIL_INDEX也不在OpenGL ES 2.0 headers

OpenGL ES 3.0 specES 3.0 headers中也没有提到它。直到ES 3.1出现

也许you should search and/or ask here