source: rtems-graphics-toolkit/fltk-1.1.10/png/INSTALL @ 513eea1

Last change on this file since 513eea1 was 513eea1, checked in by Joel Sherrill <joel.sherrill@…>, on 01/09/10 at 22:43:24

2010-01-08 Joel Sherrill <joel.sherrill@…>

fltk 1.1.10. imported

  • ORIGIN: Updated.
  • Property mode set to 100644
File size: 8.1 KB
Line 
1
2Installing libpng version 1.2.40 - September 10, 2009
3
4On Unix/Linux and similar systems, you can simply type
5
6    ./configure [--prefix=/path]
7    make check
8    make install
9
10and ignore the rest of this document.
11
12If configure does not work on your system and you have a reasonably
13up-to-date set of tools, running ./autogen.sh before running ./configure
14may fix the problem.  You can also run the individual commands in
15autogen.sh with the --force option, if supported by your version of
16the tools.  If you run 'libtoolize --force', though, this will replace
17the distributed, patched, version of ltmain.sh with an unpatched version
18and your shared library builds may fail to produce libraries with the
19correct version numbers.
20
21Instead, you can use one of the custom-built makefiles in the
22"scripts" directory
23
24    cp scripts/makefile.system makefile
25    make test
26    make install
27
28Or you can use one of the "projects" in the "projects" directory.
29
30If you want to use "cmake" (see www.cmake.org), copy CMakeLists.txt
31from the "scripts" directory to this directory and type
32
33   cmake . [-DPNG_MMX=YES] -DCMAKE_INSTALL_PREFIX=/path
34   make
35   make install
36
37Before installing libpng, you must first install zlib, if it
38is not already on your system.  zlib can usually be found
39wherever you got libpng.  zlib can be placed in another directory,
40at the same level as libpng.
41
42If your system already has a preinstalled zlib you will still need
43to have access to the zlib.h and zconf.h include files that
44correspond to the version of zlib that's installed.
45
46You can rename the directories that you downloaded (they
47might be called "libpng-1.2.40" or "lpng109" and "zlib-1.2.1"
48or "zlib121") so that you have directories called "zlib" and "libpng".
49
50Your directory structure should look like this:
51
52   ..       (the parent directory)
53      libpng  (this directory)
54          INSTALL (this file)
55          README
56          *.h
57          *.c
58          contrib
59             gregbook
60             pngminus
61             pngsuite
62             visupng
63          projects
64             beos
65             c5builder (Borland)
66             visualc6 (msvc)
67             netware.txt
68             wince.txt
69          scripts
70             makefile.*
71          pngtest.png
72          etc.
73      zlib
74          README
75          *.h
76          *.c
77          contrib
78          etc.
79
80If the line endings in the files look funny, you may wish to get the other
81distribution of libpng.  It is available in both tar.gz (UNIX style line
82endings) and zip (DOS style line endings) formats.
83
84If you are building libpng with MSVC, you can enter the
85libpng projects\visualc6 directory and follow the instructions in
86projects\visualc6\README.txt.
87
88You can build libpng for WindowsCE by downloading and installing
89the projects\wince directory as instructed in the projects\wince.txt file, and
90then following the instructions in the README* files.  Similarly, you can
91build libpng for Netware or Beos as instructed in projects\netware.txt
92or projects\beos.
93
94Else enter the zlib directory and follow the instructions in zlib/README,
95then come back here and run "configure" or choose the appropriate
96makefile.sys in the scripts directory.
97
98The files that are presently available in the scripts directory
99include
100
101 CMakeLists.txt    =>  "cmake" script
102 makefile.std      =>  Generic UNIX makefile (cc, creates static libpng.a)
103 makefile.elf      =>  Linux/ELF makefile symbol versioning,
104                       gcc, creates libpng12.so.0.1.2.40)
105 makefile.linux    =>  Linux/ELF makefile
106                       (gcc, creates libpng12.so.0.1.2.40)
107 makefile.gcc      =>  Generic makefile (gcc, creates static libpng.a)
108 makefile.knr      =>  Archaic UNIX Makefile that converts files with
109                       ansi2knr (Requires ansi2knr.c from
110                       ftp://ftp.cs.wisc.edu/ghost)
111 makefile.aix      =>  AIX/gcc makefile
112 makefile.cygwin   =>  Cygwin/gcc makefile
113 makefile.darwin   =>  Darwin makefile, can use on MacosX
114 makefile.dec      =>  DEC Alpha UNIX makefile
115 makefile.freebsd  =>  FreeBSD makefile
116 makefile.hpgcc    =>  HPUX makefile using gcc
117 makefile.hpux     =>  HPUX (10.20 and 11.00) makefile
118 makefile.hp64     =>  HPUX (10.20 and 11.00) makefile, 64-bit
119 makefile.ibmc     =>  IBM C/C++ version 3.x for Win32 and OS/2 (static)
120 makefile.intel    =>  Intel C/C++ version 4.0 and later
121 libpng.icc        =>  Project file for IBM VisualAge/C++ version 4.0 or later
122 makefile.netbsd   =>  NetBSD/cc makefile, uses PNGGCCRD, makes libpng.so.
123 makefile.ne12bsd  =>  NetBSD/cc makefile, uses PNGGCCRD,
124                       makes libpng12.so
125 makefile.openbsd  =>  OpenBSD makefile
126 makefile.sgi      =>  Silicon Graphics IRIX makefile (cc, creates static lib)
127 makefile.sggcc    =>  Silicon Graphics (gcc,
128                       creates libpng12.so.0.1.2.40)
129 makefile.sunos    =>  Sun makefile
130 makefile.solaris  =>  Solaris 2.X makefile (gcc,
131                       creates libpng12.so.0.1.2.40)
132 makefile.solaris-x86 =>  Solaris/intelMMX 2.X makefile (gcc,
133                       creates libpng12.so.0.1.2.40)
134 makefile.so9      =>  Solaris 9 makefile (gcc,
135                       creates libpng12.so.0.1.2.40)
136 makefile.32sunu   =>  Sun Ultra 32-bit makefile
137 makefile.64sunu   =>  Sun Ultra 64-bit makefile
138 makefile.sco      =>  For SCO OSr5  ELF and Unixware 7 with Native cc
139 makefile.mips     =>  MIPS makefile
140 makefile.acorn    =>  Acorn makefile
141 makefile.amiga    =>  Amiga makefile
142 smakefile.ppc     =>  AMIGA smakefile for SAS C V6.58/7.00 PPC compiler
143                       (Requires SCOPTIONS, copied from scripts/SCOPTIONS.ppc)
144 makefile.atari    =>  Atari makefile
145 makefile.beos     =>  BEOS makefile for X86
146 makefile.bor      =>  Borland makefile (uses bcc)
147 makefile.bc32     =>  32-bit Borland C++ (all modules compiled in C mode)
148 makefile.tc3      =>  Turbo C 3.0 makefile
149 makefile.dj2      =>  DJGPP 2 makefile
150 makefile.msc      =>  Microsoft C makefile
151 makefile.vcwin32  =>  makefile for Microsoft Visual C++ 4.0 and later
152 makefile.os2      =>  OS/2 Makefile (gcc and emx, requires pngos2.def)
153 pngos2.def        =>  OS/2 module definition file used by makefile.os2
154 makefile.watcom   =>  Watcom 10a+ Makefile, 32-bit flat memory model
155 makevms.com       =>  VMS build script
156 descrip.mms       =>  VMS makefile for MMS or MMK
157 SCOPTIONS.ppc     =>  Used with smakefile.ppc
158
159Copy the file (or files) that you need from the
160scripts directory into this directory, for example
161
162   MSDOS example: copy scripts\makefile.msc makefile
163   UNIX example:    cp scripts/makefile.std makefile
164
165Read the makefile to see if you need to change any source or
166target directories to match your preferences.
167
168Then read pngconf.h to see if you want to make any configuration
169changes.
170
171Then just run "make" which will create the libpng library in
172this directory and "make test" which will run a quick test that reads
173the "pngtest.png" file and writes a "pngout.png" file that should be
174identical to it.  Look for "9782 zero samples" in the output of the
175test.  For more confidence, you can run another test by typing
176"pngtest pngnow.png" and looking for "289 zero samples" in the output.
177Also, you can run "pngtest -m contrib/pngsuite/*.png" and compare
178your output with the result shown in contrib/pngsuite/README.
179
180Most of the makefiles will allow you to run "make install" to
181put the library in its final resting place (if you want to
182do that, run "make install" in the zlib directory first if necessary).
183Some also allow you to run "make test-installed" after you have
184run "make install".
185
186If you encounter a compiler error message complaining about the
187lines
188      __png.h__ already includes setjmp.h;
189      __dont__ include it again.;
190This means you have compiled another module that includes setjmp.h,
191which is hazardous because the two modules might not include exactly
192the same setjmp.h.  If you are sure that you know what you are doing
193and that they are exactly the same, then you can comment out or
194delete the two lines.  Better yet, use the cexcept interface
195instead, as demonstrated in contrib/visupng of the libpng distribution.
196
197Further information can be found in the README and libpng.txt
198files, in the individual makefiles, in png.h, and the manual pages
199libpng.3 and png.5.
Note: See TracBrowser for help on using the repository browser.