Opengl4.5 中文手册—B

Posted 2020-10-08 wiki3D

索引

A       B     C      D     E     F     G  

H       I       L     M     N

O       P     Q      R     S     T   

U       V     W 

 

B

glBeginConditionalRender 3.0

开始条件渲染

         GLuint queryid

         GLenu mode: GL_QUERY_WAIT|GL_QUERY_NOWAIT|

GL_QUERY_BY_REGION_WAIT|GL_QUERY_REGION_NOWAIT

         根据遮挡查询结果进行绘制，_WAIT会等待查询执行完毕，再根据结果判断；_NOWAIT版本在Query未执行完时会直接绘制

glBeginQuery 2.0

开启遮挡查询

         GLenum target:

GL_SAMPLES_PASSED,  通过的采样个数

GL_ANY_SAMPLES_PASSED,  是否存在通过的采样 3.3+

GL_ANY_SAMPLES_PASSED_CONSERVATIVE,  非精确的结果(保守)，速度可能快 4.3+

GL_PRIMITIVES_GENERATED, vertex shader或者geometry shader emit顶点数

GL_TRANSFORM_FEEDBACK_PRIMITIVES_WRITTEN, 查询生成到反馈查询缓冲区中的顶点数

GL_TIME_ELAPSED

         GLuint queryid

 

glEndQuery(GLenum target ):与begin相同

          结束查询

 

可以使用glGetQuery、glGetQueryObject获取查询结果

 

glBeginQueryIndexed 4.0

4启用索引查询，用于geometryshader

         GLenum target

         GLuint index 和BeginQuery区别在于使用geometryshader并在在target为GL_PRIMITIVES_GENERATED\\ GL_TRANSFORM_FEEDBACK_PRIMITIVES_WRITTEN时，可指定对应的stream索引

         GLuint queryid

glEndQueryIndexed结束查询

glBeginTransformFeedback

3.0+ 开启反馈查询      

GLenum mode: GL_POINTS\\GL_LINES\\GL_TRIANGLES

用于将vertex或者geometry shader结果输出到通过glBindBufferBase、glBindBufferRange绑定的GL_TRANSFORM_FEEDBACK_BUFFER缓冲区，不是通过glBindBuffer绑定(无索引参数，只能绑定到非数组类型的目标缓冲区：GL_ATOMIC_COUNTER_BUFFER, GL_TRANSFORM_FEEDBACK_BUFFER, GL_UNIFORM_BUFFER or GL_SHADER_STORAGE_BUFFER). P458

         记录的顶点程序输出可在程序链接前通过glTransformFeedbackVaryings设置

glBindAttribLocation 2.0

设置顶点属性索引，一般在shader中用layout(location=index) 设置，设置的索引在linkprogram之后生效。

可以将多个名称绑定到同一索引，实现别名

GLuint program,

GLuint index,

      const GLchar *name

 

绑定片段程序输出使用glBindFragDataLocation

glBindBuffer 2.0

关联buffer

GLenum target:

GL_ARRAY_BUFFER   顶点属性，用于glVertexAttribPointer

GL_ELEMENT_ARRAY_BUFFER         顶点索引，用于glDrawElements等索引绘制方法

GL_COPY_READ_BUFFER          Buffer copy source

GL_COPY_WRITE_BUFFER        Buffer copy destination

GL_PIXEL_PACK_BUFFER           用于从纹理或帧缓冲区对象中读取像素数据  glGetCompressedTexImage, glGetTexImage, and glReadPixels.

GL_PIXEL_UNPACK_BUFFER     作为生成纹理数据源，用于glTexImage2D, glTexImage3D, glTexSubImage1D, glTexSubImage2D等

GL_TEXTURE_BUFFER       Texture data buffer

GL_QUERY_BUFFER   用于存储查询结果glGetQuery

GL_DISPATCH_INDIRECT_BUFFER   用于glDispatchComputeIndirect

GL_DRAW_INDIRECT_BUFFER  用于glDrawArraysIndirect and glDrawElementsIndirect

 

