rvu
Radiance rvu program
RVU(1) RVU(1)
NAME
rvu - generate RADIANCE images interactively
SYNOPSIS
rvu [ rpict options ][ -n nproc ][ -o dev ][ -b ][ -pe exposure ] [
$EVAR ] [ @file ] octree
rvu [ options ] -defaults
rvu -devices
DESCRIPTION
Rvu generates RADIANCE images using octree. (The octree may be given
as the output of a command enclosed in quotes and preceded by a `!'.)
Options specify the viewing parameters as well as giving some control
over the calculation. Options may be given on the command line and/or
read from the environment and/or read from a file. A command argument
beginning with a dollar sign ('$') is immediately replaced by the con-
tents of the given environment variable. A command argument beginning
with an at sign ('@') is immediately replaced by the contents of the
given file. The options are the same as for rpict(1), with a few
notable exceptions. The -r, -z, -S, -P, -PP and -t options are not
supported, and -o specifies which output device is being used instead
of the output file. The -x, -y and -pa options are unnecessary, since
rvu scales the display image to the specified output device. Addition-
ally, the -b option improves the display on greyscale monitors, and -pe
may be used to set an initial exposure value.
The -n option may be used to specify multiple processes, to accelerate
rendering.
In the second form, the default values for the options are printed with
a brief explanation. In the third form, the list of supported output
devices is displayed.
rvu starts rendering the image from the selected viewpoint and gradu-
ally improves the resolution of the display until interrupted by key-
board input. rvu then issues a prompt (usually ':') and accepts a com-
mand line from the user. rvu may also stop its calculation and wait
for command input if the resolution of the display has reached the res-
olution of the graphics device. At this point, it will give the
'done:' prompt and await further instructions. If rvu runs out of mem-
ory due to lack of resources to store its computed image, it will give
the 'out of memory:' prompt. At this prompt, the user can save the
image, quit, or even restart a new image, although this is not gener-
ally recommended on virtual memory machines for efficiency reasons.
rvu is not meant to be a rendering program, and we strongly recommend
that rpict(1) be used instead for that purpose. Since rpict(1) does
not store its image in memory or update any display of its output, it
is much faster and less wasteful of its resources than rvu. rvu is
intended as a quick interactive program for deciding viewpoints and
debugging scene descriptions and is not suited for producing polished
images.
COMMANDS
Once the program starts, a number of commands can be used to control
it. A command is given by its name, which can be abbreviated, followed
by its arguments.
aim [ mag [ x y z ] ]
Zoom in by mag on point x y z . The view point is held con-
stant; only the view direction and size are changed. If x y
z is missing, the cursor is used to select the view center.
A negative magnification factor means zoom out. The default
factor is one.
^C Interrupt. Go to the command line.
exposure [ spec ]
Adjust exposure. The number spec is a multiplier used to
compensate the average exposure. A value of 1 renormalizes
the image to the computed average, which is usually done
immediately after startup. If spec begins with a '+' or '-',
the compensation is interpreted in f-stops (ie. the power of
two). If spec begins with an '=', an absolute setting is
performed. An '=' by itself permits interactive display and
setting of the exposure. If spec begins with an '@', the
exposure is adjusted to present similar visibility to what
would be experienced in the real environment. If spec is
absent, or an '@' is followed by nothing, then the cursor is
used to pick a specific image location for normalization.
focus [distance]
Set focus distance for depth-of-field sampling. If a dis-
tance in world coordinates is absent, then the cursor is used
to choose a point in the scene on which to focus. (The focus
distance setting does not affect rendering in rview, but can
be used in rpict with the -pd option to simulate depth-of-
field on views saved from rview.)
frame [ xmin ymin xmax ymax ]
Set frame for refinement. If coordinates are absent, the
cursor is used to pick frame boundaries. If ``all'' is spec-
ified, the frame is reset to the entire image.
free Free cached object structures and associated data. This com-
mand may be useful when memory is low and a completely dif-
ferent view is being generated from the one previous.
last [ file ]
Restore the previous view. If a view or picture file is
specified, the parameters are taken from the last view entry
in the file.
L [ vw [ rfile ] ]
Load parameters for view vw from the rad(1) input file,
rfile. Both vw and rfile must be given the first call, but
subsequent calls will use the last rfile as a default, and
"1" as the default view (ie. the first view appearing in
rfile). If rvu was started by rad, then the rfile parameter
will initially default to the rad input file used.
move [ mag [ x y z ] ]
Move camera mag times closer to point x y z . For a perspec-
tive projection (or fisheye view), only the view point is
changed; the view direction and size remain constant. The
view size must be modified in a parallel projection since it
determines magnification. If x y z is missing, the cursor is
used to select the view center. A negative magnification
factor decreases the object size. The default factor is one.
Care must be taken to avoid moving behind or inside other
objects.
new [ nproc ]
Restart the image, using the specified number of rendering
processes. Usually used after the "set" command.
pivot angle [ elev [ mag [ x y z ] ] ]
Similar to the "move" command, but pivots the view about a
selected point. The angle is measured in degrees around the
view up vector using the right hand rule. The optional elev
is the elevation in degrees from the pivot point; positive
raises the view point to look downward and negative lowers
the view point to look upward.
quit Quit the program.
^R Redraw the image. Use when the display gets corrupted. On
some displays, occassionally forcing a redraw can improve
appearance, as more color information is available and the
driver can make a better color table selection.
rotate angle [ elev [ mag ] ]
Rotate the camera horizontally by angle degrees. If an ele-
vation is specified, the camera looks upward elev degrees.
(Negative means look downward.)
set [ var [ val ] ]
Check/change program variable. If var is absent, the list of
available variables is displayed. If val is absent, the cur-
rent value of the variable is displayed and changed interac-
tively. Otherwise, the variable var assumes the value val.
Variables include: ambient value (av), ambient value weight
(aw), ambient bounces (ab), ambient accuracy (aa), ambient
divisions (ad), ambient radius (ar), ambient samples (as),
black&white (b), back face visibility (bv), direct jitter
(dj), direct sampling (ds), direct threshold (dt), direct
visibility (dv), irradiance (i), limit weight (lw), limit
recursion (lr), medium extinction (me), medium albedo (ma),
medium eccentricity (mg), medium sampling (ms), pixel sample
(ps), pixel threshold (pt), specular jitter (sj), specular
threshold (st), and uncorrelated sampling (u). Once a vari-
able has been changed, the "new" command can be used to
recompute the image with the new parameters. If a program
variable is not available here, it may show up under some
other command or it may be impossible to change once the pro-
gram is running.
trace [ xbeg ybeg zbeg xdir ydir zdir ]
Trace a ray. If the ray origin and direction are absent, the
cursor is used to pick a location in the image to trace. The
object intersected and its material, location and value are
displayed.
view [ file [ comments ] ]
Check/change view parameters. If file is present, the view
parameters are appended to a file, followed by comments if
any. Alternatively, view options may be given directly on
the command line instead of an output view file. Otherwise,
view parameters are displayed and changed interactively.
V [ vw [ rfile ] ]
Append the current view as view vw in the rad file rfile.
Compliment to L command. Note that the view is simply
appended to the file, and previous views with the same name
should be removed before using the file with rad.
write [ file ]
Write picture to file. If argument is missing, the current
file name is used.
^Z Stop the program. The screen will be redrawn when the pro-
gram resumes.
ENVIRONMENT
RAYPATH the directories to check for auxiliary files. DIS-
PLAY_GAMMA the value to use for monitor gamma correction.
AUTHOR
Greg Ward
SEE ALSO
getinfo(1), lookamb(1), oconv(1), pfilt(1), rad(1), rpict(1), rtrace(1)
RADIANCE 1/1/04 RVU(1)
Man(1) output converted with man2html
by
admin
– last modified
Nov 09, 2019 09:22 AM