COMP: Fixing configuration for static builds. Fixing dependencies that several
[openjpeg.git] / README.linux
1
2 # **************************************************
3 # NOTE : This README is obsolete. We strongly
4 # recommend using the cmake tool (see README.cmake)
5 # to build openJPEG.
6 # **************************************************
7
8
9 Release Notes
10 --------------
11 This version of the library has been tested under the following OS:
12 - RedHat Linux 9.0
13
14 You should be able to link progams with the -lopenjpeg option after the library is compiled and installed. 
15 You can also statically link with libopenjpeg.a.
16 If you use a really old version of gcc and it chokes on the CRs in the file, you can type 'make dos2unix'
17 to run all of the files through dos2unix which converts CRLF to LF.  This no longer appears to be required
18 for RedHat 7.3 or 9.
19
20 Please let us know how this works for you under other Linux distributions or any other *nix.
21
22 Installation
23 ------------
24 Note: You will need to have root privileges in order to install the library in
25 /usr/include and /usr/lib directories.
26 The installation process is as simple as this : 
27 1) Enter the OpenJPEG directory
28 2) Build the distribution : 
29 make
30 make install
31 3) Clean all files produced during the build process
32 make clean
33
34 Simple codec compilation
35 ------------------------
36 Once you've built the library, you might want to test it with a basic codec. To do this, go to the codec directory and use one of the following commands to build an encoder and decoder respectively:
37
38 gcc convert.c image_to_j2k.c -o image_to_j2k -lopenjpeg -I ../libopenjpeg/ -lm -ltiff
39 gcc convert.c j2k_to_image.c -o j2k_to_image -lopenjpeg -I ../libopenjpeg/ -lm -ltiff
40
41 You should add '-L..' to those lines if you did not use the 'install' target (and the 'clean' target neither...).