Debian Codegraph @

upstream/debian-unstable/man1/anytopnm.1

raw
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