libpng-1.2.8/INSTALL

   1
   2 Installing libpng version 1.2.8 - December 3, 2004
   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.2.8" or "lpng109" and "zlib-1.2.1"
  14 or "zlib121") 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           contrib
  25              gregbook
  26              pngminus
  27              pngsuite
  28              visupng
  29           projects
  30              beos
  31              c5builder (Borland)
  32              visualc6 (msvc)
  33              netware.txt
  34              wince.txt
  35           scripts
  36              makefile.*
  37           pngtest.png
  38           etc.
  39       zlib
  40           README
  41           *.h
  42           *.c
  43           contrib
  44           etc.
  45
  46 If the line endings in the files look funny, you may wish to get the other
  47 distribution of libpng.  It is available in both tar.gz (UNIX style line
  48 endings) and zip (DOS style line endings) formats.
  49
  50
  51 If you are building libpng with MSVC, you can enter the
  52 libpng projects\visualc6 directory and follow the instructions in
  53 projects\visualc6\README.txt.
  54
  55 You can build libpng for WindowsCE by downloading and installing
  56 the projects\wince directory as instructed in the projects\wince.txt file, and
  57 then following the instructions in the README* files.  Similarly, you can
  58 build libpng for Netware or Beos as instructed in projects\netware.txt
  59 or projects\beos.
  60
  61 Else enter the zlib directory and follow the instructions in zlib/README,
  62 then come back here and choose the appropriate makefile.sys in the scripts
  63 directory.
  64
  65 The files that are presently available in the scripts directory
  66 include
  67
  68  makefile.std      =>  Generic UNIX makefile (cc, creates static libpng.a)
  69  makefile.elf      =>  Linux/ELF makefile symbol versioning,
  70                        gcc, creates libpng12.so.0.1.2.8)
  71  makefile.linux    =>  Linux/ELF makefile
  72                        (gcc, creates libpng12.so.0.1.2.8)
  73  makefile.gcmmx    =>  Linux/ELF makefile
  74                        (gcc, creates libpng12.so.0.1.2.8,
  75                        uses assembler code tuned for Intel MMX platform)
  76  makefile.gcc      =>  Generic makefile (gcc, creates static libpng.a)
  77  makefile.knr      =>  Archaic UNIX Makefile that converts files with
  78                        ansi2knr (Requires ansi2knr.c from
  79                        ftp://ftp.cs.wisc.edu/ghost)
  80  makefile.aix      =>  AIX/gcc makefile
  81  makefile.cygwin   =>  Cygwin/gcc makefile
  82  makefile.darwin   =>  Darwin makefile, can use on MacosX
  83  makefile.dec      =>  DEC Alpha UNIX makefile
  84  makefile.freebsd  =>  FreeBSD makefile
  85  makefile.hpgcc    =>  HPUX makefile using gcc
  86  makefile.hpux     =>  HPUX (10.20 and 11.00) makefile
  87  makefile.hp64     =>  HPUX (10.20 and 11.00) makefile, 64-bit
  88  makefile.ibmc     =>  IBM C/C++ version 3.x for Win32 and OS/2 (static)
  89  makefile.intel    =>  Intel C/C++ version 4.0 and later
  90  libpng.icc        =>  Project file for IBM VisualAge/C++ version 4.0 or later
  91  makefile.netbsd   =>  NetBSD/cc makefile, uses PNGGCCRD, makes libpng.so.
  92  makefile.ne12bsd  =>  NetBSD/cc makefile, uses PNGGCCRD,
  93                        makes libpng12.so
  94  makefile.openbsd  =>  OpenBSD makefile
  95  makefile.sgi      =>  Silicon Graphics IRIX makefile (cc, creates static lib)
  96  makefile.sggcc    =>  Silicon Graphics (gcc,
  97                        creates libpng12.so.0.1.2.8)
  98  makefile.sunos    =>  Sun makefile
  99  makefile.solaris  =>  Solaris 2.X makefile (gcc,
 100                        creates libpng12.so.0.1.2.8)
 101  makefile.so9      =>  Solaris 9 makefile (gcc,
 102                        creates libpng12.so.0.1.2.8)
 103  makefile.32sunu   =>  Sun Ultra 32-bit makefile
 104  makefile.64sunu   =>  Sun Ultra 64-bit makefile
 105  makefile.sco      =>  For SCO OSr5  ELF and Unixware 7 with Native cc
 106  makefile.mips     =>  MIPS makefile
 107  makefile.acorn    =>  Acorn makefile
 108  makefile.amiga    =>  Amiga makefile
 109  smakefile.ppc     =>  AMIGA smakefile for SAS C V6.58/7.00 PPC compiler
 110                        (Requires SCOPTIONS, copied from scripts/SCOPTIONS.ppc)
 111  makefile.atari    =>  Atari makefile
 112  makefile.beos     =>  BEOS makefile for X86
 113  makefile.bor      =>  Borland makefile (uses bcc)
 114  makefile.bc32     =>  32-bit Borland C++ (all modules compiled in C mode)
 115  makefile.tc3      =>  Turbo C 3.0 makefile
 116  makefile.dj2      =>  DJGPP 2 makefile
 117  makefile.msc      =>  Microsoft C makefile
 118  makefile.vcawin32 =>  makefile for Microsoft Visual C++ 5.0 and later (uses
 119                        assembler code tuned for Intel MMX platform)
 120  makefile.vcwin32  =>  makefile for Microsoft Visual C++ 4.0 and later (does
 121                        not use assembler code)
 122  makefile.os2      =>  OS/2 Makefile (gcc and emx, requires pngos2.def)
 123  pngos2.def        =>  OS/2 module definition file used by makefile.os2
 124  makefile.watcom   =>  Watcom 10a+ Makefile, 32-bit flat memory model
 125  makevms.com       =>  VMS build script
 126  descrip.mms       =>  VMS makefile for MMS or MMK
 127  SCOPTIONS.ppc     =>  Used with smakefile.ppc
 128
 129 Copy the file (or files) that you need from the
 130 scripts directory into this directory, for example
 131
 132    MSDOS example: copy scripts\makefile.msc makefile
 133    UNIX example:    cp scripts/makefile.std makefile
 134
 135 Read the makefile to see if you need to change any source or
 136 target directories to match your preferences.
 137
 138 Then read pngconf.h to see if you want to make any configuration
 139 changes.
 140
 141 Then just run "make" which will create the libpng library in
 142 this directory and "make test" which will run a quick test that reads
 143 the "pngtest.png" file and writes a "pngout.png" file that should be
 144 identical to it.  Look for "9782 zero samples" in the output of the
 145 test.  For more confidence, you can run another test by typing
 146 "pngtest pngnow.png" and looking for "289 zero samples" in the output.
 147 Also, you can run "pngtest -m contrib/pngsuite/*.png" and compare
 148 your output with the result shown in contrib/pngsuite/README.
 149
 150 Most of the makefiles will allow you to run "make install" to
 151 put the library in its final resting place (if you want to
 152 do that, run "make install" in the zlib directory first if necessary).
 153 Some also allow you to run "make test-installed" after you have
 154 run "make install".
 155
 156 If you encounter a compiler error message complaining about the
 157 lines
 158       __png.h__ already includes setjmp.h;
 159       __dont__ include it again.;
 160 This means you have compiled another module that includes setjmp.h,
 161 which is hazardous because the two modules might not include exactly
 162 the same setjmp.h.  If you are sure that you know what you are doing
 163 and that they are exactly the same, then you can comment out or
 164 delete the two lines.  Better yet, use the cexcept interface
 165 instead, as demonstrated in contrib/visupng of the libpng distribution.
 166
 167 Further information can be found in the README and libpng.txt
 168 files, in the individual makefiles, in png.h, and the manual pages
 169 libpng.3 and png.5.