1998-03-07 12:06:55 +00:00
|
|
|
|
2004-08-10 02:50:32 +00:00
|
|
|
Installing libpng version 1.2.6rc3 - August 10, 2004
|
1998-03-07 12:06:55 +00:00
|
|
|
|
|
|
|
Before installing libpng, you must first install zlib. zlib
|
|
|
|
can usually be found wherever you got libpng. zlib can be
|
|
|
|
placed in another directory, at the same level as libpng.
|
|
|
|
Note that your system might already have a preinstalled
|
1998-12-29 17:47:59 +00:00
|
|
|
zlib, but you will still need to have access to the
|
1998-03-07 12:06:55 +00:00
|
|
|
zlib.h and zconf.h include files that correspond to the
|
|
|
|
version of zlib that's installed.
|
|
|
|
|
|
|
|
You can rename the directories that you downloaded (they
|
2004-08-10 02:50:32 +00:00
|
|
|
might be called "libpng-1.2.6rc3" or "lpng109" and "zlib-1.1.3"
|
2004-07-18 03:45:44 +00:00
|
|
|
or "zlib113") so that you have directories called "zlib" and "libpng".
|
1998-03-07 12:06:55 +00:00
|
|
|
|
|
|
|
Your directory structure should look like this:
|
|
|
|
|
|
|
|
.. (the parent directory)
|
|
|
|
libpng (this directory)
|
|
|
|
INSTALL (this file)
|
|
|
|
README
|
|
|
|
*.h
|
|
|
|
*.c
|
1999-10-14 12:43:10 +00:00
|
|
|
contrib
|
|
|
|
gregbook
|
2000-06-04 19:29:29 +00:00
|
|
|
msvctest
|
1999-10-23 13:39:18 +00:00
|
|
|
pngminus
|
|
|
|
pngsuite
|
2000-06-24 02:38:16 +00:00
|
|
|
visupng
|
2001-01-16 04:01:20 +00:00
|
|
|
projects
|
2001-05-07 19:52:45 +00:00
|
|
|
beos
|
2001-01-16 04:01:20 +00:00
|
|
|
borland
|
2000-11-10 18:26:19 +00:00
|
|
|
msvc
|
2001-06-23 13:03:17 +00:00
|
|
|
netware.txt
|
|
|
|
wince.txt
|
1998-03-07 12:06:55 +00:00
|
|
|
scripts
|
|
|
|
makefile.*
|
|
|
|
pngtest.png
|
|
|
|
etc.
|
|
|
|
zlib
|
|
|
|
README
|
|
|
|
*.h
|
|
|
|
*.c
|
|
|
|
contrib
|
|
|
|
etc.
|
|
|
|
|
2000-02-05 05:40:16 +00:00
|
|
|
If the line endings in the files look funny, you may wish to get the other
|
|
|
|
distribution of libpng. It is available in both tar.gz (UNIX style line
|
|
|
|
endings) and zip (DOS style line endings) formats.
|
|
|
|
|
2000-06-24 02:38:16 +00:00
|
|
|
If you are building libpng with MSVC, you can enter the libpng\msvc directory
|
2001-06-23 13:03:17 +00:00
|
|
|
and follow the instructions in msvc\README.txt.
|
|
|
|
|
|
|
|
You can build libpng for WindowsCE by entering the downloading and installing
|
|
|
|
the libpng\wince directory as instructed in the projects\wince.txt file, and
|
|
|
|
then following the instructions in the README* files. Similarly, you can
|
|
|
|
build libpng for Netware as instructed in projects\netware.txt.
|
2000-06-04 19:29:29 +00:00
|
|
|
|
2000-06-24 02:38:16 +00:00
|
|
|
Else enter the zlib directory and follow the instructions in zlib/README,
|
|
|
|
then come back here and choose the appropriate makefile.sys in the scripts
|
2000-11-23 17:51:42 +00:00
|
|
|
directory.
|
2000-06-24 02:38:16 +00:00
|
|
|
|
1998-03-07 12:06:55 +00:00
|
|
|
The files that are presently available in the scripts directory
|
|
|
|
include
|
|
|
|
|
2000-03-21 11:13:06 +00:00
|
|
|
makefile.std => Generic UNIX makefile (cc, creates static libpng.a)
|
2004-08-10 02:50:32 +00:00
|
|
|
makefile.linux => Linux/ELF makefile (gcc, creates libpng12.so.0.1.2.6rc3)
|
|
|
|
makefile.gcmmx => Linux/ELF makefile (gcc, creates libpng12.so.0.1.2.6rc3,
|
2000-03-21 11:13:06 +00:00
|
|
|
uses assembler code tuned for Intel MMX platform)
|
|
|
|
makefile.gcc => Generic makefile (gcc, creates static libpng.a)
|
1999-10-14 12:43:10 +00:00
|
|
|
makefile.knr => Archaic UNIX Makefile that converts files with
|
|
|
|
ansi2knr (Requires ansi2knr.c from
|
|
|
|
ftp://ftp.cs.wisc.edu/ghost)
|
2002-10-03 11:32:37 +00:00
|
|
|
makefile.aix => AIX/gcc makefile
|
2000-11-10 18:26:19 +00:00
|
|
|
makefile.cygwin => Cygwin/gcc makefile
|
2004-08-04 11:34:52 +00:00
|
|
|
makefile.darwin => Darwin makefile, can use on MacosX
|
1999-10-14 12:43:10 +00:00
|
|
|
makefile.dec => DEC Alpha UNIX makefile
|
2002-04-27 15:11:25 +00:00
|
|
|
makefile.hpgcc => FreeBSD makefile
|
2001-05-07 19:52:45 +00:00
|
|
|
makefile.hpgcc => HPUX makefile using gcc
|
1999-10-14 12:43:10 +00:00
|
|
|
makefile.hpux => HPUX (10.20 and 11.00) makefile
|
2000-04-02 03:10:05 +00:00
|
|
|
makefile.ibmc => IBM C/C++ version 3.x for Win32 and OS/2 (static)
|
2000-05-16 11:17:36 +00:00
|
|
|
makefile.intel => Intel C/C++ version 4.0 and later
|
2000-04-02 03:10:05 +00:00
|
|
|
libpng.icc => Project file for IBM VisualAge/C++ version 4.0 or later
|
2002-04-15 14:25:51 +00:00
|
|
|
makefile.netbsd => NetBSD/cc makefile, uses PNGGCCRD, makes libpng.so.
|
2002-04-27 15:11:25 +00:00
|
|
|
makefile.ne0bsd => NetBSD/cc makefile, uses PNGGCCRD, makes libpng0.so
|
2002-03-07 04:08:00 +00:00
|
|
|
makefile.openbsd => OpenBSD makefile
|
2000-03-21 11:13:06 +00:00
|
|
|
makefile.sgi => Silicon Graphics IRIX makefile (cc, creates static lib)
|
2004-08-10 02:50:32 +00:00
|
|
|
makefile.sggcc => Silicon Graphics (gcc, creates libpng12.so.0.1.2.6rc3)
|
1999-10-14 12:43:10 +00:00
|
|
|
makefile.sunos => Sun makefile
|
2004-08-10 02:50:32 +00:00
|
|
|
makefile.solaris => Solaris 2.X makefile (gcc, creates libpng12.so.0.1.2.6rc3)
|
|
|
|
makefile.so9 => Solaris 9 makefile (gcc, creates libpng12.so.0.1.2.6rc3)
|
2002-03-07 04:08:00 +00:00
|
|
|
makefile.32sunu => Sun Ultra 32-bit makefile
|
|
|
|
makefile.64sunu => Sun Ultra 64-bit makefile
|
1999-10-14 12:43:10 +00:00
|
|
|
makefile.sco => For SCO OSr5 ELF and Unixware 7 with Native cc
|
|
|
|
makefile.mips => MIPS makefile
|
|
|
|
makefile.acorn => Acorn makefile
|
|
|
|
makefile.amiga => Amiga makefile
|
|
|
|
smakefile.ppc => AMIGA smakefile for SAS C V6.58/7.00 PPC compiler
|
|
|
|
(Requires SCOPTIONS, copied from scripts/SCOPTIONS.ppc)
|
|
|
|
makefile.atari => Atari makefile
|
|
|
|
makefile.beos => BEOS makefile for X86
|
2000-03-21 11:13:06 +00:00
|
|
|
makefile.bor => Borland makefile (uses bcc)
|
|
|
|
makefile.bc32 => 32-bit Borland C++ (all modules compiled in C mode)
|
2000-02-05 05:40:16 +00:00
|
|
|
makefile.bd32 => To make a png32bd.dll with Borland C++ 4.5
|
2000-03-21 11:13:06 +00:00
|
|
|
makefile.tc3 => Turbo C 3.0 makefile
|
1999-10-14 12:43:10 +00:00
|
|
|
makefile.dj2 => DJGPP 2 makefile
|
|
|
|
makefile.msc => Microsoft C makefile
|
|
|
|
makefile.vcawin32 => makefile for Microsoft Visual C++ 5.0 and later (uses
|
2000-02-05 05:40:16 +00:00
|
|
|
assembler code tuned for Intel MMX platform)
|
1999-10-14 12:43:10 +00:00
|
|
|
makefile.vcwin32 => makefile for Microsoft Visual C++ 4.0 and later (does
|
|
|
|
not use assembler code)
|
|
|
|
makefile.os2 => OS/2 Makefile (gcc and emx, requires pngos2.def)
|
|
|
|
pngos2.def => OS/2 module definition file used by makefile.os2
|
|
|
|
makefile.watcom => Watcom 10a+ Makefile, 32-bit flat memory model
|
|
|
|
makevms.com => VMS build script
|
2000-03-21 11:13:06 +00:00
|
|
|
descrip.mms => VMS makefile for MMS or MMK
|
1999-10-14 12:43:10 +00:00
|
|
|
pngdef.pas => Defines for a png32bd.dll with Borland C++ 4.5
|
|
|
|
SCOPTIONS.ppc => Used with smakefile.ppc
|
1998-03-07 12:06:55 +00:00
|
|
|
|
|
|
|
Copy the file (or files) that you need from the
|
|
|
|
scripts directory into this directory, for example
|
|
|
|
|
1999-10-14 12:43:10 +00:00
|
|
|
MSDOS example: copy scripts\makefile.msc makefile
|
1998-03-07 12:06:55 +00:00
|
|
|
UNIX example: cp scripts/makefile.std makefile
|
|
|
|
|
|
|
|
Read the makefile to see if you need to change any source or
|
|
|
|
target directories to match your preferences.
|
|
|
|
|
|
|
|
Then read pngconf.h to see if you want to make any configuration
|
|
|
|
changes.
|
|
|
|
|
|
|
|
Then just run "make test" which will create the libpng library in
|
|
|
|
this directory and run a quick test that reads the "pngtest.png"
|
|
|
|
file and writes a "pngout.png" file that should be identical to it.
|
1999-10-14 12:43:10 +00:00
|
|
|
Look for "9782 zero samples" in the output of the test. For more
|
|
|
|
confidence, you can run another test by typing "pngtest pngnow.png"
|
1999-10-23 13:39:18 +00:00
|
|
|
and looking for "289 zero samples" in the output. Also, you can
|
|
|
|
run "pngtest -m *.png" in the "contrib/pngsuite" directory and compare
|
|
|
|
your output with the result shown in contrib/pngsuite/README.
|
1998-03-07 12:06:55 +00:00
|
|
|
|
|
|
|
Most of the makefiles will allow you to run "make install" to
|
|
|
|
put the library in its final resting place (if you want to
|
|
|
|
do that, run "make install" in the zlib directory first if necessary).
|
2002-06-20 11:54:34 +00:00
|
|
|
Some also allow you to run "make test-installed" after you have
|
2002-10-03 11:32:37 +00:00
|
|
|
run "make install".
|
1998-03-07 12:06:55 +00:00
|
|
|
|
2004-07-28 13:20:44 +00:00
|
|
|
If you encounter a compiler error message complaining about the
|
|
|
|
lines
|
|
|
|
__png.h__ already includes setjmp.h;
|
|
|
|
__dont__ include it again.;
|
|
|
|
This means you have compiled another module that includes setjmp.h,
|
|
|
|
which is hazardous because the two modules might not include exactly
|
|
|
|
the same setjmp.h. If you are sure that you know what you are doing
|
|
|
|
and that they are exactly the same, then you can comment out or
|
|
|
|
delete the two lines. Better yet, use the cexcept interface
|
|
|
|
instead, as demonstrated in contrib/visupng of the libpng distribution.
|
|
|
|
|
1998-03-07 12:06:55 +00:00
|
|
|
Further information can be found in the README and libpng.txt
|
2004-07-28 13:20:44 +00:00
|
|
|
files, in the individual makefiles, in png.h, and the manual pages
|
|
|
|
libpng.3 and png.5.
|