| 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 " [ xo yo zo [ xd yd zd ] ]" |
| 236 |
+ |
Change view origin to the indicated world position |
| 237 |
+ |
.I "xo yo zo" |
| 238 |
+ |
looking in the direction |
| 239 |
+ |
.I "xd yd zd." |
| 240 |
+ |
If the direction is missing, the current view direction is used. |
| 241 |
+ |
If the origin is missing, the cursor is used to select the |
| 242 |
+ |
view origin, and the direction will be determined by the |
| 243 |
+ |
(reoriented) surface normal. |
| 244 |
+ |
The view type and size will not be altered, but the up vector |
| 245 |
+ |
may be changed if the new direction coincides. |
| 246 |
+ |
.TP |
| 247 |
|
.BI pivot " angle [ elev [ mag [ x y z ] ] ]" |
| 248 |
|
Similar to the "move" command, but pivots the view about a selected point. |
| 249 |
|
The |
| 250 |
|
.I angle |
| 251 |
< |
is measured in degrees around the view up vector using the right hand rule. |
| 251 |
> |
is measured in degrees around the view up vector using the right hand rule, |
| 252 |
> |
so a positive value pivots the viewer to the right of the selected point. |
| 253 |
|
The optional |
| 254 |
|
.I elev |
| 255 |
|
is the elevation in degrees from the pivot point; positive raises the view point |
| 268 |
|
.BI rotate " angle [ elev [ mag ] ]" |
| 269 |
|
Rotate the camera horizontally by |
| 270 |
|
.I angle |
| 271 |
< |
degrees. |
| 271 |
> |
degrees using the right-hand rule. |
| 272 |
> |
A positive value rotates the view towards the left, and a negative value |
| 273 |
> |
looks to the right. |
| 274 |
|
If an elevation is specified, the camera looks upward |
| 275 |
|
.I elev |
| 276 |
|
degrees. |
| 298 |
|
ambient radius (ar), |
| 299 |
|
ambient samples (as), |
| 300 |
|
black&white (b), |
| 301 |
+ |
back face visibility (bv), |
| 302 |
|
direct jitter (dj), |
| 303 |
|
direct sampling (ds), |
| 304 |
|
direct threshold (dt), |
| 312 |
|
medium sampling (ms), |
| 313 |
|
pixel sample (ps), |
| 314 |
|
pixel threshold (pt), |
| 315 |
< |
back face visibility (bv), |
| 316 |
< |
specular jitter (sj), and |
| 317 |
< |
specular threshold (st). |
| 315 |
> |
specular jitter (sj), |
| 316 |
> |
specular threshold (st), and |
| 317 |
> |
uncorrelated sampling (u). |
| 318 |
|
Once a variable has been changed, the "new" command can be used |
| 319 |
|
to recompute the image with the new parameters. |
| 320 |
|
If a program variable is not available here, it may show up under |
| 361 |
|
The screen will be redrawn when the program resumes. |
| 362 |
|
.SH ENVIRONMENT |
| 363 |
|
RAYPATH the directories to check for auxiliary files. |
| 364 |
+ |
.br |
| 365 |
|
DISPLAY_GAMMA the value to use for monitor gamma correction. |
| 366 |
|
.SH AUTHOR |
| 367 |
|
Greg Ward |
| 368 |
|
.SH "SEE ALSO" |
| 369 |
< |
getinfo(1), lookamb(1), oconv(1), pfilt(1), rad(1), rpict(1), rtrace(1) |
| 369 |
> |
getinfo(1), lookamb(1), mkpmap(1), |
| 370 |
> |
oconv(1), pfilt(1), rad(1), rpict(1), rtrace(1) |
