NativeWindow Protocol Specification Overview

See: Description

Packages 
Package Description
javax.media.nativewindow
NativeWindow Protocol Specification Overview
javax.media.nativewindow.util  

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:

  • EGL/OpenKODE Windowing System
  • X11 Windowing System
  • Microsoft Windows
  • Apple MacOSX
  • Java's AWT

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:

  • The javax.media.nativewindow package

    This package contains Java bindings for a native windowing system.
    Subsequent packages contain marker type classes, containing native characteristics of the windowing system.
    • The javax.media.nativewindow.awt package

      This sub package contains classes to cover the native characteristics of the AWT windowing system.
    • The javax.media.nativewindow.x11 package

      This sub package contains classes to cover the native characteristics of the X11 windowing system.
    • The javax.media.nativewindow.windows package

      This sub package contains classes to cover the native characteristics of the Windows windowing system.
    • The javax.media.nativewindow.macosx package

      This sub package contains classes to cover the native characteristics of the MacOSX windowing system.
    • The javax.media.nativewindow.egl package

      This sub package contains classes to cover the native characteristics of the EGL/OpenKODE windowing system.

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

  • Early Draft Review, June 2009
  • 2.0.0 Maintenance Release, February 2011



Copyright 2010 JogAmp Community.