RA_RGBE(1)                                                          RA_RGBE(1)



NNAAMMEE
       ra_rgbe - convert between different RADIANCE picture types

SSYYNNOOPPSSIISS
       rraa__rrggbbee [ --rr ][ --ee ++//--ssttooppss ][ --ff ][ --nn ffrraammeennoo ] [ iinnppuutt [ oouuttssppeecc ] ]

DDEESSCCRRIIPPTTIIOONN
       _R_a___r_g_b_e converts between RADIANCE run-length encoded and flat  formats,
       and  separates concatanated animation frames produced by _r_p_i_c_t_(_1_)_.  The
       _-_e option specifies an exposure  compensation  in  f-stops  (powers  of
       two).   Only  integer  stops  are allowed, for efficiency.  By default,
       _r_a___r_g_b_e produces a flat RADIANCE picture file from any type of RADIANCE
       input  picture.   The  _-_r option causes _r_a___r_g_b_e to produce a run-length
       encoded file instead.

       If the input file consists of multiple animation frames as produced  by
       _r_p_i_c_t  with the _-_S option, _r_a___r_g_b_e will read each frame and write it to
       the output file created by calling _p_r_i_n_t_f_(_3_) with the output specifica-
       tion and frame number as arguments.  If the output specification begins
       with an exclamation mark ('!'), then  this  interpreted  as  a  command
       spec.,  which  is  also run through _p_r_i_n_t_f with the frame number to get
       the final command.  This command must accept a Radiance picture on  its
       standard  input, and may write results either to a file or to the stan-
       dard output.  The _-_n option may be used to select a specific frame  for
       output,  and  other frames in the input will be skipped.  Normally, all
       frames will be read and written.

       _R_a___r_g_b_e will report an error and exit if the target output file already
       exists,  unless the _-_f option is given.  If the output file is missing,
       the standard output is used.  If the input file is missing  or  set  to
       '-', the standard input is used.

NNOOTTEESS
       The  file  format for RADIANCE pictures was changed between release 1.4
       and release 2.0.  The older format can still be read by  all  the  pro-
       grams, but only the newer format is produced.  This newer format cannot
       be read by RADIANCE software prior to release 2.0.

       _R_a___r_g_b_e provides some downward compatibility by  producing  files  that
       can  be  read by older RADIANCE software.  The resultant files are also
       easier to manipulate with programs designed to read raw raster data.

       The other use for _r_a___r_g_b_e is as a quicker way to adjust the exposure of
       a  RADIANCE picture than _p_f_i_l_t_(_1_)_, since _r_a___r_g_b_e only allows integer f-
       stop changes.  In this mode, _r_a___r_g_b_e should be used with the _-_r option.

AAUUTTHHOORR
       Greg Ward

AACCKKNNOOWWLLEEDDGGEEMMEENNTT
       Work  on  this program was initiated and sponsored by the LESO group at
       EPFL in Switzerland.

SSEEEE AALLSSOO
       pfilt(1), printf(1), ra_xyze(1), rpict(1)



RADIANCE                            1/23/98                         RA_RGBE(1)
