← Back to branch summary

~ubuntu-branches/ubuntu/vivid/emscripten/vivid

« back to all changes in this revision

Viewing changes to tests/openjpeg/INSTALL

  • Committer: Package Import Robot
  • Author(s): Sylvestre Ledru
  • Date: 2013-05-02 13:11:51 UTC
  • Revision ID: package-import@ubuntu.com-20130502131151-q8dvteqr1ef2x7xz
Tags: upstream-1.4.1~20130504~adb56cb
Import upstream version 1.4.1~20130504~adb56cb

Show diffs side-by-side

added added

removed removed

Lines of Context:
tests/openjpeg/INSTALL
 
1
 
 
2
How to build and install openjpeg binaries
 
3
==========================================
 
4
 
 
5
UNIX/LINUX similar systems
 
6
--------------------------
 
7
 
 
8
1) Using configure tools
 
9
 
 
10
You can simply type
 
11
  ./configure [--prefix=/path]
 
12
  make
 
13
 
 
14
If you are root:
 
15
  make install
 
16
  make clean
 
17
  make distclean
 
18
 
 
19
else:
 
20
  sudo make install
 
21
  make clean
 
22
  make distclean
 
23
 
 
24
Binaries are located in the 'bin' directory.
 
25
 
 
26
If 'configure' does not work on your system please
 
27
call './bootstrap.sh'.
 
28
 
 
29
If 'configure' does not find a library or header file,
 
30
or to see available configure options, please try 
 
31
'./configure --help'.
 
32
 
 
33
Note: if Doxygen is found on your system, a target 'docs'
 
34
will automatically be created in 'doc/Makefile'. To build
 
35
the documentation (it will create an 'html' directory):
 
36
  cd doc
 
37
        make docs
 
38
 
 
39
2) Using cmake (see www.cmake.org)
 
40
 
 
41
Type:
 
42
  cmake .
 
43
  make
 
44
 
 
45
If you are root:
 
46
  make install
 
47
  make clean
 
48
 
 
49
else:
 
50
  sudo make install
 
51
  make clean
 
52
 
 
53
Binaries are located in the 'bin' directory.
 
54
 
 
55
Main available cmake flags:
 
56
* To specify the install path: '-DCMAKE_INSTALL_PREFIX=/path'
 
57
* To build the shared libraries and links the executables against it: '-DBUILD_SHARED_LIBS:bool=on' (default: 'ON')
 
58
  Note: when using this option, static libraries are not built and executables are dynamically linked.
 
59
* To build the CODEC executables: '-DBUILD_CODEC:bool=on' (default: 'ON')
 
60
* To build the MJ2 executables: '-DBUILD_MJ2:bool=on' (default: 'OFF')
 
61
* To build the JPWL executables and JPWL library: '-DBUILD_JPWL:bool=on' (default: 'OFF')
 
62
* To build the JP3D executables and JP3D library: '-DBUILD_JP3D:bool=on' (default: 'OFF')
 
63
* [WIN32 ONLY] To build the INDEXER_JPIP executable: '-DBUILD_INDEXER_JPIP:bool=on' (default: 'OFF')
 
64
* To build the doxygen documentation: '-DBUILD_DOC:bool=on' (default: 'OFF')
 
65
* To enable testing (and automatic result upload to http://my.cdash.org/index.php?project=OPENJPEG):
 
66
    cmake . -DBUILD_TESTING:BOOL=ON -DJPEG2000_CONFORMANCE_DATA_ROOT:PATH=/path/to/your/JPEG2000/test/files
 
67
    make
 
68
    make Experimental
 
69
  Note : JPEG2000 test files are available here : http://www.crc.ricoh.com/~gormish/jpeg2000conformance/
 
70
 
 
71
3) Manually using Makefile.nix:
 
72
- Manually edit the config.nix file
 
73
- Manually create an opj_config.h file from opj_config.h.in.user
 
74
  and edit this opj_config.h
 
75
- Then : (if 'WITH_JPWL' and/or 'WITH_JP3D' are defined in config.nix)
 
76
    make -f Makefile.nix all
 
77
    make -f Makefile.nix install
 
78
    make -f Makefile.nix clean
 
79
    make -f Makefile.nix uninstall
 
80
- If neither 'WITH_JPWL' nor 'WITH_JP3D' is defined in config.nix
 
81
  and you want to clean/compile/install/uninstall JPWL/JP3D:
 
82
  call the respective target in the respective directory.
 
83
 
 
84
MACOSX
 
85
------
 
86
 
 
87
The same building procedures as above will soon be available for MACOSX.
 
88
The xcode project file has also to be updated.
 
89
Right now, the CMake procedure is the only one working. Please refer to instructions above.
 
90
If it does not work, try adding the following flag to the cmake command : 
 
91
  '-DCMAKE_OSX_ARCHITECTURES:STRING=i386'
 
92
 
 
93
WINDOWS
 
94
-------
 
95
 
 
96
If you're using cygwin, the same procedures as for Unix should work. Otherwise:
 
97
 
 
98
1) Using cmake to generate project files
 
99
 
 
100
Use the cmake procedure above with the '-G <generator-name>' flag to generate the project
 
101
files for the IDE you are using. Type 'cmake --help' for available generators on your platform.
 
102
 
 
103
2) Using the provided project files
 
104
 
 
105
These files are obsolete and will be updated soon.