Difference between revisions of "Known Issues"

Revision as of 18:03, 14 December 2020

This page provides answers to issues that users have encountered when installing PANGU.

QGtkStyle was unable to detect the current GTK+ theme [SPR00029]

This error might occur when running the PANGU Qt viewers under Linux when using XFCE, LXDE or KDE desktops with Ubuntu 18.04. This affects any Qt application, not just PANGU.

The simplest solution is to define the following environment variable:

GTK2_RC_FILES="$HOME/.gtkrc-2.0:/etc/gtk-2.0/gtkrc"

If neither of those configuration files exists then create a text file called .gtkrc-2.0 in your home directory and add the following line of text to it:

 gtk-theme-name="GTK+"

Save the file and the issue ought to be resolved.

For more details see http://alien.slackbook.org/blog/running-vlc-in-xfce/

Failed to load module "canberra-gtk-module" [SPR00030]

This error might occur when running the PANGU Qt viewers under Linux when using XFCE, LXDE or KDE desktops with Ubuntu 18.04. This affects any Qt application, not just PANGU.

The problem is due to the specified module not being installed on your system.

Ubuntu users might be able to resolve this issue by using this command:

sudo apt install libcanberra-gtk-module

CentOS users might need to use one of these commands instead:

sudo yum install libcanberra-gtk2
sudo yum install libcanberra-gtk3

See https://askubuntu.com/questions/208431/failed-to-load-module-canberra-gtk-module or https://askubuntu.com/questions/971560/what-is-the-purpose-of-canberra-gtk-module for more details.

Save-as crash/freeze using Qt5 on Windows 7 on a Dell [SPR00042]

The Dell Backup and Recovery tool on Windows 7 causes Qt5 applications (such as the viewer) to crash when opening a file manager dialog e.g. using “Save Image As”. After the crash Windows 7 will adjust the way in which the viewer runs which will prevent a crash for the affected dialog window only. However, the dialog will be blank except “Save” and “Cancel” buttons. Pressing the “Cancel” button and then trying again will work around the issue for that dialog until the viewer quits. The process must be repeated for the other file dialogs.

For more details please refer to the following bug report from May 2015: https://www.dell.com/community/Productivity-Software/Backup-and-Recovery-causing-applications-using-Qt5-DLLs-to-crash/td-p/4590325

Uninstalling the Dell Backup and Recovery tool will resolve the issue.

Performance boost with __GL_DEBUGGER=1 when using NVIDIA drivers under Linux

Linux users may notice a substantial performance increase if the viewer is executed under a debugger, a system call profiler (e.g. strace) or if the __GL_DEBUGGER environment variable is set to 1.

It is believed that the NVIDIA drivers analyse the initial rendering calls issued by an application to detect the game or application that is being run. The result is used to select internal settings in the driver which negatively affect the performance of the PANGU viewer. When the application is operating in debugging mode the effects of the detection algorithm appear to be disabled.

Linux users with native NVIDIA drivers may wish to set __GL_DEBUGGER=1 before running the viewer. There do not appear to be any other side-effects to enabling this setting. Bash shell users can set the environment variable just for a specific viewer execution (e.g. for use in scripts) via the following shell syntax:

$ __GL_DEBUGGER=1 ./bin/viewer ...

Incorrect scaling in pan2cad COLLADA files

Prior to version 5.50(2), COLLADA (.dae) files generated by pan2cad had <scale> nodes in which the y/z elements were incorrectly swapped over.

The work-around for affected versions of pan2cad is to manually swap the y/z elements of every non-trivial <scale> node (or use a different CAD output format). Most <scale> nodes in a COLLADA file will be for unit scaling (1 1 1) and don't need swapping.