Blob Blame History Raw
ABOUT THE OPENEXR LIBRARIES
----------------------------

IlmImf is our "EXR" file format for storing 16-bit FP images.  Libraries in
this package depend on the IlmBase library.

See the IlmImfExamples directory for some code that demonstrates how
to use the IlmImf library to read and write OpenEXR files.  The doc
directory contains some high-level documentation and history about the
OpenEXR format.

If you have questions about using the OpenEXR libraries, you may want
to join our developer mailing list.  See http://www.openexr.com for
details.


LICENSE
-------

The OpenEXR source code distribution is free software.  See the file
named COPYING (included in this distribution) for details.


BUILDING OPENEXR
----------------

Building OpenEXR requires the IlmBase and the zlib library.

You can obtain the source code for zlib from:

   http://www.zlib.net

If you're building OpenEXR on a Windows platform, see README.win32 for
instructions on how to build OpenEXR.  The remainder of this file
applies only to GNU/Linux or other UNIX-like systems.

After installing the required libraries, to build OpenEXR on
GNU/Linux or other UNIX-like systems, do this:

./configure
make
make install

unless you obtained IlmBase directly from git, in which case you
should first read README.git


Please type :

./configure --help

for a list of options in relation to building IlmBase libraries. In 
particular, peruse README.namespaces for information regarding the 
use of namespaces in IlmBase and OpenEXR.

See README.OSX for details on building OpenEXR in MacOS X.

Do `make check` to run the OpenEXR confidence tests.  They should all
pass; if you find a test that does not pass on your system, please let
us know.

Other UNIX variants haven't been tested, but should be easy to build.
Let us know if you're having problems porting OpenEXR to a particular
platform.

All include files needed to use the OpenEXR libraries are installed in the 
OpenEXR subdirectory of the install prefix, e.g. /usr/local/include/OpenEXR.


USING OPENEXR IN YOUR APPLICATIONS
----------------------------------

On systems with support for pkg-config, use `pkg-config --cflags
OpenEXR` for the C++ flags required to compile against OpenEXR
headers; and `pkg-config --libs OpenEXR` for the linker flags required
to link against OpenEXR libraries.