ViewVC Help

View File | Revision Log | Show Annotations | Download File | Root Listing

root/Development/ray/doc/man/man1/rpict.1

Comparing ray/doc/man/man1/rpict.1 (file contents):
Revision 1.6 by greg, Wed Feb 16 05:40:06 2005 UTC vs.
Revision 1.11 by greg, Tue Sep 4 17:36:41 2007 UTC

#	Line 152 | Line 152 | This is option is useful for generating skewed perspec
152		rendering an image a piece at a time.
153		A value of 1 means that the rendered image starts just to the right of
154		the normal view.
155	<	A value of -1 would be to the left.
155	>	A value of \-1 would be to the left.
156		Larger or fractional values are permitted as well.
157		.TP
158		.BI -vl \ val
#	Line 263 | Line 263 | A warning about aiming failure will issued if
263		.I frac
264		is too large.
265		It is usually wise to turn off image sampling when using
266	<	direct jitter by setting -ps to 1.
266	>	direct jitter by setting \-ps to 1.
267		.TP
268		.BI -ds \ frac
269		Set the direct sampling ratio to
#	Line 472 | Line 472 | header of the ambient file.
472		.I Getinfo(1)
473		may be used to print out this information.
474		.TP
475	<	.BI -ae \ mat
475	>	.BI -ae \ mod
476		Append
477	<	.I mat
477	>	.I mod
478		to the ambient exclude list,
479		so that it will not be considered during the indirect calculation.
480		This is a hack for speeding the indirect computation by
481		ignoring certain objects.
482		Any object having
483	<	.I mat
483	>	.I mod
484		as its modifier will get the default ambient
485		level rather than a calculated value.
486	<	Any number of excluded materials may be given, but each
486	>	Any number of excluded modifiers may be given, but each
487		must appear in a separate option.
488		.TP
489	<	.BI -ai \ mat
489	>	.BI -ai \ mod
490		Add
491	<	.I mat
491	>	.I mod
492		to the ambient include list,
493		so that it will be considered during the indirect calculation.
494		The program can use either an include list or an exclude
#	Line 497 | Line 497 | list, but not both.
497		.BI -aE \ file
498		Same as
499		.I \-ae,
500	<	except read materials to be excluded from
500	>	except read modifiers to be excluded from
501		.I file.
502		The RAYPATH environment variable determines which directories are
503		searched for this file.
504	<	The material names are separated by white space in the file.
504	>	The modifier names are separated by white space in the file.
505		.TP
506		.BI -aI \ file
507		Same as
508		.I \-ai,
509	<	except read materials to be included from
509	>	except read modifiers to be included from
510		.I file.
511		.TP
512		.BI -me " rext gext bext"
#	Line 555 | Line 555 | though the
555		.I \-dv
556		option (above) may be used to override this.
557		.TP
558	+	.BR \-u
559	+	Boolean switch to control uncorrelated random sampling.
560	+	When "off", a low-discrepancy sequence is used, which reduces
561	+	variance but can result in a brushed appearance in specular highlights.
562	+	When "on", pure Monte Carlo sampling is used in all calculations.
563	+	.TP
564		.BI -lr \ N
565		Limit reflections to a maximum of
566		.I N.
567	+	If
568	+	.I N
569	+	is zero, then Russian roulette is used for ray
570	+	termination, and the
571	+	.I -lw
572	+	setting (below) must be positive.
573	+	If N is a negative integer, then this sets the upper limit
574	+	of reflections past which Russian roulette will not be used.
575	+	In scenes with dielectrics and total internal reflection,
576	+	a setting of 0 (no limit) may cause a stack overflow.
577		.TP
578		.BI -lw \ frac
579		Limit the weight of each ray to a minimum of
580		.I frac.
581	<	During ray-tracing, a record is kept of the final contribution
582	<	a ray would have to the image.
583	<	If it is less then the specified minimum, the ray is not traced.
581	>	During ray-tracing, a record is kept of the estimated contribution
582	>	(weight) a ray would have in the image.
583	>	If this weight is less than the specified minimum and the
584	>	.I -lr
585	>	setting (above) is positive, the ray is not traced.
586	>	Otherwise, Russian roulette is used to
587	>	continue rays with a probability equal to the ray weight
588	>	divided by the given
589	>	.I frac.
590		.TP
591		.BI -S \ seqstart
592		Instead of generating a single picture based only on the view
#	Line 752 | Line 774 | Set the time between progress reports to
774		A progress report writes the number of rays traced, the percentage
775		completed, and the CPU usage to the standard error.
776		Reports are given either automatically after the specified interval,
777	<	or when the process receives a continue (-CONT) signal (see
777	>	or when the process receives a continue (\-CONT) signal (see
778		.I kill(1)).
779		A value of zero turns automatic reporting off.
780		.TP
#	Line 766 | Line 788 | Boolean switch for warning messages.
788		The default is to print warnings, so the first appearance of
789		this option turns them off.
790		.SH EXAMPLE
791	<	rpict -vp 10 5 3 -vd 1 -.5 0 scene.oct > scene.pic
791	>	rpict \-vp 10 5 3 \-vd 1 \-.5 0 scene.oct > scene.pic
792		.PP
793	<	rpict -S 1 -o frame%02d.pic scene.oct < keyframes.vf
793	>	rpict \-S 1 \-o frame%02d.pic scene.oct < keyframes.vf
794		.SH ENVIRONMENT
795		RAYPATH         the directories to check for auxiliary files.
796		.SH FILES

Diff Legend

–	Removed lines
+	Added lines
<	Changed lines (old)
>	Changed lines (new)