Next: Making Data Tables from
Up: Command Line Utilities
Previous: Command Line Utilities
The any2ppm program converts bitmap files from the Portable Pixmap
(PPM), Windows BMP, and GIF formats into the Portable Pixmap P3
(text) format or the uncompressed 24 bits-per-pixel BMP binary format.
Additional formats may be available if the Tcl/Tk Img
package is installed on your system. (Note: OOMMF support for BMP
requires Tk 8.0 or later.)
Bitmap File Format Conversion:
The any2ppm launch command is:
tclsh oommf.tcl any2ppm [standard options] [-f] [-format fmt] \
[-noinfo] [-o outfile] [infile ...]
- Force output. If the -o option is not specified, then the output
filename is automatically generated by stripping the extension, if
any, off of each input filename, and appending a format-specific
extension (e.g., .ppm). If -f is specified, that generated
filename is used for the output filename. If -f is not
specified, then a check is made to see if the generated filename
already exists. If so, then an additional ``-000'' or ``-001''
... suffix is appended to create an unused filename. If the input
is coming from stdin, i.e., there is no input filename, then the
default output is to stdout.
- -format fmt
- Output file format. The default is PPM, which is the Portable
Pixmap P3 (text) format. Setting fmt to BMP will
produce files in the uncompressed Windows BMP 24
bits-per-pixel format. If the Tcl/Tk Img package is installed,
then additional formats, such as PNG, JPEG and TIFF, will be
available. The default output file extension depends on the format
selected, e.g., .ppm for PPM files and .bmp for BMP files.
- Suppress writing of progress information to stderr.
- -o outfile
- Write output to outfile; use ``-'' to pipe output to stdout.
Note that if outfile is specified, then all output will go to
this one file; in this case it is unlikely that one wants to specify
more than one input file.
- infile ...
- List of input files to process. If none, or if an infile is the empty
string, then read from stdin.
Note: If the output is to stdout, and the selected output
format is anything other than PPM, then the output is first written
to a temporary file before being copied to stdout. Under normal
operation the temporary file will be automatically deleted, but this is
not guaranteed if the program terminates abnormally.
Tk Requirement: any2ppm uses the
Tk image command in its processing. This requires that Tk be
properly initialized, which in particular means that a valid display
must be available. This is not a problem on Windows, where a desktop
is always present, but on Unix this means that an X server must be
virtual framebuffer can be used if desired. (Xvfb is an X server
distributed with X11R6 that requires no display hardware or physical
OOMMF Documentation Team
September 28, 2012