Struct Mesh 

pub struct Mesh {
    pub positions: Vec<f32>,
    pub indices: Vec<u32>,
    pub colors: Vec<u8>,
    pub parts: u32,
    pub fields: Vec<Field>,
    pub faces: Option<(u32, u32)>,
}

Triangles (or points when indices is empty) in model coordinates.

Fields

positions: Vec<f32>

x, y, z per vertex.

indices: Vec<u32>

Three vertex indices per triangle; empty for a point cloud.

colors: Vec<u8>

r, g, b per vertex – empty, or three bytes for every vertex.

parts: u32

Number of bodies / objects (for the status line of the viewer).

fields: Vec<Field>

Scalar result fields, one value per vertex (simulation results).

faces: Option<(u32, u32)>

A partial preview: (faces shown, faces in the file) – STEP files whose B-rep the kernel could tessellate only in part.

Implementations

impl Mesh

pub fn vertex_count(&self) -> usize

pub fn triangle_count(&self) -> usize

pub fn is_point_cloud(&self) -> bool

pub fn append(&mut self, other: Mesh)

Appends other (indices are shifted; colours are filled in so that either every vertex or none has a colour).

pub fn append_placed( &mut self, other: &Mesh, place: impl Fn([f64; 3]) -> [f64; 3], )

Appends the geometry of other with every vertex moved by place: what Mesh::append does with a placed copy of other, without making that copy first (an assembly places the same part many times). Indices are shifted and colours filled in the same way; result fields and the partial-preview note belong to one file and are not carried over.

pub fn check(&self) -> Result<()>

Validates the mesh: finite coordinates, indices in range, limits.

pub fn bounds(&self) -> [f32; 6]

Bounding box [min x, min y, min z, max x, max y, max z].

pub fn encode(&self) -> Vec<u8>

The binary form read by shared/js/viewer.js:

0   "TCMESH01"
8   u32 vertices   12  u32 indices   16  u32 parts
20  u32 flags (1 = colours, 2 = fields, 4 = partial preview)
24  f32 × 6 bounding box
48  f32 × 3·vertices, u32 × indices, u8 × 3·vertices (colours, padded to 4 bytes)
    only with flag 2, after that:
    u32 field count, then per field
    u32 n, n bytes name (UTF-8), u32 m, m bytes unit, padding to 4 bytes,
    f32 min, f32 max, f32 × vertices (NaN = no value)
with flag 4, the last 8 bytes of the file: u32 faces shown, u32 faces in the file

Viewers that do not know flag 2 ignore the field section; meshes with fields also carry the first field as colours for them. The face count sits at the very end, so viewers that do not know flag 4 – and the field section in between – are not affected.

pub fn bake_colors(&mut self)

Sets the colours from the first field (for viewers that do not know fields); vertices without a value are neutral.

pub fn decode(data: &[u8]) -> Result<Mesh>

Reads Mesh::encode output (tests, tools). Every size is checked, so a damaged cache file is an error, not a panic.

Trait Implementations

impl Clone for Mesh

fn clone(&self) -> Self

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for Mesh

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

Formats the value using the given formatter.

impl Default for Mesh

fn default() -> Self

Returns the “default value” for a type.

impl PartialEq for Mesh

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

Equality operator ==.

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

Inequality operator !=.

impl StructuralPartialEq for Mesh