doc: GL mapping cleanup, separated the table by letters.

doc/opengl-mapping.dox

@@ -38,11 +38,18 @@ Legend:
 
 @section opengl-mapping-functions Functions
 
+@subsection opengl-mapping-functions-a A
+
 OpenGL function                         | Matching API
--------------------------------------- | ------------
+--------------------------------------- | ------------
 @fn_gl{ActiveShaderProgram}             | not needed as @fn_gl{ProgramUniform} calls are used
 @fn_gl{ActiveTexture}                   | @ref AbstractTexture::bind()
 @fn_gl{AttachShader}                    | @ref AbstractShaderProgram::attachShader()
+
+@subsection opengl-mapping-functions-b B
+
+OpenGL function                         | Matching API
+--------------------------------------- | ------------
 @fn_gl{BeginConditionalRender}, `glEndConditionalRender()` | @ref SampleQuery::beginConditionalRender(), \n @ref SampleQuery::endConditionalRender()
 @fn_gl{BeginQuery}, `glEndQuery()`      | @ref PrimitiveQuery::begin(), \n @ref SampleQuery::begin(), \n @ref TimeQuery::begin(), \n @ref AbstractQuery::end()
 @fn_gl{BeginQueryIndexed}, `glEndQueryIndexed()` | |
@@ -68,6 +75,11 @@ OpenGL function                        | Matching API
 @fn_gl{BufferData}, \n `glNamedBufferData()`, \n @fn_gl_extension{NamedBufferData,EXT,direct_state_access} | @ref Buffer::setData()
 @fn_gl{BufferStorage}, \n `glNamedBufferStorage()`, \n @fn_gl_extension{NamedBufferStorage,EXT,direct_state_access} | |
 @fn_gl{BufferSubData}, \n `glNamedBufferSubData()`, \n @fn_gl_extension{NamedBufferSubData,EXT,direct_state_access} | @ref Buffer::setSubData()
+
+@subsection opengl-mapping-functions-c C
+
+OpenGL function                         | Matching API
+--------------------------------------- | ------------
 @fn_gl{CheckFramebufferStatus}, \n `glCheckNamedFramebufferStatus()`, \n @fn_gl_extension{CheckNamedFramebufferStatus,EXT,direct_state_access} | @ref DefaultFramebuffer::checkStatus(), \n @ref Framebuffer::checkStatus()
 @fn_gl{ClampColor}                      | |
 @fn_gl{Clear}                           | @ref AbstractFramebuffer::clear()
@@ -93,6 +105,11 @@ OpenGL function                        | Matching API
 @fn_gl{CreateShader}, @fn_gl{DeleteShader} | @ref Shader constructor and destructor
 @fn_gl{CreateShaderProgram}             | |
 @fn_gl{CullFace}                        | @ref Renderer::setFaceCullingMode()
+
+@subsection opengl-mapping-functions-d D
+
+OpenGL function                         | Matching API
+--------------------------------------- | ------------
 @fn_gl{DebugMessageCallback}            | @ref DebugMessage::setCallback()
 @fn_gl{DebugMessageControl}             | @ref DebugMessage::setEnabled()
 @fn_gl{DebugMessageInsert}, \n @fn_gl_extension2{InsertEventMarker,EXT,debug_marker}, \n @fn_gl_extension{StringMarker,GREMEDY,string_marker} | @ref DebugMessage::insert()
@@ -108,8 +125,18 @@ OpenGL function                        | Matching API
 @fn_gl{DrawArraysIndirect}, \n @fn_gl{DrawElementsIndirect}, \n @fn_gl{MultiDrawArraysIndirect}, \n @fn_gl{MultiDrawElementsIndirect} | |
 @fn_gl{DrawBuffer}, \n `glNamedFramebufferDrawBuffer()`, \n @fn_gl_extension{FramebufferDrawBuffer,EXT,direct_state_access}, \n @fn_gl{DrawBuffers}, \n `glNamedFramebufferDrawBuffers()`, \n @fn_gl_extension{FramebufferDrawBuffers,EXT,direct_state_access} | @ref DefaultFramebuffer::mapForDraw(), \n @ref Framebuffer::mapForDraw()
 @fn_gl{DrawTransformFeedback}, \n @fn_gl{DrawTransformFeedbackInstanced}, \n @fn_gl{DrawTransformFeedbackStream}, \n @fn_gl{DrawTransformFeedbackStreamInstanced} | |
