Enum density_mesh_core::DensityMeshGenerator

pub enum DensityMeshGenerator {
    Uninitialized,
    FindingPoints {
        settings: GenerateDensityMeshSettings,
        map: DensityMap,
        tries: usize,
        remaining: Vec<(Coord, Scalar, Scalar)>,
        points: Vec<Coord>,
        progress_current: usize,
        progress_limit: usize,
    },
    Triangulate {
        settings: GenerateDensityMeshSettings,
        map: DensityMap,
        points: Vec<Coord>,
        progress_limit: usize,
    },
    Extrude {
        points: Vec<Coord>,
        triangles: Vec<Triangle>,
        size: Scalar,
        progress_limit: usize,
    },
    BakeFinalMesh {
        points: Vec<Coord>,
        triangles: Vec<Triangle>,
        progress_limit: usize,
    },
    Completed {
        mesh: DensityMesh,
        progress_limit: usize,
    },
}

Density mesh generator state object. It allows you to process mesh generation in steps and track progress or cancel generation in the middle of the process.

Examples

use density_mesh_core::*;

let map = DensityMap::new(2, 2, 1, vec![1, 2, 3, 1]).unwrap();
let settings = GenerateDensityMeshSettings {
    points_separation: 0.5,
    visibility_threshold: 0.0,
    steepness_threshold: 0.0,
    ..Default::default()
};
let mut generator = DensityMeshGenerator::new(vec![], map, settings);
loop {
    match generator.process().unwrap().get_mesh_or_self() {
        Ok(mesh) => {
            println!("{:#?}", mesh);
            return;
        },
        Err(gen) => generator = gen,
    }
}

Variants

Uninitialized

FindingPoints

Fields of FindingPoints

settings: GenerateDensityMeshSettingsmap: DensityMaptries: usizeremaining: Vec<(Coord, Scalar, Scalar)>

[(coordinate, value, steepness)]

points: Vec<Coord>progress_current: usizeprogress_limit: usize

Triangulate

Fields of Triangulate

settings: GenerateDensityMeshSettingsmap: DensityMappoints: Vec<Coord>progress_limit: usize

Extrude

Fields of Extrude

points: Vec<Coord>triangles: Vec<Triangle>size: Scalarprogress_limit: usize

BakeFinalMesh

Fields of BakeFinalMesh

points: Vec<Coord>triangles: Vec<Triangle>progress_limit: usize

Completed

Fields of Completed

mesh: DensityMeshprogress_limit: usize

Implementations

impl DensityMeshGenerator

pub fn new(
    points: Vec<Coord>,
    map: DensityMap,
    settings: GenerateDensityMeshSettings
) -> Self

Creates new generator instance. Check struct documentation for examples.

Arguments

• points - List of initial points.
• map - Density map.
• settings - Density mesh generation settings.

Returns

New generator instance.

pub fn progress(&self) -> (usize, usize, Scalar)

Get processing progress.

Returns

(current, limit, percentage)

pub fn is_done(&self) -> bool

Check if mesh generation is done.

Returns

True if process is completed.

pub fn get_mesh_or_self(self) -> Result<DensityMesh, Self>

Tries to get inner generated mesh when ready, otherwise gets itself. This function consumes generator!

Returns

Result with mesh (Ok) when completed, or self (Err) when still processing.

Examples

use density_mesh_core::*;

let map = DensityMap::new(2, 2, 1, vec![1, 2, 3, 1]).unwrap();
let settings = GenerateDensityMeshSettings {
    points_separation: 0.5,
    visibility_threshold: 0.0,
    steepness_threshold: 0.0,
    ..Default::default()
};
let mut generator = DensityMeshGenerator::new(vec![], map, settings);
match generator.get_mesh_or_self() {
    Ok(mesh) => println!("{:#?}", mesh),
    Err(gen) => generator = gen,
}

pub fn process(self) -> Result<Self, GenerateDensityMeshError>

Process mesh generation. Check struct documentation for examples. This function consumes generator!

Returns

Result with self when processing step was successful, or error.

Trait Implementations

impl Clone for DensityMeshGenerator

fn clone(&self) -> DensityMeshGenerator

Returns a copy of the value.

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

Performs copy-assignment from source.

impl Debug for DensityMeshGenerator

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

Formats the value using the given formatter.

impl Default for DensityMeshGenerator

fn default() -> Self

Returns the "default value" for a type.

impl<'de> Deserialize<'de> for DensityMeshGenerator

fn deserialize<__D>(__deserializer: __D) -> Result<Self, __D::Error> where
    __D: Deserializer<'de>, 

Deserialize this value from the given Serde deserializer.

impl PartialEq<DensityMeshGenerator> for DensityMeshGenerator

fn eq(&self, other: &DensityMeshGenerator) -> bool

This method tests for self and other values to be equal, and is used by ==.

fn ne(&self, other: &DensityMeshGenerator) -> bool

This method tests for !=.

impl Serialize for DensityMeshGenerator

fn serialize<__S>(&self, __serializer: __S) -> Result<__S::Ok, __S::Error> where
    __S: Serializer, 

Serialize this value into the given Serde serializer.

impl StructuralPartialEq for DensityMeshGenerator