#pixel-perfect #pixel #bevy #graphics #game

bevy_smooth_pixel_camera

Smooth pixel-perfect camera for Bevy

6 releases

0.3.0 Feb 17, 2024
0.2.2 Jan 31, 2024
0.1.1 Nov 10, 2023

#391 in Game dev

47 downloads per month

MIT/Apache

36KB
492 lines

bevy_smooth_pixel_camera

crates.io docs.rs

A bevy plugin that adds a simple smooth pixel camera.

The smoothing is based on this video from aarthificial which explains how it works pretty nicely: https://youtu.be/jguyR4yJb1M

This method allows for smooth camera movement while retaining the pixel perfection of low resolution rendering.

Usage

  1. Add the bevy_smooth_pixel_camera crate to your project.

    cargo add bevy_smooth_pixel_camera
    
  2. Add the PixelCameraPlugin and set the ImagePlugin to default_nearest.

    use bevy::prelude::*;
    use bevy_smooth_pixel_camera::prelude::*;
    
    App::new().add_plugins((
        DefaultPlugins.set(ImagePlugin::default_nearest()),
        PixelCameraPlugin
    )).run();
    
  3. Add a pixel pefect camera to your scene.

    use bevy::prelude::*;
    use bevy_smooth_pixel_camera::prelude::*;
    
    fn setup(mut commands: Commands) {
        commands.spawn((
            Camera2dBundle::default(),
            PixelCamera::from_size(ViewportSize::PixelFixed(4))
        ));
    }
    
  4. That should be it! Make sure you move your camera via the PixelCamera.subpixel_pos property instead of the Transform component.

Bevy Compatibility

bevy bevy_smooth_pixel_camera
main main
0.13.* / latest 0.3.0 / latest
0.12.* 0.1.0 - 0.2.1

Dependencies

~41–80MB
~1.5M SLoC