[][src]Crate swsurface

This crate provides a software-rendered surface for winit.

The goal of this crate is to provide a minimal drawing functionality for every platform supported by winit even if the drawing APIs that we usually assume are available, such as OpenGL¹, aren't available in the target environment. This crate is also useful as a fallback when they are available, but failed due to an unrecoverable error.

¹ “Servo on Windows in VirtualBox gets 'NoAvailablePixelFormat'” servo/servo #9468

To this end, this crate is designed to panic only when preconditions are not met or under very pathologic circumstances that would cause winit to panic.

Unimplemented features

  • Partial update - The application can redraw a portion, but swsurface always sends entire the windowfor now
  • Support for platforms other than: macOS, Windows, X11, Wayland
  • X11: Support for color depths other than 24
  • X11: Transparency
  • Multi-threaded rendering (Send-able Surface)
  • Color management - we'll try to stick to sRGB for now

Structs

Config

Configuration for a Surface.

Context

The global data for Surface, constructed using ContextBuilder.

ContextBuilder
ImageInfo

Describes the format of a swapchain image.

Surface

A software-rendered surface that is implicitly associated with the underlying window (like glutin::RawContext).

SwWindow

A software-rendered window.

Enums

Format

Specifies a pixel format.