1 unstable release
0.1.0 | Jul 16, 2024 |
---|
#784 in Parser implementations
8KB
140 lines
STL to 3MF Converter
stlto3mf
is a command line tool written in Rust that merges multiple STL files representing a single object into a single 3MF file. This is especially useful for multi-material 3D printing, saving time and effort when dealing with slicer programs.
Features
- Merge multiple STL files into a single 3MF file.
- Generate a generic 3MF file compatible with any slicer program or 3D viewer that supports the 3MF format.
Requirements
- Rust (for building from source)
Installation
To build from source, you need to have Rust installed. Clone the repository and build the project:
git clone https://github.com/yourusername/stlto3mf.git
cd stlto3mf
cargo run
# or
cargo install --path '.'
The executable will be available in the target/release directory (or in your $PATH)
Usage
stlto3mf [OPTIONS] --output <OUTPUT> [STL_FILES]...
Arguments
-
[STL_FILES]...
List of STL files to merge.
Options
-
--output <OUTPUT>
Name of a group of STLs in the final .3MF file. -
--name <NAME>
Output filename for the 3MF file. -
-h, --help
Print help information. -
-V, --version
Print version information.
Examples
Basic Usage
Merge multiple STL files into a single 3MF file with a specified output name:
stlto3mf --output final_object --name output.3mf part1.stl part2.stl part3.stl
This command will merge part1.stl, part2.stl, and part3.stl into a single output.3mf file, grouping them under final_object.
Help and Version
To print the help information:
stlto3mf --help
To print the version information:
stlto3mf --version
Contributing
Contributions are welcome! Please open an issue or submit a pull request for any improvements or bug fixes. License
License
This project is licensed under the MIT License. See the LICENSE file for details.
Contact
For any questions or support, please open an issue on the GitHub repository or contact michal@papierski.net.
Dependencies
~4.5MB
~81K SLoC