Screen Mode manipulation API (with X11 impl) ; X11 Fullscreen impl

Added screen mode change capability with impl for X11 (using Xrandr)

com.jogamp.newt.Screen: added 4 methods which cover screen mode lifecycle

ScreenMode[] getScreenModes():  Get list of available screen modes
returns null if not natively implemented. On first call
will fetch the list thru a set of native calls and stores them
in the ScreenModeState. Consequent calls will retreive the data
from the ScreenModeStatus object. Native calls are done on creation stage,
so subsequent API calls will return cached data.

int getDesktopScreenModeIndex(): Get the Current Desktop Screen mode index
returns -1 if functionality not natively implemented. The index
returned refers to the screen mode location in the ScreenMode array.
Used to get initial mode for reverting back. Initial call will retreive the
mode thru a native call (done on initialization), subsequent API calls will retreive it
from the ScreenModeStatus object.

Note: If Window is closed without reverting back and screen is set to unreachable.
The api will revert the screen. A call to destoy(unreachable) is needed
for revert to take place on close

windowDestroyNotify(WindowEvent e) {
	...
	window.destroy(true);
}

short getCurrentScreenRate(): Get the current screen rate
returns -1 if not natively implemented. Used along with getDesktopScreenModeIndex
You can identify the current screen mode (w x h) and the rate. Initial call will retreive the
mode thru a native call (done on initialization), subsequent API calls will retreive it
from the ScreenModeStatus object.

void setScreenMode(int modeIndex, short rate): change the screen mode
to the mode index which refers to one of the screen modes retreived by getScreenModes()
and a rate which can be one of screenModes.getRates(). If the rate provided doesnt belong
to the list of available rates the first rate is chosen.

build-newt.xml: Added header files generation for Screen and Display
Added Xrandr syslink to x11 based builds.

+++++++++++++
Fullscreen for X11Window:

Added Fullscreen WM Hint for X11Window. Event of Fullscreen is
sent to the display root. When changing to fullscreen the request is send
after configuring the window otherwize before decoration.

Not Stable yet, needs tweeking on other Linux dist. Window looses focus
after switching to fullscreen mode.
+++++++++++++++
Added TestScreenMode01NEWT which includes 4 tests
1- Fullscreen change mode
2- Screen mode change
3- Screen change with fullscreen (revert screenmode then revert fullscreen)
4- Screen change with fullscreen (revert fullscreen then revert screenmode)

should fail if not screenmode not implemented on platform.
+++++++++++++++
Cleaned up some unused imports

1 files changed, 276 insertions, 0 deletions

