Struct StlImporter 

pub struct StlImporter;

Imports binary STL files into 3MF Model structures.

The importer reads binary STL format and creates a single mesh object with ResourceId(1). Vertices are deduplicated using bitwise float comparison during import.

Implementations

impl StlImporter

pub fn new() -> Self

Creates a new STL importer instance.

pub fn read<R: Read>(reader: R) -> Result<Model>

Reads a binary STL file and converts it to a 3MF Model.

Arguments

• reader - Any type implementing Read containing binary STL data

Returns

A Model containing:

• Single mesh object with ResourceId(1) named “STL Import”
• All triangles from the STL file
• Deduplicated vertices (using bitwise float comparison)
• Single build item referencing the mesh object

Errors

Returns Lib3mfError::Io if:

• Cannot read 80-byte header
• Cannot read triangle count
• Cannot read triangle data (normals, vertices, attribute bytes)

Returns Lib3mfError::Validation if triangle count field cannot be parsed.

Format Details

• Vertex deduplication: Uses HashMap with bitwise float comparison [x.to_bits(), y.to_bits(), z.to_bits()] as key. Only exactly identical vertices (bitwise) are merged.
• Normal vectors: Read from STL but ignored (not stored in Model).
• Attribute bytes: Read but ignored (2-byte field after each triangle).

Examples

use lib3mf_converters::stl::StlImporter;
use std::fs::File;

let file = File::open("cube.stl")?;
let model = StlImporter::read(file)?;

// Access the imported mesh
let obj = model.resources.get_object(lib3mf_core::model::resources::ResourceId(1))
    .expect("STL import creates object with ID 1");
if let lib3mf_core::model::Geometry::Mesh(mesh) = &obj.geometry {
    println!("Imported {} vertices, {} triangles",
        mesh.vertices.len(), mesh.triangles.len());
}

Trait Implementations

impl Default for StlImporter

fn default() -> Self

Returns the “default value” for a type.