changeset 31828:d4693c66e7c9 stable

doc: Update section about hardware vs. software rendering on Windows. * doc/interpreter/plot.txi (Hardware vs Software Rendering): Refer to "OpenGL Switcher" application with Octave for Windows.
author Markus Mützel <markus.muetzel@gmx.de>
date Wed, 15 Feb 2023 16:40:48 +0100
parents 449d9b0f3478
children 2ea6344450e3 c5fa6a6ba7af
files doc/interpreter/plot.txi
diffstat 1 files changed, 14 insertions(+), 7 deletions(-) [+]
line wrap: on
line diff
--- a/doc/interpreter/plot.txi	Thu Feb 02 10:37:45 2023 -0800
+++ b/doc/interpreter/plot.txi	Wed Feb 15 16:40:48 2023 +0100
@@ -2798,17 +2798,24 @@
 @subsubsection Hardware vs Software Rendering
 @cindex opengl rendering slow windows
 
-On Windows platforms, Octave uses software rendering for the OpenGL graphics
-toolkits (@qcode{"qt"} and @qcode{"fltk"}) by default.  This is done to avoid
+When using the Octave for Windows installer, the user has the option to select
+between "System OpenGL" and "Software OpenGL" renderers.  This option selects
+whether software rendering is used for the OpenGL graphics toolkits
+(@qcode{"qt"} and @qcode{"fltk"}).  Software rendering can be used to avoid
 rendering and printing issues due to imperfect OpenGL driver implementations
-for diverse graphic cards from different vendors.  As a down-side, software
-rendering might be considerably slower than hardware accelerated rendering.
-To permanently switch back to hardware accelerated rendering with your graphic
-card drivers, rename the following file while Octave is closed:
+for diverse graphic cards from different vendors (notably integrated Intel
+graphics).  As a down-side, software rendering might be considerably slower
+than hardware accelerated rendering (and it might not work correctly on 32-bit
+platforms or WoW64).  To permanently switch between hardware accelerated
+rendering with your graphics card drivers and software rendering, use the
+"OpenGL Switcher" application from the Start menu while Octave is closed.
+Alternatively, rename the following file while Octave is closed:
 
 @file{@var{octave-home}\bin\opengl32.dll}
 @*where @var{octave-home} is the directory in which Octave is installed (the
-default is @file{C:\Octave\Octave-@var{version}}).
+default is @file{C:\Program Files\GNU Octave\Octave\Octave-@var{version}}).
+Change the file extension to @file{.bak} for hardware rendering or to
+@file{.dll} for software rendering.
 
 @node Precision issues
 @subsubsection Precision issues