Bevy Vector Shapes
[](https://crates.io/crates/bevy_vector_shapes)
[](https://docs.rs/bevy_vector_shapes)
[](https://github.com/james-j-obrien/bevy_vector_shapes/actions?query=workflow%3A%22Rust%22+branch%3Amain)
[](https://github.com/bevyengine/bevy/blob/main/docs/plugins_guidelines.md#main-branch-tracking)
What is Bevy Vector Shapes?
Bevy Vector Shapes is a library for easily and ergonomically creating instanced vector shapes in Bevy Engine.
WARNING
Bevy Vector Shapes is in the early stages of development. You may encounter issues, but feel free to report them.
Features
- Variety of built in shape types: lines, rectangles, circles, arcs and regular polygons.
- Traits to allow implementation of custom shape types.
- Supports various bevy rendering features: 2D and 3D pipelines, transparency, alpha modes, render layers, bloom.
- Canvas API for rendering shapes to a texture.
- Ability to draw textures on shapes, including canvas textures.
- Immediate and retained mode.
- Local anti-aliasing for smoother looking shapes.
- Optional billboarding for each shape type to ensure they are always facing the camera.
- Shapes of the same type and rendering configuration are fully instanced together.
- Compilation to wasm to run your projects in the browser.
Usage
See the minimal_2d or minimal_3d examples for basic usage and the remaining examples for explorations of supported features.
```rust
use bevy::prelude::;
// Import commonly used items
use bevy_vector_shapes::prelude::;
fn main() {
App::new()
.addplugins(DefaultPlugins)
// Add the shape plugin, Shape2dPlugin for 2D cameras or ShapePlugin for both 2D and 3D cameras
.addplugin(Shape2dPlugin::default())
.addstartupsystem(setup)
.add_system(draw)
.run();
}
fn setup(mut commands: Commands) {
// Spawn the camera
commands.spawn(Camera2dBundle::default());
}
fn draw(mut painter: ShapePainter) {
// Draw a circle
painter.circle(100.0);
}
```
| bevy | bevyvectorshapes |
| ---- | ------------------ |
| 0.10 | 0.4.0 |
Alternatives
- bevy_smud: for generating custom sdf expressions at run time.
- bevyprotoypelyon: for generating meshes from 2D shapes and paths.
- vello: for very efficient 2D shape rendering to images.