aboutsummaryrefslogtreecommitdiffstats
path: root/src
diff options
context:
space:
mode:
authorSven Gothel <[email protected]>2011-11-27 17:24:29 +0100
committerSven Gothel <[email protected]>2011-11-27 17:24:29 +0100
commitf842b59caa0b98c0c0e229ecb9f7c615650e50e8 (patch)
treeed9623f657e014a892bb9b6e3341c7381d3d85c2 /src
parent9bdc043059abc927a0cdb72b4e775d097e3c8876 (diff)
NEWT: Add DriverUpdatePosition interface; Clarify NativeWindow API doc (position)
DriverUpdatePosition: Interface tagging driver requirement of absolute positioning, ie. depend on parent position.
Diffstat (limited to 'src')
-rw-r--r--src/nativewindow/classes/javax/media/nativewindow/NativeWindow.java12
-rw-r--r--src/newt/classes/jogamp/newt/driver/DriverClearFocus.java2
-rw-r--r--src/newt/classes/jogamp/newt/driver/DriverUpdatePosition.java9
3 files changed, 19 insertions, 4 deletions
diff --git a/src/nativewindow/classes/javax/media/nativewindow/NativeWindow.java b/src/nativewindow/classes/javax/media/nativewindow/NativeWindow.java
index e3ee85cf4..2bc352116 100644
--- a/src/nativewindow/classes/javax/media/nativewindow/NativeWindow.java
+++ b/src/nativewindow/classes/javax/media/nativewindow/NativeWindow.java
@@ -104,20 +104,26 @@ public interface NativeWindow extends NativeSurface {
/**
* @return the current x position of the top-left corner
- * of the client area, hence excluding insets (window decorations).<br>
+ * of the client area relative to it's parent.
+ * Since the position reflects the client area, it does not include the insets.
* @see #getInsets()
*/
public int getX();
/**
* @return the current y position of the top-left corner
- * of the client area, hence excluding insets (window decorations).<br>
+ * of the client area relative to it's parent.
+ * Since the position reflects the client area, it does not include the insets.
* @see #getInsets()
*/
public int getY();
/**
- * Returns the current absolute location of this window.
+ * Returns the current position of the top-left corner
+ * of the client area in screen coordinates.
+ * <p>
+ * Since the position reflects the client area, it does not include the insets.
+ * </p>
* @param point if not null,
* {@link javax.media.nativewindow.util.Point#translate(javax.media.nativewindow.util.Point)}
* the passed {@link javax.media.nativewindow.util.Point} by this location on the screen and return it.
diff --git a/src/newt/classes/jogamp/newt/driver/DriverClearFocus.java b/src/newt/classes/jogamp/newt/driver/DriverClearFocus.java
index 4d23c4ea8..0a824e83b 100644
--- a/src/newt/classes/jogamp/newt/driver/DriverClearFocus.java
+++ b/src/newt/classes/jogamp/newt/driver/DriverClearFocus.java
@@ -1,7 +1,7 @@
package jogamp.newt.driver;
/**
- * Interface tagging driver feature / requirement of clearing the focus.
+ * Interface tagging driver requirement of clearing the focus.
* <p>
* Some drivers require a programmatic {@link #clearFocus()} when traversing the focus.
* </p>
diff --git a/src/newt/classes/jogamp/newt/driver/DriverUpdatePosition.java b/src/newt/classes/jogamp/newt/driver/DriverUpdatePosition.java
new file mode 100644
index 000000000..bb846c081
--- /dev/null
+++ b/src/newt/classes/jogamp/newt/driver/DriverUpdatePosition.java
@@ -0,0 +1,9 @@
+package jogamp.newt.driver;
+
+/**
+ * Interface tagging driver requirement of absolute positioning, ie. depend on parent position.
+ */
+public interface DriverUpdatePosition {
+ /** Programmatic update the position */
+ void updatePosition();
+}