diff options
author | giraffedata <giraffedata@9d0c8265-081b-0410-96cb-a4ca84ce46f8> | 2020-07-11 03:14:39 +0000 |
---|---|---|
committer | giraffedata <giraffedata@9d0c8265-081b-0410-96cb-a4ca84ce46f8> | 2020-07-11 03:14:39 +0000 |
commit | a87703a515ec08a0637c2b3b3e6cd0ef1a7e78ff (patch) | |
tree | 0e462a89e51e65b0d293104f437aa371d8e56ee1 /giftopnm.html | |
parent | e4dbb262ce92440414dad7735f9b9264e47cffa0 (diff) | |
download | netpbm-mirror-a87703a515ec08a0637c2b3b3e6cd0ef1a7e78ff.tar.gz netpbm-mirror-a87703a515ec08a0637c2b3b3e6cd0ef1a7e78ff.tar.xz netpbm-mirror-a87703a515ec08a0637c2b3b3e6cd0ef1a7e78ff.zip |
cleanup
git-svn-id: http://svn.code.sf.net/p/netpbm/code/userguide@3893 9d0c8265-081b-0410-96cb-a4ca84ce46f8
Diffstat (limited to 'giftopnm.html')
-rw-r--r-- | giftopnm.html | 140 |
1 files changed, 72 insertions, 68 deletions
diff --git a/giftopnm.html b/giftopnm.html index a58ed582..200350ce 100644 --- a/giftopnm.html +++ b/giftopnm.html @@ -1,88 +1,92 @@ -<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 3.2//EN"> -<HTML><HEAD><TITLE>Giftopnm User Manual</TITLE></HEAD> -<BODY> -<H1>giftopnm</H1> +<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 3.3//EN"> +<html><head><title>Giftopnm User Manual</title></head> +<body> +<h1>giftopnm</h1> Updated: 13 September 2012 -<BR> +<br> +<a href="#index">Table Of Contents</a> -<A HREF="#index">Table Of Contents</A> - -<H2>NAME</H2> +<h2>NAME</h2> giftopnm - convert a GIF file into a PNM image -<H2 id="synopsis">SYNOPSIS</H2> +<h2 id="synopsis">SYNOPSIS</h2> -<B>giftopnm</B> -[<B>--alphaout=</B>{<I>alpha-filename</I>,<B>-</B>}] -[<B>-verbose</B>] -[<B>-comments</B>] -[<B>-image=</B>{<I>N</I>,<B>all</b>}] -[<B>-repair</B>] -[<B>-quitearly</B>] -[<I>GIFfile</I>] +<b>giftopnm</b> +[<b>--alphaout=</b>{<i>alpha-filename</i>,<b>-</b>}] +[<b>-verbose</b>] +[<b>-comments</b>] +[<b>-image=</b>{<i>N</i>,<b>all</b>}] +[<b>-repair</b>] +[<b>-quitearly</b>] +[<i>GIFfile</i>] <p>Minimum unique abbreviation of option is acceptable. You may use double hyphens instead of single hyphen to denote options. You may use white space in place of the equals sign to separate an option name from its value. -<H2 id="description">DESCRIPTION</H2> +<h2 id="description">DESCRIPTION</h2> <p>This program is part of <a href="index.html">Netpbm</a>. <p>This is a graphics format converter from the GIF format to the PNM (i.e. PBM, PGM, or PPM) format. -<P>If the image contains only black and maximally bright white, the +<p>If the image contains only black and maximally bright white, the output is PBM. If the image contains more than those two colors, but only grays, the output is PGM. If the image contains other colors, the output is PPM. -<P> A GIF image contains rectangular pixels. They all have the same +<p> A GIF image contains rectangular pixels. They all have the same aspect ratio, but may not be square (it's actually quite unusual for them not to be square, but it could happen). The pixels of a Netpbm image are always square. Because of the engineering complexity to do -otherwise, <B>giftopnm</B> converts a GIF image to a Netpbm image +otherwise, <b>giftopnm</b> converts a GIF image to a Netpbm image pixel-for-pixel. This means if the GIF pixels are not square, the Netpbm output image has the wrong aspect ratio. In this case, -<B>giftopnm</B> issues an informational message telling you to run -<B>pamscale</B> to correct the output. +<b>giftopnm</b> issues an informational message telling you to run +<b>pamscale</b> to correct the output. + +<h2 id="options">OPTIONS</h2> -<H2 id="options">OPTIONS</H2> +<p>In addition to the options common to all programs based on libnetpbm +(most notably <b>-quiet</b>, see <a href="index.html#commonoptions"> +Common Options</a>), <b>giftopnm</b> recognizes the following +command line options: -<DL COMPACT> -<DT><B>--alphaout=</B><I>alpha-filename</I> +<dl compact> +<dt><b>--alphaout=</b><i>alpha-filename</i> -<DD><B>giftopnm </B> creates a PBM file containing the transparency +<dd><b>giftopnm </b> creates a PBM file containing the transparency information from the input image. This transparency image is the same dimensions as the input image, and each pixel of the transparency image tells whether the corresponding pixel of the input image is transparent. Black means transparent; white means opaque. If you don't -specify <B>--alphaout</B>, <B>giftopnm</B> does not generate a transparency -file, and if the input image has a transparency channel, <B>giftopnm</B> simply +specify <b>--alphaout</b>, <b>giftopnm</b> does not generate a transparency +file, and if the input image has a transparency channel, <b>giftopnm</b> simply discards it. -<P>If you specify <B>-</B> as the filename, <B>giftopnm</B> writes the +<p>If you specify <b>-</b> as the filename, <b>giftopnm</b> writes the transparency output to Standard Output and discards the image. -<P>See <B><A HREF="pamcomp.html">pamcomp</A></B> for one way to use +<p>See <b><a href="pamcomp.html">pamcomp</a></b> for one way to use the transparency output file. -<DT><B>-verbose</B> +<dt><b>-verbose</b> -<DD>Produce verbose output about the GIF file input. +<dd>Produce verbose output about the GIF file input. -<DT><B>-comments</B> +<dt><b>-comments</b> -<DD> +<dd> With this option, <b>giftopnm</b> issues messages showing the GIF comments (A GIF89 stream can contain comments in comment extensions). <p> By default, <b>giftopnm</b> ignores comment extensions. -<DT><B>-image=</B>{<I>N</I>,<B>all</b>} +<dt><b>-image=</b>{<i>N</i>,<b>all</b>} -<DD> +<dd> This option identifies which image from the GIF stream you want. You can select either one image or all the images. Select all the images with <b>all</b>. Select one image by specifying its sequence @@ -163,59 +167,59 @@ if it doesn't. <p>This option has no effect if you also specify <b>-image=all</b> -<P>This option was new in Netpbm 10.35 (August 2006). Before that, +<p>This option was new in Netpbm 10.35 (August 2006). Before that, <b>giftopnm</b> always reads the entire stream. -</DL> +</dl> -<H2 id="restrictions">RESTRICTIONS</H2> +<h2 id="restrictions">RESTRICTIONS</h2> <p>This does not correctly handle the Plain Text Extension of the GIF89 standard, since I did not have any example input files containing them. -<H2 id="seealso">SEE ALSO</H2> +<h2 id="seealso">SEE ALSO</h2> -<B><A HREF="pamtogif.html">pamtogif</A></B>, -<B><A HREF="ppmcolormask.html">ppmcolormask</A></B>, -<B><A HREF="pamcomp.html">pamcomp</A></B>, -<<A -HREF="http://www.lcdf.org/gifsicle">http://www.lcdf.org/gifsicle</A>>, -<B><A HREF="ppm.html">ppm</A></B>. +<b><a href="pamtogif.html">pamtogif</a></b>, +<b><a href="ppmcolormask.html">ppmcolormask</a></b>, +<b><a href="pamcomp.html">pamcomp</a></b>, +<<a +href="http://www.lcdf.org/gifsicle">http://www.lcdf.org/gifsicle</a>>, +<b><a href="ppm.html">ppm</a></b>. -<H2 id="author">AUTHOR</H2> +<h2 id="author">AUTHOR</h2> -<p>Copyright (c) 1993 by David Koblas (<A -HREF="mailto:koblas@netcom.com">koblas@netcom.com</A>) +<p>Copyright (c) 1993 by David Koblas (<a +href="mailto:koblas@netcom.com">koblas@netcom.com</a>) -<H2 id="license">LICENSE</H2> +<h2 id="license">LICENSE</h2> -<p>As a historical note, for a long time if you used <B>giftopnm</B>, +<p>As a historical note, for a long time if you used <b>giftopnm</b>, you were using a patent on the LZW compression method which was owned by Unisys, and in all probability you did not have a license from Unisys to do so. Unisys typically asked $5000 for a license for trivial use of the patent. Unisys never enforced the patent against trivial users, and made statements that it is much less concerned about people using the patent for decompression (which is what -<B>giftopnm</B> does than for compression. The patent expired in +<b>giftopnm</b> does than for compression. The patent expired in 2003. -<P>Rumor has it that IBM also owns a patent covering <B>giftopnm</B>. +<p>Rumor has it that IBM also owns a patent covering <b>giftopnm</b>. -<P>A replacement for the GIF format that has never required any patent +<p>A replacement for the GIF format that has never required any patent license to use is the PNG format. -<HR> -<A NAME="index"> </A><H2>Table Of Contents</H2> -<UL> -<LI><A HREF="#synopsis">SYNOPSIS</A> -<LI><A HREF="#description">DESCRIPTION</A> -<LI><A HREF="#options">OPTIONS</A> -<LI><A HREF="#restrictions">RESTRICTIONS</A> -<LI><A HREF="#seealso">SEE ALSO</A> -<LI><A HREF="#author">AUTHOR</A> -<LI><A HREF="#license">LICENSE</A> -</UL> -</BODY> -</HTML> +<hr> +<h2 id="index">Table Of Contents</h2> +<ul> +<li><a href="#synopsis">SYNOPSIS</a> +<li><a href="#description">DESCRIPTION</a> +<li><a href="#options">OPTIONS</a> +<li><a href="#restrictions">RESTRICTIONS</a> +<li><a href="#seealso">SEE ALSO</a> +<li><a href="#author">AUTHOR</a> +<li><a href="#license">LICENSE</a> +</ul> +</body> +</html> |