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.
Rview starts rendering the image from the selected viewpoint and gradually improves the resolution of the display until interrupted by keyboard input. Rview then issues a prompt (usually `:') and accepts a command line from the user. Rview may also stop its calculation and wait for command input if the resolution of the display has reached the resolution of the graphics device. At this point, it will give the `done:' prompt and await further instructions. If rview runs out of memory 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 generally recommended on virtual memory machines for efficiency reasons.
Rview 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 rview. Rview is intended as a quick interactive program for deciding viewpoints and debugging scene descriptions and is not suited for producing polished images.
aim [ mag [ x y z ] ]
Zoom in by mag on point x y z . The view point is held constant; 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.
frame [ xmin ymin xmax ymax ]
Set frame for refinement. If coordinates are absent, the cursor is used to pick frame boundaries. If ``all'' is specified, the frame is reset to the entire image.
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 rview 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 perspective 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.
set [ var [ val ] ]
Check/change program variable. If var is absent, the list of available variables is displayed. If val is absent, the current value of the variable is displayed and changed interactively. 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), 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), back face visibility (bv), specular jitter (sj), and specular threshold (st). Once a variable 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 program 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.
Table of Contents