Contents of node1

<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 3.2 Final//en">

<!–Converted with LaTeX2HTML 2022 (Released January 1, 2022) –> <HTML lang="en"> <HEAD> <TITLE>Contents of Options</TITLE>

<H1><A ID="SECTION00100000000000000000"> Options</A> </H1>

This appendix describes the command-line arguments accepted by . These options override defaults as well as any values or flags given in the input file, and are thus useful for generating test and other unusual, ``non-standard'' renderings.

The general form of a command line is: <BLOCKQUOTE> <TT>rayshade</TT> [Options] [filename]

</BLOCKQUOTE>

If given, the input file is read from filename. By default, the input file is read from the standard input. Recall that, by default, the image file is written to the standard output; you will need to redirect the standard output if you have not chosen to write the image to a file directly. The name of the input file may be given anywhere on the command line.

Command-line options fall into two broad categories: those that set numerical or other values and thus must be followed by further arguments, and those that simply turn features on and off. 's convention is to denote the value-setting arguments using capital letters, and feature-toggling arguments using lower-case letters.

<IMG STYLE="height: 196.25ex; vertical-align: -0.70ex; " SRC="img1.png" ALT="
$\begin{defkey}{-A}{{\em frame}} Begin rendering (action) on the given frame. \end{defkey}$
"> The default starting frame is number zero.

<IMG STYLE="height: 2.38ex; vertical-align: 176.40ex; " SRC="img2.png" ALT="
$\begin{defkey}{-a}{} Toggle writing of alpha channel. \end{defkey}$
"> This option is only available when the Utah Raster Toolkit is being used.

<IMG STYLE="height: 2.17ex; vertical-align: 176.68ex; " SRC="img3.png" ALT="
$\begin{defkey}{-C}{{\em R G B}} Set the adaptive ray tree pruning color. If al... ...alls below the given cutoff values, no further rays are spawned. \end{defkey}$
"> Overrides the value specified via the <TT>cutoff</TT> keyword.

<IMG STYLE="height: 2.17ex; vertical-align: 176.68ex; " SRC="img4.png" ALT="
$\begin{defkey}{-c}{} Continue an interrupted rendering. \end{defkey}$
"> When given, this option indicates that the image file being written to contains a partially-completed image. will read the image to determine the scanline from which to continue the rendering. This option is only available with the Utah Raster Toolkit. The <TT>-O</TT> option must also be used.

<IMG STYLE="height: 2.17ex; vertical-align: 176.68ex; " SRC="img5.png" ALT="
$\begin{defkey}{-D}{{\em depth}} Set maximum ray tree depth. \end{defkey}$
"> Overrides the value specified in the input file via the <TT>maxdepth</TT> keyword.

<IMG STYLE="height: 2.17ex; vertical-align: 176.68ex; " SRC="img6.png" ALT="
$\begin{defkey}{-E}{{\em separation}} Set eye separation for rendering of stereo pairs. \end{defkey}$
"> Overrides the value specified via the <TT>eyesep</TT> keyword.

<IMG STYLE="height: 2.17ex; vertical-align: 176.68ex; " SRC="img7.png" ALT="
$\begin{defkey}{-e}{} Write exponential RLE file. \end{defkey}$
"> This option is only available for use with the Utah Raster Toolkit. See the Utah Raster Toolkit's unexp manual page for details on exponential RLE files.

<IMG STYLE="height: 2.17ex; vertical-align: 176.68ex; " SRC="img8.png" ALT="
$\begin{defkey}{-F}{{\em freq}} Set frequency of status report. \end{defkey}$
"> Overrides the value given using the <TT>report</TT> keyword.

<IMG STYLE="height: 2.17ex; vertical-align: 176.55ex; " SRC="img9.png" ALT="
$\begin{defkey}{-f}{} Flip all computed polygon (and triangle) normals. \end{defkey}$
"> This option should be used when rendering polygons defined by vertices given in clockwise order, rather than counter-clockwise order as expected by .

<IMG STYLE="height: 2.38ex; vertical-align: 176.40ex; " SRC="img10.png" ALT="
$\begin{defkey}{-G}{{\em gamma}} Use given gamma correction exponent writing writing color information to the image file. \end{defkey}$
"> The default value for gamma is 1.0.

<IMG STYLE="height: 2.17ex; vertical-align: 176.68ex; " SRC="img11.png" ALT="
$\begin{defkey}{-g}{} Use a Gaussian pixel filter. \end{defkey}$
"> Overrides the filter selected through the use of the <TT>filter</TT> keyword.

