Rev 1907 | Go to most recent revision | Show entire file | Regard whitespace | Details | Blame | Last modification | View Log | RSS feed
Rev 1907 | Rev 3928 | ||
---|---|---|---|
Line 1... | Line 1... | ||
1 | README for libpng version 1.5.1 - February 3, 2011 (shared library 15.0) |
1 | README for libpng version 1.6.5 - September 14, 2013 (shared library 16.0) |
2 | See the note about version numbers near the top of png.h |
2 | See the note about version numbers near the top of png.h |
Line 3... | Line 3... | ||
3 | 3 | ||
Line 4... | Line 4... | ||
4 | See INSTALL for instructions on how to install libpng. |
4 | See INSTALL for instructions on how to install libpng. |
5 | 5 | ||
6 | Libpng comes in several distribution formats. Get libpng-*.tar.gz, |
6 | Libpng comes in several distribution formats. Get libpng-*.tar.gz or |
Line 7... | Line 7... | ||
7 | libpng-*.tar.xz or libpng-*.tar.bz2 if you want UNIX-style line endings |
7 | libpng-*.tar.xz or if you want UNIX-style line endings in the text files, |
8 | in the text files, or lpng*.zip if you want DOS-style line endings. |
8 | or lpng*.7z or lpng*.zip if you want DOS-style line endings. |
9 | 9 | ||
10 | Version 0.89 was the first official release of libpng. Don't let the |
10 | Version 0.89 was the first official release of libpng. Don't let the |
Line 75... | Line 75... | ||
75 | and medium memory models. You should also note that zlib is a |
75 | and medium memory models. You should also note that zlib is a |
76 | compression library that is useful for more things than just PNG files. |
76 | compression library that is useful for more things than just PNG files. |
77 | You can use zlib as a drop-in replacement for fread() and fwrite() if |
77 | You can use zlib as a drop-in replacement for fread() and fwrite() if |
78 | you are so inclined. |
78 | you are so inclined. |
Line 79... | Line 79... | ||
79 | 79 | ||
80 | zlib should be available at the same place that libpng is, or at. |
- | |
Line 81... | Line 80... | ||
81 | ftp://ftp.info-zip.org/pub/infozip/zlib |
80 | zlib should be available at the same place that libpng is, or at zlib.net. |
82 | 81 | ||
83 | You may also want a copy of the PNG specification. It is available |
82 | You may also want a copy of the PNG specification. It is available |
Line 84... | Line 83... | ||
84 | as an RFC, a W3C Recommendation, and an ISO/IEC Standard. You can find |
83 | as an RFC, a W3C Recommendation, and an ISO/IEC Standard. You can find |
85 | these at http://www.libpng.org/pub/png/documents/ |
84 | these at http://www.libpng.org/pub/png/documents/ |
86 | - | ||
87 | This code is currently being archived at libpng.sf.net in the |
85 | |
Line 88... | Line 86... | ||
88 | [DOWNLOAD] area, and on CompuServe, Lib 20 (PNG SUPPORT) |
86 | This code is currently being archived at libpng.sf.net in the |
89 | at GO GRAPHSUP. If you can't find it in any of those places, |
87 | [DOWNLOAD] area, and at ftp://ftp.simplesystems.org. If you can't find it |
90 | e-mail me, and I'll help you find it. |
88 | in any of those places, e-mail me, and I'll help you find it. |
91 | 89 | ||
Line 112... | Line 110... | ||
112 | You can't reach Guy, the original libpng author, at the addresses |
110 | You can't reach Guy, the original libpng author, at the addresses |
113 | given in previous versions of this document. He and Andreas will |
111 | given in previous versions of this document. He and Andreas will |
114 | read mail addressed to the png-implement list, however. |
112 | read mail addressed to the png-implement list, however. |
Line 115... | Line 113... | ||
115 | 113 | ||
116 | Please do not send general questions about PNG. Send them to |
114 | Please do not send general questions about PNG. Send them to |
117 | the (png-list at ccrc.wustl.edu, subscription required, write to |
- | |
118 | majordomo at ccrc.wustl.edu with "subscribe png-list" in your message). |
- | |
119 | On the other hand, |
115 | png-mng-misc at lists.sf.net (subscription required; visit |
120 | please do not send libpng questions to that address, send them to me |
- | |
121 | or to the png-implement list. I'll |
116 | https://lists.sourceforge.net/lists/listinfo/png-mng-misc to |
122 | get them in the end anyway. If you have a question about something |
117 | subscribe). If you have a question about something |
123 | in the PNG specification that is related to using libpng, send it |
118 | in the PNG specification that is related to using libpng, send it |
124 | to me. Send me any questions that start with "I was using libpng, |
119 | to me. Send me any questions that start with "I was using libpng, |
125 | and ...". If in doubt, send questions to me. I'll bounce them |
120 | and ...". If in doubt, send questions to me. I'll bounce them |
Line 126... | Line 121... | ||
126 | to others, if necessary. |
121 | to others, if necessary. |
127 | 122 | ||
128 | Please do not send suggestions on how to change PNG. We have |
123 | Please do not send suggestions on how to change PNG. We have |
129 | been discussing PNG for nine years now, and it is official and |
124 | been discussing PNG for eighteen years now, and it is official and |
130 | finished. If you have suggestions for libpng, however, I'll |
125 | finished. If you have suggestions for libpng, however, I'll |
Line 131... | Line 126... | ||
131 | gladly listen. Even if your suggestion is not used immediately, |
126 | gladly listen. Even if your suggestion is not used immediately, |
Line 168... | Line 163... | ||
168 | pngtrans.c => Common data transformation functions |
163 | pngtrans.c => Common data transformation functions |
169 | pngwio.c => Lowest-level write I/O functions |
164 | pngwio.c => Lowest-level write I/O functions |
170 | pngwrite.c => High-level write functions |
165 | pngwrite.c => High-level write functions |
171 | pngwtran.c => Write data transformations |
166 | pngwtran.c => Write data transformations |
172 | pngwutil.c => Write utility functions |
167 | pngwutil.c => Write utility functions |
- | 168 | arm => Contains optimized code for the ARM platform |
|
173 | contrib => Contributions |
169 | contrib => Contributions |
- | 170 | examples => Example programs |
|
174 | gregbook => source code for PNG reading and writing, from |
171 | gregbook => source code for PNG reading and writing, from |
175 | Greg Roelofs' "PNG: The Definitive Guide", |
172 | Greg Roelofs' "PNG: The Definitive Guide", |
176 | O'Reilly, 1999 |
173 | O'Reilly, 1999 |
- | 174 | libtests => Test programs |
|
- | 175 | pngminim => Minimal decoder, encoder, and progressive decoder |
|
177 | msvctest => Builds and runs pngtest using a MSVC workspace |
176 | programs demonstrating use of pngusr.dfa |
178 | pngminus => Simple pnm2png and png2pnm programs |
177 | pngminus => Simple pnm2png and png2pnm programs |
179 | pngsuite => Test images |
178 | pngsuite => Test images |
- | 179 | tools => Various tools |
|
180 | visupng => Contains a MSVC workspace for VisualPng |
180 | visupng => Contains a MSVC workspace for VisualPng |
181 | projects => Contains project files and workspaces for |
181 | projects => Contains project files and workspaces for |
182 | building a DLL |
182 | building a DLL |
183 | cbuilder5 => Contains a Borland workspace for building |
183 | owatcom => Contains a WATCOM project for building libpng |
184 | libpng and zlib |
- | |
185 | visualc6 => Contains a Microsoft Visual C++ (MSVC) |
- | |
186 | workspace for building libpng and zlib |
- | |
187 | visualc71 => Contains a Microsoft Visual C++ (MSVC) |
184 | visualc71 => Contains a Microsoft Visual C++ (MSVC) |
188 | workspace for building libpng and zlib |
185 | workspace for building libpng and zlib |
189 | xcode => Contains an Apple xcode |
186 | vstudio => Contains a Microsoft Visual C++ (MSVC) |
190 | workspace for building libpng and zlib |
187 | workspace for building libpng and zlib |
191 | scripts => Directory containing scripts for building libpng: |
188 | scripts => Directory containing scripts for building libpng: |
192 | (see scripts/README.txt for the list of scripts) |
189 | (see scripts/README.txt for the list of scripts) |
Line 193... | Line 190... | ||
193 | 190 |