70 lines
2.7 KiB
Plaintext
70 lines
2.7 KiB
Plaintext
|
|
How to build and install openjpeg binaries
|
|
==========================================
|
|
|
|
UNIX/LINUX/MacOSX/Windows systems
|
|
--------------------------
|
|
|
|
Using cmake (see www.cmake.org)
|
|
|
|
Type:
|
|
cmake .
|
|
make
|
|
|
|
If you are root:
|
|
make install
|
|
|
|
else if you have sudo power:
|
|
sudo make install
|
|
|
|
else
|
|
DESTDIR=$HOME/local make install
|
|
|
|
To build the Doxygen documentation (Doxygen needs to be found on the system):
|
|
(A 'html' directory is generated in the 'doc' directory)
|
|
make doc
|
|
|
|
Binaries are located in the 'bin' directory.
|
|
|
|
Main available cmake flags:
|
|
* To specify the install path: '-DCMAKE_INSTALL_PREFIX=/path', or use DESTDIR env variable (see above)
|
|
* To build the shared libraries and links the executables against it: '-DBUILD_SHARED_LIBS:bool=on' (default: 'ON')
|
|
Note: when using this option, static libraries are not built and executables are dynamically linked.
|
|
* To build the CODEC executables: '-DBUILD_CODEC:bool=on' (default: 'ON')
|
|
* To build the documentation: '-DBUILD_DOC:bool=on' (default: 'OFF')
|
|
* To build the MJ2 executables: '-DBUILD_MJ2:bool=on' (default: 'OFF')
|
|
* To build the JPWL executables and JPWL library: '-DBUILD_JPWL:bool=on' (default: 'OFF')
|
|
* To build the JPIP library and utilities: '-DBUILD_JPIP:bool=on' (default: 'OFF')
|
|
** To build the JPIP server: '-DBUILD_JPIP_SERVER:bool=on' (default: 'OFF')
|
|
* To build the JP3D library and utilities: '-DBUILD_JP3D:bool=on' (default: 'OFF') (experimental)
|
|
* To build the Java binding: '-DBUILD_JAVA:bool=on' (default: 'OFF') (experimental).
|
|
** to choose which java implementation, you can set your JAVA_HOME env var.
|
|
* To build the wxWidgets/C++ viewer: 'BUILD_VIEWER:BOOL=ON' (default OFF) (experimental)
|
|
* To enable testing (and automatic result upload to http://my.cdash.org/index.php?project=OPENJPEG):
|
|
cmake . -DBUILD_TESTING:BOOL=ON -DOPJ_DATA_ROOT:PATH='path/to/the/data/directory'
|
|
make
|
|
make Experimental
|
|
Note : JPEG2000 test files are available with 'git clone https://github.com/uclouvain/openjpeg-data.git'.
|
|
If '-DOPJ_DATA_ROOT:PATH' option is omitted, test files will be automatically searched in '${CMAKE_SOURCE_DIR}/../data',
|
|
corresponding to the location of the data directory when compiling from the trunk (and assuming the data directory has
|
|
been checked out of course).
|
|
|
|
MACOSX
|
|
------
|
|
|
|
The same building procedures as above work for MACOSX.
|
|
The xcode project file can also be used.
|
|
|
|
If it does not work, try adding the following flag to the cmake command :
|
|
'-DCMAKE_OSX_ARCHITECTURES:STRING=i386'
|
|
|
|
WINDOWS
|
|
-------
|
|
|
|
You can use cmake to generate project files for the IDE you are using (VS2010, NMake, etc).
|
|
Type 'cmake --help' for available generators on your platform.
|
|
|
|
Make sure to build the third party libs (png, zlib ...):
|
|
|
|
'-DBUILD_THIRDPARTY:BOOL=ON'
|