blob: 6df4c0beae89f1671de07e8bbd723163c81bd9b4 [file] [log] [blame]
Glenn Randers-Pehrson08a33431998-03-07 06:06:55 -06001
Glenn Randers-Pehrson0f7202f1998-03-08 18:52:15 -06002Installing libpng version 1.0.0 March 8, 1998
Glenn Randers-Pehrson08a33431998-03-07 06:06:55 -06003
4Before installing libpng, you must first install zlib. zlib
5can usually be found wherever you got libpng. zlib can be
6placed in another directory, at the same level as libpng.
7Note that your system might already have a preinstalled
8zlib, but you will still need to have access to the
9zlib.h and zconf.h include files that correspond to the
10version of zlib that's installed.
11
12You can rename the directories that you downloaded (they
Glenn Randers-Pehrson0f7202f1998-03-08 18:52:15 -060013might be called "libpng-1.0.0 or "lpng100" and "zlib-1.1.1"
Glenn Randers-Pehrson08a33431998-03-07 06:06:55 -060014or "zlib111") so that you have directories called "zlib" and "libpng".
15
16Your 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
35First enter the zlib directory and follow the instructions
36in zlib/README. Then come back here and choose the
37appropriate makefile.sys in the scripts directory.
38The files that are presently available in the scripts directory
39include
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.sgi => Silicon Graphics IRIX makefile
46 makefile.sun => Sun makefile
Glenn Randers-Pehrson0f7202f1998-03-08 18:52:15 -060047 makefile.s2x => Solaris 2.X makefile (gcc, creates libpng.so.2.1.0)
48 makefile.lnx => Linux/ELF makefile (gcc, creates libpng.so.2.1.0)
Glenn Randers-Pehrson08a33431998-03-07 06:06:55 -060049 makefile.mip => MIPS makefile
50 makefile.aco => Acorn makefile
51 makefile.ama => Amiga makefile
Glenn Randers-Pehrson0f7202f1998-03-08 18:52:15 -060052 smakefile.ppc => AMIGA smakefile for SAS C V6.58/7.00 PPC compiler
53 (Requires SCOPTIONS, copied from scripts/SCOPTIONS.ppc)
Glenn Randers-Pehrson08a33431998-03-07 06:06:55 -060054 makefile.atr => Atari makefile
55 makefile.bor => Borland makefile
56 build.bat => MS-DOS batch file for Borland compiler
57 makefile.dj2 => DJGPP 2 makefile
58 makefile.msc => Microsoft C makefile
59 makefile.tc3 => Turbo C 3.0 makefile
60 makefile.os2 => OS/2 Makefile (gcc and emx, requires pngos2.def)
61 pngos2.def => OS/2 module definition file used by makefile.os2
62 makefile.wat => Watcom 10a+ Makefile, 32-bit flat memory model
63 makevms.com => VMS build script
64
65Copy the file (or files) that you need from the
66scripts directory into this directory, for example
67
68 MSDOS example: copy scripts\makefile.msd makefile
69 UNIX example: cp scripts/makefile.std makefile
70
71Read the makefile to see if you need to change any source or
72target directories to match your preferences.
73
74Then read pngconf.h to see if you want to make any configuration
75changes.
76
77Then just run "make test" which will create the libpng library in
78this directory and run a quick test that reads the "pngtest.png"
79file and writes a "pngout.png" file that should be identical to it.
80
81Most of the makefiles will allow you to run "make install" to
82put the library in its final resting place (if you want to
83do that, run "make install" in the zlib directory first if necessary).
84
85Further information can be found in the README and libpng.txt
86files, in the individual makefiles, and in png.h, and the manual
87pages libpng.3 and png.5.