Skip to content

Building Mosaic

Daan de Lange edited this page May 16, 2022 · 1 revision

The easiest way to get started using Mosaic is by downloading the precompiled binary which is distributed for each release.
However, you might want to build it yourself (and maybe even contribute to the codebase!).
This wiki page will help you trough the build process.

Automatic Installation

The Mosaic-Installer will install everything almost automatically; we recommend using it to save time. (excepted on osx?)

Manual Installation

Openframeworks

Mosaic relies on OpenFrameworks (in fact it's an OpenFrameworks project itself) so you need to install it before.

You can either download OpenFrameworks as a release distribution (simpler) or compile it by cloning the github repo (advanced users). If you're not familiar with OpenFrameworks, we recommend the first approach.

Please refer to the OpenFrameworks getting started guides to install OpenFrameworks. Some ofxAddons used by Mosaic also need some custom installation steps.

Mosaic

Please follow the mosaic installation guide which can be found here and here.

Building Mosaic

Mosaic can either be compiled using the make build system, a platform dependent developper IDE (Xcode, QtCreator, VSCode, etc.). Please refer to the IDE-specific-guide of your choice on the OpenFrameworks website.
Releases are build with [fill-me].

QtCreator

Qt creator works great on Linux/Mac and is a nice alternative editor and compiler, between makefiles and a full-featured IDE.

When opening Mosaic.qbs for the first time, Qt prompts you to configure the project. In order to run the produced binary, Qt needs to fix the rpath of dynamic libs, and we made a script for that, you can add it as a build step like so : sh ../fixDynamicLibs_debug.sh.
image

You can also setup a Profiling build.

Clone this wiki locally