以下四个类型含多个绑定点，需要使用glBindBufferBase 或glBindBufferRange绑定

GL_ATOMIC_COUNTER_BUFFER     Atomic counter storage

GL_SHADER_STORAGE_BUFFER       Read-write storage for shaders

GL_TRANSFORM_FEEDBACK_BUFFER     Transform feedback buffer

GL_UNIFORM_BUFFER

GLuint bufferID

glBindBufferBase

3.0+ 绑定索引的数组类型的缓冲区，也可绑定非索引类型缓冲区

索引缓冲区包括：GL_ATOMIC_COUNTER_BUFFER, GL_TRANSFORM_FEEDBACK_BUFFER

, GL_UNIFORM_BUFFER or GL_SHADER_STORAGE_BUFFER

GLenum target,

GLuint index, 相比glBindBuffer增加了此参数，指定对应绑定点索引，

GLuint buffer

 

glBindBufferRange

3.0+绑定索引的缓冲区中可用数据范围，也可用于绑定非索引类型缓冲区

索引缓冲区包括：GL_ATOMIC_COUNTER_BUFFER, GL_TRANSFORM_FEEDBACK_BUFFER

, GL_UNIFORM_BUFFER or GL_SHADER_STORAGE_BUFFER

相比glBindBufferBase增加了offset和size

GLenum   target,

      GLuint      index,

      GLuint      buffer,

      GLintptr   offset,

      GLsizeiptr                 size

glBindFramebuffer

关联帧缓冲区

3.0+

GLenum target, ：GL_DRAW_FRAMEBUFFER 渲染、GL_READ_FRAMEBUFFER读取、GL_FRAMEBUFFER 渲染和读取

      GLuint framebuffer

 

关联到GL_DRAW_FRAMEBUFFER的Framebuffer的可通过glFramebufferRenderbuffer挂接渲染缓冲区、以及通过glFramebufferTexture2D渲染到纹理。

glBindFragDataLocation 3.0

设置片段程序输出对应的颜色缓冲区索引

GLuint program,

      GLuint colorNumber, [0, GL_MAX_DRAW_BUFFERS)

      const char * name 变量名称

如果片段程序使用layout (location = colorNumber)指定了索引，则此方法调用无效

不可以将多个变量输出到同一索引

主要用于多渲染目标绘制，参考glDrawBuffers

glBindFragDataLocationIndexed 3.2

同glBindFragDataLocation， 增加了index，分别为0/1表示对应颜色混合等式的第一个或第二个输入项

GLuint program,

      GLuint colorNumber,

      GLuint index,

      const char *name

glBindImageTexture

4.2+ 绑定纹理到image unit用于后续的shader读写

GLuint unit,              绑定到的image unit索引

      GLuint texture,       

      GLint level,               使用的纹理level

      GLboolean layered,使用纹理数组或者立方体纹理时，是否按层堆放。true 使用所有, false 仅使用layer指定的层

      GLint layer, layerder=false时指定使用的层

      GLenum access, GL_READ_ONLY, GL_WRITE_ONLY, or GL_READ_WRITE 指定读写权限

      GLenum format 数据输出格式，应与纹理的innerformat同大小并属于同一类。

glBindImageTextures

4.4+ 批量绑定纹理到image unit

GLuint first,     起始iamge unit索引

      GLsizei count,

      const GLuint *textures

采用layered方式绑定level 0，格式与纹理格式相同

glBindProgramPipeline

4.1+ 绑定管线对象到当前上下文

         GLuint pipeline

如果glUseProgram 设置了当前程序，则使用glUseProgram的设置，glUseProgram优先级较高。

glBindRenderbuffer

3.0+ 绑定渲染缓冲区

GLenum target, GL_RENDERBUFFER 仅此一个绑定点，设计多余

      GLuint renderbuffer

绑定后可通过glRenderbufferStorage初始化格式和大小，并关联到Framebuffer用于后续渲染

glBindSampler

3.3+ 将采样器关联到纹理单元

         GLuint unit

         GLuint sampler

