Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

OpenTK 5.0 TODO list #1207

5 of 11 tasks
varon opened this issue Nov 25, 2020 · 2 comments · Fixed by #1238
5 of 11 tasks

OpenTK 5.0 TODO list #1207

varon opened this issue Nov 25, 2020 · 2 comments · Fixed by #1238


Copy link

varon commented Nov 25, 2020

Tasks list

  • Color overloads [only needs a few manual overloads for GL.ClearColor(ColorX)
  • Add typesafe gl handles.
  • Fix the native method _ postfix (something is not working correctly here right now. Not sure what it is)
  • Move to Opentk.Mathemathics.Half
  • Write apple stuff for GLHandleARB
  • Documentation for all the overloads (This probably requires a tick list by itself as we havent even started on this step yet)
  • Merge master into the otk 5 branch to get all the math fixes pushed to both branches.
  • Fix all warnings and FIXME's in the generator and the generated code.
  • Lots of field testing
  • Fix any spec errors we might find (this is reoccurring and will probably never be completed).

For future updates?

  • New windowing system

Source Location

The source code for the new generator is currently located at:

How to contribute to the OpenTK 5.0 Bindings Generator

To help with XML issues

There are mismatches between the XML version of the spec and the official documentation.
These cause the bindings generator to generate incorrect values or less convenient types than we expect.
These issues mostly are missing metadata about how parameters and information relate to one another.

To improve this, we need to fix the upstream XML version of the spec.

Fixing XML Guide:

Using the example function: glNamedFramebufferDrawBuffers

1) Look up the OpenGL function signature in the reference documentation.

The parameters section contains the information we're concerned with.
For example, see:

Pay attention to the parameter listing:

    Specifies the name of the framebuffer object for glNamedFramebufferDrawBuffers.
    Specifies the number of buffers in bufs.
    Points to an array of symbolic constants specifying the buffers into which fragment colors or data values will be written.

2) Look up the OpenGL Function signature in the Khronos XML specification:

This is available here:
It's a huge file, so download it into a text editor and use Ctrl+F (Search) to navigate to the function you want.

We're concerned mostly with the <command> section.

at the time of writing, this looks something like this:

    <proto>void <name>glNamedFramebufferDrawBuffers</name></proto>
    <param class="framebuffer"><ptype>GLuint</ptype> <name>framebuffer</name></param>
    <param><ptype>GLsizei</ptype> <name>n</name></param>
    <param group="ColorBuffer">const <ptype>GLenum</ptype> *<name>bufs</name></param>

This is ALMOST correct, but there is no information to indicate that n corresponds to the length of the bufs array.

3) Add missing metadata:

To fix this, we need to add a len property to the bufs parameter. This tells us that the n property corresponds
to the length of the buffer pass in. This change is on the last <param> line.

    <proto>void <name>glNamedFramebufferDrawBuffers</name></proto>
    <param class="framebuffer"><ptype>GLuint</ptype> <name>framebuffer</name></param>
    <param><ptype>GLsizei</ptype> <name>n</name></param>
    <param len="n" group="ColorBuffer">const <ptype>GLenum</ptype> *<name>bufs</name></param>

4) Now, make a PR to the Khronos Repo with your changes.

This repo is available here:

To help with code issues:



Is there any documentation on the XML tags?

Yes there is. A full PDF is available here listing all of the properties and what they mean:

Copy link

To see the current status of development see this PR #1238

@frederikja163 frederikja163 changed the title OpenTK 5.0 Bindings Generator OpenTK 5.0 TODO list May 29, 2021
Copy link

This issue is severely out of date, to find out the current state of OpenTK 5 have a look at the project board here:

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
None yet

Successfully merging a pull request may close this issue.

2 participants