1Anytopnm User Manual(0)                                Anytopnm User Manual(0)
2
3
4

NAME

6       anytopnm - convert an arbitrary type of image file to PBM, PGM, or PPM
7
8

SYNOPSIS

10       anytopnm [file]
11
12
13

DESCRIPTION

15       This program is part of Netpbm(1).
16
17       anytopnm  converts  the  input  image, which may be in any of about 100
18       graphics formats, to PBM, PGM, or PPM format, depending on that  nature
19       of the input image, and outputs it to Standard Output.
20
21       To  determine  the  format of the input, anytopnm uses the file program
22       (possibly assisted by the magic numbers  file  fragment  included  with
23       Netpbm).  If  that  fails  (very few image formats have magic numbers),
24       anytopnm looks at the filename  extension.   If  that  fails,  anytopnm
25       punts.
26
27       The type of the output file depends on the input image.
28
29       anytopnm  uses  the converters for particular graphics formats that are
30       in the Netpbm package, so it can't convert any format that you couldn't
31       convert  with  some  other  Netpbm  program.  What anytopnm adds is the
32       ability to recognize the format and choose the appropriate Netpbm  pro‐
33       gram to convert it.  For example, if you invoke anytopnm on a GIF file,
34       anytopnm will recognize that it is a GIF file  and  therefore  giftopnm
35       knows how to convert it to PNM, so anytopnm invokes giftopnm.
36
37       anytopnm cannot recognize every possible input format, so you may still
38       be able to convert an image with a specific Netpbm  program  when  any‐
39       topnm fails to convert it.
40
41       If  file  indicates  that the input file is compressed (either via Unix
42       compress, gzip, or bzip compression), anytopnm uncompresses it and pro‐
43       ceeds as above with the uncompressed result.
44
45       If  file  indicates that the input file is encoded by uuencode or btoa,
46       anytopnm decodes it and proceeds as above with the decoded result.
47
48       If file is - or not given,  anytopnm  takes  its  input  from  Standard
49       Input.
50
51       Many  image  formats  are  capable of representing multiple images.  In
52       most cases, anytopnm converts these to multi-image Netpbm  images,  but
53       for  some  formats,  anytopnm converts only the first image and ignores
54       the rest.
55
56       In the case of a multi-image  GIF  input,  anytopnm  converts  all  the
57       images  starting  with Netpbm 10.69 (December 2014), but only the first
58       in earlier releases.
59
60
61

OPTIONS

63       There are no command line options defined specifically for anytopnm.
64
65       anytopnm does not recognize the options common to all programs based on
66       libnetpbm (See
67        Common  Options  ⟨index.html#commonoptions⟩  .)  However, the -version
68       option works.
69
70

SEE ALSO

72       pamfile(1), pnm(1), file man page
73
74

AUTHOR

76       Copyright (C) 1991 by Jef Poskanzer.
77

DOCUMENT SOURCE

79       This manual page was generated by the Netpbm tool 'makeman'  from  HTML
80       source.  The master documentation is at
81
82              http://netpbm.sourceforge.net/doc/anytopnm.html
83
84netpbm documentation           15 November 2014        Anytopnm User Manual(0)