picrate 2.0.0.pre-java → 2.0.1-java

data/pom.rb

@@ -2,7 +2,7 @@
 
 project 'picrate', 'http://maven.apache.org' do
   model_version '4.0.0'
-  id 'ruby-processing:picrate:2.0.0.pre'
+  id 'ruby-processing:picrate:2.0.1'
   packaging 'jar'
 
   description 'An integrated processing-core (somewhat hacked), with additional java code for a jruby version of processing.'
@@ -22,7 +22,7 @@ project 'picrate', 'http://maven.apache.org' do
   license 'LGPL 2', 'https://www.gnu.org/licenses/old-licenses/lgpl-2.1.en.html'
 
   issue_management 'https://github.com/ruby-processing/PiCrate/issues', 'Github'
-
+  # Need to update to jogl 2.4.1 as soon as available, then make a dependency
   properties('jogl.version' => '2.3.2',
              'jruby.api' => 'http://jruby.org/apidocs/',
              'source.directory' => 'src',
@@ -38,21 +38,23 @@ project 'picrate', 'http://maven.apache.org' do
 end
 
 overrides do
-  plugin :resources, '2.7'
-  plugin :dependency, '2.8'
-  plugin(:compiler, '3.8.1', 'release' => '11')
-  plugin(
-    :javadoc,
-    '3.1.1',
-    'detectOfflineLinks' => 'false',
-    'links' => ['${processing.api}', '${jruby.api}']
-  )
-  plugin(
-    :jar, '3.1.2',
-    'archive' => {
-      'manifestEntries' => { 'Class-Path' => 'gluegen-rt.jar jog-all.jar' }
-    }
-  )
+  plugin :resources, '3.1.0'
+  plugin :dependency, '3.1.2'
+  plugin(:compiler, '3.8.1',
+         'release' => '11')
+  plugin(:javadoc, '2.10.4',
+         'detectOfflineLinks' => 'false',
+         'links' => ['${processing.api}',
+                     '${jruby.api}'])
+  plugin(:jar, '3.2.0',
+         'archive' => {
+           'manifestEntries' => {
+             'Class-Path' => 'gluegen-rt.jar jog-all.jar'
+           }
+         })
+  plugin :jdeps, '3.1.2' do
+    execute_goals 'jdkinternals', 'test-jdkinternals'
+  end
 end
 
 build do

data/pom.xml

@@ -11,7 +11,7 @@ DO NOT MODIFIY - GENERATED CODE
   <modelVersion>4.0.0</modelVersion>
   <groupId>ruby-processing</groupId>
   <artifactId>picrate</artifactId>
-  <version>2.0.0.pre</version>
+  <version>2.0.1</version>
   <name>picrate</name>
   <description>An integrated processing-core (somewhat hacked), with additional java code for a jruby version of processing.</description>
   <url>http://maven.apache.org</url>
@@ -119,11 +119,11 @@ DO NOT MODIFIY - GENERATED CODE
       <plugins>
         <plugin>
           <artifactId>maven-resources-plugin</artifactId>
-          <version>2.7</version>
+          <version>3.1.0</version>
         </plugin>
         <plugin>
           <artifactId>maven-dependency-plugin</artifactId>
-          <version>2.8</version>
+          <version>3.1.2</version>
         </plugin>
         <plugin>
           <artifactId>maven-compiler-plugin</artifactId>
@@ -134,7 +134,7 @@ DO NOT MODIFIY - GENERATED CODE
         </plugin>
         <plugin>
           <artifactId>maven-javadoc-plugin</artifactId>
-          <version>3.1.1</version>
+          <version>2.10.4</version>
           <configuration>
             <detectOfflineLinks>false</detectOfflineLinks>
             <links>
@@ -145,7 +145,7 @@ DO NOT MODIFIY - GENERATED CODE
         </plugin>
         <plugin>
           <artifactId>maven-jar-plugin</artifactId>
-          <version>3.1.2</version>
+          <version>3.2.0</version>
           <configuration>
             <archive>
               <manifestEntries>
@@ -154,6 +154,18 @@ DO NOT MODIFIY - GENERATED CODE
             </archive>
           </configuration>
         </plugin>
+        <plugin>
+          <artifactId>maven-jdeps-plugin</artifactId>
+          <version>3.1.2</version>
+          <executions>
+            <execution>
+              <goals>
+                <goal>jdkinternals</goal>
+                <goal>test-jdkinternals</goal>
+              </goals>
+            </execution>
+          </executions>
+        </plugin>
       </plugins>
     </pluginManagement>
   </build>

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

@@ -83,35 +83,35 @@ import processing.opengl.*;
 
 /**
  * Base class for all sketches that use processing.core.
- *
+ * 
  * The
  * <A HREF="https://github.com/processing/processing/wiki/Window-Size-and-Full-Screen">
  * Window Size and Full Screen</A> page on the Wiki has useful information about
  * sizing, multiple displays, full screen, etc.
- *
+ * 
  * Processing uses active mode rendering. All animation tasks happen on the
  * "Processing Animation Thread". The setup() and draw() methods are handled by
  * that thread, and events (like mouse movement and key presses, which are fired
  * by the event dispatch thread or EDT) are queued to be safely handled at the
  * end of draw().
- *
+ * 
  * Starting with 3.0a6, blit operations are on the EDT, so as not to cause GUI
  * problems with Swing and AWT. In the case of the default renderer, the sketch
  * renders to an offscreen image, then the EDT is asked to bring that image to
  * the screen.
- *
+ * 
  * For code that needs to run on the EDT, use EventQueue.invokeLater(). When
  * doing so, be careful to synchronize between that code and the Processing
  * animation thread. That is, you can't call Processing methods from the EDT or
  * at any random time from another thread. Use of a callback function or the
  * registerXxx() methods in PApplet can help ensure that your code doesn't do
  * something naughty.
- *
+ * 
  * As of Processing 3.0, we have removed Applet as the base class for PApplet.
  * This means that we can remove lots of legacy code, however one downside is
  * that it's no longer possible (without extra code) to embed a PApplet into
  * another Java application.
- *
+ * 
  * As of Processing 3.0, we have discontinued support for versions of Java prior
  * to 1.8. We don't have enough people to support it, and for a project of our
  * (tiny) size, we should be focusing on the future, rather than working around
@@ -182,7 +182,7 @@ public class PApplet implements PConstants {
    * if the current screen resolution is 1024x768,
    * <b>displayWidth</b> is 1024 and <b>displayHeight</b> is 768. These
    * dimensions are useful when exporting full-screen applications.
-   *
+   * 
    * To ensure that the sketch takes over the entire screen, use "Present"
    * instead of "Run". Otherwise the window will still have a frame border
    * around it and not be placed in the upper corner of the screen. On Mac OS X,
@@ -199,7 +199,7 @@ public class PApplet implements PConstants {
    * if the current screen resolution is 1024x768,
    * <b>displayWidth</b> is 1024 and <b>displayHeight</b> is 768. These
    * dimensions are useful when exporting full-screen applications.
-   *
+   * 
    * To ensure that the sketch takes over the entire screen, use "Present"
    * instead of "Run". Otherwise the window will still have a frame border
    * around it and not be placed in the upper corner of the screen. On Mac OS X,
@@ -264,7 +264,7 @@ public class PApplet implements PConstants {
    * <b>index</b> value defines the position of a value within the array. For
    * example, the statement <b>color b = pixels[230]</b> will set the variable
    * <b>b</b> to be equal to the value at that location in the array.
-   *
+   * 
    * Before accessing this array, the data must loaded with the
    * <b>loadPixels()</b> function. After the array data has been modified, the
    * <b>updatePixels()</b> function must be run to update the changes. Without
@@ -421,7 +421,7 @@ public class PApplet implements PConstants {
    *
    * The system variable <b>pmouseX</b> always contains the horizontal position
    * of the mouse in the frame previous to the current frame.
-   *
+   * 
    * You may find that <b>pmouseX</b> and <b>pmouseY</b> have different values
    * inside <b>draw()</b> and inside events like <b>mousePressed()</b>
    * and <b>mouseMoved()</b>. This is because they're used for different roles,
@@ -575,7 +575,7 @@ public class PApplet implements PConstants {
    *
    * The system variable <b>key</b> always contains the value of the most recent
    * key on the keyboard that was used (either pressed or released).
-   *
+   *  
    * For non-ASCII keys, use the <b>keyCode</b> variable. The keys included in
    * the ASCII specification (BACKSPACE, TAB, ENTER, RETURN, ESC, and DELETE) do
    * not require checking to see if they key is coded, and you should simply use
@@ -608,7 +608,7 @@ public class PApplet implements PConstants {
    * DOWN, LEFT, RIGHT arrow keys and ALT, CONTROL, SHIFT. When checking for
    * these keys, it's first necessary to check and see if the key is coded. This
    * is done with the conditional "if (key == CODED)" as shown in the example.
-   *
+   *  
    * The keys included in the ASCII specification (BACKSPACE, TAB, ENTER,
    * RETURN, ESC, and DELETE) do not require checking to see if they key is
    * coded, and you should simply use the <b>key</b> variable instead of
@@ -616,7 +616,7 @@ public class PApplet implements PConstants {
    * ENTER key is commonly used on PCs and Unix and the RETURN key is used
    * instead on Macintosh. Check for both ENTER and RETURN to make sure your
    * program will work for all platforms.
-   *
+   *  
    * For users familiar with Java, the values for UP and DOWN are simply shorter
    * versions of Java's KeyEvent.VK_UP and KeyEvent.VK_DOWN. Other keyCode
    * values can be found in the Java <a
@@ -1133,7 +1133,7 @@ public class PApplet implements PConstants {
         return 1;
       } else if (suggestedDensity == 1 || suggestedDensity == 2) {
         return suggestedDensity;
-      }
+      }    
     return 1;
   }
 
@@ -1233,7 +1233,7 @@ public class PApplet implements PConstants {
    * Called by the browser or applet viewer to inform this applet that it should
    * start its execution. It is called after the init method and each time the
    * applet is revisited in a Web page.
-   *
+   * 
    * Called explicitly via the first call to PApplet.paint(), because PAppletGL
    * needs to have a usable screen before getting things rolling.
    */
@@ -1248,7 +1248,7 @@ public class PApplet implements PConstants {
   /**
    * Called by the browser or applet viewer to inform this applet that it should
    * stop its execution.
-   *
+   * 
    * Unfortunately, there are no guarantees from the Java spec when or if stop()
    * will be called (i.e. on browser quit, or when moving between web pages),
    * and it's not always called.
@@ -1304,7 +1304,7 @@ public class PApplet implements PConstants {
 //   * Called by the browser or applet viewer to inform this applet
 //   * that it is being reclaimed and that it should destroy
 //   * any resources that it has allocated.
-//   *
+//   * 
 //   * destroy() supposedly gets called as the applet viewer
 //   * is shutting down the applet. stop() is called
 //   * first, and then destroy() to really get rid of things.
@@ -1831,7 +1831,7 @@ public class PApplet implements PConstants {
    * <b>size()</b> is not used, the default size of the window is 100x100
    * pixels. The system variables <b>width</b> and <b>height</b> are set by the
    * parameters passed to this function.
-   *
+   * 
    * Do not use variables as the parameters to <b>size()</b> function, because
    * it will cause problems when exporting your sketch. When variables are used,
    * the dimensions of your sketch cannot be determined during export. Instead,
@@ -1839,32 +1839,32 @@ public class PApplet implements PConstants {
    * statement, and then use the built-in <b>width</b> and <b>height</b>
    * variables inside your program when the dimensions of the display window are
    * needed.
-   *
+   * 
    * The <b>size()</b> function can only be used once inside a sketch, and
    * cannot be used for resizing.
    *  <b>renderer</b> parameter selects which rendering engine to use. For
    * example, if you will be drawing 3D shapes, use <b>P3D</b>, if you want to
    * export images from a program as a PDF file use <b>PDF</b>. A brief
    * description of the three primary renderers follows:
-   *
+   * 
    * <b>P2D</b> (Processing 2D) - The default renderer that supports two
    * dimensional drawing.
-   *
+   * 
    * <b>P3D</b> (Processing 3D) - 3D graphics renderer that makes use of
    * OpenGL-compatible graphics hardware.
-   *
+   * 
    * <b>PDF</b> - The PDF renderer draws 2D graphics directly to an Acrobat PDF
    * file. This produces excellent results when you need vector shapes for high
    * resolution output or printing. You must first use Import Library &rarr; PDF
    * to make use of the library. More information can be found in the PDF
    * library reference.
-   *
+   * 
    * The P3D renderer doesn't support <b>strokeCap()</b> or
    * <b>strokeJoin()</b>, which can lead to ugly results when using
    * <b>strokeWeight()</b>. (<a
    * href="http://code.google.com/p/processing/issues/detail?id=123">Issue
-   * 123</a>)
-   *
+   * 123</a>) 
+   * 
    * The maximum width and height is limited by your operating system, and is
    * usually the width and height of your actual screen. On some machines it may
    * simply be the number of pixels on your current screen, meaning that a
@@ -1873,7 +1873,7 @@ public class PApplet implements PConstants {
    * rendering modes and sizes until you get what you're looking for. If you
    * need something larger, use <b>createGraphics</b> to create a non-visible
    * drawing surface.
-   *
+   * 
    * Again, the <b>size()</b> function must be the first line of the code (or
    * first item inside setup). Any code that appears before the <b>size()</b>
    * command may run more than once, which can lead to confusing results.
@@ -2019,7 +2019,7 @@ public class PApplet implements PConstants {
    * 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>
    * and <b>endDraw()</b> statements. This is also true for any functions that
    * affect drawing, such as <b>smooth()</b> or <b>colorMode()</b>.
@@ -2236,10 +2236,10 @@ public class PApplet implements PConstants {
    * <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.
-   *
+   *  
    * Be sure to include all three parameters, specifying only the width and
    * height (but no format) will produce a strange error.
-   *
+   *  
    * Advanced users please note that createImage() should be used instead of the
    * syntax <tt>new PImage()</tt>.
    *
@@ -2468,7 +2468,7 @@ public class PApplet implements PConstants {
    * <b>draw()</b>. If <b>loop()</b> is called, the code in <b>draw()</b>
    * begin to run continuously again. If using <b>noLoop()</b> in
    * <b>setup()</b>, it should be the last line inside the block.
-   *
+   *  
    * When <b>noLoop()</b> is used, it's not possible to manipulate or access the
    * screen inside event handling functions such as <b>mousePressed()</b>
    * or <b>keyPressed()</b>. Instead, use those functions to call
@@ -2476,7 +2476,7 @@ public class PApplet implements PConstants {
    * update the screen properly. This means that when noLoop() has been called,
    * no drawing can happen, and functions like saveFrame() or loadPixels() may
    * not be used.
-   *
+   *  
    * Note that if the sketch is resized, <b>redraw()</b> will be called to
    * update the sketch, even after <b>noLoop()</b> has been specified.
    * Otherwise, the sketch would enter an odd state until <b>loop()</b> was
@@ -2885,7 +2885,7 @@ public class PApplet implements PConstants {
    *
    * The <b>keyPressed()</b> function is called once every time a key is
    * pressed. The key that was pressed is stored in the <b>key</b> variable.
-   *
+   *  
    * For non-ASCII keys, use the <b>keyCode</b> variable. The keys included in
    * the ASCII specification (BACKSPACE, TAB, ENTER, RETURN, ESC, and DELETE) do
    * not require checking to see if they key is coded, and you should simply use
@@ -2893,7 +2893,7 @@ public class PApplet implements PConstants {
    * cross-platform projects, note that the ENTER key is commonly used on PCs
    * and Unix and the RETURN key is used instead on Macintosh. Check for both
    * ENTER and RETURN to make sure your program will work for all platforms.
-   *
+   *  
    * Because of how operating systems handle key repeats, holding down a key may
    * cause multiple calls to keyPressed() (and keyReleased() as well). The rate
    * of repeat is set by the operating system and how each computer is
@@ -3276,22 +3276,22 @@ public class PApplet implements PConstants {
    * 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 element.
-   *
+   *  
    * If args is a String (not an array), then it can only be a single file or
    * application with no parameters. It's not the same as executing that String
    * using a shell. For instance, launch("javac -help") will not work properly.
-   *
+   *  
    * This function behaves differently on each platform. On Windows, the
    * parameters are sent to the Windows shell via "cmd /c". On Mac OS X, the
    * "open" command is used (type "man open" in Terminal.app for documentation).
    * On Linux, it first tries gnome-open, then kde-open, but if neither are
    * available, it sends the command to the shell without any alterations.
-   *
+   *  
    * For users familiar with Java, this is not quite the same as Runtime.exec(),
    * because the launcher command is prepended. Instead, the
    * <b>exec(String[])</b> function is a shortcut for
@@ -3553,11 +3553,11 @@ public class PApplet implements PConstants {
    * exit automatically after the last line has run, but programs with
    * <b>draw()</b> run continuously until the program is manually stopped or
    * <b>exit()</b> is run.
-   *
+   * 
    * Rather than terminating immediately, <b>exit()</b> will cause the sketch to
    * exit after <b>draw()</b> has completed (or after <b>setup()</b>
    * completes if called during the <b>setup()</b> function).
-   *
+   * 
    * For Java programmers, this is <em>not</em> the same as System.exit().
    * Further, System.exit() should not be used because closing out an
    * application while <b>draw()</b> is running may cause a crash (particularly
@@ -3634,7 +3634,7 @@ public class PApplet implements PConstants {
   //////////////////////////////////////////////////////////////
   /**
    * Call a method in the current class based on its name.
-   *
+   * 
    * Note that the function being called must be public. Inside the PDE,
    * 'public' is automatically added, but when used without the preprocessor,
    * (like from Eclipse) you'll have to do it yourself.
@@ -3662,7 +3662,7 @@ public class PApplet implements PConstants {
    * Launch a new thread and call the specified function from that new thread.
    * This is a very simple way to do a thread without needing to get into
    * classes, runnables, etc.
-   *
+   * 
    * Note that the function being called must be public. Inside the PDE,
    * 'public' is automatically added, but when used without the preprocessor,
    * (like from Eclipse) you'll have to do it yourself.
@@ -3738,7 +3738,7 @@ public class PApplet implements PConstants {
    * and made into movies. These files are saved to the sketch's folder, which
    * may be opened by selecting "Show sketch folder" from the "Sketch"
    * menu.
-   *
+   * 
    * It is not possible to use saveXxxxx() functions inside a web browser unless
    * the sketch is <a
    * href="http://wiki.processing.org/w/Sign_an_Applet">signed applet</A>. To
@@ -3816,7 +3816,7 @@ public class PApplet implements PConstants {
    * load an image as the cursor if you are exporting your program for the Web
    * and not all MODES work with all Web browsers. The values for parameters
    * <b>x</b> and <b>y</b> must be less than the dimensions of the image.
-   *
+   *  
    * Setting or hiding the cursor generally does not work with "Present" mode
    * (when running full-screen).
    *
@@ -3875,14 +3875,14 @@ public class PApplet implements PConstants {
    * function <b>println()</b> works like <b>print()</b>, but creates a new line
    * of text for each call to the function. Individual elements can be separated
    * with quotes ("") and joined with the addition operator (+).
-   *
+   * 
    * Beginning with release 0125, to print the contents of an array, use
    * println(). There's no sensible way to do a <b>print()</b> of an array,
    * because there are too many possibilities for how to separate the data
    * (spaces, commas, etc). If you want to print an array as a single line, use
    * <b>join()</b>. With <b>join()</b>, you can choose any delimiter you like
    * and <b>print()</b> the result.
-   *
+   * 
    * Using <b>print()</b> on an object will output <b>null</b>, a memory
    * location that may look like "@10be08," or the result of the
    * <b>toString()</b> method from the object that's being printed. Advanced
@@ -4799,9 +4799,9 @@ public class PApplet implements PConstants {
    * ( begin auto-generated from norm.xml )
    *
    * Normalizes a number from another range into a value between 0 and 1.
-   *
+   *  
    * Identical to map(value, low, high, 0, 1);
-   *
+   *  
    * Numbers outside the range are not clamped to 0 and 1, because out-of-range
    * values are often intentional and useful.
    *
@@ -4824,7 +4824,7 @@ public class PApplet implements PConstants {
    * Re-maps a number from one range to another. In the example above, the
    * number '25' is converted from a value in the range 0..100 into a value that
    * ranges from the left edge (0) to the right edge (width) of the screen.
-   *
+   *  
    * Numbers outside the range are not clamped to 0 and 1, because out-of-range
    * values are often intentional and useful.
    *
@@ -6071,18 +6071,18 @@ public class PApplet implements PConstants {
    * font to use with Processing, select "Create Font..." from the Tools menu.
    * This will create a font in the format Processing requires and also adds it
    * to the current sketch's data directory.
-   *
+   * 
    * Like <b>loadImage()</b> and other functions that load data, the
    * <b>loadFont()</b> function should not be used inside <b>draw()</b>, because
    * it will slow down the sketch considerably, as the font will be re-loaded
    * from the disk (or network) on each frame.
-   *
+   * 
    * For most renderers, Processing displays fonts using the .vlw font format,
    * which uses images for each letter, rather than defining them through vector
    * data. When <b>hint(ENABLE_NATIVE_FONTS)</b> is used with the JAVA2D
    * renderer, the native version of a font will be used if it is installed on
    * the user's machine.
-   *
+   * 
    * Using <b>createFont()</b> (instead of loadFont) enables vector data to be
    * used with the JAVA2D (default) renderer setting. This can be helpful when
    * many font sizes are needed, or when using any renderer based on JAVA2D,
@@ -6128,7 +6128,7 @@ public class PApplet implements PConstants {
    * inside the sketches "data" folder. This function is an advanced feature for
    * precise control. On most occasions you should create fonts through
    * selecting "Create Font..." from the Tools menu.
-   *
+   * 
    * Use the <b>PFont.list()</b> method to first determine the names for the
    * fonts recognized by the computer and are compatible with this function.
    * Because of limitations in Java, not all fonts can be used and some might
@@ -6137,12 +6137,12 @@ public class PApplet implements PConstants {
    * .otf version of your font in the data directory of the sketch because other
    * people might not have the font installed on their computer. Only fonts that
    * can legally be distributed should be included with a sketch.
-   *
+   * 
    * The <b>size</b> parameter states the font size you want to generate. The
    * <b>smooth</b> parameter specifies if the font should be antialiased or not,
    * and the <b>charset</b> parameter is an array of chars that specifies the
    * characters to generate.
-   *
+   * 
    * This function creates a bitmapped version of a font in the same manner as
    * the Create Font tool. It loads a font by name, and converts it to a series
    * of images based on the size of the font. When possible, the
@@ -6308,27 +6308,27 @@ public class PApplet implements PConstants {
     final PApplet sketch) {
     EventQueue.invokeLater(() -> {
       File selectedFile = null;
-
+      
 //      boolean hide = (sketch != null)
 //              && (sketch.g instanceof PGraphicsOpenGL) && (platform == WINDOWS);
 //      if (hide) {
 //        sketch.surface.setVisible(false);
 //      }
-
+      
       if (useNativeSelect) {
         FileDialog dialog = new FileDialog(parentFrame, prompt, mode);
         if (defaultSelection != null) {
           dialog.setDirectory(defaultSelection.getParent());
           dialog.setFile(defaultSelection.getName());
         }
-
+        
         dialog.setVisible(true);
         String directory = dialog.getDirectory();
         String filename = dialog.getFile();
         if (filename != null) {
           selectedFile = new File(directory, filename);
         }
-
+        
       } else {
         JFileChooser chooser = new JFileChooser();
         chooser.setDialogTitle(prompt);
@@ -6346,7 +6346,7 @@ public class PApplet implements PConstants {
           selectedFile = chooser.getSelectedFile();
         }
       }
-
+      
 //      if (hide) {
 //        sketch.surface.setVisible(true);
 //      }
@@ -6392,13 +6392,13 @@ public class PApplet implements PConstants {
     final PApplet sketch) {
     EventQueue.invokeLater(() -> {
       File selectedFile = null;
-
+      
 //      boolean hide = (sketch != null)
 //              && (sketch.g instanceof PGraphicsOpenGL) && (platform == WINDOWS);
 //      if (hide) {
 //        sketch.surface.setVisible(false);
 //      }
-
+      
       checkLookAndFeel();
       JFileChooser fileChooser = new JFileChooser();
       fileChooser.setDialogTitle(prompt);
@@ -6406,15 +6406,15 @@ public class PApplet implements PConstants {
       if (defaultSelection != null) {
         fileChooser.setCurrentDirectory(defaultSelection);
       }
-
+      
       int result = fileChooser.showOpenDialog(parentFrame);
       if (result == JFileChooser.APPROVE_OPTION) {
         selectedFile = fileChooser.getSelectedFile();
       }
-
-
+      
+      
 //      if (hide) sketch.surface.setVisible (
-//
+//              
 //              true);
       selectCallback(selectedFile, callbackMethod, callbackObject);
     });
@@ -6429,7 +6429,7 @@ public class PApplet implements PConstants {
       Method selectMethod =
         callbackClass.getMethod(callbackMethod, new Class[] { File
 
-.class
+.class 
 });
       selectMethod.invoke(callbackObject, new Object[] { selectedFile });
 
@@ -6607,7 +6607,7 @@ public class PApplet implements PConstants {
    * Creates a <b>BufferedReader</b> object that can be used to read files
    * line-by-line as individual <b>String</b> objects. This is the complement
    * to the <b>createWriter()</b> function.
-   *
+   *  
    * Starting with Processing release 0134, all files loaded and saved by the
    * Processing API use UTF-8 encoding. In previous releases, the default
    * encoding for your platform was used, which causes problems when files
@@ -6682,7 +6682,7 @@ public class PApplet implements PConstants {
    * to write to it. For the file to be made correctly, it should be flushed
    * and must be closed with its <b>flush()</b> and <b>close()</b> methods
    * (see above example).
-   *
+   *  
    * Starting with Processing release 0134, all files loaded and saved by the
    * Processing API use UTF-8 encoding. In previous releases, the default
    * encoding for your platform was used, which causes problems when files
@@ -6751,13 +6751,13 @@ public class PApplet implements PConstants {
    * easily open files from the data folder or from a URL, but want an
    * InputStream object so that you can use other parts of Java to take more
    * control of how the stream is read.
-   *
+   * 
    * The filename passed in can be:
    * - A URL, for instance <b>openStream("http://processing.org/")</b>
    * - A file in the sketch's <b>data</b> folder
    * - The full path to a file to be opened locally (when running as an
    * application)
-   *
+   * 
    * If the requested item doesn't exist, null is returned. If not online,
    * this will also check to see if the user is asking for a file whose name
    * isn't properly capitalized. If capitalization is different, an error
@@ -6765,13 +6765,13 @@ public class PApplet implements PConstants {
    * when a sketch is exported to the web, where case sensitivity matters, as
    * opposed to running from inside the Processing Development Environment on
    * Windows or Mac OS, where case sensitivity is preserved but ignored.
-   *
+   * 
    * If the file ends with <b>.gz</b>, the stream will automatically be gzip
    * decompressed. If you don't want the automatic decompression, use the
    * related function <b>createInputRaw()</b>.
-   *
+   * 
    * In earlier releases, this function was called <b>openStream()</b>.
-   *
+   * 
    *
    * ( end auto-generated )
    *
@@ -7025,7 +7025,7 @@ public class PApplet implements PConstants {
    * Reads the contents of a file or url and places it in a byte array. If a
    * file is specified, it must be located in the sketch's "data"
    * directory/folder.
-   *
+   * 
    * The filename parameter can also be a URL to a file found online. For
    * security reasons, a Processing sketch found online can only download
    * files from the same server from which it came. Getting around this
@@ -7232,19 +7232,19 @@ public class PApplet implements PConstants {
    * Reads the contents of a file or url and creates a String array of its
    * individual lines. If a file is specified, it must be located in the
    * sketch's "data" directory/folder.
-   *
+   * 
    * The filename parameter can also be a URL to a file found online. For
    * security reasons, a Processing sketch found online can only download
    * files from the same server from which it came. Getting around this
    * restriction requires a <a
    * href="http://wiki.processing.org/w/Sign_an_Applet">signed applet</a>.
-   *
+   * 
    * If the file is not available or an error occurs, <b>null</b> will be
    * returned and an error message will be printed to the console. The error
    * message does not halt the program, however the null value may cause a
    * NullPointerException if your code does not check whether the value
    * returned is null.
-   *
+   *  
    * Starting with Processing release 0134, all files loaded and saved by the
    * Processing API use UTF-8 encoding. In previous releases, the default
    * encoding for your platform was used, which causes problems when files
@@ -7329,7 +7329,7 @@ public class PApplet implements PConstants {
 
     } catch (IOException e) {
       //throw new RuntimeException("Error inside loadStrings()");
-
+      
     }
     return null;
   }
@@ -7347,16 +7347,16 @@ public class PApplet implements PConstants {
    * Similar to <b>createInput()</b>, this creates a Java <b>OutputStream</b>
    * for a given filename or path. The file will be created in the sketch
    * folder, or in the same folder as an exported application.
-   *
+   * 
    * If the path does not exist, intermediate folders will be created. If an
    * exception occurs, it will be printed to the console, and <b>null</b>
    * will be returned.
-   *
+   * 
    * This function is a convenience over the Java approach that requires you
    * to 1) create a FileOutputStream object, 2) determine the exact file
    * location, and 3) handle exceptions. Exceptions are handled internally by
    * the function, which is more appropriate for "sketch" projects.
-   *
+   * 
    * If the output filename ends with <b>.gz</b>, the output will be
    * automatically GZIP compressed as it is written.
    *
@@ -7394,7 +7394,7 @@ public class PApplet implements PConstants {
    * Save the contents of a stream to a file in the sketch folder. This is
    * basically <b>saveBytes(blah, loadBytes())</b>, but done more efficiently
    * (and with less confusing syntax).
-   *
+   * 
    * When using the <b>targetFile</b> parameter, it writes to a <b>File</b>
    * object for greater control over the file location. (Note that unlike
    * some other functions, this will not automatically compress or uncompress
@@ -7414,7 +7414,7 @@ public class PApplet implements PConstants {
   /**
    * Identical to the other saveStream(), but writes to a File
    * object, for greater control over the file location.
-   *
+   * 
    * Note that unlike other api methods, this will not automatically
    * compress or uncompress gzip files.
    */
@@ -7488,7 +7488,7 @@ public class PApplet implements PConstants {
    * file. The data is saved in binary format. This file is saved to the
    * sketch's folder, which is opened by selecting "Show sketch folder" from
    * the "Sketch" menu.
-   *
+   * 
    * It is not possible to use saveXxxxx() functions inside a web browser
    * unless the sketch is <a
    * href="http://wiki.processing.org/w/Sign_an_Applet">signed applet</A>. To
@@ -7596,7 +7596,7 @@ public class PApplet implements PConstants {
    * Writes an array of strings to a file, one line per string. This file is
    * saved to the sketch's folder, which is opened by selecting "Show sketch
    * folder" from the "Sketch" menu.
-   *
+   * 
    * It is not possible to use saveXxxxx() functions inside a web browser
    * unless the sketch is <a
    * href="http://wiki.processing.org/w/Sign_an_Applet">signed applet</A>. To
@@ -7657,7 +7657,7 @@ public class PApplet implements PConstants {
       URL jarURL =
           PApplet
 
-.class
+.class  
 
 
 .getProtectionDomain().getCodeSource().getLocation();
@@ -7698,11 +7698,11 @@ public class PApplet implements PConstants {
    * Prepend the sketch folder path to the filename (or path) that is
    * passed in. External libraries should use this function to save to
    * the sketch folder.
-   *
+   * 
    * Note that when running as an applet inside a web browser,
    * the sketchPath will be set to null, because security restrictions
    * prevent applets from accessing that information.
-   *
+   * 
    * This will also cause an error if the sketch is not inited properly,
    * meaning that init() was never called on the PApplet when hosted
    * my some other main() or by other code. For proper use of init(),
@@ -7731,7 +7731,7 @@ public class PApplet implements PConstants {
   /**
    * Returns a path inside the applet folder to save to. Like sketchPath(),
    * but creates any in-between folders so that things save properly.
-   *
+   * 
    * All saveXxxx() functions use the path to the sketch folder, rather than
    * its data folder. Once exported, the data folder will be found inside the
    * jar file of the exported application or applet. In this case, it's not
@@ -7766,7 +7766,7 @@ public class PApplet implements PConstants {
       desktopFolder = new File(System.getProperty("user.home"), "Desktop");
       if (!desktopFolder.exists()) {
         throw new UnsupportedOperationException("Could not find a suitable desktop foldder");
-      }
+      }      
     }
     return new File(desktopFolder, what);
   }
@@ -8080,7 +8080,7 @@ public class PApplet implements PConstants {
    * 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>.
@@ -8200,7 +8200,7 @@ public class PApplet implements PConstants {
    * Expands an array by one element and adds data to the new position. The
    * datatype of the <b>element</b> parameter must be the same as the
    * datatype of the array.
-   *
+   *  
    * 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[]) append(originalArray, element)</em>.
@@ -8255,7 +8255,7 @@ public class PApplet implements PConstants {
    * ( begin auto-generated from shorten.xml )
    *
    * Decreases an array by one element and returns the shortened array.
-   *
+   *  
    * 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[]) shorten(originalArray)</em>.
@@ -8304,7 +8304,7 @@ public class PApplet implements PConstants {
    * parameters must be of the same datatype. The <b>array</b> parameter
    * defines the array which will be modified and the second parameter
    * defines the data which will be inserted.
-   *
+   *  
    * 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[]) splice(array1, array2, index)</em>.
@@ -8476,7 +8476,7 @@ public class PApplet implements PConstants {
    * from the <b>offset</b> to the end of the array. When specifying the
    * <b>offset</b> remember the first array element is 0. This function does
    * not change the source array.
-   *
+   *  
    * 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[]) subset(originalArray, 0, 4)</em>.
@@ -8599,7 +8599,7 @@ public class PApplet implements PConstants {
    * Concatenates two arrays. For example, concatenating the array { 1, 2, 3
    * } and the array { 4, 5, 6 } yields { 1, 2, 3, 4, 5, 6 }. Both parameters
    * must be arrays of the same datatype.
-   *
+   *  
    * 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[]) concat(array1, array2)</em>.
@@ -8828,7 +8828,7 @@ public class PApplet implements PConstants {
    * The splitTokens() function splits a String at one or many character
    * "tokens." The <b>tokens</b> parameter specifies the character or
    * characters to be used as a boundary.
-   *
+   *  
    * If no <b>tokens</b> character is specified, any whitespace character is
    * used to split. Whitespace characters include tab (\\t), line feed (\\n),
    * carriage return (\\r), form feed (\\f), and space. To convert a String
@@ -8862,11 +8862,11 @@ public class PApplet implements PConstants {
    * string as the divider. The <b>delim</b> parameter specifies the
    * character or characters that mark the boundaries between each piece. A
    * String[] array is returned that contains each of the pieces.
-   *
+   *  
    * If the result is a set of numbers, you can convert the String[] array to
    * to a float[] or int[] array using the datatype conversion functions
    * <b>int()</b> and <b>float()</b> (see example above).
-   *
+   *  
    * The <b>splitTokens()</b> function works in a similar fashion, except
    * that it splits using a range of characters instead of a specific
    * character or sequence.
@@ -8976,7 +8976,7 @@ public class PApplet implements PConstants {
    * a String array. No match will return null. If no groups are specified in
    * the regexp, but the sequence matches, an array of length one (with the
    * matched text as the first element of the array) will be returned.
-   *
+   * 
    * To use the function, first check to see if the result is null. If the
    * result is null, then the sequence did not match. If the sequence did
    * match, an array is returned.
@@ -8985,7 +8985,7 @@ public class PApplet implements PConstants {
    * Element [0] of a regexp match returns the entire matching string, and
    * the match groups start at element [1] (the first group is [1], the
    * second [2], and so on).
-   *
+   * 
    * The syntax can be found in the reference for Java's <a
    * href="http://download.oracle.com/javase/6/docs/api/">Pattern</a> class.
    * For regular expression syntax, read the <a
@@ -9026,7 +9026,7 @@ public class PApplet implements PConstants {
    * groups are specified in the regexp, but the sequence matches, a two
    * dimensional array is still returned, but the second dimension is only of
    * length one.
-   *
+   * 
    * To use the function, first check to see if the result is null. If the
    * result is null, then the sequence did not match at all. If the sequence
    * did match, a 2D array is returned. If there are groups (specified by
@@ -9036,7 +9036,7 @@ public class PApplet implements PConstants {
    * match returns the entire matching string, and the match groups start at
    * element [i][1] (the first group is [i][1], the second [i][2], and so
    * on).
-   *
+   * 
    * The syntax can be found in the reference for Java's <a
    * href="http://download.oracle.com/javase/6/docs/api/">Pattern</a> class.
    * For regular expression syntax, read the <a
@@ -9661,7 +9661,7 @@ public class PApplet implements PConstants {
    * appropriate commas to mark units of 1000. There are two versions, one
    * for formatting ints and one for formatting an array of ints. The value
    * for the <b>digits</b> parameter should always be a positive integer.
-   *
+   * 
    * For a non-US locale, this will insert periods instead of commas, or
    * whatever is apprioriate for that region.
    *
@@ -9901,7 +9901,7 @@ public class PApplet implements PConstants {
    * equivalent hexadecimal notation. For example color(0, 102, 153) will
    * convert to the String "FF006699". This function can help make your geeky
    * debugging sessions much happier.
-   *
+   *  
    * Note that the maximum number of digits is 8, because an int value can
    * only represent up to 32 bits. Specifying more than eight digits will
    * simply shorten the string to eight anyway.
@@ -10002,7 +10002,7 @@ public class PApplet implements PConstants {
    * equivalent binary notation. For example color(0, 102, 153, 255) will
    * convert to the String "11111111000000000110011010011001". This function
    * can help make your geeky debugging sessions much happier.
-   *
+   *  
    * Note that the maximum number of digits is 32, because an int value can
    * only represent up to 32 bits. Specifying more than 32 digits will simply
    * shorten the string to 32 anyway.
@@ -10502,7 +10502,7 @@ public class PApplet implements PConstants {
         switch (args[argIndex]) {
           case ARGS_PRESENT:
             present = true;
-
+            
 //        } else if (args[argIndex].equals(ARGS_SPAN_DISPLAYS)) {
 //          spanDisplays = true;
             break;
@@ -10556,12 +10556,12 @@ public class PApplet implements PConstants {
         Method method =
           thinkDifferent.getMethod("init", new Class[] { PApplet
 
-.class
+.class 
 });
         method.invoke(null, new Object[] { sketch });
       } catch (ClassNotFoundException | IllegalAccessException | IllegalArgumentException | NoSuchMethodException | SecurityException | InvocationTargetException e) {
         // That's unfortunate
-
+        
       }
     }
 
@@ -10705,8 +10705,8 @@ public class PApplet implements PConstants {
 
         @Override
   public void setUndecorated(boolean ignored) {
-          throw new RuntimeException("'frame' has been removed from PiCrate 2.0, " +
-            "use full_screen to get an undecorated full screen frame");
+          throw new RuntimeException("'frame' has been removed from Processing 3, " +
+            "use fullScreen() to get an undecorated full screen frame");
         }
 
         // Can't override this one because it's called by Window's constructor
@@ -10725,14 +10725,14 @@ public class PApplet implements PConstants {
         }
 
         private void deprecationWarning(String method) {
-          PGraphics.showWarning("Use surface." + method + " instead of " +
-                                "frame." + method + " in PiCrate 2.0");
+          PGraphics.showWarning("Use surface." + method + "() instead of " +
+                                "frame." + method + " in Processing 3");
           //new Exception(method).printStackTrace(System.out);
         }
       };
 
       surface.initFrame(this); //, backgroundColor, displayNum, fullScreen, spanDisplays);
-      surface.setTitle("PiCrate 2.0 Sketch");
+      surface.setTitle("Picrate 1.2 Sketch");
 
     } else {
       surface.initOffscreen(this);  // for PDF/PSurfaceNone and friends
@@ -10817,7 +10817,7 @@ public class PApplet implements PConstants {
    * requires two parameters, the first is the renderer and the second is the
    * file name. This function is always used with <b>endRecord()</b> to stop
    * the recording process and close the file.
-   *
+   *  
    * Note that beginRecord() will only pick up any settings that happen after
    * it has been called. For instance, if you call textFont() before
    * beginRecord(), then that font will not be set for the file that you're
@@ -10878,21 +10878,21 @@ public class PApplet implements PConstants {
    * hundreds of triangles, rather than a single object. Or that a
    * multi-segment line shape (such as a curve) will be rendered as
    * individual segments.
-   *
+   * 
    * When using <b>beginRaw()</b> and <b>endRaw()</b>, it's possible to write
    * to either a 2D or 3D renderer. For instance, <b>beginRaw()</b> with the
    * PDF library will write the geometry as flattened triangles and lines,
    * even if recording from the <b>P3D</b> renderer.
-   *
+   * 
    * If you want a background to show up in your files, use <b>rect(0, 0,
    * width, height)</b> after setting the <b>fill()</b> to the background
    * color. Otherwise the background will not be rendered to the file because
    * the background is not shape.
-   *
+   * 
    * Using <b>hint(ENABLE_DEPTH_SORT)</b> can improve the appearance of 3D
    * geometry drawn to 2D file formats. See the <b>hint()</b> reference for
    * more details.
-   *
+   * 
    * See examples in the reference for the <b>PDF</b> and <b>DXF</b>
    * libraries for more information.
    *
@@ -11000,7 +11000,7 @@ public class PApplet implements PConstants {
    * <b>updatePixels()</b>. Even if the renderer may not seem to use this
    * function in the current Processing release, this will always be subject
    * to change.
-   *
+   *  
    * Currently, none of the renderers use the additional parameters to
    * <b>updatePixels()</b>, however this may be implemented in the future.
    *
@@ -11082,12 +11082,12 @@ public class PApplet implements PConstants {
    * specifies a position in 2D and the <b>vertex()</b> function with three
    * parameters specifies a position in 3D. Each shape will be outlined with
    * the current stroke color and filled with the fill color.
-   *
+   *  
    * Transformations such as <b>translate()</b>, <b>rotate()</b>, and
    * <b>scale()</b> do not work within <b>beginShape()</b>. It is also not
    * possible to use other shapes, such as <b>ellipse()</b> or <b>rect()</b>
    * within <b>beginShape()</b>.
-   *
+   *  
    * The P3D renderer settings allow <b>stroke()</b> and <b>fill()</b>
    * settings to be altered per-vertex, however the default P2D renderer does
    * not. Settings such as <b>strokeWeight()</b>, <b>strokeCap()</b>, and
@@ -11227,7 +11227,7 @@ public class PApplet implements PConstants {
    * Sets a texture to be applied to vertex points. The <b>texture()</b>
    * function must be called between <b>beginShape()</b> and
    * <b>endShape()</b> and before any calls to <b>vertex()</b>.
-   *
+   *  
    * When textures are in use, the fill color is ignored. Instead, use tint()
    * to specify the color of the texture as it is applied to the shape.
    *
@@ -11293,10 +11293,10 @@ public class PApplet implements PConstants {
    * <b>vertex()</b> is used to specify the vertex coordinates for points,
    * lines, triangles, quads, and polygons and is used exclusively within the
    * <b>beginShape()</b> and <b>endShape()</b> function.
-   *
+   * 
    * Drawing a vertex in 3D using the <b>z</b> parameter requires the P3D
    * parameter in combination with size as shown in the above example.
-   *
+   * 
    * This function is also used to map a texture onto the geometry. The
    * <b>texture()</b> function declares the texture to apply to the geometry
    * and the <b>u</b> and <b>v</b> coordinates set define the mapping of this
@@ -12451,7 +12451,7 @@ public class PApplet implements PConstants {
    * the fourth and fifth parameters to set the opposite corner. Use
    * <b>imageMode(CENTER)</b> to draw images centered at the given x and y
    * position.
-   *
+   * 
    * The parameter to <b>imageMode()</b> must be written in ALL CAPS because
    * Processing is a case-sensitive language.
    *
@@ -12481,12 +12481,12 @@ public class PApplet implements PConstants {
    * its upper-left corner. The image is displayed at its original size
    * unless the <b>width</b> and <b>height</b> parameters specify a different
    * size.
-   *
+   * 
    * The <b>imageMode()</b> function changes the way the parameters work. For
    * example, a call to <b>imageMode(CORNERS)</b> will change the
    * <b>width</b> and <b>height</b> parameters to define the x and y values
    * of the opposite corner of the image.
-   *
+   * 
    * The color of an image may be modified with the <b>tint()</b> function.
    * This function will maintain transparency for GIF and PNG images.
    *
@@ -12587,7 +12587,7 @@ public class PApplet implements PConstants {
    * to <b>shapeMode(CORNERS)</b>, for example, will change the width and
    * height parameters to define the x and y values of the opposite corner of
    * the shape.
-   *
+   * 
    * Note complex shapes may draw awkwardly with P3D. This renderer does not
    * yet support shapes that have holes or complicated breaks.
    *
@@ -12634,7 +12634,7 @@ public class PApplet implements PConstants {
    * CENTER, and RIGHT set the display characteristics of the letters in
    * relation to the values for the <b>x</b> and <b>y</b> parameters of the
    * <b>text()</b> function.
-   *
+   *  
    * In Processing 0125 and later, an optional second parameter can be used
    * to vertically align the text. BASELINE is the default, and the vertical
    * alignment will be reset to BASELINE if the second parameter is not used.
@@ -12642,12 +12642,12 @@ public class PApplet implements PConstants {
    * offsets the line based on the current <b>textDescent()</b>. For multiple
    * lines, the final line will be aligned to the bottom, with the previous
    * lines appearing above it.
-   *
+   *  
    * When using <b>text()</b> with width and height parameters, BASELINE is
    * ignored, and treated as TOP. (Otherwise, text would by default draw
    * outside the box, since BASELINE is the default setting. BASELINE is not
    * a useful drawing mode for text drawn in a rectangle.)
-   *
+   *  
    * The vertical alignment is based on the value of <b>textAscent()</b>,
    * which many fonts do not specify correctly. It may be necessary to use a
    * hack and offset by a few pixels by hand so that the offset looks
@@ -12720,7 +12720,7 @@ public class PApplet implements PConstants {
    * "Create Font..." tool) until it is changed with <b>textSize()</b>.
    * Because fonts are usually bitmaped, you should create fonts at
    * the sizes that will be used most commonly. Using <b>textFont()</b>
-   * without the size parameter will result in the cleanest-looking text.
+   * without the size parameter will result in the cleanest-looking text. 
    * With the default (JAVA2D) and PDF renderers, it's also possible
    * to enable the use of native fonts via the command
    * <b>hint(ENABLE_NATIVE_FONTS)</b>. This will produce vector text in
@@ -12781,7 +12781,7 @@ public class PApplet implements PConstants {
    * Sets the way text draws to the screen. In the default configuration, the
    * <b>MODEL</b> mode, it's possible to rotate, scale, and place letters in
    * two and three dimensional space.
-   *
+   * 
    * The <b>SHAPE</b> mode draws text using the the glyph outlines of
    * individual characters rather than as textures. This mode is only
    * supported with the <b>PDF</b> and <b>P3D</b> renderer settings. With the
@@ -12789,7 +12789,7 @@ public class PApplet implements PConstants {
    * other drawing occurs. If the outlines are not available, then
    * <b>textMode(SHAPE)</b> will be ignored and <b>textMode(MODEL)</b> will
    * be used instead.
-   *
+   * 
    * The <b>textMode(SHAPE)</b> option in <b>P3D</b> can be combined with
    * <b>beginRaw()</b> to write vector-accurate text to 2D and 3D output
    * files, for instance <b>DXF</b> or <b>PDF</b>. The <b>SHAPE</b> mode is
@@ -12881,7 +12881,7 @@ public class PApplet implements PConstants {
    * with the <b>fill()</b> function. The text displays in relation to the
    * <b>textAlign()</b> function, which gives the option to draw to the left,
    * right, and center of the coordinates.
-   *
+   * 
    * The <b>x2</b> and <b>y2</b> parameters define a rectangular area to
    * display within and may only be used with string data. For text drawn
    * inside a rectangle, the coordinates are interpreted based on the current
@@ -12969,11 +12969,11 @@ public class PApplet implements PConstants {
    * Draw text in a box that is constrained to a particular size.
    * The current rectMode() determines what the coordinates mean
    * (whether x1/y1/x2/y2 or x/y/w/h).
-   *
+   * 
    * Note that the x,y coords of the start of the box
    * will align with the *ascent* of the text, not the baseline,
    * as is the case for the other text() functions.
-   *
+   * 
    * Newlines that are \n (Unix newline or linefeed char, ascii 10)
    * are honored, and \r (carriage return, Windows and Mac OS) are
    * ignored.
@@ -13032,7 +13032,7 @@ public class PApplet implements PConstants {
    * and later return to what you had. When a new state is started
    * with push(), it builds on the current style and transform
    * information.
-   *
+   * 
    * <b>push()</b> stores information related to the current
    * transformation state and style settings controlled by the
    * following functions: <b>rotate()</b>, <b>translate()</b>,
@@ -13041,7 +13041,7 @@ public class PApplet implements PConstants {
    * <b>imageMode()</b>, <b>rectMode()</b>, <b>ellipseMode()</b>,
    * <b>colorMode()</b>, <b>textAlign()</b>, <b>textFont()</b>,
    * <b>textMode()</b>, <b>textSize()</b>, <b>textLeading()</b>.
-   *
+   * 
    * The <b>push()</b> and <b>pop()</b> functions were added with
    * Processing 3.5. They can be used in place of <b>pushMatrix()</b>,
    * <b>popMatrix()</b>, <b>pushStyles()</b>, and <b>popStyles()</b>.
@@ -13069,8 +13069,8 @@ public class PApplet implements PConstants {
    * you to change the style and transformation settings and later
    * return to what you had. When a new state is started with push(),
    * it builds on the current style and transform information.
-   *
-   *
+   * 
+   * 
    * <b>push()</b> stores information related to the current
    * transformation state and style settings controlled by the
    * following functions: <b>rotate()</b>, <b>translate()</b>,
@@ -13079,7 +13079,7 @@ public class PApplet implements PConstants {
    * <b>imageMode()</b>, <b>rectMode()</b>, <b>ellipseMode()</b>,
    * <b>colorMode()</b>, <b>textAlign()</b>, <b>textFont()</b>,
    * <b>textMode()</b>, <b>textSize()</b>, <b>textLeading()</b>.
-   *
+   * 
    * The <b>push()</b> and <b>pop()</b> functions were added with
    * Processing 3.5. They can be used in place of <b>pushMatrix()</b>,
    * <b>popMatrix()</b>, <b>pushStyles()</b>, and <b>popStyles()</b>.
@@ -13199,7 +13199,7 @@ public class PApplet implements PConstants {
    * Rotates a shape the amount specified by the <b>angle</b> parameter.
    * Angles should be specified in radians (values from 0 to TWO_PI) or
    * converted to radians with the <b>radians()</b> function.
-   *
+   *  
    * Objects are always rotated around their relative position to the origin
    * and positive numbers rotate objects in a clockwise direction.
    * Transformations apply to everything that happens after and subsequent
@@ -13207,7 +13207,7 @@ public class PApplet implements PConstants {
    * <b>rotate(HALF_PI)</b> and then <b>rotate(HALF_PI)</b> is the same as
    * <b>rotate(PI)</b>. All tranformations are reset when <b>draw()</b>
    * begins again.
-   *
+   *  
    * Technically, <b>rotate()</b> multiplies the current transformation
    * matrix by a rotation matrix. This function can be further controlled by
    * the <b>pushMatrix()</b> and <b>popMatrix()</b>.
@@ -13418,7 +13418,7 @@ public class PApplet implements PConstants {
    * <b>shearX(PI/2)</b> and then <b>shearX(PI/2)</b> is the same as
    * <b>shearX(PI)</b>. If <b>shearX()</b> is called within the
    * <b>draw()</b>, the transformation is reset when the loop begins again.
-   *
+   *  
    * Technically, <b>shearX()</b> multiplies the current transformation
    * matrix by a rotation matrix. This function can be further controlled by
    * the <b>pushMatrix()</b> and <b>popMatrix()</b> functions.
@@ -13453,7 +13453,7 @@ public class PApplet implements PConstants {
    * <b>shearY(PI/2)</b> and then <b>shearY(PI/2)</b> is the same as
    * <b>shearY(PI)</b>. If <b>shearY()</b> is called within the
    * <b>draw()</b>, the transformation is reset when the loop begins again.
-   *
+   *  
    * Technically, <b>shearY()</b> multiplies the current transformation
    * matrix by a rotation matrix. This function can be further controlled by
    * the <b>pushMatrix()</b> and <b>popMatrix()</b> functions.
@@ -13963,7 +13963,7 @@ public class PApplet implements PConstants {
    * transformations (scale, rotate, translate, etc.) The X value can be used
    * to place an object in space relative to the location of the original
    * point once the transformations are no longer in use.
-   *
+   *  
    * In the example, the <b>modelX()</b>, <b>modelY()</b>, and
    * <b>modelZ()</b> functions record the location of a box in space after
    * being placed using a series of translate and rotate commands. After
@@ -13993,7 +13993,7 @@ public class PApplet implements PConstants {
    * transformations (scale, rotate, translate, etc.) The Y value can be used
    * to place an object in space relative to the location of the original
    * point once the transformations are no longer in use.
-   *
+   * 
    * In the example, the <b>modelX()</b>, <b>modelY()</b>, and
    * <b>modelZ()</b> functions record the location of a box in space after
    * being placed using a series of translate and rotate commands. After
@@ -14023,7 +14023,7 @@ public class PApplet implements PConstants {
    * transformations (scale, rotate, translate, etc.) The Z value can be used
    * to place an object in space relative to the location of the original
    * point once the transformations are no longer in use.
-   *
+   * 
    * In the example, the <b>modelX()</b>, <b>modelY()</b>, and
    * <b>modelZ()</b> functions record the location of a box in space after
    * being placed using a series of translate and rotate commands. After
@@ -14055,7 +14055,7 @@ public class PApplet implements PConstants {
    * <b>pushStyle()</b>, it builds on the current style information. The
    * <b>pushStyle()</b> and <b>popStyle()</b> functions can be embedded to
    * provide more control (see the second example above for a demonstration.)
-   *
+   * 
    * The style information controlled by the following functions are included
    * in the style:
    * fill(), stroke(), tint(), strokeWeight(), strokeCap(), strokeJoin(),
@@ -14107,7 +14107,7 @@ public class PApplet implements PConstants {
    *
    * Sets the width of the stroke used for lines, points, and the border
    * around shapes. All widths are set in units of pixels.
-   *
+   *  
    * When drawing with P3D, series of connected lines (such as the stroke
    * around a polygon, triangle, or ellipse) produce unattractive results
    * when a thick stroke weight is set (<a
@@ -14138,7 +14138,7 @@ public class PApplet implements PConstants {
    * are either mitered, beveled, or rounded and specified with the
    * corresponding parameters MITER, BEVEL, and ROUND. The default joint is
    * MITER.
-   *
+   *  
    * This function is not available with the P3D renderer, (<a
    * href="http://code.google.com/p/processing/issues/detail?id=123">see
    * Issue 123</a>). More information about the renderers can be found in the
@@ -14164,7 +14164,7 @@ public class PApplet implements PConstants {
    * Sets the style for rendering line endings. These ends are either
    * squared, extended, or rounded and specified with the corresponding
    * parameters SQUARE, PROJECT, and ROUND. The default cap is ROUND.
-   *
+   *  
    * This function is not available with the P3D renderer (<a
    * href="http://code.google.com/p/processing/issues/detail?id=123">see
    * Issue 123</a>). More information about the renderers can be found in the
@@ -14211,7 +14211,7 @@ public class PApplet implements PConstants {
    * is either specified in terms of the RGB or HSB color depending on the
    * current <b>colorMode()</b> (the default color space is RGB, with each
    * value in the range from 0 to 255).
-   *
+   *  
    * When using hexadecimal notation to specify a color, use "#" or "0x"
    * before the values (e.g. #CCFFAA, 0xFFCCFFAA). The # syntax uses six
    * digits to specify a color (the way colors are specified in HTML and
@@ -14219,7 +14219,7 @@ public class PApplet implements PConstants {
    * hexadecimal value must be specified with eight characters; the first two
    * characters define the alpha component and the remainder the red, green,
    * and blue components.
-   *
+   *  
    * The value for the parameter "gray" must be less than or equal to the
    * current maximum value as specified by <b>colorMode()</b>. The default
    * maximum value is 255.
@@ -14309,12 +14309,12 @@ public class PApplet implements PConstants {
    *
    * Sets the fill value for displaying images. Images can be tinted to
    * specified colors or made transparent by setting the alpha.
-   *
+   * 
    * To make an image transparent, but not change it's color, use white as
    * the tint color and specify an alpha value. For instance, tint(255, 128)
    * will make an image 50% transparent (unless <b>colorMode()</b> has been
    * used).
-   *
+   * 
    * When using hexadecimal notation to specify a color, use "#" or "0x"
    * before the values (e.g. #CCFFAA, 0xFFCCFFAA). The # syntax uses six
    * digits to specify a color (the way colors are specified in HTML and
@@ -14322,11 +14322,11 @@ public class PApplet implements PConstants {
    * hexadecimal value must be specified with eight characters; the first two
    * characters define the alpha component and the remainder the red, green,
    * and blue components.
-   *
+   * 
    * The value for the parameter "gray" must be less than or equal to the
    * current maximum value as specified by <b>colorMode()</b>. The default
    * maximum value is 255.
-   *
+   * 
    * The <b>tint()</b> function is also used to control the coloring of
    * textures in 3D.
    *
@@ -14413,7 +14413,7 @@ public class PApplet implements PConstants {
    * color is either specified in terms of the RGB or HSB color depending on
    * the current <b>colorMode()</b> (the default color space is RGB, with
    * each value in the range from 0 to 255).
-   *
+   *  
    * When using hexadecimal notation to specify a color, use "#" or "0x"
    * before the values (e.g. #CCFFAA, 0xFFCCFFAA). The # syntax uses six
    * digits to specify a color (the way colors are specified in HTML and
@@ -14421,11 +14421,11 @@ public class PApplet implements PConstants {
    * hexadecimal value must be specified with eight characters; the first two
    * characters define the alpha component and the remainder the red, green,
    * and blue components.
-   *
+   *  
    * The value for the parameter "gray" must be less than or equal to the
    * current maximum value as specified by <b>colorMode()</b>. The default
    * maximum value is 255.
-   *
+   *  
    * To change the color of an image (or a texture), use tint().
    *
    * ( end auto-generated )
@@ -14917,13 +14917,13 @@ public class PApplet implements PConstants {
    * of the Processing window. The default background is light gray. In the
    * <b>draw()</b> function, the background color is used to clear the
    * display window at the beginning of each frame.
-   *
+   *  
    * An image can also be used as the background for a sketch, however its
    * width and height must be the same size as the sketch window. To resize
    * an image 'b' to the size of the sketch window, use b.resize(width, height).
-   *
+   *  
    * Images used as background will ignore the current <b>tint()</b> setting.
-   *
+   *  
    * It is not possible to use transparency (alpha) in background colors with
    * the main drawing surface, however they will work properly with <b>createGraphics()</b>.
    *
@@ -15007,12 +15007,12 @@ public class PApplet implements PConstants {
    * Takes an RGB or ARGB image and sets it as the background.
    * The width and height of the image must be the same size as the sketch.
    * Use image.resize(width, height) to make short work of such a task.
-   *
+   * 
    * Note that even if the image is set as RGB, the high 8 bits of each pixel
    * should be set opaque (0xFF000000) because the image data will be copied
    * directly to the screen, and non-opaque background images may have strange
    * behavior. Use image.filter(OPAQUE) to handle this easily.
-   *
+   * 
    * When using 3D, this will also clear the zbuffer (if it exists).
    *
    * @param image PImage to set as background (must be same size as the sketch window)
@@ -15325,13 +15325,13 @@ public class PApplet implements PConstants {
    * <b>height</b> parameter. When getting an image, the <b>x</b> and
    * <b>y</b> parameters define the coordinates for the upper-left corner of
    * the image, regardless of the current <b>imageMode()</b>.
-   *
+   * 
    * If the pixel requested is outside of the image window, black is
    * returned. The numbers returned are scaled according to the current color
    * ranges, but only RGB values are returned by this function. For example,
    * even though you may have drawn a shape with <b>colorMode(HSB)</b>, the
    * numbers returned will be in RGB format.
-   *
+   * 
    * Getting the color of a single pixel with <b>get(x, y)</b> is easy, but
    * not as fast as grabbing the data directly from <b>pixels[]</b>. The
    * equivalent statement to <b>get(x, y)</b> using <b>pixels[]</b> is
@@ -15399,14 +15399,14 @@ public class PApplet implements PConstants {
    *
    * Changes the color of any pixel or writes an image directly into the
    * display window.
-   *
+   * 
    * The <b>x</b> and <b>y</b> parameters specify the pixel to change and the
    * <b>color</b> parameter specifies the color value. The color parameter is
    * affected by the current color mode (the default is RGB values from 0 to
    * 255). When setting an image, the <b>x</b> and <b>y</b> parameters define
    * the coordinates for the upper-left corner of the image, regardless of
    * the current <b>imageMode()</b>.
-   *
+   * 
    * Setting the color of a single pixel with <b>set(x, y)</b> is easy, but
    * not as fast as putting the data directly into <b>pixels[]</b>. The
    * equivalent statement to <b>set(x, y, #000000)</b> using <b>pixels[]</b>
@@ -15452,7 +15452,7 @@ public class PApplet implements PConstants {
    * using it as an alpha channel. This mask image should only contain
    * grayscale data, but only the blue color channel is used. The mask image
    * needs to be the same size as the image to which it is applied.
-   *
+   * 
    * In addition to using a mask image, an integer array containing the alpha
    * channel data can be specified directly. This method is useful for
    * creating dynamically generated alpha masks. This array must be of the
@@ -15500,23 +15500,23 @@ public class PApplet implements PConstants {
    * they are above or below the threshold defined by the level parameter.
    * The level must be between 0.0 (black) and 1.0(white). If no level is
    * specified, 0.5 is used.
-   *
+   * 
    * GRAY - converts any colors in the image to grayscale equivalents
-   *
+   * 
    * INVERT - sets each pixel to its inverse value
-   *
+   * 
    * POSTERIZE - limits each channel of the image to the number of colors
    * specified as the level parameter
-   *
+   * 
    * BLUR - executes a Guassian blur with the level parameter specifying the
    * extent of the blurring. If no level parameter is used, the blur is
    * equivalent to Guassian blur of radius 1
-   *
+   * 
    * OPAQUE - sets the alpha channel to entirely opaque
-   *
+   * 
    * ERODE - reduces the light areas with the amount defined by the level
    * parameter
-   *
+   * 
    * DILATE - increases the light areas with the amount defined by the level parameter
    *
    * ( end auto-generated )
@@ -15535,7 +15535,7 @@ public class PApplet implements PConstants {
    * </UL>
    * Luminance conversion code contributed by
    * <A HREF="http://www.toxi.co.uk">toxi</A>
-   *
+   * 
    * Gaussian blur code contributed by
    * <A HREF="http://incubator.quasimondo.com">Mario Klingemann</A>
    *
@@ -15559,7 +15559,7 @@ public class PApplet implements PConstants {
    * source pixels to fit the specified target region. No alpha information
    * is used in the process, however if the source image has an alpha channel
    * set, it will be copied as well.
-   *
+   * 
    * As of release 0149, this function ignores <b>imageMode()</b>.
    *
    * ( end auto-generated )
@@ -15610,46 +15610,46 @@ public class PApplet implements PConstants {
    * parameter. These copies utilize full alpha channel support and a choice
    * of the following modes to blend the colors of source pixels (A) with the
    * ones of pixels in the destination image (B):
-   *
+   * 
    * BLEND - linear interpolation of colours: C = A*factor + B
-   *
+   * 
    * ADD - additive blending with white clip: C = min(A*factor + B, 255)
-   *
+   * 
    * SUBTRACT - subtractive blending with black clip: C = max(B - A*factor,
    * 0)
-   *
+   * 
    * DARKEST - only the darkest colour succeeds: C = min(A*factor, B)
-   *
+   * 
    * LIGHTEST - only the lightest colour succeeds: C = max(A*factor, B)
-   *
+   * 
    * DIFFERENCE - subtract colors from underlying image.
-   *
+   * 
    * EXCLUSION - similar to DIFFERENCE, but less extreme.
-   *
+   * 
    * MULTIPLY - Multiply the colors, result will always be darker.
-   *
+   * 
    * SCREEN - Opposite multiply, uses inverse values of the colors.
-   *
+   * 
    * OVERLAY - A mix of MULTIPLY and SCREEN. Multiplies dark values,
    * and screens light values.
-   *
+   * 
    * HARD_LIGHT - SCREEN when greater than 50% gray, MULTIPLY when lower.
-   *
+   * 
    * SOFT_LIGHT - Mix of DARKEST and LIGHTEST.
    * Works like OVERLAY, but not as harsh.
-   *
+   * 
    * DODGE - Lightens light tones and increases contrast, ignores darks.
    * Called "Color Dodge" in Illustrator and Photoshop.
-   *
+   * 
    * BURN - Darker areas are applied, increasing contrast, ignores lights.
    * Called "Color Burn" in Illustrator and Photoshop.
-   *
+   * 
    * All modes use the alpha information (highest byte) of source image
    * pixels as the blending factor. If the source and destination regions are
    * different sizes, the image will be automatically resized to match the
    * destination size. If the <b>srcImg</b> parameter is not used, the
    * display window is used as the source image.
-   *
+   * 
    * As of release 0149, this function ignores <b>imageMode()</b>.
    *
    * ( end auto-generated )