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