anytopnm - Man Page

convert an arbitrary type of image file to PBM, PGM, or PPM

Examples (TL;DR)

Synopsis

anytopnm [file]

Description

This program is part of Netpbm(1).

anytopnm converts the input image, which may be in any of about 100 graphics formats, to PBM, PGM, or PPM format, depending on that nature of the input image, and outputs it to Standard Output.

To determine the format of the input, anytopnm uses the file program (possibly assisted by the magic numbers file fragment included with Netpbm). If that fails (very few image formats have magic numbers), anytopnm looks at the filename extension. If that fails, anytopnm punts.

The type of the output file depends on the input image.

anytopnm uses the converters for particular graphics formats that are in the Netpbm package, so it can't convert any format that you couldn't convert with some other Netpbm program.  What anytopnm adds is the ability to recognize the format and choose the appropriate Netpbm program to convert it.  For example, if you invoke anytopnm on a GIF file, anytopnm will recognize that it is a GIF file and therefore giftopnm knows how to convert it to PNM, so anytopnm invokes giftopnm.

anytopnm cannot recognize every possible input format, so you may still be able to convert an image with a specific Netpbm program when anytopnm fails to convert it.

If file indicates that the input file is compressed (either via Unix compress, gzip, or bzip compression), anytopnm uncompresses it and proceeds as above with the uncompressed result.

If file indicates that the input file is encoded by uuencode or btoa, anytopnm decodes it and proceeds as above with the decoded result.

If file is - or not given, anytopnm takes its input from Standard Input.

Many image formats are capable of representing multiple images.  In most cases, anytopnm converts these to multi-image Netpbm images, but for some formats, anytopnm converts only the first image and ignores the rest.

In the case of a multi-image GIF input, anytopnm converts all the images starting with Netpbm 10.69 (December 2014), but only the first in earlier releases.

Options

There are no command line options defined specifically for anytopnm.

anytopnm does not recognize the options common to all programs based on libnetpbm (See Common Options .)  However, the -version option works.

See Also

pamfile(1), pnm(1), file man page

Author

Copyright (C) 1991 by Jef Poskanzer.

Document Source

This manual page was generated by the Netpbm tool 'makeman' from HTML source.  The master documentation is at

http://netpbm.sourceforge.net/doc/anytopnm.html

Referenced By

tuxpaint-import(1).

15 November 2014 netpbm documentation