Package javax.media.nativewindow

NativeWindow Protocol Specification Overview

See:
          Description

Interface Summary
AbstractGraphicsConfiguration A marker interface describing a graphics configuration, visual, or pixel format in a toolkit-independent manner.
AbstractGraphicsDevice A interface describing a graphics device in a toolkit-independent manner.
AbstractGraphicsScreen A interface describing a graphics screen in a toolkit-independent manner.
CapabilitiesChooser Provides a mechanism by which applications can customize the window type selection for a given Capabilities.
CapabilitiesImmutable Specifies an immutable set of capabilities that a window's rendering context must support, such as color depth per channel.
MutableSurface Provides a NativeSurface with a mutable surfaceHandle via MutableSurface.setSurfaceHandle(long).
NativeSurface Provides low-level information required for hardware-accelerated rendering using a surface in a platform-independent manner.
NativeWindow Extend the NativeSurface interface with windowing information such as window handle and position.
OffscreenLayerOption Handling requests for using an OffscreenLayerSurface within the implementation.
OffscreenLayerSurface Interface specifying the offscreen layer surface protocol.
ProxySurface Provides a mutable NativeSurface, i.e.
SurfaceUpdatedListener Clients may add their SurfaceUpdateListener implementation to a NativeSurface allowing to get notified after the surface has been updated, eg.
ToolkitLock Marker for a singleton global recursive blocking lock implementation, optionally locking a native windowing toolkit as well.
UpstreamSurfaceHook Interface allowing upstream caller to pass lifecycle actions and size info to a ProxySurface instance.
UpstreamSurfaceHook.MutableSize UpstreamSurfaceHook w/ mutable size, allowing it's ProxySurface user to resize.
VisualIDHolder Visual ID holder interface.
WindowClosingProtocol Protocol for handling window closing events.
 

Class Summary
Capabilities Specifies a set of capabilities that a window's rendering context must support, such as color depth per channel.
DefaultCapabilitiesChooser The default implementation of the CapabilitiesChooser interface, which provides consistent visual selection behavior across platforms.
DefaultGraphicsConfiguration  
DefaultGraphicsDevice  
DefaultGraphicsScreen  
GraphicsConfigurationFactory Provides the mechanism by which the graphics configuration for a window can be chosen before the window is created.
NativeWindowFactory Provides a pluggable mechanism for arbitrary window toolkits to adapt their components to the NativeWindow interface, which provides a platform-independent mechanism of accessing the information required to perform operations like hardware-accelerated rendering using the OpenGL API.
VisualIDHolder.VIDComparator Comparing VisualIDHolder.VIDType.NATIVE
 

Enum Summary
VisualIDHolder.VIDType  
WindowClosingProtocol.WindowClosingMode Window closing mode if triggered by toolkit close operation.
 

Exception Summary
NativeWindowException A generic exception for OpenGL errors used throughout the binding as a substitute for RuntimeException.
 

Package javax.media.nativewindow Description

NativeWindow Protocol Specification Overview

Preface

This specification, an optional set of packages, describing a protocol for a native windowing interface binding to Java(TM).
Currently specified native windowing systems are:


However, any other native windowing system may be added to the implementation, using a generic string identifier and an optional specialisation of:


The implementor has to provide the following:


This protocol does not describe how to create native windows, but how to bind a native surface to an implementation of and window to an implementation of NativeSurface.
NativeWindow specializes the NativeSurface.
However, an implementation of this protocol (e.g. com.jogamp.newt) may support the creation.

Dependencies

This binding has dependencies to the following:

Package Structure

The packages defined by this specification include:

Factory Model

Running on a platform with a supported windowing system, the factory model shall be used to instantiate a native window, see NativeWindowFactory.
The implementor has to specialize All supported Regardless of the knowledge of the underly

Revision History






Copyright 2010 JogAmp Community.