Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/alembic/alembic

Alembic is an open framework for storing and sharing scene data that includes a C++ library, a file format, and client plugins and applications.
https://github.com/alembic/alembic

Last synced: about 9 hours ago
JSON representation

Alembic is an open framework for storing and sharing scene data that includes a C++ library, a file format, and client plugins and applications.

Awesome Lists containing this project

README 

        
-------------------------------------------------------------------------------

- Alembic

-

- Copyright 2009-2021 Sony Pictures Imageworks, Inc. and

- Industrial Light and Magic, a division of Lucasfilm Entertainment Company Ltd.

-------------------------------------------------------------------------------



Installation instructions for Alembic



0) Before Alembic can be built, you will need to satisfy its external

dependencies:



Required:



    CMake (3.13+) www.cmake.org

    C++ compiler that supports C++11

    Imath 3 https://github.com/AcademySoftwareFoundation/Imath

    OR

    OpenEXR (2.2.0+) www.openexr.com (for Imath)



Optional:



    HDF5 (1.8.9) www.hdfgroup.org/HDF5

    Boost (1.55+) www.boost.org (to build the python bindings)

    PyImath 3 https://github.com/AcademySoftwareFoundation/Imath (to build the python bindings)

    OR

    pyilmbase (1.0.0+) (to build the python bindings)

    Arnold (3.3+)

    Pixar PRMan (15.x)

    Autodesk Maya (2012+)



Note that the versions given parenthetically above are minimum-tested

versions.  You may have good luck with later or earlier versions, but this is

what we've been building Alembic against.



They may be installed in their default system locations (typically somewhere

under /usr/local), or some other centralized directory at your discretion; it's

best not to install your dependencies under the Alembic source root.



1) Clone the Alembic repo source into your desired source root:



    $ git clone https://github.com/alembic/alembic []



This will create your source root directory that contains the Alembic source

code.



2) Run the cmake command. You should create a separate build root and pass the

source root to cmake:



    $ cd 

    $ cmake  [OPTIONS] 



Some examples of OPTIONS you may want or need to use include:



    -DALEMBIC_SHARED_LIBS=OFF  If you want the primary Alembic library to be

    built as a static library, instead of a dynamic one.



    -DUSE_HDF5=ON

    Specify this if you want to include optional HDF5 support.

    -DHDF_ROOT=HDF5Path may need to be specified if HDF5 is not installed in

    a standard location.



    -DUSE_MAYA=ON If you want to build AbcExport and AbcImport.

    -DMAYA_ROOT=MayaPath may need to be specified to point at a specific

    installation of Maya.



    -G "Visual Studio 15 2017 Win64"  If you want to create the project file for

    the 64 bit build of Alembic with the Visual Studio 2017 Community Edition.



    -DCMAKE_INSTALL_PREFIX=customPath  If you want to install the Alembic into

    an arbitrary location.



    -DUSE_PYALEMBIC=ON Whether you want to build the boost python bindings for Alembic.



    -DPYALEMBIC_PYTHON_MAJOR=2  If you want to look for python 2 (or python 3) via find_package.

    See the [CMake module documentation](https://cmake.org/cmake/help/latest/module/FindPython3.html).



    -DDOCS_PATH=customDocPath  If you have Doxygen installed this will create and install the doxygen

    generated doc (WIP) to customDocPath when you run: cmake doxygen



3)  To build: cmake -build .



4) To test: ctest

   Note:  On Windows you may need to add the path to your Alembic dlls.

   PATH=%PATH%;location of Alembic dlls (and OpenExr if not in a standard place)



If you get stuck, contact us on the alembic-discussion mailing list. You can

view the mailing list archives and join the mailing list:



http://groups.google.com/group/alembic-discussion