bevy 2d line

Bevy port of https://github.com/mattdesl/three-line-2d

Polylines in a vertex shader; plays nice with projection scale, z-index; supports vertex colors. Does not support picking!

Moving thousands of line endpoints every frame will be slow, because the mesh needs rebuilt when the lines are moved.

Lazily maintained at best!

Compatibility

Installation

Add the following to your Cargo.toml:

[dependencies]
bevy_2d_line = "0.1.3"

Usage

1. Add the LineRenderingPlugin to your Bevy app:

use bevy::prelude::*;
use bevy_2d_line::LineRenderingPlugin;

fn main() {
    App::new()
        .add_plugins(DefaultPlugins)

        // Must be added after the `DefaultPlugins`
        .add_plugins(LineRenderingPlugin)
        .add_systems(Startup, setup)
        .run();
}

[!IMPORTANT] The LineRenderingPlugin must be added after the DefaultPlugins

2. Create and spawn a Line component:

use bevy_2d_line::Line;
use bevy::{color::palettes::css::{BLUE, GREEN, RED}, prelude::*};

fn setup(mut commands: Commands) {
    commands.spawn(Camera2d::default());

    let points = vec![
        Vec2::new(-200.0, 0.0),
        Vec2::new(0.0, 200.0),
        Vec2::new(200.0, 0.0),
    ];

    let colors = vec![
        RED.into(),
        GREEN.into(),
        BLUE.into(),
    ];

    commands.spawn(Line {
        points,
        colors,
        thickness: 5.0,
    });
}

Examples

Check out the examples directory for more detailed usage:

• simple_line.rs: Basic usage of the line renderer
• curved_line.rs: Rendering a curved line using Bezier curves

To run an example:

cargo run --example simple_line

License

• MIT license (LICENSE-MIT or http://opensource.org/licenses/MIT)

Contributing

Contributions are welcome! Please feel free to submit a Pull Request.