Package com.jogamp.nativewindow
Interface ToolkitLock
public interface ToolkitLock
Marker for a singleton global recursive blocking lock implementation,
optionally locking a native windowing toolkit as well.
Toolkit locks are created solely via NativeWindowFactory
.
One use case is the AWT locking on X11, see NativeWindowFactory.getDefaultToolkitLock(String, long)
.
-
Field Details
-
DEBUG
static final boolean DEBUG -
TRACE_LOCK
static final boolean TRACE_LOCK
-
-
Method Details
-
lock
void lock()Blocking until the lock is acquired by this Thread or a timeout is reached.Timeout is implementation specific, if used at all.
- Throws:
RuntimeException
- in case of a timeout
-
unlock
void unlock()Release the lock.- Throws:
RuntimeException
- in case the lock is not acquired by this thread.
-
validateLocked
- Throws:
RuntimeException
- if current thread does not hold the lock
-
dispose
void dispose()Dispose this instance.Shall be called when instance is no more required.
This allows implementations sharing a lock via resources to decrease the reference counter.
-