107 lines
3.4 KiB
Plaintext
107 lines
3.4 KiB
Plaintext
|
|
How to build and install openjpeg binaries
|
|
==========================================
|
|
|
|
UNIX/LINUX similar systems
|
|
--------------------------
|
|
|
|
1) Using configure tools
|
|
|
|
You can simply type
|
|
./configure [--prefix=/path]
|
|
make
|
|
|
|
If you are root:
|
|
make install
|
|
make clean
|
|
make distclean
|
|
|
|
else:
|
|
sudo make install
|
|
make clean
|
|
make distclean
|
|
|
|
Binaries are located in the 'bin' directory.
|
|
|
|
If 'configure' does not work on your system please
|
|
call './bootstrap.sh'.
|
|
|
|
If 'configure' does not find a library or header file,
|
|
or to see available configure options, please try
|
|
'./configure --help'.
|
|
|
|
Note: if Doxygen is found on your system, a target 'docs'
|
|
will automatically be created in 'doc/Makefile'. To build
|
|
the documentation (it will create an 'html' directory):
|
|
cd doc
|
|
make docs
|
|
|
|
2) Using cmake (see www.cmake.org)
|
|
|
|
Type:
|
|
cmake .
|
|
make
|
|
|
|
If you are root:
|
|
make install
|
|
make clean
|
|
|
|
else:
|
|
sudo make install
|
|
make clean
|
|
|
|
Binaries are located in the 'bin' directory.
|
|
Executables are always statically linked.
|
|
|
|
Main available cmake flags:
|
|
* To specify the install path: '-DCMAKE_INSTALL_PREFIX=/path'
|
|
* To build the shared libraries: '-DBUILD_SHARED_LIBS:bool=on' (default: 'ON')
|
|
Note: when using this option, shared libraries are built but executables remain linked against the corresponding static libraries.
|
|
* To build the CODEC executables: '-DBUILD_CODEC:bool=on' (default: 'ON')
|
|
* 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 JP3D executables and JP3D library: '-DBUILD_JP3D:bool=on' (default: 'OFF')
|
|
* [WIN32 ONLY] To build the INDEXER_JPIP executable: '-DBUILD_INDEXER_JPIP:bool=on' (default: 'OFF')
|
|
* To build the doxygen documentation: '-DBUILD_DOC:bool=on' (default: 'OFF')
|
|
* To enable testing (and automatic result upload to http://my.cdash.org/index.php?project=OPENJPEG):
|
|
cmake . -DBUILD_TESTING:BOOL=ON -DJPEG2000_CONFORMANCE_DATA_ROOT:PATH=/path/to/your/JPEG2000/test/files
|
|
make
|
|
make Experimental
|
|
Note : JPEG2000 test files are available here : http://www.crc.ricoh.com/~gormish/jpeg2000conformance/
|
|
|
|
3) Manually using Makefile.nix:
|
|
- Manually edit the config.nix file
|
|
- Manually create an opj_config.h file from opj_config.h.in.user
|
|
and edit this opj_config.h
|
|
- Then : (if 'WITH_JPWL' and/or 'WITH_JP3D' are defined in config.nix)
|
|
make -f Makefile.nix all
|
|
make -f Makefile.nix install
|
|
make -f Makefile.nix clean
|
|
make -f Makefile.nix uninstall
|
|
- If neither 'WITH_JPWL' nor 'WITH_JP3D' is defined in config.nix
|
|
and you want to clean/compile/install/uninstall JPWL/JP3D:
|
|
call the respective target in the respective directory.
|
|
|
|
MACOSX
|
|
------
|
|
|
|
The same building procedures as above will soon be available for MACOSX.
|
|
The xcode project file has also to be updated.
|
|
Right now, the CMake procedure is the only one working. Please refer to instructions above.
|
|
If it does not work, try adding the following flag to the cmake command :
|
|
'-DCMAKE_OSX_ARCHITECTURES:STRING=i386'
|
|
|
|
WINDOWS
|
|
-------
|
|
|
|
If you're using cygwin, the same procedures as for Unix should work. Otherwise:
|
|
|
|
1) Using cmake to generate project files
|
|
|
|
Use the cmake procedure above with the '-G <generator-name>' flag to generate the project
|
|
files for the IDE you are using. Type 'cmake --help' for available generators on your platform.
|
|
|
|
2) Using the provided project files
|
|
|
|
These files are obsolete and will be updated soon.
|