Molekel versions 5.3 or above use some advanced multi-pass rendering techniques to enhance visual quality; these techniques may generate visual artifacts on transparent surfaces on some specific graphic cards. We have experienced problems on SuSE 10.3 x86-32/NVIDIA 8800 Ultra and Windows XP 32bit/NVIDIA 8800 Ultra systems; on Windows problems can be fixed by selecting Let the 3D application decide (which should be the default) in the Image Settings page of the NVIDIA Control Panel.

Simply open the dmg disk image and copy the folders to any location; you may want to create a Molekel folder inside Applications and put everything there.

Molekel versions 5.3 or above use some advanced multi-pass rendering techniques to enhance visual quality; these techniques may generate visual artifacts on transparent surfaces on some specific graphic cards. We have experienced problems on SuSE 10.3 x86-32/NVIDIA 8800 Ultra and Windows XP 32bit/NVIDIA 8800 Ultra system; on Windows problems can be fixed by selecting Let the 3D application decide (which should be the default) in the Image Settings page of the NVIDIA Control Panel.

In general, in case you have rendering problems, get messages about errors in Coin or the program crashes when loading files without reporting any error, you can set the value of two environment variables as follows:

To set the environment variables permanently on Windows XP right-click on My Computer then select the Advanced tab and click on the Environment Variables button.

Rendering issues

In case you have rendering problems, get messages about errors in Coin or the program crashes when loading files without reporting any error, you can set the value of two environment variables as follows:

• COIN_FULL_INDIRECT_RENDERING=0
• COIN_FORCE_GL1_0_ONLY=1

before launching Molekel to disable the use of advanced OpenGL features.

You can also set the COIN_DEBUG_GLGLUE environment variable to 1 before starting Molekel in a console window to print OpenGL debug information. To enable printing on standard output on Mac you'll have to invoke the actual executable in the Molekel.app folder i.e. Molekel.app/Contents/MacOS/Molekel.

Warning: it seems that due to an issue with Qt's QDesktopServices Molekel is unable to open the main page of the local documentation if the installation path contains spaces. You can manually open the html documentation which resides in the Molekel/doc folder.

Warning: it seems that due to an issue with Qt's QDesktopServices Molekel is unable to open the main page of the local documentation if the installation path contains spaces. You can manually open the html documentation which resides in the Molekel/doc folder.

sh:

csh:

it means you do not have glibc 2.4 installed, you can either install glibc 2.4 o simply download this patch and replace <molekel root>/lib/libQtCore.so.4 with the version found in the archive which works with glibc 2.3.

If you get an error similar to the following:

.../lib/tls/libc.so.6: version 'GLIBC_2.4' not found (required by ./lib/libQtCore.so.4)

it means you do not have glibc 2.4 installed, you can either install glibc 2.4 o simply download this patch and replace <molekel root>/lib/libQtCore.so.4 with the version found in the archive.

Launch from desktop

To be able to launch Molekel from KDE and Gnome you can create a script like:

#!/bin/sh
#if you have not added the command to add Molekel's dynamic libs dir to LD_LIBRARY_PATH
#to your .profile or .tcshrc file you need to do it here:
export LD_LIBRARY_PATH=<molekel installation dir>/lib:$LD_LIBRARY_PATH
#launch molekel
<molekel installation dir>/bin/Molekel

Uncompress the archive and add the molekel/lib directory to LD_LIBRARY_PATH then run <molekel root>/bin/Molekel:

1. to your .profile or .tcshrc file you need to do it here:

Uncompress the archive and add the @molekel/lib@ directory to LD_LIBRARY_PATH then run <molekel root>/bin/Molekel:

sh: export LD_LIBRARY_PATH=<molekel installation dir>/lib:$LD_LIBRARY_PATH

csh: setenv LD_LIBRARY_PATH <molekel installation dir>/lib:${LD_LIBRARY_PATH}

To be able to launch Molekel from KDE and Gnome you can create a script like:

#!/bin/sh
#if you have not added the command to add Molekel's dynamic libs dir to LD_LIBRARY_PATH
#to your .profile or .tcshrc you need to do it here:
export LD_LIBRARY_PATH=<molekel installation dir>/lib:$LD_LIBRARY_PATH
#launch molekel
<molekel installation dir>/bin/Molekel

Warning: it seems that due to an issue with Qt's QDesktopServices Molekel is unable to open the main page of the local documentation if the installation path contains spaces. You can manually open the html documentation which resides in the Molekel/doc folder.

Uncompress the archive and add the @molekel/lib@ directory to LD_LIBRARY_PATH then run <molekel root>/bin/Molekel.

To be able to launch Molekel from KDE and Gnome you first need to modify the script as described in the previous paragraph.

In this case the launch script will have to explicitly cd to Molekel's root dir.

Simply open the dmg disk image and copy the folders to any location.

Windows

Linux

Mac OS

Installation

Windows

Install

Windows

• installer: install the program with administrator privileges.
• zip: simply uncompress the archive; Molekel.exe is in molekel/bin.

Linux

Uncompress the archive and add the molekel/lib directory to LD_LIBRARY_PATH then run molekel/bin/Molekel.

A sample startup script start_molekel.sh is provided.

Launch from command line

Modify start_molekel.sh.sample to add <molekel home directory>/lib to LD_LIBRARY_PATH and enter the full path of Molekel's executable: <molekel home directory>/bin/Molekel.

No need to cd to Molekel's home dir, the cd ... line can be commented.

Launch from desktop

To be able to launch Molekel from KDE and Gnome you need to modify the script start_molekel.sh.sample specifying Molekel's home directory. You can then create a launcher/application icon on the Gnome and KDE desktop and point it to the sh file. In this case the launch script will have to explicitly cd to Molekel's home dir. You can change the icon of the desktop shortcut by selecting the Molekel.png icon in the <molekel root>/resources directory.

Mac OS

Simply open the dmg disk image and drag and drop the folders in any location.