home *** CD-ROM | disk | FTP | other *** search
/ Crawly Crypt Collection 1 / crawlyvol1.bin / tt / raysh402 / guide.tex / node37_mn.html < prev    next >
Text File  |  1992-02-09  |  10KB  |  325 lines

  1.  
  2. <H1><A ID="SECTION001000000000000000000">
  3. Options</A>
  4. </H1>
  5.  
  6. <P>
  7. This appendix describes the command-line arguments accepted by <#825#><#2057#><EM>rayshade</EM><#2057#><#825#>.
  8. These options override defaults
  9. as well as any values or flags given in the input file,
  10. and are thus useful for generating test and other unusual, ``non-standard''
  11. renderings.
  12.  
  13. <P>
  14. The general form of a <#826#><#2059#><EM>rayshade</EM><#2059#><#826#> command line is:
  15. <BLOCKQUOTE>
  16. <#828#><TT>rayshade</TT><#828#> [<#829#><EM>Options</EM><#829#>] [<#830#><EM>filename</EM><#830#>]
  17.  
  18. </BLOCKQUOTE>
  19.  
  20. <P>
  21. If given, the input file is read from <#832#><EM>filename</EM><#832#>.  By default,
  22. the input file is read from the standard input.
  23. Recall that, by default, the image file is written to the standard
  24. output; you will need to redirect the standard output if you have not
  25. chosen to write the image to a file directly.  The name of the input
  26. file may be given anywhere on the command line.
  27.  
  28. <P>
  29. Command-line options fall into two broad categories: those that set
  30. numerical or other values and thus must be followed by further arguments,
  31. and those that simply turn features on and off.  <#833#><#2061#><EM>Rayshade</EM><#2061#><#833#>'s
  32. convention is to denote the value-setting arguments using capital letters,
  33. and feature-toggling arguments using lower-case letters.
  34.  
  35. <P>
  36. <DL>
  37. <DT><STRONG><#5087#><#5087#></STRONG></DT>
  38. <DD><#1566#><TT>-A</TT><#1566#> <#1567#><EM>frame</EM><#1567#> 
  39. <BR>    Begin rendering (action) on the given frame.
  40. </DD>
  41. </DL>The default starting frame is number zero.
  42.  
  43. <P>
  44. <DL>
  45. <DT><STRONG><#5088#><#5088#></STRONG></DT>
  46. <DD><#1570#><TT>-a</TT><#1570#>  
  47. <BR>    Toggle writing of alpha channel.
  48. </DD>
  49. </DL>This option is only available when the Utah Raster Toolkit is
  50. being used.
  51.  
  52. <P>
  53. <DL>
  54. <DT><STRONG><#5089#><#5089#></STRONG></DT>
  55. <DD><#1573#><TT>-C</TT><#1573#> <#1574#><EM>R G B</EM><#1574#> 
  56. <BR>    Set the adaptive ray tree pruning color.  If all
  57.     channel contributions falls below the given cutoff
  58.     values, no further rays are spawned.
  59. </DD>
  60. </DL>Overrides the value specified via the <#846#><TT>cutoff</TT><#846#> keyword.
  61.  
  62. <P>
  63. <DL>
  64. <DT><STRONG><#5090#><#5090#></STRONG></DT>
  65. <DD><#1577#><TT>-c</TT><#1577#>  
  66. <BR>    Continue an interrupted rendering.
  67. </DD>
  68. </DL>When given, this option indicates that the image file being written
  69. to contains a partially-completed image.  <#851#><#2063#><EM>Rayshade</EM><#2063#><#851#> will read the
  70. image to determine the scanline from which to continue the rendering.
  71. This option is only available with the Utah Raster Toolkit.
  72. The <#852#><TT>-O</TT><#852#> option must also be used.
  73.  
  74. <P>
  75. <DL>
  76. <DT><STRONG><#5091#><#5091#></STRONG></DT>
  77. <DD><#1580#><TT>-D</TT><#1580#> <#1581#><EM>depth</EM><#1581#> 
  78. <BR>    Set maximum ray tree depth.
  79. </DD>
  80. </DL>Overrides the value specified in the input file via the <#857#><TT>maxdepth</TT><#857#>
  81. keyword.
  82.  
  83. <P>
  84. <DL>
  85. <DT><STRONG><#5092#><#5092#></STRONG></DT>
  86. <DD><#1584#><TT>-E</TT><#1584#> <#1585#><EM>separation</EM><#1585#> 
  87. <BR>    Set eye separation for rendering of stereo pairs.
  88. </DD>
  89. </DL>Overrides the value specified via the <#862#><TT>eyesep</TT><#862#> keyword.
  90.  
  91. <P>
  92. <DL>
  93. <DT><STRONG><#5093#><#5093#></STRONG></DT>
  94. <DD><#1588#><TT>-e</TT><#1588#>  
  95. <BR>    Write exponential RLE file.
  96. </DD>
  97. </DL>This option is only available for use with the Utah Raster Toolkit.
  98. See the Utah Raster Toolkit's <#867#><EM>unexp</EM><#867#> manual page for details on
  99. exponential RLE files.
  100.  
  101. <P>
  102. <DL>
  103. <DT><STRONG><#5094#><#5094#></STRONG></DT>
  104. <DD><#1591#><TT>-F</TT><#1591#> <#1592#><EM>freq</EM><#1592#> 
  105. <BR>    Set frequency of status report.
  106. </DD>
  107. </DL>Overrides the value given using the <#872#><TT>report</TT><#872#> keyword.
  108.  
  109. <P>
  110. <DL>
  111. <DT><STRONG><#5095#><#5095#></STRONG></DT>
  112. <DD><#1595#><TT>-f</TT><#1595#>  
  113. <BR>    Flip all computed polygon (and triangle) normals.
  114. </DD>
  115. </DL>This option should be used when rendering polygons defined
  116. by vertices given in <#877#><EM>clockwise</EM><#877#>
  117. order, rather than counter-clockwise order as
  118. expected by <#878#><#2065#><EM>rayshade</EM><#2065#><#878#>.
  119.  
  120. <P>
  121. <DL>
  122. <DT><STRONG><#5096#><#5096#></STRONG></DT>
  123. <DD><#1598#><TT>-G</TT><#1598#> <#1599#><EM>gamma</EM><#1599#> 
  124. <BR>    Use given gamma correction exponent writing writing
  125.     color information to the image file.
  126. </DD>
  127. </DL>The default value for <#883#><EM>gamma</EM><#883#> is 1.0.
  128.  
  129. <P>
  130. <DL>
  131. <DT><STRONG><#5097#><#5097#></STRONG></DT>
  132. <DD><#1602#><TT>-g</TT><#1602#>  
  133. <BR>    Use a Gaussian pixel filter.
  134. </DD>
  135. </DL>Overrides the filter selected through the use of the <#888#><TT>filter</TT><#888#>
  136. keyword.
  137.  
  138. <P>
  139. <DL>
  140. <DT><STRONG><#5098#><#5098#></STRONG></DT>
  141. <DD><#1605#><TT>-h</TT><#1605#>  
  142. <BR>    Print a short use message.
  143. </DD>
  144. </DL>
  145. <P>
  146. <DL>
  147. <DT><STRONG><#5099#><#5099#></STRONG></DT>
  148. <DD><#1608#><TT>-j</TT><#1608#>  
  149. <BR>    Toggle the use of jittered sampling to perform antialiasing.
  150.     If disabled, a fixed sampling pattern is used.
  151. </DD>
  152. </DL>
  153. <P>
  154. <DL>
  155. <DT><STRONG><#5100#><#5100#></STRONG></DT>
  156. <DD><#1611#><TT>-l</TT><#1611#>  
  157. <BR>    Render the left stereo pair image.
  158. </DD>
  159. </DL>
  160. <P>
  161. <DL>
  162. <DT><STRONG><#5101#><#5101#></STRONG></DT>
  163. <DD><#1614#><TT>-m</TT><#1614#>  
  164. <BR>    Write a sampling map to the alpha channel.
  165. </DD>
  166. </DL>Rather than containing coverage information, the alpha channel values
  167. will be restricted to zero, indicating no supersampling, and full intensity,
  168. indicating supersampling.  This option is only available if the Utah
  169. Raster Toolkit is being used.
  170.  
  171. <P>
  172. <DL>
  173. <DT><STRONG><#5102#><#5102#></STRONG></DT>
  174. <DD><#1617#><TT>-N</TT><#1617#> <#1618#><EM>frames</EM><#1618#> 
  175. <BR>    Set the total number of frames to be rendered.
  176. </DD>
  177. </DL>This option overrides any value specified through the use of the
  178. <#909#><TT>frames</TT><#909#> keyword.  By default, a single frame is rendered.
  179.  
  180. <P>
  181. <DL>
  182. <DT><STRONG><#5103#><#5103#></STRONG></DT>
  183. <DD><#1621#><TT>-n</TT><#1621#>  
  184. <BR>    Do not render shadows.
  185. </DD>
  186. </DL>
  187. <P>
  188. <DL>
  189. <DT><STRONG><#5104#><#5104#></STRONG></DT>
  190. <DD><#1624#><TT>-O</TT><#1624#> <#1625#><EM>outfile</EM><#1625#> 
  191. <BR>    Write the image to the named file.
  192. </DD>
  193. </DL>This option overrides the name given with the <#918#><TT>outfile</TT><#918#> keyword,
  194. if any,
  195. in the input file.
  196.  
  197. <P>
  198. <DL>
  199. <DT><STRONG><#5105#><#5105#></STRONG></DT>
  200. <DD><#1628#><TT>-o</TT><#1628#>  
  201. <BR>    Toggle the effect of object opacity on shadows.
  202. </DD>
  203. </DL>This option is equivalent to specifying <#923#><TT>shadowtransp</TT><#923#>
  204. in the input file.  By default, <#924#><#2067#><EM>rayshade</EM><#2067#><#924#> traces shadow
  205. rays through non-opaque objects.
  206.  
  207. <P>
  208. <DL>
  209. <DT><STRONG><#5106#><#5106#></STRONG></DT>
  210. <DD><#1631#><TT>-P</TT><#1631#> <#1632#><EM>cpp-arguments</EM><#1632#> 
  211. <BR>    Specify the options that should be passed to the C
  212.     preprocessor.
  213. </DD>
  214. </DL>The C preprocessor, if available, is applied to all of the input
  215. passed to <#929#><EM>rayshade</EM><#929#>.
  216.  
  217. <P>
  218. <DL>
  219. <DT><STRONG><#5107#><#5107#></STRONG></DT>
  220. <DD><#1635#><TT>-p</TT><#1635#>  
  221. <BR>    Perform preview-quality rendering.
  222. </DD>
  223. </DL>This option is equivalent to <#934#><TT>-n -S 1 -D 0</TT><#934#>.
  224.  
  225. <P>
  226. <DL>
  227. <DT><STRONG><#5108#><#5108#></STRONG></DT>
  228. <DD><#1638#><TT>-q</TT><#1638#>  
  229. <BR>    Do not print warning messages.
  230. </DD>
  231. </DL>
  232. <P>
  233. <DL>
  234. <DT><STRONG><#5109#><#5109#></STRONG></DT>
  235. <DD><#1641#><TT>-R</TT><#1641#> <#1642#><EM>xsize ysize</EM><#1642#> 
  236. <BR>    Produce an image <#942#><EM>xsize</EM><#942#> pixels wide by
  237.     <#943#><EM>ysize</EM><#943#> pixels high.
  238. </DD>
  239. </DL>This option overrides any screen size set by use of
  240. the <#945#><TT>screen</TT><#945#> keyword.
  241.  
  242. <P>
  243. <DL>
  244. <DT><STRONG><#5110#><#5110#></STRONG></DT>
  245. <DD><#1645#><TT>-r</TT><#1645#>  
  246. <BR>    Render the right stereo pair image.
  247. </DD>
  248. </DL>
  249. <P>
  250. <DL>
  251. <DT><STRONG><#5111#><#5111#></STRONG></DT>
  252. <DD><#1648#><TT>-S</TT><#1648#> <#1649#><EM>samples</EM><#1649#> 
  253. <BR>    Use <I>samples</I><SUP>2</SUP> jittered samples.
  254. </DD>
  255. </DL>This option overrides any value set through the use of
  256. the <#954#><TT>samples</TT><#954#> keyword in the input file.
  257.  
  258. <P>
  259. <DL>
  260. <DT><STRONG><#5113#><#5113#></STRONG></DT>
  261. <DD><#1652#><TT>-s</TT><#1652#>  
  262. <BR>    Disable caching of  shadowing information.
  263. </DD>
  264. </DL>It should never be necessary to use this option.
  265.  
  266. <P>
  267. <DL>
  268. <DT><STRONG><#5114#><#5114#></STRONG></DT>
  269. <DD><#1655#><TT>-T</TT><#1655#> <#1656#><EM>r g b</EM><#1656#> 
  270. <BR>    Set the contrast threshold in the three
  271.     color channels for use in adaptive supersampling.
  272. </DD>
  273. </DL>This option overrides any value given through the use of
  274. the <#963#><EM>contrast</EM><#963#> keyword.
  275.  
  276. <P>
  277. <DL>
  278. <DT><STRONG><#5115#><#5115#></STRONG></DT>
  279. <DD><#1659#><TT>-u</TT><#1659#>  
  280. <BR>    Toggle the use of the C preprocessor.
  281. </DD>
  282. </DL><#968#><#2069#><EM>Rayshade</EM><#2069#><#968#> usually feeds its input through a
  283. C preprocessor if one is available on your system.
  284. If this option is given, unadulterated input files will
  285. be used.
  286.  
  287. <P>
  288. <DL>
  289. <DT><STRONG><#5116#><#5116#></STRONG></DT>
  290. <DD><#1662#><TT>-V</TT><#1662#> <#1663#><EM>filename</EM><#1663#> 
  291. <BR>    Write verbose output to the named file.
  292. </DD>
  293. </DL>This option overrides any file named through the use of
  294. the <#973#><TT>report</TT><#973#> keyword.
  295.  
  296. <P>
  297. <DL>
  298. <DT><STRONG><#5117#><#5117#></STRONG></DT>
  299. <DD><#1666#><TT>-v</TT><#1666#>  
  300. <BR>    Write verbose output.
  301. </DD>
  302. </DL>When given, this option causes information about the options
  303. selected and the objects defined to be included in the
  304. report file.
  305.  
  306. <P>
  307. <DL>
  308. <DT><STRONG><#5118#><#5118#></STRONG></DT>
  309. <DD><#1669#><TT>-W</TT><#1669#> <#1670#><EM>minx maxx miny maxy</EM><#1670#> 
  310. <BR>    Render the specified window.
  311. </DD>
  312. </DL>The window must be properly contained within the screen.  This
  313. option overrides any window specified using the <#982#><EM>window</EM><#982#> keyword
  314. in the input file.
  315.  
  316. <P>
  317. <DL>
  318. <DT><STRONG><#5119#><#5119#></STRONG></DT>
  319. <DD><#1673#><TT>-X</TT><#1673#> <#1674#><EM>left right bottom top</EM><#1674#> 
  320. <BR>    Crop the rendering window using the given normalized values.
  321. </DD>
  322. </DL>This option is provided to facilitate changing and/or examining a
  323. small portion of an image without having to re-render the entire
  324. image.
  325.