]> git.jsancho.org Git - lugaru.git/blob - libpng-1.2.8/INSTALL
Link against non-SSE2 libGLU.
[lugaru.git] / libpng-1.2.8 / INSTALL
1
2 Installing libpng version 1.2.8 - December 3, 2004
3
4 Before installing libpng, you must first install zlib.  zlib
5 can usually be found wherever you got libpng.  zlib can be
6 placed in another directory, at the same level as libpng.
7 Note that your system might already have a preinstalled
8 zlib, but you will still need to have access to the
9 zlib.h and zconf.h include files that correspond to the
10 version of zlib that's installed.
11
12 You can rename the directories that you downloaded (they
13 might be called "libpng-1.2.8" or "lpng109" and "zlib-1.2.1"
14 or "zlib121") so that you have directories called "zlib" and "libpng".
15
16 Your directory structure should look like this:
17
18    ..       (the parent directory)
19       libpng  (this directory)
20           INSTALL (this file)
21           README
22           *.h
23           *.c
24           contrib
25              gregbook
26              pngminus
27              pngsuite
28              visupng
29           projects
30              beos
31              c5builder (Borland)
32              visualc6 (msvc)
33              netware.txt
34              wince.txt
35           scripts
36              makefile.*
37           pngtest.png
38           etc.
39       zlib
40           README
41           *.h
42           *.c
43           contrib
44           etc.
45
46 If the line endings in the files look funny, you may wish to get the other
47 distribution of libpng.  It is available in both tar.gz (UNIX style line
48 endings) and zip (DOS style line endings) formats.
49
50
51 If you are building libpng with MSVC, you can enter the
52 libpng projects\visualc6 directory and follow the instructions in
53 projects\visualc6\README.txt.
54
55 You can build libpng for WindowsCE by downloading and installing
56 the projects\wince directory as instructed in the projects\wince.txt file, and
57 then following the instructions in the README* files.  Similarly, you can
58 build libpng for Netware or Beos as instructed in projects\netware.txt
59 or projects\beos.
60
61 Else enter the zlib directory and follow the instructions in zlib/README,
62 then come back here and choose the appropriate makefile.sys in the scripts
63 directory.
64
65 The files that are presently available in the scripts directory
66 include
67
68  makefile.std      =>  Generic UNIX makefile (cc, creates static libpng.a)
69  makefile.elf      =>  Linux/ELF makefile symbol versioning,
70                        gcc, creates libpng12.so.0.1.2.8)
71  makefile.linux    =>  Linux/ELF makefile
72                        (gcc, creates libpng12.so.0.1.2.8)
73  makefile.gcmmx    =>  Linux/ELF makefile
74                        (gcc, creates libpng12.so.0.1.2.8,
75                        uses assembler code tuned for Intel MMX platform)
76  makefile.gcc      =>  Generic makefile (gcc, creates static libpng.a)
77  makefile.knr      =>  Archaic UNIX Makefile that converts files with
78                        ansi2knr (Requires ansi2knr.c from
79                        ftp://ftp.cs.wisc.edu/ghost)
80  makefile.aix      =>  AIX/gcc makefile
81  makefile.cygwin   =>  Cygwin/gcc makefile
82  makefile.darwin   =>  Darwin makefile, can use on MacosX
83  makefile.dec      =>  DEC Alpha UNIX makefile
84  makefile.freebsd  =>  FreeBSD makefile
85  makefile.hpgcc    =>  HPUX makefile using gcc
86  makefile.hpux     =>  HPUX (10.20 and 11.00) makefile
87  makefile.hp64     =>  HPUX (10.20 and 11.00) makefile, 64-bit
88  makefile.ibmc     =>  IBM C/C++ version 3.x for Win32 and OS/2 (static)
89  makefile.intel    =>  Intel C/C++ version 4.0 and later
90  libpng.icc        =>  Project file for IBM VisualAge/C++ version 4.0 or later
91  makefile.netbsd   =>  NetBSD/cc makefile, uses PNGGCCRD, makes libpng.so.
92  makefile.ne12bsd  =>  NetBSD/cc makefile, uses PNGGCCRD,
93                        makes libpng12.so
94  makefile.openbsd  =>  OpenBSD makefile
95  makefile.sgi      =>  Silicon Graphics IRIX makefile (cc, creates static lib)
96  makefile.sggcc    =>  Silicon Graphics (gcc,
97                        creates libpng12.so.0.1.2.8)
98  makefile.sunos    =>  Sun makefile
99  makefile.solaris  =>  Solaris 2.X makefile (gcc,
100                        creates libpng12.so.0.1.2.8)
101  makefile.so9      =>  Solaris 9 makefile (gcc,
102                        creates libpng12.so.0.1.2.8)
103  makefile.32sunu   =>  Sun Ultra 32-bit makefile
104  makefile.64sunu   =>  Sun Ultra 64-bit makefile
105  makefile.sco      =>  For SCO OSr5  ELF and Unixware 7 with Native cc
106  makefile.mips     =>  MIPS makefile
107  makefile.acorn    =>  Acorn makefile
108  makefile.amiga    =>  Amiga makefile
109  smakefile.ppc     =>  AMIGA smakefile for SAS C V6.58/7.00 PPC compiler
110                        (Requires SCOPTIONS, copied from scripts/SCOPTIONS.ppc)
111  makefile.atari    =>  Atari makefile
112  makefile.beos     =>  BEOS makefile for X86
113  makefile.bor      =>  Borland makefile (uses bcc)
114  makefile.bc32     =>  32-bit Borland C++ (all modules compiled in C mode)
115  makefile.tc3      =>  Turbo C 3.0 makefile
116  makefile.dj2      =>  DJGPP 2 makefile
117  makefile.msc      =>  Microsoft C makefile
118  makefile.vcawin32 =>  makefile for Microsoft Visual C++ 5.0 and later (uses
119                        assembler code tuned for Intel MMX platform)
120  makefile.vcwin32  =>  makefile for Microsoft Visual C++ 4.0 and later (does
121                        not use assembler code)
122  makefile.os2      =>  OS/2 Makefile (gcc and emx, requires pngos2.def)
123  pngos2.def        =>  OS/2 module definition file used by makefile.os2
124  makefile.watcom   =>  Watcom 10a+ Makefile, 32-bit flat memory model
125  makevms.com       =>  VMS build script
126  descrip.mms       =>  VMS makefile for MMS or MMK
127  SCOPTIONS.ppc     =>  Used with smakefile.ppc
128
129 Copy the file (or files) that you need from the
130 scripts directory into this directory, for example
131
132    MSDOS example: copy scripts\makefile.msc makefile
133    UNIX example:    cp scripts/makefile.std makefile
134
135 Read the makefile to see if you need to change any source or
136 target directories to match your preferences.
137
138 Then read pngconf.h to see if you want to make any configuration
139 changes.
140
141 Then just run "make" which will create the libpng library in
142 this directory and "make test" which will run a quick test that reads
143 the "pngtest.png" file and writes a "pngout.png" file that should be
144 identical to it.  Look for "9782 zero samples" in the output of the
145 test.  For more confidence, you can run another test by typing
146 "pngtest pngnow.png" and looking for "289 zero samples" in the output.
147 Also, you can run "pngtest -m contrib/pngsuite/*.png" and compare
148 your output with the result shown in contrib/pngsuite/README.
149
150 Most of the makefiles will allow you to run "make install" to
151 put the library in its final resting place (if you want to
152 do that, run "make install" in the zlib directory first if necessary).
153 Some also allow you to run "make test-installed" after you have
154 run "make install".
155
156 If you encounter a compiler error message complaining about the
157 lines
158       __png.h__ already includes setjmp.h;
159       __dont__ include it again.;
160 This means you have compiled another module that includes setjmp.h,
161 which is hazardous because the two modules might not include exactly
162 the same setjmp.h.  If you are sure that you know what you are doing
163 and that they are exactly the same, then you can comment out or
164 delete the two lines.  Better yet, use the cexcept interface
165 instead, as demonstrated in contrib/visupng of the libpng distribution.
166
167 Further information can be found in the README and libpng.txt
168 files, in the individual makefiles, in png.h, and the manual pages
169 libpng.3 and png.5.