summaryrefslogtreecommitdiff
diff options
context:
space:
mode:
authorChun-wei Fan <fanchunwei@src.gnome.org>2022-08-01 12:32:53 +0800
committerChun-wei Fan <fanchunwei@src.gnome.org>2022-08-02 13:53:06 +0800
commit489f2190bef48bb5b06695b86fa9e659f519f67e (patch)
treecc1ceb779f519f89efe78c62b875c33ff304733c
parent2cb920a51bf3cc2ed5d52462556d037a609365b6 (diff)
downloadgtk+-489f2190bef48bb5b06695b86fa9e659f519f67e.tar.gz
README.win32: Add note on using OpenGL on Windows
...when running on a system with nVidia graphics with Nahimic installed, since a known issue within the graphics drivers and/or Nahimic can cause random crashes and issues when OpenGL (G[t|d]kGLArea) is being used. This will close issue #4113--sadly, this issue is an issue that is beyond our reach to try fixing within GTK.
-rw-r--r--README.win3216
1 files changed, 16 insertions, 0 deletions
diff --git a/README.win32 b/README.win32
index 704f6f3caf..f208a49ed9 100644
--- a/README.win32
+++ b/README.win32
@@ -3,6 +3,22 @@ The Win32 backend in GTK+ is not as stable or correct as the X11 one.
For prebuilt runtime and developer packages see
http://ftp.gnome.org/pub/gnome/binaries/win32/
+Notes on using OpenGL (GtkGLArea/GdkGLArea) on Win32
+====================================================
+Note that on Windows, if one is running Nahimic 3 on a system with
+nVidia graphics, one needs to stop the "Nahimic service" or insert
+the GTK application into the Nahimic blacklist, as noted in
+https://www.nvidia.com/en-us/geforce/forums/game-ready-drivers/13/297952/nahimic-and-nvidia-drivers-conflict/2334568/
+if using programs that utilise GtkGLArea and/or GdkGLArea, or use
+GDK_GL=gles if you know that GLES support is enabled for the build.
+
+This is a known issue, as the above link indicates, and affects quite
+a number of applications--sadly, since this issue lies within the
+nVidia graphics driver and/or the Nahimic 3 code, we are not able
+to rememdy this on the GTK side; the best bet before trying the above
+workarounds is to try to update your graphics drivers and Nahimic
+installation.
+
Building GTK+ on Win32
======================