Crawly Crypt Collection 1

home *** CD-ROM | disk | FTP | other *** search

/ Crawly Crypt Collection 1 / crawlyvol1.bin / tt / raysh402 / guide.tex / node37_mn.html < prev next >

Wrap

Text File | 1992-02-09 | 10KB | 325 lines

<H1><A ID="SECTION001000000000000000000"> Options</A> </H1> This appendix describes the command-line arguments accepted by <#825#><#2057#>rayshade<#2057#><#825#>. 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 <#826#><#2059#>rayshade<#2059#><#826#> command line is: <BLOCKQUOTE> <#828#><TT>rayshade</TT><#828#> [<#829#>Options<#829#>] [<#830#>filename<#830#>] </BLOCKQUOTE> If given, the input file is read from <#832#>filename<#832#>. 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. <#833#><#2061#>Rayshade<#2061#><#833#>'s convention is to denote the value-setting arguments using capital letters, and feature-toggling arguments using lower-case letters. <DL> <DT><#5087#><#5087#></DT> <DD><#1566#><TT>-A</TT><#1566#> <#1567#>frame<#1567#> Begin rendering (action) on the given frame. </DD> </DL>The default starting frame is number zero. <DL> <DT><#5088#><#5088#></DT> <DD><#1570#><TT>-a</TT><#1570#> Toggle writing of alpha channel. </DD> </DL>This option is only available when the Utah Raster Toolkit is being used. <DL> <DT><#5089#><#5089#></DT> <DD><#1573#><TT>-C</TT><#1573#> <#1574#>R G B<#1574#> Set the adaptive ray tree pruning color. If all channel contributions falls below the given cutoff values, no further rays are spawned. </DD> </DL>Overrides the value specified via the <#846#><TT>cutoff</TT><#846#> keyword. <DL> <DT><#5090#><#5090#></DT> <DD><#1577#><TT>-c</TT><#1577#> Continue an interrupted rendering. </DD> </DL>When given, this option indicates that the image file being written to contains a partially-completed image. <#851#><#2063#>Rayshade<#2063#><#851#> 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 <#852#><TT>-O</TT><#852#> option must also be used. <DL> <DT><#5091#><#5091#></DT> <DD><#1580#><TT>-D</TT><#1580#> <#1581#>depth<#1581#> Set maximum ray tree depth. </DD> </DL>Overrides the value specified in the input file via the <#857#><TT>maxdepth</TT><#857#> keyword. <DL> <DT><#5092#><#5092#></DT> <DD><#1584#><TT>-E</TT><#1584#> <#1585#>separation<#1585#> Set eye separation for rendering of stereo pairs. </DD> </DL>Overrides the value specified via the <#862#><TT>eyesep</TT><#862#> keyword. <DL> <DT><#5093#><#5093#></DT> <DD><#1588#><TT>-e</TT><#1588#> Write exponential RLE file. </DD> </DL>This option is only available for use with the Utah Raster Toolkit. See the Utah Raster Toolkit's <#867#>unexp<#867#> manual page for details on exponential RLE files. <DL> <DT><#5094#><#5094#></DT> <DD><#1591#><TT>-F</TT><#1591#> <#1592#>freq<#1592#> Set frequency of status report. </DD> </DL>Overrides the value given using the <#872#><TT>report</TT><#872#> keyword. <DL> <DT><#5095#><#5095#></DT> <DD><#1595#><TT>-f</TT><#1595#> Flip all computed polygon (and triangle) normals. </DD> </DL>This option should be used when rendering polygons defined by vertices given in <#877#>clockwise<#877#> order, rather than counter-clockwise order as expected by <#878#><#2065#>rayshade<#2065#><#878#>. <DL> <DT><#5096#><#5096#></DT> <DD><#1598#><TT>-G</TT><#1598#> <#1599#>gamma<#1599#> Use given gamma correction exponent writing writing color information to the image file. </DD> </DL>The default value for <#883#>gamma<#883#> is 1.0. <DL> <DT><#5097#><#5097#></DT> <DD><#1602#><TT>-g</TT><#1602#> Use a Gaussian pixel filter. </DD> </DL>Overrides the filter selected through the use of the <#888#><TT>filter</TT><#888#> keyword. <DL> <DT><#5098#><#5098#></DT> <DD><#1605#><TT>-h</TT><#1605#> Print a short use message. </DD> </DL> <DL> <DT><#5099#><#5099#></DT> <DD><#1608#><TT>-j</TT><#1608#> Toggle the use of jittered sampling to perform antialiasing. If disabled, a fixed sampling pattern is used. </DD> </DL> <DL> <DT><#5100#><#5100#></DT> <DD><#1611#><TT>-l</TT><#1611#> Render the left stereo pair image. </DD> </DL> <DL> <DT><#5101#><#5101#></DT> <DD><#1614#><TT>-m</TT><#1614#> Write a sampling map to the alpha channel. </DD> </DL>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. <DL> <DT><#5102#><#5102#></DT> <DD><#1617#><TT>-N</TT><#1617#> <#1618#>frames<#1618#> Set the total number of frames to be rendered. </DD> </DL>This option overrides any value specified through the use of the <#909#><TT>frames</TT><#909#> keyword. By default, a single frame is rendered. <DL> <DT><#5103#><#5103#></DT> <DD><#1621#><TT>-n</TT><#1621#> Do not render shadows. </DD> </DL> <DL> <DT><#5104#><#5104#></DT> <DD><#1624#><TT>-O</TT><#1624#> <#1625#>outfile<#1625#> Write the image to the named file. </DD> </DL>This option overrides the name given with the <#918#><TT>outfile</TT><#918#> keyword, if any, in the input file. <DL> <DT><#5105#><#5105#></DT> <DD><#1628#><TT>-o</TT><#1628#> Toggle the effect of object opacity on shadows. </DD> </DL>This option is equivalent to specifying <#923#><TT>shadowtransp</TT><#923#> in the input file. By default, <#924#><#2067#>rayshade<#2067#><#924#> traces shadow rays through non-opaque objects. <DL> <DT><#5106#><#5106#></DT> <DD><#1631#><TT>-P</TT><#1631#> <#1632#>cpp-arguments<#1632#> Specify the options that should be passed to the C preprocessor. </DD> </DL>The C preprocessor, if available, is applied to all of the input passed to <#929#>rayshade<#929#>. <DL> <DT><#5107#><#5107#></DT> <DD><#1635#><TT>-p</TT><#1635#> Perform preview-quality rendering. </DD> </DL>This option is equivalent to <#934#><TT>-n -S 1 -D 0</TT><#934#>. <DL> <DT><#5108#><#5108#></DT> <DD><#1638#><TT>-q</TT><#1638#> Do not print warning messages. </DD> </DL> <DL> <DT><#5109#><#5109#></DT> <DD><#1641#><TT>-R</TT><#1641#> <#1642#>xsize ysize<#1642#> Produce an image <#942#>xsize<#942#> pixels wide by <#943#>ysize<#943#> pixels high. </DD> </DL>This option overrides any screen size set by use of the <#945#><TT>screen</TT><#945#> keyword. <DL> <DT><#5110#><#5110#></DT> <DD><#1645#><TT>-r</TT><#1645#> Render the right stereo pair image. </DD> </DL> <DL> <DT><#5111#><#5111#></DT> <DD><#1648#><TT>-S</TT><#1648#> <#1649#>samples<#1649#> Use samples2 jittered samples. </DD> </DL>This option overrides any value set through the use of the <#954#><TT>samples</TT><#954#> keyword in the input file. <DL> <DT><#5113#><#5113#></DT> <DD><#1652#><TT>-s</TT><#1652#> Disable caching of shadowing information. </DD> </DL>It should never be necessary to use this option. <DL> <DT><#5114#><#5114#></DT> <DD><#1655#><TT>-T</TT><#1655#> <#1656#>r g b<#1656#> Set the contrast threshold in the three color channels for use in adaptive supersampling. </DD> </DL>This option overrides any value given through the use of the <#963#>contrast<#963#> keyword. <DL> <DT><#5115#><#5115#></DT> <DD><#1659#><TT>-u</TT><#1659#> Toggle the use of the C preprocessor. </DD> </DL><#968#><#2069#>Rayshade<#2069#><#968#> 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. <DL> <DT><#5116#><#5116#></DT> <DD><#1662#><TT>-V</TT><#1662#> <#1663#>filename<#1663#> Write verbose output to the named file. </DD> </DL>This option overrides any file named through the use of the <#973#><TT>report</TT><#973#> keyword. <DL> <DT><#5117#><#5117#></DT> <DD><#1666#><TT>-v</TT><#1666#> Write verbose output. </DD> </DL>When given, this option causes information about the options selected and the objects defined to be included in the report file. <DL> <DT><#5118#><#5118#></DT> <DD><#1669#><TT>-W</TT><#1669#> <#1670#>minx maxx miny maxy<#1670#> Render the specified window. </DD> </DL>The window must be properly contained within the screen. This option overrides any window specified using the <#982#>window<#982#> keyword in the input file. <DL> <DT><#5119#><#5119#></DT> <DD><#1673#><TT>-X</TT><#1673#> <#1674#>left right bottom top<#1674#> Crop the rendering window using the given normalized values. </DD> </DL>This option is provided to facilitate changing and/or examining a small portion of an image without having to re-render the entire image.