/** * Copyright 2010 JogAmp Community. All rights reserved. * * Redistribution and use in source and binary forms, with or without modification, are * permitted provided that the following conditions are met: * * 1. Redistributions of source code must retain the above copyright notice, this list of * conditions and the following disclaimer. * * 2. Redistributions in binary form must reproduce the above copyright notice, this list * of conditions and the following disclaimer in the documentation and/or other materials * provided with the distribution. * * THIS SOFTWARE IS PROVIDED BY JogAmp Community ``AS IS'' AND ANY EXPRESS OR IMPLIED * WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND * FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL JogAmp Community OR * CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR * CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR * SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON * ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING * NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF * ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. * * The views and conclusions contained in the software and documentation are those of the * authors and should not be interpreted as representing official policies, either expressed * or implied, of JogAmp Community. */ package jogamp.opengl; import java.util.Collection; import java.util.HashSet; import java.util.Iterator; import javax.media.nativewindow.AbstractGraphicsDevice; import javax.media.nativewindow.AbstractGraphicsScreen; import com.jogamp.opengl.GLRendererQuirks; public class SharedResourceRunner implements Runnable { protected static final boolean DEBUG = GLDrawableImpl.DEBUG; public static interface Resource { boolean isValid(); AbstractGraphicsDevice getDevice(); AbstractGraphicsScreen getScreen(); GLDrawableImpl getDrawable(); GLContextImpl getContext(); GLRendererQuirks getRendererQuirks(); } public static interface Implementation { /** *

* Called within synchronized block. *

* @param connection for creation a {@link AbstractGraphicsDevice} instance. * @return true if the device supports all protocols required for the implementation, otherwise false. */ boolean isDeviceSupported(String connection); /** *

* Called within synchronized block. *

* @param connection for creation a {@link AbstractGraphicsDevice} instance. * @return A new shared resource instance */ Resource createSharedResource(String connection); /** Called within synchronized block. */ void releaseSharedResource(Resource shared); /** Called within synchronized block. */ void clear(); /** Called within synchronized block. */ Resource mapPut(String connection, Resource resource); /** Called within synchronized block. */ Resource mapGet(String connection); /** Called within synchronized block. */ Collection mapValues(); } final HashSet devicesTried = new HashSet(); final Implementation impl; Thread thread; boolean running; boolean ready; boolean shouldRelease; String initConnection; String releaseConnection; private boolean getDeviceTried(final String connection) { // synchronized call return devicesTried.contains(connection); } private void addDeviceTried(final String connection) { // synchronized call devicesTried.add(connection); } private void removeDeviceTried(final String connection) { // synchronized call devicesTried.remove(connection); } public SharedResourceRunner(final Implementation impl) { this.impl = impl; resetState(); } private void resetState() { // synchronized call devicesTried.clear(); thread = null; ready = false; running = false; shouldRelease = false; initConnection = null; releaseConnection = null; } /** * Start the shared resource runner thread, if not running. *

* Validate the thread upfront and release all related resource if it was killed. *

* * @return the shared resource runner thread. */ public Thread start() { synchronized (this) { if(null != thread && !thread.isAlive()) { // thread was killed unrecognized .. if (DEBUG) { System.err.println("SharedResourceRunner.start() - dead-old-thread cleanup - "+getThreadName()); } releaseSharedResources(); thread = null; running = false; } if( null == thread ) { if (DEBUG) { System.err.println("SharedResourceRunner.start() - start new Thread - "+getThreadName()); } resetState(); thread = new Thread(this, getThreadName()+"-SharedResourceRunner"); thread.setDaemon(true); // Allow JVM to exit, even if this one is running thread.start(); while (!running) { try { this.wait(); } catch (final InterruptedException ex) { } } } } return thread; } public void stop() { synchronized (this) { if(null != thread) { if (DEBUG) { System.err.println("SharedResourceRunner.stop() - "+getThreadName()); } synchronized (this) { shouldRelease = true; this.notifyAll(); while (running) { try { this.wait(); } catch (final InterruptedException ex) { } } } } } } public SharedResourceRunner.Resource getOrCreateShared(final AbstractGraphicsDevice device) { SharedResourceRunner.Resource sr = null; if(null != device) { synchronized (this) { start(); final String connection = device.getConnection(); sr = impl.mapGet(connection); if (null == sr) { if ( !getDeviceTried(connection) ) { addDeviceTried(connection); if (DEBUG) { System.err.println("SharedResourceRunner.getOrCreateShared() " + connection + ": trying - "+getThreadName()); } if ( impl.isDeviceSupported(connection) ) { doAndWait(connection, null); sr = impl.mapGet(connection); } if (DEBUG) { System.err.println("SharedResourceRunner.getOrCreateShared() " + connection + ": "+ ( ( null != sr ) ? "success" : "failed" ) +" - "+getThreadName()); } } } } } return sr; } public SharedResourceRunner.Resource releaseShared(final AbstractGraphicsDevice device) { SharedResourceRunner.Resource sr = null; if(null != device) { synchronized (this) { final String connection = device.getConnection(); sr = impl.mapGet(connection); if (null != sr) { removeDeviceTried(connection); if (DEBUG) { System.err.println("SharedResourceRunner.releaseShared() " + connection + ": trying - "+getThreadName()); } doAndWait(null, connection); if (DEBUG) { System.err.println("SharedResourceRunner.releaseShared() " + connection + ": done - "+getThreadName()); } } } } return sr; } private final void doAndWait(final String initConnection, final String releaseConnection) { synchronized (this) { // wait until thread becomes ready to init new device, // pass the device and release the sync final String threadName = getThreadName(); if (DEBUG) { System.err.println("SharedResourceRunner.doAndWait() START init: " + initConnection + ", release: "+releaseConnection+" - "+threadName); } while (!ready && running) { try { this.wait(); } catch (final InterruptedException ex) { } } if (DEBUG) { System.err.println("SharedResourceRunner.doAndWait() set command: " + initConnection + ", release: "+releaseConnection+" - "+threadName); } this.initConnection = initConnection; this.releaseConnection = releaseConnection; this.notifyAll(); // wait until thread has init/released the device while ( running && ( !ready || null != this.initConnection || null != this.releaseConnection ) ) { try { this.wait(); } catch (final InterruptedException ex) { } } if (DEBUG) { System.err.println("SharedResourceRunner.initializeAndWait END init: " + initConnection + ", release: "+releaseConnection+" - "+threadName); } } // done } @Override public final void run() { final String threadName = getThreadName(); if (DEBUG) { System.err.println("SharedResourceRunner.run(): STARTED - " + threadName); } synchronized (this) { running = true; while (!shouldRelease) { try { // wait for stop or init ready = true; if (DEBUG) { System.err.println("SharedResourceRunner.run(): READY - " + threadName); } notifyAll(); this.wait(); } catch (final InterruptedException ex) { shouldRelease = true; if(DEBUG) { System.err.println("SharedResourceRunner.run(): INTERRUPTED - "+threadName); ex.printStackTrace(); } } ready = false; if (!shouldRelease) { if (DEBUG) { System.err.println("SharedResourceRunner.run(): WOKE UP for device connection init: " + initConnection + ", release: " + releaseConnection + " - " + threadName); } if(null != initConnection) { if (DEBUG) { System.err.println("SharedResourceRunner.run(): create Shared for: " + initConnection + " - " + threadName); } Resource sr = null; try { sr = impl.createSharedResource(initConnection); } catch (final Exception e) { e.printStackTrace(); } if (null != sr) { impl.mapPut(initConnection, sr); } } if(null != releaseConnection) { if (DEBUG) { System.err.println("SharedResourceRunner.run(): release Shared for: " + releaseConnection + " - " + threadName); } final Resource sr = impl.mapGet(releaseConnection); if (null != sr) { try { impl.releaseSharedResource(sr); impl.mapPut(releaseConnection, null); } catch (final Exception e) { e.printStackTrace(); } } } } initConnection = null; releaseConnection = null; } if (DEBUG) { System.err.println("SharedResourceRunner.run(): RELEASE START - " + threadName); } releaseSharedResources(); if (DEBUG) { System.err.println("SharedResourceRunner.run(): RELEASE END - " + threadName); } shouldRelease = false; running = false; thread = null; notifyAll(); } } private void releaseSharedResources() { // synchronized call devicesTried.clear(); final Collection sharedResources = impl.mapValues(); for (final Iterator iter = sharedResources.iterator(); iter.hasNext();) { try { impl.releaseSharedResource(iter.next()); } catch (final Throwable t) { System.err.println("Caught exception on thread "+getThreadName()); t.printStackTrace(); } } impl.clear(); } protected static String getThreadName() { return Thread.currentThread().getName(); } }