sc-mesh-formats 0.0.7

A library to load, inspect & write 3d mesh data.
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58

/*
 * SPDX-FileCopyrightText: 2026 MyMiniFactory Ltd
 * SPDX-License-Identifier: Apache-2.0
 */

mod stla;
mod stlb;
mod writers;

use anyhow::Result;
use sc_mesh_core::TriangleIterator;
use sc_mesh_core::scene::Scene;

use stla::AsciiStlReader;
use stlb::BinaryStlReader;

pub use writers::{write_stla, write_stlb};

pub fn read_stl<R>(read: &mut R) -> Result<Scene>
where
    R: std::io::Read + std::io::Seek,
{
    let is_ascii = AsciiStlReader::probe(read)?;

    let metadata = if is_ascii {
        AsciiStlReader::extract_metadata(read)
    } else {
        BinaryStlReader::extract_metadata(read)
    }?;

    let mut stl_reader = if is_ascii {
        AsciiStlReader::create_triangles_iterator(read)
    } else {
        BinaryStlReader::create_triangles_iterator(read)
    }?;

    stl_reader.as_indexed_mesh(Some(metadata)).map(Scene::from)
}

pub fn read_stla<R>(read: &mut R) -> Result<Scene>
where
    R: std::io::Read + std::io::Seek,
{
    let metadata = AsciiStlReader::extract_metadata(read)?;
    AsciiStlReader::create_triangles_iterator(read)?
        .as_indexed_mesh(Some(metadata))
        .map(Scene::from)
}

pub fn read_stlb<R>(read: &mut R) -> Result<Scene>
where
    R: std::io::Read + std::io::Seek,
{
    let metadata = BinaryStlReader::extract_metadata(read)?;
    BinaryStlReader::create_triangles_iterator(read)?
        .as_indexed_mesh(Some(metadata))
        .map(Scene::from)
}