diff options
author | Silas Bartha <[email protected]> | 2024-04-23 16:17:07 -0400 |
---|---|---|
committer | Silas Bartha <[email protected]> | 2024-04-23 16:17:07 -0400 |
commit | 5f3564cdc05ec065f41ad49fd9f80257a1ef9530 (patch) | |
tree | ed1c7b846ea618dab513160fc0134d2296237d96 /README.md | |
parent | 18195e9089dd86ce90b7978f4806a893a25a512d (diff) |
Added READMEv0.1.0
Diffstat (limited to 'README.md')
-rw-r--r-- | README.md | 73 |
1 files changed, 73 insertions, 0 deletions
diff --git a/README.md b/README.md new file mode 100644 index 0000000..dbe6816 --- /dev/null +++ b/README.md @@ -0,0 +1,73 @@ +# grex_outline_post_process + + +A plugin for the [Bevy](https://bevyengine.org) engine which adds an outline post-processing effect. + +## Screenshots +![](./doc/screenshot.png) +![](./doc/screenshot_smooth.png) +Configuration Used: +```rs +grex_outline_post_process::components::OutlinePostProcessSettings { + weight: 2.0, + threshold: 0.0, +} +``` + +## Installation + +### Using git URL in Cargo.toml +```toml +[dependencies.grex_outline_post_process] +git = "https://github.com/exvacuum/grex_outline_post_process.git" +``` + +### Workspace Submodule +I recommend organizing your Bevy project as a [cargo workspace](https://doc.rust-lang.org/book/ch14-03-cargo-workspaces.html) and pulling this repository as a git submodule: +```bash +git submodule add [email protected]:exvacuum/grex_outline_post_process.git +``` + +We can add a [patch override](https://doc.rust-lang.org/cargo/reference/overriding-dependencies.html#overriding-repository-url) for this repository in the workspace's `Cargo.toml`: +```toml +[patch."https://github.com/exvacuum/grex_outline_post_process.git".grex_outline_post_process] +path = "./grex_outline_post_process" +``` + +And then, from a crate that depends on it: +```toml +[dependencies.grex_outline_post_process] +git = "https://github.com/exvacuum/grex_outline_post_process.git" +``` + + +## Usage + +In `main.rs`: +```rs +use bevy::prelude::*; +use grex_outline_post_process; + +fn main() { + App::new() + .add_plugins(( + DefaultPlugins, + grex_outline_post_process::OutlinePostProcessPlugin, + )) + .run(); +} +``` + +When spawning a camera: +```rs +commands.spawn(( + // Camera3dBundle... + grex_outline_post_process::components::OutlinePostProcessSettings { + weight: 2.0, + threshold: 0.0, + } +)); +``` + +This effect will only run for cameras which contain this component. + |