10 releases (breaking)
0.8.0 | Mar 23, 2023 |
---|---|
0.7.0 | Nov 26, 2022 |
0.5.0 | Apr 22, 2022 |
0.4.0 | Jan 28, 2022 |
0.2.0 | Dec 26, 2020 |
#103 in Game dev
4,084 downloads per month
Used in optima
135KB
101 lines
bevy_stl
STL is a very simple format, which supports only triangular geometry (positions + normals), without any color / uv / texture information.
It is supported as an output format by most CAD software.
Alternatives
- by default bevy can load glTF scenes, which is a much better choice if you are looking for a way to load more complex models / scenes, including materials, animations, etc.
- bevy_obj can load Wavefront .obj files, which can carry more information than STL (such as color, material, UV coordinates)
Usage
- Add
bevy_stl
to yourCargo.toml
- Add
bevy_stl::StlPlugin
plugin to the bevyApp
- Load STL assets by passing paths with ".stl" extension to
asset_server.load(..)
Example
fn main() {
App::new()
.add_plugin(bevy_stl::StlPlugin)
.add_startup_system(setup)
// ...
.run();
}
fn setup(commands: &mut Commands, asset_server: Res<AssetServer>, mut materials: ResMut<Assets<StandardMaterial>>) {
commands
.spawn(PbrBundle {
mesh: asset_server.load("disc.stl"),
material: materials.add(Color::rgb(0.9, 0.4, 0.3).into()),
..Default::default()
})
// ...
}
You can find a more complete example in examples/spinning_disc.rs
- use cargo run --example spinning_disc --release
to run it.
Optional Features
Wireframe
By default bevy_stl
produces a triangle mesh (PrimitiveTopology::TriangleList
).
When the optional wireframe
feature is enabled, an additional line mesh is produced (PrimitiveTopology::LineList
).
The feature can be enabled via Cargo.toml:
[dependencies.bevy_stl]
features = ["wireframe"]
When enabled, the mesh can be accessed by appending the wireframe label to the path passed to the asset loader:
// This returns the triangle mesh (the default):
asset_server.load("disc.stl")
// This returns the wireframe mesh:
asset_server.load("disc.stl#wireframe")
Dependencies
~21–58MB
~1M SLoC