在此页

• 句法
• 范例
• 规范
• 浏览器兼容性
• 另请参阅
• 相关话题

WebGLRenderingContext.getFramebufferAttachmentParameter() 方法在 WebGL API returns information about a framebuffer's attachment.

句法

any gl.getFramebufferAttachmentParameter(target, attachment, pname);
					

参数

target

A GLenum specifying the binding point (target). Possible values:

• gl.FRAMEBUFFER : Collection buffer data storage of color, alpha, depth and stencil buffers used to render an image.
• 当使用 WebGL 2 context , the following values are available additionally:
  • gl.DRAW_FRAMEBUFFER : Equivalent to gl.FRAMEBUFFER . Used as a destination for drawing, rendering, clearing, and writing operations.
  • gl.READ_FRAMEBUFFER : Used as a source for reading operations.

attachment

A GLenum specifying the attachment point for the texture . Possible values:

• gl.COLOR_ATTACHMENT0 : Texture attachment for the framebuffer's color buffer.
• gl.DEPTH_ATTACHMENT : Texture attachment for the framebuffer's depth buffer.
• gl.STENCIL_ATTACHMENT : Texture attachment for the framebuffer's stencil buffer.
• gl.DEPTH_STENCIL_ATTACHMENT : Texture attachment for both, the depth and stencil buffer.
• 当使用 WebGL 2 context , the following values are available additionally:
  • gl.COLOR_ATTACHMENT1
gl.COLOR_ATTACHMENT2
gl.COLOR_ATTACHMENT3
gl.COLOR_ATTACHMENT4
gl.COLOR_ATTACHMENT5
gl.COLOR_ATTACHMENT6
gl.COLOR_ATTACHMENT7
gl.COLOR_ATTACHMENT8
gl.COLOR_ATTACHMENT9
gl.COLOR_ATTACHMENT10
gl.COLOR_ATTACHMENT11
gl.COLOR_ATTACHMENT12
gl.COLOR_ATTACHMENT13
gl.COLOR_ATTACHMENT14
gl.COLOR_ATTACHMENT15
• 当使用 WEBGL_draw_buffers extension:
  • ext.COLOR_ATTACHMENT0_WEBGL (same as gl.COLOR_ATTACHMENT0 )
    ext.COLOR_ATTACHMENT1_WEBGL
ext.COLOR_ATTACHMENT2_WEBGL
ext.COLOR_ATTACHMENT3_WEBGL
ext.COLOR_ATTACHMENT4_WEBGL
ext.COLOR_ATTACHMENT5_WEBGL
ext.COLOR_ATTACHMENT6_WEBGL
ext.COLOR_ATTACHMENT7_WEBGL
ext.COLOR_ATTACHMENT8_WEBGL
ext.COLOR_ATTACHMENT9_WEBGL
ext.COLOR_ATTACHMENT10_WEBGL
ext.COLOR_ATTACHMENT11_WEBGL
ext.COLOR_ATTACHMENT12_WEBGL
ext.COLOR_ATTACHMENT13_WEBGL
ext.COLOR_ATTACHMENT14_WEBGL
ext.COLOR_ATTACHMENT15_WEBGL

pname

A GLenum specifying information to query. Possible values:

• gl.FRAMEBUFFER_ATTACHMENT_OBJECT_TYPE : The type which contains the attached image.
• gl.FRAMEBUFFER_ATTACHMENT_OBJECT_NAME : The texture or renderbuffer of the attached image ( WebGLRenderbuffer or WebGLTexture ).
• gl.FRAMEBUFFER_ATTACHMENT_TEXTURE_LEVEL : Mipmap level. Default value: 0.
• gl.FRAMEBUFFER_ATTACHMENT_TEXTURE_CUBE_MAP_FACE : The name of cube-map face of the texture.
• 当使用 EXT_sRGB extension:
  • ext.FRAMEBUFFER_ATTACHMENT_COLOR_ENCODING_EXT : The framebuffer color encoding.
