bevy_ecs_tiled 0.11.0

A Bevy plugin for loading Tiled maps
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
119
120
121
122
123
124
125
126
127
128
129

//! Avian physics backend for bevy_ecs_tiled.
//!
//! This module provides an implementation of the [`TiledPhysicsBackend`] trait using the Avian 2D physics engine.
//! This backend is only available when the `avian` feature is enabled.
//!
//! # Example
//!
//! ```rust,no_run
//! use bevy::prelude::*;
//! use bevy_ecs_tiled::prelude::*;
//!
//! App::new()
//!     .add_plugins(TiledPhysicsPlugin::<TiledPhysicsAvianBackend>::default());
//! ```
//!

use crate::prelude::*;
use avian2d::{
    parry::{
        math::{Isometry, Point, Real},
        shape::SharedShape,
    },
    prelude::*,
};
use bevy::prelude::*;

/// The [`TiledPhysicsBackend`] to use for Avian 2D integration.
///
/// This enum allows you to select how colliders are generated from Tiled shapes:
/// - [`TiledPhysicsAvianBackend::Polyline`]: Aggregates all line strings into a single polyline collider.
/// - [`TiledPhysicsAvianBackend::Triangulation`]: Triangulates polygons and aggregates triangles into a compound collider.
/// - [`TiledPhysicsAvianBackend::LineStrip`]: Creates a separate linestrip collider for each line string.
#[derive(Default, Reflect, Copy, Clone, Debug)]
#[reflect(Default, Debug)]
pub enum TiledPhysicsAvianBackend {
    #[default]
    /// Aggregates all [`geo::LineString`]s into a single collider using [`SharedShape::polyline`].
    Polyline,
    /// Performs triangulation and produces a single collider by aggregating multiple [`SharedShape::triangle`]s.
    Triangulation,
    /// Produces several linestrip colliders, one for each line string.
    LineStrip,
}

impl TiledPhysicsBackend for TiledPhysicsAvianBackend {
    fn spawn_colliders(
        &self,
        commands: &mut Commands,
        source: &TiledEvent<ColliderCreated>,
        multi_polygon: &geo::MultiPolygon<f32>,
    ) -> Vec<Entity> {
        let mut out = vec![];
        match self {
            TiledPhysicsAvianBackend::Triangulation => {
                let shared_shapes = multi_polygon_as_triangles(multi_polygon)
                    .iter()
                    .map(|([a, b, c], centroid)| {
                        (
                            Isometry::<Real>::new((*centroid).into(), 0.),
                            SharedShape::triangle((*a).into(), (*b).into(), (*c).into()),
                        )
                    })
                    .collect::<Vec<_>>();

                if !shared_shapes.is_empty() {
                    let collider: Collider = SharedShape::compound(shared_shapes).into();
                    out.push(
                        commands
                            .spawn((
                                Name::from("Avian[Triangulation]"),
                                ChildOf(*source.event.collider_of),
                                collider,
                            ))
                            .id(),
                    );
                }
            }
            TiledPhysicsAvianBackend::LineStrip => {
                multi_polygon_as_line_strings(multi_polygon)
                    .iter()
                    .enumerate()
                    .for_each(|(i, ls)| {
                        let collider: Collider = SharedShape::polyline(
                            ls.points().map(|v| Point::new(v.x(), v.y())).collect(),
                            None,
                        )
                        .into();
                        out.push(
                            commands
                                .spawn((
                                    Name::from(format!("Avian[LineStrip {i}]")),
                                    ChildOf(*source.event.collider_of),
                                    collider,
                                ))
                                .id(),
                        );
                    });
            }
            TiledPhysicsAvianBackend::Polyline => {
                let mut vertices = vec![];
                let mut indices = vec![];
                multi_polygon_as_line_strings(multi_polygon)
                    .iter()
                    .for_each(|ls| {
                        ls.lines().for_each(|l| {
                            let points = l.points();
                            let len = vertices.len();
                            vertices.push(Point::new(points.0.x(), points.0.y()));
                            vertices.push(Point::new(points.1.x(), points.1.y()));
                            indices.push([len as u32, (len + 1) as u32]);
                        });
                    });
                if !vertices.is_empty() {
                    let collider: Collider = SharedShape::polyline(vertices, Some(indices)).into();
                    out.push(
                        commands
                            .spawn((
                                Name::from("Avian[Polyline]"),
                                ChildOf(*source.event.collider_of),
                                collider,
                            ))
                            .id(),
                    );
                }
            }
        }
        out
    }
}