Skip to content

3MFConsortium/lib3mf

Repository files navigation

lib3mf

Build Status Documentation Status Version 2.3.0-alpha Supported platforms Simplified BSD License codecov

lib3mf is a C++ implementation of the 3D Manufacturing Format file standard.

It provides 3MF reading and writing capabilities, as well as conversion and validation tools for input and output data. lib3mf runs on Windows, Linux and MacOS and offers a clean and easy-to-use API in various programming languages to speed up the development and keep integration costs at a minimum.

As 3MF shall become an universal 3D Printing standard, its quick adoption is very important. This library shall lower all barriers of adoption to any possible user, let it be software providers, hardware providers, service providers or middleware tools.

The specification can be downloaded at http://3mf.io/specification/.

Documentation

lib3mf's documentation is available on https://lib3mf.readthedocs.io.

Obtaining lib3mf

Simply download the precompiled binary SDK https://github.com/3MFConsortium/lib3mf/releases.

Using lib3mf

Allthough the different language bindings are kept as similar as possible, the usage of lib3mf still depends your programming language.

You are best-off starting with one of the examples distributed in the SDK or with this minimal example in C++.

Contributing

lib3mf is an open source project and supported by the 3MF Consortium.

Contributions are welcome and we are always looking for people that improve the implementation of the specification and extensions of 3MF. Have a look at the contributor's guide for details. This page also contains a section about building lib3mf from source or obtaining nightly snapshot builds.

Licenses and third party code

lib3mf is released under the BSD license. The library contains code of the following third parties:

  1. libzip 1.10.1, https://libzip.org/license/
  2. zlib 1.3.0, http://www.zlib.net/zlib_license.html
  3. cpp-base64 2.rc.08, https://github.com/ReneNyffenegger/cpp-base64/blob/master/LICENSE
  4. fast-float v6.0.0, https://github.com/fastfloat/fast_float/tree/v6.0.0?tab=License-3-ov-file

In addition, the automated tests of lib3mf make uses of LibReSSL 3.8.2, License and googletest 1.14.0 License.