lib3mf-core 0.4.0

Parse and validate 3MF files for manufacturing workflows - production-ready with streaming parser and comprehensive validation
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
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119

use lib3mf_core::model::{BuildItem, Geometry, Mesh, Model, Object, ObjectType, ResourceId, Unit};
use std::fs::File;

fn main() -> anyhow::Result<()> {
    println!("Creating simple 3MF cube...");

    let mut model = Model {
        unit: Unit::Millimeter,
        ..Default::default()
    };

    // 1. Create a Mesh (Cube)
    let mut mesh = Mesh::new();

    // Add 8 vertices
    // Bottom
    let v0 = mesh.add_vertex(0.0, 0.0, 0.0);
    let v1 = mesh.add_vertex(10.0, 0.0, 0.0);
    let v2 = mesh.add_vertex(10.0, 10.0, 0.0);
    let v3 = mesh.add_vertex(0.0, 10.0, 0.0);
    // Top
    let v4 = mesh.add_vertex(0.0, 0.0, 10.0);
    let v5 = mesh.add_vertex(10.0, 0.0, 10.0);
    let v6 = mesh.add_vertex(10.0, 10.0, 10.0);
    let v7 = mesh.add_vertex(0.0, 10.0, 10.0);

    // Add 12 triangles (2 per face)
    // Bottom
    mesh.add_triangle(v0, v2, v1);
    mesh.add_triangle(v0, v3, v2);
    // Top
    mesh.add_triangle(v4, v5, v6);
    mesh.add_triangle(v4, v6, v7);
    // Front
    mesh.add_triangle(v0, v1, v5);
    mesh.add_triangle(v0, v5, v4);
    // Right
    mesh.add_triangle(v1, v2, v6);
    mesh.add_triangle(v1, v6, v5);
    // Back
    mesh.add_triangle(v2, v3, v7);
    mesh.add_triangle(v2, v7, v6);
    // Left
    mesh.add_triangle(v3, v0, v4);
    mesh.add_triangle(v3, v4, v7);

    // 2. Create Model Object (printable part)
    let object_id = ResourceId(1);
    let object = Object {
        id: object_id,
        object_type: ObjectType::Model, // Printable part - requires manifold mesh
        name: Some("Simple Cube".to_string()),
        part_number: None,
        uuid: None,
        pid: None,
        thumbnail: None,
        pindex: None,
        geometry: Geometry::Mesh(mesh),
    };

    println!(
        "Object type: {} - requires manifold: {}",
        object.object_type,
        object.object_type.requires_manifold()
    );

    // 3. Create Support Object (optional - demonstrates different type)
    let mut support_mesh = Mesh::new();
    // Simple support geometry (can be non-manifold)
    support_mesh.add_vertex(5.0, 5.0, -5.0);
    support_mesh.add_vertex(6.0, 5.0, -5.0);
    support_mesh.add_vertex(5.0, 6.0, -5.0);
    support_mesh.add_triangle(0, 1, 2);

    let support_id = ResourceId(2);
    let support_object = Object {
        id: support_id,
        object_type: ObjectType::Support, // Support structure - non-manifold allowed
        name: Some("Support".to_string()),
        part_number: None,
        uuid: None,
        pid: None,
        thumbnail: None,
        pindex: None,
        geometry: Geometry::Mesh(support_mesh),
    };

    println!(
        "Support type: {} - requires manifold: {}",
        support_object.object_type,
        support_object.object_type.requires_manifold()
    );

    // 4. Add to Resources
    model.resources.add_object(object)?;
    model.resources.add_object(support_object)?;

    // 5. Create Build Items (only model object - supports can be ignored by consumer)
    let item = BuildItem {
        object_id,
        transform: glam::Mat4::IDENTITY,
        part_number: None,
        uuid: None,
        path: None,
        printable: None,
    };
    model.build.items.push(item);

    // 6. Write to file
    let file = File::create("cube.3mf")?;
    model.write(file)?;

    println!("\nWritten to cube.3mf");
    println!("Model contains:");
    println!("  - 1 model object (printable cube)");
    println!("  - 1 support object (removable support)");

    Ok(())
}