就业培训     下载中心     Wiki     联络
登录   注册
  1. 首页
  2. Web API
  3. WebGLRenderingContext
  4. WebGLRenderingContext.framebufferTexture2D()

在此页

WebGLRenderingContext.framebufferTexture2D() 方法在 WebGL API attaches a texture to a WebGLFramebuffer .

句法 

void gl.framebufferTexture2D(target, attachment, textarget, texture, level);

参数

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 : Attaches the texture to the framebuffer's color buffer.
  • gl.DEPTH_ATTACHMENT : Attaches the texture to the framebuffer's depth buffer.
  • gl.STENCIL_ATTACHMENT : Attaches the texture to the framebuffer's stencil buffer.
  • 当使用 WebGL 2 context , the following values are available additionally:
    • gl.DEPTH_STENCIL_ATTACHMENT : depth and stencil buffer.
    • 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
  • 当使用 WEBGL_depth_texture extension:
    • gl.DEPTH_STENCIL_ATTACHMENT : Depth and stencil buffer data storage.
textarget
A GLenum specifying the texture target. Possible values:
  • gl.TEXTURE_2D : A 2D image.
  • 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.
texture
WebGLTexture object whose image to attach.
level
GLint specifying the mipmap level of the texture image to be attached. Must be 0.

返回值

None.

异常

  • A gl.INVALID_ENUM error is thrown if
    • target 不是 gl.FRAMEBUFFER .
    • attachment is not one of the accepted attachment points.
    • textarget is not one of the accepted texture targets.
  • A gl.INVALID_VALUE error is thrown if level is not 0.
  • A gl.INVALID_OPERATION error is thrown if texture isn't 0 or the name of an existing texture object.

范例 

gl.framebufferTexture2D(gl.FRAMEBUFFER, gl.COLOR_ATTACHMENT0, gl.TEXTURE_2D, texture, 0);

规范

规范 状态 注释
WebGL 1.0
The definition of 'framebufferTexture2D' in that specification. 		推荐 初始定义。
OpenGL ES 2.0
The definition of 'glFramebufferTexture2D' in that specification. 		标准 Man page of the (similar) OpenGL ES 2 API.
OpenGL ES 3.0
The definition of 'glFramebufferTexture2D' in that specification. 		标准 Man page of the (similar) OpenGL ES 3 API.

浏览器兼容性

更新 GitHub 上的兼容性数据
桌面 移动
Chrome Edge Firefox Internet Explorer Opera Safari Android webview Chrome for Android Firefox for Android Opera for Android Safari on iOS Samsung Internet
framebufferTexture2D 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

图例

完整支持

完整支持

不支持

不支持

另请参阅

元数据

  • 最后修改：
  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