<IMG STYLE="height: 2.17ex; vertical-align: 176.68ex; " SRC="img15.png" ALT="
$\begin{defkey}{-m}{} Write a sampling map to the alpha channel. \end{defkey}$
"> Rather than containing coverage information, the alpha channel values will be restricted to zero, indicating no supersampling, and full intensity, indicating supersampling. This option is only available if the Utah Raster Toolkit is being used.

<IMG STYLE="height: 2.10ex; vertical-align: 176.68ex; " SRC="img16.png" ALT="
$\begin{defkey}{-N}{{\em frames}} Set the total number of frames to be rendered. \end{defkey}$
"> This option overrides any value specified through the use of the <TT>frames</TT> keyword. By default, a single frame is rendered.

<IMG STYLE="height: 1.68ex; vertical-align: 177.10ex; " SRC="img18.png" ALT="
$\begin{defkey}{-O}{{\em outfile}} Write the image to the named file. \end{defkey}$
"> This option overrides the name given with the <TT>outfile</TT> keyword, if any, in the input file.

<IMG STYLE="height: 2.17ex; vertical-align: 176.68ex; " SRC="img19.png" ALT="
$\begin{defkey}{-o}{} Toggle the effect of object opacity on shadows. \end{defkey}$
"> This option is equivalent to specifying <TT>shadowtransp</TT> in the input file. By default, traces shadow rays through non-opaque objects.

<IMG STYLE="height: 2.17ex; vertical-align: 176.68ex; " SRC="img20.png" ALT="
$\begin{defkey}{-P}{{\em cpp-arguments}} Specify the options that should be passed to the C preprocessor. \end{defkey}$
"> The C preprocessor, if available, is applied to all of the input passed to rayshade.

<IMG STYLE="height: 2.17ex; vertical-align: 176.68ex; " SRC="img21.png" ALT="
$\begin{defkey}{-p}{} Perform preview-quality rendering. \end{defkey}$
"> This option is equivalent to <TT>-n -S 1 -D 0</TT>.

<IMG STYLE="height: 2.10ex; vertical-align: 176.75ex; " SRC="img23.png" ALT="
$\begin{defkey}{-R}{{\em xsize ysize}} Produce an image {\em xsize} pixels wide by {\em ysize} pixels high. \end{defkey}$
"> This option overrides any screen size set by use of the <TT>screen</TT> keyword.

<IMG STYLE="height: 2.10ex; vertical-align: 176.68ex; " SRC="img25.png" ALT="
$\begin{defkey}{-S}{{\em samples}} Use $samples^2$\ jittered samples. \end{defkey}$
"> This option overrides any value set through the use of the <TT>samples</TT> keyword in the input file.

<IMG STYLE="height: 2.45ex; vertical-align: 176.40ex; " SRC="img26.png" ALT="
$\begin{defkey}{-s}{} Disable caching of shadowing information. \end{defkey}$
"> It should never be necessary to use this option.

<IMG STYLE="height: 2.17ex; vertical-align: 176.68ex; " SRC="img27.png" ALT="
$\begin{defkey}{-T}{{\em r g b}} Set the contrast threshold in the three color channels for use in adaptive supersampling. \end{defkey}$
"> This option overrides any value given through the use of the contrast keyword.

<IMG STYLE="height: 2.17ex; vertical-align: 176.68ex; " SRC="img28.png" ALT="
$\begin{defkey}{-u}{} Toggle the use of the C preprocessor. \end{defkey}$
"> usually feeds its input through a C preprocessor if one is available on your system. If this option is given, unadulterated input files will be used.

<IMG STYLE="height: 2.17ex; vertical-align: 176.68ex; " SRC="img29.png" ALT="
$\begin{defkey}{-V}{{\em filename}} Write verbose output to the named file. \end{defkey}$
"> This option overrides any file named through the use of the <TT>report</TT> keyword.

<IMG STYLE="height: 2.17ex; vertical-align: 176.68ex; " SRC="img30.png" ALT="
$\begin{defkey}{-v}{} Write verbose output. \end{defkey}$
"> When given, this option causes information about the options selected and the objects defined to be included in the report file.

<IMG STYLE="height: 2.10ex; vertical-align: 176.68ex; " SRC="img31.png" ALT="
$\begin{defkey}{-W}{{\em minx maxx miny maxy}} Render the specified window. \end{defkey}$
"> The window must be properly contained within the screen. This option overrides any window specified using the window keyword in the input file.

<IMG STYLE="height: 2.17ex; vertical-align: 176.68ex; " SRC="img32.png" ALT="
$\begin{defkey}{-X}{{\em left right bottom top}} Crop the rendering window using the given normalized values. \end{defkey}$
"> This option is provided to facilitate changing and/or examining a small portion of an image without having to re-render the entire image.

<HR>

</BODY> </HTML>