LinuxCommandLibrary

pi1toppm

Convert Macintosh PICT file to PPM image

TLDR

Convert an Atari Degas PI1 image into PPM image

$ pi1toppm [path/to/atari_image.pi1] > [path/to/image.ppm]
copy

SYNOPSIS

pi1toppm [-gamma ] [pi1file]

PARAMETERS

-gamma
    Applies a gamma correction to the output image. is a floating-point number representing the gamma value.

pi1file
    The path to the input Atari ST .pi1 image file. If omitted, pi1toppm reads from standard input (stdin).

DESCRIPTION

pi1toppm is a utility from the Netpbm suite that transforms an Atari ST .pi1 format image file into a portable pixmap (PPM). The .pi1 format is a specific 16-color interlaced graphics format used on Atari ST computers. The command reads the .pi1 data from a specified file or standard input and outputs the converted image to standard output as a PPM file, which can then be further processed or viewed by other Netpbm tools or image viewers.

CAVEATS

Input must be a valid Atari ST .pi1 file. Incorrect or corrupted files may lead to unexpected output or errors.
The .pi1 format is a legacy format, and its primary use today is typically for converting historical graphics files.

STANDARD INPUT/OUTPUT

Like most Netpbm tools, pi1toppm is designed to work with standard input and output. It reads the .pi1 file from stdin if no pi1file argument is provided, and always writes the resulting PPM image to stdout. This allows for easy piping of data between commands, e.g., cat image.pi1 | pi1toppm | ppmtogif > image.gif.

HISTORY

pi1toppm is a component of the Netpbm project, a comprehensive toolkit for manipulating graphic images, especially suited for batch processing and scripting. Netpbm originated from the earlier Pbmplus package, developed by Jef Poskanzer in the late 1980s. The pi1toppm command was created to provide compatibility with legacy Atari ST .pi1 image files, allowing these older graphics to be integrated into modern image processing workflows via the versatile Netpbm framework. Its development reflects the Netpbm philosophy of providing robust converters for a vast array of image formats.

SEE ALSO

ppm(5), anytopnm(1), pnm(5), pc1toppm(1)

Copied to clipboard