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