Alembic is a new open-source computer graphics interchange framework being developed by Sony Imageworks and ILM. The basic idea is that moving animation rigs and data and whatnot between packages can be a very tricky procedure since every package has its own way to handle animation, so why not bake out all of that animation data into a common interchange format? So, for example, instead of having to import a Maya rig into Houdini, you could rig/animate in Maya, bake out the animation to Alembic, bring that into Houdini to conduct simulations with, and then bake out the animation and bring it back into Maya. This is a trend that a number of studios including Sony, ILM, Pixar, etc. have been moving toward for some time.

I’ve been working on a project lately (more on that later) that makes use of Alembic, but I found that the only way to actually get Alembic is to build it from source. That’s not terribly difficult, but there’s not really any guides out there for folks who might not be as comfortable with building things from source. So, I wrote up a little guide!

Here’s how to build Alembic for OSX (10.6 and 10.7):

1. Alembic has a lot of dependencies that can be annoying to build/install by hand, so we’re going to cheat and use Homebrew. To install Homebrew:

1. Get/build/install cmake with Homebrew:

1. Get/build/install Boost with Homebrew:

1. Get/build/install HDF5 with Homebrew:

1. Unfortunately, ilmbase is not a standard UNIX package, so we can’t use Homebrew. We’ll have to build ilmbase manually. Get it from:

`/Half/Makefile
/HalfTest/Makefile
/Iex/Makefile
/IexTest/Makefile
/IlmThread/Makefile
/Imath/Makefile
/ImathTest/Makefile`

1. Time to actually build Alembic. Get the source tarball from:

   http://code.google.com/p/alembic/wiki/GettingAlembic

   Untar/unzip into a readily accessible directory and then create a build root directory parallel to the source root you just created:

   mkdir ALEMBIC_BUILD

   The build root doesn’t necesarily have to be parallel, but here we’ll assume it is for the sake of consistency.

2. Now cd into ALEMBIC_BUILD and bootstrap the Alembic build process. The bootstrap script is a python script:

   python ../[Your Alembic Source Root]/build/bootstrap/alembic_bootstrap.py

   The script will ask you for a whole bunch of paths:

   For “Please enter the location where you would like to build the Alembic”, enter the full path to your ALEMBIC_BUILD directory.

   For “Enter the path to lexical_cast.hpp:”, enter the full path to your lexical_cast.hpp, which should be something like /usr/local/include/boost/lexical_cast.hpp

   For “Enter the path to libboost_thread:”, your path should be something like /usr/local/lib/libboost_thread-mt.a For “Enter the path to zlib.h”, your path should be something like /usr/include/zlib.h

   For “Enter the path to libz.a”, we’re actually not going to link against libz.a. We’ll be using libz.dylib instead, which should be at something like /usr/lib/libz.dylib

   For “Enter the path to hdf5.h”, your path should be something like /usr/local/include/hdf5.h

   For “Enter the path to libhdf5.a”, your path should be something like /usr/local/Cellar/hdf5/1.x.x/lib/libhdf5.a (unless you did not use Homebrew for installing hdf5, in which case libhdf5.a will be in whatever lib directory you installed it to)

   For “Enter the path to ImathMath.h”, your path should be something like /usr/local/include/OpenEXR/ImathMath.h

   For “Enter the path to libImath.a”, your path should be something like /usr/local/lib/libImath.a

   Now hit enter, and let the script finish running!

3. If everything is bootstrapped correctly, you can now make. This will take a while, be patient.

4. Once the make finishes successfully, run make test to check for any problems.

5. Finally, run make install, and we’re done! Alembic should install to something like /usr/bin/alembic-1.x.x/.