Crate surfman 

Cross-platform GPU device and surface management.

You can use this crate to multithread a graphics application so that rendering happens on multiple threads, sharing textures among them in the most efficient manner. It may also be useful as a lightweight framework for just initializing rendering in native applications. This is in contrast to crates like SDL, GLFW, winit, and Glutin, all of which have a broader focus in that they manage windowing and the event loop as well.

Re-exports

pub use unix as default;

pub use crate::error::Error;

pub use crate::error::WindowingApiError;

pub use default::connection::Connection;

pub use default::connection::NativeConnection;

pub use default::context::Context;

pub use default::context::ContextDescriptor;

pub use default::context::NativeContext;

pub use default::device::Adapter;

pub use default::device::Device;

pub use default::device::NativeDevice;

pub use default::surface::NativeWidget;

pub use default::surface::Surface;

pub use default::surface::SurfaceTexture;

Modules

base 🔒

Shared support code that can be used by multiple Surfman backends.

chains

An implementation of thread-safe swap chains for the surfman surface manager.

connection

The abstract interface that all connections conform to.

context 🔒

Declarations common to all platform contexts.

device

The abstract interface that all devices conform to.

egl 🔒

error

Various errors that methods can produce.

gl_utils 🔒

Various OpenGL utilities used by the different backends.

info 🔒

OpenGL information.

macros

A macro for use in the top-level crate.

mesa_surfaceless

The Mesa “surfaceless” backend, which only supports off-screen surfaces and cannot directly display surfaces on a screen.

multi

An abstraction that allows the choice of backends dynamically.

renderbuffers 🔒

A utility module for backends that wrap surfaces in OpenGL FBOs.

surface 🔒

Information related to hardware surfaces.

unix

The default backend for Unix, which dynamically switches between Wayland, X11 and surfaceless.

wayland

Bindings to Wayland via the Linux GBM interface.

x11

Bindings to EGL via Xlib.

Macros

declare_surfman

When using surfman, you should place this macro at the top of your crate, like so:

Structs

ContextAttributeFlags

Various flags that control attributes of the context and/or surfaces created from that context.

ContextAttributes

Attributes that control aspects of a context and/or surfaces created from that context.

ContextID

A unique ID among all currently-allocated contexts.

GLVersion

Describes the OpenGL version that is requested when a context is created.

SurfaceID

A unique ID per allocated surface.

SurfaceInfo

Various data about the surface.

SystemSurfaceInfo

Various data about the surface.

Enums

GLApi

The API (OpenGL or OpenGL ES).

SurfaceAccess

Specifies how and if the CPU has direct access to the surface data.

SurfaceType

Information specific to the type of surface: generic or widget.