Struct AsciiStlExporter 

pub struct AsciiStlExporter;

Exports 3MF Model structures to ASCII STL files.

Each mesh object in the model’s build items is written as a separate ASCII STL solid. Face normals are computed from the triangle edges using the cross product.

Implementations

impl AsciiStlExporter

pub fn write<W: Write>(model: &Model, writer: W) -> Result<()>

Writes a 3MF Model to ASCII STL format.

Each mesh object referenced in the model’s build items is written as a separate solid ... endsolid block. The solid name is taken from the object’s name field, or left empty if the object has no name.

Arguments

• model - The 3MF model to export
• writer - Any type implementing Write to receive ASCII STL text

Returns

Ok(()) on successful export.

Errors

Returns Lib3mfError::Io if any write operation fails.

Format Details

• Normals: Computed via cross product of triangle edges (normalize_or_zero())
• Degenerate triangles: Emit zero normal (0 0 0), triangle is not skipped
• Normal format: Scientific notation with 6 decimal places ({:.6e})
• Vertex format: Fixed-point with 6 decimal places ({:.6})
• Transformations: Build item transforms are applied to vertex coordinates
• Solid names: Taken from object.name, empty string if None

Examples

use lib3mf_converters::stl::AsciiStlExporter;
use lib3mf_core::model::Model;
use std::fs::File;

let output = File::create("exported.stl")?;
AsciiStlExporter::write(&model, output)?;

pub fn write_with_resolver<W: Write, A: ArchiveReader>( model: &Model, resolver: PartResolver<'_, A>, writer: W, ) -> Result<()>

Writes a 3MF Model to ASCII STL format with support for multi-part 3MF files.

Resolves component references and external model parts using a PartResolver, then writes all collected triangles as a single ASCII STL solid.

Arguments

• model - The root 3MF model to export
• resolver - A PartResolver for loading external model parts from the 3MF archive
• writer - Any type implementing Write to receive ASCII STL text

Returns

Ok(()) on successful export.

Errors

Returns [Lib3mfError::Io] if any write operation fails. Returns errors from the resolver if external parts cannot be loaded.