ViewVC Help
View File | Revision Log | Show Annotations | Download File | Root Listing
root/radiance/ray/doc/man/man1/ranimate.1
(Generate patch)

Comparing ray/doc/man/man1/ranimate.1 (file contents):
Revision 1.3 by greg, Tue Jan 18 03:59:40 2005 UTC vs.
Revision 1.11 by greg, Wed Jun 1 16:59:34 2022 UTC

# Line 157 | Line 157 | how to adjust the exposure for each frame.
157   As in
158   .I pfilt,
159   the exposure setting may be given either as a multiplier or as a
160 < number of f-stop adjustments (eg. +2 or -1.5).
160 > number of f\-stop adjustments (eg. +2 or \-1.5).
161   Alternatively, a file name may be given, which
162   .I ranimate
163   will interpret as having one exposure value per line per frame,
# Line 180 | Line 180 | options of rpict, along with appropriate suffixes,
180   and thus should contain a
181   .I printf(3)
182   style integer field to distinguish one frame number from another.
183 < The final frames will use this name with a ".pic" suffix.
183 > The final frames will use this name with a ".hdr" suffix.
184   The default value is the assigned
185   .I DIRECTORY
186   followed by "/frame%03d".
# Line 271 | Line 271 | before it is executed.
271   Normally, the transfer command does something such as convert the
272   frames to another format and/or copy them to tape or some other
273   destination device before removing them.
274 + The
275 + .I fieldcomb(1)
276 + script may be used to conveniently combine fields into frames for
277 + field-based animations.
278   If this variable is not given, the final frames are left where they
279   are.
280   (See
# Line 279 | Line 283 | above.)\0
283   .TP
284   .BR RSH
285   The command to use instead of
286 < .I rsh(1)
286 > .I ssh(1)
287   to execute commands remotely on another machine.
288   The arguments and behavior of this program must be identical to the UNIX
289 < .I rsh
289 > .I ssh
290   command, except that the
291   .I -l
292   option will always be used to specify an alternate user name rather than the
293   .I "user@host"
294   convention.
295 < Th
295 > The
296   .I -l
297   option may or may not appear, but the
298   .I -n
299   option will always be used, and the expected starting directory will
300   be that of the remote user, just as with
301 < .I rsh.
301 > .I ssh.
302   .TP
303   .BR NEXTANIM
304   This variable specifies the next
# Line 358 | Line 362 | used otherwise.
362   The default fraction is 0, meaning no motion blurring.
363   This option does not currently work with the
364   .I ANIMATE
365 < variable, since pinterp only works for static environments.
365 > variable.
366   .TP
367   .BR DBLUR
368   This variable specifies the aperture diameter for depth-of-field blurring,
# Line 374 | Line 378 | and
378   .I pinterp
379   used otherwise.
380   (The default value for number of samples is 5.)\0
381 + To simulate a particular camera's aperture, divide the focal length of
382 + the lens by the f-number, then convert to the corresponding
383 + world coordinate units.
384 + For example, if you wish to simulate a 50mm lens at f/2.0 in
385 + a scene modeled in meters, then you divide 50mm by 2.0 to get 25mm,
386 + which corresponds to an effective aperture of 0.025 meters.
387 + The focus distance is determined by the length of the view directon vector.
388   The default aperture is 0, meaning no depth-of-field blurring.
378 – This option does not currently work with the
379 – .I ANIMATE
380 – variable, since pinterp only works for static environments.
389   .TP
390   .BR RTRACE
391   This boolean variable tells
# Line 479 | Line 487 | If we only want to see what default values
487   would use without actually executing anything, we can invoke it
488   thus:
489   .IP "" .2i
490 < ranimate -n -e sample.ran
490 > ranimate \-n \-e sample.ran
491   .PP
492   This will print the variables we have given as well as default
493   values
# Line 510 | Line 518 | INTERP= 3                              # render every fourth frame
518   RES= 1024                               # shoot for 1024x resolution
519   MBLUR= .25                              # apply camera motion blur
520   EXP= anim1.exp                          # adjust exposure according to file
521 < pfilt= -r .9                            # use Gaussian filtering
521 > pfilt= \-r .9                           # use Gaussian filtering
522   ARCHIVE= tar cf /dev/nrtape             # save original renderings to tape
523   .fi
524   .PP
# Line 518 | Line 526 | Note the use of abbreviation for variable names.
526   .SH FILES
527   $(DIRECTORY)/STATUS     animation status file
528   $(DIRECTORY)/*          other temporary files
529 < $(BASENAME).pic         final animation frames
529 > $(BASENAME).hdr         final animation frames
530   .SH AUTHOR
531   Greg Ward
532   .SH BUGS
# Line 575 | Line 583 | to set whatever variables are important in the remote
583   This requirement may be circumvented by substituting the
584   .I on(1)
585   command for
586 < .I rsh(1)
586 > .I ssh(1)
587   using the
588   .I RSH
589   control variable, or by writing a custom remote execution script.
# Line 599 | Line 607 | is called if INTERPOLATE > 0 and/or MBLUR is assigned.
607   Since most modern machines use IEEE floating point, this is not
608   usually a problem, but it is something to keep in mind.
609   .SH "SEE ALSO"
610 < pfilt(1), pinterp(1), pmblur(1), rad(1),
611 < ranimove(1), rpict(1), rsh(1), rtrace(1)
610 > fieldcomb(1), pfilt(1), pinterp(1), pmblur(1), rad(1),
611 > ran2tiff(1), ranimove(1), rpict(1), ssh(1), rtrace(1)

Diff Legend

– Removed lines
+ Added lines
< Changed lines
> Changed lines