bevy_smooth_pixel_camera

A bevy plugin that adds a simple smooth pixel camera.

It works by rendering the main camera to a small viewport which is then rendered by a second camera spawned by the plugin. This allows for hybrid rendering of both a pixelated world and high resolution assets on top.

This plugin has a smoothing feature, which makes the camera's movement appear smooth while keeping the world itself locked to a pixel grid. It works by moving the canvas in the opposite direction of the world camera's subpixel position. See the how_smoothing_works example for a demonstration of how it works behind the scenes.

Smoothing OFF	Smoothing ON

Usage

1. Add the bevy_smooth_pixel_camera crate to your project.

   cargo add bevy_smooth_pixel_camera
   

2. Add the PixelCameraPlugin and set 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 PixelCamera to your world.

   use bevy::prelude::*;
   use bevy_smooth_pixel_camera::prelude::*;
   
   fn setup(mut commands: Commands) {
       commands.spawn(PixelCamera::from_size(ViewportScalingMode::PixelSize(4.0)));
   }
   

4. That's it!

Features

picking (default) - Enables picking through the viewport.

Bevy Compatibility