2009-09-06 09:38:04 +00:00
[Introduction]
This is a simple tool to convert C headers to XML files. It works using simple pattern matching - it does not actually parse the header files. For this reason, it will work with only a few, specific header files: ES and CL at this point.
2013-11-07 16:18:12 +00:00
[Examples]
2013-10-22 09:40:41 +00:00
2013-11-07 16:18:12 +00:00
To download and convert the new XML API registry from Khronos:
Convert.exe -p:gl -v:4.4 -t:xml -o:../../../Source/Bind/Specifications/GL2/signatures.xml https://cvs.khronos.org/svn/repos/ogl/trunk/doc/registry/public/api/gl.xml
To download and convert the old .spec files from Khronos:
2013-10-22 09:40:41 +00:00
Convert.exe -p:gl -v:4.3 -t:spec -o:../../../Source/Bind/Specifications/GL2/signatures.xml https://cvs.khronos.org/svn/repos/ogl/trunk/doc/registry/public/oldspecs/gl.spec https://cvs.khronos.org/svn/repos/ogl/trunk/doc/registry/public/oldspecs/enum.spec https://cvs.khronos.org/svn/repos/ogl/trunk/doc/registry/public/oldspecs/enumext.spec
The line above will download the latest .spec files from the public Khronos repository and update signatures.xml for the binding generator.
2009-09-06 09:38:04 +00:00
[Usage]
2011-07-26 11:54:09 +00:00
Convert.exe -p:{PREFIX} -v:{VERSION} -t:{TYPE} -o:{OUT} {INPUT1} ... {INPUTn}
2009-09-06 09:38:04 +00:00
{PREFIX} is a simple string that defines the a common prefix for functions and constants in this header. This prefix will be removed from the generated XML file.
{VERSION} is a string that defines that version that will be used for functions in the generated XML file. Specific input files may override this setting.
2011-07-26 11:54:09 +00:00
{TYPE} can be either 'spec' or 'header' to indicate whether the input files are OpenGL .spec files or C headers.
{OUT} is the output filename (optional). If no output file is specified, output will be directed to the console.
{INPUT1..n} is a space-separated list of input files (headers).
2009-09-06 09:38:04 +00:00
Despite what the help says, all three parameters are necessary at the moment.
[Known issues]
OpenGL|ES 2.0: gl*Fence[s|iv]?NV fail to define parameters names. These have been added by hand (take care when updating the header file).
[Support]
If you encounter a bug, please file an issue report at http://www.opentk.com/issues
2009-07-31 15:37:27 +00:00
We will only accept bug reports for supported header files. This is not a generic tool and will fail to parse unsupported files.
