#bevy #pixel-art #pixel #2d #graphics

bevy_modern_pixel_camera

A simple pixel-perfect camera plugin for Bevy, suitable for pixel-art

2 unstable releases

0.2.0-rc2 Oct 28, 2024
0.1.0 Oct 26, 2024

#358 in Game dev

Download history 162/week @ 2024-10-22 76/week @ 2024-10-29 22/week @ 2024-11-05

260 downloads per month

MIT/Apache

34KB
173 lines

bevy_modern_pixel_camera

Based of: https://github.com/drakmaniso/bevy_pixel_camera

A simple camera plugin for the Bevy game engine, to help with the use of pixel-art sprites.

This crates provides a plugin to automatically configure Bevy's Camera2dBundle. It works by setting the camera to an integer scaling factor (using Bevy's ScalingMode::WindowSize), and automatically updating the zoom level so that the specified target resolution fills as much of the sceen as possible.

The plugin can also automatically set and resize the viewport of the camera to match the target resolution.

How to use

Note that Bevy uses linear sampling by default for textures, which is not what you want for pixel art. The easiest way to change this is to configure Bevy's default plugins with ImagePlugin::default_nearest().

Note that Bevy uses MSAA by default for textures, which is not what you want for pixel art The easiest way to change this is to configure Bevy's by overriding the Msaa resource with .insert_resource(Msaa::Off).

Also note that if either the width or the height of your sprite is not divisible by 2, you may need to change the anchor of the sprite (which is at the center by default), otherwise it won't be aligned with virtual pixels.

use bevy::prelude::*;
use bevy::sprite::Anchor;
use bevy_pixel_camera::{
    PixelCameraPlugin, PixelZoom, PixelViewport
};

fn main() {
    App::new()
        .add_plugins(DefaultPlugins.set(ImagePlugin::default_nearest()))
        .add_plugins(PixelCameraPlugin)
        .insert_resource(Msaa::Off)
        .add_systems(Startup, setup)
        .run();
}

fn setup(
    mut commands: Commands,
    asset_server: Res<AssetServer>,
) {
    commands.spawn((
        Camera2dBundle::default(),
        PixelZoom::FitSize {
            width: 320,
            height: 180,
        },
        PixelViewport,
    ));

    commands.spawn(SpriteBundle {
        texture: asset_server.load("my-pixel-art-sprite.png"),
        sprite: Sprite {
            anchor: Anchor::BottomLeft,
            ..Default::default()
        },
        ..Default::default()
    });
}

A small example is included in the crate. Run it with:

cargo run --example flappin

Bevy versions supported

bevy bevy_modern_pixel_camera
0.14 0.1

License

Licensed under either of

at your option.

License: MIT OR Apache-2.0

Dependencies

~41–73MB
~1.5M SLoC