feat: add support for parry’s new Voxels collider shape

Author: sebcrozet

CHANGELOG.md

@@ -2,6 +2,8 @@
 
 ### Added
 
+- Added support for parry’s new `Voxels` collider shape with `ColliderBuilder::voxels` and
+  `ColliderBuilder::voxelized_mesh`.
 - `MeshConverter` now implements `Copy`.
 
 ## v0.24.0 (10 April 2025)

src/geometry/collider.rs

@@ -1,4 +1,6 @@
 use crate::dynamics::{CoefficientCombineRule, MassProperties, RigidBodyHandle};
+#[cfg(feature = "dim3")]
+use crate::geometry::HeightFieldFlags;
 use crate::geometry::{
     ActiveCollisionTypes, BroadPhaseProxyIndex, ColliderBroadPhaseData, ColliderChanges,
     ColliderFlags, ColliderMassProps, ColliderMaterial, ColliderParent, ColliderPosition,
@@ -10,10 +12,8 @@ use crate::pipeline::{ActiveEvents, ActiveHooks};
 use crate::prelude::ColliderEnabled;
 use na::Unit;
 use parry::bounding_volume::{Aabb, BoundingVolume};
-use parry::shape::{Shape, TriMeshBuilderError, TriMeshFlags};
-
-#[cfg(feature = "dim3")]
-use crate::geometry::HeightFieldFlags;
+use parry::shape::{Shape, TriMeshBuilderError, TriMeshFlags, VoxelPrimitiveGeometry};
+use parry::transformation::voxelization::FillMode;
 
 #[cfg_attr(feature = "serde-serialize", derive(Serialize, Deserialize))]
 #[derive(Clone, Debug)]
@@ -573,6 +573,36 @@ impl ColliderBuilder {
         Self::new(SharedShape::halfspace(outward_normal))
     }
 
+    /// Initializes a collider made of voxels.
+    ///
+    /// Each voxel has the size `voxel_size` and centers given by `centers`.
+    /// The `primitive_geometry` controls the behavior of collision detection at voxels boundaries.
+    pub fn voxels(
+        primitive_geometry: VoxelPrimitiveGeometry,
+        centers: &[Point<Real>],
+        voxel_size: Real,
+    ) -> Self {
+        Self::new(SharedShape::voxels(primitive_geometry, centers, voxel_size))
+    }
+
+    /// Initializes a voxels obtained from the decomposition of the given trimesh (in 3D)
+    /// or polyline (in 2D) into voxelized convex parts.
+    pub fn voxelized_mesh(
+        primitive_geometry: VoxelPrimitiveGeometry,
+        vertices: &[Point<Real>],
+        indices: &[[u32; DIM]],
+        voxel_size: Real,
+        fill_mode: FillMode,
+    ) -> Self {
+        Self::new(SharedShape::voxelized_mesh(
+            primitive_geometry,
+            vertices,
+            indices,
+            voxel_size,
+            fill_mode,
+        ))
+    }
+
     /// Initialize a new collider builder with a cylindrical shape defined by its half-height
     /// (along the Y axis) and its radius.
     #[cfg(feature = "dim3")]

src/geometry/mod.rs

@@ -17,7 +17,7 @@ pub use self::narrow_phase::NarrowPhase;
 
 pub use parry::bounding_volume::BoundingVolume;
 pub use parry::query::{PointQuery, PointQueryWithLocation, RayCast, TrackedContact};
-pub use parry::shape::SharedShape;
+pub use parry::shape::{SharedShape, VoxelPrimitiveGeometry, VoxelState, VoxelType, Voxels};
 
 use crate::math::{Real, Vector};