Crate gfx_backend_gl

OpenGL backend internals.

The main target is OpenGL ES3 on Linux and Android.

Binding model

Binding model is the biggest and most painful difference with gfx-hal API.

First, the bindings get linearized into the pipeline layout (see PipelineLayoutSet). Then a pipeline gets created, and we track all the texture-sampler associations. We only support at most one sampler used with each texture so far. The linear index of this sampler is stored per texture slot in SamplerBindMap array.

The texture-sampler pairs get potentially invalidated in 2 places:

• when a new pipeline is bound, we update the linear indices of associated samplers
• when a new descriptor set is bound, we update both the textures and the samplers

We expect that the changes to sampler states between any 2 pipelines of the same layout will be minimal, if any.

Structs

Device

GL device.

GlContext

Info

OpenGL implementation information

Instance

PhysicalDevice

PlatformName

A unique platform identifier that does not change between releases

QueueFamily

Starc

Single-threaded Arc. Wrapper for Arc that allows you to Send it even if T: !Sync. Yet internal data cannot be accessed outside of the thread where it was created.

Surface

Swapchain

Version

A version number for a specific component of an OpenGL implementation

Wstarc

Single-threaded Weak. Wrapper for Weak that allows you to Send it even if T: !Sync. Yet internal data cannot be accessed outside of the thread where it was created.

Enums

Backend

Error