This is a simple demonstration of how a software vendor or studio can add extensions to Gaffer.
By following the instructions below, you should be able to compile, install, and run Gaffer with your custom extension.
Note : The DemoGafferExtension is basically a no-op, and is intended as a starting point for those writing a real extension. You should expect to rename folders, files, and classes as appropriate.
Requires:
- cmake
- Gaffer Install
In a terminal:
setenv GAFFER_ROOT <gaffer install path>
setenv DEMO_INSTALL_PREFIX <your extension install path>
mkdir gafferExtensionDemo/cmake-build-default
cd gafferExtensionDemo/cmake-build-default
cmake -DGAFFER_ROOT=$GAFFER_ROOT -DCMAKE_INSTALL_PREFIX=$DEMO_INSTALL_PREFIX -DPYTHON_VERSION=2.7 ..
make install -j <num cores>
Now that you've installed the extension to $DEMO_INSTALL_PREFIX
, you need to tell Gaffer about it:
setenv GAFFER_EXTENSION_PATHS '$DEMO_INSTALL_PREFIX:$GAFFER_EXTENSION_PATHS'
Next, test your install:
gaffer test DemoGafferExtensionTest DemoGafferExtensionUITest
Now run gaffer
as normal.