• 当使用 WebGL 2 context , the following values are available additionally:
  • gl.FRAMEBUFFER_ATTACHMENT_ALPHA_SIZE
  • gl.FRAMEBUFFER_ATTACHMENT_BLUE_SIZE
  • gl.FRAMEBUFFER_ATTACHMENT_COLOR_ENCODING
  • gl.FRAMEBUFFER_ATTACHMENT_COMPONENT_TYPE
  • gl.FRAMEBUFFER_ATTACHMENT_DEPTH_SIZE
  • gl.FRAMEBUFFER_ATTACHMENT_GREEN_SIZE
  • gl.FRAMEBUFFER_ATTACHMENT_RED_SIZE
  • gl.FRAMEBUFFER_ATTACHMENT_STENCIL_SIZE
  • gl.FRAMEBUFFER_ATTACHMENT_TEXTURE_LAYER
• 当使用 OVR_multiview2 extension:
  • ext.FRAMEBUFFER_ATTACHMENT_TEXTURE_NUM_VIEWS_OVR : the number of views of the framebuffer object attachment.
  • ext.FRAMEBUFFER_ATTACHMENT_TEXTURE_BASE_VIEW_INDEX_OVR :  the base view index of the framebuffer object attachment.

返回值

Depends on the requested information (as specified with pname ). Either a GLint ， GLenum ， WebGLRenderbuffer ，或 WebGLTexture .

pname 参数	返回值
gl.FRAMEBUFFER_ATTACHMENT_OBJECT_TYPE	A GLenum indicating the type of the texture. Either gl.RENDERBUFFER , gl.TEXTURE , or if no image is attached, gl.NONE .
gl.FRAMEBUFFER_ATTACHMENT_OBJECT_NAME	The texture ( WebGLTexture ) or renderbuffer ( WebGLRenderbuffer ) of the attached image.
gl.FRAMEBUFFER_ATTACHMENT_TEXTURE_LEVEL	A GLint indicating the mipmap level. Default value: 0.
gl.FRAMEBUFFER_ATTACHMENT_TEXTURE_CUBE_MAP_FACE	A GLenum indicating the name of cube-map face of the texture. Possible values: gl.TEXTURE_CUBE_MAP_POSITIVE_X : Image for the positive X face of the cube. gl.TEXTURE_CUBE_MAP_NEGATIVE_X : Image for the negative X face of the cube. gl.TEXTURE_CUBE_MAP_POSITIVE_Y : Image for the positive Y face of the cube. gl.TEXTURE_CUBE_MAP_NEGATIVE_Y : Image for the negative Y face of the cube. gl.TEXTURE_CUBE_MAP_POSITIVE_Z : Image for the positive Z face of the cube. gl.TEXTURE_CUBE_MAP_NEGATIVE_Z : Image for the negative Z face of the cube.
gl.FRAMEBUFFER_ATTACHMENT_ALPHA_SIZE	A GLint indicating the number of bits in the alpha component of the attachment.
gl.FRAMEBUFFER_ATTACHMENT_BLUE_SIZE	A GLint indicating the number of bits in the blue component of the attachment.
gl.FRAMEBUFFER_ATTACHMENT_COLOR_ENCODING	A GLenum indicating the encoding of components of the specified attachment. Either gl.LINEAR or gl.SRGB .
gl.FRAMEBUFFER_ATTACHMENT_COMPONENT_TYPE	A GLenum indicating the format of the components of the specified attachment. Either gl.FLOAT , gl.INT , gl.UNSIGNED_INT , gl.SIGNED_NORMALIZED ，或 gl.UNSIGNED_NORMALIZED .
gl.FRAMEBUFFER_ATTACHMENT_DEPTH_SIZE	A GLint indicating the number of bits in the depth component of the attachment.
gl.FRAMEBUFFER_ATTACHMENT_GREEN_SIZE	A GLint indicating the number of bits in the green component of the attachment.
gl.FRAMEBUFFER_ATTACHMENT_RED_SIZE	A GLint indicating the number of bits in the red component of the attachment.
gl.FRAMEBUFFER_ATTACHMENT_STENCIL_SIZE	A GLint indicating the number of bits in the stencil component of the attachment.
gl.FRAMEBUFFER_ATTACHMENT_TEXTURE_LAYER	A GLint indicating the number of the texture layer which contains the attached image.
ext.FRAMEBUFFER_ATTACHMENT_COLOR_ENCODING_EXT	A GLenum indicating the framebuffer color encoding. Either gl.LINEAR or ext.SRGB_EXT .
ext.FRAMEBUFFER_ATTACHMENT_TEXTURE_NUM_VIEWS_OVR	A GLsizei indicating the number of views of the framebuffer object attachment.
ext.FRAMEBUFFER_ATTACHMENT_TEXTURE_BASE_VIEW_INDEX_OVR	A GLint indicating the base view index of the framebuffer object attachment.

