README
上传用户:sesekoo
上传日期:2020-07-18
资源大小:21543k
文件大小:14k
源码类别:

界面编程

开发平台:

Visual C++

  1. README for libpng version 1.2.34 - December 18, 2008 (shared library 12.0)
  2. See the note about version numbers near the top of png.h
  3. See INSTALL for instructions on how to install libpng.
  4. Libpng comes in several distribution formats.  Get libpng-*.tar.gz,
  5. libpng-*.tar.lzma, or libpng-*.tar.bz2 if you want UNIX-style line
  6. endings in the text files, or lpng*.7z or lpng*.zip if you want DOS-style
  7. line endings.  You can get UNIX-style line endings from the *.zip file
  8. by using "unzip -a" but there seems to be no simple way to recover
  9. UNIX-style line endings from the *.7z file.  The *.tar.lzma file is
  10. recommended for *NIX users instead.
  11. Version 0.89 was the first official release of libpng.  Don't let the
  12. fact that it's the first release fool you.  The libpng library has been in
  13. extensive use and testing since mid-1995.  By late 1997 it had
  14. finally gotten to the stage where there hadn't been significant
  15. changes to the API in some time, and people have a bad feeling about
  16. libraries with versions < 1.0.  Version 1.0.0 was released in
  17. March 1998.
  18. ****
  19. Note that some of the changes to the png_info structure render this
  20. version of the library binary incompatible with libpng-0.89 or
  21. earlier versions if you are using a shared library.  The type of the
  22. "filler" parameter for png_set_filler() has changed from png_byte to
  23. png_uint_32, which will affect shared-library applications that use
  24. this function.
  25. To avoid problems with changes to the internals of png_info_struct,
  26. new APIs have been made available in 0.95 to avoid direct application
  27. access to info_ptr.  These functions are the png_set_<chunk> and
  28. png_get_<chunk> functions.  These functions should be used when
  29. accessing/storing the info_struct data, rather than manipulating it
  30. directly, to avoid such problems in the future.
  31. It is important to note that the APIs do not make current programs
  32. that access the info struct directly incompatible with the new
  33. library.  However, it is strongly suggested that new programs use
  34. the new APIs (as shown in example.c and pngtest.c), and older programs
  35. be converted to the new format, to facilitate upgrades in the future.
  36. ****
  37. Additions since 0.90 include the ability to compile libpng as a
  38. Windows DLL, and new APIs for accessing data in the info struct.
  39. Experimental functions include the ability to set weighting and cost
  40. factors for row filter selection, direct reads of integers from buffers
  41. on big-endian processors that support misaligned data access, faster
  42. methods of doing alpha composition, and more accurate 16->8 bit color
  43. conversion.
  44. The additions since 0.89 include the ability to read from a PNG stream
  45. which has had some (or all) of the signature bytes read by the calling
  46. application.  This also allows the reading of embedded PNG streams that
  47. do not have the PNG file signature.  As well, it is now possible to set
  48. the library action on the detection of chunk CRC errors.  It is possible
  49. to set different actions based on whether the CRC error occurred in a
  50. critical or an ancillary chunk.
  51. The changes made to the library, and bugs fixed are based on discussions
  52. on the png-mng-implement mailing list
  53. and not on material submitted privately to Guy, Andreas, or Glenn.  They will
  54. forward any good suggestions to the list.
  55. For a detailed description on using libpng, read libpng.txt.  For
  56. examples of libpng in a program, see example.c and pngtest.c.  For usage
  57. information and restrictions (what little they are) on libpng, see
  58. png.h.  For a description on using zlib (the compression library used by
  59. libpng) and zlib's restrictions, see zlib.h
  60. I have included a general makefile, as well as several machine and
  61. compiler specific ones, but you may have to modify one for your own needs.
  62. You should use zlib 1.0.4 or later to run this, but it MAY work with
  63. versions as old as zlib 0.95.  Even so, there are bugs in older zlib
  64. versions which can cause the output of invalid compression streams for
  65. some images.  You will definitely need zlib 1.0.4 or later if you are
  66. taking advantage of the MS-DOS "far" structure allocation for the small
  67. and medium memory models.  You should also note that zlib is a
  68. compression library that is useful for more things than just PNG files.
  69. You can use zlib as a drop-in replacement for fread() and fwrite() if
  70. you are so inclined.
  71. zlib should be available at the same place that libpng is, or at
  72. ftp://ftp.simplesystems.org/pub/png/src/
  73. You may also want a copy of the PNG specification.  It is available
  74. as an RFC, a W3C Recommendation, and an ISO/IEC Standard.  You can find
  75. these at http://www.libpng.org/pub/png/pngdocs.html
  76. This code is currently being archived at libpng.sf.net in the
  77. [DOWNLOAD] area, and on CompuServe, Lib 20 (PNG SUPPORT)
  78. at GO GRAPHSUP.  If you can't find it in any of those places,
  79. e-mail me, and I'll help you find it.
  80. If you have any code changes, requests, problems, etc., please e-mail
  81. them to me.  Also, I'd appreciate any make files or project files,
  82. and any modifications you needed to make to get libpng to compile,
  83. along with a #define variable to tell what compiler/system you are on.
  84. If you needed to add transformations to libpng, or wish libpng would
  85. provide the image in a different way, drop me a note (and code, if
  86. possible), so I can consider supporting the transformation.
  87. Finally, if you get any warning messages when compiling libpng
  88. (note: not zlib), and they are easy to fix, I'd appreciate the
  89. fix.  Please mention "libpng" somewhere in the subject line.  Thanks.
  90. This release was created and will be supported by myself (of course
  91. based in a large way on Guy's and Andreas' earlier work), and the PNG group.
  92. Send comments/corrections/commendations to png-mng-implement at lists.sf.net
  93. (subscription required; visit 
  94. https://lists.sourceforge.net/lists/listinfo/png-mng-implement
  95. to subscribe) or to glennrp at users.sourceforge.net
  96. You can't reach Guy, the original libpng author, at the addresses
  97. given in previous versions of this document.  He and Andreas will read mail
  98. addressed to the png-mng-implement list, however.
  99. Please do not send general questions about PNG.  Send them to
  100. the (png-mng-misc at lists.sourceforge.net, subscription required, visit
  101. https://lists.sourceforge.net/lists/listinfo/png-mng-implement to subscribe)
  102. On the other hand,
  103. please do not send libpng questions to that address, send them to me
  104. or to the png-mng-implement list.  I'll
  105. get them in the end anyway.  If you have a question about something
  106. in the PNG specification that is related to using libpng, send it
  107. to me.  Send me any questions that start with "I was using libpng,
  108. and ...".  If in doubt, send questions to me.  I'll bounce them
  109. to others, if necessary.
  110. Please do not send suggestions on how to change PNG.  We have
  111. been discussing PNG for twelve years now, and it is official and
  112. finished.  If you have suggestions for libpng, however, I'll
  113. gladly listen.  Even if your suggestion is not used immediately,
  114. it may be used later.
  115. Files in this distribution:
  116.       ANNOUNCE      =>  Announcement of this version, with recent changes
  117.       CHANGES       =>  Description of changes between libpng versions
  118.       KNOWNBUG      =>  List of known bugs and deficiencies
  119.       LICENSE       =>  License to use and redistribute libpng
  120.       README        =>  This file
  121.       TODO          =>  Things not implemented in the current library
  122.       Y2KINFO       =>  Statement of Y2K compliance
  123.       example.c     =>  Example code for using libpng functions
  124.       libpng-*-*-diff.txt => Diff from previous release
  125.       libpng.3      =>  manual page for libpng (includes libpng.txt)
  126.       libpng.txt    =>  Description of libpng and its functions
  127.       libpngpf.3    =>  manual page for libpng's private functions
  128.       png.5         =>  manual page for the PNG format
  129.       png.c         =>  Basic interface functions common to library
  130.       png.h         =>  Library function and interface declarations
  131.       pngconf.h     =>  System specific library configuration
  132.       pngerror.c    =>  Error/warning message I/O functions
  133.       pngget.c      =>  Functions for retrieving info from struct
  134.       pngmem.c      =>  Memory handling functions
  135.       pngbar.png    =>  PNG logo, 88x31
  136.       pngnow.png    =>  PNG logo, 98x31
  137.       pngpread.c    =>  Progressive reading functions
  138.       pngread.c     =>  Read data/helper high-level functions
  139.       pngrio.c      =>  Lowest-level data read I/O functions
  140.       pngrtran.c    =>  Read data transformation functions
  141.       pngrutil.c    =>  Read data utility functions
  142.       pngset.c      =>  Functions for storing data into the info_struct
  143.       pngtest.c     =>  Library test program
  144.       pngtest.png   =>  Library test sample image
  145.       pngtrans.c    =>  Common data transformation functions
  146.       pngwio.c      =>  Lowest-level write I/O functions
  147.       pngwrite.c    =>  High-level write functions
  148.       pngwtran.c    =>  Write data transformations
  149.       pngwutil.c    =>  Write utility functions
  150.       contrib       =>  Contributions
  151.        gregbook         =>  source code for PNG reading and writing, from
  152.                             Greg Roelofs' "PNG: The Definitive Guide",
  153.                             O'Reilly, 1999
  154.        msvctest     =>  Builds and runs pngtest using a MSVC workspace
  155.        pngminus     =>  Simple pnm2png and png2pnm programs
  156.        pngsuite     =>  Test images
  157.        visupng      =>  Contains a MSVC workspace for VisualPng
  158.       projects      =>  Contains project files and workspaces for building DLL
  159.        beos             =>  Contains a Beos workspace for building libpng
  160.        c5builder        =>  Contains a Borland workspace for building libpng
  161.                             and zlib
  162.        visualc6         =>  Contains a Microsoft Visual C++ (MSVC) workspace
  163.                             for building libpng and zlib
  164.        netware.txt      =>  Contains instructions for downloading a set of
  165.                             project files for building libpng and zlib on
  166.                             Netware.
  167.        wince.txt        =>  Contains instructions for downloading a Microsoft
  168.                             Visual C++ (Windows CD Toolkit) workspace for
  169.                             building libpng and zlib on WindowsCE
  170.       scripts       =>  Directory containing scripts for building libpng:
  171.        descrip.mms      =>  VMS makefile for MMS or MMK
  172.        makefile.std     =>  Generic UNIX makefile (cc, creates static libpng.a)
  173.        makefile.elf     =>  Linux/ELF makefile symbol versioning,
  174.                             gcc, creates libpng12.so.0.1.2.34)
  175.        makefile.linux   =>  Linux/ELF makefile
  176.                             (gcc, creates libpng12.so.0.1.2.34)
  177.        makefile.gcmmx   =>  Linux/ELF makefile
  178.                             (gcc, creates libpng12.so.0.1.2.34,
  179.                             uses assembler code tuned for Intel MMX platform)
  180.        makefile.gcc     =>  Generic makefile (gcc, creates static libpng.a)
  181.        makefile.knr     =>  Archaic UNIX Makefile that converts files with
  182.                             ansi2knr (Requires ansi2knr.c from
  183.                             ftp://ftp.cs.wisc.edu/ghost)
  184.        makefile.aix     =>  AIX makefile
  185.        makefile.cygwin  =>  Cygwin/gcc makefile
  186.        makefile.darwin  =>  Darwin makefile
  187.        makefile.dec     =>  DEC Alpha UNIX makefile
  188.        makefile.freebsd =>  FreeBSD makefile
  189.        makefile.hpgcc   =>  HPUX makefile using gcc
  190.        makefile.hpux    =>  HPUX (10.20 and 11.00) makefile
  191.        makefile.hp64    =>  HPUX (10.20 and 11.00) makefile, 64 bit
  192.        makefile.ibmc    =>  IBM C/C++ version 3.x for Win32 and OS/2 (static)
  193.        makefile.intel   =>  Intel C/C++ version 4.0 and later
  194.        libpng.icc       =>  Project file, IBM VisualAge/C++ 4.0 or later
  195.        makefile.netbsd  =>  NetBSD/cc makefile, PNGGCCRD, makes libpng.so.
  196.        makefile.ne12bsd  =>  NetBSD/cc makefile, PNGGCCRD, makes libpng12.so
  197.        makefile.openbsd =>  OpenBSD makefile
  198.        makefile.sgi     =>  Silicon Graphics IRIX (cc, creates static lib)
  199.        makefile.sggcc   =>  Silicon Graphics
  200.                             (gcc, creates libpng12.so.0.1.2.34)
  201.        makefile.sunos   =>  Sun makefile
  202.        makefile.solaris =>  Solaris 2.X makefile
  203.                             (gcc, creates libpng12.so.0.1.2.34)
  204.        makefile.so9     =>  Solaris 9 makefile
  205.                             (gcc, creates libpng12.so.0.1.2.34)
  206.        makefile.32sunu  =>  Sun Ultra 32-bit makefile
  207.        makefile.64sunu  =>  Sun Ultra 64-bit makefile
  208.        makefile.sco     =>  For SCO OSr5  ELF and Unixware 7 with Native cc
  209.        makefile.mips    =>  MIPS makefile
  210.        makefile.acorn   =>  Acorn makefile
  211.        makefile.amiga   =>  Amiga makefile
  212.        smakefile.ppc    =>  AMIGA smakefile for SAS C V6.58/7.00 PPC
  213.                             compiler (Requires SCOPTIONS, copied from
  214.                             scripts/SCOPTIONS.ppc)
  215.        makefile.atari   =>  Atari makefile
  216.        makefile.beos    =>  BEOS makefile for X86
  217.        makefile.bor     =>  Borland makefile (uses bcc)
  218.        makefile.bc32    =>  32-bit Borland C++ (all modules compiled in C mode)
  219.        makefile.tc3     =>  Turbo C 3.0 makefile
  220.        makefile.dj2     =>  DJGPP 2 makefile
  221.        makefile.msc     =>  Microsoft C makefile
  222.        makefile.vcawin32=>  makefile for Microsoft Visual C++ 5.0 and
  223.                             later (uses assembler code tuned for Intel MMX
  224.                             platform)
  225.        makefile.vcwin32 =>  makefile for Microsoft Visual C++ 4.0 and
  226.                             later (does not use assembler code)
  227.        makefile.os2     =>  OS/2 Makefile (gcc and emx, requires pngos2.def)
  228.        pngos2.def       =>  OS/2 module definition file used by makefile.os2
  229.        makefile.watcom  =>  Watcom 10a+ Makefile, 32-bit flat memory model
  230.        makevms.com      =>  VMS build script
  231.        SCOPTIONS.ppc    =>  Used with smakefile.ppc
  232. Good luck, and happy coding.
  233. -Glenn Randers-Pehrson (current maintainer)
  234.  Internet: glennrp at users.sourceforge.net
  235. -Andreas Eric Dilger (former maintainer, 1996-1997)
  236.  Internet: adilger at enel.ucalgary.ca
  237.  Web: http://members.shaw.ca/adilger/
  238. -Guy Eric Schalnat (original author and former maintainer, 1995-1996)
  239.  (formerly of Group 42, Inc)
  240.  Internet: gschal at infinet.com