aboutsummaryrefslogtreecommitdiff
diff options
context:
space:
mode:
authorLibravatar Silas Bartha <[email protected]>2024-04-23 16:17:07 -0400
committerLibravatar Silas Bartha <[email protected]>2024-04-23 16:17:07 -0400
commit5f3564cdc05ec065f41ad49fd9f80257a1ef9530 (patch)
treeed1c7b846ea618dab513160fc0134d2296237d96
parent18195e9089dd86ce90b7978f4806a893a25a512d (diff)
Added READMEv0.1.0
-rw-r--r--README.md73
-rw-r--r--doc/screenshot.pngbin0 -> 192578 bytes
-rw-r--r--doc/screenshot_smooth.pngbin0 -> 347011 bytes
3 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.
+
diff --git a/doc/screenshot.png b/doc/screenshot.png
new file mode 100644
index 0000000..cdbc4bf
--- /dev/null
+++ b/doc/screenshot.png
Binary files differ
diff --git a/doc/screenshot_smooth.png b/doc/screenshot_smooth.png
new file mode 100644
index 0000000..ea5b427
--- /dev/null
+++ b/doc/screenshot_smooth.png
Binary files differ