异常

• A gl.INVALID_ENUM error is thrown if target 不是 gl.FRAMEBUFFER , gl.DRAW_FRAMEBUFFER , gl.READ_FRAMEBUFFER or if attachment is not one of the accepted attachment points.

范例

gl.getFramebufferAttachmentParameter(gl.FRAMEBUFFER, gl.COLOR_ATTACHMENT0,
                                     gl.FRAMEBUFFER_ATTACHMENT_OBJECT_TYPE);
					

规范

规范	状态	注释
WebGL 1.0 The definition of 'getFramebufferAttachmentParameter' in that specification.	推荐	Initial definition for WebGL.
OpenGL ES 2.0 The definition of 'glGetFramebufferAttachmentParameteriv' in that specification.	标准	Man page of the (similar) OpenGL API.
WebGL 2.0 The definition of 'getFramebufferAttachmentParameter' in that specification.	编者草案	Updated definition for WebGL 2.
OpenGL ES 3.0 The definition of 'glGetFramebufferAttachmentParameteriv' in that specification.	标准	Man page of the (similar) OpenGL ES 3 API.

浏览器兼容性

The compatibility table in this page is generated from structured data. If you'd like to contribute to the data, please check out https://github.com/mdn/browser-compat-data and send us a pull request.

更新 GitHub 上的兼容性数据

	桌面						移动
	Chrome	Edge	Firefox	Internet Explorer	Opera	Safari	Android webview	Chrome for Android	Firefox for Android	Opera for Android	Safari on iOS	Samsung Internet
getFramebufferAttachmentParameter	Chrome 9	Edge 12	Firefox 4	IE 11	Opera 12	Safari 5.1	WebView Android Yes	Chrome Android 25	Firefox Android Yes	Opera Android 12	Safari iOS 8	Samsung Internet Android 1.5
WebGL2	Chrome 56	Edge 79	Firefox 51	IE No	Opera 43	Safari No	WebView Android 58	Chrome Android 58	Firefox Android 51	Opera Android 43	Safari iOS No	Samsung Internet Android 7.0

图例

完整支持

完整支持

不支持

不支持

另请参阅

• WebGLRenderingContext.createFramebuffer()
• WebGLRenderingContext.deleteFramebuffer()
• WebGLRenderingContext.isFramebuffer()
• Other buffers: WebGLBuffer , WebGLRenderbuffer
• EXT_sRGB
• WEBGL_draw_buffers

元数据

• 最后修改： Nov 26, 2019

相关话题

1. WebGL API
2. WebGLRenderingContext
3. 特性

   1. canvas
   2. drawingBufferHeight
   3. drawingBufferWidth
