Struct TriMesh 

pub struct TriMesh { /* private fields */ }

A triangle mesh.

Implementations

impl TriMesh

pub fn bounding_sphere(&self, pos: &Isometry<f32>) -> BoundingSphere

Computes the world-space bounding sphere of this triangle mesh, transformed by pos.

pub fn local_bounding_sphere(&self) -> BoundingSphere

Computes the local-space bounding sphere of this triangle mesh.

impl TriMesh

pub fn cast_ray_with_culling( &self, m: &Isometry<f32>, ray: &Ray, max_time_of_impact: f32, culling: RayCullingMode, ) -> Option<RayIntersection>

Casts a ray on this triangle mesh transformed by m.

Hits happening later than max_time_of_impact are ignored. In other words, hits are only searched along the segment [ray.origin, ray.origin + ray.dir * max_time_of_impact].

Hits on back-faces or front-faces are ignored, depending on the given culling mode.

pub fn cast_local_ray_with_culling( &self, ray: &Ray, max_time_of_impact: f32, culling: RayCullingMode, ) -> Option<RayIntersection>

Casts a ray on this triangle mesh.

This is the same as TriMesh::cast_ray_with_culling except that the ray is given in the mesh’s local-space.

impl TriMesh

pub fn canonical_split( &self, axis: usize, bias: f32, epsilon: f32, ) -> 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.

pub fn split( &self, position: &Isometry<f32>, axis: &UnitVector<f32>, bias: f32, epsilon: f32, ) -> 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).

pub fn local_split( &self, local_axis: &UnitVector<f32>, bias: f32, epsilon: f32, ) -> 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).

pub fn canonical_intersection_with_plane( &self, axis: usize, bias: f32, epsilon: f32, ) -> IntersectResult<Polyline>

Computes the intersection Polylines between this mesh and the plane identified by the given canonical axis.

This will intersect the mesh 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).

Note that the resultant polyline may have multiple connected components

pub fn intersection_with_plane( &self, position: &Isometry<f32>, axis: &UnitVector<f32>, bias: f32, epsilon: f32, ) -> IntersectResult<Polyline>

Computes the intersection Polylines between this mesh, transformed by position, and a plane identified by its normal axis and the bias (i.e. the plane passes through the point equal to normal * bias).

pub fn intersection_with_local_plane( &self, local_axis: &UnitVector<f32>, bias: f32, epsilon: f32, ) -> IntersectResult<Polyline>

Computes the intersection Polylines between this mesh and a plane identified by its normal local_axis and the bias (i.e. the plane passes through the point equal to normal * bias).

pub fn intersection_with_aabb( &self, position: &Isometry<f32>, flip_mesh: bool, aabb: &Aabb, flip_cuboid: bool, epsilon: f32, ) -> Result<Option<Self>, MeshIntersectionError>

Computes the intersection mesh between an Aabb and this mesh.

pub fn intersection_with_cuboid( &self, position: &Isometry<f32>, flip_mesh: bool, cuboid: &Cuboid, cuboid_position: &Isometry<f32>, flip_cuboid: bool, epsilon: f32, ) -> Result<Option<Self>, MeshIntersectionError>

Computes the intersection mesh between a cuboid and this mesh transformed by position.

pub fn intersection_with_local_cuboid( &self, flip_mesh: bool, cuboid: &Cuboid, cuboid_position: &Isometry<f32>, flip_cuboid: bool, _epsilon: f32, ) -> Result<Option<Self>, MeshIntersectionError>

Computes the intersection mesh between a cuboid and this mesh.

impl TriMesh

pub fn new( vertices: Vec<Point<f32>>, indices: Vec<[u32; 3]>, ) -> Result<Self, TriMeshBuilderError>

Creates a new triangle mesh from a vertex buffer and an index buffer.

pub fn with_flags( vertices: Vec<Point<f32>>, indices: Vec<[u32; 3]>, flags: TriMeshFlags, ) -> Result<Self, TriMeshBuilderError>

Creates a new triangle mesh from a vertex buffer and an index buffer, and flags controlling optional properties.

pub fn set_flags(&mut self, flags: TriMeshFlags) -> Result<(), TopologyError>

Sets the flags of this triangle mesh, controlling its optional associated data.

pub fn total_memory_size(&self) -> usize

An approximation of the memory usage (in bytes) for this struct plus the memory it allocates dynamically.

pub fn heap_memory_size(&self) -> usize

An approximation of the memory dynamically-allocated by this struct.

pub fn transform_vertices(&mut self, transform: &Isometry<f32>)

Transforms in-place the vertices of this triangle mesh.

pub fn scaled(self, scale: &Vector<f32>) -> Self

Returns a scaled version of this triangle mesh.

pub fn append(&mut self, rhs: &TriMesh)

Appends a second triangle mesh to this triangle mesh.

pub fn flat_indices(&self) -> &[u32]

A flat view of the index buffer of this mesh.

pub fn reverse(&mut self)

Reverse the orientation of the triangle mesh.

