PVALUE(1)                                                            PVALUE(1)



NNAAMMEE
       pvalue - convert RADIANCE picture to/from alternate formats

SSYYNNOOPPSSIISS
       ppvvaalluuee [ ooppttiioonnss ] [ ffiillee ]
       ppvvaalluuee --rr [ ooppttiioonnss ] [ ffiillee11 [ ffiillee22 ffiillee33 ] ]

DDEESSCCRRIIPPTTIIOONN
       _P_v_a_l_u_e  converts  the  pixels  of a RADIANCE picture to or from another
       format.  In the default mode, pixels are sent to the  standard  output,
       one per line, in the following ascii format:

            xpos ypos red  green     blue

       If no _f_i_l_e is given, the standard input is read.

       The reverse conversion option _(_-_r_) may be used with a single input file
       or when reading from the standard input, but if the second form is used
       with three separate input files, the three primaries are presumed to be
       separated in these files.

       --uu        Print only unique values in  the  output,  skipping  runs  of
                 equal  pixels.  Specifying _+_u turns this option off, which is
                 the default.

       --oo        Print original values, before exposure compensation.  If  the
                 input file is in XYZE format, the Y (green) channel will cor-
                 respond to units of  candelas/meter^2.   Otherwise,  the  RGB
                 values should be in spectral watts/steradian/meter^2.  Speci-
                 fying _+_o uses final exposed values, which is the default.

       --hh        Do not print header.  Specifying _+_h causes the header  to  be
                 printed, which is the default.

       --HH        Do  not print the resolution string.  (See also the _-_r option
                 below.)  Specifying an input resolution for  reverse  conver-
                 sion  also  turns  this option off.  Specifying _+_H causes the
                 resolution string to be printed, which is the default.

       --ss _n_b_y_t_e_s Skip the specified number of bytes on the input header.  This
                 option  is useful for skipping unintelligible headers in for-
                 eign file formats.  (Does not work when reading from standard
                 input.)

       --ee _e_x_p_o_s_u_r_e
                 Adjust the exposure by the amount specified.  If the exposure
                 is being given as a conversion factor, use _+_e instead, so  an
                 EXPOSURE line will not be recorded in the header (if any).

       --gg _g_a_m_m_a  Set  gamma correction for conversion.  When converting from a
                 RADIANCE picture to another  format,  the  inverse  gamma  is
                 applied  to correct for monitor response.  When converting to
                 a RADIANCE picture _(_-_r option), the gamma is applied directly
                 to  recover  the  linear values.  By default, _g_a_m_m_a is set to
                 1.0, meaning no gamma correction is performed.

       --dd        Data only, do not print x and y pixel position.

       --ddaa       Same as _-_d_.

       --ddii       Print ascii integer values from 0 to 255+.  If _+_d_i is  given,
                 the  integer  values  will  be  preceded by the x and y pixel
                 locations.

       --ddbb       Output binary byte values from 0 to 255.

       --ddww       Output binary 16-bit words from 0 to 65535.

       --ddWW       Output binary 16-bit words from 0 to 65535, byte-swapped.

       --ddff       Output binary float values.

       --ddFF       Output byte-swapped binary float values.

       --dddd       Output binary double values.

       --ddDD       Output byte-swapped binary double values.

       --RR        Reverse ordering of colors so that the output  is  blue  then
                 green  then red.  The default ordering (specified with _+_R_) is
                 red then green then blue.

       --nn        The RGB values are non-interleaved, meaning that all the red,
                 green  and  blue data are stored together in separate chunks.
                 Interleaving may be turned on with the _+_n  option,  which  is
                 the default.

       --bb        Print brightness values rather than RGB.  Specifying _+_b turns
                 this option off, which is the default.

       --pp_P       Put out only the primary _P_, where _P is one of upper or  lower
                 case  'R',  'G'  or 'B' for red, green or blue, respectively.
                 This option may be used to separate  the  Radiance  primaries
                 into  three files with three separate runs of _p_v_a_l_u_e_, or only
                 one file when only one primary is needed.  Note that there is
                 no space between this option and its argument.

       --rr        Perform  reverse conversion.  Input is in the format given by
                 the other options.  The x and y resolution must be  specified
                 on  the  command line, unless the image file contains a Radi-
                 ance resolution string at the beginning (see _-_H option  above
                 and _-_y option below).  Specifying _+_r converts from a Radiance
                 picture to other values, which is the default.

       --yy _r_e_s    Set the output y resolution to _r_e_s_.  If _+_y is specified, then
                 the scanlines are assumed to be in increasing order (ie. bot-
                 tom to top).  The default value for this option is  0,  which
                 means that the picture size and scanline order must appear as
                 the first line after the header (if any) in the  input  file.
                 Either  an  upper  or  lower  case  'Y'  may be used for this
                 option.  Since Radiance files always  contain  such  a  line,
                 this option has no effect for forward conversions.

       ++xx _r_e_s    Set the output x resolution to _r_e_s_.  If _-_x is specified, then
                 the scanlines are assumed to  be  in  decreasing  order  (ie.
                 right to left).  The ordering of the _-_y and _+_x options deter-
                 mines whether the scanlines are sorted along x  or  along  y.
                 Most Radiance pictures are sorted top to bottom, then left to
                 right.  This corresponds to a specification of the  form  "-y
                 yres +x xres".  Either an upper or lower case 'X' may be used
                 for this option.  Like the _-_y  option,  _-_x  options  have  no
                 effect for forward conversions.

EEXXAAMMPPLLEE
       To look at the original, unique pixels in picture:

         pvalue -o -u picture | more

       To  convert from a 512x400 8-bit greyscale image in bottom to top, left
       to right scanline ordering:

         pvalue -r -db -b -h +y 400 +x 512 input.im > flipped.hdr
         pflip -v flipped.hdr > final.hdr

AAUUTTHHOORR
       Greg Ward

BBUUGGSS
       The _-_r option does not work with the  _-_u  option.   Also,  input  pixel
       locations  are ignored during a reverse conversion, so this information
       is not used in determining the scanline ordering or picture size.

SSEEEE AALLSSOO
       getinfo(1),  pcompos(1),  pfilt(1),  pflip(1),  protate(1),   rpict(1),
       rtrace(1), rvu(1)



RADIANCE                            1/15/99                          PVALUE(1)
