Glenn Randers-Pehrson | 08a3343 | 1998-03-07 06:06:55 -0600 | [diff] [blame] | 1 | |
Glenn Randers-Pehrson | db66d44 | 2000-06-23 21:38:16 -0500 | [diff] [blame^] | 2 | Installing libpng version 1.0.7beta17 - June 24, 2000 |
Glenn Randers-Pehrson | 08a3343 | 1998-03-07 06:06:55 -0600 | [diff] [blame] | 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 |
Glenn Randers-Pehrson | 5c6aeb2 | 1998-12-29 11:47:59 -0600 | [diff] [blame] | 8 | zlib, but you will still need to have access to the |
Glenn Randers-Pehrson | 08a3343 | 1998-03-07 06:06:55 -0600 | [diff] [blame] | 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 |
Glenn Randers-Pehrson | db66d44 | 2000-06-23 21:38:16 -0500 | [diff] [blame^] | 13 | might be called "libpng-1.0.7beta17" or "lpng107" and "zlib-1.1.3" |
Glenn Randers-Pehrson | 5c6aeb2 | 1998-12-29 11:47:59 -0600 | [diff] [blame] | 14 | or "zlib113") so that you have directories called "zlib" and "libpng". |
Glenn Randers-Pehrson | 08a3343 | 1998-03-07 06:06:55 -0600 | [diff] [blame] | 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 |
Glenn Randers-Pehrson | 860ab2b | 1999-10-14 07:43:10 -0500 | [diff] [blame] | 24 | contrib |
| 25 | gregbook |
Glenn Randers-Pehrson | d436672 | 2000-06-04 14:29:29 -0500 | [diff] [blame] | 26 | msvctest |
Glenn Randers-Pehrson | 6d8f3b0 | 1999-10-23 08:39:18 -0500 | [diff] [blame] | 27 | pngminus |
| 28 | pngsuite |
Glenn Randers-Pehrson | db66d44 | 2000-06-23 21:38:16 -0500 | [diff] [blame^] | 29 | visupng |
Glenn Randers-Pehrson | d436672 | 2000-06-04 14:29:29 -0500 | [diff] [blame] | 30 | msvc |
Glenn Randers-Pehrson | 08a3343 | 1998-03-07 06:06:55 -0600 | [diff] [blame] | 31 | scripts |
| 32 | makefile.* |
| 33 | pngtest.png |
| 34 | etc. |
| 35 | zlib |
| 36 | README |
| 37 | *.h |
| 38 | *.c |
| 39 | contrib |
| 40 | etc. |
| 41 | |
Glenn Randers-Pehrson | 61c32d9 | 2000-02-04 23:40:16 -0600 | [diff] [blame] | 42 | If the line endings in the files look funny, you may wish to get the other |
| 43 | distribution of libpng. It is available in both tar.gz (UNIX style line |
| 44 | endings) and zip (DOS style line endings) formats. |
| 45 | |
Glenn Randers-Pehrson | db66d44 | 2000-06-23 21:38:16 -0500 | [diff] [blame^] | 46 | If you are building libpng with MSVC, you can enter the libpng\msvc directory |
| 47 | and follow the instructions in msvc\README.txt. |
Glenn Randers-Pehrson | d436672 | 2000-06-04 14:29:29 -0500 | [diff] [blame] | 48 | |
Glenn Randers-Pehrson | db66d44 | 2000-06-23 21:38:16 -0500 | [diff] [blame^] | 49 | Else enter the zlib directory and follow the instructions in zlib/README, |
| 50 | then come back here and choose the appropriate makefile.sys in the scripts |
Glenn Randers-Pehrson | 520a764 | 2000-03-21 05:13:06 -0600 | [diff] [blame] | 51 | directory. |
Glenn Randers-Pehrson | db66d44 | 2000-06-23 21:38:16 -0500 | [diff] [blame^] | 52 | |
Glenn Randers-Pehrson | 08a3343 | 1998-03-07 06:06:55 -0600 | [diff] [blame] | 53 | The files that are presently available in the scripts directory |
| 54 | include |
| 55 | |
Glenn Randers-Pehrson | 520a764 | 2000-03-21 05:13:06 -0600 | [diff] [blame] | 56 | makefile.std => Generic UNIX makefile (cc, creates static libpng.a) |
Glenn Randers-Pehrson | db66d44 | 2000-06-23 21:38:16 -0500 | [diff] [blame^] | 57 | makefile.linux => Linux/ELF makefile (gcc, creates libpng.so.2.1.0.7beta17) |
| 58 | makefile.gcmmx => Linux/ELF makefile (gcc, creates libpng.so.2.1.0.7beta17, |
Glenn Randers-Pehrson | 520a764 | 2000-03-21 05:13:06 -0600 | [diff] [blame] | 59 | uses assembler code tuned for Intel MMX platform) |
| 60 | makefile.gcc => Generic makefile (gcc, creates static libpng.a) |
Glenn Randers-Pehrson | 860ab2b | 1999-10-14 07:43:10 -0500 | [diff] [blame] | 61 | makefile.knr => Archaic UNIX Makefile that converts files with |
| 62 | ansi2knr (Requires ansi2knr.c from |
| 63 | ftp://ftp.cs.wisc.edu/ghost) |
| 64 | makefile.dec => DEC Alpha UNIX makefile |
| 65 | makefile.hpux => HPUX (10.20 and 11.00) makefile |
Glenn Randers-Pehrson | 68ea243 | 2000-04-01 21:10:05 -0600 | [diff] [blame] | 66 | 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] | 67 | makefile.intel => Intel C/C++ version 4.0 and later |
Glenn Randers-Pehrson | 68ea243 | 2000-04-01 21:10:05 -0600 | [diff] [blame] | 68 | libpng.icc => Project file for IBM VisualAge/C++ version 4.0 or later |
Glenn Randers-Pehrson | 520a764 | 2000-03-21 05:13:06 -0600 | [diff] [blame] | 69 | makefile.sgi => Silicon Graphics IRIX makefile (cc, creates static lib) |
Glenn Randers-Pehrson | db66d44 | 2000-06-23 21:38:16 -0500 | [diff] [blame^] | 70 | makefile.sggcc => Silicon Graphics (gcc, creates libpng.so.2.1.0.7beta17) |
Glenn Randers-Pehrson | 860ab2b | 1999-10-14 07:43:10 -0500 | [diff] [blame] | 71 | makefile.sunos => Sun makefile |
Glenn Randers-Pehrson | db66d44 | 2000-06-23 21:38:16 -0500 | [diff] [blame^] | 72 | makefile.solaris => Solaris 2.X makefile (gcc, creates libpng.so.2.1.0.7beta17) |
Glenn Randers-Pehrson | 860ab2b | 1999-10-14 07:43:10 -0500 | [diff] [blame] | 73 | makefile.sco => For SCO OSr5 ELF and Unixware 7 with Native cc |
| 74 | makefile.mips => MIPS makefile |
| 75 | makefile.acorn => Acorn makefile |
| 76 | makefile.amiga => Amiga makefile |
| 77 | smakefile.ppc => AMIGA smakefile for SAS C V6.58/7.00 PPC compiler |
| 78 | (Requires SCOPTIONS, copied from scripts/SCOPTIONS.ppc) |
| 79 | makefile.atari => Atari makefile |
| 80 | makefile.beos => BEOS makefile for X86 |
Glenn Randers-Pehrson | 520a764 | 2000-03-21 05:13:06 -0600 | [diff] [blame] | 81 | makefile.bor => Borland makefile (uses bcc) |
| 82 | makefile.bc32 => 32-bit Borland C++ (all modules compiled in C mode) |
Glenn Randers-Pehrson | 61c32d9 | 2000-02-04 23:40:16 -0600 | [diff] [blame] | 83 | makefile.bd32 => To make a png32bd.dll with Borland C++ 4.5 |
Glenn Randers-Pehrson | 520a764 | 2000-03-21 05:13:06 -0600 | [diff] [blame] | 84 | makefile.tc3 => Turbo C 3.0 makefile |
Glenn Randers-Pehrson | 860ab2b | 1999-10-14 07:43:10 -0500 | [diff] [blame] | 85 | makefile.dj2 => DJGPP 2 makefile |
| 86 | makefile.msc => Microsoft C makefile |
| 87 | 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] | 88 | assembler code tuned for Intel MMX platform) |
Glenn Randers-Pehrson | 860ab2b | 1999-10-14 07:43:10 -0500 | [diff] [blame] | 89 | makefile.vcwin32 => makefile for Microsoft Visual C++ 4.0 and later (does |
| 90 | not use assembler code) |
Glenn Randers-Pehrson | 860ab2b | 1999-10-14 07:43:10 -0500 | [diff] [blame] | 91 | makefile.os2 => OS/2 Makefile (gcc and emx, requires pngos2.def) |
| 92 | pngos2.def => OS/2 module definition file used by makefile.os2 |
| 93 | makefile.watcom => Watcom 10a+ Makefile, 32-bit flat memory model |
| 94 | makevms.com => VMS build script |
Glenn Randers-Pehrson | 520a764 | 2000-03-21 05:13:06 -0600 | [diff] [blame] | 95 | descrip.mms => VMS makefile for MMS or MMK |
Glenn Randers-Pehrson | 860ab2b | 1999-10-14 07:43:10 -0500 | [diff] [blame] | 96 | pngdef.pas => Defines for a png32bd.dll with Borland C++ 4.5 |
| 97 | SCOPTIONS.ppc => Used with smakefile.ppc |
Glenn Randers-Pehrson | 08a3343 | 1998-03-07 06:06:55 -0600 | [diff] [blame] | 98 | |
| 99 | Copy the file (or files) that you need from the |
| 100 | scripts directory into this directory, for example |
| 101 | |
Glenn Randers-Pehrson | 860ab2b | 1999-10-14 07:43:10 -0500 | [diff] [blame] | 102 | MSDOS example: copy scripts\makefile.msc makefile |
Glenn Randers-Pehrson | 08a3343 | 1998-03-07 06:06:55 -0600 | [diff] [blame] | 103 | UNIX example: cp scripts/makefile.std makefile |
| 104 | |
| 105 | Read the makefile to see if you need to change any source or |
| 106 | target directories to match your preferences. |
| 107 | |
| 108 | Then read pngconf.h to see if you want to make any configuration |
| 109 | changes. |
| 110 | |
| 111 | Then just run "make test" which will create the libpng library in |
| 112 | this directory and run a quick test that reads the "pngtest.png" |
| 113 | file and writes a "pngout.png" file that should be identical to it. |
Glenn Randers-Pehrson | 860ab2b | 1999-10-14 07:43:10 -0500 | [diff] [blame] | 114 | Look for "9782 zero samples" in the output of the test. For more |
| 115 | confidence, you can run another test by typing "pngtest pngnow.png" |
Glenn Randers-Pehrson | 6d8f3b0 | 1999-10-23 08:39:18 -0500 | [diff] [blame] | 116 | and looking for "289 zero samples" in the output. Also, you can |
| 117 | run "pngtest -m *.png" in the "contrib/pngsuite" directory and compare |
| 118 | your output with the result shown in contrib/pngsuite/README. |
Glenn Randers-Pehrson | 08a3343 | 1998-03-07 06:06:55 -0600 | [diff] [blame] | 119 | |
| 120 | Most of the makefiles will allow you to run "make install" to |
| 121 | put the library in its final resting place (if you want to |
| 122 | do that, run "make install" in the zlib directory first if necessary). |
| 123 | |
| 124 | Further information can be found in the README and libpng.txt |
Glenn Randers-Pehrson | 6d8f3b0 | 1999-10-23 08:39:18 -0500 | [diff] [blame] | 125 | files, in the individual makefiles, in png.h, and the manual pages |
| 126 | libpng.3 and png.5. |