A simple command-line program to convert 3mf files to stl files
Switch branches/tags
Nothing to show
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Permalink
Failed to load latest commit information.
.gitignore
LICENSE
Lion_Cookie_Cutter.3mf
Makefile
README.md Fix doc Nov 26, 2017
convert_to_stl.sh
main.cpp
tinyxml2.cpp
tinyxml2.h
triangle.cpp
triangle.h
utils.cpp
utils.h
version.h
vertex_3.cpp
vertex_3.h

README.md

3mf2stl

This is a simple command-line utility to convert 3d ".3mf" files to the ".stl" files used by most 3d printer slicing software.

Build and Install

You will need a working c++ development environment to make this code. You must also install a zip development library, usually available from your repository. For Debian users, that's the "libzip-dev" package. If you wish to use this program successfully, you'll also need the "p7zip" or "p7zip-full" package in order to work around a current bug in the way the Debian zip libraries handle ".3mf" files.

Unzip the source code to an empty directory and type "make". It compiles without errors or warnings on Debian 3.2 ("Sarge") and Debian 8.0 ("Jessie"). This will produce an executable called "3mf2stl".

Using

The current version of the Debian zip libraries won't decompress ".3mf" files, apparently because of a file format dispute between the 3mf folks and the Debian folks. The symptom of this Trouble is the following error message:

Error on [Lion_Cookie_Cutter.3mf] : Multi-disk zip archives not supported

The current work-around is to unzip the .3mf file with p7zip, then re-zip it with the same utility. That produces a zip archive which the Linux zip libraries handle properly. The "convert_to_stl.sh" script automates this process, albeit with minimal error handling. If you type "make test" at the command line, make(1) will run the convert_to_stl.sh script to produce "Lion_Cookie_Cutter.stl". You should be able to import this stl file into the 3d software of your choice and see a funny cookie cutter thing.

This program has a usage message with more details on how to use it. You can see the usage message and version number by typing its name at the command line.

License

This code is based on the work of Shawn Haylaka, which was released to the public domain.

This code is Copyright(c) Charles Shapiro and Shawn Haylaka, October 2016.

This program is free software: you can redistribute it and/or modify
it under the terms of the GNU General Public License as published by
the Free Software Foundation, either version 3 of the License, or
(at your option) any later version.

This program is distributed in the hope that it will be useful,
but WITHOUT ANY WARRANTY; without even the implied warranty of
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
GNU General Public License for more details.

You should have received a copy of the GNU General Public License
along with this program.  If not, see <http://www.gnu.org/licenses/>.

The "tinyxml2.cpp" and "tinyxml2.h" files used in this program were written by Lee Thomason; they have their own licenses which are in the referenced source files.

Contact

Charles Shapiro charles.shapiro@tomshiro.org