apply preferred style to com.jme3.renderer

jme3-core/src/main/java/com/jme3/renderer/IDList.java → jme3-core/src/main/java/com/jme3/renderer/IdList.java

@@ -35,19 +35,31 @@
 
 /**
  * A specialized data-structure used to optimize state changes of "slot"
- * based state. 
+ * based state.
  */
-public class IDList {
+public class IdList {
 
+    /**
+     * Indices belonging to the "new list". Valid data in elements 0 through newLen-1 only!
+     */
     public int[] newList = new int[16];
+    /**
+     * Indices belonging to the "old list". Valid data in elements 0 through oldLen-1 only!
+     */
     public int[] oldList = new int[16];
+    /**
+     * The number of valid elements in the new list.
+     */
     public int newLen = 0;
+    /**
+     * The number of valid elements in the old list.
+     */
     public int oldLen = 0;
 
     /**
-     * Reset all states to zero
+     * Resets all states to zero.
      */
-    public void reset(){
+    public void reset() {
         newLen = 0;
         oldLen = 0;
         Arrays.fill(newList, 0);
@@ -62,21 +74,22 @@ public void reset(){
      * 
      * @param idx The index to move
      * @return True if it existed in old list and was removed
-     * from there, false otherwise.
+     *     from there, false otherwise.
      */
-    public boolean moveToNew(int idx){
-        if (newLen == 0 || newList[newLen-1] != idx)
+    public boolean moveToNew(int idx) {
+        if (newLen == 0 || newList[newLen - 1] != idx) {
             // add item to newList first
             newList[newLen++] = idx;
+        }
 
         // find idx in oldList, if removed successfully, return true.
-        for (int i = 0; i < oldLen; i++){
-            if (oldList[i] == idx){
+        for (int i = 0; i < oldLen; i++) {
+            if (oldList[i] == idx) {
                 // found index in slot i
                 // delete index from old list
-                oldLen --;
-                for (int j = i; j < oldLen; j++){
-                    oldList[j] = oldList[j+1];
+                oldLen--;
+                for (int j = i; j < oldLen; j++) {
+                    oldList[j] = oldList[j + 1];
                 }
                 return true;
             }
@@ -87,32 +100,34 @@ public boolean moveToNew(int idx){
     /**
      * Copies the new list to the old list, and clears the new list.
      */
-    public void copyNewToOld(){
+    public void copyNewToOld() {
         System.arraycopy(newList, 0, oldList, 0, newLen);
         oldLen = newLen;
         newLen = 0;
     }
 
     /**
-     * Prints the contents of the lists
+     * Prints the contents of the lists.
      */
-    public void print(){
-        if (newLen > 0){
+    public void print() {
+        if (newLen > 0) {
             System.out.print("New List: ");
-            for (int i = 0; i < newLen; i++){
-                if (i == newLen -1)
+            for (int i = 0; i < newLen; i++) {
+                if (i == newLen - 1) {
                     System.out.println(newList[i]);
-                else
-                    System.out.print(newList[i]+", ");
+                } else {
+                    System.out.print(newList[i] + ", ");
+                }
             }
         }
-        if (oldLen > 0){
+        if (oldLen > 0) {
             System.out.print("Old List: ");
-            for (int i = 0; i < oldLen; i++){
-                if (i == oldLen -1)
+            for (int i = 0; i < oldLen; i++) {
+                if (i == oldLen - 1) {
                     System.out.println(oldList[i]);
-                else
-                    System.out.print(oldList[i]+", ");
+                } else {
+                    System.out.print(oldList[i] + ", ");
+                }
             }
         }
     }

jme3-core/src/main/java/com/jme3/renderer/Limits.java

@@ -32,10 +32,10 @@
 package com.jme3.renderer;
 
 /**
- * <code>Limits</code> allows querying the limits of certain features in
+ * Allows querying the limits of certain features in
  * {@link Renderer}.
- * <p>
- * For example, maximum texture sizes or number of samples.
+ *
+ * <p>For example, maximum texture sizes or number of samples.
  *
  * @author Kirill Vainer
  */
@@ -50,32 +50,104 @@ public enum Limits {
      * be used in the fragment shader.
      */
     FragmentTextureUnits,
+    /**
+     * Maximum number of fragment uniform vectors.
+     */
     FragmentUniformVectors,
+    /**
+     * Maximum number of vertex uniform vectors.
+     */
     VertexUniformVectors,
+    /**
+     * Maximum number of vertex attributes.
+     */
     VertexAttributes,
+    /**
+     * Maximum number of FrameBuffer samples.
+     */
     FrameBufferSamples,
+    /**
+     * Maximum number of FrameBuffer attachments.
+     */
     FrameBufferAttachments,
+    /**
+     * Maximum number of FrameBuffer MRT attachments.
+     */
     FrameBufferMrtAttachments,
+    /**
+     * Maximum render buffer size.
+     */
     RenderBufferSize,
+    /**
+     * Maximum texture size.
+     */
     TextureSize,
+    /**
+     * Maximum cubemap size.
+     */
     CubemapSize,
+    /**
+     * Maximum number of color texture samples.
+     */
     ColorTextureSamples,
+    /**
+     * Maximum number of depth texture samples.
+     */
     DepthTextureSamples,
+    /**
+     * Maximum degree of texture anisotropy.
+     */
     TextureAnisotropy,
 
     // UBO
+    /**
+     * Maximum number of UBOs that may be accessed by a vertex shader.
+     */
     UniformBufferObjectMaxVertexBlocks,
+    /**
+     * Maximum number of UBOs that may be accessed by a fragment shader.
+     */
     UniformBufferObjectMaxFragmentBlocks,
+    /**
+     * Maximum number of UBOs that may be accessed by a geometry shader.
+     */
     UniformBufferObjectMaxGeometryBlocks,
+    /**
+     * Maximum block size of a UBO.
+     */
     UniformBufferObjectMaxBlockSize,
 
     // SSBO
+    /**
+     * Maximum size of an SSBO.
+     */
     ShaderStorageBufferObjectMaxBlockSize,
+    /**
+     * Maximum number of active SSBOs that may be accessed by a vertex shader.
+     */
     ShaderStorageBufferObjectMaxVertexBlocks,
+    /**
+     * Maximum number of active SSBOs that may be accessed by a fragment shader.
+     */
     ShaderStorageBufferObjectMaxFragmentBlocks,
+    /**
+     * Maximum number of active SSBOs that may be accessed by a geometry shader.
+     */
     ShaderStorageBufferObjectMaxGeometryBlocks,
+    /**
+     * Maximum number of active SSBOs that may be accessed by a tessellation control shader.
+     */
     ShaderStorageBufferObjectMaxTessControlBlocks,
+    /**
+     * Maximum number of active SSBOs that may be accessed by a tessellation evaluation shader.
+     */
     ShaderStorageBufferObjectMaxTessEvaluationBlocks,
+    /**
+     * Not implemented yet.
+     */
     ShaderStorageBufferObjectMaxComputeBlocks,
+    /**
+     * Maximum number shader storage blocks across all active programs.
+     */
     ShaderStorageBufferObjectMaxCombineBlocks,
 }