+
+@subsection opengl-mapping-functions-e E
+
+OpenGL function                         | Matching API
+--------------------------------------- | ------------
 @fn_gl{Enable}, `glDisable()`           | @ref Renderer::setFeature()
-@fn_gl{EnableVertexAttribArray}, \n `glEnableVertexArrayAttrib()`, \n @fn_gl_extension{EnableVertexArrayAttrib,EXT,direct_state_access} \n `glDisableVertexAttribArray()`, \n `glDisableVertexArrayAttrib()`, \n `glDisableVertexArrayAttribEXT()` | @ref Mesh::addVertexBuffer()
+@fn_gl{EnableVertexAttribArray}, \n `glEnableVertexArrayAttrib()`, \n @fn_gl_extension{EnableVertexArrayAttrib,EXT,direct_state_access}, \n `glDisableVertexAttribArray()`, \n `glDisableVertexArrayAttrib()`, \n `glDisableVertexArrayAttribEXT()` | @ref Mesh::addVertexBuffer()
+
+@subsection opengl-mapping-functions-f F
+
+OpenGL function                         | Matching API
+--------------------------------------- | ------------
 @fn_gl{FenceSync}, @fn_gl{DeleteSync}   | |
 @fn_gl{Finish}                          | @ref Renderer::finish()
 @fn_gl{Flush}                           | @ref Renderer::flush()
@@ -121,6 +148,11 @@ OpenGL function                        | Matching API
 @fn_gl2{FramebufferTexture3D,FramebufferTexture} | not used, @fn_gl{FramebufferTextureLayer} has more complete features
 @fn_gl{FramebufferTextureLayer}, \n `glNamedFramebufferTextureLayer()`, \n @fn_gl_extension{NamedFramebufferTextureLayer,EXT,direct_state_access} | @ref Framebuffer::attachTextureLayer()
 @fn_gl{FrontFace}                       | @ref Renderer::setFrontFace()
+
+@subsection opengl-mapping-functions-g G
+
+OpenGL function                         | Matching API
+--------------------------------------- | ------------
 @fn_gl{GenBuffers}, \n @fn_gl{CreateBuffers}, \n @fn_gl{DeleteBuffers} | @ref Buffer constructor and destructor
 @fn_gl{GenFramebuffers}, \n @fn_gl{CreateFramebuffers}, \n @fn_gl{DeleteFramebuffers} | @ref Framebuffer constructor and destructor
 @fn_gl{GenProgramPipelines}, \n @fn_gl{CreateProgramPipelines}, \n @fn_gl{DeleteProgramPipelines} | |
@@ -158,7 +190,7 @@ OpenGL function                        | Matching API
 @fn_gl{GetProgramResource}              | |
 @fn_gl{GetProgramResourceIndex}         | |
 @fn_gl{GetProgramResourceLocation}      | |
-@fn_gl{GetProgramResourceLocationIndex}| |
+@fn_gl{GetProgramResourceLocationIndex} | |
 @fn_gl{GetProgramResourceName}          | |
 @fn_gl{GetProgramStage}                 | |
 @fn_gl{GetQueryIndexed}                 | |
@@ -185,6 +217,11 @@ OpenGL function                        | Matching API
 @fn_gl{GetUniformLocation}              | @ref AbstractShaderProgram::uniformLocation()
 @fn_gl{GetUniformSubroutine}            | |
 @fn_gl{GetVertexAttrib}, \n @fn_gl{GetVertexArray}, \n @fn_gl_extension{GetVertexArray,EXT,direct_state_access} | not queryable, @ref Mesh::addVertexBuffer() setter only
