Skip to content

GafferHQ/gaffer

Folders and files

NameName
Last commit message
Last commit date
Jun 1, 2015
May 1, 2015
May 13, 2015
Apr 2, 2014
Apr 23, 2015
Jan 22, 2015
May 19, 2015
Jun 2, 2015
May 19, 2015
May 28, 2015
Jun 2, 2015
May 27, 2015
Apr 24, 2013
May 12, 2015
Jun 2, 2015
Nov 7, 2013
Dec 21, 2014
Jun 2, 2015

Repository files navigation

Gaffer

Gaffer is an open source application framework designed specifically for creating tools for use in visual effects production. It builds on top of the Cortex libraries, adding a flexible node-based computation framework and a user interface framework for editing and viewing node graphs. Gaffer ships with a number of sample modules and applications, not least of which is a module for the on-demand generation of procedural scenes for rendering.

More information can be found on the project homepage: http://imageengine.github.io/gaffer

Developer notes are available on the project wiki.

Downloading

Compiled binary releases are available for download from the releases page.

Building

Build Status

Gaffer is a fairly large project, and as such has a fairly complex build process. Before you start, you’ll want to make sure you have the following prerequisites installed on your system - these will be used to perform the build itself :

Gaffer also depends on a number of 3rd party libraries and python modules, many of which are not entirely straightforward to build. We therefore recommend using the latest prebuilt dependencies from the gafferDependencies project. These are used in our automated test builds and so are guaranteed to be up to date with Gaffer’s requirements.

Once you’ve downloaded the dependencies, you’ll want to unpack them and move/rename them to the directory in which you want to make your Gaffer build. We’ll refer to this location as <BUILD_DIR> in the instructions below - before continuing make sure the dependencies are unpacked as <BUILD_DIR>/include, <BUILD_DIR>/lib etc.

Next, get yourself a clone of the Gaffer source and change into that directory :

git clone https://github.com/ImageEngine/gaffer.git
cd gaffer

You can then build Gaffer itself as follows :

scons BUILD_DIR=<BUILD_DIR> build

If you encounter any problems, please get in touch via the developer mailing list and we’ll do our best to help get you up and running.

Contributing

Contributions to Gaffer are welcome. For small fixes we suggest just going ahead and making a pull request - for anything larger we recommend dicussing it on the developer list first, to avoid duplication of effort and to ensure that your whizz-bang ideas fit in with the general direction of the project.

© 2013, Image Engine Design Inc. © 2013, John Haddon under the BSD license