diff options
| author | Antonin Descampe <antonin@gmail.com> | 2010-10-05 10:33:15 +0000 |
|---|---|---|
| committer | Antonin Descampe <antonin@gmail.com> | 2010-10-05 10:33:15 +0000 |
| commit | eeefefd56cb3edddefb73141733fd1e757c4b798 (patch) | |
| tree | 4727958764c4c348762c043c2efbb7470a9ffcca /INSTALL | |
| parent | 531c0cf26f0c327b42a5caa79725e4afeb98768d (diff) | |
Added files to let people build openjpeg with configure tools ; Added makefiles to let people manually build openjpeg on *nix platforms ; Removed obsolete Makefiles ; Renamed dirent.h to windirent.h ; Made optional the PNG, TIFF, and LCMS support in CMake files ; Added opj_config* files to configure openjpeg before building it (opj_config.h generated by configure, cmake, or manually by the user) ; Renamed this file from ChangeLog to CHANGES ; Renamed License.txt to LICENSE ; Updated README files ; Added INSTALL and LICENSE files ; Added man pages
Diffstat (limited to 'INSTALL')
| -rw-r--r-- | INSTALL | 93 |
1 files changed, 93 insertions, 0 deletions
diff --git a/INSTALL b/INSTALL new file mode 100644 index 00000000..b14fb395 --- /dev/null +++ b/INSTALL @@ -0,0 +1,93 @@ + +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'. + +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. + +Main available cmake flags: +* To specify the install path: '-DCMAKE_INSTALL_PREFIX=/path' +* To build the shared libraries: '-DBUILD_SHARED_LIBS:bool=on' +* To build the example codec: '-DBUILD_EXAMPLES:bool=on' (default is actually 'ON') +* To build the JPWL binaries: '-DBUILD_JPWL:bool=on' +* To build the JP3D binaries: '-DBUILD_JP3D:bool=on' +* To build the doxygen documentation: '-DBUILD_DOCUMENTATION:bool=on' +* 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 +- Then : (remove the unwanted targets) + make -f Makefile.nix all jpwl-all jp3d-all doc-all + make -f Makefile.nix clean jpwl-clean jp3d-clean doc-clean + make -f Makefile.nix install jpwl-install jp3d-install + make -f Makefile.nix uninstall jpwl-uninstall jp3d-uninstall + + +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. |
