--- ray/doc/man/man1/rpict.1 2022/10/19 18:23:14 1.27 +++ ray/doc/man/man1/rpict.1 2025/04/22 17:12:25 1.31 @@ -1,4 +1,4 @@ -.\" RCSid "$Id: rpict.1,v 1.27 2022/10/19 18:23:14 greg Exp $" +.\" RCSid "$Id: rpict.1,v 1.31 2025/04/22 17:12:25 greg Exp $" .TH RPICT 1 2/26/99 RADIANCE .SH NAME rpict - generate a RADIANCE picture @@ -18,6 +18,8 @@ rpict - generate a RADIANCE picture ] .br .B "rpict [ options ] \-defaults" +.br +.B "rpict \-features [feat1 ..]" .SH DESCRIPTION .I Rpict generates a picture from the RADIANCE scene given in @@ -41,6 +43,21 @@ In the second form shown above, the default values for the options (modified by those options present) are printed with a brief explanation. .PP +In the third form, a list of supported features is sent +to the standard output, one per line. +If additional arguments follow, they are checked for presence in +this list. +If a feature includes subfeatures, these may be checked as well by +specifying: +.nf + + rpict -features FeatName=subfeat1,subfeat2 + +.fi +If any named feature or subfeature is missing, an error is +reported and the program returns an error status. +If all of the named features are present, a zero status is returned. +.PP Most options are followed by one or more arguments, which must be separated from the option and each other by white space. The exceptions to this rule are the @@ -254,6 +271,25 @@ to use a very small fraction with the .I \-pd option, to avoid the ghosting effect of too few samples. .TP +.BI -pc " xr yr xg yg xb yb xw yw" +Use the specified chromaticity pairs for output primaries and white +point rather than the standard RGB color space. +.TP +.BR \-pRGB +Output standard RGB values (the default). +.TP +.BR \-pXYZ +Output standard CIE XYZ tristimulus values rather than RGB. +.TP +.BI -f \ source +Load definitions from +.I source +and assign at global level. +.TP +.BI -e \ expr +Set additional definitions from +.I expr. +.TP .BI -dj \ frac Set the direct jittering to .I frac. @@ -682,6 +718,19 @@ continue rays with a probability equal to the ray weig divided by the given .I frac. .TP +.BI -cs \ Ns +Use +.I Ns +bands for spectral sampling rather than the default RGB calculation space. +The maximum setting is controlled by the compiler macro MAXCSAMP, and +defaults to 24. +Larger values for Ns will be reduced to MAXCSAMP. +.TP +.BI -cw " nmA nmB" +Set extrema to the given wavelengths for spectral sampling. +The default is 380 and 780 nanometers. +The order specified does not matter. +.TP .BI -S \ seqstart Instead of generating a single picture based only on the view parameters given on the command line, this option causes @@ -876,6 +925,8 @@ A value of zero turns automatic reporting off. Send error messages and progress reports to .I efile instead of the standard error. +(Note this option overlaps with "-e expr" above, so file paths +with '=' or ':' in them are not allowed on this option.) .TP .BR \-w Boolean switch for warning messages.