Struct parry3d_f64::shape::GenericHeightField

#[repr(C)]
pub struct GenericHeightField<Storage: HeightFieldStorage> { /* private fields */ }

A 3D heightfield with a generic storage buffer for its height grid.

Implementations

impl<Storage: HeightFieldStorage> GenericHeightField<Storage>

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

Computes the world-space Aabb of this heightfield, transformed by pos.

pub fn local_aabb(&self) -> Aabb

Computes the local-space Aabb of this heightfield.

impl<Storage: HeightFieldStorage> GenericHeightField<Storage>

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

Computes the world-space bounding sphere of this height-field, transformed by pos.

pub fn local_bounding_sphere(&self) -> BoundingSphere

Computes the local-space bounding sphere of this height-field.

impl GenericHeightField<DefaultStorage>

pub fn new(heights: DMatrix<Real>, scale: Vector<Real>) -> Self

Initializes a new heightfield with the given heights and a scaling factor.

impl<Storage: HeightFieldStorage> GenericHeightField<Storage>

pub fn nrows(&self) -> usize

The number of rows of this heightfield.

pub fn ncols(&self) -> usize

The number of columns of this heightfield.

pub fn closest_cell_at_point(&self, pt: &Point3<Real>) -> (usize, usize)

The pair of index of the cell containing the vertical projection of the given point.

pub fn cell_at_point(&self, pt: &Point3<Real>) -> Option<(usize, usize)>

The pair of index of the cell containing the vertical projection of the given point.

pub fn unclamped_cell_at_point(&self, pt: &Point3<Real>) -> (isize, isize)

The pair of index of the cell containing the vertical projection of the given point.

pub fn x_at(&self, j: usize) -> Real

The smallest x coordinate of the j-th column of this heightfield.

pub fn z_at(&self, i: usize) -> Real

The smallest z coordinate of the start of the i-th row of this heightfield.

pub fn signed_x_at(&self, j: isize) -> Real

The smallest x coordinate of the j-th column of this heightfield.

pub fn signed_z_at(&self, i: isize) -> Real

The smallest z coordinate of the start of the i-th row of this heightfield.

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

An iterator through all the triangles of this heightfield.

pub fn triangles_around_point( &self, point: &Point3<Real> ) -> HeightFieldRadialTriangles<'_, Storage>

An iterator through all the triangles around the given point, after vertical projection on the heightfield.

pub fn triangle_at_id(&self, id: u32) -> Option<Triangle>

Gets the the vertices of the triangle identified by id.

pub fn triangle_vids_at_id(&self, id: u32) -> Option<[u32; 3]>

Gets the vertex indices of the triangle identified by id.

pub fn triangles_vids_at( &self, i: usize, j: usize ) -> (Option<[u32; 3]>, Option<[u32; 3]>)

Gets the indices of the vertices of the (up to) two triangles for the cell (i, j).

pub fn triangles_at( &self, i: usize, j: usize ) -> (Option<Triangle>, Option<Triangle>)

The two triangles at the cell (i, j) of this heightfield.

Returns None fore triangles that have been removed because of their user-defined status flags (described by the HeightFieldCellStatus bitfield).

pub fn num_cells_ij(&self) -> (usize, usize)

The number of cells of this heightfield along each dimension.

pub fn cell_status(&self, i: usize, j: usize) -> HeightFieldCellStatus

The status of the (i, j)-th cell.

pub fn set_cell_status( &mut self, i: usize, j: usize, status: HeightFieldCellStatus )

Set the status of the (i, j)-th cell.

pub fn cells_statuses(&self) -> &Storage::Status

The statuses of all the cells of this heightfield.

pub fn cells_statuses_mut(&mut self) -> &mut Storage::Status

The mutable statuses of all the cells of this heightfield.

pub fn heights(&self) -> &Storage::Heights

The heights of this heightfield.

pub fn scale(&self) -> &Vector<Real>

The scale factor applied to this heightfield.

pub fn set_scale(&mut self, new_scale: Vector<Real>)

Sets the scale factor applied to this heightfield.

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

Returns a scaled version of this heightfield.

pub fn cell_width(&self) -> Real

The width (extent along its local x axis) of each cell of this heightmap, including the scale factor.

pub fn cell_height(&self) -> Real

The height (extent along its local z axis) of each cell of this heightmap, including the scale factor.

pub fn unit_cell_width(&self) -> Real

The width (extent along its local x axis) of each cell of this heightmap, excluding the scale factor.

pub fn unit_cell_height(&self) -> Real

The height (extent along its local z axis) of each cell of this heightmap, excluding the scale factor.

pub fn root_aabb(&self) -> &Aabb

The Aabb of this heightmap.

pub fn convert_triangle_feature_id( &self, i: usize, j: usize, left: bool, fid: FeatureId ) -> FeatureId

Converts the FeatureID of the left or right triangle at the cell (i, j) into a FeatureId of the whole heightfield.

pub fn unclamped_elements_range_in_local_aabb( &self, aabb: &Aabb ) -> (Range<isize>, Range<isize>)

The range of segment ids that may intersect the given local Aabb.

pub fn map_elements_in_local_aabb( &self, aabb: &Aabb, f: &mut impl FnMut(u32, &Triangle) )

Applies the function f to all the triangles of this heightfield intersecting the given Aabb.

impl<Storage: HeightFieldStorage> GenericHeightField<Storage>

pub fn to_trimesh(&self) -> (Vec<Point3<Real>>, Vec<[u32; 3]>)

Discretize the boundary of this heightfield as a triangle-mesh.

Trait Implementations

impl<Storage> Clone for GenericHeightField<Storage>

where Storage: HeightFieldStorage, Storage::Heights: Clone, Storage::Status: Clone,

fn clone(&self) -> Self

Returns a copy of the value.

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

Performs copy-assignment from source.

impl<Storage: Debug + HeightFieldStorage> Debug for GenericHeightField<Storage>

where Storage::Heights: Debug, Storage::Status: Debug,

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

Formats the value using the given formatter.

impl<Storage: HeightFieldStorage> From<GenericHeightField<Storage>> for TriMesh

fn from(heightfield: GenericHeightField<Storage>) -> Self

Converts to this type from the input type.

impl<Storage: HeightFieldStorage> PointQuery for GenericHeightField<Storage>

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.

fn project_local_point(&self, point: &Point<Real>, _: bool) -> PointProjection

Projects a point on self.

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.

fn contains_local_point(&self, _point: &Point<Real>) -> bool

Tests if the given point is inside of self.

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.

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

Computes the minimal distance between a point and self.

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

Projects a point on self transformed by m.

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.

fn project_point_and_get_feature( &self, m: &Isometry<Real>, pt: &Point<Real> ) -> (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<Real>, pt: &Point<Real>) -> bool

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

impl<Storage: HeightFieldStorage> PointQueryWithLocation for GenericHeightField<Storage>

type Location = (usize, TrianglePointLocation)

Additional shape-specific projection information

fn project_local_point_and_get_location( &self, _point: &Point<Real>, _: bool ) -> (PointProjection, Self::Location)

Projects a point on self.

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

Projects a point on self transformed by m.

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

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

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

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

impl<Storage: HeightFieldStorage> RayCast for GenericHeightField<Storage>

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.

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.

fn intersects_local_ray(&self, ray: &Ray, max_toi: Real) -> bool

Tests whether a ray intersects this transformed shape.

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.

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.

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

Tests whether a ray intersects this transformed shape.

impl<Storage> Copy for GenericHeightField<Storage>

where Storage: HeightFieldStorage, Storage::Heights: Copy, Storage::Status: Copy,