采样器设置优先于纹理的单元的纹理状态设置，未设置采样器才会采用纹理状态设置

一个采样器可用于多个纹理单元

glBindSamplers

4.4+ 批量设置多个采样器

GLuint first,     起始纹理单元索引

      GLsizei count,

      const GLuint *samplers

glBindTexture

2.0+ 绑定纹理

GLenum target: GL_TEXTURE_1D, GL_TEXTURE_2D, GL_TEXTURE_3D, GL_TEXTURE_1D_ARRAY, GL_TEXTURE_2D_ARRAY, GL_TEXTURE_RECTANGLE, GL_TEXTURE_CUBE_MAP, GL_TEXTURE_CUBE_MAP_ARRAY, GL_TEXTURE_BUFFER, GL_TEXTURE_2D_MULTISAMPLE or GL_TEXTURE_2D_MULTISAMPLE_ARRAY

GLuint     texture

纹理默认仅当前渲染上下文可见。

glBindTextures

4.4+ 批量绑定纹理

GLuint first,     起始纹理单元

GLsizei count,

const GLuint *textures

glBindTextureUnit

4.5+ 蒋纹理直接绑定到纹理单元

GLuint unit,

GLuint texture

相当于glActiveTexture +glBindTexture， 可配合glBindSampler

glBindTransformFeedback

4.0+ 绑定变换反馈对象

GLenum target,  GL_TRANSFORM_FEEDBACK

      GLuint id

glBindVertexArray

3.0+ 绑定顶点数组对象VAO

GLuint arrayID

glBindVertexBuffer

4.3+ 绑定顶点buffer ，相当于glBindBuffer+glVertexAttribPointer，但简单多了，以前设计太累赘

GLuint bindingindex, 绑定索引

      GLuint buffer,

      GLintptr offset,

      GLintptr stride

 

4.5+ glVertexArrayVertexBuffer 直接绑定到VAO

glBindVertexBuffers

4.4+ 批量绑定多个顶点buffer

GLuint firstIndex,

      GLsizei count,

      const GLuint *buffers,

      const GLuintptr *offsets,

      const GLsizei *strides

glBlendColor

2.0+ 设置混合颜色，用于glBlendFunc:: GL_CONSTANT_COLOR

GLfloat red,

      GLfloat green,

      GLfloat blue,

      GLfloat alpha

glBlendEquation

2.0+ 设置源、目标混合方程式

         GLenum mode GL_FUNC_ADD, GL_FUNC_SUBTRACT, GL_FUNC_REVERSE_SUBTRACT, GL_MIN, GL_MAX 加、减、目标-源，最小、最大

 

glBlendEquationi (          GLuint buf, GLenum mode) 4.0+ 依据索引设置指定drawbuffer

glBlendEquationSeparate

2.0+ 对rgb和alpha设置不同的方程式

GLenum modeRGB,

      GLenum modeAlpha

glBlendFunc

2.0+ 设置源和目标混合因子

         GLenum src, dst ：

GL_ZERO, GL_ONE, GL_SRC_COLOR, GL_ONE_MINUS_SRC_COLOR, GL_DST_COLOR, GL_ONE_MINUS_DST_COLOR, GL_SRC_ALPHA, GL_ONE_MINUS_SRC_ALPHA, GL_DST_ALPHA, GL_ONE_MINUS_DST_ALPHA. GL_CONSTANT_COLOR, GL_ONE_MINUS_CONSTANT_COLOR, GL_CONSTANT_ALPHA, and GL_ONE_MINUS_CONSTANT_ALPHA

 

GL_CONSTANT_COLOR : 采用glBlendColor设定的值

GL_SRC_ALPHA_SATURATE :采用srcAlpha和1-dstAlpha中较小的一个

 

默认源为GL_ONE, 目标为 GL_ZERO。混合默认无效，启用需要使用glEnable(GL_BLEND)

常用的透明为：(GL_SRC_ALPHA, GL_ONE_MINUS_SRC_ALPHA)

 

