pub struct TriMesh { /* private fields */ }
Expand description
A triangle mesh.
Implementations
sourceimpl TriMesh
impl TriMesh
sourcepub fn bounding_sphere(&self, pos: &Isometry<Real>) -> BoundingSphere
pub fn bounding_sphere(&self, pos: &Isometry<Real>) -> BoundingSphere
Computes the world-space bounding sphere of this triangle mesh, transformed by pos
.
sourcepub fn local_bounding_sphere(&self) -> BoundingSphere
pub fn local_bounding_sphere(&self) -> BoundingSphere
Computes the local-space bounding sphere of this triangle mesh.
sourceimpl TriMesh
impl TriMesh
sourcepub fn canonical_split(
&self,
axis: usize,
bias: Real,
epsilon: Real
) -> SplitResult<Self>
pub fn canonical_split(
&self,
axis: usize,
bias: Real,
epsilon: Real
) -> SplitResult<Self>
Splits this TriMesh
along the given canonical axis.
This will split the AABB by a plane with a normal with it’s axis
-th component set to 1.
The splitting plane is shifted wrt. the origin by the bias
(i.e. it passes through the point
equal to normal * bias
).
Result
Returns the result of the split. The first mesh returned is the piece lying on the negative half-space delimited by the splitting plane. The second mesh returned is the piece lying on the positive half-space delimited by the splitting plane.
sourcepub fn split(
&self,
position: &Isometry<Real>,
axis: &UnitVector<Real>,
bias: Real,
epsilon: Real
) -> SplitResult<Self>
pub fn split(
&self,
position: &Isometry<Real>,
axis: &UnitVector<Real>,
bias: Real,
epsilon: Real
) -> SplitResult<Self>
Splits this mesh, transformed by position
by a plane identified by its normal local_axis
and the bias
(i.e. the plane passes through the point equal to normal * bias
).
sourcepub fn local_split(
&self,
local_axis: &UnitVector<Real>,
bias: Real,
epsilon: Real
) -> SplitResult<Self>
pub fn local_split(
&self,
local_axis: &UnitVector<Real>,
bias: Real,
epsilon: Real
) -> SplitResult<Self>
Splits this mesh by a plane identified by its normal local_axis
and the bias
(i.e. the plane passes through the point equal to normal * bias
).
sourcepub fn intersection_with_aabb(
&self,
position: &Isometry<Real>,
flip_mesh: bool,
aabb: &AABB,
flip_cuboid: bool,
epsilon: Real
) -> Option<Self>
pub fn intersection_with_aabb(
&self,
position: &Isometry<Real>,
flip_mesh: bool,
aabb: &AABB,
flip_cuboid: bool,
epsilon: Real
) -> Option<Self>
Computes the intersection mesh between an AABB and this mesh.
sourceimpl TriMesh
impl TriMesh
sourcepub fn new(vertices: Vec<Point<Real>>, indices: Vec<[u32; 3]>) -> Self
pub fn new(vertices: Vec<Point<Real>>, indices: Vec<[u32; 3]>) -> Self
Creates a new triangle mesh from a vertex buffer and an index buffer.
sourcepub fn with_flags(
vertices: Vec<Point<Real>>,
indices: Vec<[u32; 3]>,
flags: TriMeshFlags
) -> Self
pub fn with_flags(
vertices: Vec<Point<Real>>,
indices: Vec<[u32; 3]>,
flags: TriMeshFlags
) -> Self
Creates a new triangle mesh from a vertex buffer and an index buffer, and flags controlling optional properties.
sourcepub fn flags(&self) -> TriMeshFlags
pub fn flags(&self) -> TriMeshFlags
The flags of this triangle mesh.
sourcepub fn set_flags(&mut self, flags: TriMeshFlags) -> Result<(), TopologyError>
pub fn set_flags(&mut self, flags: TriMeshFlags) -> Result<(), TopologyError>
Sets the flags of this triangle mesh, controlling its optional associated data.
sourcepub fn transform_vertices(&mut self, transform: &Isometry<Real>)
pub fn transform_vertices(&mut self, transform: &Isometry<Real>)
Transforms in-place the vertices of this triangle mesh.
sourcepub fn scaled(self, scale: &Vector<Real>) -> Self
pub fn scaled(self, scale: &Vector<Real>) -> Self
Returns a scaled version of this triangle mesh.
sourcepub fn aabb(&self, pos: &Isometry<Real>) -> AABB
pub fn aabb(&self, pos: &Isometry<Real>) -> AABB
Compute the axis-aligned bounding box of this triangle mesh.
sourcepub fn local_aabb(&self) -> &AABB
pub fn local_aabb(&self) -> &AABB
Gets the local axis-aligned bounding box of this triangle mesh.
sourcepub fn num_triangles(&self) -> usize
pub fn num_triangles(&self) -> usize
The number of triangles forming this mesh.
sourcepub fn is_backface(&self, feature: FeatureId) -> bool
pub fn is_backface(&self, feature: FeatureId) -> bool
Does the given feature ID identify a backface of this trimesh?
sourcepub fn triangles(&self) -> impl ExactSizeIterator<Item = Triangle> + '_
pub fn triangles(&self) -> impl ExactSizeIterator<Item = Triangle> + '_
An iterator through all the triangles of this mesh.
sourcepub fn flat_indices(&self) -> &[u32]
pub fn flat_indices(&self) -> &[u32]
A flat view of the index buffer of this mesh.
sourcepub fn topology(&self) -> Option<&TriMeshTopology>
pub fn topology(&self) -> Option<&TriMeshTopology>
Returns the topology information of this trimesh, if it has been computed.
sourcepub fn connected_components(&self) -> Option<&TriMeshConnectedComponents>
pub fn connected_components(&self) -> Option<&TriMeshConnectedComponents>
Returns the connected-component information of this trimesh, if it has been computed.
sourcepub fn pseudo_normals(&self) -> Option<&TriMeshPseudoNormals>
pub fn pseudo_normals(&self) -> Option<&TriMeshPseudoNormals>
The pseudo-normals of this triangle mesh, if they have been computed.
Trait Implementations
sourceimpl<Heights, Status> From<GenericHeightField<Heights, Status>> for TriMesh where
Heights: HeightFieldStorage<Item = Real>,
Status: HeightFieldStorage<Item = HeightFieldCellStatus>,
impl<Heights, Status> From<GenericHeightField<Heights, Status>> for TriMesh where
Heights: HeightFieldStorage<Item = Real>,
Status: HeightFieldStorage<Item = HeightFieldCellStatus>,
sourcefn from(heightfield: GenericHeightField<Heights, Status>) -> Self
fn from(heightfield: GenericHeightField<Heights, Status>) -> Self
Converts to this type from the input type.
sourceimpl PointQuery for TriMesh
impl PointQuery for TriMesh
sourcefn project_local_point(
&self,
point: &Point<Real>,
solid: bool
) -> PointProjection
fn project_local_point(
&self,
point: &Point<Real>,
solid: bool
) -> PointProjection
Projects a point on self
. Read more
sourcefn project_local_point_and_get_feature(
&self,
point: &Point<Real>
) -> (PointProjection, FeatureId)
fn project_local_point_and_get_feature(
&self,
point: &Point<Real>
) -> (PointProjection, FeatureId)
Projects a point on the boundary of self
and returns the id of the
feature the point was projected on. Read more
sourcefn contains_local_point(&self, point: &Point<Real>) -> bool
fn contains_local_point(&self, point: &Point<Real>) -> bool
Tests if the given point is inside of self
.
sourcefn project_local_point_with_max_dist(
&self,
pt: &Point<Real>,
solid: bool,
max_dist: Real
) -> Option<PointProjection>
fn project_local_point_with_max_dist(
&self,
pt: &Point<Real>,
solid: bool,
max_dist: Real
) -> Option<PointProjection>
Projects a point on self
, unless the projection lies further than the given max distance. Read more
sourcefn project_point_with_max_dist(
&self,
m: &Isometry<Real>,
pt: &Point<Real>,
solid: bool,
max_dist: Real
) -> Option<PointProjection>
fn project_point_with_max_dist(
&self,
m: &Isometry<Real>,
pt: &Point<Real>,
solid: bool,
max_dist: Real
) -> Option<PointProjection>
Projects a point on self
transformed by m
, unless the projection lies further than the given max distance.
sourcefn distance_to_local_point(&self, pt: &Point<Real>, solid: bool) -> Real
fn distance_to_local_point(&self, pt: &Point<Real>, solid: bool) -> Real
Computes the minimal distance between a point and self
.
sourcefn project_point(
&self,
m: &Isometry<Real>,
pt: &Point<Real>,
solid: bool
) -> PointProjection
fn project_point(
&self,
m: &Isometry<Real>,
pt: &Point<Real>,
solid: bool
) -> PointProjection
Projects a point on self
transformed by m
.
sourcefn distance_to_point(
&self,
m: &Isometry<Real>,
pt: &Point<Real>,
solid: bool
) -> Real
fn distance_to_point(
&self,
m: &Isometry<Real>,
pt: &Point<Real>,
solid: bool
) -> Real
Computes the minimal distance between a point and self
transformed by m
.
sourceimpl PointQueryWithLocation for TriMesh
impl PointQueryWithLocation for TriMesh
type Location = (u32, TrianglePointLocation)
type Location = (u32, TrianglePointLocation)
Additional shape-specific projection information Read more
sourcefn project_local_point_and_get_location(
&self,
point: &Point<Real>,
solid: bool
) -> (PointProjection, Self::Location)
fn project_local_point_and_get_location(
&self,
point: &Point<Real>,
solid: bool
) -> (PointProjection, Self::Location)
Projects a point on self
.
sourceimpl RayCast for TriMesh
impl RayCast for TriMesh
sourcefn cast_local_ray(&self, ray: &Ray, max_toi: Real, solid: bool) -> Option<Real>
fn cast_local_ray(&self, ray: &Ray, max_toi: Real, solid: bool) -> Option<Real>
Computes the time of impact between this transform shape and a ray.
sourcefn cast_local_ray_and_get_normal(
&self,
ray: &Ray,
max_toi: Real,
solid: bool
) -> Option<RayIntersection>
fn cast_local_ray_and_get_normal(
&self,
ray: &Ray,
max_toi: Real,
solid: bool
) -> Option<RayIntersection>
Computes the time of impact, and normal between this transformed shape and a ray.
sourcefn intersects_local_ray(&self, ray: &Ray, max_toi: Real) -> bool
fn intersects_local_ray(&self, ray: &Ray, max_toi: Real) -> bool
Tests whether a ray intersects this transformed shape.
sourcefn cast_ray(
&self,
m: &Isometry<Real>,
ray: &Ray,
max_toi: Real,
solid: bool
) -> Option<Real>
fn cast_ray(
&self,
m: &Isometry<Real>,
ray: &Ray,
max_toi: Real,
solid: bool
) -> Option<Real>
Computes the time of impact between this transform shape and a ray.
sourcefn cast_ray_and_get_normal(
&self,
m: &Isometry<Real>,
ray: &Ray,
max_toi: Real,
solid: bool
) -> Option<RayIntersection>
fn cast_ray_and_get_normal(
&self,
m: &Isometry<Real>,
ray: &Ray,
max_toi: Real,
solid: bool
) -> Option<RayIntersection>
Computes the time of impact, and normal between this transformed shape and a ray.
sourceimpl Shape for TriMesh
impl Shape for TriMesh
sourcefn compute_local_aabb(&self) -> AABB
fn compute_local_aabb(&self) -> AABB
Computes the AABB of this shape.
sourcefn compute_local_bounding_sphere(&self) -> BoundingSphere
fn compute_local_bounding_sphere(&self) -> BoundingSphere
Computes the bounding-sphere of this shape.
sourcefn compute_aabb(&self, position: &Isometry<Real>) -> AABB
fn compute_aabb(&self, position: &Isometry<Real>) -> AABB
Computes the AABB of this shape with the given position.
sourcefn mass_properties(&self, density: Real) -> MassProperties
fn mass_properties(&self, density: Real) -> MassProperties
Compute the mass-properties of this shape given its uniform density.
sourcefn shape_type(&self) -> ShapeType
fn shape_type(&self) -> ShapeType
Gets the type tag of this shape.
sourcefn as_typed_shape(&self) -> TypedShape<'_>
fn as_typed_shape(&self) -> TypedShape<'_>
Gets the underlying shape as an enum.
fn ccd_thickness(&self) -> Real
fn ccd_angular_thickness(&self) -> Real
fn as_composite_shape(&self) -> Option<&dyn SimdCompositeShape>
sourcefn compute_bounding_sphere(&self, position: &Isometry<Real>) -> BoundingSphere
fn compute_bounding_sphere(&self, position: &Isometry<Real>) -> BoundingSphere
Computes the bounding-sphere of this shape with the given position.
sourcefn as_support_map(&self) -> Option<&dyn SupportMap>
fn as_support_map(&self) -> Option<&dyn SupportMap>
Convents this shape into its support mapping, if it has one.
sourcefn as_polygonal_feature_map(&self) -> Option<(&dyn PolygonalFeatureMap, Real)>
fn as_polygonal_feature_map(&self) -> Option<(&dyn PolygonalFeatureMap, Real)>
Converts this shape to a polygonal feature-map, if it is one.
sourceimpl SimdCompositeShape for TriMesh
impl SimdCompositeShape for TriMesh
sourceimpl TypedSimdCompositeShape for TriMesh
impl TypedSimdCompositeShape for TriMesh
Auto Trait Implementations
impl RefUnwindSafe for TriMesh
impl Send for TriMesh
impl Sync for TriMesh
impl Unpin for TriMesh
impl UnwindSafe for TriMesh
Blanket Implementations
sourceimpl<T> BorrowMut<T> for T where
T: ?Sized,
impl<T> BorrowMut<T> for T where
T: ?Sized,
const: unstable · sourcefn borrow_mut(&mut self) -> &mut T
fn borrow_mut(&mut self) -> &mut T
Mutably borrows from an owned value. Read more
sourceimpl<T> Downcast for T where
T: Any,
impl<T> Downcast for T where
T: Any,
sourcefn into_any(self: Box<T, Global>) -> Box<dyn Any + 'static, Global>
fn into_any(self: Box<T, Global>) -> Box<dyn Any + 'static, Global>
Convert Box<dyn Trait>
(where Trait: Downcast
) to Box<dyn Any>
. Box<dyn Any>
can
then be further downcast
into Box<ConcreteType>
where ConcreteType
implements Trait
. Read more
sourcefn into_any_rc(self: Rc<T>) -> Rc<dyn Any + 'static>
fn into_any_rc(self: Rc<T>) -> Rc<dyn Any + 'static>
Convert Rc<Trait>
(where Trait: Downcast
) to Rc<Any>
. Rc<Any>
can then be
further downcast
into Rc<ConcreteType>
where ConcreteType
implements Trait
. Read more
sourcefn as_any(&self) -> &(dyn Any + 'static)
fn as_any(&self) -> &(dyn Any + 'static)
Convert &Trait
(where Trait: Downcast
) to &Any
. This is needed since Rust cannot
generate &Any
’s vtable from &Trait
’s. Read more
sourcefn as_any_mut(&mut self) -> &mut (dyn Any + 'static)
fn as_any_mut(&mut self) -> &mut (dyn Any + 'static)
Convert &mut Trait
(where Trait: Downcast
) to &Any
. This is needed since Rust cannot
generate &mut Any
’s vtable from &mut Trait
’s. Read more
sourceimpl<T> DowncastSync for T where
T: Any + Send + Sync,
impl<T> DowncastSync for T where
T: Any + Send + Sync,
sourceimpl<SS, SP> SupersetOf<SS> for SP where
SS: SubsetOf<SP>,
impl<SS, SP> SupersetOf<SS> for SP where
SS: SubsetOf<SP>,
sourcefn to_subset(&self) -> Option<SS>
fn to_subset(&self) -> Option<SS>
The inverse inclusion map: attempts to construct self
from the equivalent element of its
superset. Read more
sourcefn is_in_subset(&self) -> bool
fn is_in_subset(&self) -> bool
Checks if self
is actually part of its subset T
(and can be converted to it).
sourcefn to_subset_unchecked(&self) -> SS
fn to_subset_unchecked(&self) -> SS
Use with care! Same as self.to_subset
but without any property checks. Always succeeds.
sourcefn from_subset(element: &SS) -> SP
fn from_subset(element: &SS) -> SP
The inclusion map: converts self
to the equivalent element of its superset.
sourceimpl<T> ToOwned for T where
T: Clone,
impl<T> ToOwned for T where
T: Clone,
type Owned = T
type Owned = T
The resulting type after obtaining ownership.
sourcefn clone_into(&self, target: &mut T)
fn clone_into(&self, target: &mut T)
toowned_clone_into
)Uses borrowed data to replace owned data, usually by cloning. Read more