4. 方法

   1. activeTexture()
   2. attachShader()
   3. bindAttribLocation()
   4. bindBuffer()
   5. bindFramebuffer()
   6. bindRenderbuffer()
   7. bindTexture()
   8. blendColor()
   9. blendEquation()
   10. blendEquationSeparate()
   11. blendFunc()
   12. blendFuncSeparate()
   13. bufferData()
   14. bufferSubData()
   15. checkFramebufferStatus()
   16. clear()
   17. clearColor()
   18. clearDepth()
   19. clearStencil()
   20. colorMask()
   21. commit()
   22. compileShader()
   23. compressedTexImage[23]D()
   24. compressedTexSubImage2D()
   25. copyTexImage2D()
   26. copyTexSubImage2D()
   27. createBuffer()
   28. createFramebuffer()
   29. createProgram()
   30. createRenderbuffer()
   31. createShader()
   32. createTexture()
   33. cullFace()
   34. deleteBuffer()
   35. deleteFramebuffer()
   36. deleteProgram()
   37. deleteRenderbuffer()
   38. deleteShader()
   39. deleteTexture()
   40. depthFunc()
   41. depthMask()
   42. depthRange()
   43. detachShader()
   44. disable()
   45. disableVertexAttribArray()
   46. drawArrays()
   47. drawElements()
   48. enable()
   49. enableVertexAttribArray()
   50. finish()
   51. flush()
   52. framebufferRenderbuffer()
   53. framebufferTexture2D()
   54. frontFace()
   55. generateMipmap()
   56. getActiveAttrib()
   57. getActiveUniform()
   58. getAttachedShaders()
   59. getAttribLocation()
   60. getBufferParameter()
   61. getContextAttributes()
   62. getError()
   63. getExtension()
   64. getFramebufferAttachmentParameter()
   65. getParameter()
   66. getProgramInfoLog()
   67. getProgramParameter()
   68. getRenderbufferParameter()
   69. getShaderInfoLog()
   70. getShaderParameter()
   71. getShaderPrecisionFormat()
   72. getShaderSource()
   73. getSupportedExtensions()
   74. getTexParameter()
   75. getUniform()
   76. getUniformLocation()
   77. getVertexAttrib()
   78. getVertexAttribOffset()
   79. hint()
   80. isBuffer()
   81. isContextLost()
   82. isEnabled()
   83. isFramebuffer()
   84. isProgram()
   85. isRenderbuffer()
   86. isShader()
   87. isTexture()
   88. lineWidth()
   89. linkProgram()
   90. pixelStorei()
   91. polygonOffset()
   92. readPixels()
   93. renderbufferStorage()
   94. sampleCoverage()
   95. scissor()
   96. shaderSource()
   97. stencilFunc()
   98. stencilFuncSeparate()
   99. stencilMask()
   100. stencilMaskSeparate()
   101. stencilOp()
   102. stencilOpSeparate()
   103. texImage2D()
   104. texParameter[fi]()
   105. texSubImage2D()
   106. uniform[1234][fi][v]()
   107. uniformMatrix[234]fv()
   108. useProgram()
   109. validateProgram()
   110. vertexAttrib[1234]f[v]()
   111. vertexAttribPointer()
   112. viewport()
5. WebGL 相关页面

   1. ANGLE_instanced_arrays
   2. EXT_blend_minmax
   3. EXT_color_buffer_half_float
   4. EXT_disjoint_timer_query
   5. EXT_frag_depth
   6. EXT_sRGB
   7. EXT_shader_texture_lod
   8. EXT_texture_filter_anisotropic
   9. OES_element_index_uint
   10. OES_standard_derivatives
   11. OES_texture_float
   12. OES_texture_float_linear
   13. OES_texture_half_float
   14. OES_texture_half_float_linear
   15. OES_vertex_array_object
   16. WEBGL_color_buffer_float
   17. WEBGL_compressed_texture_atc
   18. WEBGL_compressed_texture_etc1
   19. WEBGL_compressed_texture_pvrtc
   20. WEBGL_compressed_texture_s3tc
   21. WEBGL_compressed_texture_s3tc_srgb
   22. WEBGL_debug_renderer_info
   23. WEBGL_debug_shaders
   24. WEBGL_depth_texture
   25. WEBGL_draw_buffers
   26. WEBGL_lose_context
   27. WebGL2RenderingContext
   28. WebGLActiveInfo
   29. WebGLBuffer
   30. WebGLContextEvent
   31. WebGLFramebuffer
   32. WebGLObject
   33. WebGLProgram
   34. WebGLQuery
   35. WebGLRenderbuffer
   36. WebGLSampler
   37. WebGLShader
   38. WebGLShaderPrecisionFormat
   39. WebGLSync
   40. WebGLTexture
   41. WebGLTransformFeedback
   42. WebGLUniformLocation
   43. WebGLVertexArrayObject