pub fn triangles(&self) -> impl ExactSizeIterator<Item = Triangle> + '_

An iterator through all the triangles of this mesh.

pub fn feature_normal(&self, feature: FeatureId) -> Option<Unit<Vector<f32>>>

Gets the normal of the triangle represented by feature.

impl TriMesh

pub fn flags(&self) -> TriMeshFlags

The flags of this triangle mesh.

pub fn aabb(&self, pos: &Isometry<f32>) -> Aabb

Compute the axis-aligned bounding box of this triangle mesh.

pub fn local_aabb(&self) -> Aabb

Gets the local axis-aligned bounding box of this triangle mesh.

pub fn bvh(&self) -> &Bvh

The acceleration structure used by this triangle-mesh.

pub fn num_triangles(&self) -> usize

The number of triangles forming this mesh.

pub fn is_backface(&self, feature: FeatureId) -> bool

Does the given feature ID identify a backface of this trimesh?

pub fn triangle(&self, i: u32) -> Triangle

Get the i-th triangle of this mesh.

pub fn triangle_normal_constraints( &self, i: u32, ) -> Option<TrianglePseudoNormals>

Returns the pseudo-normals of one of this mesh’s triangles, if it was computed.

This returns None if the pseudo-normals of this triangle were not computed. To have its pseudo-normals computed, be sure to set the TriMeshFlags so that they contain the TriMeshFlags::FIX_INTERNAL_EDGES flag.

pub fn vertices(&self) -> &[Point<f32>]

The vertex buffer of this mesh.

pub fn indices(&self) -> &[[u32; 3]]

The index buffer of this mesh.

pub fn topology(&self) -> Option<&TriMeshTopology>

Returns the topology information of this trimesh, if it has been computed.

pub fn connected_components(&self) -> Option<&TriMeshConnectedComponents>

Returns the connected-component information of this trimesh, if it has been computed.

pub fn connected_component_meshes( &self, flags: TriMeshFlags, ) -> Option<Vec<Result<TriMesh, TriMeshBuilderError>>>

Returns the connected-component of this mesh.

The connected-components are returned as a set of TriMesh build with the given flags.

pub fn pseudo_normals(&self) -> Option<&TriMeshPseudoNormals>

The pseudo-normals of this triangle mesh, if they have been computed.

pub fn pseudo_normals_if_oriented(&self) -> Option<&TriMeshPseudoNormals>

The pseudo-normals of this triangle mesh, if they have been computed and this mesh was marked as TriMeshFlags::ORIENTED.

Trait Implementations

impl Clone for TriMesh

fn clone(&self) -> TriMesh

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl CompositeShape for TriMesh

fn map_part_at( &self, i: u32, f: &mut dyn FnMut(Option<&Isometry<f32>>, &dyn Shape, Option<&dyn NormalConstraints>), )

Applies a function to one sub-shape of this composite shape.

fn bvh(&self) -> &Bvh

Gets the acceleration structure of the composite shape.

impl Debug for TriMesh

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl From<Cuboid> for TriMesh

Available on crate feature dim3 only.

fn from(cuboid: Cuboid) -> Self

Converts to this type from the input type.

impl From<HeightField> for TriMesh

Available on crate feature dim3 only.

fn from(heightfield: HeightField) -> Self

Converts to this type from the input type.

impl PointQuery for TriMesh

fn project_local_point_with_max_dist( &self, pt: &Point<f32>, solid: bool, max_dist: f32, ) -> Option<PointProjection>

Projects a point on self transformed by m, unless the projection lies further than the given max distance.

fn project_local_point( &self, point: &Point<f32>, solid: bool, ) -> PointProjection

Projects a point on self.

fn project_local_point_and_get_feature( &self, point: &Point<f32>, ) -> (PointProjection, FeatureId)

Projects a point on the boundary of self and returns the id of the feature the point was projected on.

fn contains_local_point(&self, point: &Point<f32>) -> bool

Tests if the given point is inside of self.

fn project_point_with_max_dist( &self, m: &Isometry<f32>, pt: &Point<f32>, solid: bool, max_dist: f32, ) -> Option<PointProjection>

Projects a point on self transformed by m, unless the projection lies further than the given max distance.

fn distance_to_local_point(&self, pt: &Point<f32>, solid: bool) -> f32

Computes the minimal distance between a point and self.

fn project_point( &self, m: &Isometry<f32>, pt: &Point<f32>, solid: bool, ) -> PointProjection

Projects a point on self transformed by m.

fn distance_to_point( &self, m: &Isometry<f32>, pt: &Point<f32>, solid: bool, ) -> f32

Computes the minimal distance between a point and self transformed by m.

fn project_point_and_get_feature( &self, m: &Isometry<f32>, pt: &Point<f32>, ) -> (PointProjection, FeatureId)

Projects a point on the boundary of self transformed by m and returns the id of the feature the point was projected on.

fn contains_point(&self, m: &Isometry<f32>, pt: &Point<f32>) -> bool

