propane 3.5.0-java → 3.6.0-java

data/src/main/java/processing/core/PSurface.java

@@ -71,12 +71,13 @@ public interface PSurface {
   //
 
   /**
-   * Get the native window object associated with this drawing surface.
-   * For Java2D, this will be an AWT Frame object. For OpenGL, the window.
-   * The data returned here is subject to the whims of the renderer,
-   * and using this method means you're willing to deal with underlying
-   * implementation changes and that you won't throw a fit like a toddler
-   * if your code breaks sometime in the future.
+   * Get the native window object associated with this drawing surface.For Java2D, this will be an AWT Frame object.
+   * For OpenGL, the window.
+ The data returned here is subject to the whims of the renderer,
+ and using this method means you're willing to deal with underlying
+ implementation changes and that you won't throw a fit like a toddler
+ if your code breaks sometime in the future.
+   * @return 
    */
   public Object getNative();
 
@@ -86,16 +87,20 @@ public interface PSurface {
   // Silly, but prevents a lot of rewrite and extra methods for little benefit.
   // However, maybe prevents us from having to document the 'frame' variable?
 
-  /** Set the window (and dock, or whatever necessary) title. */
+  /** Set the window (and dock, or whatever necessary) title.
+   * @param title */
   public void setTitle(String title);
 
-  /** Show or hide the window. */
+  /** Show or hide the window.
+   * @param visible */
   public void setVisible(boolean visible);
 
-  /** Set true if we want to resize things (default is not resizable) */
+  /** Set true if we want to resize things (default is not resizable)
+   * @param resizable */
   public void setResizable(boolean resizable);
 
-  /** Dumb name, but inherited from Frame and no better ideas. */
+  /** Dumb name, but inherited from Frame and no better ideas.
+   * @param always */
   public void setAlwaysOnTop(boolean always);
 
   public void setIcon(PImage icon);

data/src/main/java/processing/core/PSurfaceNone.java

@@ -107,7 +107,8 @@ public class PSurfaceNone implements PSurface {
   }
 
 
-  /** Set the window (and dock, or whatever necessary) title. */
+  /** Set the window (and dock, or whatever necessary) title.
+   * @param title */
   @Override
   public void setTitle(String title) {
     // You're in a utopian PSurface implementation where titles don't exist.
@@ -120,14 +121,16 @@ public class PSurfaceNone implements PSurface {
   }
 
 
-  /** Show or hide the window. */
+  /** Show or hide the window.
+   * @param visible */
   @Override
   public void setVisible(boolean visible) {
     // I'm always invisible. You can't catch me.
   }
 
 
-  /** Set true if we want to resize things (default is not resizable) */
+  /** Set true if we want to resize things (default is not resizable)
+   * @param resizable */
   @Override
   public void setResizable(boolean resizable) {
     // I don't need size to know my worth.
@@ -295,6 +298,7 @@ public class PSurfaceNone implements PSurface {
   }
 
 
+  @Override
   public void setFrameRate(float fps) {
     frameRateTarget = fps;
     frameRatePeriod = (long) (1000000000.0 / frameRateTarget);
@@ -315,7 +319,7 @@ public class PSurfaceNone implements PSurface {
 
     /**
      * Main method for the primary animation thread.
-     * <a href="http://java.sun.com/products/jfc/tsc/articles/painting/">Painting in AWT and Swing</a>
+     * <A HREF="http://java.sun.com/products/jfc/tsc/articles/painting/">Painting in AWT and Swing</A>
      */
     @Override
     public void run() {  // not good to make this synchronized, locks things up

data/src/main/java/processing/core/PVector.java

@@ -23,8 +23,10 @@
  */
 
 package processing.core;
+
 import java.io.Serializable;
 
+
 /**
  * ( begin auto-generated from PVector.xml )
  *
@@ -47,7 +49,7 @@ import java.io.Serializable;
  * <a
  * href="http://processing.googlecode.com/svn/trunk/processing/build/javadoc/core/">developer's reference.</a>
  *
- * 
+ * ( end auto-generated )
  *
  * A class to describe a two or three dimensional vector.
  * <p>
@@ -71,7 +73,7 @@ public class PVector implements Serializable {
    * The x component of the vector. This field (variable) can be used to both
    * get and set the value (see above example.)
    *
-   * 
+   * ( end auto-generated )
    *
    * @webref pvector:field
    * @usage web_application
@@ -85,7 +87,7 @@ public class PVector implements Serializable {
    * The y component of the vector. This field (variable) can be used to both
    * get and set the value (see above example.)
    *
-   * 
+   * ( end auto-generated )
    *
    * @webref pvector:field
    * @usage web_application
@@ -99,7 +101,7 @@ public class PVector implements Serializable {
    * The z component of the vector. This field (variable) can be used to both
    * get and set the value (see above example.)
    *
-   * 
+   * ( end auto-generated )
    *
    * @webref pvector:field
    * @usage web_application
@@ -147,7 +149,7 @@ public class PVector implements Serializable {
    * Sets the x, y, and z component of the vector using two or three separate
    * variables, the data from a PVector, or the values from a float array.
    *
-   * 
+   * ( end auto-generated )
    *
    * @webref pvector:method
    * @param x the x component of the vector
@@ -325,7 +327,7 @@ public class PVector implements Serializable {
    *
    * Make a new 2D unit vector from an angle.
    *
-   * 
+   * ( end auto-generated )
    *
    * @webref pvector:method
    * @usage web_application
@@ -359,7 +361,7 @@ public class PVector implements Serializable {
    *
    * Gets a copy of the vector, returns a PVector object.
    *
-   * 
+   * ( end auto-generated )
    *
    * @webref pvector:method
    * @usage web_application
@@ -400,7 +402,7 @@ public class PVector implements Serializable {
    * Calculates the magnitude (length) of the vector and returns the result
    * as a float (this is simply the equation <em>sqrt(x*x + y*y + z*z)</em>.)
    *
-   * 
+   * ( end auto-generated )
    *
    * @webref pvector:method
    * @usage web_application
@@ -421,7 +423,7 @@ public class PVector implements Serializable {
    * Faster if the real length is not required in the
    * case of comparing vectors, etc.
    *
-   * 
+   * ( end auto-generated )
    *
    * @webref pvector:method
    * @usage web_application
@@ -443,7 +445,7 @@ public class PVector implements Serializable {
    * others have no return value -- they act directly on the vector. See the
    * examples for more context.
    *
-   * 
+   * ( end auto-generated )
    *
    * @webref pvector:method
    * @usage web_application
@@ -513,7 +515,7 @@ public class PVector implements Serializable {
    * PVector, the others have no return value -- they act directly on the
    * vector. See the examples for more context.
    *
-   * 
+   * ( end auto-generated )
    *
    * @webref pvector:method
    * @usage web_application
@@ -579,7 +581,7 @@ public class PVector implements Serializable {
    *
    * Multiplies a vector by a scalar or multiplies one vector by another.
    *
-   * 
+   * ( end auto-generated )
    *
    * @webref pvector:method
    * @usage web_application
@@ -621,7 +623,7 @@ public class PVector implements Serializable {
    *
    * Divides a vector by a scalar or divides one vector by another.
    *
-   * 
+   * ( end auto-generated )
    *
    * @webref pvector:method
    * @usage web_application
@@ -666,7 +668,7 @@ public class PVector implements Serializable {
    * Calculates the Euclidean distance between two points (considering a
    * point as a vector object).
    *
-   * 
+   * ( end auto-generated )
    *
    * @webref pvector:method
    * @usage web_application
@@ -699,7 +701,7 @@ public class PVector implements Serializable {
    *
    * Calculates the dot product of two vectors.
    *
-   * 
+   * ( end auto-generated )
    *
    * @webref pvector:method
    * @usage web_application
@@ -737,7 +739,7 @@ public class PVector implements Serializable {
    * Calculates and returns a vector composed of the cross product between
    * two vectors.
    *
-   * 
+   * ( end auto-generated )
    *
    * @webref pvector:method
    * @param v the vector to calculate the cross product
@@ -790,7 +792,7 @@ public class PVector implements Serializable {
    *
    * Normalize the vector to length 1 (make it a unit vector).
    *
-   * 
+   * ( end auto-generated )
    *
    * @webref pvector:method
    * @usage web_application
@@ -828,7 +830,7 @@ public class PVector implements Serializable {
    *
    * Limit the magnitude of this vector to the value used for the <b>max</b> parameter.
    *
-   * 
+   * ( end auto-generated )
    *
    * @webref pvector:method
    * @usage web_application
@@ -849,7 +851,7 @@ public class PVector implements Serializable {
    *
    * Set the magnitude of this vector to the value used for the <b>len</b> parameter.
    *
-   * 
+   * ( end auto-generated )
    *
    * @webref pvector:method
    * @usage web_application
@@ -881,7 +883,7 @@ public class PVector implements Serializable {
    *
    * Calculate the angle of rotation for this vector (only 2D vectors)
    *
-   * 
+   * ( end auto-generated )
    *
    * @webref pvector:method
    * @usage web_application
@@ -905,7 +907,7 @@ public class PVector implements Serializable {
    *
    * Rotate the vector by an angle (only 2D vectors), magnitude remains the same
    *
-   * 
+   * ( end auto-generated )
    *
    * @webref pvector:method
    * @usage web_application
@@ -926,7 +928,7 @@ public class PVector implements Serializable {
    *
    * Linear interpolate the vector to another vector
    *
-   * 
+   * ( end auto-generated )
    *
    * @webref pvector:method
    * @usage web_application
@@ -947,6 +949,8 @@ public class PVector implements Serializable {
    * Linear interpolate between two vectors (returns a new PVector object)
    * @param v1 the vector to start from
    * @param v2 the vector to lerp to
+   * @param amt
+   * @return 
    */
   public static PVector lerp(PVector v1, PVector v2, float amt) {
     PVector v = v1.copy();
@@ -960,6 +964,8 @@ public class PVector implements Serializable {
    * @param x the x component to lerp to
    * @param y the y component to lerp to
    * @param z the z component to lerp to
+   * @param amt
+   * @return 
    */
   public PVector lerp(float x, float y, float z, float amt) {
     this.x = PApplet.lerp(this.x, x, amt);
@@ -972,10 +978,10 @@ public class PVector implements Serializable {
   /**
    * ( begin auto-generated from PVector_angleBetween.xml )
    *
-   * Calculates and returns the angle (in radians) between two vectors.
+   * Calculates and returns the angle (in radians) between two vectors.( end auto-generated )
    *
-   * 
    *
+   * @return 
    * @webref pvector:method
    * @usage web_application
    * @param v1 the x, y, and z components of a PVector
@@ -1017,12 +1023,13 @@ public class PVector implements Serializable {
   /**
    * ( begin auto-generated from PVector_array.xml )
    *
-   * Return a representation of this vector as a float array. This is only
-   * for temporary use. If used in any other fashion, the contents should be
-   * copied by using the <b>PVector.get()</b> method to copy into your own array.
+   * Return a representation of this vector as a float array.This is only
+ for temporary use. If used in any other fashion, the contents should be
+ copied by using the <b>PVector.get()</b> method to copy into your own array.
    *
-   * 
+   * ( end auto-generated )
    *
+   * @return 
    * @webref pvector:method
    * @usage: web_application
    * @brief Return a representation of the vector as a float array

data/src/main/java/processing/data/Table.java

@@ -437,7 +437,7 @@ public class Table {
             // Sleep this thread so that the GC can catch up
             Thread.sleep(10);
           } catch (InterruptedException e) {
-      
+            e.printStackTrace();
           }
         }
       }
@@ -835,7 +835,7 @@ public class Table {
         }
       }
     } catch (IOException e) {
-
+      e.printStackTrace();
     }
     return null;
   }
@@ -873,13 +873,13 @@ public class Table {
         }
       }
     } catch (UnsupportedEncodingException e) {
-
+      e.printStackTrace();
     } catch (IOException e) {
-
+      e.printStackTrace();
     } catch (ParserConfigurationException e) {
-
+      e.printStackTrace();
     } catch (SAXException e) {
-
+      e.printStackTrace();
     }
   }
 
@@ -1047,9 +1047,9 @@ public class Table {
         outgoing = Array.newInstance(target, getRowCount());
       }
     } catch (NoSuchFieldException e) {
-
+      e.printStackTrace();
     } catch (SecurityException e) {
-
+      e.printStackTrace();
     }
 
 //    Object enclosingObject = sketch;
@@ -1070,9 +1070,9 @@ public class Table {
         con.setAccessible(true);
       }
     } catch (SecurityException e) {
-
+      e.printStackTrace();
     } catch (NoSuchMethodException e) {
-
+      e.printStackTrace();
     }
 
     Field[] fields = target.getDeclaredFields();
@@ -1166,13 +1166,13 @@ public class Table {
       targetField.set(enclosingObject, outgoing);
 
     } catch (InstantiationException e) {
-
+      e.printStackTrace();
     } catch (IllegalAccessException e) {
-
+      e.printStackTrace();
     } catch (IllegalArgumentException e) {
-
+      e.printStackTrace();
     } catch (InvocationTargetException e) {
-
+      e.printStackTrace();
     }
   }
 
@@ -1213,7 +1213,7 @@ public class Table {
       try {
         saveODS(output);
       } catch (IOException e) {
-  
+        e.printStackTrace();
         return false;
       }
     } else if (extension.equals("html")) {
@@ -1222,7 +1222,7 @@ public class Table {
       try {
         saveBinary(output);
       } catch (IOException e) {
-  
+        e.printStackTrace();
         return false;
       }
     }
@@ -2300,7 +2300,7 @@ public class Table {
           try {
             Thread.sleep(10);  // gc time!
           } catch (InterruptedException e) {
-      
+            e.printStackTrace();
           }
         }
       }
@@ -3021,7 +3021,7 @@ public class Table {
             try {
               return rs.getMetaData().getColumnCount();
             } catch (SQLException e) {
-        
+              e.printStackTrace();
               return -1;
             }
           }
@@ -3434,7 +3434,7 @@ public class Table {
 //    try {
 //      return excelDateFormat.parse(timestamp).getTime();
 //    } catch (ParseException e) {
-//
+//      e.printStackTrace();
 //      return -1;
 //    }
 //  }
@@ -4778,7 +4778,7 @@ public class Table {
 //        try {
 //          Thread.sleep(5);
 //        } catch (InterruptedException e) {
-//    
+//          e.printStackTrace();
 //        }
       }
     }