Difference between revisions of "Documentation:Unix Section 2"

From POV-Wiki
Jump to navigation Jump to search
m (heading change)
m (canonicalize some version numbers)
 
(9 intermediate revisions by one other user not shown)
Line 7: Line 7:
 
<br>
 
<br>
 
<!--</wikitalk>--->
 
<!--</wikitalk>--->
−
==New Features==
+
==Features==
−
<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>
−
This section lists significant new features in the Unix version of POV-Ray 3.6, compared
+
===New Features===
−
to the last release (3.5). It does not list new features of the rendering engine, but only
+
<ol>
−
of the Unix version.
+
<li>Reworked the built-in <code>--benchmark</code></li>
−
</p>
+
<ul>
 +
<li>The built-in benchmark now accepts the <code>+L&lt;path&gt;</code> command-line option</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>
 +
<li> Added preliminary Linux support for these two features:
 +
<ul>
 +
<li> CPU timer; might return incorrect results depending on the platform.</li>
 +
<li> signal catching when aborting a render by hitting Ctrl+C</li>
 +
</ul>
 +
<li> Added support for the <code>+P</code> option  to allow <em>pause when done</em>.</li>
 +
<li> Unix default file gamma changed from from 1.0 to 2.2.</li>
 +
</ol>
  
−
===I/O Restrictions===
+
===Display Options===
−
<p class="Note"><strong>Note:</strong>
+
<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 used.  Otherwise, text graphics are used.</p>
−
The I/O Restriction code may not be completely mature yet.  Please report any bugs you may find.
 
−
</p>
 
−
<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>
 
  
−
===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.

Retrieved from "https://wiki.povray.org/content?title=Documentation:Unix_Section_2&oldid=10475"