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
use bevy::{prelude::*, utils::HashSet};
use crate::prelude::*;
/// Rules that determine which colliders are taken into account in [spatial queries](crate::spatial_query).
///
/// ## Example
///
/// ```
#[cfg_attr(feature = "2d", doc = "use avian2d::prelude::*;")]
#[cfg_attr(feature = "3d", doc = "use avian3d::prelude::*;")]
/// use bevy::prelude::*;
///
/// fn setup(mut commands: Commands) {
#[cfg_attr(
feature = "2d",
doc = " let object = commands.spawn(Collider::circle(0.5)).id();"
)]
#[cfg_attr(
feature = "3d",
doc = " let object = commands.spawn(Collider::sphere(0.5)).id();"
)]
///
/// // A query filter that has three collision layers and excludes the `object` entity
/// let query_filter = SpatialQueryFilter::from_mask(0b1011).with_excluded_entities([object]);
///
/// // Spawn a ray caster with the query filter
/// commands.spawn(RayCaster::default().with_query_filter(query_filter));
/// }
/// ```
#[derive(Clone, Debug, PartialEq, Reflect)]
#[cfg_attr(feature = "serialize", derive(serde::Serialize, serde::Deserialize))]
#[cfg_attr(feature = "serialize", reflect(Serialize, Deserialize))]
#[reflect(Debug, PartialEq)]
pub struct SpatialQueryFilter {
/// Specifies which [collision layers](CollisionLayers) will be included in the [spatial query](crate::spatial_query).
pub mask: LayerMask,
/// Entities that will not be included in [spatial queries](crate::spatial_query).
pub excluded_entities: HashSet<Entity>,
}
impl Default for SpatialQueryFilter {
fn default() -> Self {
Self {
mask: LayerMask::ALL,
excluded_entities: default(),
}
}
}
impl SpatialQueryFilter {
/// Creates a new [`SpatialQueryFilter`] with the given [`LayerMask`] determining
/// which [collision layers](CollisionLayers) will be included in the [spatial query](crate::spatial_query).
pub fn from_mask(mask: impl Into<LayerMask>) -> Self {
Self {
mask: mask.into(),
..default()
}
}
/// Creates a new [`SpatialQueryFilter`] with the given entities excluded from the [spatial query](crate::spatial_query).
pub fn from_excluded_entities(entities: impl IntoIterator<Item = Entity>) -> Self {
Self {
excluded_entities: HashSet::from_iter(entities),
..default()
}
}
/// Sets the [`LayerMask`] of the filter configuration. Only colliders with the corresponding
/// [collision layer memberships](CollisionLayers) will be included in the [spatial query](crate::spatial_query).
pub fn with_mask(mut self, masks: impl Into<LayerMask>) -> Self {
self.mask = masks.into();
self
}
/// Excludes the given entities from the [spatial query](crate::spatial_query).
pub fn with_excluded_entities(mut self, entities: impl IntoIterator<Item = Entity>) -> Self {
self.excluded_entities = HashSet::from_iter(entities);
self
}
/// Tests if an entity should be included in [spatial queries](crate::spatial_query) based on the
/// filter configuration.
pub fn test(&self, entity: Entity, layers: CollisionLayers) -> bool {
!self.excluded_entities.contains(&entity)
&& CollisionLayers::new(LayerMask::ALL, self.mask)
.interacts_with(CollisionLayers::new(layers.memberships, LayerMask::ALL))
}
}