| 7 |
|
[ |
| 8 |
|
.B "rpict options" |
| 9 |
|
][ |
| 10 |
+ |
.B "\-n nproc" |
| 11 |
+ |
][ |
| 12 |
|
.B "\-o dev" |
| 13 |
|
][ |
| 14 |
|
.B \-b |
| 42 |
|
replaced by the contents of the given file. |
| 43 |
|
The options are the same as for rpict(1), with a few notable exceptions. |
| 44 |
|
The |
| 45 |
< |
.I "\-r, \-z, \-S, \-P, \-PP" |
| 45 |
> |
.I "\-pd, \-r, \-z, \-S, \-P, \-PP" |
| 46 |
|
and |
| 47 |
|
.I \-t |
| 48 |
|
options are not supported, and |
| 62 |
|
.I \-pe |
| 63 |
|
may be used to set an initial exposure value. |
| 64 |
|
.PP |
| 65 |
+ |
The |
| 66 |
+ |
.I \-n |
| 67 |
+ |
option may be used to specify multiple processes, |
| 68 |
+ |
to accelerate rendering. |
| 69 |
+ |
.PP |
| 70 |
|
In the second form, the default values |
| 71 |
|
for the options are printed with a brief explanation. |
| 72 |
|
In the third form, the list of supported output devices |
| 154 |
|
the cursor is used to pick a specific image |
| 155 |
|
location for normalization. |
| 156 |
|
.TP |
| 157 |
+ |
.BI focus " [distance]" |
| 158 |
+ |
Set focus distance for depth-of-field sampling. |
| 159 |
+ |
If a distance in world coordinates is absent, then the cursor |
| 160 |
+ |
is used to choose a point in the scene on which to focus. |
| 161 |
+ |
(The focus distance setting does not affect rendering in |
| 162 |
+ |
.I rvu, |
| 163 |
+ |
but can be used in |
| 164 |
+ |
.I rpict |
| 165 |
+ |
with the |
| 166 |
+ |
.I \-pd |
| 167 |
+ |
option to simulate depth-of-field on views saved from |
| 168 |
+ |
.I rvu.) |
| 169 |
+ |
.TP |
| 170 |
|
.BI frame " [ xmin ymin xmax ymax ]" |
| 171 |
|
Set frame for refinement. |
| 172 |
|
If coordinates are absent, the cursor is used to |
| 207 |
|
.I rad, |
| 208 |
|
then the |
| 209 |
|
.I rfile |
| 210 |
< |
parameter will initially default to the rad input file used. |
| 210 |
> |
parameter will initially default to the |
| 211 |
> |
.I rad |
| 212 |
> |
input file used. |
| 213 |
|
.TP |
| 214 |
|
.BI move " [ mag [ x y z ] ]" |
| 215 |
|
Move camera |
| 228 |
|
The default factor is one. |
| 229 |
|
Care must be taken to avoid moving behind or inside other objects. |
| 230 |
|
.TP |
| 231 |
< |
.BR new |
| 232 |
< |
Restart the image. |
| 231 |
> |
.BI new " [ nproc ]" |
| 232 |
> |
Restart the image, using the specified number of rendering processes. |
| 233 |
|
Usually used after the "set" command. |
| 234 |
|
.TP |
| 235 |
+ |
.BI origin " [ d | xo yo zo [ xd yd zd ] ]" |
| 236 |
+ |
Move the view forward or backwards the distance specified by a single |
| 237 |
+ |
.I d |
| 238 |
+ |
argument along the view direction vector. |
| 239 |
+ |
If 3 or more arguments are given, move the |
| 240 |
+ |
view origin to the indicated world position |
| 241 |
+ |
.I "xo yo zo" |
| 242 |
+ |
looking in the direction |
| 243 |
+ |
.I "xd yd zd." |
| 244 |
+ |
If the direction is unspecified, the current view direction is used. |
| 245 |
+ |
Without arguments, the cursor is used to select the |
| 246 |
+ |
view origin, and the direction will be determined by the |
| 247 |
+ |
(reoriented) surface normal. |
| 248 |
+ |
The view type and size will not be altered, but the up vector |
| 249 |
+ |
may be changed if the new direction coincides. |
| 250 |
+ |
.TP |
| 251 |
|
.BI pivot " angle [ elev [ mag [ x y z ] ] ]" |
| 252 |
|
Similar to the "move" command, but pivots the view about a selected point. |
| 253 |
|
The |
| 254 |
|
.I angle |
| 255 |
< |
is measured in degrees around the view up vector using the right hand rule. |
| 255 |
> |
is measured in degrees around the view up vector using the right hand rule, |
| 256 |
> |
so a positive value pivots the viewer to the right of the selected point. |
| 257 |
|
The optional |
| 258 |
|
.I elev |
| 259 |
|
is the elevation in degrees from the pivot point; positive raises the view point |
| 272 |
|
.BI rotate " angle [ elev [ mag ] ]" |
| 273 |
|
Rotate the camera horizontally by |
| 274 |
|
.I angle |
| 275 |
< |
degrees. |
| 275 |
> |
degrees using the right-hand rule. |
| 276 |
> |
A positive value rotates the view towards the left, and a negative value |
| 277 |
> |
looks to the right. |
| 278 |
|
If an elevation is specified, the camera looks upward |
| 279 |
|
.I elev |
| 280 |
|
degrees. |
| 302 |
|
ambient radius (ar), |
| 303 |
|
ambient samples (as), |
| 304 |
|
black&white (b), |
| 305 |
+ |
back face visibility (bv), |
| 306 |
|
direct jitter (dj), |
| 307 |
|
direct sampling (ds), |
| 308 |
|
direct threshold (dt), |
| 316 |
|
medium sampling (ms), |
| 317 |
|
pixel sample (ps), |
| 318 |
|
pixel threshold (pt), |
| 319 |
< |
back face visibility (bv), |
| 320 |
< |
specular jitter (sj), and |
| 321 |
< |
specular threshold (st). |
| 319 |
> |
specular jitter (sj), |
| 320 |
> |
specular threshold (st), and |
| 321 |
> |
uncorrelated sampling (u). |
| 322 |
|
Once a variable has been changed, the "new" command can be used |
| 323 |
|
to recompute the image with the new parameters. |
| 324 |
|
If a program variable is not available here, it may show up under |
| 365 |
|
The screen will be redrawn when the program resumes. |
| 366 |
|
.SH ENVIRONMENT |
| 367 |
|
RAYPATH the directories to check for auxiliary files. |
| 368 |
+ |
.br |
| 369 |
|
DISPLAY_GAMMA the value to use for monitor gamma correction. |
| 370 |
|
.SH AUTHOR |
| 371 |
|
Greg Ward |
| 372 |
|
.SH "SEE ALSO" |
| 373 |
< |
getinfo(1), lookamb(1), oconv(1), pfilt(1), rad(1), rpict(1), rtrace(1) |
| 373 |
> |
getinfo(1), lookamb(1), mkpmap(1), |
| 374 |
> |
oconv(1), pfilt(1), rad(1), rpict(1), rtpict(1), rtrace(1) |
