propane 3.8.0-java → 4.0.0-java

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

@@ -3,7 +3,7 @@
  /*
   Part of the Processing project - http://processing.org
 
-  Copyright (c) 2012-20 The Processing Foundation
+  Copyright (c) 2012-22 The Processing Foundation
   Copyright (c) 2004-12 Ben Fry and Casey Reas
   Copyright (c) 2001-04 Massachusetts Institute of Technology
 
@@ -39,8 +39,8 @@ import java.util.zip.*;
 
 // loadXML() error handling
 import javax.xml.parsers.ParserConfigurationException;
-import monkstone.noise.NoiseMode;
-import monkstone.noise.Noise;
+// import monkstone.noise.NoiseMode;
+// import monkstone.noise.Noise;
 import org.xml.sax.SAXException;
 
 // TODO have this removed by 4.0 final
@@ -49,9 +49,7 @@ import processing.awt.ShimAWT;
 import processing.data.*;
 import processing.event.*;
 import processing.opengl.*;
-import monkstone.noise.NoiseGenerator;
-import monkstone.noise.SimplexNoise;
-import monkstone.noise.ValueNoise;
+// import monkstone.noise.NoiseGenerator;
 
 /**
  * Base class for all sketches that use processing.core.
@@ -120,8 +118,8 @@ public class PApplet implements PConstants {
      * For 3.3.5, this defaults to true on all platforms.
      */
     static public boolean useNativeSelect = true;
