| 192 |
|
If given, the object's transformation will be prepended to that |
| 193 |
|
of its parent. |
| 194 |
|
The second argument is the name of this object, which will be used |
| 195 |
< |
to name surfaces it contains, and as a modifier for any child objects |
| 196 |
< |
that reference it. |
| 195 |
> |
to name surfaces it contains, and as a parent identifier for any child |
| 196 |
> |
objects that reference it. |
| 197 |
|
The third argument is the transformation string or file for this object. |
| 198 |
|
If this argument is enclosed in quotes and begins with a hyphen |
| 199 |
|
('-'), then it will be interpreted as a |
| 215 |
|
the input of |
| 216 |
|
.I xform |
| 217 |
|
for each frame. |
| 218 |
< |
An optinal fifth argument |
| 218 |
> |
An optional fifth argument |
| 219 |
|
specifies the rendering priority for this object. |
| 220 |
< |
Values greater than 1 will result in preferential rendering of |
| 220 |
> |
Values greater than 1.0 will result in preferential rendering of |
| 221 |
|
this object over other portions of the image when it appears in a frame. |
| 222 |
< |
Values less than 1 will cause the rendering to neglect this object in |
| 222 |
> |
Values less than 1.0 will cause the rendering to neglect this object in |
| 223 |
|
favor of other parts of the image. |
| 224 |
|
A value of 3.0 can be interpreted as saying the viewer is three times more |
| 225 |
|
likely to look at this object than the background. |
| 226 |
|
A file may be given rather than a floating point value, and this file must |
| 227 |
< |
contain one floating point number per line, corresponding to frames in the |
| 228 |
< |
animation. |
| 227 |
> |
contain one floating point number per line, corresponding to priorities |
| 228 |
> |
for frames in the animation. |
| 229 |
|
.TP |
| 230 |
|
.BR VIEWFILE |
| 231 |
|
This variable names a file from which |
| 253 |
|
As in |
| 254 |
|
.I pfilt, |
| 255 |
|
the exposure setting may be given either as a multiplier or as a |
| 256 |
< |
number of f-stop adjustments (eg. +2 or -1.5). |
| 256 |
> |
number of f\-stop adjustments (eg. +2 or \-1.5). |
| 257 |
|
Alternatively, a file name may be given, which |
| 258 |
|
.I ranimate |
| 259 |
|
will interpret as having one exposure value per line per frame, |
| 269 |
|
This string should contain a |
| 270 |
|
.I printf(3) |
| 271 |
|
style integer field to distinguish one frame number from another. |
| 272 |
< |
The final frames will use this name with a ".pic" suffix. |
| 272 |
> |
The final frames will use this name with a ".hdr" suffix. |
| 273 |
|
The default value is "frame%03d". |
| 274 |
|
.TP |
| 275 |
|
.BR MBLUR |
| 277 |
|
is simulated as being open for motion blur. |
| 278 |
|
Motion blur is computed by |
| 279 |
|
.I ranimove |
| 280 |
< |
using image-based rendering methods, and will not be exact. |
| 281 |
< |
The default value is 0, meaning no motion blurring. |
| 280 |
> |
using image-based rendering methods in a rather crude fashion. |
| 281 |
> |
A much better result is achieved by setting |
| 282 |
> |
.I MBLUR=0 |
| 283 |
> |
and using the |
| 284 |
> |
.I pmblur2(1) |
| 285 |
> |
command as a post-process, assigning the |
| 286 |
> |
.I ZNAME |
| 287 |
> |
and |
| 288 |
> |
.I MNAME |
| 289 |
> |
variables described below. |
| 290 |
> |
The default motion blur is 0. |
| 291 |
|
.TP |
| 292 |
|
.BR RATE |
| 293 |
|
This variable specifies the animation frame rate, in frames per second. |
| 337 |
|
(The |
| 338 |
|
.I \-f |
| 339 |
|
option is specified by default.)\0 |
| 340 |
+ |
.TP |
| 341 |
+ |
.BR ZNAME |
| 342 |
+ |
The base file name for the depth buffer output frames. |
| 343 |
+ |
This string should contain a |
| 344 |
+ |
.I printf(3) |
| 345 |
+ |
style integer field to distinguish one frame number from another. |
| 346 |
+ |
The final frames will use this name with a ".zbf" suffix. |
| 347 |
+ |
This is needed by the |
| 348 |
+ |
.I pmblur2 |
| 349 |
+ |
command to compute a better motion blur. |
| 350 |
+ |
There is no default setting for this variable. |
| 351 |
+ |
.TP |
| 352 |
+ |
.BR MNAME |
| 353 |
+ |
The base file name for the motion vector output frames. |
| 354 |
+ |
This string should contain a |
| 355 |
+ |
.I printf(3) |
| 356 |
+ |
style integer field to distinguish one frame number from another. |
| 357 |
+ |
The final frames will use this name with a ".mvo" suffix. |
| 358 |
+ |
This file is used together with the image and depth buffer by |
| 359 |
+ |
.I pmblur2 |
| 360 |
+ |
to compute a better motion blur. |
| 361 |
+ |
In this case, the |
| 362 |
+ |
.I MBLUR |
| 363 |
+ |
variable should be unset or zero. |
| 364 |
+ |
The file will contain 3 16-bit unsigned values per pixel. |
| 365 |
+ |
The first two are the x and y offsets to each pixel in the previous frame, |
| 366 |
+ |
with an offset of 32768 being no movement. |
| 367 |
+ |
The third value is 0 if the previous frame's pixel was on a |
| 368 |
+ |
different object, and 32768 if it was on the same object. |
| 369 |
+ |
There is no default setting for this variable. |
| 370 |
|
.SH EXAMPLES |
| 371 |
|
A minimal input file for |
| 372 |
|
.I ranimove |
| 390 |
|
would use without actually executing anything, we can invoke it |
| 391 |
|
thus: |
| 392 |
|
.IP "" .2i |
| 393 |
< |
ranimove -n 0 -e sample.rnm |
| 393 |
> |
ranimove \-n 0 \-e sample.rnm |
| 394 |
|
.PP |
| 395 |
|
This will print the variables we have given as well as default |
| 396 |
|
values |
| 422 |
|
.SH AUTHOR |
| 423 |
|
Greg Ward |
| 424 |
|
.SH "SEE ALSO" |
| 425 |
< |
fieldcomb(1), oconv(1), pfilt(1), pinterp(1), rad(1), |
| 425 |
> |
fieldcomb(1), oconv(1), pfilt(1), pinterp(1), pmblur2(1), pvalue(1), rad(1), |
| 426 |
|
ran2tiff(1), ranimate(1), rpict(1), xform(1) |
