<!-- This file copyright Persistence of Vision Raytracer Pty. Ltd. 2003-2004 -->
<html>
<head>
<!-- NOTE: In order to users to help find information about POV-Ray using -->
<!-- web search engines, we ask you to *not* let them index documentation -->
<!-- mirrors because effectively, when searching, users will get hundreds -->
<!-- of results containing the same information! For this reason, the two -->
<!-- meta tags below disable archiving and indexing of this page by all -->
<!-- search engines that support these meta tags. -->
<meta content="noarchive" name="robots">
<meta content="noindex" name="robots">
<meta content="no-cache" http-equiv="Pragma">
<meta content="0" http-equiv="expires">
<title>1.6.1 Special Command-Line Options</title>
<link href="povray35.css" rel="stylesheet" type="text/css">
</head>
<body>
<table class="NavBar" width="100%">
<tr>
<td align="left" nowrap="" valign="middle" width="32">
<a href="s_32.html"><img alt="previous" border="0" src="prev.png"></a>
</td>
<td align="left" valign="middle" width="30%">
<a href="s_32.html">1.6 Understanding POV-Ray Options</a>
</td>
<td align="center" valign="middle">
<strong class="NavBar">POV-Ray 3.6 for UNIX documentation</strong><br> <strong>1.6.1
Special Command-Line Options</strong>
</td>
<td align="right" valign="middle" width="30%">
<a href="s_34.html">1.6.2 Benchmark Rendering Mode</a>
</td>
<td align="right" nowrap="" valign="middle" width="32">
<a href="s_34.html"><img alt="next" border="0" src="next.png"></a>
</td>
</tr>
</table>
<h3><a name="s01_06_01">1.6.1 </a>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>
</p>
<dl>
<dt>
<code>-display <display_name></code>
<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.
<dt>
<code>-geometry [WIDTHxHEIGHT][+XOFF+YOFF]</code>
<dd>
Render the image with WIDTH and HEIGHT 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).
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.
<dt>
<code>-help</code>
<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.
<dt>
<code>-icon</code>
<dd>
Start the preview window as an icon.
<dt>
<code>-title <window_title></code>
<dd>
Override the default preview window title with window_title.
<dt>
<code>-visual <visual_type></code>
<dd>
Use the deepest visual of visual_type, if available, instead of the automatically selected visual. Valid visuals
are StaticGray, GrayScale, StaticColor, PseudoColor, TrueColor, or DirectColor.
</dl>
<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>
<br>
<table class="NavBar" width="100%">
<tr>
<td align="left" nowrap="" valign="middle" width="32">
<a href="s_32.html"><img alt="previous" border="0" src="prev.png"></a>
</td>
<td align="left" valign="middle" width="30%">
<a href="s_32.html">1.6 Understanding POV-Ray Options</a>
</td>
<td align="center" valign="middle">
<strong>1.6.1 Special Command-Line Options</strong>
</td>
<td align="right" valign="middle" width="30%">
<a href="s_34.html">1.6.2 Benchmark Rendering Mode</a>
</td>
<td align="right" nowrap="" valign="middle" width="32">
<a href="s_34.html"><img alt="next" border="0" src="next.png"></a>
</td>
</tr>
</table>
</body> </html>
