NAME
      rawtorle - Convert raw image data to RLE.

 SYNOPSIS
      rawtorle [ -N ] [ -s ] [ -r ] [ -w width ] [ -h height ] [ -f header-
      size ] [ -t trailer-size ] [ -n nchannels ] [ -a [ alpha-value ] ] [ -p
      scanline-pad ] [ -l left-scanline-pad ] [ -o outfile ] [ infile ]

 DESCRIPTION
      This program is used to convert image data in
      any of a number of "raw" forms to the RLE(5)
      format.  The expected input size is computed
      from the arguments, so that several images
      may be concatenated together and will be
      processed in sequence.  In this case, the
      output file will contain several RLE images.

 OPTIONS
      -N   The input is in non-interleaved order,
           as might be generated by the command
           cat pic.r pic.g pic.b

      -s   The input is in scanline interleaved
           order.

      -r   Reverse the channel order.  (E.g., data
           will be interpreted as ABGR instead of
           RGBA.)

      -w width
           Specify the width of the input image.

      -h height
           Specify the height of the input image.

      -f header-size
           This many bytes will be skipped before
           starting to read image data.

      -t trailer-size
           This many bytes will be skipped at the
           end of the image data.

      -n nchannels
           The input data has this many color
           channels.

      -a [alpha-value]
           Generate a constant alpha channel.  The
           default value for alpha-value is 255.
9
      -p scanline-pad
           This many bytes will be skipped at the
           end of each scanline.

      -l left-scanline-pad
           This many bytes will be skipped at the
           beginning of each scanline.

      -o outfile
           If specified, output will be written to
           this file, otherwise it will go to
           stdout.

      infile
           The input will be read from this file,
           otherwise, input will be taken from
           stdin.  The input data is assumed to
           have an alpha channel if there are 2 or
           4 channels.  The alpha channel is the
           last input channel unless -r is
           specified, in which case it is the
           first.

 EXAMPLES
      512x512 grayscale
           rawtorle -w 512 -h 512 -n 1

      640x512 raw RGB
           rawtorle -w 640 -h 512 -n 3

      picture.[rgb]
           cat picture.[rgb] | rawtorle -w 640 -h
           512 -n 3 -N -r
           (I.e., separate red, green, blue image
           files.  This subsumes graytorle(1).)

      JPL ODL Voyager pics
           rawtorle -w 800 -h 800 -f 2508 -t 1672
           -n 1 -p 36

      24bit Sun raster file
           rawtorle -f 32 -w ... -h ... -n 3
           (But rastorle(1) is easier.)

      pic.{000-100}.[rgb]
           cat pic.* | rawtorle -w ... -h ... -n 3
           -s -r
           (I.e., each color of each scanline is in
           a separate file.)

9

      graytorle(1), rastorle(1), urt(1), RLE(5).

 AUTHOR
      Martin Friedmann













































9