Changed NEWT NativeWindow creation contract - AWT/NEWT Parenting - Misc Fixes

+++++

Changed NEWT NativeWindow creation contract

Original contract:

(1) A native window was created as soon as possible,
    ie when NEWTFactory.createWindow(..) was called - if possible.

(2) A valid native window has to be created at least after setVisible(true)
    has been called.

Problems:
    Not all implementation are able to create the native window that early,
    but at setVisible(true) only (e.g: KD and EGL).

    Due to window parenting especially the new AWT/NEWT parenting,
    the native window can only be created in case the parent native window is valid.

New contract:

(1) A native window is created at setVisible(true),
    if it's a top level window or the native parent window is valid.

(2) A valid native window may not be created after setVisible(true)
    has been called.
    Subsequent setVisible(true) calls shall be made in case
    the creation has not been done yet.
    This is demonstrated in GLWindow.display() for example.

The new contract implements a lazy native window creation.

+++++

AWT/NEWT Parenting

- HierarchyListener and ComponentListener ensure that the NEWT child window
  will be setVisible according to the AWT parent window.

- Lazy native window creation relaxes requirements to the parent window's state.

- Attachment of the child window and setVisible() may be called
  after NEWT child window creation.

- GLWindow supports NEWT child window creation directly

The test case TestParenting01AWT.java reflect this new contract
and demonstrates more simplified and more flexible use cases.

+++++

NEWT Fixes:

- All NEWT implementation's native code method names end with 0.

- GLWindow: don't issue the actual 'init'/'display' call to GLEventListeners
  in case the window is not visible.

- NEWT setSize/setPosition:
    if native-window
        call native-window action and let the attributes being set by
        the feedback call, which issues more action, ie RESIZE.
    else
        set the attributes directly, no feedback call/action is necessary.

+++++

X11 Fixes:

- X11GLContext MakeContextCurrent:
  Use MakeCurrent in case write and read drawable are equal,
  otherwise SEGV happens on ATI with heavy multithreading involved!
  Even XLockDisplay and XSync didn't help here ..

- X11GLXDrawableFactory shared resource:
  Removed the resource holder thread to simplify code,
  hence proper release is no more desired and it could become a cause for deadlock.

- Moved XInitThreads() from NEWT X11Window -> NativeWindow X11Util,
  since NativeWindow is loaded first (essential for XInitThreads())
  and it is the more basic lib.

- Made call to XInitThreads() conditional, ie it's spared if
  AWT could be used - which causes SEGV .. (AWT bug). See X11Util.java

+++++

JOGL Fixes:

- GLProfile.isAWTAvailable() -> NativeWindowFactory.isAWTAvailable()
- GLProfile.isAWTJOGLAvailable() -> GLProfile.isAWTAvailable()

3 files changed, 103 insertions, 4 deletions

diff --git a/src/nativewindow/classes/com/jogamp/nativewindow/impl/jawt/JAWTUtil.java b/src/nativewindow/classes/com/jogamp/nativewindow/impl/jawt/JAWTUtil.java
index b3c706ed8..527d7750d 100644
--- a/src/nativewindow/classes/com/jogamp/nativewindow/impl/jawt/JAWTUtil.java
+++ b/src/nativewindow/classes/com/jogamp/nativewindow/impl/jawt/JAWTUtil.java
@@ -42,6 +42,7 @@ import javax.media.nativewindow.*;
 
 import java.awt.GraphicsEnvironment;
 import java.lang.reflect.*;
