picrate 0.0.2-java

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

@@ -0,0 +1,1033 @@
+/* -*- mode: java; c-basic-offset: 2; indent-tabs-mode: nil -*- */
+
+ /*
+  Part of the Processing project - http://processing.org
+
+  Copyright (c) 2004-11 Ben Fry and Casey Reas
+  Copyright (c) 2001-04 Massachusetts Institute of Technology
+
+  This library is free software; you can redistribute it and/or
+  modify it under the terms of the GNU Lesser General Public
+  License as published by the Free Software Foundation; either
+  version 2.1 of the License, or (at your option) any later version.
+
+  This library is distributed in the hope that it will be useful,
+  but WITHOUT ANY WARRANTY; without even the implied warranty of
+  MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
+  Lesser General Public License for more details.
+
+  You should have received a copy of the GNU Lesser General
+  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;
+
+import java.awt.Cursor;
+import java.awt.event.KeyEvent;
+
+/**
+ * Numbers shared throughout processing.core.
+ * <p>
+ * An attempt is made to keep the constants as short/non-verbose as possible.
+ * For instance, the constant is TIFF instead of FILE_TYPE_TIFF. We'll do this
+ * as long as we can get away with it.
+ *
+ * @usage Web &amp; Application
+ */
+public interface PConstants {
+
+    /**
+     *
+     */
+    static public final int X = 0;
+
+    /**
+     *
+     */
+    static public final int Y = 1;
+
+    /**
+     *
+     */
+    static public final int Z = 2;
+
+    // renderers known to processing.core
+
+    /*
+  // List of renderers used inside PdePreprocessor
+  static final StringList rendererList = new StringList(new String[] {
+    "JAVA2D", "JAVA2D_2X",
+    "P2D", "P2D_2X", "P3D", "P3D_2X", "OPENGL",
+    "E2D", "FX2D", "FX2D_2X",  // experimental
+    "LWJGL.P2D", "LWJGL.P3D",  // hmm
+    "PDF"  // no DXF because that's only for beginRaw()
+  });
+     */
+    /**
+     *
+     */
+    static final String JAVA2D = "processing.awt.PGraphicsJava2D";
+
+    /**
+     *
+     */
+    static final String P2D = "processing.opengl.PGraphics2D";
+
+    /**
+     *
+     */
+    static final String P3D = "processing.opengl.PGraphics3D";
+
+    // When will it be time to remove this?
+    /**
+     *
+     * @deprecated
+     */
+    @Deprecated
+    static final String OPENGL = P3D;
+
+    // Experimental, higher-performance Java 2D renderer (but no pixel ops)
+//  static final String E2D = PGraphicsDanger2D.class.getName();
+    // Experimental JavaFX renderer; even better 2D performance
+    /**
+     *
+     */
+    static final String FX2D = "processing.javafx.PGraphicsFX2D";
+
+    /**
+     *
+     */
+    static final String PDF = "processing.pdf.PGraphicsPDF";
+
+    /**
+     *
+     */
+    static final String SVG = "processing.svg.PGraphicsSVG";
+
+    /**
+     *
+     */
+    static final String DXF = "processing.dxf.RawDXF";
+
+    // platform IDs for PApplet.platform
+    /**
+     *
+     */
+    static final int OTHER = 0;
+
+    /**
+     *
+     */
+    static final int WINDOWS = 1;
+
+    /**
+     *
+     */
+    static final int MACOSX = 2;
+
+    /**
+     *
+     */
+    static final int LINUX = 3;
+
+    /**
+     *
+     */
+    static final String[] platformNames = {
+        "other", "windows", "macosx", "linux"
+    };
+
+    /**
+     *
+     */
+    static final float EPSILON = 0.0001f;
+
+    // max/min values for numbers
+    /**
+     * Same as Float.MAX_VALUE, but included for parity with MIN_VALUE, and to
+     * avoid teaching static methods on the first day.
+     */
+    static final float MAX_FLOAT = Float.MAX_VALUE;
+    /**
+     * Note that Float.MIN_VALUE is the smallest <EM>positive</EM> value for a
+     * floating point number, not actually the minimum (negative) value for a
+     * float. This constant equals 0xFF7FFFFF, the smallest (farthest negative)
+     * value a float can have before it hits NaN.
+     */
+    static final float MIN_FLOAT = -Float.MAX_VALUE;
+    /**
+     * Largest possible (positive) integer value
+     */
+    static final int MAX_INT = Integer.MAX_VALUE;
+    /**
+     * Smallest possible (negative) integer value
+     */
+    static final int MIN_INT = Integer.MIN_VALUE;
+
+    // shapes
+    /**
+     *
+     */
+    static public final int VERTEX = 0;
+
+    /**
+     *
+     */
+    static public final int BEZIER_VERTEX = 1;
+
+    /**
+     *
+     */
+    static public final int QUADRATIC_VERTEX = 2;
+
+    /**
+     *
+     */
+    static public final int CURVE_VERTEX = 3;
+
+    /**
+     *
+     */
+    static public final int BREAK = 4;
+
+    /**
+     *
+     * @deprecated
+     */
+    @Deprecated
+    static public final int QUAD_BEZIER_VERTEX = 2;  // should not have been exposed
+
+    // useful goodness
+    /**
+     * ( begin auto-generated from PI.xml )
+     *
+     * PI is a mathematical constant with the value 3.14159265358979323846. It
+     * is the ratio of the circumference of a circle to its diameter. It is
+     * useful in combination with the trigonometric functions <b>sin()</b> and
+     * <b>cos()</b>.
+     *
+     * ( end auto-generated )
+     *
+     * @webref constants
+     * @see PConstants#TWO_PI
+     * @see PConstants#TAU
+     * @see PConstants#HALF_PI
+     * @see PConstants#QUARTER_PI
+     *
+     */
+    static final float PI = (float) Math.PI;
+    /**
+     * ( begin auto-generated from HALF_PI.xml )
+     *
+     * HALF_PI is a mathematical constant with the value 1.57079632679489661923.
+     * It is half the ratio of the circumference of a circle to its diameter. It
+     * is useful in combination with the trigonometric functions <b>sin()</b>
+     * and <b>cos()</b>.
+     *
+     * ( end auto-generated )
+     *
+     * @webref constants
+     * @see PConstants#PI
+     * @see PConstants#TWO_PI
+     * @see PConstants#TAU
+     * @see PConstants#QUARTER_PI
+     */
+    static final float HALF_PI = (float) (Math.PI / 2.0);
+
+    /**
+     *
+     */
+    static final float THIRD_PI = (float) (Math.PI / 3.0);
+    /**
+     * ( begin auto-generated from QUARTER_PI.xml )
+     *
+     * QUARTER_PI is a mathematical constant with the value 0.7853982. It is one
+     * quarter the ratio of the circumference of a circle to its diameter. It is
+     * useful in combination with the trigonometric functions
+     * <b>sin()</b> and <b>cos()</b>.
+     *
+     * ( end auto-generated )
+     *
+     * @webref constants
+     * @see PConstants#PI
+     * @see PConstants#TWO_PI
+     * @see PConstants#TAU
+     * @see PConstants#HALF_PI
+     */
+    static final float QUARTER_PI = (float) (Math.PI / 4.0);
+    /**
+     * ( begin auto-generated from TWO_PI.xml )
+     *
+     * TWO_PI is a mathematical constant with the value 6.28318530717958647693.
+     * It is twice the ratio of the circumference of a circle to its diameter.
+     * It is useful in combination with the trigonometric functions
+     * <b>sin()</b> and <b>cos()</b>.
+     *
+     * ( end auto-generated )
+     *
+     * @webref constants
+     * @see PConstants#PI
+     * @see PConstants#TAU
+     * @see PConstants#HALF_PI
+     * @see PConstants#QUARTER_PI
+     */
+    static final float TWO_PI = (float) (2.0 * Math.PI);
+    /**
+     * ( begin auto-generated from TAU.xml )
+     *
+     * TAU is an alias for TWO_PI, a mathematical constant with the value
+     * 6.28318530717958647693. It is twice the ratio of the circumference of a
+     * circle to its diameter. It is useful in combination with the
+     * trigonometric functions <b>sin()</b> and <b>cos()</b>.
+     *
+     * ( end auto-generated )
+     *
+     * @webref constants
+     * @see PConstants#PI
+     * @see PConstants#TWO_PI
+     * @see PConstants#HALF_PI
+     * @see PConstants#QUARTER_PI
+     */
+    static final float TAU = (float) (2.0 * Math.PI);
+
+    /**
+     *
+     */
+    static final float DEG_TO_RAD = PI / 180.0f;
+
+    /**
+     *
+     */
+    static final float RAD_TO_DEG = 180.0f / PI;
+
+    // angle modes
+    //static final int RADIANS = 0;
+    //static final int DEGREES = 1;
+    // used by split, all the standard whitespace chars
+    // (also includes unicode nbsp, that little bostage)
+    /**
+     *
+     */
+    static final String WHITESPACE = " \t\n\r\f\u00A0";
+
+    // for colors and/or images
+    /**
+     *
+     */
+    static final int RGB = 1;  // image & color
+
+    /**
+     *
+     */
+    static final int ARGB = 2;  // image
+
+    /**
+     *
+     */
+    static final int HSB = 3;  // color
+
+    /**
+     *
+     */
+    static final int ALPHA = 4;  // image
+//  static final int CMYK  = 5;  // image & color (someday)
+
+    // image file types
+    /**
+     *
+     */
+    static final int TIFF = 0;
+
+    /**
+     *
+     */
+    static final int TARGA = 1;
+
+    /**
+     *
+     */
+    static final int JPEG = 2;
+
+    /**
+     *
+     */
+    static final int GIF = 3;
+
+    // filter/convert types
+    /**
+     *
+     */
+    static final int BLUR = 11;
+
+    /**
+     *
+     */
+    static final int GRAY = 12;
+
+    /**
+     *
+     */
+    static final int INVERT = 13;
+
+    /**
+     *
+     */
+    static final int OPAQUE = 14;
+
+    /**
+     *
+     */
+    static final int POSTERIZE = 15;
+
+    /**
+     *
+     */
+    static final int THRESHOLD = 16;
+
+    /**
+     *
+     */
+    static final int ERODE = 17;
+
+    /**
+     *
+     */
+    static final int DILATE = 18;
+
+    // blend mode keyword definitions
+    // @see processing.core.PImage#blendColor(int,int,int)
+    /**
+     *
+     */
+    public final static int REPLACE = 0;
+
+    /**
+     *
+     */
+    public final static int BLEND = 1;
+
+    /**
+     *
+     */
+    public final static int ADD = 1 << 1;
+
+    /**
+     *
+     */
+    public final static int SUBTRACT = 1 << 2;
+
+    /**
+     *
+     */
+    public final static int LIGHTEST = 1 << 3;
+
+    /**
+     *
+     */
+    public final static int DARKEST = 1 << 4;
+
+    /**
+     *
+     */
+    public final static int DIFFERENCE = 1 << 5;
+
+    /**
+     *
+     */
+    public final static int EXCLUSION = 1 << 6;
+
+    /**
+     *
+     */
+    public final static int MULTIPLY = 1 << 7;
+
+    /**
+     *
+     */
+    public final static int SCREEN = 1 << 8;
+
+    /**
+     *
+     */
+    public final static int OVERLAY = 1 << 9;
+
+    /**
+     *
+     */
+    public final static int HARD_LIGHT = 1 << 10;
+
+    /**
+     *
+     */
+    public final static int SOFT_LIGHT = 1 << 11;
+
+    /**
+     *
+     */
+    public final static int DODGE = 1 << 12;
+
+    /**
+     *
+     */
+    public final static int BURN = 1 << 13;
+
+    // for messages
+    /**
+     *
+     */
+    static final int CHATTER = 0;
+
+    /**
+     *
+     */
+    static final int COMPLAINT = 1;
+
+    /**
+     *
+     */
+    static final int PROBLEM = 2;
+
+    // types of transformation matrices
+    /**
+     *
+     */
+    static final int PROJECTION = 0;
+
+    /**
+     *
+     */
+    static final int MODELVIEW = 1;
+
+    // types of projection matrices
+    /**
+     *
+     */
+    static final int CUSTOM = 0; // user-specified fanciness
+
+    /**
+     *
+     */
+    static final int ORTHOGRAPHIC = 2; // 2D isometric projection
+
+    /**
+     *
+     */
+    static final int PERSPECTIVE = 3; // perspective matrix
+
+    // shapes
+    // the low four bits set the variety,
+    // higher bits set the specific shape type
+    /**
+     *
+     */
+    static final int GROUP = 0;   // createShape()
+
+    /**
+     *
+     */
+    static final int POINT = 2;   // primitive
+
+    /**
+     *
+     */
+    static final int POINTS = 3;   // vertices
+
+    /**
+     *
+     */
+    static final int LINE = 4;   // primitive
+
+    /**
+     *
+     */
+    static final int LINES = 5;   // beginShape(), createShape()
+
+    /**
+     *
+     */
+    static final int LINE_STRIP = 50;  // beginShape()
+
+    /**
+     *
+     */
+    static final int LINE_LOOP = 51;
+
+    /**
+     *
+     */
+    static final int TRIANGLE = 8;   // primitive
+
+    /**
+     *
+     */
+    static final int TRIANGLES = 9;   // vertices
+
+    /**
+     *
+     */
+    static final int TRIANGLE_STRIP = 10;  // vertices
+
+    /**
+     *
+     */
+    static final int TRIANGLE_FAN = 11;  // vertices
+
+    /**
+     *
+     */
+    static final int QUAD = 16;  // primitive
+
+    /**
+     *
+     */
+    static final int QUADS = 17;  // vertices
+
+    /**
+     *
+     */
+    static final int QUAD_STRIP = 18;  // vertices
+
+    /**
+     *
+     */
+    static final int POLYGON = 20;  // in the end, probably cannot
+
+    /**
+     *
+     */
+    static final int PATH = 21;  // separate these two
+
+    /**
+     *
+     */
+    static final int RECT = 30;  // primitive
+
+    /**
+     *
+     */
+    static final int ELLIPSE = 31;  // primitive
+
+    /**
+     *
+     */
+    static final int ARC = 32;  // primitive
+
+    /**
+     *
+     */
+    static final int SPHERE = 40;  // primitive
+
+    /**
+     *
+     */
+    static final int BOX = 41;  // primitive
+
+//  static public final int POINT_SPRITES = 52;
+//  static public final int NON_STROKED_SHAPE = 60;
+//  static public final int STROKED_SHAPE     = 61;
+    // shape closing modes
+    /**
+     *
+     */
+    static final int OPEN = 1;
+
+    /**
+     *
+     */
+    static final int CLOSE = 2;
+
+    // shape drawing modes
+    /**
+     * Draw mode convention to use (x, y) to (width, height)
+     */
+    static final int CORNER = 0;
+    /**
+     * Draw mode convention to use (x1, y1) to (x2, y2) coordinates
+     */
+    static final int CORNERS = 1;
+    /**
+     * Draw mode from the center, and using the radius
+     */
+    static final int RADIUS = 2;
+    /**
+     * Draw from the center, using second pair of values as the diameter.
+     * Formerly called CENTER_DIAMETER in alpha releases.
+     */
+    static final int CENTER = 3;
+    /**
+     * Synonym for the CENTER constant. Draw from the center, using second pair
+     * of values as the diameter.
+     */
+    static final int DIAMETER = 3;
+
+    // arc drawing modes
+    //static final int OPEN = 1;  // shared
+    /**
+     *
+     */
+    static final int CHORD = 2;
+
+    /**
+     *
+     */
+    static final int PIE = 3;
+
+    // vertically alignment modes for text
+    /**
+     * Default vertical alignment for text placement
+     */
+    static final int BASELINE = 0;
+    /**
+     * Align text to the top
+     */
+    static final int TOP = 101;
+    /**
+     * Align text from the bottom, using the baseline.
+     */
+    static final int BOTTOM = 102;
+
+    // uv texture orientation modes
+    /**
+     * texture coordinates in 0..1 range
+     */
+    static final int NORMAL = 1;
+    /**
+     * texture coordinates based on image width/height
+     */
+    static final int IMAGE = 2;
+
+    // texture wrapping modes
+    /**
+     * textures are clamped to their edges
+     */
+    public static final int CLAMP = 0;
+    /**
+     * textures wrap around when uv values go outside 0..1 range
+     */
+    public static final int REPEAT = 1;
+
+    // text placement modes
+    /**
+     * textMode(MODEL) is the default, meaning that characters will be affected
+     * by transformations like any other shapes.
+     * <p/>
+     * Changed value in 0093 to not interfere with LEFT, CENTER, and RIGHT.
+     */
+    static final int MODEL = 4;
+
+    /**
+     * textMode(SHAPE) draws text using the the glyph outlines of individual
+     * characters rather than as textures. If the outlines are not available,
+     * then textMode(SHAPE) will be ignored and textMode(MODEL) will be used
+     * instead. For this reason, be sure to call textMode()
+     * <EM>after</EM> calling textFont().
+     * <p/>
+     * Currently, textMode(SHAPE) is only supported by OPENGL mode. It also
+     * requires Java 1.2 or higher (OPENGL requires 1.4 anyway)
+     */
+    static final int SHAPE = 5;
+
+    // text alignment modes
+    // are inherited from LEFT, CENTER, RIGHT
+    // stroke modes
+    /**
+     *
+     */
+    static final int SQUARE = 1 << 0;  // called 'butt' in the svg spec
+
+    /**
+     *
+     */
+    static final int ROUND = 1 << 1;
+
+    /**
+     *
+     */
+    static final int PROJECT = 1 << 2;  // called 'square' in the svg spec
+
+    /**
+     *
+     */
+    static final int MITER = 1 << 3;
+
+    /**
+     *
+     */
+    static final int BEVEL = 1 << 5;
+
+    // lighting
+    /**
+     *
+     */
+    static final int AMBIENT = 0;
+
+    /**
+     *
+     */
+    static final int DIRECTIONAL = 1;
+    //static final int POINT  = 2;  // shared with shape feature
+
+    /**
+     *
+     */
+    static final int SPOT = 3;
+
+    // key constants
+    // only including the most-used of these guys
+    // if people need more esoteric keys, they can learn about
+    // the esoteric java KeyEvent api and of virtual keys
+    // both key and keyCode will equal these values
+    // for 0125, these were changed to 'char' values, because they
+    // can be upgraded to ints automatically by Java, but having them
+    // as ints prevented split(blah, TAB) from working
+    /**
+     *
+     */
+    static final char BACKSPACE = 8;
+
+    /**
+     *
+     */
+    static final char TAB = 9;
+
+    /**
+     *
+     */
+    static final char ENTER = 10;
+
+    /**
+     *
+     */
+    static final char RETURN = 13;
+
+    /**
+     *
+     */
+    static final char ESC = 27;
+
+    /**
+     *
+     */
+    static final char DELETE = 127;
+
+    // i.e. if ((key == CODED) && (keyCode == UP))
+    /**
+     *
+     */
+    static final int CODED = 0xffff;
+
+    // key will be CODED and keyCode will be this value
+    /**
+     *
+     */
+    static final int UP = KeyEvent.VK_UP;
+
+    /**
+     *
+     */
+    static final int DOWN = KeyEvent.VK_DOWN;
+
+    /**
+     *
+     */
+    static final int LEFT = KeyEvent.VK_LEFT;
+
+    /**
+     *
+     */
+    static final int RIGHT = KeyEvent.VK_RIGHT;
+
+    // key will be CODED and keyCode will be this value
+    /**
+     *
+     */
+    static final int ALT = KeyEvent.VK_ALT;
+
+    /**
+     *
+     */
+    static final int CONTROL = KeyEvent.VK_CONTROL;
+
+    /**
+     *
+     */
+    static final int SHIFT = KeyEvent.VK_SHIFT;
+
+    // orientations (only used on Android, ignored on desktop)
+    /**
+     * Screen orientation constant for portrait (the hamburger way).
+     */
+    static final int PORTRAIT = 1;
+    /**
+     * Screen orientation constant for landscape (the hot dog way).
+     */
+    static final int LANDSCAPE = 2;
+
+    /**
+     * Use with fullScreen() to indicate all available displays.
+     */
+    static final int SPAN = 0;
+
+    // cursor types
+    /**
+     *
+     */
+    static final int ARROW = Cursor.DEFAULT_CURSOR;
+
+    /**
+     *
+     */
+    static final int CROSS = Cursor.CROSSHAIR_CURSOR;
+
+    /**
+     *
+     */
+    static final int HAND = Cursor.HAND_CURSOR;
+
+    /**
+     *
+     */
+    static final int MOVE = Cursor.MOVE_CURSOR;
+
+    /**
+     *
+     */
+    static final int TEXT = Cursor.TEXT_CURSOR;
+
+    /**
+     *
+     */
+    static final int WAIT = Cursor.WAIT_CURSOR;
+
+    // hints - hint values are positive for the alternate version,
+    // negative of the same value returns to the normal/default state
+    /**
+     *
+     * @deprecated
+     */
+    @Deprecated
+    static final int ENABLE_NATIVE_FONTS = 1;
+
+    /**
+     *
+     * @deprecated
+     */
+    @Deprecated
+    static final int DISABLE_NATIVE_FONTS = -1;
+
+    /**
+     *
+     */
+    static final int DISABLE_DEPTH_TEST = 2;
+
+    /**
+     *
+     */
+    static final int ENABLE_DEPTH_TEST = -2;
+
+    /**
+     *
+     */
+    static final int ENABLE_DEPTH_SORT = 3;
+
+    /**
+     *
+     */
+    static final int DISABLE_DEPTH_SORT = -3;
+
+    /**
+     *
+     */
+    static final int DISABLE_OPENGL_ERRORS = 4;
+
+    /**
+     *
+     */
+    static final int ENABLE_OPENGL_ERRORS = -4;
+
+    /**
+     *
+     */
+    static final int DISABLE_DEPTH_MASK = 5;
+
+    /**
+     *
+     */
+    static final int ENABLE_DEPTH_MASK = -5;
+
+    /**
+     *
+     */
+    static final int DISABLE_OPTIMIZED_STROKE = 6;
+
+    /**
+     *
+     */
+    static final int ENABLE_OPTIMIZED_STROKE = -6;
+
+    /**
+     *
+     */
+    static final int ENABLE_STROKE_PERSPECTIVE = 7;
+
+    /**
+     *
+     */
+    static final int DISABLE_STROKE_PERSPECTIVE = -7;
+
+    /**
+     *
+     */
+    static final int DISABLE_TEXTURE_MIPMAPS = 8;
+
+    /**
+     *
+     */
+    static final int ENABLE_TEXTURE_MIPMAPS = -8;
+
+    /**
+     *
+     */
+    static final int ENABLE_STROKE_PURE = 9;
+
+    /**
+     *
+     */
+    static final int DISABLE_STROKE_PURE = -9;
+
+    /**
+     *
+     */
+    static final int ENABLE_BUFFER_READING = 10;
+
+    /**
+     *
+     */
+    static final int DISABLE_BUFFER_READING = -10;
+
+    /**
+     *
+     */
+    static final int DISABLE_KEY_REPEAT = 11;
+
+    /**
+     *
+     */
+    static final int ENABLE_KEY_REPEAT = -11;
+
+    /**
+     *
+     */
+    static final int DISABLE_ASYNC_SAVEFRAME = 12;
+
+    /**
+     *
+     */
+    static final int ENABLE_ASYNC_SAVEFRAME = -12;
+
+    /**
+     *
+     */
+    static final int HINT_COUNT = 13;
+}