| 1 |
\ |
| 2 |
.\" This man page was generated by the Netpbm tool 'makeman' from HTML source. |
| 3 |
.\" Do not hand-hack it! If you have bug fixes or improvements, please find |
| 4 |
.\" the corresponding HTML page on the Netpbm website, generate a patch |
| 5 |
.\" against that, and send it to the Netpbm maintainer. |
| 6 |
.TH "Anytopnm User Manual" 1 "15 November 2014" "netpbm documentation" |
| 7 |
|
| 8 |
.SH NAME |
| 9 |
anytopnm - convert an arbitrary type of image file to PBM, PGM, or PPM |
| 10 |
|
| 11 |
.UN synopsis |
| 12 |
.SH SYNOPSIS |
| 13 |
|
| 14 |
\fBanytopnm\fP [\fIfile\fP] |
| 15 |
|
| 16 |
|
| 17 |
.UN description |
| 18 |
.SH DESCRIPTION |
| 19 |
.PP |
| 20 |
This program is part of |
| 21 |
.BR "Netpbm" (1)\c |
| 22 |
\&. |
| 23 |
.PP |
| 24 |
\fBanytopnm\fP converts the input image, which may be in any of |
| 25 |
about 100 graphics formats, to PBM, PGM, or PPM format, depending on |
| 26 |
that nature of the input image, and outputs it to Standard Output. |
| 27 |
.PP |
| 28 |
To determine the format of the input, \fBanytopnm\fP uses the |
| 29 |
\fBfile\fP program (possibly assisted by the magic numbers file |
| 30 |
fragment included with Netpbm). If that fails (very few image formats |
| 31 |
have magic numbers), \fBanytopnm\fP looks at the filename extension. |
| 32 |
If that fails, \fBanytopnm\fP punts. |
| 33 |
.PP |
| 34 |
The type of the output file depends on the input image. |
| 35 |
.PP |
| 36 |
\fBanytopnm\fP uses the converters for particular graphics formats |
| 37 |
that are in the Netpbm package, so it can't convert any format that |
| 38 |
you couldn't convert with some other Netpbm program. What |
| 39 |
\fBanytopnm\fP adds is the ability to recognize the format and choose |
| 40 |
the appropriate Netpbm program to convert it. For example, if you |
| 41 |
invoke \fBanytopnm\fP on a GIF file, \fBanytopnm\fP will recognize |
| 42 |
that it is a GIF file and therefore \fBgiftopnm\fP knows how to |
| 43 |
convert it to PNM, so \fBanytopnm\fP invokes \fBgiftopnm\fP. |
| 44 |
.PP |
| 45 |
\fBanytopnm\fP cannot recognize every possible input format, so you |
| 46 |
may still be able to convert an image with a specific Netpbm program when |
| 47 |
\fBanytopnm\fP fails to convert it. |
| 48 |
.PP |
| 49 |
If \fBfile\fP indicates that the input file is compressed (either |
| 50 |
via Unix compress, gzip, or bzip compression), \fBanytopnm\fP |
| 51 |
uncompresses it and proceeds as above with the uncompressed result. |
| 52 |
.PP |
| 53 |
If \fBfile\fP indicates that the input file is encoded by uuencode |
| 54 |
or btoa, \fBanytopnm\fP decodes it and proceeds as above with the |
| 55 |
decoded result. |
| 56 |
.PP |
| 57 |
If \fIfile\fP is \fB-\fP or not given, \fBanytopnm\fP takes its |
| 58 |
input from Standard Input. |
| 59 |
.PP |
| 60 |
Many image formats are capable of representing multiple images. In |
| 61 |
most cases, \fBanytopnm\fP converts these to multi-image Netpbm images, |
| 62 |
but for some formats, \fBanytopnm\fP converts only the first image and |
| 63 |
ignores the rest. |
| 64 |
.PP |
| 65 |
In the case of a multi-image GIF input, \fBanytopnm\fP converts all the |
| 66 |
images starting with Netpbm 10.69 (December 2014), but only the first in |
| 67 |
earlier releases. |
| 68 |
|
| 69 |
|
| 70 |
.UN options |
| 71 |
.SH OPTIONS |
| 72 |
.PP |
| 73 |
There are no command line options defined specifically |
| 74 |
for \fBanytopnm\fP. |
| 75 |
|
| 76 |
\fBanytopnm\fP does not recognize the options common to all |
| 77 |
programs based on libnetpbm (See |
| 78 |
.UR index.html#commonoptions |
| 79 |
Common Options |
| 80 |
.UE |
| 81 |
\&.) However, the \fB-version\fP option works. |
| 82 |
|
| 83 |
.UN seealso |
| 84 |
.SH SEE ALSO |
| 85 |
.BR "pamfile" (1)\c |
| 86 |
\&, |
| 87 |
.BR "pnm" (1)\c |
| 88 |
\&, |
| 89 |
\fBfile\fP man page |
| 90 |
|
| 91 |
.UN author |
| 92 |
.SH AUTHOR |
| 93 |
|
| 94 |
Copyright (C) 1991 by Jef Poskanzer. |
| 95 |
.SH DOCUMENT SOURCE |
| 96 |
This manual page was generated by the Netpbm tool 'makeman' from HTML |
| 97 |
source. The master documentation is at |
| 98 |
.IP |
| 99 |
.B http://netpbm.sourceforge.net/doc/anytopnm.html |
| 100 |
.PP |