1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
|
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
<!-- This file copyright Persistence of Vision Raytracer Pty. Ltd. 2009-2011 -->
<html lang="en">
<head>
<meta http-equiv=Content-Type content="text/html; charset=windows-1252">
<title>Unix Section 6</title>
<link rel="StyleSheet" href="povray37.css" type="text/css">
<link rel="shortcut icon" href="favicon.ico">
<!-- NOTE: In order to help users find information about POV-Ray using web -->
<!-- search engines, we ask that you *not* let them index documentation -->
<!-- mirrors because effectively, when searching, users will get hundreds of -->
<!-- results containing the same information! For this reason, these meta tags -->
<!-- below disable archiving of this page by search engines. -->
<meta name="robots" content="noarchive">
<meta http-equiv="Pragma" content="no-cache">
<meta http-equiv="expires" content="0">
</head>
<body>
<div class="Page">
<!-- NavPanel Begin -->
<div class="NavPanel">
<table class="NavTable">
<tr>
<td class="FixedPanelHeading"><a title="1.6" href="#u1_6">Understanding POV-Ray Options</a></td>
</tr>
<tr>
<td><div class="divh2"><strong><a title="1.6.1" href="#u1_6_1">Special Command-Line Options</a></strong></div></td>
</tr>
<tr>
<td><div class="divh2"><strong><a title="1.6.2" href="#u1_6_2">Benchmark Rendering Mode</a></strong></div></td>
</tr>
<tr>
<td><div class="divh1"> </div></td>
</tr>
<tr>
<td><div class="divh1"> </div></td>
</tr>
</table>
</div>
<!-- NavPanel End -->
<div class="Content">
<table class="HeaderFooter" width="100%">
<tr>
<td colspan=5 align="left" class="HeaderFooter">
POV-Ray for Unix <strong class="HeaderFooter">version 3.7</strong>
</td>
</tr>
<tr >
<td colspan=5>
<hr align="right" width="70%">
</td>
</tr>
<tr>
<td width="30%"></td>
<td class="NavBar"><a href="index.html" title="The Front Door">Home</a></td>
<td class="NavBar"><a href="u1_0.html" title="Unix Table of Contents">POV-Ray for Unix</a></td>
<td class="NavBar"><a href="t2_0.html" title="Tutorial Table of Contents">POV-Ray Tutorial</a></td>
<td class="NavBar"><a href="r3_0.html" title="Reference Table of Contents">POV-Ray Reference</a></td>
</tr>
</table>
<a name="u1_6"></a>
<div class="content-level-h2" contains="Understanding POV-Ray Options" id="u1_6">
<h2>1.6 Understanding POV-Ray Options</h2>
<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 <a href="u1_5.html#u1_5_2">INI files</a>.</p>
</div>
<a name="u1_6_1"></a>
<div class="content-level-h3" contains="Special Command-Line Options" id="u1_6_1">
<h3>1.6.1 Special Command-Line Options</h3>
<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>
<p class="Note"><strong>Note:</strong> See the section <a href="u1_7.html#u1_7_1">Known Bugs</a> for more information about a problem with the X11 windows system.</p>
<dl>
<dt><code>-display <display_name></code></dt>
<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>
<dt><code>-geometry [WIDTHxHEIGHT][+XOFF+YOFF]</code></dt>
<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>
<dt><code>-help</code></dt>
<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>
<dt><code>-icon</code></dt>
<dd>Start the preview window as an icon.</dd>
<dt><code>-title <window_title></code></dt>
<dd>Override the default preview window title with <strong><code>window_title</code></strong>.</dd>
<dt><code>-visual <visual_type></code></dt>
<dd>Use the deepest visual of <strong><code>visual_type</code></strong>, if available, instead of the automatically selected visual.</dd>
</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"><strong>Note:</strong> If you are supplying a filename with spaces in it, you will need to enclose the filename itself within quotes.</p>
</div>
<a name="u1_6_2"></a>
<div class="content-level-h3" contains="Benchmark Rendering Mode" id="u1_6_2">
<h3>1.6.2 Benchmark Rendering Mode</h3>
<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>
<p>To run this scene use the <code>--benchmark</code> command line option:</p>
<pre>
povray --benchmark
</pre>
<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 <a href="http://www.povray.org/download/benchmark.php">Benchmarking with POV-Ray</a> page.</p>
</div>
</div>
</div>
</body>
</html>
|
