Documentation | Blog

gfx-rs

gfx is a high-performance, bindless graphics API for the Rust programming language. It aims to be the default API for Rust graphics: for one-off applications, or higher level libraries or engines.

Motivation

• Graphics APIs are mostly designed with C and C++ in mind, and hence are dangerous and error prone, with little static safety guarantees.
• Providing type safe wrappers around platform-specific APIs is feasible, but only pushes the problem of platform independence to a higher level of abstraction, often to the game or rendering engine.
• Modern graphics APIs, whilst providing a great degree of flexibility and a high level of performance, often have a much higher barrier to entry than traditional fixed-function APIs.
• Graphics APIs like OpenGL still require the developer to 'bind' and 'unbind' objects in order to perform operations on them. This results in a large amount of boiler plate code, and brings with it the usual problems associated with global state.

Getting started

Add the following to your Cargo.toml:

~~~toml [dependencies] gfx = "*" ~~~

See the cube example for a typical context initialization with glfw and the triangle example for initialization with glutin.

links to stuff here!

Who's using it?

People are!

Note

gfx is still in the early stages of development. Help is most appreciated.

If you are interested in helping out, you can contact the developers on Gitter. See contrib.md for contact information and contribution guidelines.