Bevy Mod Transform2d

A 2D Transform component for Bevy.

Usage

[dependencies]
bevy_mod_transform2d = "0.1"

use bevy_mod_transform2d::prelude::*;

fn main() {
    App::new()
        .add_plugins(DefaultPlugins)
        // Add the plugin
        .add_plugin(Transform2dPlugin)
        .add_startup_system(setup)
        .run();
}

fn setup(mut commands: Commands) {
    commands
        .spawn_bundle(SpriteBundle {
            sprite: Sprite {
                custom_size: Some(Vec2::splat(100.)),
                ..default()
            },
            ..default()
        })
        // Add a Transform2d component!
        .insert(Transform2d::from_xy(200., 0.))
}

Take a look here for the examples.

Version table.

Note that the Transform2d component does not replace Transform component, instead it writes to it. The Transform and GlobalTransform components are required for Transform2d to function.

To integrate with another library the state of Transform and Transform2d will need to be synchronised at the right times.

This is already done for bevy_rapier2d, so just enable the feature and you're off!

[dependencies]
bevy_mod_transform2d = { version = "0.1", features = ["bevy_rapier2d"] }

If there is another library interacts with the transform here's how you would synchronise the state to keep it up-to-date.

• When a system needs to read from Transfrom add the provided sync_to_3d_transform system before it.
• When a system writes to Transfrom add the provided sync_from_3d_transform system after it.

License

Bevy Mod Transform2d is free and open source! All code in this repository is dual-licensed under either:

• MIT License (LICENSE-MIT or http://opensource.org/licenses/MIT)
• Apache License, Version 2.0 (LICENSE-APACHE or http://www.apache.org/licenses/LICENSE-2.0)

at your option. This means you can select the license you prefer!

Unless you explicitly state otherwise, any contribution intentionally submitted for inclusion in the work by you, as defined in the Apache-2.0 license, shall be dual licensed as above, without any additional terms or conditions.