Bevy Toon Shader

A toon shader for the Bevy game engine.

Features - "Sun" color & direction - Specular highlight - Light banding - Shadow casting - Albedo map (base color texture)

Not supported (yet) - Dynamic color banding amount - Shadow receiving - Rim lighting

Installation

sh cargo add bevy_toon_shader

```rust use bevy::prelude::*; use bevytoonshader::{ToonShaderMainCamera, ToonShaderMaterial, ToonShaderPlugin, ToonShaderSun};

fn main() { App::new() .addplugins(DefaultPlugins) .addplugin(ToonShaderPlugin) .addstartupsystem(setup) .run(); }

fn setup( mut commands: Commands, mut meshes: ResMut>, mut toon_materials: ResMut>, ) { // Camera commands.spawn(( Camera3dBundle { /* ... */ }, ToonShaderMainCamera, ));

// Sun
commands.spawn((
    DirectionalLightBundle { /* ... */ },
    ToonShaderSun,
));

// Ambient light
commands.insert_resource(AmbientLight {
    color: Color::GRAY * 0.2,
    ..default()
});

let material = toon_materials.add(ToonShaderMaterial {
    base_color_texture: None,
    color: Color::WHITE,
    sun_dir: Vec3::ZERO,
    sun_color: Color::WHITE,
    camera_pos: Vec3::new(0.0, 6., 12.0),
    ambient_color: Color::WHITE,
});

// 3D object
commands.spawn(MaterialMeshBundle {
    mesh: meshes.add(Mesh::try_from(shape::Torus::default()).unwrap()),
    transform: Transform::from_xyz(0., 2., 0.),
    material: toon_material,
    ..default()
});

} ```

Running the example

sh git clone https://github.com/tbillington/bevy_toon_shader.git cd bevy_toon_shader cargo run --example scene

Bevy Support Table

| bevy | bevytoonshader | | -- | -- | | 0.10 | 0.1 |

Credit

Code initially adapted from this excellent Unity tutorial by Roystan.

License

Except where noted, all code in this repository is dual-licensed under either:

• MIT License (LICENSE-MIT or http://opensource.org/licenses/MIT)
• Apache License, Version 2.0 (LICENSE-APACHE or http://www.apache.org/licenses/LICENSE-2.0)

at your option. This means you can select the license you prefer! This dual-licensing approach is the de-facto standard in the Rust ecosystem and there are very good reasons to include both.

Your contributions

Unless you explicitly state otherwise, any contribution intentionally submitted for inclusion in the work by you, as defined in the Apache-2.0 license, shall be dual licensed as above, without any additional terms or conditions.