https://github.com/ickshonpe/bevy_independent_transform

Relative positioning, global scaling and rotation.
https://github.com/ickshonpe/bevy_independent_transform

Last synced: about 1 month ago
JSON representation

Relative positioning, global scaling and rotation.

• Host: GitHub
• URL: https://github.com/ickshonpe/bevy_independent_transform
• Owner: ickshonpe
• License: mit
• Created: 2022-10-05T11:15:42.000Z (about 2 years ago)
• Default Branch: main
• Last Pushed: 2022-10-05T15:54:06.000Z (about 2 years ago)
• Last Synced: 2024-03-15T09:48:55.064Z (9 months ago)
• Language: Rust
• Size: 122 KB
• Stars: 0
• Watchers: 1
• Forks: 0
• Open Issues: 0
• Metadata Files:
  • Readme: README.md
  • License: LICENSE

Awesome Lists containing this project

README

        
# bevy_independent_transform

[![crates.io](https://img.shields.io/crates/v/bevy_independent_transform)](https://crates.io/crates/bevy_independent_transform)

[![MIT/Apache 2.0](https://img.shields.io/badge/license-MIT%2FApache-blue.svg)](https://github.com/ickshonpe/bevy_independent_transform)

[![crates.io](https://img.shields.io/crates/d/bevy_independent_transform)](https://crates.io/crates/bevy_independent_transform)

Entities with an `IndependentTransform` have a position relative to their parent, but aren't part of the Bevy Transform hierarchy.

With `Transform` :

![image](/assets/dependent.png)

With `IndependentTransform`:

![image](/assets/independent_text.png)

Supports Bevy 0.8

## Setup

Add the dependency to your `Cargo.toml`

```toml

bevy_independent_transform = "0.1"

```

and the plugin to your `App`

```rust

fn main() {

  App::new()

    .add_plugins(DefaultPlugins)

    .add_plugin(IndependentTransformPlugin)

    // .. rest of App

    run()

}

```

## Usage

`IndependentTransform` is a newtype wrapping `Transform`.

Like `Transform`, an entity with a `IndependentTransform` should also have a `GlobalTransform`.

You can insert an `IndependentTransform` component directly, or spawn one of the bundles included with this crate:

* ```IndependentSpriteBundle```

* ```IndependentSpriteSheetBundle```

* ```IndependentText2dBundle```

* ```IndependentTransformBundle```

If an entity has both `IndependentTransform` and `Transform` components, the `IndependentTransform` component will be ignored.

## Examples

```

cargo run --example text

cargo run --example sprites

```

## Notes

For an alternative that respects the Bevy transform hierarchy, see my other crate at

https://github.com/ickshonpe/bevy_fixed_sprites

The approach here seems better for text and game icons, and bevy_fixed_sprites is probably better for sprites representing 

game characters and objects.

I'm not sure how to combine both methods. Maybe it's not possible without introducing a lot of complexity and extra components, and/or replacing Bevy's `transform_propagate_system` system

entirely. Haven't really thought about it much though.