gif2png.1
上传用户:sorock1981
上传日期:2007-01-06
资源大小:73k
文件大小:6k
源码类别:

图片显示

开发平台:

Unix_Linux

  1. .TH GIF2PNG 1 "20 September 1999"
  2. .SH NAME
  3. gif2png - convert GIFs to PNGs
  4. .SH SYNOPSIS
  5. gif2png [-bdfghinprsvwO] [file[.gif]...]
  6. .SH DESCRIPTION
  7. The gif2png program converts files in the obsolescent and
  8. patent-encumbered Graphic Interchange Format (GIF) to Portable Network
  9. Graphics (PNG) format, an open W3C standard.
  10. Normally gif2png converts each file named on the command line, leaving
  11. the original in place.  If a name does not have a .gif extension, the
  12. unmodified name will be tried first, followed by the name with .gif
  13. appended.  For each file named `foo.gif', a foo.png will be created.
  14. When a multi-image GIF file named foo.gif is converted, gif2png
  15. creates multiple PNG files, each containing one frame; their names
  16. will be foo.png, foo.p01, foo.p02 etc.
  17. If no source files are specified and stdin is a terminal, gif2png lists
  18. a usage summary and version information, then exits.
  19. If no source files are specified, and stdin is a device or pipe, stdin
  20. is converted to noname.png.  (The program can't be a normal
  21. stdin-to-stdout filter because of the possibility that the input GIF
  22. might have multiple images).
  23. However, if filter mode is forced (with -f) stdin will be converted to
  24. stdout, with gif2png returning an error code if the GIF is multi-image.
  25. The program will preserve the information contained in a GIF file as
  26. closely as possible, including GIF comment and application-data
  27. extension blocks. All graphics data (pixels, RGB color tables) will be
  28. converted without loss of information.  Transparency is also preserved.
  29. There is one exception; GIF plain-text extensions are skipped.
  30. The program automatically converts interlaced GIFs to interlaced PNGs.
  31. It detects images in which all colors are gray (equal R, G, and B
  32. values) and converts such images to PNG grayscale.  Other images are
  33. converted to use the PNG palette type.  Duplicate color entries are
  34. silently preserved.  Unused color-table entries cause an error message.
  35. The action of the program can be modified with the following
  36. command-line switches:
  37. .TP 
  38. .B -b {#}RRGGBB
  39. Background.  Replace transparent pixels with given RGB value,
  40. six hexadecimal digits interpreted as two hexits each of red,
  41. green, and blue value.  The value may optionally be led with
  42. a #, HTML-style.
  43. .TP
  44. .B -d
  45. Delete source GIF files after successful conversion.
  46. .TP 
  47. .B -f
  48. Filter mode.  Convert GIF on stdin to PNG on stdout, return error
  49. if the GIF is multi-image.
  50. .TP
  51. .B -g 
  52. Write gamma=1/2.2 and sRGB chunks in the PNG.
  53. .TP
  54. .B -h 
  55. Generate PNG color-frequency histogram chunks into converted color files.
  56. .TP
  57. .B -i
  58. Force conversion to interlaced PNG files.
  59. .TP
  60. .B -n
  61. Force conversion to non-interlaced PNG files.
  62. .TP
  63. .B -p
  64. Display progress of PNG writing.
  65. .TP
  66. .B -r
  67. Try to recover data from corrupted GIF files.
  68. .TP
  69. .B -s
  70. Do not translate the GIF Software chunk to a PNG annotation.
  71. .TP
  72. .B -v
  73. Verbose mode; show summary line, -vv enables conversion-statistics and
  74. debugging messages.
  75. .TP
  76. .B -w
  77. Web-probe switch; list GIFs that do not have multiple images or
  78. transparency to stdout.  GIFs that fail this filter cause error
  79. messages to stderr.
  80. .TP
  81. .B -O
  82. Optimize; remove unused color-table entries.  Normally these trigger
  83. an error message and disable -d (but conversion is completed anyway).
  84. Also, use zlib compression level 9 (best compression) instead of
  85. the default level.
  86. The recovery algorithm enabled by -r is as follows: Unused color table
  87. entries will not trigger an error message as they normally do, but
  88. will still be preserved unless -O is also on, in which case they will
  89. be discarded. Missing color tables will be patched with a default that
  90. puts black at index 0, white at index 1, and supplies red, green,
  91. blue, yellow, purple and cyan as the remaining color values.  Missing
  92. image pixels will be set to 0.  Unrecognized or corrupted extensions
  93. will be discarded.
  94. .SH PROBLEMS
  95. Naively converting all your GIFs at one go with gif2png is not likely
  96. to give you the results you want.  The problem is not with PNG itself
  97. or with gif2png, but with the poor-to-nonexistent support for PNG
  98. transparency and animation in most browsers.
  99. The web-probe switch is intended to be used with scripts for
  100. converting web sites.  All PNGs generated from the pathnames it
  101. returns will be properly rendered in Netscape Navigator 4.04+,
  102. Internet Explorer versions 4.0b1+, and all other current web browsers.
  103. Note: in future releases of gif2png, the meaning of this switch may
  104. change to reflect the capabilities of prevalent browsers.
  105. .SH PATENT ISSUES
  106. The GIF format is encumbered by a Unisys patent (see
  107. <http://www.patents.ibm.com/details?pn=US04558302__>) for the
  108. Lempel-Ziv-Welch compression algorithm.  Use of any GIF image
  109. generator not licensed by Unisys can make you liable to lawsuit.
  110. Unisys apparently refuses to issue licenses for use of LZW in
  111. open-source programs, and in 1999 stated that its policy is to require
  112. a $5000 fee from websites that carry GIF images made by unlicensed
  113. software -- even nonprofit websites created and displayed with free
  114. software.  See <http://corp2.unisys.com/LeadStory/lzw-license.html>
  115. for details.
  116. The patent probably does not cover LZW decompressors such as the one
  117. gif2png uses; legal opinions are divided on this, there has been no court
  118. test, and Unisys refuses to commit itself.  It is possible that
  119. you may be liable if you distribute gif2png in a commercial program,
  120. or distribute gif2png on a for-profit basis.   
  121. For a history of the GIF patent controversy, see
  122. <http://lpf.ai.mit.edu/Patents/Gif/Gif.html>.  To avoid legal
  123. problems, it would be a good idea to convert all GIFs on your websites
  124. and elsewhere to PNGs without delay.  See <http://burnallgifs.org/>
  125. for discussion.
  126. .SH STANDARDS AND SPECIFICATIONS
  127. Copies of the GIF89 specification are widely available on the Web;
  128. search for "GRAPHICS INTERCHANGE FORMAT".  The Graphics Interchange
  129. Format(c) is the Copyright property of CompuServe
  130. Incorporated. GIF(sm) is a Service Mark property of CompuServe
  131. Incorporated.
  132. The PNG home site at <http://www.cdrom.com/pub/png/> has very 
  133. complete information on the PNG standard, PNG libraries, and PNG tools.
  134. .SH SEE ALSO
  135. web2png(1)
  136. .SH AUTHORS
  137. Code by Alexander Lehmann <alex@hal.rhein-main.de>, 1995.
  138. Auto-interlace conversion and tRNS optimization by Greg Roelofs
  139. <newt@pobox.com>, 1999.  Man page, -O, -w, and production packaging by
  140. Eric S. Raymond <esr@thyrsus.com>, 1999.