| 2 |
- |
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.
|