Apply a pixelation effect to any Bevy mesh or scene without post-processing.

Last update: Mar 25, 2023

Overview

Pixelate Mesh

Apply a pixelation effect to any Bevy mesh or scene without post-processing.

Usage

Add the PixelateMeshPlugin, where you specify a component that tracks the main camera.
Add this tracking component to your camera.
Add the Pixelate component to any entity that you want to pixelate.

The tracking component is needed because the plugin draws the textures on 2D canvases that need to rotate to always face the main camera.

Compatibility

bevy	pixelate_mesh
0.10	0.1

Examples

The following is an annotated minimal example. More can be found in the examples folder.

use bevy::prelude::*;
use pixelate_mesh::prelude::*;

fn main() {
    App::new()
        .add_plugins(DefaultPlugins)
        // Add the plugin
        .add_plugin(PixelateMeshPlugin::<MainCamera>::default())
        .add_startup_system(setup)
        .run();
}

// Create a component for the main camera
#[derive(Component)]
struct MainCamera;

fn setup(
    mut commands: Commands,
    mut meshes: ResMut<Assets<Mesh>>,
    mut materials: ResMut<Assets<StandardMaterial>>,
) {
    commands.spawn((
        // This cube will render at 64x64 pixels
        Pixelate::splat(64),
        PbrBundle {
            mesh: meshes.add(Mesh::from(shape::Cube { size: 1.0 })),
            material: materials.add(Color::WHITE.into()),
            ..default()
        },
    ));

    commands.spawn((
        // Add the tracking component to the camera
        MainCamera,
        Camera3dBundle {
            transform: Transform::from_xyz(-2.0, 2.5, 5.0).looking_at(Vec3::ZERO, Vec3::Y),
            ..default()
        },
    ));
}

Inspiration

The plugin tries to emulate the effect as seen in Prodeus:

Prodeus.-.Models.vs.Sprites.mp4

Source

Shortcomings

The current setup does not work with multiple main cameras. Feel free to comment on the issue if you have an idea for how to fix this!
The plugin deactivates MSAA globally.

You might also like...

NeosPeeps is tool that allows for listing your NeosVR friends quickly, without having to actually open the whole game

Neos Peeps NeosPeeps is tool that allows for listing your NeosVR friends quickly, without having to actually open the whole game. It also has a bunch

6 Sep 12, 2022

Terminal-based Snake game written in Rust without dependencies (for educational purposes).

RustSnake This is a simple terminal-based Snake game implemented in Rust without dependencies. To start the game type cargo run. Control the snake usi

88 Jan 6, 2023

A Bevy plugin for loading the LDtk 2D tile map format.

bevy_ldtk ( Tileset from "Cavernas" by Adam Saltsman ) A Bevy plugin for loading LDtk tile maps. Usage use bevy::prelude::*; use bevy_ldtk::*; fn mai

23 Jul 4, 2022

Basic first-person fly camera for the Bevy game engine

bevy_flycam A basic first-person fly camera for Bevy 0.4 Controls WASD to move horizontally SPACE to ascend LSHIFT to descend ESC to grab/release curs

85 Dec 23, 2022

An ergonomic physics API for bevy games.

Heron An ergonomic physics API for 2d and 3d bevy games. (powered by rapier) How it looks like fn main() { App::build() .add_plugins(DefaultPlug

313 Dec 16, 2022

Inspector plugin for the bevy game engine

bevy-inspector-egui This crate provides the ability to annotate structs with a #[derive(Inspectable)], which opens a debug interface using egui where

517 Dec 31, 2022

A plugin for Egui integration into Bevy

bevy_egui This crate provides a Egui integration for the Bevy game engine. Features: Desktop and web (bevy_webgl2) platforms support Clipboard (web su

453 Jan 3, 2023

Crossterm plugin for the bevy game engine

What is bevy_crossterm? bevy_crossterm is a Bevy plugin that uses crossterm as a renderer. It provides custom components and events which allow users

79 Nov 2, 2022

A 4X style camera for bevy.

A 4X style camera for bevy. Demo Default Key Bindings: W / A / S / D / Arrow Keys / Mouse Left - Move along the horizontal plane Q / E / Mouse Right -

30 Jan 4, 2023

Comments

WIP: Add support for removing pixelation effect

I've fixed some bugs in the code where the cameras and canvas entity was compared with the pixelated entity instead of the target of Canvas and Camera.

I haven't really figured out what is left do do. Maybe We need to store the Original Handle<Mesh> And reinsert it in despawn_dependent_types.

I could use some help on this one @janhohenheim

opened by naasblod 3
Support Orthographic Projection

I was looking at this as a way to generate what looks like a 2D sprite based game easily by using 3D meshes and this plugin to simulate sprites but with dynamic lighting.

Much like the transform is being copied from the main camera, I think it would be possible to also copy the projection from the main camera onto the pixelation camera.
enhancement

opened by orclev 3