glBlendFunc设置所有drawbuffer,设置单个drawbuffer使用glBlendFunci

 

glBlendFuncSeparate

与glBlendFunc类似，为rgb和alpha设置不同的混合因子

glBlitFramebuffer 3.0

3.0+ 帧缓冲区之间拷贝数据，比如帧缓冲区输出结果拷贝的窗口缓冲区显示

GLint srcX0,

      GLint srcY0,

      GLint srcX1,

      GLint srcY1,

      GLint dstX0,

      GLint dstY0,

      GLint dstX1,

      GLint dstY1,

      GLbitfield mask 颜色、深度、模板标记

GL_COLOR_BUFFER_BIT, GL_DEPTH_BUFFER_BIT GL_STENCIL_BUFFER_BIT

      GLenum filter  过滤方式GL_NEAREST or GL_LINEAR， 深度或模板只能使用GL_NEAREST

将绑定到GL_READ_FRAMEBUFFER的FrameBuffer数据复制到GL_DRAW_FRAMEBUFFER绑定的帧缓冲区。可以为0，即窗口系统缓冲区。

拷贝范围为[srcx0, srcy0]-(srcx1,srcy1)，即左下包含，右上不包含

 

glBlitNamedFramebuffer 4.5+ 根据framebufferID直接复制数据

glBufferData 2.0

初始化Buffer数据

GLenum           target,

      GLsizeiptr                 size,   大小

    const GLvoid * data, 数据地址，可为NULL，后续可通过glBufferSubData, glMapBuffer

glReadPixels等方式生成数据

      GLenum                   usage:    GL_STREAM/STATIC/DYNAMIC_DRAW/READ/COPY

                          STATIC    一次创建，经常使用

                          DYMAMIC 多次创建，多次使用

                          STREAM  一次创建，几次使用

 

                          DRAW 写数据到GPU

                          READ  从GPU中读取数据

                          COPY  GPU读写数据

 

glNamedBufferData 4.5+ 直接初始化buffer数据

GLuint buffer,

      GLsizei size,

      const void *data,

      GLenum usage

 

glBufferStorage 4.4

初始化buffer数据存储，参数与glBufferData仅最后标记不同，相比glBufferData, 标志位多了COHERENT和PERSISTENT以便协调cpu gpu并发

GLenum target,

      GLsizeiptr size,

      const GLvoid * data,

      GLbitfield flags：

                  GL_DYNAMIC_STORAGE_BIT 数据可通过glBufferSubData动态更新，否则cpu在初始化后不能再更改数据。对于gpu, 不论设不设置都可以通过glCopyBufferSubData and glClearBufferSubData修改其数据

                  GL_MAP_READ_BIT cpu可以通过map读取其数据

GL_MAP_WRITE_BIT cpu可以通过map更新数据

GL_MAP_PERSISTENT_BIT map期间gpu可以读写buffer（不需要等待）

GL_MAP_COHERENT_BIT 使用glMapBufferRange期间，保持cpu与gpu数据一致。即cpu写对gpu立即可见。Gpu写在调用glFinish或者glFenceSync(GL_SYNC_GPU_ COMMANDS_COMPLETE,0)后对cpu可见。如果不指定此标记，需要先调用glMemoryBarrier，  数据修改才对gpu可见；对于cpu需要调用glMemoryBarrier之后再调用glFenceSync或者glFinish，gpu对数据的修改才可见

GL_CLIENT_STORAGE_BIT 使用客户端内存存储（具体存储位置依据实现）

 

指定GL_MAP_COHERENT_BIT需要同时指定GL_MAP_PERSISTENT_BIT

 

glNamedBufferStorage 4.5+ 直接设置buffer数据存储

 

 

glBufferSubData

2.0+ 替换部分数据

GLenum target,

      GLintptr offset,

      GLsizeiptr size,

      const GLvoid * data

替换全部数据使用glBufferSubData优于glBufferData，可避免重新分配内存。

可以考虑使用多个buffer，避免在更新时堵塞渲染管线

 

glNamedBufferSubData 4.5+ 直接更新buffer