This project contains the source code for all the 3rd party libraries required to build Gaffer. It is intended to help Gaffer developers get up and running as quickly as possible, and secondarily to provide a record of exactly which dependencies were used for each release of Gaffer, and how they were built.
We provide prebuilt binary releases, which should be used in conjunction with Gaffer's build instructions.
We strongly recommend using the precompiled binaries as described above, but if you really like building multiple huge software projects, read on!
Since the build covers so many different projects, it requires the installation of several common software development tools, most of which should be installed by default on a typical developer machine. They include (but are probably not limited to) :
- Make
- CMake
- SCons
- libbz2 (and headers)
See https://github.com/GafferHQ/build for a Docker container which contains all necessary prerequisites.
The build is controlled by several environment variables, which must be set up before running :
- ARNOLD_ROOT : Path to the root of an Arnold installation
- RMAN_ROOT : Path to the root of a 3delight installation
The build is then initiated with build.py, which should be run from the root directory of the project :
./build.py --buildDir /path/to/build
Subsets of the dependencies can be built using the --projects command line argument :
./build.py --buildDir /path/to/build --projects TBB
Variants are specified using the --variant:<Project> command line arguments :
./build.py --buildDir /path/to/build --variants:Python 3