Quick Navigator

Search Site

Unix VPS
A - Starter
B - Basic
C - Preferred
D - Commercial
MPS - Dedicated
Previous VPSs
* Sign Up! *

Contact Us
Online Help
Domain Status
Man Pages

Virtual Servers

Topology Map

Server Agreement
Year 2038

USA Flag



Man Pages

Manual Reference Pages  -  RLATORLE (1)


rlatorle - convert a Wavefront "rla" or "rlb" image file into an RLE image file.


See Also


rlatorle [ -b ] [ -h ] [ -v ] [ -m ] [ -o outfile ] [ infile.rla ]


This program converts Wavefront image files (rla or rlb formats) into Utah RLE(5) image files. Wavefront image files store RGB data as well as a matte channel. They also define a "bounding box" containing non-background pixels which is in many cases smaller than the total image area. Only this non-background area is run length encoded. When converting to an RLE file, the matte channel is stored as an alpha channel and the "bounding box" dimensions are ignored. It is for this reason that in general the RLE version of the file will be larger than its Wavefront counterpart.

The RLE file will contain a "true color" image (24 bits). These RLE files may then be viewed using any RLE image viewer. When they are displayed on an 8 bit display, the image will be dithered. In order to produce a better looking image (on 8 bit displays), it is recommended that the image be quantizing (to 8 bit mapped color) prior to its display. This may be done by piping the output of this program into the Utah mcut(1) or rlequant(1) utilities. An example of this is shown later.


-b This option will cause rlatorle to convert from a Wavefront "rlb" image rather than use the default "rla" conversion.
-v This option will cause rlatorle to operate in verbose mode. The header information is written to "stderr".
-h This option allows the header of the wavefront image to be dumped to "stderr" without converting the file. It is equivalent to using the -v option except that no file conversion takes place.
-m This option will cause rlatorle to ignore the RGB data and use the matte channel information to produce a monochrome image. The resulting RLE image file will contain only one color channel instead of the usual four (RGB + alpha).
-o outfile
  If specified, the output will be written to this file. If outfile is "-", or if it is not specified, the output will be written to the standard output stream.
  The name of the Wavefront image data file to be converted. It is not necessary to supply the ".rla" or ".rlb" extension as it will be added to the supplied name if not already there.


rlatorle -v test.0001.rla -o test.rle
  While running in verbose mode, convert test.0001.rla to RLE format and store resulting data in test.rle.
rlatorle test.0001.rla | mcut >test.rle
  Convert test.0001.rla to RLE format and convert to 8 bit mapped color before storing data in test.rle
rlatorle -h test.0001.rla
  Dump the header information of the Wavefront file called test.0001.rla.
rlatorle -b test.0001 | get4d
  Convert test.0001.rlb to RLE format and display the resulting image.


mcut(1), rlequant(1), rletorla(1), urt(1), RLE(5).


Wesley C. Barris
Army High Performance Computing Research Center (AHPCRC)
Minnesota Supercomputer Center, Inc.
Search for    or go to Top of page |  Section 1 |  Main Index

1 RLATORLE (1) May 30, 1990

Powered by GSP Visit the GSP FreeBSD Man Page Interface.
Output converted with manServer 1.07.