picrate 2.0.1-java → 2.3.0-java

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

@@ -61,12 +61,12 @@ import java.util.Map;
  * For the time being, this class and its shape() and loadShape() friends in
  * PApplet exist as placeholders for more exciting things to come. If you'd like
  * to work with this class, make a subclass (see how PShapeSVG works) and you
- * can play with its internal methods all you like.</p>
+ * can play with its internal methods all you like.
  *
  * <p>
  * Library developers are encouraged to create PShape objects when loading shape
  * data, so that they can eventually hook into the bounty that will be the
- * PShape interface, and the ease of loadShape() and shape().</p>
+ * PShape interface, and the ease of loadShape() and shape().
  *
  * @webref shape
  * @usage Web &amp; Application
@@ -171,7 +171,7 @@ public class PShape implements PConstants {
    *
    * The width of the PShape document.
    *
-   * ( end auto-generated )
+
    *
    * @webref pshape:field
    * @usage web_application
@@ -184,7 +184,7 @@ public class PShape implements PConstants {
    *
    * The height of the PShape document.
    *
-   * ( end auto-generated )
+
    *
    * @webref pshape:field
    * @usage web_application
@@ -597,7 +597,7 @@ public class PShape implements PConstants {
    * SVG file. For instance, this parameter is controlled by showing or hiding
    * the shape in the layers palette in Adobe Illustrator.
    *
-   * ( end auto-generated )
+
    *
    * @return
    * @webref pshape:method
@@ -620,7 +620,7 @@ public class PShape implements PConstants {
    * the SVG file. For instance, this parameter is controlled by showing or
    * hiding the shape in the layers palette in Adobe Illustrator.
    *
-   * ( end auto-generated )
+
    *
    * @webref pshape:mathod
    * @usage web_application
@@ -639,7 +639,7 @@ public class PShape implements PConstants {
    * Disables the shape's style data and uses Processing's current styles.
    * Styles include attributes such as colors, stroke weight, and stroke joints.
    *
-   * ( end auto-generated )
+
    * <h3>Advanced</h3>
    * Overrides this shape's style information and uses PGraphics styles and
    * colors. Identical to ignoreStyles(true). Also disables styles for all child
@@ -664,7 +664,7 @@ public class PShape implements PConstants {
    * Enables the shape's style data and ignores Processing's current styles.
    * Styles include attributes such as colors, stroke weight, and stroke joints.
    *
-   * ( end auto-generated )
+
    *
    * @webref pshape:method
    * @usage web_application
@@ -2419,7 +2419,7 @@ public class PShape implements PConstants {
    * with the <b>target</b> parameter. The shape is returned as a
    * <b>PShape</b> object, or <b>null</b> is returned if there is an error.
    *
-   * ( end auto-generated )
+
    *
    * @return
    * @webref pshape:method
@@ -3025,7 +3025,7 @@ public class PShape implements PConstants {
    * created, only the <b>setFill()</b> method can define a new fill value for
    * the <b>PShape</b>.
    *
-   * ( end auto-generated )
+
    *
    * @webref
    * @param fill
@@ -3202,7 +3202,7 @@ public class PShape implements PConstants {
    * after the shape is created, only the <b>setStroke()</b> method can define a
    * new stroke value for the <b>PShape</b>.
    *
-   * ( end auto-generated )
+
    *
    * @webref
    * @param stroke
@@ -3678,7 +3678,7 @@ public class PShape implements PConstants {
    * Using this method with the <b>z</b> parameter requires using the P3D
    * parameter in combination with size.
    *
-   * ( end auto-generated )
+
    *
    * @webref pshape:method
    * @usage web_application
@@ -3721,7 +3721,7 @@ public class PShape implements PConstants {
    * This method requires a 3D renderer. You need to use P3D as a third
    * parameter for the <b>size()</b> function as shown in the example above.
    *
-   * ( end auto-generated )
+
    *
    * @webref pshape:method
    * @usage web_application
@@ -3755,7 +3755,7 @@ public class PShape implements PConstants {
    * This method requires a 3D renderer. You need to use P3D as a third
    * parameter for the <b>size()</b> function as shown in the example above.
    *
-   * ( end auto-generated )
+
    *
    * @webref pshape:method
    * @usage web_application
@@ -3789,7 +3789,7 @@ public class PShape implements PConstants {
    * This method requires a 3D renderer. You need to use P3D as a third
    * parameter for the <b>size()</b> function as shown in the example above.
    *
-   * ( end auto-generated )
+
    *
    * @webref pshape:method
    * @usage web_application
@@ -3821,7 +3821,7 @@ public class PShape implements PConstants {
    * <b>rotate(PI)</b>. This transformation is applied directly to the shape,
    * it's not refreshed each time <b>draw()</b> is run.
    *
-   * ( end auto-generated )
+
    *
    * @webref pshape:method
    * @usage web_application
@@ -3875,7 +3875,7 @@ public class PShape implements PConstants {
    * Using this method with the <b>z</b> parameter requires using the P3D
    * parameter in combination with size.
    *
-   * ( end auto-generated )
+
    *
    * @webref pshape:method
    * @usage web_application
@@ -3917,7 +3917,7 @@ public class PShape implements PConstants {
    * Replaces the current matrix of a shape with the identity matrix. The
    * equivalent function in OpenGL is glLoadIdentity().
    *
-   * ( end auto-generated )
+
    *
    * @webref pshape:method
    * @brief Replaces the current matrix of a shape with the identity matrix

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

@@ -1,6 +1,6 @@
 /* -*- mode: java; c-basic-offset: 2; indent-tabs-mode: nil -*- */
 
- /*
+/*
   Part of the Processing project - http://processing.org
 
   Copyright (c) 2014-15 The Processing Foundation
@@ -18,132 +18,113 @@
   Public License along with this library; if not, write to the
   Free Software Foundation, Inc., 59 Temple Place, Suite 330,
   Boston, MA  02111-1307  USA
- */
+*/
+
 package processing.core;
 
-/**
- *
- * @author Martin Prout
- */
-public interface PSurface {
+import java.io.File;
 
+public interface PSurface {
   /**
-   * Minimum dimensions for the window holding an applet.
+   * Minimum dimensions for the window holding an applet. This varies between
+   * platforms, Mac OS X 10.3 (confirmed with 10.7 and Java 6) can do any
+   * height but requires at least 128 pixels width. Windows XP has another
+   * set of limitations. And for all I know, Linux probably allows window
+   * sizes to be negative numbers.
    */
-  int MIN_WINDOW_WIDTH = 128;
+  static public final int MIN_WINDOW_WIDTH = 128;
+  static public final int MIN_WINDOW_HEIGHT = 128;
 
-  /**
-   *
-   */
-  int MIN_WINDOW_HEIGHT = 128;
+  //public int displayDensity();
+
+  //public int displayDensity(int display);
+
+  //
 
   // renderer that doesn't draw to the screen
-  /**
-   *
-   * @param sketch
-   */
-  void initOffscreen(PApplet sketch);
+  public void initOffscreen(PApplet sketch);
 
   // considering removal in favor of separate Component classes for appropriate renderers
   // (i.e. for Java2D or a generic Image surface, but not PDF, debatable for GL or FX)
-  //Component initComponent(PApplet sketch);
-  //Frame initFrame(PApplet sketch, Color backgroundColor,
-//  void initFrame(PApplet sketch, int backgroundColor,
+  //public Component initComponent(PApplet sketch);
+
+  //public Frame initFrame(PApplet sketch, Color backgroundColor,
+//  public void initFrame(PApplet sketch, int backgroundColor,
 //                        int deviceIndex, boolean fullScreen, boolean spanDisplays);
-  /**
-   *
-   * @param sketch
-   */
-  void initFrame(PApplet sketch);
+  public void initFrame(PApplet sketch);
+
+  //
+
+  public PImage loadImage(String path, Object... args);
+
+  //
+
+  public void selectInput(String prompt, String callback,
+                          File file, Object callbackObject);
+
+  public void selectOutput(String prompt, String callback,
+                           File file, Object callbackObject);
+
+  public void selectFolder(String prompt, String callback,
+                           File file, Object callbackObject);
+
+  //
 
   /**
-   * Get the native window object associated with this drawing surface. For
-   * Java2D, this will be an AWT Frame object. For OpenGL, the window. The data
-   * returned here is subject to the whims of the renderer, and using this
-   * method means you're willing to deal with underlying implementation changes
-   * and that you won't throw a fit like a toddler if your code breaks sometime
-   * in the future.
-   *
-   * @return
+   * Get the native window object associated with this drawing surface.For Java2D, this will be an AWT Frame object.
+   * For OpenGL, the window.
+ The data returned here is subject to the whims of the renderer,
+ and using this method means you're willing to deal with underlying
+ implementation changes and that you won't throw a fit like a toddler
+ if your code breaks sometime in the future.
+   * @return 
    */
-  Object getNative();
+  public Object getNative();
 
   //
+
   // Just call these on an AWT Frame object stored in PApplet.
   // Silly, but prevents a lot of rewrite and extra methods for little benefit.
   // However, maybe prevents us from having to document the 'frame' variable?
-  /**
-   * Set the window (and dock, or whatever necessary) title.
-   *
-   * @param title
-   */
-  void setTitle(String title);
 
-  /**
-   * Show or hide the window.
-   *
-   * @param visible
-   */
-  void setVisible(boolean visible);
+  /** Set the window (and dock, or whatever necessary) title.
+   * @param title */
+  public void setTitle(String title);
 
-  /**
-   * Set true if we want to resize things (default is not resizable)
-   *
-   * @param resizable
-   */
-  void setResizable(boolean resizable);
+  /** Show or hide the window.
+   * @param visible */
+  public void setVisible(boolean visible);
 
-  /**
-   * Dumb name, but inherited from Frame and no better ideas.
-   *
-   * @param always
-   */
-  void setAlwaysOnTop(boolean always);
+  /** Set true if we want to resize things (default is not resizable)
+   * @param resizable */
+  public void setResizable(boolean resizable);
 
-  /**
-   *
-   * @param icon
-   */
-  void setIcon(PImage icon);
+  /** Dumb name, but inherited from Frame and no better ideas.
+   * @param always */
+  public void setAlwaysOnTop(boolean always);
+
+  public void setIcon(PImage icon);
 
   //
-//  void placeWindow(int[] location);
-  /**
-   *
-   * @param location
-   * @param editorLocation
-   */
-  void placeWindow(int[] location, int[] editorLocation);
 
-  //void placeFullScreen(boolean hideStop);
-  /**
-   *
-   * @param stopColor
-   */
-  void placePresent(int stopColor);
+//  public void placeWindow(int[] location);
+
+  public void placeWindow(int[] location, int[] editorLocation);
+
+  //public void placeFullScreen(boolean hideStop);
+  public void placePresent(int stopColor);
 
   // Sketch is running from the PDE, set up messaging back to the PDE
-  /**
-   *
-   */
-  void setupExternalMessages();
+  public void setupExternalMessages();
 
   //
+
   // sets displayWidth/Height inside PApplet
-  //void checkDisplaySize();
-  /**
-   *
-   * @param x
-   * @param y
-   */
-  void setLocation(int x, int y);
+  //public void checkDisplaySize();
 
-  /**
-   *
-   * @param width
-   * @param height
-   */
-  void setSize(int width, int height);
+  public void setLocation(int x, int y);
+
+  public void setSize(int width, int height);
 
 //  /**
 //   * Called by {@link PApplet#createGraphics} to initialize the
@@ -154,79 +135,64 @@ public interface PSurface {
 //   * @param high
 //   */
   // create pixel buffer (pulled out for offscreen graphics)
-  //void initImage(PGraphics gr, int wide, int high);
+  //public void initImage(PGraphics gr, int wide, int high);
   // create pixel buffer, called from allocate() to produce a compatible image for rendering efficiently
-//  void initImage(PGraphics gr);
-  //Component getComponent();
+//  public void initImage(PGraphics gr);
+
+  //public Component getComponent();
+
 //  /**
 //   * Sometimes smoothing must be set at the drawing surface level
 //   * not just inside the renderer itself.
 //   */
-//  void setSmooth(int level);
-  /**
-   *
-   * @param fps
-   */
-  void setFrameRate(float fps);
+//  public void setSmooth(int level);
+
+  public void setFrameRate(float fps);
 
 //  // called on the first frame so that the now-visible drawing surface can
 //  // receive key and mouse events
-//  void requestFocus();
+//  public void requestFocus();
+
 //  // finish rendering to the screen (called by PApplet)
-//  void blit();
+//  public void blit();
+
   //
-  /**
-   *
-   * @param kind
-   */
-  void setCursor(int kind);
 
-  /**
-   *
-   * @param image
-   * @param hotspotX
-   * @param hotspotY
-   */
-  void setCursor(PImage image, int hotspotX, int hotspotY);
+  public void setCursor(int kind);
 
-  /**
-   *
-   */
-  void showCursor();
+  public void setCursor(PImage image, int hotspotX, int hotspotY);
 
-  /**
-   *
-   */
-  void hideCursor();
+  public void showCursor();
+
+  public void hideCursor();
 
   //
+
   /**
-   * Start the animation thread
+   * @param url the link to open
+   * @return false if unable to find a viable way to open
    */
-  void startThread();
+  public boolean openLink(String url);
+
+  //
+
+  /** Start the animation thread */
+  public void startThread();
 
   /**
    * On the next trip through the animation thread, things should go sleepy-bye.
    * Does not pause the thread immediately because that needs to happen on the
    * animation thread itself, so fires on the next trip through draw().
    */
-  void pauseThread();
+  public void pauseThread();
 
-  /**
-   *
-   */
-  void resumeThread();
+  public void resumeThread();
 
   /**
    * Stop the animation thread (set it null)
-   *
    * @return false if already stopped
    */
-  boolean stopThread();
+  public boolean stopThread();
 
-  /**
-   *
-   * @return
-   */
-  boolean isStopped();
+  public boolean isStopped();
 }