Go to file
2019-10-23 19:31:42 -07:00
examples/invaders Improve syntax slightly when handling RedrawRequested (#23) 2019-10-23 19:31:42 -07:00
img Update README 2019-10-13 18:35:47 -07:00
pixels-mocks Update dependencies (#17) 2019-10-20 17:32:11 -07:00
shaders Replace vk-shader-macros with pre-compiled GLSL. Fixes #9 (#10) 2019-10-13 21:43:30 -07:00
simple-invaders Update public API to provide &mut [u8] instead of accepting &[u8] from the app (#22) 2019-10-21 23:17:58 -07:00
src Update public API to provide &mut [u8] instead of accepting &[u8] from the app (#22) 2019-10-21 23:17:58 -07:00
.gitignore Initial commit. 2019-09-25 23:07:30 -07:00
.travis.yml Fix CI 2019-10-06 02:41:41 -07:00
Cargo.lock Clean up event handling with winit_input_helper (#21) 2019-10-21 22:34:12 -07:00
Cargo.toml Clean up event handling with winit_input_helper (#21) 2019-10-21 22:34:12 -07:00
README.md Update README 2019-10-15 18:43:01 -07:00

Build Status

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.

Features

  • Built on modern graphics APIs powered by wgpu: DirectX 12, Vulkan, Metal, OpenGL.
  • Use your own custom shaders for special effects. (WIP)
  • Hardware accelerated scaling on perfect pixel boundaries.
  • Supports non-square pixel aspect ratios. (WIP)

Examples

To demonstrate pixels, I've written a Space Invaders clone. The game logic can be found in the simple-invaders crate. The included example uses simple-invaders to rasterize the image, and pixels to display it. winit provides the windowing and event handling.

cargo run --release --example invaders

See the example's README for more information.

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.