Thread with 8 posts
jump to expanded post
opengl graphics folks… have you ever needed to read the state tables section in the specs, and struggled against the vertical, rotated, heavily abbreviated pdf? perhaps you wished it were machine readable?
well, do i have a gift for you!
i'm enormously grateful to khronos for listening to my request and going to the effort of digging up the latex markup for those sections and releasing them publicly under favourable license terms. there is no way i'd have been able to do this from the pdfs alone. thank you!!!
getting the source was just the first hurdle of course. it took me several days of full-time effort to try to wrangle some semblance of order from that chaos (which, to be clear, is not khronos's fault in any way; markup is always messy, a compromise between computer and machine)
as you may notice from the various stray snippets of unparsed latex and the notes in the readme, there's still a lot of untamed chaos in there. this is a work-in-progress. i'll probably work more on it at a later time, but i didn't want to let perfect be the enemy of the better.
oh also: the untamedness is generally in the free text fields, because my original goal was to make a human readable spec to help me in my api translation efforts
a screen recording comparing looking up an opengl state variable in the pdf spec with looking it up on my site
you can tell it's not rehearsed because it took me 20 seconds to look it up on my site rather than 10
i don't have json output yet but it's something i'll probably do eventually, once i start writing an opengl es 1.1 implementation