From 42d1d1a03da4527e7262eadbffeac8a3c1f4e0c0 Mon Sep 17 00:00:00 2001 From: alemuntoni Date: Tue, 7 Apr 2020 14:49:01 +0200 Subject: [PATCH] use_cpu_opengl docs --- src/use_cpu_opengl/CMakeLists.txt | 8 ++++++++ src/use_cpu_opengl/README.md | 4 ++-- src/use_cpu_opengl/use_cpu_opengl.pro | 2 +- 3 files changed, 11 insertions(+), 3 deletions(-) diff --git a/src/use_cpu_opengl/CMakeLists.txt b/src/use_cpu_opengl/CMakeLists.txt index bd1f58d13..780684b38 100644 --- a/src/use_cpu_opengl/CMakeLists.txt +++ b/src/use_cpu_opengl/CMakeLists.txt @@ -1,3 +1,11 @@ +# This project is supposed to be compiled only with windows. +# It creates a binary file inside the MESHLAB_DISTRIB folder that is called +# UseCPUOpenGL. This binary file is automatically run by meshlab +# only if glewInit() fails (therefore, drivers do not support newer OpenGL +# versions). When UseCPUOpenGL is run, a file called "opengl32.dll" will be +# renamed/placed in the meshlab folder, overriding the system one and making meshlab +# able to start using a CPU implementation of OpenGL. + if(WIN32) set(SOURCES diff --git a/src/use_cpu_opengl/README.md b/src/use_cpu_opengl/README.md index 1f4fed48f..14dbf7c0b 100644 --- a/src/use_cpu_opengl/README.md +++ b/src/use_cpu_opengl/README.md @@ -1,6 +1,6 @@ #Use CPU OpenGL -This is a little qmake project **for windows** (it won't be compiled in other platforms) that generates a binary `UseCPUOpenGL.exe` file with admin privileges. +This is a little qmake/cmake project **for windows** (it won't be compiled in other platforms) that generates a binary `UseCPUOpenGL.exe` file with admin privileges. This binary is useful when MeshLab cannot start due to some graphic drivers that do not implement recent versions of OpenGL. In these cases, a (slow) CPU implementation of newer OpenGL leds MeshLab at least to start. @@ -8,4 +8,4 @@ This binary must be run inside the MeshLab folder, and: - it renames the file `opengl32sw.dll` if present inside the MeshLab folder, or - it generates a `opengl32.dll` file that will be used by MeshLab instead of the system one. -Running meshlab, if `glewInit()` fails, `UseCPUOpenGL.exe` will be executed and the new `opengl32.dll` file will be placed in the MeshLab folder, overriding the system one just for MeshLab. \ No newline at end of file +Running meshlab, if `glewInit()` fails, `UseCPUOpenGL.exe` will be executed and the new `opengl32.dll` file will be renamed/placed in the MeshLab folder, overriding the system one just for MeshLab. \ No newline at end of file diff --git a/src/use_cpu_opengl/use_cpu_opengl.pro b/src/use_cpu_opengl/use_cpu_opengl.pro index 53f2fa706..6be7379fc 100644 --- a/src/use_cpu_opengl/use_cpu_opengl.pro +++ b/src/use_cpu_opengl/use_cpu_opengl.pro @@ -3,7 +3,7 @@ # UseCPUOpenGL. This binary file is automatically run by meshlab # only if glewInit() fails (therefore, drivers do not support newer OpenGL # versions). When UseCPUOpenGL is run, a file called "opengl32.dll" will be -# placed in the meshlab folder, overriding the system one and making meshlab +# renamed/placed in the meshlab folder, overriding the system one and making meshlab # able to start using a CPU implementation of OpenGL. win32 {