Radiance rhpict program



RHPICT(1)                                                            RHPICT(1)




NAME

       rhpict - render a RADIANCE picture from a holodeck file


SYNOPSIS

       rhpict [ options ] holodeck


DESCRIPTION

       Rhpict  generates  one or more pictures from the RADIANCE holodeck file
       holodeck and sends them to the standard output.  The -o option  may  be
       used  to  specify  an alternate output file.  Other options specify the
       viewing parameters and provide some control over the calculation.

       The view as well as some of the other controls  are  shared  in  common
       with  the  rpict(1) command.  The options that are unique to rhpict are
       given first, followed by the more familiar ones.

       -s        Use the smooth resampling algorithm, which amounts to  linear
                 interpolation between ray samples with additional edge detec-
                 tion along color and object boundaries.  This is the default.

       -r rf     Use  random  resampling,  where  rf is a fraction from 0 to 1
                 indicating the desired degree of randomness.  A random  frac-
                 tion of 0 is not the same as smooth resampling, because there
                 is no linear interpolation,  just  Voronoi  regions.   Values
                 greater than 1 produce interesting underwater effects.

       -x res    Set the maximum x resolution to res.

       -y res    Set the maximum y resolution to res.

       -pa rat   Set  the  pixel  aspect  ratio  (height  over  width) to rat.
                 Either the x or the y resolution will be reduced so that  the
                 pixels  have  this  ratio  for the specified view.  If rat is
                 zero, then the x and y resolutions will adhere to  the  given
                 maxima.

       -pe expval
                 Set  the  exposure  value  for the output pictures to expval.
                 Since filtering is performed by rhpict, there is little sense
                 in  passing  the output through pfilt(1), other than changing
                 the exposure.  This option eliminates that need.   The  value
                 may  be  specified  either as a multiplier, or as a number f-
                 stops preceeded by a '+' or '-' character.

       -vtt      Set view type to t.  If t  is  'v',  a  perspective  view  is
                 selected.  If t is 'l', a parallel view is used.  A cylindri-
                 cal panorma may be selected by setting t to the  letter  'c'.
                 This view is like a standard perspective vertically, but pro-
                 jected on  a  cylinder  horizontally  (like  a  soupcan's-eye
                 view).   Two fisheye views are provided as well; 'h' yields a
                 hemispherical fisheye view and 'a' results in angular fisheye
                 distortion.   A  hemispherical fisheye is a projection of the
                 hemisphere onto a circle.  The maximum view  angle  for  this
                 type is 180 degrees.  An angular fisheye view is defined such
                 that distance from the center of the image is proportional to
                 the  angle from the central view direction.  An angular fish-
                 eye can display a full 360 degrees.  Note that  there  is  no
                 space  between  the  view  type  option and its single letter
                 argument.

       -vp x y z Set the view point to x y z .  This is the focal point  of  a
                 perspective view or the center of a parallel projection.

       -vd xd yd zd
                 Set the view direction vector to xd yd zd .

       -vu xd yd zd
                 Set the view up vector (vertical direction) to xd yd zd .

       -vh val   Set  the view horizontal size to val.  For a perspective pro-
                 jection (including fisheye  views),  val  is  the  horizontal
                 field  of  view (in degrees).  For a parallel projection, val
                 is the view width in world coordinates.

       -vv val   Set the view vertical size to val.

       -vo val   Set the view fore clipping plane at a distance  of  val  from
                 the  view point.  The plane will be perpendicular to the view
                 direction for perspective and parallel view types.  For fish-
                 eye  view  types,  the  clipping plane is actually a clipping
                 sphere, centered on the view point with radius val.   Objects
                 in front of this imaginary surface will not be visible.  This
                 may be useful for seeing through walls (to get a longer  per-
                 spective from an exterior view point) or for incremental ren-
                 dering.  A value of zero implies no foreground  clipping.   A
                 negative  value  produces  some interesting effects, since it
                 creates an inverted image for objects behind  the  viewpoint.
                 This  possibility  is provided mostly for the purpose of ren-
                 dering stereographic holograms.

       -va val   Set the view aft clipping plane at a distance of val from the
                 view point.  Like the view fore plane, it will be perpendicu-
                 lar to the view direction for perspective and  parallel  view
                 types.   For  fisheye view types, the clipping plane is actu-
                 ally a clipping sphere,  centered  on  the  view  point  with
                 radius  val.   Objects behind this imaginary surface will not
                 be visible.  A value of zero means no aft  clipping,  and  is
                 the  only  way  to see infinitely distant objects such as the
                 sky.

       -vs val   Set the view shift to val.  This is  the  amount  the  actual
                 image  will  be  shifted  to the right of the specified view.
                 This is option is useful for generating  skewed  perspectives
                 or  rendering an image a piece at a time.  A value of 1 means
                 that the rendered image starts just to the right of the  nor-
                 mal  view.   A  value  of -1 would be to the left.  Larger or
                 fractional values are permitted as well.

       -vl val   Set the view lift to val.  This  is  the  amount  the  actual
                 image  will  be lifted up from the specified view, similar to
                 the -vs option.

       -vf file  Get view parameters from file, which may be a  picture  or  a
                 file created by rvu (with the "view" command).

       -S seqstart
                 Instead of generating a single picture based only on the view
                 parameters given on the  command  line,  this  option  causes
                 rhpict  to  read view options from the standard input and for
                 each line containing a valid view specification,  generate  a
                 corresponding  picture.   Seqstart is a positive integer that
                 will be associated with the first output  frame,  and  incre-
                 mented  for successive output frames.  By default, each frame
                 is concatenated to the output stream, but it is  possible  to
                 change  this  action  using  the -o option (described below).
                 Multiple frames may be later extracted from a  single  output
                 stream using the ra_rgbe(1) command.

       -o fspec  Send  the picture(s) to the file(s) given by fspec instead of
                 the standard output.  If this option is used  in  combination
                 with  -S  and  fspec  contains an integer field for printf(3)
                 (eg., "%03d") then the actual output file name  will  include
                 the current frame number.

       -w        Turn off warning messages.


EXAMPLE

       rhpict -vp 10 5 3 -vd 1 -.5 0 scene.hdk > scene.pic

       rpict -S 1 -o frame%02d.pic scene.hdk < keyframes.vf


AUTHOR

       Greg Ward


SEE ALSO

       getinfo(1),  pfilt(1),  pinterp(1),  printf(3),  ra_rgbe(1),  rholo(1),
       rpict(1), rvu(1)



RADIANCE                            3/10/99                          RHPICT(1)

Man(1) output converted with man2html