Difference between revisions of "Documentation:Unix Section 6"

From POV-Wiki
Jump to navigation Jump to search
m (1 revision(s))
m (1 revision: updates related to change #5720)
 
(7 intermediate revisions by the same user not shown)
Line 7: Line 7:
 
<br>
 
<br>
 
<!--</wikitalk>--->
 
<!--</wikitalk>--->
===Understanding POV-Ray Options===
+
==Understanding POV-Ray Options==
<p>
+
<p>Options are what previous versions of POV-Ray used to refer to as command-line options. The term is no longer accurate for POV-Ray 3.x, because the command line is only one way of passing options to the program. The other, more convenient way, is to use <!--<linkto "INI Files">INI files</linkto>--->[[Documentation:Unix Section 5#INI Files|INI files]].</p>
Options are what previous versions of POV-Ray used to refer to as command-line options. The
 
term is no longer accurate for POV-Ray 3.x, because the command line is only one way of passing
 
options to the program. The other, more convenient way, is to use
 
<!--<linkto "INI Files">INI files</linkto>--->[[Documentation:Unix Section 5#INI Files|INI files]].
 
</p>
 
  
 
===Special Command-Line Options===
 
===Special Command-Line Options===
<p>
+
<p>POV-Ray for Unix supports several special command-line options not recognized by other versions.  They follow the standards for programs that run under the X Window System.</p>
POV-Ray for Unix supports several special command-line options not recognized by other
+
 
versions.  They follow the standards for programs
+
<p class="Note"><strong>Note:</strong> See the section [[Documentation:Unix Section 7#Known Bugs|Known Bugs]] for more information about a problem with the X11 windows system.</p>
that run under the X Window System.
 
</p>
 
  
 
<dl>
 
<dl>
 
<dt><code>-display &lt;display_name&gt;</code><!--</dt>--->
 
<dt><code>-display &lt;display_name&gt;</code><!--</dt>--->
<dd>Display preview on  display_name  rather  than  the
+
<dd>Display preview on  display_name  rather  than  the default  display.  This  is  meant  to  be used to change the display to a remote  host.  The  normal dispay option <code>+d</code> is still valid.<!--</dd>--->
default  display.  This  is  meant  to  be used to
 
change the display to a remote  host.  The  normal
 
dispay option <code>+d</code> is still valid.<!--</dd>--->
 
  
 
<dt><code>-geometry [WIDTHxHEIGHT][+XOFF+YOFF]</code><!--</dt>--->
 
<dt><code>-geometry [WIDTHxHEIGHT][+XOFF+YOFF]</code><!--</dt>--->
<dd>Render the image with WIDTH and HEIGHT as the
+
<dd>Render the image with <code>WIDTH</code> and <code>HEIGHT</code> as the dimensions, and locate the window <code>XOFF</code> from the left edge, and <code>YOFF</code> from the top edge of the screen, or if negative the right and bottom edges respectively.<br>For instance: <code>-geometry 640x480+10+20</code> creates a display for a 640x480 image placed at (10,20) pixels from the top-left corner of the screen. The <code>WIDTH</code> and <code>HEIGHT</code>, if given, override any previous <code>+Wn</code> and <code>+Hn</code> settings.<!--</dd>--->
dimensions, and locate the window <code>XOFF</code> from the
 
left edge, and <code>YOFF</code> from the top edge of the screen
 
(or if negative the right and bottom edges respectively).
 
For instance: <code>-geometry 640x480+10+20</code> creates a
 
display for a 640x480 image placed at (10,20) pixels from the
 
top-left corner of the screen.
 
The <code>WIDTH</code> and <code>HEIGHT</code>, if given, override
 
any previous +Wn and +Hn settings.<!--</dd>--->
 
  
 
<dt><code>-help</code><!--</dt>--->
 
<dt><code>-help</code><!--</dt>--->
<dd>Display the X Window System-specific options.   Use
+
<dd>Display the X Window System-specific options. Use<code>-H</code> by itself on the command-line to output the general POV-Ray options.<!--</dd>--->
<code>-H</code> by itself on the command-line to output the general POV-Ray
 
options.<!--</dd>--->
 
  
 
<dt><code>-icon</code><!--</dt>--->
 
<dt><code>-icon</code><!--</dt>--->
Line 49: Line 29:
  
 
<dt><code>-title &lt;window_title&gt;</code><!--</dt>--->
 
<dt><code>-title &lt;window_title&gt;</code><!--</dt>--->
<dd>Override the default preview window title with window_title.<!--</dd>--->
+
<dd>Override the default preview window title with <strong><code>window_title</code></strong>.<!--</dd>--->
  
 
<dt><code>-visual &lt;visual_type&gt;</code><!--</dt>--->
 
<dt><code>-visual &lt;visual_type&gt;</code><!--</dt>--->
<dd>Use  the  deepest  visual of visual_type, if available, instead of the
+
<dd>Use  the  deepest  visual of <strong><code>visual_type</code></strong>, if available, instead of the automatically  selected visual.<!--</dd>--->
automatically  selected visual.  Valid  visuals are StaticGray, GrayScale,
 
StaticColor,  PseudoColor,  TrueColor,  or  DirectColor.<!--</dd>--->
 
 
</dl>
 
</dl>
 +
<p>Valid <strong><code>visual_type</code></strong> values:</p>
 +
<ul>
 +
<li>StaticGray</li>
 +
<li>GrayScale</li>
 +
<li>StaticColor</li>
 +
<li>PseudoColor</li>
 +
<li>TrueColor</li>
 +
<li>DirectColor</li>
 +
</ul>
  
<p class="Note">
+
<p class="Note"><strong>Note:</strong> If you are supplying a filename with spaces in it, you will need to enclose the filename itself within quotes.</p>
<strong>Note:</strong> if you are supplying a filename with spaces in it, you will
 
need to enclose the filename itself within quotes.
 
</p>
 
  
 
===Benchmark Rendering Mode===
 
===Benchmark Rendering Mode===
<p>
+
<p>POV-Ray for Unix has a <em>built-in</em> version of the standard benchmark scene. In version 3.7 the <em>built-in</em> benchmark mode has been further modified to run without accessing <em>any</em> other distribution files, so now benchmarking can now be done with <em>just</em> the compiled executable.</p>
POV-Ray for Unix has a builtin version of the standard benchmark scene.
+
<p>To run this scene use the <code>--benchmark</code> command line option:</p>
To run this scene use the <code>-benchmark</code> command line option:
 
</p>
 
  
 
<pre>
 
<pre>
povray -benchmark
+
povray --benchmark
 
</pre>
 
</pre>
  
<p>
+
<p>Note that running the benchmark takes some time, on a 3 GHz AMD x2 250 processor with 4GB ram, about 12 minutes. There will be no image or file output from this render. For more information on the standard POV-Ray benchmark have a look at the [http://www.povray.org/download/benchmark.php Benchmarking with POV-Ray] page.</p>
Note that running the benchmark takes some time, on a 2 GHz PC processor  
 
about 45 minutes. There will be no image or file output from this render.
 
For more information on the standard POV-Ray benchmark have a look at the
 
[http://www.povray.org/download/benchmark.php|_new <span title="Opens A New Window!">Benchmarking with POV-Ray</span>]
 
page.
 
</p>
 
 
<!--<wikinav>--->
 
<!--<wikinav>--->
 
<br>
 
<br>

Latest revision as of 12:58, 10 October 2012

This document is protected, so submissions, corrections and discussions should be held on this documents talk page.


Understanding POV-Ray Options

Options are what previous versions of POV-Ray used to refer to as command-line options. The term is no longer accurate for POV-Ray 3.x, because the command line is only one way of passing options to the program. The other, more convenient way, is to use INI files.

Special Command-Line Options

POV-Ray for Unix supports several special command-line options not recognized by other versions. They follow the standards for programs that run under the X Window System.

Note: See the section Known Bugs for more information about a problem with the X11 windows system.

-display <display_name>
Display preview on display_name rather than the default display. This is meant to be used to change the display to a remote host. The normal dispay option +d is still valid.
-geometry [WIDTHxHEIGHT][+XOFF+YOFF]
Render the image with WIDTH and HEIGHT as the dimensions, and locate the window XOFF from the left edge, and YOFF from the top edge of the screen, or if negative the right and bottom edges respectively.
For instance: -geometry 640x480+10+20 creates a display for a 640x480 image placed at (10,20) pixels from the top-left corner of the screen. The WIDTH and HEIGHT, if given, override any previous +Wn and +Hn settings.
-help
Display the X Window System-specific options. Use-H by itself on the command-line to output the general POV-Ray options.
-icon
Start the preview window as an icon.
-title <window_title>
Override the default preview window title with window_title.
-visual <visual_type>
Use the deepest visual of visual_type, if available, instead of the automatically selected visual.

Valid visual_type values:

  • StaticGray
  • GrayScale
  • StaticColor
  • PseudoColor
  • TrueColor
  • DirectColor

Note: If you are supplying a filename with spaces in it, you will need to enclose the filename itself within quotes.

Benchmark Rendering Mode

POV-Ray for Unix has a built-in version of the standard benchmark scene. In version 3.7 the built-in benchmark mode has been further modified to run without accessing any other distribution files, so now benchmarking can now be done with just the compiled executable.

To run this scene use the --benchmark command line option:

povray --benchmark

Note that running the benchmark takes some time, on a 3 GHz AMD x2 250 processor with 4GB ram, about 12 minutes. There will be no image or file output from this render. For more information on the standard POV-Ray benchmark have a look at the Benchmarking with POV-Ray page.


INI File Sections Bug Reports


This document is protected, so submissions, corrections and discussions should be held on this documents talk page.