Bevy 中的动画图表!
Library crate: Editor crate:
NOTICE: If you're currently using version
0.8.0or lower, note that0.9.0has introduced a number of breaking changes. Check out the migration guide for upgrading.
Animation graphs are an essential tool for managing the complexity present in the animation pipelines for modern 3D games. When your game has tens of animations with complex blends and transitions, or you want to generate your animations procedurally from very few keyframes, simple animation clip playback is not enough.
This crate works as an alternative to most of bevy_animation, and aims to
provide a complete animation system and development workflow including animation
graphs, animation state machines (i.e. animation controllers) and a graphical
editor to create your animation graphs and state machines.
NOTE: This project is separate from the animation graphs introduced in
bevy_animation in version 0.14.
bevy_animation_graph is the library part of this project. This should be added as a dependency to your project in order to use animation graphs. To install the latest published version from crates.io run
cargo add bevy_animation_graphor manually add the latest version to your Cargo.toml.
To install the latest git master, add the following to Cargo.toml:
# ...
[dependencies]
# ...
bevy_animation_graph = { git = "https://github.com/mbrea-c/bevy_animation_graph.git" }
# ...bevy_animation_graph_editor is the editor. You can install like you would install any other rust binary:
# for the latest crates.io version
cargo install bevy_animation_graph_editor
# for the latest master
cargo install --git https://github.com/mbrea-c/bevy_animation_graph bevy_animation_graph_editor
# for the version from a local workspace
cargo install --path bevy_animation_graph_editor
# use the --force flag to force reinstallAlternatively, I recommend taking a look at the editor as a plugin example in order to set up your own editor binary in your crate/workspace, consuming the same library version as your game. This will let you register custom animation graph nodes, which are a powerful feature of this crate.
Check out the tutorials in the work in progress book (many thanks to @SarahIhme for getting this started!).
Additional, up to date examples are included in the examples directory.
The following resources may also be useful, but they are somewhat out of date:
If you run into a bug or want to discuss potential new features, feel free to
post an issue, open a PR or reach out to me in Discord (@mbreac in the Bevy
discord, there's a crate-help post for bevy_animation_graph there:
link).
Depends.
It can already be useful for small-ish projects, but I cannot guarantee API
stability between different 0.x versions (it is a big library, it is
relatively young and I don't have previous experience with animation
programming, so I'm still figuring out the best ways of doing things). This
means that it will likely be necessary to go into your animation graph assets
and manually migrate them between versions, at least until I find a better way
to handle migrations.
Additionally, there may will be bugs and other issues. I try to get them
fixed as they come up.
If it's a small feature (e.g. some additional vector or floating point arithmetic node) it's likely that I have just not got around to it. If you open an issue I will probably implement it quickly. PRs are also welcome.
For larger features, it's better to start by opening an issue for discussion or pinging me in the Bevy discord.
bevy |
bevy_animation_graph |
|---|---|
| 0.19 | master |
| 0.19 | 0.11 |
| 0.18 | 0.10 |
| 0.17 | 0.9 |
| 0.17 | 0.8 |
| 0.16 | 0.7 |
| 0.15 | 0.6 |
| 0.14 | 0.5 |
| 0.13 | 0.4 |
| 0.13 | 0.3 |
| 0.12 | 0.2 |
Many thanks to Bobby Anguelov for his lectures on animation programming.
暂无开放 Issues,或尚未同步最近议题。