Tests if the given point is inside of self transformed by m.

impl PointQueryWithLocation for TriMesh

fn project_local_point_and_get_location_with_max_dist( &self, point: &Point<f32>, solid: bool, max_dist: f32, ) -> Option<(PointProjection, Self::Location)>

Projects a point on self, with a maximum projection distance.

type Location = (u32, TrianglePointLocation)

Additional shape-specific projection information

fn project_local_point_and_get_location( &self, point: &Point<f32>, solid: bool, ) -> (PointProjection, Self::Location)

Projects a point on self.

fn project_point_and_get_location( &self, m: &Isometry<f32>, pt: &Point<f32>, solid: bool, ) -> (PointProjection, Self::Location)

Projects a point on self transformed by m.

fn project_point_and_get_location_with_max_dist( &self, m: &Isometry<f32>, pt: &Point<f32>, solid: bool, max_dist: f32, ) -> Option<(PointProjection, Self::Location)>

Projects a point on self transformed by m, with a maximum projection distance.

impl RayCast for TriMesh

fn cast_local_ray( &self, ray: &Ray, max_time_of_impact: f32, solid: bool, ) -> Option<f32>

Computes the time of impact between this transform shape and a ray.

fn cast_local_ray_and_get_normal( &self, ray: &Ray, max_time_of_impact: f32, solid: bool, ) -> Option<RayIntersection>

Computes the time of impact, and normal between this transformed shape and a ray.

fn intersects_local_ray(&self, ray: &Ray, max_time_of_impact: f32) -> bool

Tests whether a ray intersects this transformed shape.

fn cast_ray( &self, m: &Isometry<f32>, ray: &Ray, max_time_of_impact: f32, solid: bool, ) -> Option<f32>

Computes the time of impact between this transform shape and a ray.

fn cast_ray_and_get_normal( &self, m: &Isometry<f32>, ray: &Ray, max_time_of_impact: f32, solid: bool, ) -> Option<RayIntersection>

Computes the time of impact, and normal between this transformed shape and a ray.

fn intersects_ray( &self, m: &Isometry<f32>, ray: &Ray, max_time_of_impact: f32, ) -> bool

Tests whether a ray intersects this transformed shape.

impl Shape for TriMesh

Available on crate feature alloc only.

fn feature_normal_at_point( &self, _feature: FeatureId, _point: &Point<f32>, ) -> Option<Unit<Vector<f32>>>

Gets the normal of the triangle represented by feature.

fn clone_dyn(&self) -> Box<dyn Shape>

Clones this shape into a boxed trait-object.

fn scale_dyn( &self, scale: &Vector<f32>, _num_subdivisions: u32, ) -> Option<Box<dyn Shape>>

Scales this shape by scale into a boxed trait-object.

fn compute_local_aabb(&self) -> Aabb

Computes the Aabb of this shape.

fn compute_local_bounding_sphere(&self) -> BoundingSphere

Computes the bounding-sphere of this shape.

fn compute_aabb(&self, position: &Isometry<f32>) -> Aabb

Computes the Aabb of this shape with the given position.

fn mass_properties(&self, density: f32) -> MassProperties

Compute the mass-properties of this shape given its uniform density.

fn shape_type(&self) -> ShapeType

Gets the type tag of this shape.

fn as_typed_shape(&self) -> TypedShape<'_>

Gets the underlying shape as an enum.

fn ccd_thickness(&self) -> f32

fn ccd_angular_thickness(&self) -> f32

fn as_composite_shape(&self) -> Option<&dyn CompositeShape>

fn clone_box(&self) -> Box<dyn Shape>

👎Deprecated: renamed to clone_dyn

Clones this shape into a boxed trait-object.

fn compute_bounding_sphere(&self, position: &Isometry<f32>) -> BoundingSphere

Computes the bounding-sphere of this shape with the given position.

fn is_convex(&self) -> bool

Is this shape known to be convex?

fn as_support_map(&self) -> Option<&dyn SupportMap>

Converts this shape into its support mapping, if it has one.

fn as_polygonal_feature_map(&self) -> Option<(&dyn PolygonalFeatureMap, f32)>

Converts this shape to a polygonal feature-map, if it is one.

fn compute_swept_aabb( &self, start_pos: &Isometry<f32>, end_pos: &Isometry<f32>, ) -> Aabb

Computes the swept Aabb of this shape, i.e., the space it would occupy by moving from the given start position to the given end position.

impl TypedCompositeShape for TriMesh

type PartShape = Triangle

type PartNormalConstraints = TrianglePseudoNormals

fn map_typed_part_at<T>( &self, i: u32, f: impl FnMut(Option<&Isometry<f32>>, &Self::PartShape, Option<&Self::PartNormalConstraints>) -> T, ) -> Option<T>

fn map_untyped_part_at<T>( &self, i: u32, f: impl FnMut(Option<&Isometry<f32>>, &dyn Shape, Option<&dyn NormalConstraints>) -> T, ) -> Option<T>