RLETOPNM(1)

💖 RLETOPNM(1) — the Rletopnm User Manual, bestie edition 💖

okay so. this is a General Commands Manual page, specifically the Rletopnm User Manual, and I'm about to make it make sense. sit down, hydrate, let's go 🫶

---

✨ NAME ✨

rletopnm — convert a Utah Raster Tools RLE image file to a PNM image file. that's it, that's the whole job, and it does it flawlessly 💅

---

🌸 SYNOPSIS 🌸

rletopnm

[--alphaout={alpha-filename,-}] [--headerdump|-h]

[--verbose|-v]

[rlefile|-]

All options may be abbreviated to their minimum unique abbreviation and options and arguments may be in any order. yes queen, you can shuffle them around however you want, she's flexible like that ✨

---

🦋 DESCRIPTION 🦋

This program is part of Netpbm(1).

rletopnm converts Utah Raster Toolkit RLE image files to PNM image files. and not to be dramatic but she handles four types of RLE files, no cap:

• Grayscale — 8 bit data, no color map
• Pseudocolor — 8 bit data with a color map
• Truecolor — 24 bit data with color map
• Directcolor — 24 bit data, no color map

rletopnm generates a PPM file for all these cases except for the Grayscale file, for which rletopnm generates a PGM file. yeah. grayscale gets its own whole file format. she's special like that, we respect it 💖

rlefile is the RLE input file. If it is absent or -, the input comes from Standard Input. so if you just pipe it in with nothing to say, she'll take it from stdin, no questions asked 🎀

---

💅 OPTIONS 💅

In addition to the options common to all programs based on libnetpbm (most notably -quiet, see Common Options), rletopnm recognizes the following command line options:

• --alphaout=alpha-filename — okay so this one's the moment. rletopnm creates a PGM (portable graymap) file containing the transparency channel values in the input image. If the input image doesn't contain a transparency channel, the alpha-filename file contains all zero (transparent) transparency values. If you don't specify --alphaout, rletopnm does not generate a transparency file, and if the input image has a transparency channel, rletopnm simply discards it 😭 (she's not being mean, she just moves on).

If you specify - as the filename, rletopnm writes the transparency output to Standard Output and discards the image. yes, the WHOLE image. gone. bestie please read that twice 😭

See pamcomp(1) for one way to use the transparency output file.

• --verbose — this option causes rletopnm to operate in verbose mode. It prints messages about what it's doing, including the contents of the RLE image header, to Standard Error. she's narrating her life. main character energy fr fr 👑
• --headerdump — this option causes rletopnm to operate in header dump mode. It prints the contents of the RLE image header to Standard Error, but does not produce any other output. just the header, nothing else, she said look but don't touch 🧚

---

🌈 EXAMPLES 🌈

1. While running in verbose mode, convert lenna.rle to PPM format and store the resulting image as lenna.ppm:

rletopnm --verbose lenna.rle >lenna.ppm

2. Dump the header information of the RLE file called file.rle:

rletopnm --headerdump file.rle

3. Convert RLE file dart.rle to PPM format as dart.ppm. Store the transparency channel of dart.rle as dartalpha.pgm (if dart.rle doesn't have a transparency channel, store a fully transparent transparency mask as dartalpha.pgm):

rletopnm --alphaout=dartalpha.pgm dart.rle >dart.ppm

---

👀 SEE ALSO 👀

pnmtorle(1), pnmconvol(1), pnm(1), ppm(1), pgm(1),

---

🫶 AUTHOR 🫶

Wes Barris Army High Performance Computing Research Center (AHPCRC) Minnesota Supercomputer Center, Inc.

Modifications by Eric Haines to produce raw and plain formats.

Modifications by Bryan Henderson to create transparency files and use mnemonic options.

three absolute legends, we stan all of them 💜

---

📜 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/rletopnm.html

---

Netpbm documentation, last touched 13 April 2000. slay, periodt, go convert some RLE files bestie 🎀✨💖