Debian Codegraph @

userguide/anytopnm.html

raw
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>