| 1 | |
| 2 | Installing libpng version 1.0.3 - January 14, 1999 |
| 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.0.3" or "lpng103" and "zlib-1.1.3" |
| 14 | or "zlib113") 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 | scripts |
| 25 | makefile.* |
| 26 | pngtest.png |
| 27 | etc. |
| 28 | zlib |
| 29 | README |
| 30 | *.h |
| 31 | *.c |
| 32 | contrib |
| 33 | etc. |
| 34 | |
| 35 | First enter the zlib directory and follow the instructions |
| 36 | in zlib/README. Then come back here and choose the |
| 37 | appropriate makefile.sys in the scripts directory. |
| 38 | The files that are presently available in the scripts directory |
| 39 | include |
| 40 | |
| 41 | descrip.mms => VMS makefile for MMS or MMK |
| 42 | makefile.std => Generic UNIX makefile |
| 43 | makefile.knr => Archaic UNIX Makefile that converts files with ansi2knr |
| 44 | makefile.dec => DEC Alpha UNIX makefile |
| 45 | makefile.hux => HPUX (10.20 and 11.00) makefile |
| 46 | makefile.sgi => Silicon Graphics IRIX makefile |
| 47 | makefile.sun => Sun makefile |
| 48 | makefile.s2x => Solaris 2.X makefile (gcc, creates libpng.so.2.1.0) |
| 49 | makefile.lnx => Linux/ELF makefile (gcc, creates libpng.so.2.1.0) |
| 50 | makefile.mip => MIPS makefile |
| 51 | makefile.aco => Acorn makefile |
| 52 | makefile.ama => Amiga makefile |
| 53 | smakefile.ppc => AMIGA smakefile for SAS C V6.58/7.00 PPC compiler |
| 54 | (Requires SCOPTIONS, copied from scripts/SCOPTIONS.ppc) |
| 55 | makefile.atr => Atari makefile |
| 56 | makefile.bor => Borland makefile |
| 57 | build.bat => MS-DOS batch file for Borland compiler |
| 58 | makefile.dj2 => DJGPP 2 makefile |
| 59 | makefile.msc => Microsoft C makefile |
| 60 | makefile.w32 => makefile for Microsoft Visual C++ 4.0 and later |
| 61 | makefile.tc3 => Turbo C 3.0 makefile |
| 62 | makefile.os2 => OS/2 Makefile (gcc and emx, requires pngos2.def) |
| 63 | pngos2.def => OS/2 module definition file used by makefile.os2 |
| 64 | makefile.wat => Watcom 10a+ Makefile, 32-bit flat memory model |
| 65 | makevms.com => VMS build script |
| 66 | pngdll.mak => To make a png32bd.dll with Borland C++ 4.5 |
| 67 | pngdef.pas => Defines for a png32bd.dll with Borland C++ 4.5 |
| 68 | |
| 69 | Copy the file (or files) that you need from the |
| 70 | scripts directory into this directory, for example |
| 71 | |
| 72 | MSDOS example: copy scripts\makefile.msd makefile |
| 73 | UNIX example: cp scripts/makefile.std makefile |
| 74 | |
| 75 | Read the makefile to see if you need to change any source or |
| 76 | target directories to match your preferences. |
| 77 | |
| 78 | Then read pngconf.h to see if you want to make any configuration |
| 79 | changes. |
| 80 | |
| 81 | Then just run "make test" which will create the libpng library in |
| 82 | this directory and run a quick test that reads the "pngtest.png" |
| 83 | file and writes a "pngout.png" file that should be identical to it. |
| 84 | |
| 85 | Most of the makefiles will allow you to run "make install" to |
| 86 | put the library in its final resting place (if you want to |
| 87 | do that, run "make install" in the zlib directory first if necessary). |
| 88 | |
| 89 | Further information can be found in the README and libpng.txt |
| 90 | files, in the individual makefiles, and in png.h, and the manual |
| 91 | pages libpng.3 and png.5. |