Skip to content

Latest commit

 

History

History
68 lines (54 loc) · 2.54 KB

README.md

File metadata and controls

68 lines (54 loc) · 2.54 KB
Raw

3MFMerge

This tool merges a given set of .3mf models into one. Material color of each individual input model is set, based on the filename. It uses Lib3MF to do the work.

Requirements

Lib3MF v2 is used, which is downloaded to the build folder as part of the build process. That means it doesn't have to be manually installed, although an active internet connection is needed during the configuration stage.

The colorscad.sh script expects a binary called '3mfmerge' in the '3mfmerge/bin/' dir, which is the default output location of the build.

How to build

Here is how to compile 3mfmerge. As mentioned, the binary will be produced at 3mfmerge/bin/3mfmerge.

On most systems, the following should work:

mkdir build
cd build
cmake .. -DLIB3MF_TESTS=OFF
cmake --build .

Windows users should make sure that the native version of CMake (>= v3.14) is installed, as well as a recent version of Visual Studio. VS 2015 should work. The Windows build might fail due to some warning-as-error shenanigans in lib3mf, when making a 32-bit build which seems to be the default. To work around that, force a 64-bit build:

cmake .. -DLIB3MF_TESTS=OFF -DCMAKE_GENERATOR_PLATFORM=x64
cmake --build .

Building on non-x86_64-based systems

The currently used version of dependency Lib3MF (v2.1.1) uses AutomaticComponentToolkit 1.6.0 (ACT) as part of its build system. The Lib3MF source includes binaries of ACT for x86_64-based platforms, which obviously won't work if your platform is for instance ARM-based. See also Lib3MF issue 199.

The workaround is, of course, to use another ACT binary that matches your platform. If possible, install ACT (>= v1.6.0) using your platform's favorite package manager. If not available, build ACT from source, which requires Go (golang):

  • clone the ACT repo, check out tag v1.6.0
  • from the root of the ACT repo, run: go build -o act Source/*.go
  • when done, copy or symlink the act binary to e.g. /usr/local/bin/act

With ACT installed, it's time for the workaround:

  • make sure that running act works and shows v1.6.0 or up
  • run the initial cmake .. -DLIB3MF_TESTS=OFF as above
  • replace the act.linux binary: ln -sf $(which act) _deps/lib3mf-src/AutomaticComponentToolkit/bin/act.linux
  • build as usual: cmake --build .

Usage

ls *.3mf | 3mfmerge OUTPUT_FILE

Run 3mfmerge without parameters for more details.