Struct density_mesh_core::live::LiveDensityMesh

pub struct LiveDensityMesh { /* fields omitted */ }

Density mesh with support for interactive region changes. This struct allows you to make changes without splitting mesh into chunks. Best for real-time applications.

Examples

use density_mesh_core::prelude::*;

let map = DensityMap::new(2, 4, 1, vec![255; 8]).unwrap();
let settings = GenerateDensityMeshSettings {
    points_separation: 0.5.into(),
    steepness_threshold: 0.0,
    keep_invisible_triangles: true,
    ..Default::default()
};
// create live density mesh.
let mut live = LiveDensityMesh::new(map, settings.clone());
// perform initial processing.
live.process_wait().unwrap();
// apply new data to inner density map region.
live.change_map(0, 2, 2, 2, vec![0; 4], settings);
// process changes.
live.process_wait().unwrap();
assert_eq!(live.map().values(), &[1.0, 1.0, 1.0, 1.0, 0.0, 0.0, 0.0, 0.0]);
assert_eq!(live.mesh().unwrap(), &DensityMesh {
    points: vec![
        Coord { x: 1.0, y: 0.0 },
        Coord { x: 0.0, y: 0.0 },
        Coord { x: 1.0, y: 2.0 },
        Coord { x: 0.0, y: 2.0 },
        Coord { x: 1.0, y: 1.0 },
        Coord { x: 0.0, y: 1.0 },
        Coord { x: 0.0, y: 3.0 },
        Coord { x: 1.0, y: 3.0 },
        Coord { x: 1.0, y: 2.0 },
        Coord { x: 0.0, y: 2.0 },
    ],
    triangles: vec![
        Triangle { a: 2, b: 4, c: 3 },
        Triangle { a: 4, b: 5, c: 3 },
        Triangle { a: 4, b: 0, c: 5 },
        Triangle { a: 0, b: 1, c: 5 },
        Triangle { a: 6, b: 7, c: 8 },
        Triangle { a: 8, b: 9, c: 6 },
    ],
});

Implementations

impl LiveDensityMesh

pub fn new(map: DensityMap, settings: GenerateDensityMeshSettings) -> Self

Create new live density mesh instance.

Arguments

• map - Density map.
• settings - Density mesh generation settings.

Returns

Live density mesh instance.

pub fn map(&self) -> &DensityMap

Get inner density map.

pub fn mesh(&self) -> Option<&DensityMesh>

Get inner density mesh if one is already generated.

pub fn in_progress(&self) -> bool

Tells if there are changes left to process.

pub fn change_map(
    &mut self,
    col: usize,
    row: usize,
    width: usize,
    height: usize,
    data: Vec<u8>,
    settings: GenerateDensityMeshSettings
) -> Result<(), DensityMapError>

Process pending changes.

Arguments

• col - Density map destination column.
• row - Density map destination row.
• width - Source data unscaled width.
• height - Source data unscaled height.
• data - Source data buffer.
• settings - Density mesh generation settings applied for this change.

Returns

Ok if successful or density map error.

pub fn process(&mut self) -> Result<LiveProcessStatus, GenerateDensityMeshError>

Process all pending changes to internal mesh.

Returns

Result with process status (Ok), or density mesh generation error.

pub fn process_wait(&mut self) -> Result<(), GenerateDensityMeshError>

Process all pending changes to internal mesh until it's done.

Returns

Ok when done, or density mesh generation error.

Trait Implementations

impl Clone for LiveDensityMesh

fn clone(&self) -> LiveDensityMesh

Returns a copy of the value.

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

Performs copy-assignment from source.

impl Debug for LiveDensityMesh

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

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for LiveDensityMesh

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

Deserialize this value from the given Serde deserializer.

impl PartialEq<LiveDensityMesh> for LiveDensityMesh

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

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

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

This method tests for !=.

impl Serialize for LiveDensityMesh

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 LiveDensityMesh