-    
-    Noise noiseGenerator = new NoiseGenerator();
+
+  //  Noise noiseGenerator = new NoiseGenerator();
 
     /**
      * The PGraphics renderer associated with this PApplet
@@ -261,13 +259,13 @@ public class PApplet implements PConstants {
     /**
      * ( begin auto-generated from pixelWidth.xml )
      *
-     * When <b>pixelDensity(2)</d> is used to make use of a high resolution
+     * When <b>pixelDensity(2)</b> is used to make use of a high resolution
      * display (called a Retina display on OS X or high-dpi on Windows and
      * Linux), the width and height of the sketch do not change, but the number
      * of pixels is doubled. As a result, all operations that use pixels (like
      * <b>loadPixels()</b>, <b>get()</b>, <b>set()</b>, etc.) happen in this
      * doubled space. As a convenience, the variables <b>pixelWidth</b>
-     * and <b>pixelHeight<b> hold the actual width and height of the sketch in
+     * and <b>pixelHeight</b> hold the actual width and height of the sketch in
      * pixels. This is useful for any sketch that uses the <b>pixels[]</b>
      * array, for instance, because the number of elements in the array will be
      * <b>pixelWidth*pixelHeight</b>, not <b>width*height</b>.
@@ -284,13 +282,13 @@ public class PApplet implements PConstants {
     /**
      * ( begin auto-generated from pixelHeight.xml )
      *
-     * When <b>pixelDensity(2)</d> is used to make use of a high resolution
+     * When <b>pixelDensity(2)</b> is used to make use of a high resolution
      * display (called a Retina display on OS X or high-dpi on Windows and
      * Linux), the width and height of the sketch do not change, but the number
      * of pixels is doubled. As a result, all operations that use pixels (like
      * <b>loadPixels()</b>, <b>get()</b>, <b>set()</b>, etc.) happen in this
      * doubled space. As a convenience, the variables <b>pixelWidth</b>
-     * and <b>pixelHeight<b> hold the actual width and height of the sketch in
+     * and <b>pixelHeight</b> hold the actual width and height of the sketch in
      * pixels. This is useful for any sketch that uses the <b>pixels[]</b>
      * array, for instance, because the number of elements in the array will be
      * <b>pixelWidth*pixelHeight</b>, not <b>width*height</b>.
@@ -372,8 +370,8 @@ public class PApplet implements PConstants {
      * <b>draw()</b>). But, inside mouse events, they update each time the event
      * is called. If they weren't separated, then the mouse would be read only
      * once per frame, making response choppy. If the mouse variables were
-     * always updated multiple times per frame, using <NOBR><b>line(pmouseX,
-     * pmouseY, mouseX, mouseY)</b></NOBR> inside <b>draw()</b> would have lots
+     * always updated multiple times per frame, using <b>line(pmouseX,
+     * pmouseY, mouseX, mouseY)</b> inside <b>draw()</b> would have lots
      * of gaps, because <b>pmouseX</b> may have changed several times in between
      * the calls to <b>line()</b>. Use <b>pmouseX</b> and
      * <b>pmouseY</b> inside <b>draw()</b> if you want values relative to the
@@ -969,11 +967,10 @@ public class PApplet implements PConstants {
      *
      * This function returns the number "2" if the screen is a high-density
      * screen (called a Retina display on OS X or high-dpi on Windows and Linux)
-     * and a "1" if not. This information is useful for a program to adapt to
-     * run at double the pixel density on a screen that supports it.
-     *
-     * ( end auto-generated )
+     * and a "1" if not.This information is useful for a program to adapt to
+ run at double the pixel density on a screen that supports it. ( end auto-generated )
      *
+     * @return
      * @webref environment
      * @see PApplet#pixelDensity(int)
      * @see PApplet#size(int,int)
@@ -1003,6 +1000,7 @@ public class PApplet implements PConstants {
     /**
      * @param display the display number to check (1-indexed to match the
      * Preferences dialog box)
+     * @return
      */
     public int displayDensity(int display) {
         if (!disableAWT) {
@@ -1057,6 +1055,8 @@ public class PApplet implements PConstants {
     /**
      * Called by PSurface objects to set the width and height variables, and
      * update the pixelWidth and pixelHeight variables.
+     * @param width
+     * @param height
      */
     public void setSize(int width, int height) {
         this.width = width;
@@ -1322,7 +1322,7 @@ public class PApplet implements PConstants {
      * <li>resume – called when the sketch is resumed
      * <li>dispose – when the sketch is shutting down (definitely not safe to
      * draw)
-     * <ul>
+     * </ul>
      * In addition, the new (for 2.0) processing.event classes are passed to the
      * following event types:
      * <ul>
@@ -1337,17 +1337,19 @@ public class PApplet implements PConstants {
      * @param target the target object that should receive the event
      */
     public void registerMethod(String methodName, Object target) {
-        if (methodName.equals("mouseEvent")) {
-            registerWithArgs("mouseEvent", target, new Class[]{processing.event.MouseEvent.class});
-
-        } else if (methodName.equals("keyEvent")) {
-            registerWithArgs("keyEvent", target, new Class[]{processing.event.KeyEvent.class});
-
-        } else if (methodName.equals("touchEvent")) {
-            registerWithArgs("touchEvent", target, new Class[]{processing.event.TouchEvent.class});
-
-        } else {
-            registerNoArgs(methodName, target);
+        switch (methodName) {
+            case "mouseEvent":
+                registerWithArgs("mouseEvent", target, new Class[]{processing.event.MouseEvent.class});
+                break;
+            case "keyEvent":
+                registerWithArgs("keyEvent", target, new Class[]{processing.event.KeyEvent.class});
+                break;
+            case "touchEvent":
+                registerWithArgs("touchEvent", target, new Class[]{processing.event.TouchEvent.class});
+                break;
+            default:
+                registerNoArgs(methodName, target);
+                break;
         }
     }
 
@@ -1683,6 +1685,7 @@ public class PApplet implements PConstants {
     }
 
     /**
+     * @param renderer
      * @param display the screen to run the sketch on (1, 2, 3, etc. or on
      * multiple screens using SPAN)
      */
@@ -1802,6 +1805,10 @@ public class PApplet implements PConstants {
     }
 
     /**
+     * @param width
+     * @param height
+     * @param renderer
+     * @param path
      * @nowebref
      */
     public void size(int width, int height, String renderer, String path) {
@@ -1893,9 +1900,9 @@ public class PApplet implements PConstants {
      * ( begin auto-generated from createGraphics.xml )
      *
      * Creates and returns a new <b>PGraphics</b> object of the types P2D or
-     * P3D. Use this class if you need to draw into an off-screen graphics
-     * buffer. The PDF renderer requires the filename parameter. The DXF
-     * renderer should not be used with <b>createGraphics()</b>, it's only built
+     * P3D.Use this class if you need to draw into an off-screen graphics
+ buffer. The PDF renderer requires the filename parameter. The DXF
+ renderer should not be used with <b>createGraphics()</b>, it's only built
      * for use with <b>beginRaw()</b> and <b>endRaw()</b>.
      *
      * It's important to call any drawing functions between <b>beginDraw()</b>
@@ -1957,6 +1964,7 @@ public class PApplet implements PConstants {
      * <A HREF="http://dev.processing.org/reference/core/javadoc/processing/core/PImage.html#save(java.lang.String)">PImage.save()</A>.
      * </UL>
      *
+     * @return
      * @webref rendering
      * @param w width in pixels
      * @param h height in pixels
@@ -1972,7 +1980,11 @@ public class PApplet implements PConstants {
      * Create an offscreen graphics surface for drawing, in this case for a
      * renderer that writes to a file (such as PDF or DXF).
      *
+     * @param w
      * @param path the name of the file (can be an absolute or relative path)
+     * @param renderer
+     * @param h
+     * @return
      */
     public PGraphics createGraphics(int w, int h,
             String renderer, String path) {
@@ -1995,8 +2007,13 @@ public class PApplet implements PConstants {
     /**
      * Version of createGraphics() used internally.
      *
+     * @param w
+     * @param h
+     * @param renderer
      * @param path A path (or null if none), can be absolute or relative
      * ({@link PApplet#savePath} will be called)
+     * @param primary
+     * @return
      */
     protected PGraphics makeGraphics(int w, int h,
             String renderer, String path,
@@ -2041,7 +2058,7 @@ public class PApplet implements PConstants {
         } catch (InvocationTargetException ite) {
             String msg = ite.getTargetException().getMessage();
             if ((msg != null)
-                    && (msg.indexOf("no jogl in java.library.path") != -1)) {
+                    && (msg.contains("no jogl in java.library.path"))) {
                 // Is this true anymore, since the JARs contain the native libs?
                 throw new RuntimeException("The jogl library folder needs to be "
                         + "specified with -Djava.library.path=/path/to/jogl");
@@ -2071,7 +2088,7 @@ public class PApplet implements PConstants {
                         + " renderer is not in the class path.");
             }
 
-        } catch (Exception e) {
+        } catch (IllegalAccessException | IllegalArgumentException | InstantiationException | NoSuchMethodException | SecurityException e) {
             if ((e instanceof IllegalArgumentException)
                     || (e instanceof NoSuchMethodException)
                     || (e instanceof IllegalAccessException)) {
@@ -2101,6 +2118,7 @@ public class PApplet implements PConstants {
     /**
      * Create default renderer, likely to be resized, but needed for surface
      * init.
+     * @return
      */
     protected PGraphics createPrimaryGraphics() {
         return makeGraphics(sketchWidth(), sketchHeight(),
@@ -2110,9 +2128,9 @@ public class PApplet implements PConstants {
     /**
      * ( begin auto-generated from createImage.xml )
      *
-     * Creates a new PImage (the datatype for storing images). This provides a
-     * fresh buffer of pixels to play with. Set the size of the buffer with the
-     * <b>width</b> and <b>height</b> parameters. The <b>format</b> parameter
+     * Creates a new PImage (the datatype for storing images).This provides a
+ fresh buffer of pixels to play with. Set the size of the buffer with the
+ <b>width</b> and <b>height</b> parameters. The <b>format</b> parameter
      * defines how the pixels are stored. See the PImage reference for more
      * information.
      *
@@ -2128,6 +2146,7 @@ public class PApplet implements PConstants {
      * to the parent PApplet is included, which makes save() work without
      * needing an absolute path.
      *
+     * @return
      * @webref image
      * @param w width in pixels
      * @param h height in pixels
@@ -2386,6 +2405,7 @@ public class PApplet implements PConstants {
     /**
      * Add an event to the internal event queue, or process it immediately if
      * the sketch is not currently looping.
+     * @param pe
      */
     public void postEvent(processing.event.Event pe) {
         eventQueue.add(pe);
@@ -2933,16 +2953,15 @@ public class PApplet implements PConstants {
      * ( begin auto-generated from millis.xml )
      *
      * Returns the number of milliseconds (thousandths of a second) since
-     * starting an applet. This information is often used for timing animation
-     * sequences.
-     *
-     * ( end auto-generated )
-     *
-     * <h3>Advanced</h3>
+     * starting an applet.This information is often used for timing animation
+ sequences. ( end auto-generated )
+
+ <h3>Advanced</h3>
      * <p>
      * This is a function, rather than a variable, because it may change
      * multiple times per frame.
      *
+     * @return
      * @webref input:time_date
      * @see PApplet#second()
      * @see PApplet#minute()
@@ -2959,12 +2978,11 @@ public class PApplet implements PConstants {
     /**
      * ( begin auto-generated from second.xml )
      *
-     * Processing communicates with the clock on your computer. The
-     * <b>second()</b> function returns the current second as a value from 0 -
-     * 59.
-     *
-     * ( end auto-generated )
+     * Processing communicates with the clock on your computer.The
+    <b>second()</b> function returns the current second as a value from 0 -
+ 59. ( end auto-generated )
      *
+     * @return
      * @webref input:time_date
      * @see PApplet#millis()
      * @see PApplet#minute()
@@ -2972,7 +2990,7 @@ public class PApplet implements PConstants {
      * @see PApplet#day()
      * @see PApplet#month()
      * @see PApplet#year()
-   *
+     *
      */
     static public int second() {
         return Calendar.getInstance().get(Calendar.SECOND);
@@ -2981,12 +2999,11 @@ public class PApplet implements PConstants {
     /**
      * ( begin auto-generated from minute.xml )
      *
-     * Processing communicates with the clock on your computer. The
-     * <b>minute()</b> function returns the current minute as a value from 0 -
-     * 59.
-     *
-     * ( end auto-generated )
+     * Processing communicates with the clock on your computer.The
+    <b>minute()</b> function returns the current minute as a value from 0 -
+ 59. ( end auto-generated )
      *
+     * @return
      * @webref input:time_date
      * @see PApplet#millis()
      * @see PApplet#second()
@@ -3004,11 +3021,10 @@ public class PApplet implements PConstants {
     /**
      * ( begin auto-generated from hour.xml )
      *
-     * Processing communicates with the clock on your computer. The
-     * <b>hour()</b> function returns the current hour as a value from 0 - 23.
-     *
-     * ( end auto-generated )
+     * Processing communicates with the clock on your computer.The
+    <b>hour()</b> function returns the current hour as a value from 0 - 23. ( end auto-generated )
      *
+     * @return
      * @webref input:time_date
      * @see PApplet#millis()
      * @see PApplet#second()
@@ -3050,11 +3066,10 @@ public class PApplet implements PConstants {
     /**
      * ( begin auto-generated from month.xml )
      *
-     * Processing communicates with the clock on your computer. The
-     * <b>month()</b> function returns the current month as a value from 1 - 12.
-     *
-     * ( end auto-generated )
+     * Processing communicates with the clock on your computer.The
+    <b>month()</b> function returns the current month as a value from 1 - 12. ( end auto-generated )
      *
+     * @return
      * @webref input:time_date
      * @see PApplet#millis()
      * @see PApplet#second()
@@ -3177,14 +3192,14 @@ public class PApplet implements PConstants {
     /**
      * ( begin auto-generated from launch.xml )
      *
-     * Attempts to open an application or file using your platform's launcher.
-     * The <b>file</b> parameter is a String specifying the file name and
-     * location. The location parameter must be a full path name, or the name of
-     * an executable in the system's PATH. In most cases, using a full path is
-     * the best option, rather than relying on the system PATH. Be sure to make
-     * the file executable before attempting to open it (chmod +x).
-     *
-     * The <b>args</b> parameter is a String or String array which is passed to
+     * Attempts to open an application or file using your platform's launcher.The <b>file</b> parameter is a String specifying the file name and
+ location.
+     * The location parameter must be a full path name, or the name of
+ an executable in the system's PATH. In most cases, using a full path is
+ the best option, rather than relying on the system PATH. Be sure to make
+ the file executable before attempting to open it (chmod +x).
+
+ The <b>args</b> parameter is a String or String array which is passed to
      * the command line. If you have multiple parameters, e.g. an application
      * and a document, or a command with multiple switches, use the version that
      * takes a String array, and place each individual item in a separate
@@ -3209,6 +3224,7 @@ public class PApplet implements PConstants {
      *
      * ( end auto-generated )
      *
+     * @return
      * @webref input:files
      * @param args arguments to the launcher, eg. a filename.
      * @usage Application
@@ -3216,42 +3232,44 @@ public class PApplet implements PConstants {
     static public Process launch(String... args) {
         String[] params = null;
 
-        if (platform == WINDOWS) {
-            // just launching the .html file via the shell works
-            // but make sure to chmod +x the .html files first
-            // also place quotes around it in case there's a space
-            // in the user.dir part of the url
-            params = new String[]{"cmd", "/c"};
-
-        } else if (platform == MACOS) {
-            params = new String[]{"open"};
-
-        } else if (platform == LINUX) {
-            // xdg-open is in the Free Desktop Specification and really should just
-            // work on desktop Linux. Not risking it though.
-            final String[] launchers = {"xdg-open", "gnome-open", "kde-open"};
-            for (String launcher : launchers) {
-                if (openLauncher != null) {
-                    break;
-                }
-                try {
-                    Process p = Runtime.getRuntime().exec(new String[]{launcher});
-                    /*int result =*/ p.waitFor();
-                    // Not installed will throw an IOException (JDK 1.4.2, Ubuntu 7.04)
-                    openLauncher = launcher;
-                } catch (Exception e) {
+        switch (platform) {
+            case WINDOWS:
+                // just launching the .html file via the shell works
+                // but make sure to chmod +x the .html files first
+                // also place quotes around it in case there's a space
+                // in the user.dir part of the url
+                params = new String[]{"cmd", "/c"};
+                break;
+            case MACOS:
+                params = new String[]{"open"};
+                break;
+            case LINUX:
+                // xdg-open is in the Free Desktop Specification and really should just
+                // work on desktop Linux. Not risking it though.
+                final String[] launchers = {"xdg-open", "gnome-open", "kde-open"};
+                for (String launcher : launchers) {
+                    if (openLauncher != null) {
+                        break;
+                    }
+                    try {
+                        Process p = Runtime.getRuntime().exec(new String[]{launcher});
+                        /*int result =*/ p.waitFor();
+                        // Not installed will throw an IOException (JDK 1.4.2, Ubuntu 7.04)
+                        openLauncher = launcher;
+                    } catch (Exception e) {
+                    }
+                }   if (openLauncher == null) {
+                    System.err.println("Could not find xdg-open, gnome-open, or kde-open: "
+                            + "the open() command may not work.");
+                }   if (openLauncher != null) {
+                    params = new String[]{openLauncher};
                 }
-            }
-            if (openLauncher == null) {
-                System.err.println("Could not find xdg-open, gnome-open, or kde-open: "
-                        + "the open() command may not work.");
-            }
-            if (openLauncher != null) {
-                params = new String[]{openLauncher};
-            }
-            //} else {  // give up and just pass it to Runtime.exec()
-            //open(new String[] { filename });
-            //params = new String[] { filename };
+                //} else {  // give up and just pass it to Runtime.exec()
+                //open(new String[] { filename });
+                //params = new String[] { filename };
+                break;
+            default:
+                break;
         }
         if (params != null) {
             // If the 'open', 'gnome-open' or 'cmd' are already included
@@ -3990,9 +4008,10 @@ public class PApplet implements PConstants {
   }
      */
     /**
-     * For arrays, use printArray() instead. This function causes a warning
+     * For arrays, use printArray() instead.This function causes a warning
      * because the new print(Object...) and println(Object...) functions can't
      * be reliably bound by the compiler.
+     * @param what
      */
     static public void println(Object what) {
         if (what == null) {
@@ -4905,111 +4924,101 @@ public class PApplet implements PConstants {
      * @see PApplet#noise(float, float, float)
      * @see PApplet#noiseSeed(long)
      */
-    public final void randomSeed(long seed) {
-        if (internalRandom == null) {
-            internalRandom = new Random();
-        }
-        internalRandom.setSeed(seed);
-    }
-    
-    public void noiseMode(NoiseMode mode){
-        noiseGenerator.noiseMode(mode);
-    }
-
-    /**
-     */
-    public float noise(float x) {
-        return noiseGenerator.noise(x);
-    }
-
-    /**
-     */
-    public float noise(float x, float y) {
-        return  noiseGenerator.noise(x, y);
-    }
-
-    /**
-     * ( begin auto-generated from noise.xml )
-     *
-     * Returns the Perlin noise value at specified coordinates. Perlin noise is
-     * a random sequence generator producing a more natural ordered, harmonic
-     * succession of numbers compared to the standard <b>random()</b> function.
-     * It was invented by Ken Perlin in the 1980s and been used since in
-     * graphical applications to produce procedural textures, natural motion,
-     * shapes, terrains etc. The main difference to the
-     * <b>random()</b> function is that Perlin noise is defined in an infinite
-     * n-dimensional space where each pair of coordinates corresponds to a fixed
-     * semi-random value (fixed only for the lifespan of the program). The
-     * resulting value will always be between 0.0 and 1.0. Processing can
-     * compute 1D, 2D and 3D noise, depending on the number of coordinates
-     * given. The noise value can be animated by moving through the noise space
-     * as demonstrated in the example above. The 2nd and 3rd dimension can also
-     * be interpreted as time.The actual noise is structured similar to an audio
-     * signal, in respect to the function's use of frequencies. Similar to the
-     * concept of harmonics in physics, perlin noise is computed over several
-     * octaves which are added together for the final result. Another way to
-     * adjust the character of the resulting sequence is the scale of the input
-     * coordinates. As the function works within an infinite space the value of
-     * the coordinates doesn't matter as such, only the distance between
-     * successive coordinates does (eg. when using <b>noise()</b> within a
-     * loop). As a general rule the smaller the difference between coordinates,
-     * the smoother the resulting noise sequence will be. Steps of 0.005-0.03
-     * work best for most applications, but this will differ depending on use.
-     *
-     * ( end auto-generated )
-     *
-     * @webref math:random
-     * @param x x-coordinate in noise space
-     * @param y y-coordinate in noise space
-     * @param z z-coordinate in noise space
-     * @see PApplet#noiseSeed(long)
-     * @see PApplet#noiseDetail(int, float)
-     * @see PApplet#random(float,float)
-     */
-    public float noise(float x, float y, float z) {
-        return noiseGenerator.noise(x, y, z);
-    }
-
-
-
-    // [toxi 040903]
-    // make perlin noise quality user controlled to allow
-    // for different levels of detail. lower values will produce
-    // smoother results as higher octaves are surpressed
-    /**
-     * ( begin auto-generated from noiseDetail.xml )
-     *
-     * Adjusts the character and level of detail produced by the Perlin noise
-     * function. Similar to harmonics in physics, noise is computed over several
-     * octaves. Lower octaves contribute more to the output signal and as such
-     * define the overal intensity of the noise, whereas higher octaves create
-     * finer grained details in the noise sequence. By default, noise is
-     * computed over 4 octaves with each octave contributing exactly half than
-     * its predecessor, starting at 50% strength for the 1st octave. This
-     * falloff amount can be changed by adding an additional function parameter.
-     * Eg. a falloff factor of 0.75 means each octave will now have 75% impact
-     * (25% less) of the previous lower octave. Any value between 0.0 and 1.0 is
-     * valid, however note that values greater than 0.5 might result in greater
-     * than 1.0 values returned by <b>noise()</b>.<br
-     * />By changing these parameters, the signal created by the <b>noise()</b>
-     * function can be adapted to fit very specific needs and characteristics.
-     *
-     * ( end auto-generated )
-     *
-     * @webref math:random
-     * @param lod number of octaves to be used by the noise
-     * @see PApplet#noise(float, float, float)
+    // public final void randomSeed(long seed) {
+    //     if (internalRandom == null) {
+    //         internalRandom = new Random();
+    //     }
+    //     internalRandom.setSeed(seed);
+    // }
+    //
+    // public void noiseMode(NoiseMode mode) {
+    //     noiseGenerator.noiseMode(mode);
+    // }
+    //
+    // /**
+    //  * @param x
+    //  * @return
+    //  */
+    // public float noise(float x) {
+    //     return noiseGenerator.noise(x);
+    // }
+    //
+    //  /**
+    //  * @param x
+    //  * @param y
+    //  * @return
+    //  */
+    // public float noise(float x, float y) {
+    //     return noiseGenerator.noise(x, y);
+    // }
+    //
+    // /**
+    //  * ( begin auto-generated from noise.xml )
+    //  *
+    //  * Returns the Perlin noise value at specified coordinates. Perlin noise is
+    //  * a random sequence generator producing a more natural ordered, harmonic
+    //  * succession of numbers compared to the standard <b>random()</b> function.
+    //  * It was invented by Ken Perlin in the 1980s and been used since in
+    //  * graphical applications to produce procedural textures, natural motion,
+    //  * shapes, terrains etc. The main difference to the
+    //  * <b>random()</b> function is that Perlin noise is defined in an infinite
+    //  * n-dimensional space where each pair of coordinates corresponds to a fixed
+    //  * semi-random value (fixed only for the lifespan of the program). The
+    //  * resulting value will always be between 0.0 and 1.0. Processing can
+    //  * compute 1D, 2D and 3D noise, depending on the number of coordinates
+    //  * given. The noise value can be animated by moving through the noise space
+    //  * as demonstrated in the example above. The 2nd and 3rd dimension can also
+    //  * be interpreted as time.The actual noise is structured similar to an audio
+    //  * signal, in respect to the function's use of frequencies. Similar to the
+    //  * concept of harmonics in physics, perlin noise is computed over several
+    //  * octaves which are added together for the final result. Another way to
+    //  * adjust the character of the resulting sequence is the scale of the input
+    //  * coordinates. As the function works within an infinite space the value of
+    //  * the coordinates doesn't matter as such, only the distance between
+    //  * successive coordinates does (eg. when using <b>noise()</b> within a
+    //  * loop). As a general rule the smaller the difference between coordinates,
+    //  * the smoother the resulting noise sequence will be. Steps of 0.005-0.03
+    //  * work best for most applications, but this will differ depending on use.
+    //  *
+    //  * ( end auto-generated )
+    //  *
+    //  * @webref math:random
+    //  * @param x x-coordinate in noise space
+    //  * @param y y-coordinate in noise space
+    //  * @param z z-coordinate in noise space
+    //  */
+    // public float noise(float x, float y, float z) {
+    //     return noiseGenerator.noise(x, y, z);
+    // }
+    // /**
+    //  * 4D noise where typically w is time
+    //  * @param x
+    //  * @param y
+    //  * @param z
+    //  * @param w
+    //  * @return
+    //  */
+    // public float noise(float x, float y, float z, float w) {
+    //     return noiseGenerator.noise(x, y, z, w);
+    // }
+
+    /**
+     *
+     * @param lod
+     * @deprecated
      */
+    @Deprecated
     public void noiseDetail(int lod) {
-        noiseGenerator.noiseDetail(lod);
     }
 
     /**
-     * @see #noiseDetail(int)
-     * @param falloff falloff factor for each octave
+     *
+     * @param lod
+     * @param falloff
+     * @deprecated
      */
+    @Deprecated
     public void noiseDetail(int lod, float falloff) {
-        noiseGenerator.noiseDetail(lod, falloff);
     }
 
     /**
@@ -5029,10 +5038,9 @@ public class PApplet implements PConstants {
      * @see PApplet#random(float,float)
      * @see PApplet#randomSeed(long)
      */
-    
-    public void noiseSeed(long seed) {
-        noiseGenerator.noiseSeed(seed);
-    }
+  //  public void noiseSeed(long seed) {
+  //      noiseGenerator.noiseSeed(seed);
+  //  }
 
     // . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
     /**
@@ -6783,7 +6791,6 @@ public class PApplet implements PConstants {
             return new BufferedOutputStream(output);
 
         } catch (IOException e) {
-            e.printStackTrace();
         }
         return null;
     }
@@ -6860,12 +6867,13 @@ public class PApplet implements PConstants {
                     System.err.println("Could not rename temporary file " + tempFile);
                 }
             }
-            e.printStackTrace();
             return false;
         }
     }
 
     /**
+     * @param target
+     * @param source
      * @nowebref
      */
     static public void saveStream(OutputStream target,
@@ -6975,11 +6983,12 @@ public class PApplet implements PConstants {
                     System.err.println("Could not delete temporary file " + tempFile);
                 }
             }
-            e.printStackTrace();
         }
     }
 
     /**
+     * @param output
+     * @param data
      * @nowebref Spews a buffer of bytes to an OutputStream.
      */
     static public void saveBytes(OutputStream output, byte[] data) {
@@ -6988,7 +6997,6 @@ public class PApplet implements PConstants {
             output.flush();
 
         } catch (IOException e) {
-            e.printStackTrace();
         }
     }
 
@@ -7033,15 +7041,17 @@ public class PApplet implements PConstants {
     }
 
     /**
+     * @param output
+     * @param data
      * @nowebref
      */
     static public void saveStrings(OutputStream output, String[] data) {
-        PrintWriter writer = createWriter(output);
-        for (int i = 0; i < data.length; i++) {
-            writer.println(data[i]);
+        try ( PrintWriter writer = createWriter(output)) {
+            for (String data1 : data) {
+                writer.println(data1);
+            }
+            writer.flush();
         }
-        writer.flush();
-        writer.close();
     }
 
     //////////////////////////////////////////////////////////////
@@ -7133,7 +7143,7 @@ public class PApplet implements PConstants {
      * from a server, or marked in-use if running from a local file system. With
      * this in mind, saving to the data path doesn't make sense anyway. If you
      * know you're running locally, and want to save to the data folder, use
-     * <TT>saveXxxx("data/blah.dat")</TT>.
+     * <code>saveXxxx("data/blah.dat")</code>.
      */
     public String savePath(String where) {
         if (where == null) {
@@ -7421,45 +7431,19 @@ public class PApplet implements PConstants {
         System.arraycopy(src, 0, dst, 0, Array.getLength(src));
     }
 
-    /**
-     * Use arrayCopy() instead.
-     */
-    @Deprecated
-    static public void arraycopy(Object src, int srcPosition,
-            Object dst, int dstPosition,
-            int length) {
-        System.arraycopy(src, srcPosition, dst, dstPosition, length);
-    }
-
-    /**
-     * Use arrayCopy() instead.
-     */
-    @Deprecated
-    static public void arraycopy(Object src, Object dst, int length) {
-        System.arraycopy(src, 0, dst, 0, length);
-    }
-
-    /**
-     * Use arrayCopy() instead.
-     */
-    @Deprecated
-    static public void arraycopy(Object src, Object dst) {
-        System.arraycopy(src, 0, dst, 0, Array.getLength(src));
-    }
-
     /**
      * ( begin auto-generated from expand.xml )
      *
-     * Increases the size of an array. By default, this function doubles the
-     * size of the array, but the optional <b>newSize</b> parameter provides
-     * precise control over the increase in size.
-     *
-     * When using an array of objects, the data returned from the function must
-     * be cast to the object array's data type. For example: <em>SomeClass[]
-     * items = (SomeClass[]) expand(originalArray)</em>.
+     * Increases the size of an array.By default, this function doubles the size
+     * of the array, but the optional <b>newSize</b> parameter provides precise
+     * control over the increase in size. When using an array of objects, the
+     * data returned from the function must be cast to the object array's data
+     * type. For example: <em>SomeClass[] items = (SomeClass[])
+     * expand(originalArray)</em>.
      *
      * ( end auto-generated )
      *
+     * @return
      * @webref data:array_functions
      * @param list the array to expand
      * @see PApplet#shorten(boolean[])
@@ -7469,7 +7453,9 @@ public class PApplet implements PConstants {
     }
 
     /**
+     * @param list
      * @param newSize new size for the array
+     * @return
      */
     static public boolean[] expand(boolean[] list, int newSize) {
         boolean[] temp = new boolean[newSize];
@@ -7549,6 +7535,7 @@ public class PApplet implements PConstants {
     }
 
     /**
+     * @param array
      * @nowebref
      */
     static public Object expand(Object array) {
@@ -9671,6 +9658,7 @@ public class PApplet implements PConstants {
      * All parameters *after* the sketch class name are passed to the sketch
      * itself and available from its 'args' array while the sketch is running.
      *
+     * @param args
      * @see PApplet#args
      * </PRE>
      */
@@ -9681,6 +9669,8 @@ public class PApplet implements PConstants {
     /**
      * Convenience method so that PApplet.main(YourSketch.class) launches a
      * sketch, rather than having to call getName() on it.
+     * @param mainClass
+     * @param args
      */
     static public void main(final Class<?> mainClass, String... args) {
         main(mainClass.getName(), args);
@@ -14628,7 +14618,8 @@ public class PApplet implements PConstants {
      * function is easy to use and undestand, but is slower than another
      * technique. To achieve the same results when working in <b>colorMode(RGB,
      * 255)</b>, but with greater speed, use the &gt;&gt; (right shift) operator
-     * with a bit mask. For example, the following two lines of code are equivalent:
+     * with a bit mask. For example, the following two lines of code are
+     * equivalent:
      * <pre>float r1 = green(myColor);float r2 =
      * myColor &gt;&gt; 8 &amp; 0xFF;</pre>
      *
@@ -14659,7 +14650,7 @@ public class PApplet implements PConstants {
      * technique. To achieve the same results when working in <b>colorMode(RGB,
      * 255)</b>, but with greater speed, use a bit mask to remove the other
      * color components. For example, the following two lines of code are
-   * equivalent:
+     * equivalent:
      * <pre>float r1 = blue(myColor);float r2 = myColor
      * &amp; 0xFF;</pre>
      *