+
+@subsection opengl-mapping-functions-i I
+
+OpenGL function                         | Matching API
+--------------------------------------- | ------------
 @fn_gl{InvalidateBufferData}            | @ref Buffer::invalidateData()
 @fn_gl{InvalidateBufferSubData}         | @ref Buffer::invalidateSubData()
 @fn_gl{InvalidateFramebuffer}, \n `glInvalidateNamedFramebufferData()`, \n @fn_gles_extension{DiscardFramebuffer,EXT,discard_framebuffer} | @ref DefaultFramebuffer::invalidate(), \n @ref Framebuffer::invalidate()
@@ -193,15 +230,35 @@ OpenGL function                        | Matching API
 @fn_gl{InvalidateTexSubImage}           | @ref Texture::invalidateSubImage(), \n @ref TextureArray::invalidateSubImage(), \n @ref CubeMapTexture::invalidateSubImage(), \n @ref CubeMapTextureArray::invalidateSubImage(), \n @ref RectangleTexture::invalidateSubImage(), \n @ref MultisampleTexture::invalidateSubImage()
 @fn_gl{IsBuffer}, \n @fn_gl{IsFramebuffer}, \n @fn_gl{IsProgram}, \n @fn_gl{IsProgramPipeline}, \n @fn_gl{IsQuery}, \n @fn_gl{IsRenderbuffer}, \n @fn_gl{IsSampler}, \n @fn_gl{IsShader}, \n @fn_gl{IsSync}, \n @fn_gl{IsTexture}, \n @fn_gl{IsTransformFeedback}, \n @fn_gl{IsVertexArray} | not needed, objects are strongly typed
 @fn_gl{IsEnabled}                       | not queryable, @ref Renderer::setFeature() setter only
+
+@subsection opengl-mapping-functions-l L
+
+OpenGL function                         | Matching API
+--------------------------------------- | ------------
 @fn_gl{LineWidth}                       | @ref Renderer::setLineWidth()
 @fn_gl{LinkProgram}                     | @ref AbstractShaderProgram::link()
 @fn_gl{LogicOp}                         | @ref Renderer::setLogicOperation()
+
+@subsection opengl-mapping-functions-m M
+
+OpenGL function                         | Matching API
+--------------------------------------- | ------------
 @fn_gl{MapBuffer}, \n `glMapNamedBuffer()`, \n @fn_gl_extension{MapNamedBuffer,EXT,direct_state_access}, \n @fn_gl{MapBufferRange}, \n `glMapNamedBufferRange()`, \n @fn_gl_extension{MapNamedBufferRange,EXT,direct_state_access}, \n @fn_gl{UnmapBuffer}, \n `glUnmapNamedBuffer()`, \n @fn_gl_extension{UnmapNamedBuffer,EXT,direct_state_access} | @ref Buffer::map(), @ref Buffer::unmap()
 @fn_gl_extension{MapBufferSubData,CHROMIUM,map_sub}, @fn_gl_extension{UnmapBufferSubData,CHROMIUM,map_sub} | @ref Buffer::mapSub(), @ref Buffer::unmapSub()
 @fn_gl{MemoryBarrier}, \n `glMemoryBarrierByRegion()` | |
 @fn_gl{MinSampleShading}                | |
 @fn_gl{MultiDrawArrays}, \n @fn_gl{MultiDrawElements}, \n @fn_gl{MultiDrawElementsBaseVertex} | @ref MeshView::draw(AbstractShaderProgram&, std::initializer_list<std::reference_wrapper<MeshView>>)
+
+@subsection opengl-mapping-functions-o O
+
+OpenGL function                         | Matching API
+--------------------------------------- | ------------
 @fn_gl{ObjectLabel}, \n @fn_gl{ObjectPtrLabel}, \n @fn_gl_extension2{LabelObject,EXT,debug_label} | @ref AbstractShaderProgram::setLabel(), \n @ref AbstractQuery::setLabel(), \n @ref AbstractTexture::setLabel(), \n @ref Buffer::setLabel(), \n @ref Framebuffer::setLabel(), \n @ref Mesh::setLabel(), \n @ref Renderbuffer::setLabel(), \n @ref Shader::setLabel()
