RLEHDR(1)           UNIX Programmer's Manual            RLEHDR(1)



NAME
     rlehdr - Prints the header of an RLE file

SYNOPSIS
     rlehdr [ -b ] [ -c_c_o_m_m_e_n_t-_n_a_m_e_s ] [ -d ] [ -m ] [ -v ] [
     _f_i_l_e_s ... ]

DESCRIPTION
     This program prints the header of _R_L_E(5) files in a human
     readable form.  If the optional _f_i_l_e_s argument is not sup-
     plied, input is read from standard input.

OPTIONS
     -b   Print the information in a "brief" one-line form.  The
          form of the output line is
          _n_a_m_e: [_l,_b]+[_x_s,_y_s]x_n_c+A, BG=_c_o_l_o_r, map=_Nx_L, (C)
          Where [_l,_b] is the position of the lower-left corner of
          the image, [_x_s,_y_s] is the size of the image in pixels,
          _n_c is the number of channels saved, +A is present if an
          alpha channel is saved.  BG= or OV= indicate that a
          background color was saved; OV= means that the existing
          background is not cleared to the background color
          before the image is read (this was used for a cheap
          form of compositing, but is basically obsolete now).
          _c_o_l_o_r is the saved background color.  The map= entry
          will be present only if a color map was saved; _N is the
          number of channels in the color map and _L is the length
          of the map.  Finally (C) is appended if there are com-
          ments present.

     -c _c_o_m_m_e_n_t-_n_a_m_e_s
          If a comment identified by any of the words in the
          comma-separated list _c_o_m_m_e_n_t-_n_a_m_e_s is present in the
          input file, its first line will be printed.  Each name
          is tried, in turn, and only the first match is printed.
          If no match is found, but comments are present, (C)
          will be printed.  The -c flag implies -b.

     -d   Dump a very verbose version of the image contents as
          text to the standard error output stream.

     -m   Print out the color map information.  -v Prints the
          raster toolkit version and patch level.  No input files
          will be processed if this option is given.

EXAMPLES
     rlehdr image.rle
          Print the header information for all images in the file
          image.rle.

     rlehdr -m image.rle
          Also print the color map contents, if one is present.



Printed 5/12/93           Jan 22, 1987                          1






RLEHDR(1)           UNIX Programmer's Manual            RLEHDR(1)



     rlehdr -b *.rle
          Print one line summaries of all the images in the
          directory.

     rlehdr -c title,TITLE *.rle
          Print one line summaries of all the images, and print
          the title of any that have a title comment.

SEE ALSO
     _u_r_t(1), _R_L_E(5).

AUTHOR
     Spencer W. Thomas, University of Utah










































Printed 5/12/93           Jan 22, 1987                          2