From 5e9c02bce7b241a0bf95c8abca9a91cd25e51ed3 Mon Sep 17 00:00:00 2001
From: Harvey Harrison
* End users do not need to call this method; it is not necessary to
- * call setRealized
on a {@link GLAutoDrawable}
+ * call setRealized
on a {@link GLAutoDrawable}
* as these perform the appropriate calls on their underlying GLDrawables internally.
*
* Developers implementing new OpenGL components for various window
* toolkits need to call this method against GLDrawables obtained
- * from the GLDrawableFactory via the
+ * from the GLDrawableFactory via the
* {@link GLDrawableFactory#createGLDrawable(NativeSurface)} method.
* It must typically be
* called with an argument of true
when the component
@@ -89,7 +89,7 @@ public interface GLDrawable {
* the addNotify
method and with an argument of
* false
in the removeNotify
method.
*
+ *
* GLDrawable
implementations should handle multiple
* cycles of setRealized(true)
/
* setRealized(false)
calls. Most, if not all, Java
@@ -104,7 +104,7 @@ public interface GLDrawable {
* associated resources as the component becomes realized and
* unrealized, respectively.
*
+ *
* With an argument of true
,
* the minimum implementation shall call
* {@link NativeSurface#lockSurface() NativeSurface's lockSurface()} and if successful:
@@ -117,7 +117,7 @@ public interface GLDrawable {
* ensures resolving the window/surface handles, and the drawable's {@link GLCapabilities}
* might have changed.
*
+ *
* Calling this method has no other effects. For example, if
* removeNotify
is called on a Canvas implementation
* for which a GLDrawable has been created, it is also necessary to
@@ -130,7 +130,7 @@ public interface GLDrawable {
*/
public void setRealized(boolean realized);
- /**
+ /**
* Returns true
if this drawable is realized, otherwise true
.
*
* A drawable can be realized and unrealized via {@link #setRealized(boolean)}.
@@ -146,19 +146,19 @@ public interface GLDrawable {
public int getHeight();
/**
- * Returns true
if the drawable is rendered in
+ * Returns true
if the drawable is rendered in
* OpenGL's coordinate system, origin at bottom left.
* Otherwise returns false
, i.e. origin at top left.
*
* Default impl. is true
, i.e. OpenGL coordinate system.
- *
* Currently only MS-Windows bitmap offscreen drawable uses a non OpenGL orientation and hence returns false
.
* This removes the need of a vertical flip when used in AWT or Windows applications.
*
- * It is usually identical to the underlying windowing toolkit {@link NativeSurface surface}'s + * It is usually identical to the underlying windowing toolkit {@link NativeSurface surface}'s * {@link javax.media.nativewindow.NativeSurface#getSurfaceHandle() handle} * or an intermediate layer to suite GL, e.g. an EGL surface. *
-- cgit v1.2.3