diff --git a/src/junit/com/jogamp/test/junit/newt/TestScreenMode01NEWT.java b/src/junit/com/jogamp/test/junit/newt/TestScreenMode01NEWT.java
new file mode 100644
index 000000000..acbcc6e17
--- /dev/null
+++ b/src/junit/com/jogamp/test/junit/newt/TestScreenMode01NEWT.java
@@ -0,0 +1,276 @@
+/**
+ * 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 com.jogamp.test.junit.newt;
+
+import java.lang.reflect.*;
+import java.util.ArrayList;
+import java.util.Iterator;
+import java.util.List;
+
+import org.junit.Assert;
+import org.junit.Before;
+import org.junit.BeforeClass;
+import org.junit.After;
+import org.junit.AfterClass;
+import org.junit.Test;
+
+import javax.media.nativewindow.*;
+
+import com.jogamp.newt.*;
+import com.jogamp.newt.impl.ScreenMode;
+
+import java.io.IOException;
+
+import com.jogamp.test.junit.util.UITestCase;
+
+public class TestScreenMode01NEWT extends UITestCase {
+    static int width, height;
+
+    @BeforeClass
+    public static void initClass() {
+        NativeWindowFactory.initSingleton(true);
+        width  = 640;
+        height = 480;
+    }
+
+    static Window createWindow(Screen screen, Capabilities caps, int width, int height, boolean onscreen, boolean undecorated) {
+        Assert.assertNotNull(caps);
+        caps.setOnscreen(onscreen);
+        // Create native windowing resources .. X11/Win/OSX
+        // 
+        Window window = NewtFactory.createWindow(screen, caps);
+        Assert.assertNotNull(window);
+        window.setUndecorated(onscreen && undecorated);
+        window.setSize(width, height);
+        Assert.assertEquals(false,window.isNativeValid());
+        Assert.assertEquals(false,window.isVisible());
+        window.setVisible(true);
+        Assert.assertEquals(true,window.isVisible());
+        Assert.assertEquals(true,window.isNativeValid());
+        // Assert.assertEquals(width,window.getWidth());
+        // Assert.assertEquals(height,window.getHeight());
+        // System.out.println("Created: "+window);
+
+        //
+        // Create native OpenGL resources .. XGL/WGL/CGL .. 
+        // equivalent to GLAutoDrawable methods: setVisible(true)
+        // 
+        caps = window.getGraphicsConfiguration().getNativeGraphicsConfiguration().getChosenCapabilities();
+        Assert.assertNotNull(caps);
+        Assert.assertTrue(caps.getGreenBits()>5);
+        Assert.assertTrue(caps.getBlueBits()>5);
+        Assert.assertTrue(caps.getRedBits()>5);
+        Assert.assertEquals(caps.isOnscreen(),onscreen);
+
+        return window;
+    }
+
+    static void destroyWindow(Display display, Screen screen, Window window) {
+        if(null!=window) {
+            window.destroy();
+        }
+        if(null!=screen) {
+            screen.destroy();
+        }
+        if(null!=display) {
+            display.destroy();
+        }
+    }
+    
+    @Test
+    public void testFullscreenChange01() throws InterruptedException {
+    	Capabilities caps = new Capabilities();
+        Assert.assertNotNull(caps);
+        Display display = NewtFactory.createDisplay(null); // local display
+        Assert.assertNotNull(display);
+        Screen screen  = NewtFactory.createScreen(display, 0); // screen 0
+        Assert.assertNotNull(screen);
+
+        Window window = createWindow(screen, caps, width, height, true /* onscreen */, false /* undecorated */);
+
+        window.setFullscreen(true);
+        
+        Assert.assertEquals(true, window.isFullscreen());
+        
+        Thread.sleep(1000); // 1 sec
+        
+        window.setFullscreen(false);
+        Assert.assertEquals(false, window.isFullscreen());
+        
+        destroyWindow(display, screen, window);    	
+    }
+
+    @Test
+    public void testScreenModeChange01() throws InterruptedException {
+        Capabilities caps = new Capabilities();
+        Assert.assertNotNull(caps);
+        Display display = NewtFactory.createDisplay(null); // local display
+        Assert.assertNotNull(display);
+        Screen screen  = NewtFactory.createScreen(display, 0); // screen 0
+        Assert.assertNotNull(screen);
+
+        Window window = createWindow(screen, caps, width, height, true /* onscreen */, false /* undecorated */);
+
+        ScreenMode[] screenModes = screen.getScreenModes();
+        Assert.assertNotNull(screenModes);
+        
+        int originalScreenMode = screen.getDesktopScreenModeIndex();
+        short originalScreenRate = screen.getCurrentScreenRate();
+        
+        Assert.assertNotSame(-1, originalScreenMode);
+        Assert.assertNotSame(-1, originalScreenRate);
+        
+        int modeIndex = 1;
+        
+        ScreenMode screenMode = screenModes[modeIndex];
+        Assert.assertNotNull(screenMode);
+        
+        short modeRate = screenMode.getRates()[0];
+        screen.setScreenMode(modeIndex, modeRate);
+        
+        Assert.assertEquals(modeIndex, screen.getDesktopScreenModeIndex());
+        Assert.assertEquals(modeRate, screen.getCurrentScreenRate());
+        
+        Thread.sleep(6000); // 6 sec
+        
+        screen.setScreenMode(-1, (short)-1);
+        Assert.assertEquals(originalScreenMode, screen.getDesktopScreenModeIndex());
+        Assert.assertEquals(originalScreenRate, screen.getCurrentScreenRate());
+        
+        destroyWindow(display, screen, window);
+    }
+
+    @Test
+    public void testScreenModeChangeWithFS01() throws InterruptedException {
+        Capabilities caps = new Capabilities();
+        Assert.assertNotNull(caps);
+        Display display = NewtFactory.createDisplay(null); // local display
+        Assert.assertNotNull(display);
+        Screen screen  = NewtFactory.createScreen(display, 0); // screen 0
+        Assert.assertNotNull(screen);
+
+        Window window = createWindow(screen, caps, width, height, true /* onscreen */, false /* undecorated */);
+
+        ScreenMode[] screenModes = screen.getScreenModes();
+        Assert.assertNotNull(screenModes);
+        
+        int originalScreenMode = screen.getDesktopScreenModeIndex();
+        short originalScreenRate = screen.getCurrentScreenRate();
+        
+        Assert.assertNotSame(-1, originalScreenMode);
+        Assert.assertNotSame(-1, originalScreenRate);
+        
+        int modeIndex = 1;
+        
+        ScreenMode screenMode = screenModes[modeIndex];
+        Assert.assertNotNull(screenMode);
+        
+        short modeRate = screenMode.getRates()[0];
+        screen.setScreenMode(modeIndex, modeRate);
+        
+        Assert.assertEquals(modeIndex, screen.getDesktopScreenModeIndex());
+        Assert.assertEquals(modeRate, screen.getCurrentScreenRate());
+        
+        window.setFullscreen(true);
+        Assert.assertEquals(true, window.isFullscreen());
+        
+        Thread.sleep(6000); // 6 sec
+        
+        window.setFullscreen(false);
+        Assert.assertEquals(false, window.isFullscreen());
+        
+        screen.setScreenMode(-1, (short)-1);
+        Assert.assertEquals(originalScreenMode, screen.getDesktopScreenModeIndex());
+        Assert.assertEquals(originalScreenRate, screen.getCurrentScreenRate());
+        
+        destroyWindow(display, screen, window);    
+    }
+    
+    @Test
+    public void testScreenModeChangeWithFS02() throws InterruptedException {
+        Capabilities caps = new Capabilities();
+        Assert.assertNotNull(caps);
+        Display display = NewtFactory.createDisplay(null); // local display
+        Assert.assertNotNull(display);
+        Screen screen  = NewtFactory.createScreen(display, 0); // screen 0
+        Assert.assertNotNull(screen);
+
+        Window window = createWindow(screen, caps, width, height, true /* onscreen */, false /* undecorated */);
+
+        ScreenMode[] screenModes = screen.getScreenModes();
+        Assert.assertNotNull(screenModes);
+        
+        int originalScreenMode = screen.getDesktopScreenModeIndex();
+        short originalScreenRate = screen.getCurrentScreenRate();
+        
+        Assert.assertNotSame(-1, originalScreenMode);
+        Assert.assertNotSame(-1, originalScreenRate);
+        
+        int modeIndex = 1;
+        
+        ScreenMode screenMode = screenModes[modeIndex];
+        Assert.assertNotNull(screenMode);
+        
+        short modeRate = screenMode.getRates()[0];
+        screen.setScreenMode(modeIndex, modeRate);
+        
+        Assert.assertEquals(modeIndex, screen.getDesktopScreenModeIndex());
+        Assert.assertEquals(modeRate, screen.getCurrentScreenRate());
+        
+        window.setFullscreen(true);
+        Assert.assertEquals(true, window.isFullscreen());
+        
+        Thread.sleep(6000); // 6 sec
+        
+        screen.setScreenMode(-1, (short)-1);
+        Assert.assertEquals(originalScreenMode, screen.getDesktopScreenModeIndex());
+        Assert.assertEquals(originalScreenRate, screen.getCurrentScreenRate());
+        
+        window.setFullscreen(false);
+        Assert.assertEquals(false, window.isFullscreen());
+        
+        destroyWindow(display, screen, window);    
+    }
+        
+    public static void main(String args[]) throws IOException {
+        String tstname = TestScreenMode01NEWT.class.getName();
+        org.apache.tools.ant.taskdefs.optional.junit.JUnitTestRunner.main(new String[] {
+            tstname,
+            "filtertrace=true",
+            "haltOnError=false",
+            "haltOnFailure=false",
+            "showoutput=true",
+            "outputtoformatters=true",
+            "logfailedtests=true",
+            "logtestlistenerevents=true",
+            "formatter=org.apache.tools.ant.taskdefs.optional.junit.PlainJUnitResultFormatter",
+            "formatter=org.apache.tools.ant.taskdefs.optional.junit.XMLJUnitResultFormatter,TEST-"+tstname+".xml" } );
+    }
+
+}