Difference between revisions of "Documentation:Unix Section 2"

From POV-Wiki
Jump to navigation Jump to search
m (updates (WIP))
m (canonicalize some version numbers)
 
(8 intermediate revisions by one other user not shown)
Line 8: Line 8:
 
<!--</wikitalk>--->
 
<!--</wikitalk>--->
 
==Features==
 
==Features==
<p>
 
This section lists significant new features in the Unix version of POV-Ray 3.6, compared
 
to the last release (3.5). It does not list new features of the rendering engine, but only
 
of the Unix version.
 
</p>
 
 
===What's new in POV-Ray for Unix===
 
 
<p>This section covers version 3.7 changes and new features that apply to POV-Ray for Unix. See the section [[Documentation:Tutorial Section 1#Changes and New Features Summary|Changes and New Features Summary]] for information about <em>non-platform</em> specific changes.</p>
 
<p>This section covers version 3.7 changes and new features that apply to POV-Ray for Unix. See the section [[Documentation:Tutorial Section 1#Changes and New Features Summary|Changes and New Features Summary]] for information about <em>non-platform</em> specific changes.</p>
 +
===New Features===
 
<ol>
 
<ol>
<li> Reworked <code>--benchmark</code>:</li>
+
<li>Reworked the built-in <code>--benchmark</code></li>
 
<ul>
 
<ul>
<li>The built-in benchmark now accepts <code>+L<path></code> command-line options</li>
+
<li>The built-in benchmark now accepts the <code>+L&lt;path&gt;</code> command-line option</li>
<li>now <em>ONLY</em> reads the provided any INI file.</li>
+
<li>and now <em>ONLY</em> reads the built-in INI file.</li>
 +
<li>It also accepts <code>+wt</code> to set the number of work threads</li>
 +
<li>and now also accepts the <code>--version</code> parameter</li>
 
</ul>
 
</ul>
 
<li> Added preliminary Linux support for these two features:
 
<li> Added preliminary Linux support for these two features:
 
<ul>
 
<ul>
 
<li> CPU timer; might return incorrect results depending on the platform.</li>
 
<li> CPU timer; might return incorrect results depending on the platform.</li>
<li> signal catching (e.g. when aborting a render by hitting Ctrl+C).</li>
+
<li> signal catching when aborting a render by hitting Ctrl+C</li>
 
</ul>
 
</ul>
<li> Added support for 'pause when done' in linux build.</li>
+
<li> Added support for the <code>+P</code> option  to allow <em>pause when done</em>.</li>
<li> Added support for <code>--benchmark</code> on unix works together with <code>+wt</code> and print built-in features with <code>--version</code></li>
 
 
<li> Unix default file gamma changed from from 1.0 to 2.2.</li>
 
<li> Unix default file gamma changed from from 1.0 to 2.2.</li>
 
</ol>
 
</ol>
  
===I/O Restrictions===
+
===Display Options===
<p>
+
<p>The Unix version now has a single binary which supports display using the X Window System, or using the SVGA library with the console on <em>GNU/Linux systems only</em>, or via text graphics otherwise. If the command-line options or INI files turn on display, the following heuristic is used to determine what kind of display should be used.  If the DISPLAY environment variable is set, the X Window display is used.  Otherwise, if the user is on the console, and has permission to do so, SVGAlib is usedOtherwise, text graphics are used.</p>
The Unix platform specific part of the I/O Restrictions feature has been redesigned for POV-Ray
 
3.6.  The <!--<linkto "Configuration file format">configuration file format</linkto>--->[[Documentation:Unix Section 4#Configuration file format|configuration file format]]
 
has changed as well as the way the settings are interpreted.  How the I/O Restriction
 
can be controlled in the Unix version is described in the
 
<!--<linkto "I/O Restrictions">I/O Restrictions Documentation</linkto>--->[[Documentation:Unix Section 4#I/O Restrictions|I/O Restrictions Documentation]].
 
</p>
 
<p>
 
As a quick summary, I/O Restrictions control where the POV-Ray core code may and may not read
 
or write files. By default, this is turned on and is fairly restrictive (read/write is allowed
 
in the directory that the main input file is in, and read is allowed in the standard installation
 
directories).
 
</p>
 
<p class="Note"><strong>Note:</strong>
 
The I/O Restriction code may not be completely mature yetPlease report any bugs you may find.
 
</p>
 
  
===Display Options===
+
<p>Text graphics display a crude 75x24 ASCII version of the image which can be useful none the less to monitor the render progress on a text terminal. Using text graphics and the Verbose <code>+v</code> option simultaneously will not work very well.</p>  
<p>
 
The Unix version now has a single binary which supports display using the X Window System,
 
or using the SVGA library (SVGAlib) on the console (GNU/Linux systems only), or via text
 
graphics otherwise.  If the command-line options or INI files turn on display, the following
 
heuristic is used to determine what kind of display should be used.  If the DISPLAY environment
 
variable is set, the X Window display is used.  Otherwise, if the user is on the console,
 
and has permission to do so, SVGAlib is used. Otherwise, text graphics are used.
 
</p>
 
  
<p>
+
<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>
Text graphics display a crude 75x24 ASCII version of the image which can
 
be useful none the less to monitor the render progress on a text terminal.
 
Using text graphics and the Verbose (+v) option simultaneously will not work
 
very well.
 
</p>  
 
  
 
===Benchmark Mode===
 
===Benchmark Mode===
<p>
+
<p>POV-Ray v3.7 for Unix provides a new mode to render a built-in version of the standard POV-Ray benchmark scene. See the <!--<linkto "Benchmark Rendering Mode">Benchmark Rendering Mode documentation</linkto>--->[[Documentation:Unix Section 6#Benchmark Rendering Mode|Benchmark Rendering Mode documentation]] for details.</p>
POV-Ray 3.6 for Unix provides a new mode to render a built-in version
 
of the standard POV-Ray benchmark scene.
 
See the <!--<linkto "Benchmark Rendering Mode">Benchmark Rendering Mode documentation</linkto>--->[[Documentation:Unix Section 6#Benchmark Rendering Mode|Benchmark Rendering Mode documentation]]  
 
for details.
 
</p>
 
  
 
===Sample scene render scripts===
 
===Sample scene render scripts===
<p>
+
<p>POV-Ray v3.7 includes a set of shell scripts to automatically render all the samples coming with POV-Ray and that generate HTML files to easily browse the sample scenes.  See <!--<linkto "Rendering the Sample Scenes">Rendering the Sample Scenes</linkto>--->[[Documentation:Unix Section 3#Rendering the Sample Scenes|Rendering the Sample Scenes]] for more information.</p>
POV-Ray 3.6 includes a set of shell scripts to automatically render all the samples
 
coming with POV-Ray and that generate HTML files to easily browse the
 
sample scenes.  See <!--<linkto "Rendering the Sample Scenes">Rendering the Sample Scenes</linkto>--->[[Documentation:Unix Section 3#Rendering the Sample Scenes|Rendering the Sample Scenes]]
 
for more information.
 
</p>
 
===KDE integration===
 
<p>
 
The binary package for x86-Linux (<code>povlinux.tgz</code>) comes with
 
an install script that generates some useful entries in the
 
[http://www.kde.org/ KDE] panel for convenient
 
access to the POV-Ray documentation and configuration files.
 
</p>
 
  
<p>
+
===KDE Integration===
The generic Unix source distribution also comes with the
+
<p>The binary package for x86-Linux (<code>povlinux.tgz</code>) comes with an install script that generates some useful entries in the [http://www.kde.org/ KDE] panel for convenient access to the POV-Ray documentation and configuration files.</p>
<code>kde_install.sh</code> script to perform the same task.
 
This script is derived from the install script above.
 
</p>
 
  
 +
<p>The generic Unix source distribution also comes with the <code>kde_install.sh</code> script to perform the same task.</p>
 
<!--<wikinav>--->
 
<!--<wikinav>--->
 
<br>
 
<br>

Latest revision as of 15:37, 9 June 2021

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


Features

This section covers version 3.7 changes and new features that apply to POV-Ray for Unix. See the section Changes and New Features Summary for information about non-platform specific changes.

New Features

  1. Reworked the built-in --benchmark
    • The built-in benchmark now accepts the +L<path> command-line option
    • and now ONLY reads the built-in INI file.
    • It also accepts +wt to set the number of work threads
    • and now also accepts the --version parameter
  2. Added preliminary Linux support for these two features:
    • CPU timer; might return incorrect results depending on the platform.
    • signal catching when aborting a render by hitting Ctrl+C
  3. Added support for the +P option to allow pause when done.
  4. Unix default file gamma changed from from 1.0 to 2.2.

Display Options

The Unix version now has a single binary which supports display using the X Window System, or using the SVGA library with the console on GNU/Linux systems only, or via text graphics otherwise. If the command-line options or INI files turn on display, the following heuristic is used to determine what kind of display should be used. If the DISPLAY environment variable is set, the X Window display is used. Otherwise, if the user is on the console, and has permission to do so, SVGAlib is used. Otherwise, text graphics are used.

Text graphics display a crude 75x24 ASCII version of the image which can be useful none the less to monitor the render progress on a text terminal. Using text graphics and the Verbose +v option simultaneously will not work very well.

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

Benchmark Mode

POV-Ray v3.7 for Unix provides a new mode to render a built-in version of the standard POV-Ray benchmark scene. See the Benchmark Rendering Mode documentation for details.

Sample scene render scripts

POV-Ray v3.7 includes a set of shell scripts to automatically render all the samples coming with POV-Ray and that generate HTML files to easily browse the sample scenes. See Rendering the Sample Scenes for more information.

KDE Integration

The binary package for x86-Linux (povlinux.tgz) comes with an install script that generates some useful entries in the KDE panel for convenient access to the POV-Ray documentation and configuration files.

The generic Unix source distribution also comes with the kde_install.sh script to perform the same task.


Trademarks Getting Started


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