A library for storing voxel data on disk and in memory.
C++ Python C Other
Latest commit 071129f Oct 13, 2016 @magnusw magnusw committed on GitHub Merge pull request #93 from r4f4/fix-big-endian
Fallback to HDF5 in case of big endian architectures.
Permalink
Failed to load latest commit information.
apps Adding MIP offset calculation. Bumping version to 1.7.1 Feb 16, 2016
cmake Change the way ILMBase is located. Use module approach instead of solely Nov 7, 2010
contrib/maya_plugin/exportF3d Fixed the missing flag "addFalloff" to maya syntax thanks to Lisur Nov 12, 2012
export Disable Ogawa on big-endian systems. Bumped version to 1.7.2. Jun 19, 2016
include Latest production code as of 8/25/15. Feb 16, 2016
man Add basic man page for f3dinfo. Nov 12, 2011
src Fallback to HDF5 in case of big endian architectures. Oct 13, 2016
test Added a short sleep to the SparseFieldIO thread spin. Updated lib_per… Feb 16, 2016
.gitignore Updated gitignore with residual SCons files and build folders. Feb 3, 2012
BuildSupport.py Ogawa code now has correct include paths. New Field3DFile compiles bu… Feb 16, 2016
CHANGES Added CMake makefile. (contributed by Nicholas Yue) Apr 21, 2010
CMakeLists.txt Adding 'include' dir to CMakeLists.txt Apr 15, 2016
COPYING Tiny change to copyright statement - Adding "Inc" to company name. Jan 27, 2010
ExampleSite.py Added CMake makefile. (contributed by Nicholas Yue) Apr 21, 2010
Field3D.doxyfile Doxygen: Only run on export/ and src/ Feb 3, 2012
README No change. Jul 7, 2014
SConscript Removed old debug printout. Sep 14, 2010
SConstruct Added CMake makefile. (contributed by Nicholas Yue) Apr 21, 2010
ogawaToF3D.sh Ogawa code now has correct include paths. New Field3DFile compiles bu… Feb 16, 2016

README

------------------------------------------------------------------------
  ABOUT THE FIELD3D LIBRARY
------------------------------------------------------------------------

Field3D is an open source library for storing voxel data. It provides C++ 
classes that handle in-memory storage and a file format based on HDF5 that 
allows the C++ objects to be written to and read from disk.

The majority of the documentation is available in the project Wiki at 
https://sites.google.com/site/field3d/

------------------------------------------------------------------------
  LICENSE
------------------------------------------------------------------------

The Field3D source code is distributed under the "New BSD" license.
See the file called COPYING for details.

------------------------------------------------------------------------
  PACKAGES
------------------------------------------------------------------------

On MacOS X, MacPorts provides a package that downloads, compiles and
installs Field3d into /opt/local (by default).  The installation files
for MacPorts can be found at http://www.macports.org/ .

After installing MacPorts, just type:

> sudo port install field3d

------------------------------------------------------------------------
  FIELD3D DEPENDENCIES
------------------------------------------------------------------------

Field3D was originally developed under CentOS. It has also been tested
under MacOS X Leopard.

The make system used by Field3D is SCons. You will need to install it
before compiling Field3D if you want to use the supplied setup.
More information about SCons is available at: http://www.scons.org/

The libraries required for Field3D are:

  boost (1.34.0)
  IlmBase (1.0.1)
  HDF5 (1.8.x)

Boost can be downloaded from 
  http://www.boost.org/

More information about HDF5 can be found at: 
  http://www.hdfgroup.org/HDF5/

Field3D has only been compiled and tested using the IlmBase 1.0.1, 
though earlier versions of the combined OpenEXR, which included the
Imath library, may also work.
More information about IlmBase/OpenEXR can be found at: 
  http://www.openexr.com/

To use a math library other than Imath - see the section USING A 
CUSTOM MATH LIBRARY below.

------------------------------------------------------------------------
  BUILDING FIELD3D
------------------------------------------------------------------------

Field3D was originally developed under CentOS. It has also been tested
under MacOS X Leopard.

By default, Field3D will look in your platform's standard directories 
for include files and libraries. If your libraries reside elsewhere,
refer to the CUSTOMIZING THE BUILD ENVIRONMENT section below.

If you are compiling on an untested platform, you may need to extend the
"systemIncludePaths" and "systemLibPaths" dictionaries in the file
called BuildSupport.py. 

To build Field3D, go to the root directory and type "scons". This will
build a shared and a static library and place them in the "install"
folder. By default an optimized/release build is created.

To build a debug version, type "scons debug=1".

To build a 64-bit version, type "scons do64=1".

------------------------------------------------------------------------
  CUSTOMIZING THE BUILD ENVIRONMENT
------------------------------------------------------------------------

Field3D will look in your platform's standard directories for include
files and libraries. If you need to add further library paths, include
paths etc., add a "Site.py" file in the root directory. 

The file ExampleSite.py can be used for reference.

------------------------------------------------------------------------
  USING A CUSTOM MATH LIBRARY
------------------------------------------------------------------------

The "Site.py" file can be used to change the math library used by
Field3D. The only current requirement is that the other library is
syntactically equivalent to Imath. At Sony Imageworks, the Imath library
is wrapped in an "SPI" namespace - the ExampleSite.py and SpiMathLib.h 
files shows an example of how to configure it.

------------------------------------------------------------------------
  AUTHORS
------------------------------------------------------------------------

Original development at Sony Pictures Imageworks:

  Magnus Wrenninge
  Chris Allen
  Sosh Mirsepassi
  Stephen Marshall
  Chris Burdorf
  Henrik Falt
  Scot Shinderman
  Doug Bloom

Contributors:

  Nicholas Yue, Dr. D Studios (CMake setup)

------------------------------------------------------------------------
  QUESTIONS AND COMMENTS
------------------------------------------------------------------------

For questions and/or comments, please join the field3d-dev discussion
group at Google Groups. http://groups.google.com/group/field3d-dev

The project web page URL is: https://sites.google.com/site/field3d/