Clarify code in stereo/ovr: Comments, states, names, formatting.

3 files changed, 9 insertions, 18 deletions

diff --git a/src/jogl/classes/com/jogamp/opengl/util/stereo/EyeParameter.java b/src/jogl/classes/com/jogamp/opengl/util/stereo/EyeParameter.java
index 075da340b..43a6cfc58 100644
--- a/src/jogl/classes/com/jogamp/opengl/util/stereo/EyeParameter.java
+++ b/src/jogl/classes/com/jogamp/opengl/util/stereo/EyeParameter.java
@@ -30,7 +30,7 @@ package com.jogamp.opengl.util.stereo;
 import com.jogamp.opengl.math.FovHVHalves;
 
 /**
- * Constant parameter for one eye.
+ * Constant single eye parameter of the viewer, relative to its {@link ViewerPose}.
  */
 public final class EyeParameter {
     /** Eye number, <code>0</code> for the left eye and <code>1</code> for the right eye. */
@@ -39,7 +39,7 @@ public final class EyeParameter {
     /** float[3] eye position vector used to define eye height in meter relative to <i>actor</i>. */
     public final float[] positionOffset;
 
-    /** Field of view in both directions, may not be centered, either in radians or tangent. */
+    /** Field of view in both directions, may not be centered, either {@link FovHVHalves#inTangents} or radians. */
     public final FovHVHalves fovhv;
 
     /** IPD related horizontal distance from nose to pupil in meter. */
diff --git a/src/jogl/classes/com/jogamp/opengl/util/stereo/ViewerPose.java b/src/jogl/classes/com/jogamp/opengl/util/stereo/ViewerPose.java
index 40411ac88..10ee4c994 100644
--- a/src/jogl/classes/com/jogamp/opengl/util/stereo/ViewerPose.java
+++ b/src/jogl/classes/com/jogamp/opengl/util/stereo/ViewerPose.java
@@ -30,7 +30,7 @@ package com.jogamp.opengl.util.stereo;
 import com.jogamp.opengl.math.Quaternion;
 
 /**
- * Position and orientation of viewer.
+ * {@link #position} and {@link #orientation} of viewer.
  */
 public final class ViewerPose {
     /**
diff --git a/src/jogl/classes/jogamp/opengl/util/stereo/GenericStereoDevice.java b/src/jogl/classes/jogamp/opengl/util/stereo/GenericStereoDevice.java
index 491535dc1..88be3b26b 100644
--- a/src/jogl/classes/jogamp/opengl/util/stereo/GenericStereoDevice.java
+++ b/src/jogl/classes/jogamp/opengl/util/stereo/GenericStereoDevice.java
@@ -163,31 +163,22 @@ public class GenericStereoDevice implements StereoDevice {
     }
 
     @Override
-    public boolean isValid() {
-        return true;
-    }
+    public boolean isValid() { return true; }
 
     @Override
-    public final PointImmutable getPosition() {
-        return surfacePos;
-    }
+    public final PointImmutable getPosition() { return surfacePos; }
 
     @Override
-    public final DimensionImmutable getSurfaceSize() {
-        return config.surfaceSizeInPixels;
-    }
+    public final DimensionImmutable getSurfaceSize() { return config.surfaceSizeInPixels; }
     @Override
     public int getRequiredRotation() { return 0; }
 
     @Override
-    public float[] getDefaultEyePositionOffset() {
-        return config.defaultEyeParam[0].positionOffset;
-    }
+    public float[] getDefaultEyePositionOffset() { return config.defaultEyeParam[0].positionOffset; }
 
     @Override
-    public final FovHVHalves[] getDefaultFOV() {
-        return defaultEyeFov;
-    }
+    public final FovHVHalves[] getDefaultFOV() { return defaultEyeFov; }
+
 
     @Override
     public final boolean startSensors(final int desiredSensorBits, final int requiredSensorBits) {