bevy_2dviewangle 0.4.2

Bevy plugin for easier to switch texture base on view angles
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118

bevy_2dviewangle
================

[![crates.io](https://img.shields.io/crates/v/bevy_2dviewangle)](https://crates.io/crates/bevy_2dviewangle)
[![docs.rs](https://docs.rs/bevy_2dviewangle/badge.svg)](https://docs.rs/bevy_2dviewangle)

Bevy plugin to easier to switch texture base on view angles. Currently, support 8 view angles:

* front
* back
* left
* right
* front_left
* front_right
* back_left
* back_right

Quick Start
-----------

Add plugin.
```rust
    App::new()
        ...
        .add_plugins(View2DAnglePlugin)
        ...
```

Declare texture map with each actor and action with view angle.
```rust
// Struct to load spritesheet
#[derive(ActorsTexturesCollection, Default)]
struct MyAssets {
    #[textureview(actor = 0, action = 0, angle = "front", handle = "image")]
    pub idle_front: Handle<Image>,

    // If not specify actor/action, the previous value will be used
    #[textureview(angle = "back", handle = "image")]
    pub idle_back: Handle<Image>,

    #[textureview(angle = "front", handle = "atlas_layout")]
    pub layout: Handle<TextureAtlasLayout>,
    
    // If angle is any, other angle which has not been defined will use this value
    #[textureview(angle = "any", handle = "atlas_layout")]
    pub layout: Handle<TextureAtlasLayout>,
}
```

Change the sprite sheet by sending event.
```rust
fn switch_sprite(
    mut actors: Query<(&mut DynamicActor, Entity)>,
    mut action_event: EventWriter<ViewChanged>,
) {
    for (mut act, e) in actors.iter_mut() {
        act.action = new_action;
        act.angle = new_direction;
        // Send event to change to sprite sheet to another view
        action_event.send(ViewChanged { entity: e });
    }
}
```

Please see in [examples](./examples) for more detail.

This plugin can work with [bevy_asset_loader](https://crates.io/crates/bevy_asset_loader) too:

```rust
#[derive(AssetCollection, ActorsTexturesCollection, Resource)]
pub struct MyAssets {
    #[asset(path = "frog_idle_front.png")]
    #[textureview(actor = 0, action = 0, angle = "front", handle = "image")]
    pub idle_front: Handle<Image>,

    #[asset(path = "frog_idle_back.png")]
    #[textureview(angle = "back", handle = "image")]
    pub idle_back: Handle<Image>,

    #[asset(path = "frog_idle_left.png")]
    #[textureview(angle = "left", handle = "image")]
    pub idle_left: Handle<Image>,

    #[asset(texture_atlas_layout(tile_size_x = 16., tile_size_y = 16., columns = 1, rows = 3))]
    #[textureview(angle = "any", handle = "atlas_layout")]
    pub front_layout: Handle<TextureAtlasLayout>,
}
```

Examples
--------

### 2d

![2d demo](https://i.imgur.com/7fRkkg3.mp4)

[2d example](examples/2d.rs)

### 3d

![3d demo](https://i.imgur.com/i3JnW9K.mp4)

[3d example](examples/3d.rs)

### Use with bevy_asset_loader

[asset loader example](examples/asset_loader.rs)

## License

Please see [LICENSE](../LICENSE).

## Compatible Bevy Versions

| bevy | bevy_2dviewangle         |
|------|--------------------------|
| 0.13 | 0.2-0.4, branch `master` |
| 0.12 | 0.1                      |