Go to file
Jay Oster 9f0a659853
Enable all wgpu backends (#356)
- This will allow `pixels` to run on platforms that have OpenGL without any extra configuration.
- It is better to allow wgpu to fallback to OpenGL than to select a Vulkan software rasterizer. This is the case on WSL2, where the only hardware-based adapter is available with the GLES backend.
- Fixes #354
2023-04-14 13:31:01 -07:00
.cargo Replace just with cargo-run-wasm (#310) 2022-10-02 21:13:48 -07:00
.github CI: Add cargo-install action to cache cargo-machete (#355) 2023-04-13 20:51:48 -07:00
examples Added R key to reset game (#350) 2023-03-26 23:59:20 -07:00
img Update README (#324) 2022-12-17 18:28:15 -08:00
internals/pixels-mocks Bump wgpu from 0.13 to 0.14 (#320) 2022-12-17 13:50:11 -08:00
run-wasm Update cargo-run-wasm (#329) 2023-01-07 15:18:09 -08:00
shaders Update wgpu to 0.13 (#300) 2022-08-17 17:30:04 -07:00
src Enable all wgpu backends (#356) 2023-04-14 13:31:01 -07:00
.gitignore Update GitHub Actions (#322) 2022-12-17 16:52:45 -08:00
Cargo.lock CI: Add cargo-install action to cache cargo-machete (#355) 2023-04-13 20:51:48 -07:00
Cargo.toml Prepare 0.12.0 (#349) 2023-03-22 00:15:38 -07:00
LICENSE Add license 2019-10-30 23:30:09 -07:00
MSRV.md Prepare 0.12.0 (#349) 2023-03-22 00:15:38 -07:00
README.md Update README (#324) 2022-12-17 18:28:15 -08:00

Crates.io Documentation GitHub actions GitHub activity GitHub Sponsors

Pixels Logo

A tiny hardware-accelerated pixel frame buffer. 🦀

But why?

Rapidly prototype a simple 2D game, pixel-based animations, software renderers, or an emulator for your favorite platform. Then add shaders to simulate a CRT or just to spice it up with some nice VFX.

pixels is more than just a library to push pixels to a screen, but less than a full framework. You're in charge of managing a window environment, event loop, and input handling.

MSRV Policy

The Minimum Supported Rust Version for pixels will always be made available in the MSRV.md file on GitHub.

Features

  • Built on modern graphics APIs powered by wgpu: Vulkan, Metal, DirectX 12, OpenGL ES3.
    • DirectX 11, WebGL2, and WebGPU support are a work in progress.
  • Use your own custom shaders for special effects.
  • Hardware accelerated scaling on perfect pixel boundaries.
  • Supports non-square pixel aspect ratios. (WIP)

Examples

Games 🎮

Demos 🧪

Troubleshooting

Driver issues

The most common issue is having an outdated graphics driver installed on the host machine. pixels requests a low power (aka integrated) GPU by default. If the examples are not working for any reason, you may try setting the WGPU_POWER_PREF=high environment variable to see if that addresses the issue on your host machine.

You should also try to keep your graphics drivers up-to-date, especially if you have an old Intel integrated GPU. Keep in mind that some drivers and GPUs are EOL and will not be supported.

Logging

You may want to use the RUST_LOG environment variable (see env_logger for full documentation) to gain additional insight while troubleshooting the examples. RUST_LOG=trace will spew all logs to stderr on debug builds:

$ RUST_LOG=trace cargo run --package minimal-winit

And also on release builds when default features are disabled:

$ RUST_LOG=trace cargo run --package minimal-winit --release --no-default-features

Comparison with minifb

The minifb crate shares some similarities with pixels; it also allows rapid prototyping of 2D games and emulators. But it requires the use of its own window/GUI management, event loop, and input handling. One of the disadvantages with the minifb approach is the lack of hardware acceleration (except on macOS, which uses Metal but is not configurable). An advantage is that it relies on fewer dependencies.

Comparison with softbuffer

There is a more recent project called softbuffer. It provides similar capabilities to what pixels offers, but is intentionally limited to software-only (not hardware-accelerated) rasterization.