#pixel-art #bevy #camera #2d #pixel #2d-game #pixel-perfect

bevy_tiled_camera

A camera for rendering low resolution pixel art in bevy

16 unstable releases (7 breaking)

0.9.0 Mar 17, 2024
0.8.0 Nov 5, 2023
0.7.0 Jul 12, 2023
0.6.0 Mar 8, 2023
0.2.4 Nov 22, 2021

#652 in Game dev

Download history 18/week @ 2024-03-25 86/week @ 2024-04-01 26/week @ 2024-04-08 24/week @ 2024-04-15 18/week @ 2024-04-22 15/week @ 2024-04-29 14/week @ 2024-05-13 22/week @ 2024-05-20 20/week @ 2024-05-27 28/week @ 2024-06-03 16/week @ 2024-06-10 12/week @ 2024-06-17 19/week @ 2024-06-24 85/week @ 2024-07-01 6/week @ 2024-07-08

125 downloads per month
Used in 2 crates

MIT license

585KB
349 lines

License: MIT Crates.io docs

Bevy Tiled Camera

A camera for properly displaying low resolution pixel perfect 2D games in bevy. It works by adjusting the viewport to match a target resolution, which is defined by a tile count and the number of pixels per tile.

Example

use bevy_tiled_camera::*;
use bevy::prelude::*;

fn setup(mut commands:Commands) {
  // Sets up a camera to display 80 x 35 tiles.
  // Defaults to 8 pixels per tile with WorldSpace::Units.
  let camera_bundle = TiledCameraBundle::unit_cam([80,35]);
  commands.spawn(camera_bundle);
}
fn main() {
    App::new()
    .add_plugins((DefaultPlugins, TiledCameraPlugin))
    .add_systems(Startup, setup)
    .run();
}

World Space

Your world space defines how transforms and scaling is treated in your game. You either position everything in terms of world units, or in terms of pixels. The camera supports either via it's world_space functions.

Versions

bevy bevy_tiled_camera
0.13 0.9.0
0.12 0.8.0
0.11 0.7.0
0.10 0.6.0
0.9 0.5.0
0.8 0.4.0
0.6 0.3.0
0.5 0.2.4
0.5 0.2.3

Blurry sprites

By default bevy will create all new images with linear image sampling. This is good for smaller, high resolution images but causes severe blurriness with low resolution images. To fix it you can manually set the image sampler to nearest when creating your images, or change the default to always spawn new images with nearest sampling:

use bevy::prelude::*;
use bevy_tiled_camera::*;

App::new()
    .add_plugins((DefaultPlugins.set(ImagePlugin::default_nearest()), TiledCameraPlugin))
    .run();

Dependencies

~18–46MB
~730K SLoC