Difference between revisions of "Documentation:Unix Section 2"
Jholsenback (talk | contribs) 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 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>Reworked the built-in <code>--benchmark</code></li> |
<ul> | <ul> | ||
− | <li>The built-in benchmark now accepts <code>+L | + | <li>The built-in benchmark now accepts the <code>+L<path></code> command-line option</li> |
− | <li>now <em>ONLY</em> reads the | + | <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 | + | <li> signal catching when aborting a render by hitting Ctrl+C</li> |
</ul> | </ul> | ||
− | <li> Added support for | + | <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> | <li> Unix default file gamma changed from from 1.0 to 2.2.</li> | ||
</ol> | </ol> | ||
− | === | + | ===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 used. Otherwise, text graphics are used.</p> |
− | The Unix | ||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | or | ||
− | |||
− | |||
− | |||
− | |||
− | |||
− | </p> | ||
− | + | <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> | ||
− | |||
− | |||
− | graphics | ||
− | |||
− | |||
− | |||
− | </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> |
− | |||
− | |||
− | |||
− | |||
− | </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 | ||
− | 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 | ||
− | 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> | ||
− | <p> | + | ===KDE Integration=== |
− | 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> | ||
− | |||
− | </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
- 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 - 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
- Added support for the
+P
option to allow pause when done. - 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. |