+
+@subsection opengl-mapping-functions-p P
+
+OpenGL function                         | Matching API
+--------------------------------------- | ------------
 @fn_gl{PatchParameter}                  | |
 @fn_gl{PauseTransformFeedback}, @fn_gl{ResumeTransformFeedback} | |
 @fn_gl{PixelStore}                      | |
@@ -214,12 +271,27 @@ OpenGL function                        | Matching API
 @fn_gl{ProgramParameter}                | @ref AbstractShaderProgram::setRetrievableBinary(), \n @ref AbstractShaderProgram::setSeparable()
 @fn_gl{ProvokingVertex}                 | @ref Renderer::setProvokingVertex()
 @fn_gl{PushDebugGroup}, @fn_gl{PopDebugGroup} | |
+
+@subsection opengl-mapping-functions-q Q
+
+OpenGL function                         | Matching API
+--------------------------------------- | ------------
 @fn_gl{QueryCounter}                    | @ref TimeQuery::timestamp()
+
+@subsection opengl-mapping-functions-r R
+
+OpenGL function                         | Matching API
+--------------------------------------- | ------------
 @fn_gl{ReadBuffer}, \n `glNamedFramebufferReadBuffer()`, \n @fn_gl_extension{FramebufferReadBuffer,EXT,direct_state_access} | @ref DefaultFramebuffer::mapForRead(), \n @ref Framebuffer::mapForRead()
 @fn_gl{ReadPixels}, \n `glReadnPixels()`, \n @fn_gl_extension{ReadnPixels,ARB,robustness} | @ref DefaultFramebuffer::read(), \n @ref Framebuffer::read()
 @fn_gl{ReleaseShaderCompiler}           | |
 @fn_gl{RenderbufferStorage}, \n `glNamedRenderbufferStorage()`, \n @fn_gl_extension{NamedRenderbufferStorage,EXT,direct_state_access} | @ref Renderbuffer::setStorage()
 @fn_gl{RenderbufferStorageMultisample}, \n `glNamedRenderbufferStorageMultisample()`, \n @fn_gl_extension{NamedRenderbufferStorageMultisample,EXT,direct_state_access} | @ref Renderbuffer::setStorageMultisample()
+
+@subsection opengl-mapping-functions-s S
+
+OpenGL function                         | Matching API
+--------------------------------------- | ------------
 @fn_gl{SampleCoverage}                  | |
 @fn_gl{SampleMaski}                     | |
 @fn_gl{SamplerParameter}                | |
@@ -232,6 +304,11 @@ OpenGL function                        | Matching API
 @fn_gl{StencilFunc}, \n @fn_gl{StencilFuncSeparate} | @ref Renderer::setStencilFunction()
 @fn_gl{StencilMask}, \n @fn_gl{StencilMaskSeparate} | @ref Renderer::setStencilMask()
 @fn_gl{StencilOp}, \n @fn_gl{StencilOpSeparate} | @ref Renderer::setStencilOperation()
+
+@subsection opengl-mapping-functions-t T
+
+OpenGL function                         | Matching API
+--------------------------------------- | ------------
 @fn_gl{TexBuffer}, \n `glTextureBuffer()`, \n @fn_gl_extension{TextureBuffer,EXT,direct_state_access}, \n @fn_gl{TexBufferRange}, \n `glTextureBufferRange()`, \n @fn_gl_extension{TextureBufferRange,EXT,direct_state_access} | @ref BufferTexture::setBuffer()
 @fn_gl{TexImage1D}, \n @fn_gl_extension{TextureImage1D,EXT,direct_state_access} \n @fn_gl{TexImage2D}, \n @fn_gl_extension{TextureImage2D,EXT,direct_state_access}, \n @fn_gl{TexImage3D}, \n @fn_gl_extension{TextureImage3D,EXT,direct_state_access} | @ref Texture::setImage(), \n @ref TextureArray::setImage(), \n @ref CubeMapTexture::setImage(), \n @ref CubeMapTextureArray::setImage(), \n @ref RectangleTexture::setImage()
 @fn_gl{TexImage2DMultisample}, \n @fn_gl{TexImage3DMultisample} | @ref MultisampleTexture::setStorage()
@@ -243,11 +320,21 @@ OpenGL function                        | Matching API
 @fn_gl{TextureView}                     | |
 @fn_gl{TransformFeedbackBufferBase}, \n @fn_gl{TransformFeedbackBufferRange} | |
 @fn_gl{TransformFeedbackVaryings}       | |
+
+@subsection opengl-mapping-functions-u U
+
+OpenGL function                         | Matching API
+--------------------------------------- | ------------
 @fn_gl{Uniform}, \n @fn_gl{ProgramUniform}, \n @fn_gl_extension{ProgramUniform,EXT,direct_state_access} | @ref AbstractShaderProgram::setUniform()
 @fn_gl{UniformBlockBinding}             | |
 @fn_gl{UniformSubroutines}              | |
 @fn_gl{UseProgram}                      | @ref Mesh::draw(), @ref MeshView::draw()
 @fn_gl{UseProgramStages}                | |
+
+@subsection opengl-mapping-functions-v V
+
+OpenGL function                         | Matching API
+--------------------------------------- | ------------
 @fn_gl{ValidateProgram}                 | @ref AbstractShaderProgram::validate()
 @fn_gl{ValidateProgramPipeline}         | |
 @fn_gl{VertexArrayElementBuffer}        | |
@@ -260,6 +347,11 @@ OpenGL function                        | Matching API
 @fn_gl{Viewport}                        | @ref DefaultFramebuffer::setViewport(), \n @ref Framebuffer::setViewport()
 @fn_gl{ViewportArray}                   | |
 @fn_gl{ViewportIndexed}                 | |
+
+@subsection opengl-mapping-functions-w W
+
+OpenGL function                         | Matching API
+--------------------------------------- | ------------
 @fn_gl{WaitSync}                        | |
 
 @section opengl-mapping-state Limit and state queries
@@ -267,7 +359,7 @@ OpenGL function                        | Matching API
 @todo Things marked only as *not queryable* should have at least setter
 
 @fn_gl{Get} parameter                   | Matching API
--------------------------------------- | ------------
+--------------------------------------- | ------------
 @def_gl{ACTIVE_TEXTURE}, \n @def_gl{TEXTURE_BINDING_1D_ARRAY}, \n @def_gl{TEXTURE_BINDING_1D}, \n @def_gl{TEXTURE_BINDING_2D_ARRAY}, \n @def_gl{TEXTURE_BINDING_2D_MULTISAMPLE_ARRAY}, \n @def_gl{TEXTURE_BINDING_2D_MULTISAMPLE}, \n @def_gl{TEXTURE_BINDING_2D}           , \n @def_gl{TEXTURE_BINDING_3D}, \n @def_gl{TEXTURE_BINDING_BUFFER}, \n @def_gl{TEXTURE_BINDING_BUFFER}, \n @def_gl{TEXTURE_BINDING_CUBE_MAP}, \n @def_gl{TEXTURE_BINDING_RECTANGLE} | not queryable but tracked internally
 @def_gl{ALIASED_LINE_WIDTH_RANGE}       | |
 @def_gl{ARRAY_BUFFER_BINDING}, \n @def_gl{DISPATCH_INDIRECT_BUFFER_BINDING}, \n @def_gl{ELEMENT_ARRAY_BUFFER_BINDING}, \n @def_gl{PIXEL_PACK_BUFFER_BINDING}, \n @def_gl{PIXEL_UNPACK_BUFFER_BINDING} | not queryable but tracked internally