https://github.com/bbredesen/vk-gen
Code generation to create a Go binding for the Vulkan graphics API.
https://github.com/bbredesen/vk-gen
binding binding-generator code-gen go golang vulkan
Last synced: 5 months ago
JSON representation
Code generation to create a Go binding for the Vulkan graphics API.
- Host: GitHub
- URL: https://github.com/bbredesen/vk-gen
- Owner: bbredesen
- License: mit
- Created: 2021-04-29T19:29:02.000Z (over 4 years ago)
- Default Branch: main
- Last Pushed: 2023-11-22T18:11:15.000Z (about 2 years ago)
- Last Synced: 2025-07-09T07:12:21.265Z (6 months ago)
- Topics: binding, binding-generator, code-gen, go, golang, vulkan
- Language: Go
- Homepage:
- Size: 3.53 MB
- Stars: 11
- Watchers: 1
- Forks: 4
- Open Issues: 7
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# vk-gen
vk-gen is a tool used to create Go bindings for the Vulkan graphics API. It uses the Vulkan XML specification to
generate all type definitions and native function calls for the API. It generates the code for
[go-vk](https://github.com/bbredesen/go-vk), but it can just as well be used to create a modified binding set in your
own projects (for example, excluding certain vendor extensions, including beta extensions, or to generate code from a
specific version of the Vulkan headers).
## Basic Usage
**You do not need to install this tool to use go-vk in a project.** Install if you need to generate for a specific
version of the API or want to produce a binding using only a subset of Vulkan.
Install: `go install github.com/bbredesen/vk-gen@latest`
Download the latest registry file: `curl https://raw.githubusercontent.com/KhronosGroup/Vulkan-Headers/main/registry/vk.xml > vk.xml`
(Or, replace "main" in the URL above with the tagged version you want to generate against: e.g.,
`https://raw.githubusercontent.com/KhronosGroup/Vulkan-Headers/v1.2.203/registry/vk.xml` for the last version 1.2 specification.)
Run the tool: `vk-gen`
Use `-inFile` to specify a registry filename or path (defaults to `./vk.xml`)
Use `-outDir` to specify the destination folder for writing go-vk files (defaults to `./vk/`)
The `static_include` folder in this repository contains static template files that are copied directly into the output
folder. These files are directly copied to the output, but are not evaluated or compiled into this tool. If using the Go
language server, you can set `-static_include` in your `directoryFilters` setting. See
(https://github.com/golang/tools/blob/master/gopls/doc/settings.md) for details.
## exceptions.json
There are a number of datatypes and values in vk.xml which need special handling, frequently because the spec uses
C data type formats or types that don't translate 1-to-1 to Go's type system. While we could probably work
around many of them by parsing the C code in the XML file, it is much simpler to set these exceptions in a separate file
with a standard format.
NOTE: There are a number of "legacy" entries in this file left over from development, but which are now unused. A future
issue/PR will clean this up, but they don't hurt anything at the moment.
### union
* `go:internalSize` - Go has no notion of union types. This field allows you to specify a size for the public
to internal translation result. By default, vk-gen will use the size of the first member in the union, but that is
not necessarily the largest member. This value must be a string and is copied to an array declaration. It can be
anything that resolves to a constant in Go, though most typically it will be an integer value (represented as a
string). The value should be the aligned (?) data size in bytes of the largest member of the union.