Skip to main content

Mesh3d

Struct Mesh3d 

Source
pub struct Mesh3d { /* private fields */ }
Expand description

Immutable validated topology for retained stereometry rendering.

Vertices use caller-defined model-space world units. Triangle indices are a flat triangle list. Winding is preserved but deliberately not interpreted: the current surface pass disables face culling, and a global “counter-clockwise” rule is meaningless without a declared outward side. Optional display edges identify the mathematical edges that a later visible/hidden-line pass should draw; they are not inferred from triangle adjacency because triangulation diagonals are not necessarily meaningful construction edges. A mesh may contain surfaces, display edges, or both.

Implementations§

Source§

impl Mesh3d

Source

pub fn new( vertices: Vec<Vec3>, triangle_indices: Vec<u32>, ) -> Result<Self, Mesh3dError>

Builds a surface mesh without explicit display edges.

Source

pub fn with_display_edges( vertices: Vec<Vec3>, triangle_indices: Vec<u32>, display_edges: Vec<MeshEdge3d>, ) -> Result<Self, Mesh3dError>

Builds a mesh with explicit mathematical display edges.

Construction rejects an empty vertex set, geometry with neither triangles nor display edges, incomplete triangle lists, out-of-range indices, repeated/collinear triangle vertices, duplicate display edges, display edges with coincident endpoints, and display edges outside the vertex array.

Source

pub fn textured( vertices: Vec<Vec3>, texture_coordinates: Vec<TextureCoordinate2d>, triangle_indices: Vec<u32>, display_edges: Vec<MeshEdge3d>, ) -> Result<Self, Mesh3dError>

Builds surfaces with one validated texture coordinate per model vertex.

Duplicate model positions with different UVs are valid for atlas seams. Winding and explicit display edges keep the untextured mesh contract. A texture/material is attached only when uploading or binding to a renderer; constructing this data requires no GPU dependencies.

Source

pub fn vertices(&self) -> &[Vec3]

Returns immutable model-space vertices.

Source

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

Returns the flat host-wound triangle index list.

Source

pub fn display_edges(&self) -> &[MeshEdge3d]

Returns explicit mathematical edges, excluding triangulation diagonals.

Source

pub fn texture_coordinates(&self) -> &[TextureCoordinate2d]

Returns per-vertex normalized UVs, or an empty slice for untextured data.

Source

pub fn triangle_count(&self) -> usize

Returns the number of retained triangles.

Source

pub const fn bounds_min(&self) -> Vec3

Returns the inclusive model-space lower bound.

Source

pub const fn bounds_max(&self) -> Vec3

Returns the inclusive model-space upper bound.

Source

pub fn recovery_memory_bytes(&self) -> usize

Returns retained CPU bytes used by vertices, indices, and display edges.

Trait Implementations§

Source§

impl Clone for Mesh3d

Source§

fn clone(&self) -> Mesh3d

Returns a duplicate of the value. Read more
1.0.0 (const: unstable) · Source§

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

Performs copy-assignment from source. Read more
Source§

impl Debug for Mesh3d

Source§

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

Formats the value using the given formatter. Read more
Source§

impl PartialEq for Mesh3d

Source§

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

Equality operator ==. Read more
1.0.0 (const: unstable) · Source§

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

Inequality operator !=. Read more
Source§

impl StructuralPartialEq for Mesh3d

Auto Trait Implementations§

Blanket Implementations§

Source§

impl<T> Any for T
where T: 'static + ?Sized,

Source§

fn type_id(&self) -> TypeId

Gets the TypeId of self. Read more
Source§

impl<T> Borrow<T> for T
where T: ?Sized,

Source§

fn borrow(&self) -> &T

Immutably borrows from an owned value. Read more
Source§

impl<T> BorrowMut<T> for T
where T: ?Sized,

Source§

fn borrow_mut(&mut self) -> &mut T

Mutably borrows from an owned value. Read more
Source§

impl<ST, DT> CastableFrom<ST, Initialized, Initialized> for DT
where ST: ?Sized, DT: ?Sized,

Source§

impl<ST, DT> CastableFrom<ST, Uninit, Uninit> for DT
where ST: ?Sized, DT: ?Sized,

Source§

impl<T> CloneToUninit for T
where T: Clone,

Source§

unsafe fn clone_to_uninit(&self, dest: *mut u8)

🔬This is a nightly-only experimental API. (clone_to_uninit)
Performs copy-assignment from self to dest. Read more
Source§

impl<T> Downcast<T> for T

Source§

fn downcast(&self) -> &T

Source§

impl<T> From<T> for T

Source§

fn from(t: T) -> T

Returns the argument unchanged.

Source§

impl<T, U> Into<U> for T
where U: From<T>,

Source§

fn into(self) -> U

Calls U::from(self).

That is, this conversion is whatever the implementation of From<T> for U chooses to do.

Source§

impl<T> Read<Exclusive, BecauseExclusive> for T
where T: ?Sized,

Source§

impl<T> ToOwned for T
where T: Clone,

Source§

type Owned = T

The resulting type after obtaining ownership.
Source§

fn to_owned(&self) -> T

Creates owned data from borrowed data, usually by cloning. Read more
Source§

fn clone_into(&self, target: &mut T)

Uses borrowed data to replace owned data, usually by cloning. Read more
Source§

impl<T, U> TryFrom<U> for T
where U: Into<T>,

Source§

type Error = !

The type returned in the event of a conversion error.
Source§

fn try_from(value: U) -> Result<T, !>

Performs the conversion.
Source§

impl<T, U> TryInto<U> for T
where U: TryFrom<T>,

Source§

type Error = <U as TryFrom<T>>::Error

The type returned in the event of a conversion error.
Source§

fn try_into(self) -> Result<U, <U as TryFrom<T>>::Error>

Performs the conversion.
Source§

impl<T> Upcast<T> for T

Source§

fn upcast(&self) -> Option<&T>

Source§

impl<T> WasmNotSend for T
where T: Send,

Source§

impl<T> WasmNotSendSync for T

Source§

impl<T> WasmNotSync for T
where T: Sync,