lib3mf-core

Parse and validate 3MF files for manufacturing workflows - production-ready with streaming parser and comprehensive validation.

Quick Start

Add to your Cargo.toml:

[dependencies]
lib3mf-core = "0.1"

Parse a 3MF file:

use lib3mf_core::Model;

fn main() -> Result<(), Box<dyn std::error::Error>> {
    let model = Model::from_file("model.3mf")?;
    let stats = model.compute_stats()?;
    println!("Triangles: {}", stats.geometry.triangle_count);
    Ok(())
}

Examples

Parse and Validate

use lib3mf_core::{Model, validation::ValidationLevel};

let model = Model::from_file("model.3mf")?;
let report = model.validate(ValidationLevel::Standard)?;

if report.has_errors() {
    for error in report.errors() {
        eprintln!("Error: {}", error);
    }
}

Streaming Parser (Large Files)

use lib3mf_core::parser::parse_model_streaming;
use lib3mf_core::streaming::StatsVisitor;

let mut visitor = StatsVisitor::new();
parse_model_streaming(reader, &mut visitor)?;
println!("Vertices: {}", visitor.vertex_count());

Write 3MF

use lib3mf_core::{Model, writer::write_model};

let model = create_model()?;
write_model(&model, "output.3mf")?;

Geometry Repair

use lib3mf_core::model::repair::{MeshRepair, RepairOptions};

let repaired = model.repair_geometry(&RepairOptions::default())?;
println!("Stitched {} vertices", repaired.vertices_merged);

Why lib3mf-rs?

• Production-ready: Comprehensive validation system with 4 levels (Minimal/Standard/Strict/Paranoid)
• Zero unsafe code: Memory-safe by design
• Comprehensive testing: 90%+ test coverage, fuzzing infrastructure, property-based tests
• Feature flags: Minimal dependencies by default, add crypto/parallel/png-validation as needed
• Complete spec support: All 9 official 3MF extensions (Materials, Slicing, Security, Boolean Ops, Displacement, etc.)
• Conformance tested: 86% pass rate on 3MF Consortium official test suite

Feature Flags

# Minimal (default)
lib3mf-core = "0.1"

# With parallel processing
lib3mf-core = { version = "0.1", features = ["parallel"] }

# All features
lib3mf-core = { version = "0.1", features = ["full"] }

Ecosystem

lib3mf-rs is a multi-crate workspace:

Specification Compliance

Implements 3MF specifications:

• Core Specification v1.4.0
• Beam Lattice Extension v1.2.0
• Boolean Operations Extension v1.1.1
• Displacement Extension v1.0.0
• Materials and Properties Extension v1.2.1
• Production Extension v1.1.2
• Secure Content Extension v1.0.2
• Slice Extension v1.0.2
• Volumetric Extension v0.8.0

Documentation

• API Reference (docs.rs)
• User Guide
• Examples

Performance

Benchmarks on M1 Mac with 3MB test file:

• Parse: 15ms (200 MiB/s)
• Validate (Standard): 18ms
• Validate (Paranoid): 45ms
• Write: 12ms

See benchmarks for detailed metrics.

License

MIT OR Apache-2.0