1.7 Charts and OpenGL or JOGL Configuration (Revision #1)

Aqua Data Studio has charting functionality which uses the Java bindings for OpenGL (JOGL : https://jogl.dev.java.net/). The JOGL libraries include native libraries for each Operating System and platform. If you download an Aqua Data Studio installer for a specific platform, the appropriate libraries will included in the root folder of the Aqua Data Studio installation.

On the Windows platform the files consist of :

gluegen-rt.dll
jogl.dll
jogl_awt.dll
jogl_cg.dll

Many lower end PCs have video cards which are not capable of supporting OpenGL.

If you download a non specific OS installer such as the Java installer packages, then all of the platform libraries will be included in the appropriate subfolders in the platform folder under the ADS root installation folder. You would need to copy the appropriate libraries for your platform into the root ADS folder.

OS X and JOGL

Under the OS X platform the JOGL libraries need to be located in:

/Aqua Data Studio.app/Contents/Resources/Java/libgluegen-rt.jnilib
/Aqua Data Studio.app/Contents/Resources/Java/libjogl_awt.jnilib
/Aqua Data Studio.app/Contents/Resources/Java/libjogl_cg.jnilib
/Aqua Data Studio.app/Contents/Resources/Java/libjogl.jnilib

The JOGL libraries require video cards which have support for OpenGL. All Macs have full support for OpenGL.

Linux\Unix XDisplay and Headless Servers

Some servers running Unix are usually purchased with low end video cards. Running ADS on a headless Unix machine with a remote XDisplay would still have the charting functionality limited to the OpenGL of the server.

Troubleshooting Chart Display Issues

If your video card or video drivers are having problems with charting, you may do some of the following to diagnose or get around the problem :

1. On Windows, make sure you have the latest version of your video driver from your video card vendor.

2. On Windows, you may lower your hardware acceleration with Start->Settings->Control Panel->Display Properties->Advanced->Troubleshoot->[Hardware acceleration]

3. You may disable charts with the option File->Options->General->Chart->[Support Charts]

4. Remove (completely remove, do NOT rename and leave them in the directory) the JOGL libraries and then start ADS. ADS will not find the libraries and will disable the charts.

Additional Chart Options

To improve Chart performance and stability there are several Chart Options within File -> Options -> General [Chart] including: