[trunk] FolderReorgProposal task: update install instruction
Update issue 177
This commit is contained in:
parent
93761d9ab5
commit
1ca5ca8392
73
INSTALL
73
INSTALL
|
@ -2,63 +2,10 @@
|
||||||
How to build and install openjpeg binaries
|
How to build and install openjpeg binaries
|
||||||
==========================================
|
==========================================
|
||||||
|
|
||||||
UNIX/LINUX similar systems
|
UNIX/LINUX/MacOSX/Windows systems
|
||||||
--------------------------
|
--------------------------
|
||||||
|
|
||||||
1) Using autotools
|
Using cmake (see www.cmake.org)
|
||||||
|
|
||||||
It is highly recommended that pkg-config is installed. If needed, you have to
|
|
||||||
properly set the environment variable PKG_CONFIG_PATH so that the .pc files
|
|
||||||
are found.
|
|
||||||
|
|
||||||
To build from top-level directory, you can simply type:
|
|
||||||
./bootstrap.sh
|
|
||||||
./configure
|
|
||||||
make
|
|
||||||
|
|
||||||
To keep all build files in a separate directory, you can type instead:
|
|
||||||
./bootstrap.sh
|
|
||||||
mkdir build
|
|
||||||
cd build
|
|
||||||
../configure
|
|
||||||
make
|
|
||||||
|
|
||||||
To install:
|
|
||||||
sudo make install
|
|
||||||
|
|
||||||
To clean:
|
|
||||||
make clean
|
|
||||||
make distclean
|
|
||||||
|
|
||||||
To build doc (requires 'doxygen' to be found on your system):
|
|
||||||
(this will create an html directory in TOP_LEVEL/doc)
|
|
||||||
make doc
|
|
||||||
|
|
||||||
Main './configure' options (type './configure --help' for more details)
|
|
||||||
'--enable-mj2'
|
|
||||||
'--enable-jpwl'
|
|
||||||
'--enable-jpip'
|
|
||||||
'--prefix=/path/to/install/directory' (example : '--prefix=$PWD/installed')
|
|
||||||
'--enable-debug' (default : disabled)
|
|
||||||
|
|
||||||
You can also specify your own CFLAGS and LDFLAGS with (for example):
|
|
||||||
CFLAGS="-O3 -pipe" LDFLAGS="-Wl,-s" ./configure
|
|
||||||
|
|
||||||
The (optional) dependencies of some binaries are libpng, libtiff, libcms 1 or 2
|
|
||||||
and FastCGI. Only libtiff and FastCGI have no .pc file. There should be some
|
|
||||||
automatic detection if they are installed in /usr, /usr/local or /opt/local.
|
|
||||||
Otherwise, you can tune their detection (as well as for libpng and libcms1 or 2
|
|
||||||
too) with the environment variables:
|
|
||||||
|
|
||||||
TIFF_CFLAGS
|
|
||||||
TIFF_LIBS
|
|
||||||
FCGI_CFLAGS
|
|
||||||
FCGI_LIBS
|
|
||||||
|
|
||||||
See './configure --help' output for more details.
|
|
||||||
|
|
||||||
|
|
||||||
2) Using cmake (see www.cmake.org)
|
|
||||||
|
|
||||||
Type:
|
Type:
|
||||||
cmake .
|
cmake .
|
||||||
|
@ -84,9 +31,15 @@ Main available cmake flags:
|
||||||
* To build the shared libraries and links the executables against it: '-DBUILD_SHARED_LIBS:bool=on' (default: 'ON')
|
* 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.
|
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 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 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 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 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):
|
* 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'
|
cmake . -DBUILD_TESTING:BOOL=ON -DOPJ_DATA_ROOT:PATH='path/to/the/data/directory'
|
||||||
make
|
make
|
||||||
|
@ -99,7 +52,7 @@ Main available cmake flags:
|
||||||
MACOSX
|
MACOSX
|
||||||
------
|
------
|
||||||
|
|
||||||
The same building procedures as above (autotools and cmake) work for MACOSX.
|
The same building procedures as above work for MACOSX.
|
||||||
The xcode project file can also be used.
|
The xcode project file can also be used.
|
||||||
|
|
||||||
If it does not work, try adding the following flag to the cmake command :
|
If it does not work, try adding the following flag to the cmake command :
|
||||||
|
@ -108,7 +61,9 @@ If it does not work, try adding the following flag to the cmake command :
|
||||||
WINDOWS
|
WINDOWS
|
||||||
-------
|
-------
|
||||||
|
|
||||||
If you're using cygwin or MinGW+MSYS, the same procedures as for Unix can be used.
|
You can use cmake to generate project files for the IDE you are using (VS2010, NMake, etc).
|
||||||
|
|
||||||
Otherwise you can use cmake to generate project files for the IDE you are using (VC2010, etc).
|
|
||||||
Type 'cmake --help' for available generators on your platform.
|
Type 'cmake --help' for available generators on your platform.
|
||||||
|
|
||||||
|
Make sure to build the third party libs (png, zlib ...):
|
||||||
|
|
||||||
|
'-DBUILD_THIRDPARTY:BOOL=ON'
|
||||||
|
|
Loading…
Reference in New Issue