Crate pixels[−][src]
A tiny library providing a GPU-powered pixel buffer.
Pixels
represents a 2D pixel buffer with an explicit image resolution, making it ideal for
prototyping simple pixel-based games, animations, and emulators. The pixel buffer is rendered
entirely on the GPU, allowing developers to easily incorporate special effects with shaders and
a customizable pipeline.
The GPU interface is offered by wgpu
, and is re-exported for
your convenience. Use a windowing framework or context manager of your choice;
winit
is a good place to start. Any windowing framework that
uses raw-window-handle
will work.
Environment variables
PIXELS_HIGH_PERF
: Switch the default adapter to high performance.PIXELS_LOW_POWER
: Switch the default adapter to low power.
These variables change the default adapter to request either high performance or low power. (I.e. discrete or integrated GPUs.) The value is not checked, only the existence of the variable is relevant.
The order of precedence for choosing a power preference is:
- Application’s specific adapter request through
PixelsBuilder::request_adapter_options
PIXELS_HIGH_PERF
PIXELS_LOW_POWER
wgpu
default power preference (usually low power)
Re-exports
pub use raw_window_handle; | |
pub use wgpu; |
Structs
Pixels | Represents a 2D pixel buffer with an explicit image resolution. |
PixelsBuilder | A builder to help create customized pixel buffers. |
PixelsContext | Provides the internal state for custom shaders. |
ScalingRenderer | The default renderer that scales your frame to the screen size. |
SurfaceSize | A logical texture size for a window surface. |
SurfaceTexture | A logical texture for a window surface. |
Enums
Error | All the ways in which creating a pixel buffer can fail. |