| 1 |
<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 3.3//EN"> |
| 2 |
<html><head><title>Anytopnm User Manual</title></head> |
| 3 |
<body> |
| 4 |
<h1>anytopnm</h1> |
| 5 |
Updated: 15 November 2014 |
| 6 |
<br> |
| 7 |
<a href="#index">Table Of Contents</a> |
| 8 |
|
| 9 |
<h2>NAME</h2> |
| 10 |
anytopnm - convert an arbitrary type of image file to PBM, PGM, or PPM |
| 11 |
|
| 12 |
<h2 id="synopsis">SYNOPSIS</h2> |
| 13 |
|
| 14 |
<b>anytopnm</b> [<i>file</i>] |
| 15 |
|
| 16 |
|
| 17 |
<h2 id="description">DESCRIPTION</h2> |
| 18 |
|
| 19 |
<p>This program is part of <a href="index.html">Netpbm</a>. |
| 20 |
|
| 21 |
<p><b>anytopnm</b> converts the input image, which may be in any of |
| 22 |
about 100 graphics formats, to PBM, PGM, or PPM format, depending on |
| 23 |
that nature of the input image, and outputs it to Standard Output. |
| 24 |
|
| 25 |
<p>To determine the format of the input, <b>anytopnm</b> uses the |
| 26 |
<b>file</b> program (possibly assisted by the magic numbers file |
| 27 |
fragment included with Netpbm). If that fails (very few image formats |
| 28 |
have magic numbers), <b>anytopnm</b> looks at the filename extension. |
| 29 |
If that fails, <b>anytopnm</b> punts. |
| 30 |
|
| 31 |
<p>The type of the output file depends on the input image. |
| 32 |
|
| 33 |
<p><b>anytopnm</b> uses the converters for particular graphics formats |
| 34 |
that are in the Netpbm package, so it can't convert any format that |
| 35 |
you couldn't convert with some other Netpbm program. What |
| 36 |
<b>anytopnm</b> adds is the ability to recognize the format and choose |
| 37 |
the appropriate Netpbm program to convert it. For example, if you |
| 38 |
invoke <b>anytopnm</b> on a GIF file, <b>anytopnm</b> will recognize |
| 39 |
that it is a GIF file and therefore <b>giftopnm</b> knows how to |
| 40 |
convert it to PNM, so <b>anytopnm</b> invokes <b>giftopnm</b>. |
| 41 |
|
| 42 |
<p><b>anytopnm</b> cannot recognize every possible input format, so you |
| 43 |
may still be able to convert an image with a specific Netpbm program when |
| 44 |
<b>anytopnm</b> fails to convert it. |
| 45 |
|
| 46 |
<p>If <b>file</b> indicates that the input file is compressed (either |
| 47 |
via Unix compress, gzip, or bzip compression), <b>anytopnm</b> |
| 48 |
uncompresses it and proceeds as above with the uncompressed result. |
| 49 |
|
| 50 |
<p>If <b>file</b> indicates that the input file is encoded by uuencode |
| 51 |
or btoa, <b>anytopnm</b> decodes it and proceeds as above with the |
| 52 |
decoded result. |
| 53 |
|
| 54 |
<p>If <i>file</i> is <b>-</b> or not given, <b>anytopnm</b> takes its |
| 55 |
input from Standard Input. |
| 56 |
|
| 57 |
<p>Many image formats are capable of representing multiple images. In |
| 58 |
most cases, <b>anytopnm</b> converts these to multi-image Netpbm images, |
| 59 |
but for some formats, <b>anytopnm</b> converts only the first image and |
| 60 |
ignores the rest. |
| 61 |
|
| 62 |
<p>In the case of a multi-image GIF input, <b>anytopnm</b> converts all the |
| 63 |
images starting with Netpbm 10.69 (December 2014), but only the first in |
| 64 |
earlier releases. |
| 65 |
|
| 66 |
|
| 67 |
<h2 id="options">OPTIONS</h2> |
| 68 |
|
| 69 |
<p>There are no command line options defined specifically |
| 70 |
for <b>anytopnm</b>. |
| 71 |
|
| 72 |
<b>anytopnm</b> does not recognize the options common to all |
| 73 |
programs based on libnetpbm (See <a href="index.html#commonoptions"> |
| 74 |
Common Options</a>.) However, the <b>-version</b> option works. |
| 75 |
|
| 76 |
<h2 id="seealso">SEE ALSO</h2> |
| 77 |
|
| 78 |
<b><a href="pamfile.html">pamfile</a></b>, |
| 79 |
<b><a href="pnm.html">pnm</a></b>, |
| 80 |
<b>file</b> man page |
| 81 |
|
| 82 |
<h2 id="author">AUTHOR</h2> |
| 83 |
|
| 84 |
Copyright (C) 1991 by Jef Poskanzer. |
| 85 |
|
| 86 |
<hr> |
| 87 |
<h2 id="index">Table Of Contents</h2> |
| 88 |
<ul> |
| 89 |
<li><a href="#synopsis">SYNOPSIS</a> |
| 90 |
<li><a href="#description">DESCRIPTION</a> |
| 91 |
<li><a href="#options">OPTIONS</a> |
| 92 |
<li><a href="#seealso">SEE ALSO</a> |
| 93 |
<li><a href="#author">AUTHOR</a> |
| 94 |
</ul> |
| 95 |
</body> |
| 96 |
</html> |