Struct UniformMeshSampler

pub struct UniformMeshSampler { /* private fields */ }

Available on crate features rand and alloc only.

A distribution that caches data to allow fast sampling from a collection of triangles. Generally used through sample or sample_iter.

Example

let faces = Tetrahedron::default().faces();
let sampler = UniformMeshSampler::try_new(faces).unwrap();
let rng = StdRng::seed_from_u64(8765309);
// 50 random points on the tetrahedron:
let samples: Vec<Vec3> = sampler.sample_iter(rng).take(50).collect();

Implementations

impl UniformMeshSampler

pub fn try_new<T: IntoIterator<Item = Triangle3d>>( triangles: T, ) -> Result<Self, WeightedError>

Construct a new UniformMeshSampler from a list of triangles.

Returns an error if the distribution of areas for the collection of triangles could not be formed (most notably if the collection has zero surface area).

Trait Implementations

impl Distribution<Vec3> for UniformMeshSampler

fn sample<R: Rng + ?Sized>(&self, rng: &mut R) -> Vec3

Generate a random value of T, using rng as the source of randomness.

fn sample_iter<R>(self, rng: R) -> DistIter<Self, R, T>

where R: Rng, Self: Sized,

Create an iterator that generates random values of T, using rng as the source of randomness.

fn map<F, S>(self, func: F) -> DistMap<Self, F, T, S>

where F: Fn(T) -> S, Self: Sized,

Create a distribution of values of ‘S’ by mapping the output of Self through the closure F