+import java.security.*;
 
 public class JAWTUtil {
 
@@ -53,6 +54,12 @@ public class JAWTUtil {
   private static final Method isQueueFlusherThread;
   private static final boolean j2dExist;
 
+  private static Class   sunToolkitClass;
+  private static Method  sunToolkitAWTLockMethod;
+  private static Method  sunToolkitAWTUnlockMethod;
+  private static final boolean hasSunToolkitAWTLock;
+  private static final boolean useSunToolkitAWTLock;
+
   static {
     JAWTJNILibLoader.loadAWTImpl();
     JAWTJNILibLoader.loadNativeWindow("awt");
@@ -73,6 +80,32 @@ public class JAWTUtil {
     j2dClazz = jC;
     isQueueFlusherThread = m;
     j2dExist = ok;
+
+    AccessController.doPrivileged(new PrivilegedAction() {
+        public Object run() {
+          try {
+            sunToolkitClass = Class.forName("sun.awt.SunToolkit");
+            sunToolkitAWTLockMethod = sunToolkitClass.getDeclaredMethod("awtLock", new Class[] {});
+            sunToolkitAWTLockMethod.setAccessible(true);
+            sunToolkitAWTUnlockMethod = sunToolkitClass.getDeclaredMethod("awtUnlock", new Class[] {});
+            sunToolkitAWTUnlockMethod.setAccessible(true);
+          } catch (Exception e) {
+            // Either not a Sun JDK or the interfaces have changed since 1.4.2 / 1.5
+          }
+          return null;
+        }
+      });
+      boolean _hasSunToolkitAWTLock = false;
+      if ( null!=sunToolkitAWTLockMethod && null!=sunToolkitAWTUnlockMethod ) {
+          try {
+                sunToolkitAWTLockMethod.invoke(null, null);
+                sunToolkitAWTUnlockMethod.invoke(null, null);
+                _hasSunToolkitAWTLock = true;
+          } catch (Exception e) {}
+      }
+      hasSunToolkitAWTLock = _hasSunToolkitAWTLock;
+      // useSunToolkitAWTLock = hasSunToolkitAWTLock;
+      useSunToolkitAWTLock = false;
   }
 
   private static Exception lockedStack;
@@ -99,6 +132,30 @@ public class JAWTUtil {
     return headlessMode;
   }
 
+  private static void awtLock() {
+    if(useSunToolkitAWTLock) {
+        try {
+            sunToolkitAWTLockMethod.invoke(null, null);
+        } catch (Exception e) {
+          throw new NativeWindowException("SunToolkit.awtLock failed", e);
+        }
+    } else {
+        JAWT.getJAWT().Lock();
+    }
+  }
+
+  private static void awtUnlock() {
+    if(useSunToolkitAWTLock) {
+        try {
+            sunToolkitAWTUnlockMethod.invoke(null, null);
+        } catch (Exception e) {
+          throw new NativeWindowException("SunToolkit.awtUnlock failed", e);
+        }
+    } else {
+        JAWT.getJAWT().Unlock();
+    }
+  }
+
   public static synchronized void lockToolkit() throws NativeWindowException {
     if (isJava2DQueueFlusherThread()) return;
 
@@ -115,7 +172,7 @@ public class JAWTUtil {
       return;
     }
 
-    JAWT.getJAWT().Lock();
+    awtLock();
   }
 
   public static synchronized void unlockToolkit() {
@@ -130,7 +187,7 @@ public class JAWTUtil {
           return;
         }
 
-        JAWT.getJAWT().Unlock();
+        awtUnlock();
     }
   }
 
diff --git a/src/nativewindow/classes/com/jogamp/nativewindow/impl/jawt/x11/X11JAWTWindow.java b/src/nativewindow/classes/com/jogamp/nativewindow/impl/jawt/x11/X11JAWTWindow.java
index f2977e8f0..77bf93204 100644
--- a/src/nativewindow/classes/com/jogamp/nativewindow/impl/jawt/x11/X11JAWTWindow.java
+++ b/src/nativewindow/classes/com/jogamp/nativewindow/impl/jawt/x11/X11JAWTWindow.java
@@ -37,6 +37,7 @@
 package com.jogamp.nativewindow.impl.jawt.x11;
 
 import javax.media.nativewindow.*;
+import javax.media.nativewindow.awt.*;
 import javax.media.nativewindow.x11.*;
 
 import com.jogamp.nativewindow.impl.x11.*;
@@ -53,6 +54,19 @@ public class X11JAWTWindow extends JAWTWindow {
   }
 
   protected void initNative() throws NativeWindowException {
+    if(0==config.getScreen().getDevice().getHandle()) {
+        AWTGraphicsDevice awtDevice = (AWTGraphicsDevice) config.getScreen().getDevice();
+        NativeWindowFactory.getDefaultFactory().getToolkitLock().lock();
+        try {
+          long displayHandle = X11SunJDKReflection.graphicsDeviceGetDisplay(awtDevice.getGraphicsDevice());
+          if(0==displayHandle) {
+                displayHandle = X11Util.createThreadLocalDefaultDisplay();
+          }
+          awtDevice.setHandle(displayHandle);
+        } finally {
+          NativeWindowFactory.getDefaultFactory().getToolkitLock().unlock();
+        }
+    }
   }
 
   public synchronized int lockSurface() throws NativeWindowException {
diff --git a/src/nativewindow/classes/com/jogamp/nativewindow/impl/x11/X11Util.java b/src/nativewindow/classes/com/jogamp/nativewindow/impl/x11/X11Util.java
index d93302e57..196e8f4e2 100644
--- a/src/nativewindow/classes/com/jogamp/nativewindow/impl/x11/X11Util.java
+++ b/src/nativewindow/classes/com/jogamp/nativewindow/impl/x11/X11Util.java
@@ -56,7 +56,17 @@ public class X11Util {
 
     static {
         NWJNILibLoader.loadNativeWindow("x11");
-        initialize();
+
+        // No concurrent threading support in case AWT could be used,
+        // Mixing AWT and X11/NEWT results in a segmentation fault:
+        //      C pthread_mutex_lock+0x4
+        //      J sun.awt.X11.XlibWrapper.XGetDefault
+        //      J sun.awt.X11.XToolkit.initializeMultiClickTime
+        //      J sun.awt.X11.XToolkit.getMultiClickTime
+        //
+        // It seems like (Oracle's) AWT's Display locking is buggy.
+        //
+        initialize( ! NativeWindowFactory.isAWTAvailable() ) ;
     }
 
     public static void initSingleton() {
@@ -142,6 +152,8 @@ public class X11Util {
             if(0==dpy) {
                 throw new NativeWindowException("X11Util.Display: Unable to create a display("+name+") connection in Thread "+Thread.currentThread().getName());
             }
+            // if you like to debug and synchronize X11 commands ..
+            // setSynchronizeDisplay(dpy, true);
             namedDpy = new NamedDisplay(name, dpy);
             addCurrentDisplay( namedDpy );
             synchronized(globalLock) {
@@ -207,6 +219,22 @@ public class X11Util {
         return closeThreadLocalDisplay(ndpy.getName());
     }
 
+    public static boolean setSynchronizeDisplay(long handle, boolean onoff) {
+        String name;
+        XLockDisplay(handle);
+        boolean res = X11Lib.XSynchronize(handle, onoff);
+        XUnlockDisplay(handle);
+        return res;
+    }
+
+    public static String getNameOfDisplay(long handle) {
+        String name;
+        XLockDisplay(handle);
+        name = X11Lib.XDisplayString(handle);
+        XUnlockDisplay(handle);
+        return name;
+    }
+
     public static void XLockDisplay(long handle) {
         if(DEBUG_XDISPLAY_LOCK) {
             NamedDisplay ndpy;
@@ -298,5 +326,5 @@ public class X11Util {
         return (NamedDisplay) displayMap.get(name);
     }
 
-    private static native void initialize();
+    private static native void initialize(boolean initConcurrentThreadSupport);
 }