KhronosGroup / KhronosGroup/OpenGL-Refpages

Inconsistencies related to buffer texture pnames

Open
#102 1 comment 0 reactions 0 assignees View on GitHub
Dominant language
HTML
Stars
492
Forks
146
PR merge metrics
No merged PRs in 30d

Description

In the latest refpages on the `glGet` page, `GL_TEXTURE_BINDING_BUFFER` has two incompatible definitions :
```
GL_TEXTURE_BINDING_BUFFER

data returns a single value, the name of the texture currently bound to the target GL_TEXTURE_BUFFER. The initial value is 0. See glBindTexture.
```
```
GL_TEXTURE_BINDING_BUFFER

data returns a single value, the name of the buffer object currently bound to the GL_TEXTURE_BUFFER buffer binding point. The initial value is 0. See glBindBuffer.
```
Moreover, `glGetTexLevelParameter` does not list `GL_TEXTURE_BUFFER_DATA_STORE_BINDING` as an accepted pname, in contrast with eg the OpenGL ES 3 refpages that do list it. Besides, the OpenGL 4.6 core spec makes no mention of this pname.

Worthy of note is also that the refpage for `glBindBuffer` does not mention a pname for getting the buffer bound to `GL_TEXTURE_BUFFER`.

Contributor guide

No contributing guide indexed for this repository

Research direction

Start with the glGet, glGetTexLevelParameter, and glBindBuffer reference pages mentioned in the issue, then compare their pname descriptions with the OpenGL 4.6 core specification and OpenGL ES 3 reference pages. Done means the buffer-texture binding and data-store pnames are consistently documented wherever applicable, with no conflicting definitions.

Written by the indexing model from the issue text.

Assessment

Tech stack
html
Domain
documentation
Issue type
Documentation
Difficulty
4/5
Estimated time
3-5 days
Activity status
Stale
Clarity
Mostly clear
Newbie friendliness
35/100

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.