From d36fbfe1cf1cf94f8c27fa186b607ecb6da345f1 Mon Sep 17 00:00:00 2001 From: "David A. Mellis" Date: Sun, 4 Apr 2010 15:16:47 +0000 Subject: [PATCH 01/11] Branching to sync with Processing 6406 (1.1 - 0179). From 34579ae440a7bf68ea5ef962b8793b7607589b70 Mon Sep 17 00:00:00 2001 From: "David A. Mellis" Date: Wed, 21 Apr 2010 01:58:57 +0000 Subject: [PATCH 02/11] Initial sync with Processing 6406. Compiles and runs (on Mac OS X) but probably very buggy. --- app/src/processing/app/Base.java | 252 +- app/src/processing/app/Editor.java | 432 +- app/src/processing/app/EditorConsole.java | 20 +- app/src/processing/app/EditorListener.java | 11 + app/src/processing/app/EditorToolbar.java | 220 +- app/src/processing/app/Platform.java | 33 + app/src/processing/app/Preferences.java | 5 + app/src/processing/app/Sketch.java | 229 +- .../processing/app/StreamRedirectThread.java | 95 + app/src/processing/app/WebServer.java | 8 +- ...tThread.java => EventThread.java.disabled} | 5 +- .../processing/app/debug/MessageSiphon.java | 7 +- .../{Runner.java => Runner.java.disabled} | 604 +- .../processing/app/debug/RunnerException.java | 10 +- .../processing/app/debug/RunnerListener.java | 2 + app/src/processing/app/linux/Platform.java | 15 +- app/src/processing/app/macosx/Platform.java | 62 +- .../processing/app/macosx/ThinkDifferent.java | 3 +- .../app/preproc/PdePreprocessor.java | 108 +- .../processing/app/syntax/InputHandler.java | 36 +- .../processing/app/syntax/JEditTextArea.java | 15 +- .../app/syntax/PdeTextAreaDefaults.java | 29 +- .../app/syntax/TextAreaPainter.java | 28 +- .../app/syntax/im/CompositionTextManager.java | 187 + .../app/syntax/im/CompositionTextPainter.java | 124 + .../app/syntax/im/InputMethodSupport.java | 105 + .../processing/app/tools/ColorSelector.java | 27 +- app/src/processing/app/tools/CreateFont.java | 582 +- app/src/processing/app/windows/Platform.java | 39 +- build/macosx/make.sh | 1 + build/shared/lib/preferences.txt | 32 +- core/.project | 34 +- core/.settings/org.eclipse.jdt.core.prefs | 532 +- core/.settings/org.eclipse.jdt.ui.prefs | 4 +- core/build.xml | 26 + core/done.txt | 55 + core/methods/.classpath | 7 + core/methods/.project | 17 + core/methods/build.xml | 28 + core/methods/demo/PApplet.java | 9483 +++++++++++++++++ core/methods/demo/PGraphics.java | 5075 +++++++++ core/methods/demo/PImage.java | 2862 +++++ core/methods/methods.jar | Bin 0 -> 3725 bytes core/methods/src/PAppletMethods.java | 272 + core/src/processing/core/PApplet.java | 689 +- core/src/processing/core/PConstants.java | 45 +- core/src/processing/core/PFont.java | 938 +- core/src/processing/core/PGraphics.java | 964 +- core/src/processing/core/PGraphics3D.java | 45 +- core/src/processing/core/PGraphicsJava2D.java | 10 + core/src/processing/core/PImage.java | 278 +- core/src/processing/core/PPolygon.java | 2 +- core/src/processing/core/PShape.java | 145 +- core/src/processing/core/PShapeSVG.java | 6 +- core/src/processing/core/PVector.java | 4 +- core/src/processing/xml/XMLElement.java | 122 +- core/todo.txt | 162 +- 57 files changed, 22913 insertions(+), 2218 deletions(-) create mode 100644 app/src/processing/app/StreamRedirectThread.java rename app/src/processing/app/debug/{EventThread.java => EventThread.java.disabled} (98%) rename app/src/processing/app/debug/{Runner.java => Runner.java.disabled} (52%) create mode 100644 app/src/processing/app/syntax/im/CompositionTextManager.java create mode 100644 app/src/processing/app/syntax/im/CompositionTextPainter.java create mode 100644 app/src/processing/app/syntax/im/InputMethodSupport.java create mode 100644 core/build.xml create mode 100644 core/methods/.classpath create mode 100644 core/methods/.project create mode 100644 core/methods/build.xml create mode 100644 core/methods/demo/PApplet.java create mode 100644 core/methods/demo/PGraphics.java create mode 100644 core/methods/demo/PImage.java create mode 100644 core/methods/methods.jar create mode 100644 core/methods/src/PAppletMethods.java diff --git a/app/src/processing/app/Base.java b/app/src/processing/app/Base.java index 0c62a8b32..e2a92b819 100644 --- a/app/src/processing/app/Base.java +++ b/app/src/processing/app/Base.java @@ -3,7 +3,7 @@ /* Part of the Processing project - http://processing.org - Copyright (c) 2004-09 Ben Fry and Casey Reas + Copyright (c) 2004-10 Ben Fry and Casey Reas Copyright (c) 2001-04 Massachusetts Institute of Technology This program is free software; you can redistribute it and/or modify @@ -42,7 +42,10 @@ import processing.core.*; */ public class Base { public static final int REVISION = 18; + /** This might be replaced by main() if there's a lib/version.txt file. */ static String VERSION_NAME = "0018"; + /** Set true if this a proper release rather than a numbered revision. */ + static public boolean RELEASE = false; static HashMap platformNames = new HashMap(); static { @@ -101,31 +104,16 @@ public class Base { // ArrayList editors = Collections.synchronizedList(new ArrayList()); Editor activeEditor; -// int nextEditorX; -// int nextEditorY; - -// import com.sun.jna.Library; -// import com.sun.jna.Native; - -// public interface CLibrary extends Library { -// CLibrary INSTANCE = (CLibrary)Native.loadLibrary("c", CLibrary.class); -// int setenv(String name, String value, int overwrite); -// String getenv(String name); -// int unsetenv(String name); -// int putenv(String string); -// } - static public void main(String args[]) { -// /Users/fry/coconut/sketchbook/libraries/gsvideo/library -// CLibrary clib = CLibrary.INSTANCE; -// clib.setenv("DYLD_LIBRARY_PATH", "/Users/fry/coconut/sketchbook/libraries/gsvideo/library", 1); -// System.out.println("env is now " + clib.getenv("DYLD_LIBRARY_PATH")); - try { File versionFile = getContentFile("lib/version.txt"); if (versionFile.exists()) { - VERSION_NAME = PApplet.loadStrings(versionFile)[0]; + String version = PApplet.loadStrings(versionFile)[0]; + if (!version.equals(VERSION_NAME)) { + VERSION_NAME = version; + RELEASE = true; + } } } catch (Exception e) { e.printStackTrace(); @@ -187,10 +175,12 @@ public class Base { try { platform.setLookAndFeel(); } catch (Exception e) { - System.err.println("Non-fatal error while setting the Look & Feel."); - System.err.println("The error message follows, however Arduino should run fine."); - System.err.println(e.getMessage()); - //e.printStackTrace(); + String mess = e.getMessage(); + if (mess.indexOf("ch.randelshofer.quaqua.QuaquaLookAndFeel") == -1) { + System.err.println("Non-fatal error while setting the Look & Feel."); + System.err.println("The error message follows, however Arduino should run fine."); + System.err.println(mess); + } } // Create a location for untitled sketches @@ -213,7 +203,7 @@ public class Base { static protected void initPlatform() { try { - Class platformClass = Class.forName("processing.app.Platform"); + Class platformClass = Class.forName("processing.app.Platform"); if (Base.isMacOS()) { platformClass = Class.forName("processing.app.macosx.Platform"); } else if (Base.isWindows()) { @@ -270,7 +260,7 @@ public class Base { } } - // If not path is set, get the default sketchbook folder for this platform + // If no path is set, get the default sketchbook folder for this platform if (sketchbookPath == null) { File defaultFolder = getDefaultSketchbookFolder(); Preferences.set("sketchbook.path", defaultFolder.getAbsolutePath()); @@ -456,8 +446,8 @@ public class Base { protected int[] nextEditorLocation() { Dimension screen = Toolkit.getDefaultToolkit().getScreenSize(); - int defaultWidth = Preferences.getInteger("default.window.width"); - int defaultHeight = Preferences.getInteger("default.window.height"); + int defaultWidth = Preferences.getInteger("editor.window.width.default"); + int defaultHeight = Preferences.getInteger("editor.window.height.default"); if (activeEditor == null) { // If no current active editor, use default placement @@ -584,7 +574,7 @@ public class Base { * Replace the sketch in the current window with a new untitled document. */ public void handleNewReplace() { - if (!activeEditor.checkModified(true)) { + if (!activeEditor.checkModified()) { return; // sketch was modified, and user canceled } // Close the running window, avoid window boogers with multiple sketches @@ -616,7 +606,7 @@ public class Base { * @param path Location of the primary pde file for the sketch. */ public void handleOpenReplace(String path) { - if (!activeEditor.checkModified(true)) { + if (!activeEditor.checkModified()) { return; // sketch was modified, and user canceled } // Close the running window, avoid window boogers with multiple sketches @@ -758,8 +748,8 @@ public class Base { */ public boolean handleClose(Editor editor) { // Check if modified - boolean immediate = editors.size() == 1; - if (!editor.checkModified(immediate)) { +// boolean immediate = editors.size() == 1; + if (!editor.checkModified()) { return false; } @@ -862,7 +852,7 @@ public class Base { protected boolean handleQuitEach() { int index = 0; for (Editor editor : editors) { - if (editor.checkModified(true)) { + if (editor.checkModified()) { // Update to the new/final sketch path for this fella storeSketchPath(editor, index); index++; @@ -914,7 +904,8 @@ public class Base { // Add a list of all sketches and subfolders try { - boolean sketches = addSketches(menu, getSketchbookFolder(), true); + //boolean sketches = addSketches(menu, getSketchbookFolder(), true); + boolean sketches = addSketches(menu, getSketchbookFolder()); if (sketches) menu.addSeparator(); } catch (IOException e) { e.printStackTrace(); @@ -923,11 +914,11 @@ public class Base { //System.out.println("rebuilding examples menu"); // Add each of the subfolders of examples directly to the menu try { - boolean found = addSketches(menu, examplesFolder, true); + boolean found = addSketches(menu, examplesFolder); if (found) menu.addSeparator(); - found = addSketches(menu, getSketchbookLibrariesFolder(), true); + found = addSketches(menu, getSketchbookLibrariesFolder()); if (found) menu.addSeparator(); - addSketches(menu, librariesFolder, true); + addSketches(menu, librariesFolder); } catch (IOException e) { e.printStackTrace(); } @@ -939,7 +930,8 @@ public class Base { //new Exception().printStackTrace(); try { menu.removeAll(); - addSketches(menu, getSketchbookFolder(), false); + //addSketches(menu, getSketchbookFolder(), false); + addSketches(menu, getSketchbookFolder()); } catch (IOException e) { e.printStackTrace(); } @@ -983,11 +975,11 @@ public class Base { //System.out.println("rebuilding examples menu"); try { menu.removeAll(); - boolean found = addSketches(menu, examplesFolder, false); + boolean found = addSketches(menu, examplesFolder); if (found) menu.addSeparator(); - found = addSketches(menu, getSketchbookLibrariesFolder(), false); + found = addSketches(menu, getSketchbookLibrariesFolder()); if (found) menu.addSeparator(); - addSketches(menu, librariesFolder, false); + addSketches(menu, librariesFolder); } catch (IOException e) { e.printStackTrace(); } @@ -1050,8 +1042,7 @@ public class Base { * should replace the sketch in the current window, or false when the * sketch should open in a new window. */ - protected boolean addSketches(JMenu menu, File folder, - final boolean openReplaces) throws IOException { + protected boolean addSketches(JMenu menu, File folder) throws IOException { // skip .DS_Store files, etc (this shouldn't actually be necessary) if (!folder.isDirectory()) return false; @@ -1068,7 +1059,8 @@ public class Base { public void actionPerformed(ActionEvent e) { String path = e.getActionCommand(); if (new File(path).exists()) { - if (openReplaces) { +// if (openReplaces) { + if ((e.getModifiers() & ActionEvent.SHIFT_MASK) == 0) { handleOpenReplace(path); } else { handleOpen(path); @@ -1121,14 +1113,15 @@ public class Base { } else { // don't create an extra menu level for a folder named "examples" if (subfolder.getName().equals("examples")) { - boolean found = addSketches(menu, subfolder, openReplaces); //, false); + boolean found = addSketches(menu, subfolder); if (found) ifound = true; } else { // not a sketch folder, but maybe a subfolder containing sketches JMenu submenu = new JMenu(list[i]); // needs to be separate var // otherwise would set ifound to false - boolean found = addSketches(submenu, subfolder, openReplaces); //, false); + //boolean found = addSketches(submenu, subfolder, openReplaces); //, false); + boolean found = addSketches(submenu, subfolder); //, false); if (found) { menu.add(submenu); ifound = true; @@ -1319,6 +1312,11 @@ public class Base { // } + static public Platform getPlatform() { + return platform; + } + + static public String getPlatformName() { String osname = System.getProperty("os.name"); @@ -1714,12 +1712,11 @@ public class Base { } */ - /** * Registers key events for a Ctrl-W and ESC with an ActionListener * that will take care of disposing the window. */ - static public void registerWindowCloseKeys(JRootPane root, //Window window, + static public void registerWindowCloseKeys(JRootPane root, ActionListener disposer) { KeyStroke stroke = KeyStroke.getKeyStroke(KeyEvent.VK_ESCAPE, 0); root.registerKeyboardAction(disposer, stroke, @@ -1836,6 +1833,129 @@ public class Base { // ................................................................... + + // incomplete + static public int showYesNoCancelQuestion(Editor editor, String title, + String primary, String secondary) { + if (!Base.isMacOS()) { + int result = + JOptionPane.showConfirmDialog(null, primary + "\n" + secondary, title, + JOptionPane.YES_NO_CANCEL_OPTION, + JOptionPane.QUESTION_MESSAGE); + return result; +// if (result == JOptionPane.YES_OPTION) { +// +// } else if (result == JOptionPane.NO_OPTION) { +// return true; // ok to continue +// +// } else if (result == JOptionPane.CANCEL_OPTION) { +// return false; +// +// } else { +// throw new IllegalStateException(); +// } + + } else { + // Pane formatting adapted from the Quaqua guide + // http://www.randelshofer.ch/quaqua/guide/joptionpane.html + JOptionPane pane = + new JOptionPane(" " + + " " + + "Do you want to save changes to this sketch
" + + " before closing?" + + "

If you don't save, your changes will be lost.", + JOptionPane.QUESTION_MESSAGE); + + String[] options = new String[] { + "Save", "Cancel", "Don't Save" + }; + pane.setOptions(options); + + // highlight the safest option ala apple hig + pane.setInitialValue(options[0]); + + // on macosx, setting the destructive property places this option + // away from the others at the lefthand side + pane.putClientProperty("Quaqua.OptionPane.destructiveOption", + new Integer(2)); + + JDialog dialog = pane.createDialog(editor, null); + dialog.setVisible(true); + + Object result = pane.getValue(); + if (result == options[0]) { + return JOptionPane.YES_OPTION; + } else if (result == options[1]) { + return JOptionPane.CANCEL_OPTION; + } else if (result == options[2]) { + return JOptionPane.NO_OPTION; + } else { + return JOptionPane.CLOSED_OPTION; + } + } + } + + +//if (result == JOptionPane.YES_OPTION) { + // +// } else if (result == JOptionPane.NO_OPTION) { +// return true; // ok to continue + // +// } else if (result == JOptionPane.CANCEL_OPTION) { +// return false; + // +// } else { +// throw new IllegalStateException(); +// } + + static public int showYesNoQuestion(Frame editor, String title, + String primary, String secondary) { + if (!Base.isMacOS()) { + return JOptionPane.showConfirmDialog(editor, + "" + + "" + primary + "" + + "
" + secondary, title, + JOptionPane.YES_NO_OPTION, + JOptionPane.QUESTION_MESSAGE); + } else { + // Pane formatting adapted from the Quaqua guide + // http://www.randelshofer.ch/quaqua/guide/joptionpane.html + JOptionPane pane = + new JOptionPane(" " + + " " + + "" + primary + "" + + "

" + secondary + "

", + JOptionPane.QUESTION_MESSAGE); + + String[] options = new String[] { + "Yes", "No" + }; + pane.setOptions(options); + + // highlight the safest option ala apple hig + pane.setInitialValue(options[0]); + + JDialog dialog = pane.createDialog(editor, null); + dialog.setVisible(true); + + Object result = pane.getValue(); + if (result == options[0]) { + return JOptionPane.YES_OPTION; + } else if (result == options[1]) { + return JOptionPane.NO_OPTION; + } else { + return JOptionPane.CLOSED_OPTION; + } + } + } + + /** * Retrieve a path to something in the Processing folder. Eventually this * may refer to the Contents subfolder of Processing.app, if we bundle things @@ -1959,6 +2079,36 @@ public class Base { } + + /** + * Read from a file with a bunch of attribute/value pairs + * that are separated by = and ignore comments with #. + */ + static public HashMap readSettings(File inputFile) { + HashMap outgoing = new HashMap(); + if (!inputFile.exists()) return outgoing; // return empty hash + + String lines[] = PApplet.loadStrings(inputFile); + for (int i = 0; i < lines.length; i++) { + int hash = lines[i].indexOf('#'); + String line = (hash == -1) ? + lines[i].trim() : lines[i].substring(0, hash).trim(); + if (line.length() == 0) continue; + + int equals = line.indexOf('='); + if (equals == -1) { + System.err.println("ignoring illegal line in " + inputFile); + System.err.println(" " + line); + continue; + } + String attr = line.substring(0, equals).trim(); + String valu = line.substring(equals + 1).trim(); + outgoing.put(attr, valu); + } + return outgoing; + } + + static public void copyFile(File sourceFile, File targetFile) throws IOException { InputStream from = @@ -2116,7 +2266,7 @@ public class Base { static public String[] listFiles(File folder, boolean relative) { String path = folder.getAbsolutePath(); - Vector vector = new Vector(); + Vector vector = new Vector(); listFiles(relative ? (path + File.separator) : "", path, vector); String outgoing[] = new String[vector.size()]; vector.copyInto(outgoing); @@ -2125,7 +2275,7 @@ public class Base { static protected void listFiles(String basePath, - String path, Vector vector) { + String path, Vector vector) { File folder = new File(path); String list[] = folder.list(); if (list == null) return; diff --git a/app/src/processing/app/Editor.java b/app/src/processing/app/Editor.java index 30ceb6b2b..831f02f80 100644 --- a/app/src/processing/app/Editor.java +++ b/app/src/processing/app/Editor.java @@ -43,7 +43,6 @@ import javax.swing.undo.*; import gnu.io.*; - /** * Main editor panel for the Processing Development Environment. */ @@ -114,7 +113,6 @@ public class Editor extends JFrame implements RunnerListener { EditorLineStatus lineStatus; - boolean newEditor = true; JEditorPane editorPane; JEditTextArea textarea; @@ -122,14 +120,14 @@ public class Editor extends JFrame implements RunnerListener { // runtime information and window placement Point sketchWindowLocation; - Runner runtime; + //Runner runtime; JMenuItem exportAppItem; JMenuItem saveMenuItem; JMenuItem saveAsMenuItem; boolean running; - boolean presenting; + //boolean presenting; boolean uploading; // undo fellers @@ -142,6 +140,12 @@ public class Editor extends JFrame implements RunnerListener { FindReplace find; + Runnable runHandler; + Runnable presentHandler; + Runnable stopHandler; + Runnable exportHandler; + Runnable exportAppHandler; + public Editor(Base ibase, String path, int[] location) { super("Arduino"); @@ -149,6 +153,9 @@ public class Editor extends JFrame implements RunnerListener { //Base.setIcon(this); + // Install default actions for Run, Present, etc. + resetHandlers(); + // add listener to handle window close box hit event addWindowListener(new WindowAdapter() { public void windowClosing(WindowEvent e) { @@ -232,22 +239,7 @@ public class Editor extends JFrame implements RunnerListener { lineStatus = new EditorLineStatus(textarea); consolePanel.add(lineStatus, BorderLayout.SOUTH); -// if (newEditor) { -// try { -// setupEditorPane(); -// upper.add(editorPane); -// } catch (Exception e1) { -// PrintWriter w = PApplet.createWriter(new File("/Users/fry/Desktop/blah.txt")); -// w.println(e1.getMessage()); -// e1.printStackTrace(w); -// w.flush(); -// w.close(); -//// e1.printStackTrace()); -//// e1.printStackTrace(System.out); -// } -// } else { upper.add(textarea); -// } splitPane = new JSplitPane(JSplitPane.VERTICAL_SPLIT, upper, consolePanel); @@ -276,64 +268,10 @@ public class Editor extends JFrame implements RunnerListener { listener = new EditorListener(this, textarea); pain.add(box); - pain.setTransferHandler(new TransferHandler() { + // get shift down/up events so we can show the alt version of toolbar buttons + textarea.addKeyListener(toolbar); - public boolean canImport(JComponent dest, DataFlavor[] flavors) { - return true; - } - - public boolean importData(JComponent src, Transferable transferable) { - int successful = 0; - - try { - DataFlavor uriListFlavor = - new DataFlavor("text/uri-list;class=java.lang.String"); - - if (transferable.isDataFlavorSupported(DataFlavor.javaFileListFlavor)) { - java.util.List list = (java.util.List) - transferable.getTransferData(DataFlavor.javaFileListFlavor); - for (int i = 0; i < list.size(); i++) { - File file = (File) list.get(i); - if (sketch.addFile(file)) { - successful++; - } - } - } else if (transferable.isDataFlavorSupported(uriListFlavor)) { - //System.out.println("uri list"); - String data = (String)transferable.getTransferData(uriListFlavor); - String[] pieces = PApplet.splitTokens(data, "\r\n"); - //PApplet.println(pieces); - for (int i = 0; i < pieces.length; i++) { - if (pieces[i].startsWith("#")) continue; - - String path = null; - if (pieces[i].startsWith("file:///")) { - path = pieces[i].substring(7); - } else if (pieces[i].startsWith("file:/")) { - path = pieces[i].substring(5); - } - if (sketch.addFile(new File(path))) { - successful++; - } - } - } - } catch (Exception e) { - e.printStackTrace(); - return false; - } - - if (successful == 0) { - statusError("No files were added to the sketch."); - - } else if (successful == 1) { - statusNotice("One file added to the sketch."); - - } else { - statusNotice(successful + " files added to the sketch."); - } - return true; - } - }); + pain.setTransferHandler(new FileDropHandler()); // System.out.println("t1"); @@ -345,6 +283,20 @@ public class Editor extends JFrame implements RunnerListener { // Set the window bounds and the divider location before setting it visible setPlacement(location); + + // If the window is resized too small this will resize it again to the + // minimums. Adapted by Chris Lonnen from comments here: + // http://bugs.sun.com/bugdatabase/view_bug.do?bug_id=4320050 + // as a fix for http://dev.processing.org/bugs/show_bug.cgi?id=25 + final int minW = Preferences.getInteger("editor.window.width.min"); + final int minH = Preferences.getInteger("editor.window.height.min"); + addComponentListener(new java.awt.event.ComponentAdapter() { + public void componentResized(ComponentEvent event) { + setSize((getWidth() < minW) ? minW : getWidth(), + (getHeight() < minH) ? minH : getHeight()); + } + }); + // System.out.println("t3"); // Bring back the general options for the editor @@ -363,46 +315,71 @@ public class Editor extends JFrame implements RunnerListener { } - /* - // http://wiki.netbeans.org/DevFaqEditorCodeCompletionAnyJEditorPane - void setupEditorPane() throws IOException { - editorPane = new JEditorPane(); + /** + * Handles files dragged & dropped from the desktop and into the editor + * window. Dragging files into the editor window is the same as using + * "Sketch → Add File" for each file. + */ + class FileDropHandler extends TransferHandler { + public boolean canImport(JComponent dest, DataFlavor[] flavors) { + return true; + } - // This will find the Java editor kit and associate it with - // our editor pane. But that does not give us code completion - // just yet because we have no Java context (i.e. no class path, etc.). - // However, this does give us syntax coloring. - EditorKit kit = CloneableEditorSupport.getEditorKit("text/x-java"); - editorPane.setEditorKit(kit); - - // You can specify any ".java" file. - // If the file does not exist, it will be created. - // The contents of the file does not matter. - // The extension must be ".java", however. -// String newSourcePath = "/Users/fry/Desktop/tmp.java"; + @SuppressWarnings("unchecked") + public boolean importData(JComponent src, Transferable transferable) { + int successful = 0; -// File tmpFile = new File(newSourcePath); -// System.out.println(tmpFile.getParent() + " " + tmpFile.getName()); -// FileObject fob = FileUtil.createData(tmpFile); - File tmpFile = File.createTempFile("temp", ".java"); - FileObject fob = FileUtil.toFileObject(FileUtil.normalizeFile(tmpFile)); + try { + DataFlavor uriListFlavor = + new DataFlavor("text/uri-list;class=java.lang.String"); - DataObject dob = DataObject.find(fob); - editorPane.getDocument().putProperty(Document.StreamDescriptionProperty, dob); + if (transferable.isDataFlavorSupported(DataFlavor.javaFileListFlavor)) { + java.util.List list = (java.util.List) + transferable.getTransferData(DataFlavor.javaFileListFlavor); + for (int i = 0; i < list.size(); i++) { + File file = (File) list.get(i); + if (sketch.addFile(file)) { + successful++; + } + } + } else if (transferable.isDataFlavorSupported(uriListFlavor)) { + // Some platforms (Mac OS X and Linux, when this began) preferred + // this method of moving files. + String data = (String)transferable.getTransferData(uriListFlavor); + String[] pieces = PApplet.splitTokens(data, "\r\n"); + for (int i = 0; i < pieces.length; i++) { + if (pieces[i].startsWith("#")) continue; - // This sets up a default class path for us so that - // we can find all the JDK classes via code completion. - DialogBinding.bindComponentToFile(fob, 0, 0, editorPane); + String path = null; + if (pieces[i].startsWith("file:///")) { + path = pieces[i].substring(7); + } else if (pieces[i].startsWith("file:/")) { + path = pieces[i].substring(5); + } + if (sketch.addFile(new File(path))) { + successful++; + } + } + } + } catch (Exception e) { + e.printStackTrace(); + return false; + } - // Last but not least, we need to fill the editor pane with - // some initial dummy code - as it seems somehow required to - // kick-start code completion. - // A simple dummy package declaration will do. - editorPane.setText("package dummy;"); + if (successful == 0) { + statusError("No files were added to the sketch."); + + } else if (successful == 1) { + statusNotice("One file added to the sketch."); + + } else { + statusNotice(successful + " files added to the sketch."); + } + return true; + } } - */ - - + + protected void setPlacement(int[] location) { setBounds(location[0], location[1], location[2], location[3]); if (location[4] != 0) { @@ -434,10 +411,10 @@ public class Editor extends JFrame implements RunnerListener { * This appears to only be required on OS X 10.2, and is not * even being called on later versions of OS X or Windows. */ - public Dimension getMinimumSize() { - //System.out.println("getting minimum size"); - return new Dimension(500, 550); - } +// public Dimension getMinimumSize() { +// //System.out.println("getting minimum size"); +// return new Dimension(500, 550); +// } // . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . @@ -737,7 +714,7 @@ public class Editor extends JFrame implements RunnerListener { protected void addTools(JMenu menu, File sourceFolder) { - HashMap toolItems = new HashMap(); + HashMap toolItems = new HashMap(); File[] folders = sourceFolder.listFiles(new FileFilter() { public boolean accept(File folder) { @@ -807,7 +784,7 @@ public class Editor extends JFrame implements RunnerListener { // If no class name found, just move on. if (className == null) continue; - Class toolClass = Class.forName(className, true, loader); + Class toolClass = Class.forName(className, true, loader); final Tool tool = (Tool) toolClass.newInstance(); tool.init(Editor.this); @@ -817,6 +794,7 @@ public class Editor extends JFrame implements RunnerListener { item.addActionListener(new ActionListener() { public void actionPerformed(ActionEvent e) { SwingUtilities.invokeLater(tool); + //new Thread(tool).start(); } }); //menu.add(item); @@ -826,7 +804,7 @@ public class Editor extends JFrame implements RunnerListener { e.printStackTrace(); } } - ArrayList toolList = new ArrayList(toolItems.keySet()); + ArrayList toolList = new ArrayList(toolItems.keySet()); if (toolList.size() == 0) return; menu.addSeparator(); @@ -843,7 +821,7 @@ public class Editor extends JFrame implements RunnerListener { try { ZipFile zipFile = new ZipFile(file); - Enumeration entries = zipFile.entries(); + Enumeration entries = zipFile.entries(); while (entries.hasMoreElements()) { ZipEntry entry = (ZipEntry) entries.nextElement(); @@ -869,7 +847,7 @@ public class Editor extends JFrame implements RunnerListener { protected JMenuItem createToolMenuItem(String className) { try { - Class toolClass = Class.forName(className); + Class toolClass = Class.forName(className); final Tool tool = (Tool) toolClass.newInstance(); JMenuItem item = new JMenuItem(tool.getMenuTitle()); @@ -903,12 +881,14 @@ public class Editor extends JFrame implements RunnerListener { menu.add(createToolMenuItem("processing.app.tools.Archiver")); menu.add(createToolMenuItem("processing.app.tools.FixEncoding")); - /* - //menu.add(createToolMenuItem("processing.app.tools.android.Build")); - item = createToolMenuItem("processing.app.tools.android.Build"); - item.setAccelerator(KeyStroke.getKeyStroke('D', modifiers)); - menu.add(item); - */ +// // These are temporary entries while Android mode is being worked out. +// // The mode will not be in the tools menu, and won't involve a cmd-key +// if (!Base.RELEASE) { +// item = createToolMenuItem("processing.app.tools.android.AndroidTool"); +// item.setAccelerator(KeyStroke.getKeyStroke('D', modifiers)); +// menu.add(item); +// menu.add(createToolMenuItem("processing.app.tools.android.Reset")); +// } return menu; } @@ -1363,6 +1343,35 @@ public class Editor extends JFrame implements RunnerListener { // . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . + // these will be done in a more generic way soon, more like: + // setHandler("action name", Runnable); + // but for the time being, working out the kinks of how many things to + // abstract from the editor in this fashion. + + + public void setHandlers(Runnable runHandler, Runnable presentHandler, + Runnable stopHandler, + Runnable exportHandler, Runnable exportAppHandler) { + this.runHandler = runHandler; + this.presentHandler = presentHandler; + this.stopHandler = stopHandler; + this.exportHandler = exportHandler; + this.exportAppHandler = exportAppHandler; + } + + + public void resetHandlers() { + runHandler = new DefaultRunHandler(); + presentHandler = new DefaultPresentHandler(); + stopHandler = new DefaultStopHandler(); + exportHandler = new DefaultExportHandler(); + exportAppHandler = new DefaultExportAppHandler(); + } + + + // . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . + + /** * Gets the current sketch object. */ @@ -1799,26 +1808,50 @@ public class Editor extends JFrame implements RunnerListener { console.clear(); } - //presenting = present; - - SwingUtilities.invokeLater(new Runnable() { - public void run() { - try { - sketch.compile(verbose); - statusNotice("Done compiling."); - } catch (RunnerException e) { - //statusError("Error compiling..."); - statusError(e); - - } catch (Exception e) { - e.printStackTrace(); - } - - toolbar.deactivate(EditorToolbar.RUN); - } - }); + // Cannot use invokeLater() here, otherwise it gets + // placed on the event thread and causes a hang--bad idea all around. + new Thread(verbose ? presentHandler : runHandler).start(); } + // DAM: in Arduino, this is compile + class DefaultRunHandler implements Runnable { + public void run() { + try { + sketch.prepare(); + String appletClassName = sketch.build(false); + statusNotice("Done compiling."); + } catch (Exception e) { + statusError(e); + } + + toolbar.deactivate(EditorToolbar.RUN); + } + } + + // DAM: in Arduino, this is compile (with verbose output) + class DefaultPresentHandler implements Runnable { + public void run() { + try { + sketch.prepare(); + String appletClassName = sketch.build(true); + statusNotice("Done compiling."); + } catch (Exception e) { + statusError(e); + } + + toolbar.deactivate(EditorToolbar.RUN); + } + } + + class DefaultStopHandler implements Runnable { + public void run() { + try { + // DAM: we should try to kill the compilation or upload process here. + } catch (Exception e) { + statusError(e); + } + } + } /** * Set the location of the sketch run window. Used by Runner to update the @@ -1855,8 +1888,10 @@ public class Editor extends JFrame implements RunnerListener { /** - * Called by Runner to notify that the sketch has stopped running. - * Tools should not call this function, use handleStop() instead. + * Deactivate the Run button. This is called by Runner to notify that the + * sketch has stopped running, usually in response to an error (or maybe + * the sketch completing and exiting?) Tools should not call this function. + * To initiate a "stop" action, call handleStop() instead. */ public void internalRunnerClosed() { running = false; @@ -1870,11 +1905,9 @@ public class Editor extends JFrame implements RunnerListener { public void internalCloseRunner() { running = false; + if (stopHandler != null) try { - if (runtime != null) { - runtime.close(); // kills the window - runtime = null; // will this help? - } + stopHandler.run(); } catch (Exception e) { } sketch.cleanup(); @@ -1883,13 +1916,14 @@ public class Editor extends JFrame implements RunnerListener { /** * Check if the sketch is modified and ask user to save changes. - * Immediately should be set true when quitting, or when the save should - * not happen asynchronously. Come to think of it, that's always now? * @return false if canceling the close/quit operation */ - protected boolean checkModified(boolean immediately) { + protected boolean checkModified() { if (!sketch.isModified()) return true; + // As of Processing 1.0.10, this always happens immediately. + // http://dev.processing.org/bugs/show_bug.cgi?id=1456 + String prompt = "Save changes to " + sketch.getName() + "? "; if (!Base.isMacOS()) { @@ -1899,13 +1933,14 @@ public class Editor extends JFrame implements RunnerListener { JOptionPane.QUESTION_MESSAGE); if (result == JOptionPane.YES_OPTION) { - return handleSave(immediately); + return handleSave(true); } else if (result == JOptionPane.NO_OPTION) { return true; // ok to continue } else if (result == JOptionPane.CANCEL_OPTION) { return false; + } else { throw new IllegalStateException(); } @@ -1950,7 +1985,7 @@ public class Editor extends JFrame implements RunnerListener { Object result = pane.getValue(); if (result == options[0]) { // save (and close/quit) - return handleSave(immediately); + return handleSave(true); } else if (result == options[2]) { // don't save (still close/quit) return true; @@ -2203,39 +2238,69 @@ public class Editor extends JFrame implements RunnerListener { synchronized public void handleExport(final boolean verbose) { //if (!handleExportCheckModified()) return; toolbar.activate(EditorToolbar.EXPORT); - console.clear(); statusNotice("Uploading to I/O Board..."); - //SwingUtilities.invokeLater(new Runnable() { - Thread t = new Thread(new Runnable() { - public void run() { - try { - serialMonitor.closeSerialPort(); - serialMonitor.setVisible(false); - - uploading = true; - - boolean success = sketch.exportApplet(verbose); - if (success) { - statusNotice("Done uploading."); - } else { - // error message will already be visible - } - } catch (RunnerException e) { - //statusError("Error during upload."); - //e.printStackTrace(); - statusError(e); - } catch (Exception e) { - e.printStackTrace(); - } - uploading = false; - //toolbar.clear(); - toolbar.deactivate(EditorToolbar.EXPORT); - }}); - t.start(); + new Thread(verbose ? exportAppHandler : exportHandler).start(); } + // DAM: in Arduino, this is upload + class DefaultExportHandler implements Runnable { + public void run() { + + try { + serialMonitor.closeSerialPort(); + serialMonitor.setVisible(false); + + uploading = true; + + boolean success = sketch.exportApplet(false); + if (success) { + statusNotice("Done uploading."); + } else { + // error message will already be visible + } + } catch (RunnerException e) { + //statusError("Error during upload."); + //e.printStackTrace(); + statusError(e); + } catch (Exception e) { + e.printStackTrace(); + } + uploading = false; + //toolbar.clear(); + toolbar.deactivate(EditorToolbar.EXPORT); + } + } + + // DAM: in Arduino, this is upload (with verbose output) + class DefaultExportAppHandler implements Runnable { + public void run() { + + try { + serialMonitor.closeSerialPort(); + serialMonitor.setVisible(false); + + uploading = true; + + boolean success = sketch.exportApplet(true); + if (success) { + statusNotice("Done uploading."); + } else { + // error message will already be visible + } + } catch (RunnerException e) { + //statusError("Error during upload."); + //e.printStackTrace(); + statusError(e); + } catch (Exception e) { + e.printStackTrace(); + } + uploading = false; + //toolbar.clear(); + toolbar.deactivate(EditorToolbar.EXPORT); + } + } /** * Checks to see if the sketch has been modified, and if so, @@ -2418,7 +2483,7 @@ public class Editor extends JFrame implements RunnerListener { } statusError(mess); } - e.printStackTrace(); +// e.printStackTrace(); } @@ -2563,4 +2628,3 @@ public class Editor extends JFrame implements RunnerListener { } } } - diff --git a/app/src/processing/app/EditorConsole.java b/app/src/processing/app/EditorConsole.java index 002fb3edd..38cf00fc2 100644 --- a/app/src/processing/app/EditorConsole.java +++ b/app/src/processing/app/EditorConsole.java @@ -28,6 +28,7 @@ import java.awt.event.*; import java.io.*; import javax.swing.*; import javax.swing.text.*; + import java.util.*; @@ -47,8 +48,6 @@ public class EditorConsole extends JScrollPane { MutableAttributeSet stdStyle; MutableAttributeSet errStyle; - boolean cerror; - int maxLineCount; static File errFile; @@ -221,18 +220,9 @@ public class EditorConsole extends JScrollPane { public void write(byte b[], int offset, int length, boolean err) { - if (err != cerror) { - // advance the line because switching between err/out streams - // potentially, could check whether we're already on a new line - message("", cerror, true); - } - // we could do some cross platform CR/LF mangling here before outputting - // add text to output document message(new String(b, offset, length), err, false); - // set last error state - cerror = err; } @@ -291,10 +281,10 @@ public class EditorConsole extends JScrollPane { // . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . - class EditorConsoleStream extends OutputStream { + private static class EditorConsoleStream extends OutputStream { //static EditorConsole current; - boolean err; // whether stderr or stdout - byte single[] = new byte[1]; + final boolean err; // whether stderr or stdout + final byte single[] = new byte[1]; public EditorConsoleStream(boolean err) { this.err = err; @@ -389,7 +379,7 @@ public class EditorConsole extends JScrollPane { * swing event thread, so they need to be synchronized */ class BufferedStyledDocument extends DefaultStyledDocument { - ArrayList elements = new ArrayList(); + ArrayList elements = new ArrayList(); int maxLineLength, maxLineCount; int currentLineLength = 0; boolean needLineBreak = false; diff --git a/app/src/processing/app/EditorListener.java b/app/src/processing/app/EditorListener.java index ffd05b022..58c3fc9a1 100644 --- a/app/src/processing/app/EditorListener.java +++ b/app/src/processing/app/EditorListener.java @@ -103,6 +103,10 @@ public class EditorListener { char c = event.getKeyChar(); int code = event.getKeyCode(); +// if (code == KeyEvent.VK_SHIFT) { +// editor.toolbar.setShiftPressed(true); +// } + //System.out.println((int)c + " " + code + " " + event); //System.out.println(); @@ -457,6 +461,13 @@ public class EditorListener { } +// public boolean keyReleased(KeyEvent event) { +// if (code == KeyEvent.VK_SHIFT) { +// editor.toolbar.setShiftPressed(false); +// } +// } + + public boolean keyTyped(KeyEvent event) { char c = event.getKeyChar(); diff --git a/app/src/processing/app/EditorToolbar.java b/app/src/processing/app/EditorToolbar.java index 6a5fe2214..74ef71f94 100644 --- a/app/src/processing/app/EditorToolbar.java +++ b/app/src/processing/app/EditorToolbar.java @@ -3,7 +3,7 @@ /* Part of the Processing project - http://processing.org - Copyright (c) 2004-08 Ben Fry and Casey Reas + Copyright (c) 2004-09 Ben Fry and Casey Reas Copyright (c) 2001-04 Massachusetts Institute of Technology This program is free software; you can redistribute it and/or modify @@ -25,6 +25,7 @@ package processing.app; import java.awt.*; import java.awt.event.*; + import javax.swing.*; import javax.swing.event.*; @@ -32,12 +33,18 @@ import javax.swing.event.*; /** * run/stop/etc buttons for the ide */ -public class EditorToolbar extends JComponent implements MouseInputListener { +public class EditorToolbar extends JComponent implements MouseInputListener, KeyListener { + /** Rollover titles for each button. */ static final String title[] = { "Verify", "Stop", "New", "Open", "Save", "Upload", "Serial Monitor" }; + /** Titles for each button when the shift key is pressed. */ + static final String titleShift[] = { + "Verify (w/ Verbose Output)", "Stop", "New Editor Window", "Open in Another Window", "Save", "Upload (w/ Verbose Output)", "Serial Monitor" + }; + static final int BUTTON_COUNT = title.length; /** Width of each toolbar button. */ static final int BUTTON_WIDTH = 27; @@ -45,6 +52,9 @@ public class EditorToolbar extends JComponent implements MouseInputListener { static final int BUTTON_HEIGHT = 32; /** The amount of space between groups of buttons on the toolbar. */ static final int BUTTON_GAP = 5; + /** Size of the button image being chopped up. */ + static final int BUTTON_IMAGE_SIZE = 33; + static final int RUN = 0; static final int STOP = 1; @@ -61,45 +71,35 @@ public class EditorToolbar extends JComponent implements MouseInputListener { static final int ACTIVE = 2; Editor editor; - //boolean disableRun; // this was for library - //Label status; Image offscreen; int width, height; Color bgcolor; - static Image buttons; - static Image inactive[]; - static Image rollover[]; - static Image active[]; + static Image[][] buttonImages; int currentRollover; - //int currentSelection; JPopupMenu popup; JMenu menu; int buttonCount; - int state[] = new int[BUTTON_COUNT]; - Image stateImage[]; + int[] state = new int[BUTTON_COUNT]; + Image[] stateImage; int which[]; // mapping indices to implementation int x1[], x2[]; int y1, y2; - String status; Font statusFont; Color statusColor; + boolean shiftPressed; public EditorToolbar(Editor editor, JMenu menu) { this.editor = editor; this.menu = menu; - if (buttons == null) { - buttons = Base.getThemeImage("buttons.gif", this); - } - buttonCount = 0; which = new int[BUTTON_COUNT]; @@ -115,9 +115,6 @@ public class EditorToolbar extends JComponent implements MouseInputListener { currentRollover = -1; bgcolor = Theme.getColor("buttons.bgcolor"); - - status = ""; - statusFont = Theme.getFont("buttons.status.font"); statusColor = Theme.getColor("buttons.status.color"); @@ -125,30 +122,28 @@ public class EditorToolbar extends JComponent implements MouseInputListener { addMouseMotionListener(this); } - - public void paintComponent(Graphics screen) { - // this data is shared by all EditorToolbar instances - if (inactive == null) { - inactive = new Image[BUTTON_COUNT]; - rollover = new Image[BUTTON_COUNT]; - active = new Image[BUTTON_COUNT]; - - int IMAGE_SIZE = 33; + protected void loadButtons() { + Image allButtons = Base.getThemeImage("buttons.gif", this); + buttonImages = new Image[BUTTON_COUNT][3]; for (int i = 0; i < BUTTON_COUNT; i++) { - inactive[i] = createImage(BUTTON_WIDTH, BUTTON_HEIGHT); - Graphics g = inactive[i].getGraphics(); - g.drawImage(buttons, -(i*IMAGE_SIZE) - 3, -2*IMAGE_SIZE, null); - - rollover[i] = createImage(BUTTON_WIDTH, BUTTON_HEIGHT); - g = rollover[i].getGraphics(); - g.drawImage(buttons, -(i*IMAGE_SIZE) - 3, -1*IMAGE_SIZE, null); - - active[i] = createImage(BUTTON_WIDTH, BUTTON_HEIGHT); - g = active[i].getGraphics(); - g.drawImage(buttons, -(i*IMAGE_SIZE) - 3, -0*IMAGE_SIZE, null); + for (int state = 0; state < 3; state++) { + Image image = createImage(BUTTON_WIDTH, BUTTON_HEIGHT); + Graphics g = image.getGraphics(); + g.drawImage(allButtons, + -(i*BUTTON_IMAGE_SIZE) - 3, + (-2 + state)*BUTTON_IMAGE_SIZE, null); + buttonImages[i][state] = image; } } + } + + @Override + public void paintComponent(Graphics screen) { + // this data is shared by all EditorToolbar instances + if (buttonImages == null) { + loadButtons(); + } // this happens once per instance of EditorToolbar if (stateImage == null) { @@ -191,21 +186,34 @@ public class EditorToolbar extends JComponent implements MouseInputListener { /* // if i ever find the guy who wrote the java2d api, i will hurt him. + * + * whereas I love the Java2D API. --jdf. lol. + * Graphics2D g2 = (Graphics2D) g; FontRenderContext frc = g2.getFontRenderContext(); float statusW = (float) statusFont.getStringBounds(status, frc).getWidth(); float statusX = (getSize().width - statusW) / 2; g2.drawString(status, statusX, statusY); */ - //int statusY = (BUTTON_HEIGHT + statusFont.getAscent()) / 2; + if (currentRollover != -1) { int statusY = (BUTTON_HEIGHT + g.getFontMetrics().getAscent()) / 2; + String status = shiftPressed ? titleShift[currentRollover] : title[currentRollover]; g.drawString(status, buttonCount * BUTTON_WIDTH + 3 * BUTTON_GAP, statusY); + } screen.drawImage(offscreen, 0, 0, null); + + if (!isEnabled()) { + screen.setColor(new Color(0,0,0,100)); + screen.fillRect(0, 0, getWidth(), getHeight()); + } } public void mouseMoved(MouseEvent e) { + if (!isEnabled()) + return; + // mouse events before paint(); if (state == null) return; @@ -213,16 +221,17 @@ public class EditorToolbar extends JComponent implements MouseInputListener { // avoid flicker, since there will probably be an update event setState(OPEN, INACTIVE, false); } - //System.out.println(e); - //mouseMove(e); - handleMouse(e.getX(), e.getY()); + handleMouse(e); } public void mouseDragged(MouseEvent e) { } - public void handleMouse(int x, int y) { + public void handleMouse(MouseEvent e) { + int x = e.getX(); + int y = e.getY(); + if (currentRollover != -1) { if ((x > x1[currentRollover]) && (y > y1) && (x < x2[currentRollover]) && (y < y2)) { @@ -230,7 +239,6 @@ public class EditorToolbar extends JComponent implements MouseInputListener { } else { setState(currentRollover, INACTIVE, true); - messageClear(title[currentRollover]); currentRollover = -1; } } @@ -238,10 +246,8 @@ public class EditorToolbar extends JComponent implements MouseInputListener { if (sel == -1) return; if (state[sel] != ACTIVE) { - //if (!(disableRun && ((sel == RUN) || (sel == STOP)))) { setState(sel, ROLLOVER, true); currentRollover = sel; - //} } } @@ -263,32 +269,16 @@ public class EditorToolbar extends JComponent implements MouseInputListener { private void setState(int slot, int newState, boolean updateAfter) { - //if (inactive == null) return; state[slot] = newState; - switch (newState) { - case INACTIVE: - stateImage[slot] = inactive[which[slot]]; - break; - case ACTIVE: - stateImage[slot] = active[which[slot]]; - break; - case ROLLOVER: - stateImage[slot] = rollover[which[slot]]; - message(title[which[slot]]); - break; - } + stateImage[slot] = buttonImages[which[slot]][newState]; if (updateAfter) { - //System.out.println("trying to update " + slot + " " + state[slot]); - //new Exception("setting slot " + slot + " to " + state[slot]).printStackTrace(); - repaint(); // changed for swing from update(); - //Toolkit.getDefaultToolkit().sync(); + repaint(); } } public void mouseEntered(MouseEvent e) { - //mouseMove(e); - handleMouse(e.getX(), e.getY()); + handleMouse(e); } @@ -300,14 +290,18 @@ public class EditorToolbar extends JComponent implements MouseInputListener { if (state[OPEN] != INACTIVE) { setState(OPEN, INACTIVE, true); } - status = ""; - handleMouse(e.getX(), e.getY()); + handleMouse(e); } int wasDown = -1; public void mousePressed(MouseEvent e) { + + // jdf + if (!isEnabled()) + return; + final int x = e.getX(); final int y = e.getY(); @@ -331,8 +325,11 @@ public class EditorToolbar extends JComponent implements MouseInputListener { break; case NEW: - //editor.base.handleNew(e.isShiftDown()); + if (shiftPressed) { + editor.base.handleNew(); + } else { editor.base.handleNewReplace(); + } break; case SAVE: @@ -353,84 +350,26 @@ public class EditorToolbar extends JComponent implements MouseInputListener { public void mouseClicked(MouseEvent e) { } - public void mouseReleased(MouseEvent e) { - /* - switch (currentSelection) { - - case OPEN: - setState(OPEN, INACTIVE, true); - break; - } - currentSelection = -1; - */ - } - - - //public void disableRun(boolean what) { - //disableRun = what; - //} - - - /* - public void run() { - if (inactive == null) return; - clear(); - setState(RUN, ACTIVE, true); - } - */ - -// public void running(boolean yesno) { -// setState(RUN, yesno ? ACTIVE : INACTIVE, true); -// } + public void mouseReleased(MouseEvent e) { } /** * Set a particular button to be active. */ public void activate(int what) { - //System.out.println("activating " + what); - if (inactive == null) return; + if (buttonImages != null) { setState(what, ACTIVE, true); } - - //public void clearRun() { - //if (inactive == null) return; - //setState(RUN, INACTIVE, true); - //} + } /** * Set a particular button to be active. */ public void deactivate(int what) { - if (inactive == null) return; // don't draw if not ready + if (buttonImages != null) { setState(what, INACTIVE, true); } - - /** - * Clear all the state of all buttons. - */ -// public void clear() { // (int button) { -// if (inactive == null) return; -// -// System.out.println("clearing state of buttons"); -// // skip the run button, do the others -// for (int i = 1; i < buttonCount; i++) { -// setState(i, INACTIVE, false); -// } -// repaint(); // changed for swing from update(); -// } - - - public void message(String msg) { - //status.setText(msg + " "); // don't mind the hack - status = msg; - } - - - public void messageClear(String msg) { - //if (status.getText().equals(msg + " ")) status.setText(Editor.EMPTY); - if (status.equals(msg)) status = ""; } @@ -447,4 +386,23 @@ public class EditorToolbar extends JComponent implements MouseInputListener { public Dimension getMaximumSize() { return new Dimension(3000, BUTTON_HEIGHT); } + + + public void keyPressed(KeyEvent e) { + if (e.getKeyCode() == KeyEvent.VK_SHIFT) { + shiftPressed = true; + repaint(); +} + } + + + public void keyReleased(KeyEvent e) { + if (e.getKeyCode() == KeyEvent.VK_SHIFT) { + shiftPressed = false; + repaint(); + } + } + + + public void keyTyped(KeyEvent e) { } } diff --git a/app/src/processing/app/Platform.java b/app/src/processing/app/Platform.java index 28fe66c99..9fd0fd972 100644 --- a/app/src/processing/app/Platform.java +++ b/app/src/processing/app/Platform.java @@ -26,6 +26,9 @@ import java.io.File; import javax.swing.UIManager; +import com.sun.jna.Library; +import com.sun.jna.Native; + /** * Used by Base for platform-specific tweaking, for instance finding the @@ -129,6 +132,36 @@ public class Platform { // . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . + public interface CLibrary extends Library { + CLibrary INSTANCE = (CLibrary)Native.loadLibrary("c", CLibrary.class); + int setenv(String name, String value, int overwrite); + String getenv(String name); + int unsetenv(String name); + int putenv(String string); + } + + + public void setenv(String variable, String value) { + CLibrary clib = CLibrary.INSTANCE; + clib.setenv(variable, value, 1); + } + + + public String getenv(String variable) { + CLibrary clib = CLibrary.INSTANCE; + return clib.getenv(variable); + } + + + public int unsetenv(String variable) { + CLibrary clib = CLibrary.INSTANCE; + return clib.unsetenv(variable); + } + + + // . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . + + protected void showLauncherWarning() { Base.showWarning("No launcher available", "Unspecified platform, no launcher available.\n" + diff --git a/app/src/processing/app/Preferences.java b/app/src/processing/app/Preferences.java index a2b790bba..ffc63f7ae 100644 --- a/app/src/processing/app/Preferences.java +++ b/app/src/processing/app/Preferences.java @@ -626,6 +626,11 @@ public class Preferences { } + static public void unset(String attribute) { + table.remove(attribute); + } + + static public boolean getBoolean(String attribute) { String value = get(attribute); //, null); return (new Boolean(value)).booleanValue(); diff --git a/app/src/processing/app/Sketch.java b/app/src/processing/app/Sketch.java index 29c2c3976..34b76d8d0 100644 --- a/app/src/processing/app/Sketch.java +++ b/app/src/processing/app/Sketch.java @@ -3,7 +3,7 @@ /* Part of the Processing project - http://processing.org - Copyright (c) 2004-09 Ben Fry and Casey Reas + Copyright (c) 2004-10 Ben Fry and Casey Reas Copyright (c) 2001-04 Massachusetts Institute of Technology This program is free software; you can redistribute it and/or modify @@ -95,6 +95,9 @@ public class Sketch { * DLLs or JNILIBs. */ private String libraryPath; + /** + * List of library folders. + */ private ArrayList importedLibraries; /** @@ -1165,11 +1168,14 @@ public class Sketch { * X. afterwards, some of these steps need a cleanup function * */ - protected String compile(boolean verbose) - throws RunnerException { - - String name; - + //protected String compile() throws RunnerException { + + + /** + * When running from the editor, take care of preparations before running + * the build. + */ + public void prepare() { // make sure the user didn't hide the sketch folder ensureExistence(); @@ -1199,11 +1205,8 @@ public class Sketch { // better connected to the dataFolder stuff below. cleanup(); - // handle preprocessing the main file's code - name = build(tempBuildFolder.getAbsolutePath(), verbose); - size(tempBuildFolder.getAbsolutePath(), name); - - return name; +// // handle preprocessing the main file's code +// return build(tempBuildFolder.getAbsolutePath()); } @@ -1255,14 +1258,6 @@ public class Sketch { // 1. concatenate all .pde files to the 'main' pde // store line number for starting point of each code bit - // Unfortunately, the header has to be written on a single line, because - // there's no way to determine how long it will be until the code has - // already been preprocessed. The header will vary in length based on - // the programming mode (STATIC, ACTIVE, or JAVA), which is determined - // by the preprocessor. So the preprocOffset for the primary class remains - // zero, even though it'd be nice to have a legitimate offset, and be able - // to remove the 'pretty' boolean for preproc.write(). - StringBuffer bigCode = new StringBuffer(); int bigCount = 0; for (SketchCode sc : code) { @@ -1271,29 +1266,9 @@ public class Sketch { bigCode.append(sc.getProgram()); bigCode.append('\n'); bigCount += sc.getLineCount(); -// if (sc != code[0]) { -// sc.setPreprocName(null); // don't compile me -// } } } - /* - String program = code[0].getProgram(); - StringBuffer bigCode = new StringBuffer(program); - int bigCount = code[0].getLineCount(); - bigCode.append('\n'); - - for (int i = 1; i < codeCount; i++) { - if (code[i].isExtension("pde")) { - code[i].setPreprocOffset(bigCount); - bigCode.append(code[i].getProgram()); - bigCode.append('\n'); - bigCount += code[i].getLineCount(); - code[i].setPreprocName(null); // don't compile me - } - } - */ - // Note that the headerOffset isn't applied until compile and run, because // it only applies to the code after it's been written to the .java file. int headerOffset = 0; @@ -1391,6 +1366,134 @@ public class Sketch { } + public ArrayList getImportedLibraries() { + return importedLibraries; + } + + + /** + * Map an error from a set of processed .java files back to its location + * in the actual sketch. + * @param message The error message. + * @param filename The .java file where the exception was found. + * @param line Line number of the .java file for the exception (1-indexed) + * @return A RunnerException to be sent to the editor, or null if it wasn't + * possible to place the exception to the sketch code. + */ +// public RunnerException placeExceptionAlt(String message, +// String filename, int line) { +// String appletJavaFile = appletClassName + ".java"; +// SketchCode errorCode = null; +// if (filename.equals(appletJavaFile)) { +// for (SketchCode code : getCode()) { +// if (code.isExtension("pde")) { +// if (line >= code.getPreprocOffset()) { +// errorCode = code; +// } +// } +// } +// } else { +// for (SketchCode code : getCode()) { +// if (code.isExtension("java")) { +// if (filename.equals(code.getFileName())) { +// errorCode = code; +// } +// } +// } +// } +// int codeIndex = getCodeIndex(errorCode); +// +// if (codeIndex != -1) { +// //System.out.println("got line num " + lineNumber); +// // in case this was a tab that got embedded into the main .java +// line -= getCode(codeIndex).getPreprocOffset(); +// +// // lineNumber is 1-indexed, but editor wants zero-indexed +// line--; +// +// // getMessage() will be what's shown in the editor +// RunnerException exception = +// new RunnerException(message, codeIndex, line, -1); +// exception.hideStackTrace(); +// return exception; +// } +// return null; +// } + + + /** + * Map an error from a set of processed .java files back to its location + * in the actual sketch. + * @param message The error message. + * @param filename The .java file where the exception was found. + * @param line Line number of the .java file for the exception (0-indexed!) + * @return A RunnerException to be sent to the editor, or null if it wasn't + * possible to place the exception to the sketch code. + */ + public RunnerException placeException(String message, + String dotJavaFilename, + int dotJavaLine) { + int codeIndex = 0; //-1; + int codeLine = -1; + +// System.out.println("placing " + dotJavaFilename + " " + dotJavaLine); +// System.out.println("code count is " + getCodeCount()); + + // first check to see if it's a .java file + for (int i = 0; i < getCodeCount(); i++) { + SketchCode code = getCode(i); + if (code.isExtension("java")) { + if (dotJavaFilename.equals(code.getFileName())) { + codeIndex = i; + codeLine = dotJavaLine; + return new RunnerException(message, codeIndex, codeLine); + } + } + } + + // If not the preprocessed file at this point, then need to get out + if (!dotJavaFilename.equals(name + ".java")) { + return null; + } + + // if it's not a .java file, codeIndex will still be 0 + // this section searches through the list of .pde files + codeIndex = 0; + for (int i = 0; i < getCodeCount(); i++) { + SketchCode code = getCode(i); + + if (code.isExtension("pde")) { +// System.out.println("preproc offset is " + code.getPreprocOffset()); +// System.out.println("looking for line " + dotJavaLine); + if (code.getPreprocOffset() <= dotJavaLine) { + codeIndex = i; +// System.out.println("i'm thinkin file " + i); + codeLine = dotJavaLine - code.getPreprocOffset(); + } + } + } + // could not find a proper line number, so deal with this differently. + // but if it was in fact the .java file we're looking for, though, + // send the error message through. + // this is necessary because 'import' statements will be at a line + // that has a lower number than the preproc offset, for instance. +// if (codeLine == -1 && !dotJavaFilename.equals(name + ".java")) { +// return null; +// } + return new RunnerException(message, codeIndex, codeLine); + } + + + /** + * Run the build inside the temporary build folder. + * @return null if compilation failed, main class name if not + * @throws RunnerException + */ + public String build(boolean verbose) throws RunnerException { + return build(tempBuildFolder.getAbsolutePath(), verbose); + } + + /** * Preprocess and compile all the code for this sketch. * @@ -1410,6 +1513,7 @@ public class Sketch { // that will bubble up to whomever called build(). Compiler compiler = new Compiler(); if (compiler.compile(this, buildPath, primaryClassName, verbose)) { + size(buildPath, primaryClassName); return primaryClassName; } return null; @@ -1500,7 +1604,7 @@ public class Sketch { verbose); return success ? suggestedClassName : null; - } + } /** * Replace all commented portions of a given String as spaces. @@ -1538,7 +1642,8 @@ public class Sketch { break; } else { - index++; + // continue blanking this area + p[index++] = ' '; } } if (!endOfRainbow) { @@ -1562,8 +1667,8 @@ public class Sketch { * Export to application via GUI. */ protected boolean exportApplication() throws IOException, RunnerException { - return false; - } + return false; + } /** @@ -1571,8 +1676,8 @@ public class Sketch { */ public boolean exportApplication(String destPath, int exportPlatform) throws IOException, RunnerException { - return false; - } + return false; + } protected void addManifest(ZipOutputStream zos) throws IOException { @@ -1588,35 +1693,6 @@ public class Sketch { } - /** - * Read from a file with a bunch of attribute/value pairs - * that are separated by = and ignore comments with #. - */ - protected HashMap readSettings(File inputFile) { - HashMap outgoing = new HashMap(); - if (!inputFile.exists()) return outgoing; // return empty hash - - String lines[] = PApplet.loadStrings(inputFile); - for (int i = 0; i < lines.length; i++) { - int hash = lines[i].indexOf('#'); - String line = (hash == -1) ? - lines[i].trim() : lines[i].substring(0, hash).trim(); - if (line.length() == 0) continue; - - int equals = line.indexOf('='); - if (equals == -1) { - System.err.println("ignoring illegal line in " + inputFile); - System.err.println(" " + line); - continue; - } - String attr = line.substring(0, equals).trim(); - String valu = line.substring(equals + 1).trim(); - outgoing.put(attr, valu); - } - return outgoing; - } - - /** * Slurps up .class files from a colon (or semicolon on windows) * separated list of paths and adds them to a ZipOutputStream. @@ -1923,11 +1999,6 @@ public class Sketch { } - public ArrayList getImportedLibraries() { - return importedLibraries; - } - - public String getClassPath() { return classPath; } diff --git a/app/src/processing/app/StreamRedirectThread.java b/app/src/processing/app/StreamRedirectThread.java new file mode 100644 index 000000000..0d27a56e6 --- /dev/null +++ b/app/src/processing/app/StreamRedirectThread.java @@ -0,0 +1,95 @@ +/* + + * @(#)StreamRedirectThread.java 1.4 03/01/23 + * + * Copyright 2003 Sun Microsystems, Inc. All rights reserved. + * SUN PROPRIETARY/CONFIDENTIAL. Use is subject to license terms. + */ +/* + * Copyright (c) 1997-2001 by Sun Microsystems, Inc. All Rights Reserved. + * + * Sun grants you ("Licensee") a non-exclusive, royalty free, license to use, + * modify and redistribute this software in source and binary code form, + * provided that i) this copyright notice and license appear on all copies of + * the software; and ii) Licensee does not utilize the software in a manner + * which is disparaging to Sun. + * + * This software is provided "AS IS," without a warranty of any kind. ALL + * EXPRESS OR IMPLIED CONDITIONS, REPRESENTATIONS AND WARRANTIES, INCLUDING ANY + * IMPLIED WARRANTY OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE OR + * NON-INFRINGEMENT, ARE HEREBY EXCLUDED. SUN AND ITS LICENSORS SHALL NOT BE + * LIABLE FOR ANY DAMAGES SUFFERED BY LICENSEE AS A RESULT OF USING, MODIFYING + * OR DISTRIBUTING THE SOFTWARE OR ITS DERIVATIVES. IN NO EVENT WILL SUN OR ITS + * LICENSORS BE LIABLE FOR ANY LOST REVENUE, PROFIT OR DATA, OR FOR DIRECT, + * INDIRECT, SPECIAL, CONSEQUENTIAL, INCIDENTAL OR PUNITIVE DAMAGES, HOWEVER + * CAUSED AND REGARDLESS OF THE THEORY OF LIABILITY, ARISING OUT OF THE USE OF + * OR INABILITY TO USE SOFTWARE, EVEN IF SUN HAS BEEN ADVISED OF THE + * POSSIBILITY OF SUCH DAMAGES. + * + * This software is not designed or intended for use in on-line control of + * aircraft, air traffic, aircraft navigation or aircraft communications; or in + * the design, construction, operation or maintenance of any nuclear + * facility. Licensee represents and warrants that it will not use or + * redistribute the Software for such purposes. + */ +package processing.app; + +import java.io.*; + +/** + * StreamRedirectThread is a thread which copies it's input to + * it's output and terminates when it completes. + * + * @version @(#) StreamRedirectThread.java 1.4 03/01/23 23:33:38 + * @author Robert Field + */ +public class StreamRedirectThread extends Thread { + + private final Reader in; + private final Writer out; + + private static final int BUFFER_SIZE = 2048; + + + /** + * Set up for copy. + * @param name Name of the thread + * @param in Stream to copy from + * @param out Stream to copy to + */ + public StreamRedirectThread(String name, InputStream in, OutputStream out) { + super(name); + this.in = new InputStreamReader(in); + this.out = new OutputStreamWriter(out); + setPriority(Thread.MAX_PRIORITY-1); + } + + + public StreamRedirectThread(String name, Reader in, Writer out) { + super(name); + this.in = in; + this.out = out; + setPriority(Thread.MAX_PRIORITY-1); + } + + + /** + * Copy. + */ + public void run() { + try { + char[] cbuf = new char[BUFFER_SIZE]; + int count; + //System.out.println("opening streamredirectthread"); + while ((count = in.read(cbuf, 0, BUFFER_SIZE)) >= 0) { + out.write(cbuf, 0, count); + // had to add the flush() here.. maybe shouldn't be using writer? [fry] + out.flush(); + } + //System.out.println("exiting streamredirectthread"); + out.flush(); + } catch(IOException exc) { + System.err.println("Child I/O Transfer - " + exc); + } + } +} diff --git a/app/src/processing/app/WebServer.java b/app/src/processing/app/WebServer.java index 01f6cc39e..fc2089d8e 100644 --- a/app/src/processing/app/WebServer.java +++ b/app/src/processing/app/WebServer.java @@ -8,8 +8,12 @@ import java.util.zip.*; //import javax.swing.SwingUtilities; /** - * An example of a very simple, multi-threaded HTTP server. - * Taken from this article on java.sun.com. + * This code is placed here in anticipation of running the reference from an + * internal web server that reads the docs from a zip file, instead of using + * thousands of .html files on the disk, which is really inefficient. + *

+ * This is a very simple, multi-threaded HTTP server, originally based on + * this article on java.sun.com. */ public class WebServer implements HttpConstants { diff --git a/app/src/processing/app/debug/EventThread.java b/app/src/processing/app/debug/EventThread.java.disabled similarity index 98% rename from app/src/processing/app/debug/EventThread.java rename to app/src/processing/app/debug/EventThread.java.disabled index d4f93d503..4c68eeb47 100644 --- a/app/src/processing/app/debug/EventThread.java +++ b/app/src/processing/app/debug/EventThread.java.disabled @@ -65,7 +65,8 @@ public class EventThread extends Thread { // Maps ThreadReference to ThreadTrace instances private Map traceMap = new HashMap(); - EventThread(Runner parent, VirtualMachine vm, String[] excludes, PrintWriter writer) { + + public EventThread(Runner parent, VirtualMachine vm, String[] excludes, PrintWriter writer) { super("event-handler"); this.parent = parent; this.vm = vm; @@ -103,7 +104,7 @@ public class EventThread extends Thread { * @param excludes Class patterns for which we don't want events * @param watchFields Do we want to watch assignments to fields */ - void setEventRequests(boolean watchFields) { + public void setEventRequests(boolean watchFields) { EventRequestManager mgr = vm.eventRequestManager(); // VMDeathRequest deathReq = mgr.createVMDeathRequest(); diff --git a/app/src/processing/app/debug/MessageSiphon.java b/app/src/processing/app/debug/MessageSiphon.java index 970fc4c8a..79a0920d5 100644 --- a/app/src/processing/app/debug/MessageSiphon.java +++ b/app/src/processing/app/debug/MessageSiphon.java @@ -29,7 +29,7 @@ import java.io.*; /** * Slurps up messages from compiler. */ -class MessageSiphon implements Runnable { +public class MessageSiphon implements Runnable { BufferedReader streamReader; Thread thread; MessageConsumer consumer; @@ -84,4 +84,9 @@ class MessageSiphon implements Runnable { thread = null; } } + + + public Thread getThread() { + return thread; +} } diff --git a/app/src/processing/app/debug/Runner.java b/app/src/processing/app/debug/Runner.java.disabled similarity index 52% rename from app/src/processing/app/debug/Runner.java rename to app/src/processing/app/debug/Runner.java.disabled index f439eeb98..e6af3f48d 100644 --- a/app/src/processing/app/debug/Runner.java +++ b/app/src/processing/app/debug/Runner.java.disabled @@ -24,6 +24,7 @@ package processing.app.debug; import processing.app.*; +import processing.app.preproc.PdePreprocessor; import processing.core.*; import java.awt.Point; @@ -49,60 +50,54 @@ public class Runner implements MessageConsumer { private boolean presenting; // Object that listens for error messages or exceptions. - private RunnerListener listener; + protected RunnerListener listener; // Running remote VM - private VirtualMachine vm; + protected VirtualMachine vm; // Thread transferring remote error stream to our error stream - private Thread errThread = null; + protected Thread errThread = null; // Thread transferring remote output stream to our output stream - private Thread outThread = null; + protected Thread outThread = null; // Mode for tracing the Trace program (default= 0 off) - private int debugTraceMode = 0; + protected int debugTraceMode = 0; // Do we want to watch assignments to fields - private boolean watchFields = false; + protected boolean watchFields = false; // Class patterns for which we don't want events - private String[] excludes = { + protected String[] excludes = { "java.*", "javax.*", "sun.*", "com.sun.*", "apple.*", "processing.*" }; - private RunnerException exception; + protected RunnerException exception; //private PrintStream leechErr; - private Editor editor; - private Sketch sketch; + protected Editor editor; + protected Sketch sketch; private String appletClassName; -// private boolean newMessage; -// private int messageLineCount; -// private boolean foundMessageSource; -// -// private SystemOutSiphon processInput; -// private OutputStream processOutput; -// private MessageSiphon processError; - - public Runner(Sketch sketch, String appletClassName, - boolean presenting, RunnerListener listener) { - this.sketch = sketch; - this.appletClassName = appletClassName; - this.presenting = presenting; + public Runner(RunnerListener listener, Sketch sketch) { this.listener = listener; + this.sketch = sketch; if (listener instanceof Editor) { this.editor = (Editor) listener; +// } else { +// System.out.println("actually it's a " + listener.getClass().getName()); } } - public void launch() { + public void launch(String appletClassName, boolean presenting) { + this.appletClassName = appletClassName; + this.presenting = presenting; + // TODO entire class is a total mess as of release 0136. // This will be cleaned up significantly over the next couple months. @@ -132,7 +127,7 @@ public class Runner implements MessageConsumer { protected String[] getMachineParams() { - ArrayList params = new ArrayList(); + ArrayList params = new ArrayList(); //params.add("-Xint"); // interpreted mode //params.add("-Xprof"); // profiler @@ -203,6 +198,13 @@ public class Runner implements MessageConsumer { protected String[] getSketchParams() { ArrayList params = new ArrayList(); + // It's dangerous to add your own main() to your code, + // but if you've done it, we'll respect your right to hang yourself. + // http://dev.processing.org/bugs/show_bug.cgi?id=1446 + if (PdePreprocessor.foundMain) { + params.add(appletClassName); + + } else { params.add("processing.core.PApplet"); // If there was a saved location (this guy has been run more than once) @@ -242,6 +244,7 @@ public class Runner implements MessageConsumer { } params.add(appletClassName); + } // String outgoing[] = new String[params.size()]; // params.toArray(outgoing); @@ -250,121 +253,11 @@ public class Runner implements MessageConsumer { } - /* - protected VirtualMachine launchVirtualMachine_sun(String[] vmParams, String[] classParams) { - //vm = launchTarget(sb.toString()); - LaunchingConnector connector = - findLaunchingConnector("com.sun.jdi.CommandLineLaunch"); - //Map arguments = connectorArguments(connector, mainArgs); - - PApplet.println(connector); // gets the defaults - - Map arguments = connector.defaultArguments(); - //System.out.println(arguments); - -// for (Iterator itr = arguments.keySet().iterator(); itr.hasNext(); ) { -// Connector.Argument argument = -// (Connector.Argument) arguments.get(itr.next()); -// System.out.println(argument); -// } - - //connector.transport(). - - Connector.Argument mainArg = - (Connector.Argument)arguments.get("main"); - if (mainArg == null) { - throw new Error("Bad launching connector"); - } - String mainArgs = ""; - //mainArgs = addArgument(mainArgs, className); - if (classParams != null) { - for (int i = 0; i < classParams.length; i++) { - mainArgs = addArgument(mainArgs, classParams[i], ' '); - } - } - mainArg.setValue(mainArgs); - - //System.out.println("main args are: "); - //System.out.println(mainArgs); - -// if (watchFields) { -// // We need a VM that supports watchpoints -// Connector.Argument optionArg = -// (Connector.Argument)arguments.get("options"); -// if (optionArg == null) { -// throw new Error("Bad launching connector"); -// } -// optionArg.setValue("-classic"); -// } - String optionArgs = ""; - for (int i = 0; i < vmParams.length; i++) { - optionArgs = addArgument(optionArgs, vmParams[i], ' '); - } - // prevent any incorrect transport address b.s. from being added - // -Xrunjdwp:transport=dt_socket,address=cincinnati118.ipcorporate.com:55422,suspend=y - //optionArgs = addArgument(optionArgs, "-agentlib:jdwp=transport=dt_socket,address=localhost:12345,suspend=y", ' '); - //optionArgs += " -Xrunjdwp:transport=dt_socket,address=localhost:55422,suspend=y"; - //optionArgs = optionArgs + " -agentlib:jdwp=transport=dt_socket"; - //optionArgs = addArgument(optionArgs, "-Xrunjdwp:transport=dt_socket,address=localhost:55422,suspend=y", ' '); - - //optionArgs = addArgument(optionArgs, "address=127.0.0.1:54321", ' '); - //optionArgs = addArgument(optionArgs, "localAddress", ' '); - - Connector.Argument optionArg = - (Connector.Argument)arguments.get("options"); - optionArg.setValue(optionArgs); - -// Connector.Argument addressArg = -// (Connector.Argument)arguments.get("address"); - //arguments.put("raw.address", new Connector.Argument("blah")); - //PApplet.println("it's gonna be " + addressArg); - - //arguments.put("address", "localhost"); - -// Connector.Argument addressArg = -// (Connector.Argument)arguments.get("address"); -// addressArg.setValue("localhost"); - -// System.out.println("option args are: "); -// System.out.println(arguments.get("options")); - - System.out.println("args are " + arguments); - - // com.sun.tools.jdi.SunCommandLineLauncher - - // http://java.sun.com/j2se/1.5.0/docs/guide/jpda/conninv.html#sunlaunch - try { - return connector.launch(arguments); - } catch (IOException exc) { - throw new Error("Unable to launch target VM: " + exc); - } catch (IllegalConnectorArgumentsException exc) { - throw new Error("Internal error: " + exc); - } catch (VMStartException exc) { - exc.printStackTrace(); - System.err.println(); - System.err.println("Could not run the sketch."); - System.err.println("Make sure that you haven't set the maximum available memory too high."); - System.err.println("For more information, read revisions.txt and Help -> Troubleshooting."); - //System.err.println("Target VM failed to initialize:"); - //System.err.println("msg is " + exc.getMessage()); - //exc.printStackTrace(); - //throw new Error("Target VM failed to initialize: " + - //exc.getMessage()); - //throw new Error(exc.getMessage()); - //throw new RunnerException(exc.getMessage()); - //editor.error(exc); - editor.error("Could not run the sketch."); - return null; - } - } - */ - - protected VirtualMachine launchVirtualMachine(String[] vmParams, String[] classParams) { //vm = launchTarget(sb.toString()); - LaunchingConnector connector = - findLaunchingConnector("com.sun.jdi.RawCommandLineLaunch"); + LaunchingConnector connector = (LaunchingConnector) + findConnector("com.sun.jdi.RawCommandLineLaunch"); //PApplet.println(connector); // gets the defaults //Map arguments = connectorArguments(connector, mainArgs); @@ -447,9 +340,10 @@ public class Runner implements MessageConsumer { } System.err.println("For more information, read revisions.txt and Help \u2192 Troubleshooting."); } - if (editor != null) { + // changing this to separate editor and listener [091124] + //if (editor != null) { listener.statusError("Could not run the sketch."); - } + //} return null; } } @@ -493,7 +387,7 @@ public class Runner implements MessageConsumer { * start threads to forward remote error and output streams, * resume the remote VM, wait for the final event, and shutdown. */ - void generateTrace(PrintWriter writer) { + protected void generateTrace(PrintWriter writer) { vm.setDebugTraceMode(debugTraceMode); EventThread eventThread = null; @@ -515,7 +409,7 @@ public class Runner implements MessageConsumer { // process.getErrorStream(), // System.err); MessageSiphon ms = new MessageSiphon(process.getErrorStream(), this); - errThread = ms.thread; + errThread = ms.getThread(); outThread = new StreamRedirectThread("output reader", process.getInputStream(), @@ -545,7 +439,6 @@ public class Runner implements MessageConsumer { if (editor != null) { editor.internalRunnerClosed(); } - } catch (InterruptedException exc) { // we don't interrupt } @@ -554,20 +447,10 @@ public class Runner implements MessageConsumer { } - /** - * Find a com.sun.jdi.CommandLineLaunch connector - */ - LaunchingConnector findLaunchingConnector(String connectorName) { - //VirtualMachineManager mgr = Bootstrap.virtualMachineManager(); - - // Get the default connector. - // Not useful here since they all need different args. -// System.out.println(Bootstrap.virtualMachineManager().defaultConnector()); -// return Bootstrap.virtualMachineManager().defaultConnector(); - + protected Connector findConnector(String connectorName) { List connectors = Bootstrap.virtualMachineManager().allConnectors(); - // code to list available connectors + // debug: code to list available connectors // Iterator iter2 = connectors.iterator(); // while (iter2.hasNext()) { // Connector connector = (Connector)iter2.next(); @@ -578,10 +461,10 @@ public class Runner implements MessageConsumer { while (iter.hasNext()) { Connector connector = (Connector)iter.next(); if (connector.name().equals(connectorName)) { - return (LaunchingConnector)connector; + return connector; } } - throw new Error("No launching connector"); + throw new Error("No connector"); } @@ -611,7 +494,17 @@ public class Runner implements MessageConsumer { // System.out.println(or.referenceType().fields()); // if (name.startsWith("java.lang.")) { // name = name.substring(10); - if (exceptionName.equals("java.lang.OutOfMemoryError")) { + if (!handleCommonErrors(exceptionName, message, listener)) { + reportException(message, event.thread()); + } + if (editor != null) { + editor.internalRunnerClosed(); + } + } + + public static boolean handleCommonErrors(final String exceptionClass, final String message, final RunnerListener listener) + { + if (exceptionClass.equals("java.lang.OutOfMemoryError")) { listener.statusError("OutOfMemoryError: You may need to increase the memory setting in Preferences."); System.err.println("An OutOfMemoryError means that your code is either using up too much memory"); System.err.println("because of a bug (e.g. creating an array that's too large, or unintentionally"); @@ -619,96 +512,83 @@ public class Runner implements MessageConsumer { System.err.println("If your sketch uses a lot of memory (for instance if it loads a lot of data files)"); System.err.println("you can increase the memory available to your sketch using the Preferences window."); - } else if (exceptionName.equals("java.lang.StackOverflowError")) { + } else if (exceptionClass.equals("java.lang.StackOverflowError")) { listener.statusError("StackOverflowError: This sketch is attempting too much recursion."); System.err.println("A StackOverflowError means that you have a bug that's causing a function"); System.err.println("to be called recursively (it's calling itself and going in circles),"); System.err.println("or you're intentionally calling a recursive function too much,"); System.err.println("and your code should be rewritten in a more efficient manner."); - } else if (exceptionName.equals("java.lang.UnsupportedClassVersionError")) { + } else if (exceptionClass.equals("java.lang.UnsupportedClassVersionError")) { listener.statusError("UnsupportedClassVersionError: A library is using code compiled with an unsupported version of Java."); System.err.println("This version of Processing only supports libraries and JAR files compiled for Java 1.5."); System.err.println("A library used by this sketch was compiled for Java 1.6 or later, "); System.err.println("and needs to be recompiled to be compatible with Java 1.5."); - - } else if (exceptionName.equals("java.lang.NoSuchMethodError") || exceptionName.equals("java.lang.NoSuchFieldError")) { - listener.statusError(exceptionName.substring(10) + ": You're probably using a library that's incompatible with this version of Processing."); - - } else if (message.equals("ClassNotFoundException: quicktime.std.StdQTException")) { - listener.statusError("Could not find QuickTime, please reinstall QuickTime 7 or later."); - + } else if (exceptionClass.equals("java.lang.NoSuchMethodError") || exceptionClass.equals("java.lang.NoSuchFieldError")) { + listener.statusError(exceptionClass.substring(10) + ": You're probably using a library that's incompatible with this version of Processing."); + } else if (message!=null && + message.equals("ClassNotFoundException: quicktime.std.StdQTException")) { + listener + .statusError("Could not find QuickTime, please reinstall QuickTime 7 or later."); } else { - reportException(message, event.thread()); + return false; } - editor.internalRunnerClosed(); + return true; } - - // This may be called more than one time per error in the VM, + // TODO: This may be called more than one time per error in the VM, // presumably because exceptions might be wrapped inside others, // and this will fire for both. protected void reportException(String message, ThreadReference thread) { - try { - int codeIndex = -1; - int lineNumber = -1; + listener.statusError(findException(message, thread)); + } + + + /** + * Move through a list of stack frames, searching for references to code + * found in the current sketch. Return with a RunnerException that contains + * the location of the error, or if nothing is found, just return with a + * RunnerException that wraps the error message itself. + */ + RunnerException findException(String message, ThreadReference thread) { + try { + // use to dump the stack for debugging +// for (StackFrame frame : thread.frames()) { +// System.out.println("frame: " + frame); +// } - // Any of the thread.blah() methods can throw an AbsentInformationEx - // if that bit of data is missing. If so, just write out the error - // message to the console. List frames = thread.frames(); for (StackFrame frame : frames) { -// System.out.println("frame: " + frame); + try { Location location = frame.location(); String filename = null; filename = location.sourceName(); - lineNumber = location.lineNumber(); - - String appletJavaFile = appletClassName + ".java"; - SketchCode errorCode = null; - if (filename.equals(appletJavaFile)) { - for (SketchCode code : sketch.getCode()) { - if (code.isExtension("pde")) { - if (lineNumber >= code.getPreprocOffset()) { - errorCode = code; + int lineNumber = location.lineNumber() - 1; + RunnerException rex = + sketch.placeException(message, filename, lineNumber); + if (rex != null) { + return rex; } - } - } - } else { - for (SketchCode code : sketch.getCode()) { - if (code.isExtension("java")) { - if (filename.equals(code.getFileName())) { - errorCode = code; - } - } - } - } - codeIndex = sketch.getCodeIndex(errorCode); - - if (codeIndex != -1) { - //System.out.println("got line num " + lineNumber); - // in case this was a tab that got embedded into the main .java - lineNumber -= sketch.getCode(codeIndex).getPreprocOffset(); - - // lineNumber is 1-indexed, but editor wants zero-indexed - lineNumber--; - - // getMessage() will be what's shown in the editor - exception = new RunnerException(message, codeIndex, lineNumber, -1); - exception.hideStackTrace(); - listener.statusError(exception); - return; - } - } } catch (AbsentInformationException e) { + // Any of the thread.blah() methods can throw an AbsentInformationEx + // if that bit of data is missing. If so, just write out the error + // message to the console. //e.printStackTrace(); // not useful exception = new RunnerException(message); exception.hideStackTrace(); listener.statusError(exception); - + } + } } catch (IncompatibleThreadStateException e) { + // This shouldn't happen, but if it does, print the exception in case + // it's something that needs to be debugged separately. e.printStackTrace(); } + // Give up, nothing found inside the pile of stack frames + RunnerException rex = new RunnerException(message); + // exception is being created /here/, so stack trace is not useful + rex.hideStackTrace(); + return rex; } @@ -727,26 +607,7 @@ public class Runner implements MessageConsumer { } vm = null; } - - //if (window != null) window.hide(); -// if (window != null) { -// //System.err.println("disposing window"); -// window.dispose(); -// window = null; -// } - - /* - if (process != null) { - try { - process.destroy(); - } catch (Exception e) { - //System.err.println("(ignored) error while destroying"); - //e.printStackTrace(); } - process = null; - } - */ - } // made synchronized for rev 87 @@ -762,7 +623,10 @@ public class Runner implements MessageConsumer { // that signals that the applet has been quit. if (s.indexOf(PApplet.EXTERNAL_STOP) == 0) { //System.out.println("external: quit"); - editor.internalCloseRunner(); + if (editor != null) { + //editor.internalCloseRunner(); // [091124] + editor.handleStop(); + } return; } @@ -773,281 +637,23 @@ public class Runner implements MessageConsumer { int space = nums.indexOf(' '); int left = Integer.parseInt(nums.substring(0, space)); int top = Integer.parseInt(nums.substring(space + 1)); + // this is only fired when connected to an editor editor.setSketchLocation(new Point(left, top)); //System.out.println("external: move to " + left + " " + top); return; } - // Removed while doing cleaning for 0145, - // it seems that this is never actually printed out. - /* - // this is PApplet sending a message saying "i'm about to spew - // a stack trace because an error occurred during PApplet.run()" - if (s.indexOf(PApplet.LEECH_WAKEUP) == 0) { - // newMessage being set to 'true' means that the next time - // message() is called, expect the first line of the actual - // error message & stack trace to be sent from the applet. - newMessage = true; - return; // this line ignored - } - */ - // these are used for debugging, in case there are concerns // that some errors aren't coming through properly - /* - if (s.length() > 2) { - System.err.println(newMessage); - System.err.println("message " + s.length() + ":" + s); - } - */ +// if (s.length() > 2) { +// System.err.println(newMessage); +// System.err.println("message " + s.length() + ":" + s); +// } + // always shove out the mesage, since it might not fall under // the same setup as we're expecting System.err.print(s); //System.err.println("[" + s.length() + "] " + s); System.err.flush(); - -// // exit here because otherwise the exception name -// // may be titled with a blank string -// if (s.trim().length() == 0) return; -// -// // annoying, because it seems as though the terminators -// // aren't being sent properly -// //System.err.println(s); -// -// //if (newMessage && s.length() > 2) { -// if (newMessage) { -// exception = new RunnerException(s); // type of java ex -// exception.hideStackTrace(); -// //System.out.println("setting ex type to " + s); -// newMessage = false; -// foundMessageSource = false; -// messageLineCount = 0; -// -// } else { -// messageLineCount++; -// -// /* -//java.lang.NullPointerException -// at javatest.(javatest.java:5) -// at Temporary_2425_1153.draw(Temporary_2425_1153.java:11) -// at PApplet.nextFrame(PApplet.java:481) -// at PApplet.run(PApplet.java:428) -// at java.lang.Thread.run(Unknown Source) -// */ -// -// if (!foundMessageSource) { -// // " at javatest.(javatest.java:5)" -// // -> "javatest.(javatest.java:5)" -// int atIndex = s.indexOf("at "); -// if (atIndex == -1) { -// //System.err.println(s); // stop double-printing exceptions -// return; -// } -// s = s.substring(atIndex + 3); -// -// // added for 0124 to improve error handling -// // not highlighting lines if it's in the p5 code -// if (s.startsWith("processing.")) return; -// // no highlight if it's java.lang.whatever -// if (s.startsWith("java.")) return; -// -// // "javatest.(javatest.java:5)" -// // -> "javatest." and "(javatest.java:5)" -// int startParen = s.indexOf('('); -// // at javatest.(javatest.java:5) -// //String pkgClassFxn = null; -// //String fileLine = null; -// int codeIndex = -1; -// int lineNumber = -1; -// -// if (startParen == -1) { -// //pkgClassFxn = s; -// -// } else { -// //pkgClassFxn = s.substring(0, startParen); -// -// // "(javatest.java:5)" -// String fileAndLine = s.substring(startParen + 1); -// int stopParen = fileAndLine.indexOf(')'); -// //fileAndLine = fileAndLine.substring(0, fileAndLine.length() - 1); -// fileAndLine = fileAndLine.substring(0, stopParen); -// //System.out.println("file 'n line " + fileAndLine); -// -// //if (!fileAndLine.equals("Unknown Source")) { -// // "javatest.java:5" -// int colonIndex = fileAndLine.indexOf(':'); -// if (colonIndex != -1) { -// String filename = fileAndLine.substring(0, colonIndex); -// // "javatest.java" and "5" -// //System.out.println("filename = " + filename); -// //System.out.println("pre0 = " + sketch.code[0].preprocName); -// //for (int i = 0; i < sketch.codeCount; i++) { -// //System.out.println(i + " " + sketch.code[i].lineOffset + " " + -// // sketch.code[i].preprocName); -// //} -// lineNumber = -// Integer.parseInt(fileAndLine.substring(colonIndex + 1)) - 1; -// -// for (int i = 0; i < sketch.getCodeCount(); i++) { -// SketchCode code = sketch.getCode(i); -// //System.out.println(code.preprocName + " " + lineNumber + " " + -// // code.preprocOffset); -// if (((code.preprocName == null) && -// (lineNumber >= code.preprocOffset)) || -// ((code.preprocName != null) && -// code.preprocName.equals(filename))) { -// codeIndex = i; -// //System.out.println("got codeindex " + codeIndex); -// //break; -// //} else if ( -// } -// } -// -// if (codeIndex != -1) { -// //System.out.println("got line num " + lineNumber); -// // in case this was a tab that got embedded into the main .java -// lineNumber -= sketch.getCode(codeIndex).preprocOffset; -// -// // this may have a paren on the end, if so need to strip -// // down to just the digits -// /* -// int lastNumberIndex = colonIndex + 1; -// while ((lastNumberIndex < fileAndLine.length()) && -// Character.isDigit(fileAndLine.charAt(lastNumberIndex))) { -// lastNumberIndex++; -// } -// */ -// -// // lineNumber is 1-indexed, but editor wants zero-indexed -// // getMessage() will be what's shown in the editor -// exception = -// new RunnerException(exception.getMessage(), -// codeIndex, lineNumber, -1); -// exception.hideStackTrace(); -// foundMessageSource = true; -// } -// } -// } -// editor.error(exception); -// -// /* -// int index = s.indexOf(className + ".java"); -// if (index != -1) { -// int len = (className + ".java").length(); -// String lineNumberStr = s.substring(index + len + 1); -// index = lineNumberStr.indexOf(')'); -// lineNumberStr = lineNumberStr.substring(0, index); -// try { -// exception.line = Integer.parseInt(lineNumberStr) - 1; //2; -// } catch (NumberFormatException e) { } -// //e.printStackTrace(); // a recursive error waiting to happen? -// // if nfe occurs, who cares, still send the error on up -// editor.error(exception); -// */ -// -// /* -// // WARNING THESE ARE DISABLED!! -// } else if ((index = s.indexOf(className + ".class")) != -1) { -// // code to check for: -// // at Temporary_484_3845.loop(Compiled Code) -// // would also probably get: -// // at Temporary_484_3845.loop -// // which (i believe) is used by the mac and/or jview -// String functionStr = s.substring(index + -// (className + ".class").length() + 1); -// index = functionStr.indexOf('('); -// if (index != -1) { -// functionStr = functionStr.substring(0, index); -// } -// exception = new RunnerException(//"inside \"" + functionStr + "()\": " + -// exception.getMessage() + -// " inside " + functionStr + "() " + -// "[add Compiler.disable() to setup()]"); -// editor.error(exception); -// // this will fall through in tihs example: -// // at Temporary_4636_9696.pootie(Compiled Code) -// // at Temporary_4636_9696.loop(Temporary_4636_9696.java:24) -// // because pootie() (re)sets the exception title -// // and throws it, but then the line number gets set -// // because of the line that comes after -// */ -// -// } else if (messageLineCount > 10) { // 5 -> 10 for 0088 -// // this means the class name may not be mentioned -// // in the stack trace.. this is just a general purpose -// // error, but needs to make it through anyway. -// // so if five lines have gone past, might as well signal -// messageLineCount = -100; -// exception = new RunnerException(exception.getMessage()); -// exception.hideStackTrace(); -// editor.error(exception); -// -// } else { -// //System.err.print(s); -// } -// //System.out.println("got it " + s); -// } } - - - ////////////////////////////////////////////////////////////// - - - /** - * Siphons from an InputStream of System.out (from a Process) - * and sends it to the real System.out. - */ - class SystemOutSiphon implements Runnable { - InputStream input; - Thread thread; - - public SystemOutSiphon(InputStream input) { - this.input = input; - - thread = new Thread(this); - // unless this is set to min, it seems to hork the app - // since it's in charge of stuffing the editor console with strings - // maybe it's time to get rid of/fix that friggin console - // ...disabled for 0075, with 0074's fix for code folder hanging - // this only seems to make the console unresponsive - //thread.setPriority(Thread.MIN_PRIORITY); - thread.start(); } - - public void run() { - byte boofer[] = new byte[256]; - - while (Thread.currentThread() == thread) { - try { - // can't use a buffered reader here because incremental - // print statements are interesting too.. causes some - // disparity with how System.err gets spewed, oh well. - int count = input.read(boofer, 0, boofer.length); - if (count == -1) { - thread = null; - - } else { - System.out.print(new String(boofer, 0, count)); - //System.out.flush(); - } - - } catch (IOException e) { - // this is prolly because the app was quit & the stream broken - //e.printStackTrace(System.out); - //e.printStackTrace(); - thread = null; - - } catch (Exception e) { - //System.out.println("SystemOutSiphon: i just died in your arms tonight"); - // on mac os x, this will spew a "Bad File Descriptor" ex - // each time an external app is shut down. - //e.printStackTrace(); - thread = null; - //System.out.println(""); - } - //System.out.println("SystemOutSiphon: out"); - //thread = null; - } - } - } -} diff --git a/app/src/processing/app/debug/RunnerException.java b/app/src/processing/app/debug/RunnerException.java index 0b4e59154..97887ed7e 100644 --- a/app/src/processing/app/debug/RunnerException.java +++ b/app/src/processing/app/debug/RunnerException.java @@ -37,10 +37,18 @@ public class RunnerException extends Exception /*RuntimeException*/ { public RunnerException(String message) { - this(message, -1, -1, -1, true); + this(message, true); } + public RunnerException(String message, boolean showStackTrace) { + this(message, -1, -1, -1, showStackTrace); + } + public RunnerException(String message, int file, int line) { + this(message, file, line, -1, true); + } + + public RunnerException(String message, int file, int line, int column) { this(message, file, line, column, true); } diff --git a/app/src/processing/app/debug/RunnerListener.java b/app/src/processing/app/debug/RunnerListener.java index 1728d7972..b9505a510 100644 --- a/app/src/processing/app/debug/RunnerListener.java +++ b/app/src/processing/app/debug/RunnerListener.java @@ -28,4 +28,6 @@ public interface RunnerListener { public void statusError(String message); public void statusError(Exception exception); + + public void statusNotice(String message); } \ No newline at end of file diff --git a/app/src/processing/app/linux/Platform.java b/app/src/processing/app/linux/Platform.java index 496e926ae..ff89c813b 100644 --- a/app/src/processing/app/linux/Platform.java +++ b/app/src/processing/app/linux/Platform.java @@ -67,10 +67,18 @@ public class Platform extends processing.app.Platform { return true; } + // Attempt to use xdg-open + try { + Process p = Runtime.getRuntime().exec(new String[] { "xdg-open" }); + p.waitFor(); + Preferences.set("launcher", "xdg-open"); + return true; + } catch (Exception e) { } + // Attempt to use gnome-open try { Process p = Runtime.getRuntime().exec(new String[] { "gnome-open" }); - /*int result =*/ p.waitFor(); + p.waitFor(); // Not installed will throw an IOException (JDK 1.4.2, Ubuntu 7.04) Preferences.set("launcher", "gnome-open"); return true; @@ -79,7 +87,7 @@ public class Platform extends processing.app.Platform { // Attempt with kde-open try { Process p = Runtime.getRuntime().exec(new String[] { "kde-open" }); - /*int result =*/ p.waitFor(); + p.waitFor(); Preferences.set("launcher", "kde-open"); return true; } catch (Exception e) { } @@ -100,7 +108,8 @@ public class Platform extends processing.app.Platform { e.printStackTrace(); } } else { - System.out.println("not available"); + System.out.println("No launcher set, cannot open " + + file.getAbsolutePath()); } } } diff --git a/app/src/processing/app/macosx/Platform.java b/app/src/processing/app/macosx/Platform.java index 6a156e8f0..06a8f5214 100644 --- a/app/src/processing/app/macosx/Platform.java +++ b/app/src/processing/app/macosx/Platform.java @@ -25,12 +25,15 @@ package processing.app.macosx; import java.awt.Insets; import java.io.File; import java.io.FileNotFoundException; +import java.lang.reflect.Method; +import java.net.URI; import javax.swing.UIManager; import com.apple.eio.FileManager; import processing.app.Base; +import processing.core.PApplet; /** @@ -103,36 +106,45 @@ public class Platform extends processing.app.Platform { public void openURL(String url) throws Exception { - if (!url.startsWith("http://")) { + if (PApplet.javaVersion < 1.6f) { + if (url.startsWith("http://")) { + // formerly com.apple.eio.FileManager.openURL(url); + // but due to deprecation, instead loading dynamically + try { + Class eieio = Class.forName("com.apple.eio.FileManager"); + Method openMethod = + eieio.getMethod("openURL", new Class[] { String.class }); + openMethod.invoke(null, new Object[] { url }); + } catch (Exception e) { + e.printStackTrace(); + } + } else { // Assume this is a file instead, and just open it. // Extension of http://dev.processing.org/bugs/show_bug.cgi?id=1010 processing.core.PApplet.open(url); - - /* - // prepend file:// on this guy since it's a file - url = "file://" + url; - - // replace spaces with %20 for the file url - // otherwise the mac doesn't like to open it - // can't just use URLEncoder, since that makes slashes into - // %2F characters, which is no good. some might say "useless" - if (url.indexOf(' ') != -1) { - StringBuffer sb = new StringBuffer(); - char c[] = url.toCharArray(); - for (int i = 0; i < c.length; i++) { - if (c[i] == ' ') { - sb.append("%20"); - } else { - sb.append(c[i]); - } - } - url = sb.toString(); } - */ + } else { + try { + Class desktopClass = Class.forName("java.awt.Desktop"); + Method getMethod = desktopClass.getMethod("getDesktop"); + Object desktop = getMethod.invoke(null, new Object[] { }); + + // for Java 1.6, replacing with java.awt.Desktop.browse() + // and java.awt.Desktop.open() + if (url.startsWith("http://")) { // browse to a location + Method browseMethod = + desktopClass.getMethod("browse", new Class[] { URI.class }); + browseMethod.invoke(desktop, new Object[] { new URI(url) }); + } else { // open a file + Method openMethod = + desktopClass.getMethod("open", new Class[] { File.class }); + openMethod.invoke(desktop, new Object[] { new File(url) }); + } + } catch (Exception e) { + e.printStackTrace(); + } + } } - // for Java 1.6, replace with java.awt.Desktop.browse() and java.awt.Desktop.open() - com.apple.eio.FileManager.openURL(url); - } public boolean openFolderAvailable() { diff --git a/app/src/processing/app/macosx/ThinkDifferent.java b/app/src/processing/app/macosx/ThinkDifferent.java index 1d292b399..f0c13cbba 100644 --- a/app/src/processing/app/macosx/ThinkDifferent.java +++ b/app/src/processing/app/macosx/ThinkDifferent.java @@ -50,7 +50,8 @@ public class ThinkDifferent implements ApplicationListener { static protected void init(Base base) { if (application == null) { - application = new com.apple.eawt.Application(); + //application = new com.apple.eawt.Application(); + application = com.apple.eawt.Application.getApplication(); } if (adapter == null) { adapter = new ThinkDifferent(base); diff --git a/app/src/processing/app/preproc/PdePreprocessor.java b/app/src/processing/app/preproc/PdePreprocessor.java index b00b7cb03..10b940536 100644 --- a/app/src/processing/app/preproc/PdePreprocessor.java +++ b/app/src/processing/app/preproc/PdePreprocessor.java @@ -51,15 +51,9 @@ public class PdePreprocessor { List prototypes; - - - - String[] defaultImports; - // these ones have the .* at the end, since a class name might be at the end // instead of .* which would make trouble other classes using this can lop // off the . and anything after it to produce a package name consistently. - //public String extraImports[]; ArrayList programImports; // imports just from the code folder, treated differently @@ -71,24 +65,24 @@ public class PdePreprocessor { PrintStream stream; String program; String buildPath; + // starts as sketch name, ends as main class name String name; /** * Setup a new preprocessor. */ - public PdePreprocessor() { } - - public int writePrefix(String program, String buildPath, - String name, String codeFolderPackages[]) - throws FileNotFoundException { - this.buildPath = buildPath; - this.name = name; - + public PdePreprocessor() { int tabSize = Preferences.getInteger("editor.tabs.size"); char[] indentChars = new char[tabSize]; Arrays.fill(indentChars, ' '); indent = new String(indentChars); + } + + public int writePrefix(String program, String buildPath, + String sketchName, String codeFolderPackages[]) throws FileNotFoundException { + this.buildPath = buildPath; + this.name = sketchName; // if the program ends with no CR or LF an OutOfMemoryError will happen. // not gonna track down the bug now, so here's a hack for it: @@ -99,52 +93,13 @@ public class PdePreprocessor { // an OutOfMemoryError or NullPointerException will happen. // again, not gonna bother tracking this down, but here's a hack. // http://dev.processing.org/bugs/show_bug.cgi?id=16 - Sketch.scrubComments(program); - // this returns the scrubbed version, but more important for this - // function, it'll check to see if there are errors with the comments. + String scrubbed = Sketch.scrubComments(program); + // If there are errors, an exception is thrown and this fxn exits. if (Preferences.getBoolean("preproc.substitute_unicode")) { - // check for non-ascii chars (these will be/must be in unicode format) - char p[] = program.toCharArray(); - int unicodeCount = 0; - for (int i = 0; i < p.length; i++) { - if (p[i] > 127) unicodeCount++; - } - // if non-ascii chars are in there, convert to unicode escapes - if (unicodeCount != 0) { - // add unicodeCount * 5.. replacing each unicode char - // with six digit uXXXX sequence (xxxx is in hex) - // (except for nbsp chars which will be a replaced with a space) - int index = 0; - char p2[] = new char[p.length + unicodeCount*5]; - for (int i = 0; i < p.length; i++) { - if (p[i] < 128) { - p2[index++] = p[i]; - - } else if (p[i] == 160) { // unicode for non-breaking space - p2[index++] = ' '; - - } else { - int c = p[i]; - p2[index++] = '\\'; - p2[index++] = 'u'; - char str[] = Integer.toHexString(c).toCharArray(); - // add leading zeros, so that the length is 4 - //for (int i = 0; i < 4 - str.length; i++) p2[index++] = '0'; - for (int m = 0; m < 4 - str.length; m++) p2[index++] = '0'; - System.arraycopy(str, 0, p2, index, str.length); - index += str.length; - } - } - program = new String(p2, 0, index); - } + program = substituteUnicode(program); } - // These may change in-between (if the prefs panel adds this option) - // so grab them here on construction. - String prefsLine = Preferences.get("preproc.imports"); - defaultImports = PApplet.splitTokens(prefsLine, ", "); - //String importRegexp = "(?:^|\\s|;)(import\\s+)(\\S+)(\\s*;)"; String importRegexp = "^\\s*#include\\s+[<\"](\\S+)[\">]"; programImports = new ArrayList(); @@ -184,8 +139,47 @@ public class PdePreprocessor { return headerCount + prototypeCount; } + + static String substituteUnicode(String program) { + // check for non-ascii chars (these will be/must be in unicode format) + char p[] = program.toCharArray(); + int unicodeCount = 0; + for (int i = 0; i < p.length; i++) { + if (p[i] > 127) unicodeCount++; + } + // if non-ascii chars are in there, convert to unicode escapes + if (unicodeCount != 0) { + // add unicodeCount * 5.. replacing each unicode char + // with six digit uXXXX sequence (xxxx is in hex) + // (except for nbsp chars which will be a replaced with a space) + int index = 0; + char p2[] = new char[p.length + unicodeCount*5]; + for (int i = 0; i < p.length; i++) { + if (p[i] < 128) { + p2[index++] = p[i]; + + } else if (p[i] == 160) { // unicode for non-breaking space + p2[index++] = ' '; + + } else { + int c = p[i]; + p2[index++] = '\\'; + p2[index++] = 'u'; + char str[] = Integer.toHexString(c).toCharArray(); + // add leading zeros, so that the length is 4 + //for (int i = 0; i < 4 - str.length; i++) p2[index++] = '0'; + for (int m = 0; m < 4 - str.length; m++) p2[index++] = '0'; + System.arraycopy(str, 0, p2, index, str.length); + index += str.length; + } + } + program = new String(p2, 0, index); + } + return program; + } + /** - * preprocesses a pde file and write out a java file + * preprocesses a pde file and writes out a java file * @return the classname of the exported Java */ //public String write(String program, String buildPath, String name, diff --git a/app/src/processing/app/syntax/InputHandler.java b/app/src/processing/app/syntax/InputHandler.java index db7260da5..9a11d3866 100644 --- a/app/src/processing/app/syntax/InputHandler.java +++ b/app/src/processing/app/syntax/InputHandler.java @@ -24,7 +24,7 @@ import java.util.*; * to the implementations of this class to do so. * * @author Slava Pestov - * @version $Id: InputHandler.java 4168 2008-08-09 17:24:37Z fry $ + * @version $Id: InputHandler.java 6126 2010-02-16 23:43:53Z fry $ */ public abstract class InputHandler extends KeyAdapter { @@ -70,6 +70,9 @@ public abstract class InputHandler extends KeyAdapter public static final ActionListener SELECT_PREV_WORD = new prev_word(true); public static final ActionListener REPEAT = new repeat(); public static final ActionListener TOGGLE_RECT = new toggle_rect(); + public static final ActionListener CLIPBOARD_CUT = new clipboard_cut(); // [fry] + public static final ActionListener CLIPBOARD_COPY = new clipboard_copy(); + public static final ActionListener CLIPBOARD_PASTE = new clipboard_paste(); // Default action public static final ActionListener INSERT_CHAR = new insert_char(); @@ -113,6 +116,9 @@ public abstract class InputHandler extends KeyAdapter actions.put("repeat",REPEAT); actions.put("toggle-rect",TOGGLE_RECT); actions.put("insert-char",INSERT_CHAR); + actions.put("clipboard-cut",CLIPBOARD_CUT); + actions.put("clipboard-copy",CLIPBOARD_COPY); + actions.put("clipboard-paste",CLIPBOARD_PASTE); } /** @@ -1077,6 +1083,34 @@ public abstract class InputHandler extends KeyAdapter } } + + public static class clipboard_cut implements ActionListener + { + public void actionPerformed(ActionEvent evt) + { + getTextArea(evt).cut(); + } + } + + + public static class clipboard_copy implements ActionListener + { + public void actionPerformed(ActionEvent evt) + { + getTextArea(evt).copy(); + } + } + + + public static class clipboard_paste implements ActionListener + { + public void actionPerformed(ActionEvent evt) + { + getTextArea(evt).paste(); + } + } + + public static class insert_char implements ActionListener, InputHandler.NonRepeatable { diff --git a/app/src/processing/app/syntax/JEditTextArea.java b/app/src/processing/app/syntax/JEditTextArea.java index 0cc9e0146..d5c01c48a 100644 --- a/app/src/processing/app/syntax/JEditTextArea.java +++ b/app/src/processing/app/syntax/JEditTextArea.java @@ -22,6 +22,9 @@ import java.awt.event.*; import java.awt.*; import java.util.Enumeration; import java.util.Vector; +import java.awt.im.InputMethodRequests; + +import processing.app.syntax.im.InputMethodSupport; /** * jEdit's text area component. It is more suited for editing program @@ -51,7 +54,7 @@ import java.util.Vector; * + "}"); * * @author Slava Pestov - * @version $Id: JEditTextArea.java 5625 2009-06-07 21:08:59Z fry $ + * @version $Id: JEditTextArea.java 6123 2010-02-16 21:43:44Z fry $ */ public class JEditTextArea extends JComponent { @@ -127,6 +130,16 @@ public class JEditTextArea extends JComponent }); } + /** + * Inline Input Method Support for Japanese. + */ + private InputMethodSupport inputMethodSupport = null; + public InputMethodRequests getInputMethodRequests() { + if (inputMethodSupport == null) { + inputMethodSupport = new InputMethodSupport(this); + } + return inputMethodSupport; + } /** * Get current position of the vertical scroll bar. [fry] diff --git a/app/src/processing/app/syntax/PdeTextAreaDefaults.java b/app/src/processing/app/syntax/PdeTextAreaDefaults.java index a2dda2b78..b715255be 100644 --- a/app/src/processing/app/syntax/PdeTextAreaDefaults.java +++ b/app/src/processing/app/syntax/PdeTextAreaDefaults.java @@ -34,18 +34,22 @@ public class PdeTextAreaDefaults extends TextAreaDefaults { inputHandler = new DefaultInputHandler(); //inputHandler.addDefaultKeyBindings(); // 0122 - // use option on mac for things that are ctrl on windows/linux + // use option on mac for text edit controls that are ctrl on windows/linux String mod = Base.isMacOS() ? "A" : "C"; // right now, ctrl-up/down is select up/down, but mod should be // used instead, because the mac expects it to be option(alt) inputHandler.addKeyBinding("BACK_SPACE", InputHandler.BACKSPACE); + // for 0122, shift-backspace is delete, for 0176, it's now a preference, + // to prevent holy warriors from attacking me for it. + if (Preferences.getBoolean("editor.keys.shift_backspace_is_delete")) { + inputHandler.addKeyBinding("S+BACK_SPACE", InputHandler.DELETE); + } else { + inputHandler.addKeyBinding("S+BACK_SPACE", InputHandler.BACKSPACE); + } + inputHandler.addKeyBinding("DELETE", InputHandler.DELETE); - - //inputHandler.addKeyBinding("S+BACK_SPACE", InputHandler.BACKSPACE); - // for 0122, shift-backspace is delete - inputHandler.addKeyBinding("S+BACK_SPACE", InputHandler.DELETE); inputHandler.addKeyBinding("S+DELETE", InputHandler.DELETE); // the following two were changing for 0122 for better mac/pc compatability @@ -57,12 +61,23 @@ public class PdeTextAreaDefaults extends TextAreaDefaults { //inputHandler.addKeyBinding("TAB", InputHandler.INSERT_TAB); inputHandler.addKeyBinding("INSERT", InputHandler.OVERWRITE); + + // http://dev.processing.org/bugs/show_bug.cgi?id=162 + // added for 0176, though the bindings do not appear relevant for osx + if (Preferences.getBoolean("editor.keys.alternative_cut_copy_paste")) { + inputHandler.addKeyBinding("C+INSERT", InputHandler.CLIPBOARD_COPY); + inputHandler.addKeyBinding("S+INSERT", InputHandler.CLIPBOARD_PASTE); + inputHandler.addKeyBinding("S+DELETE", InputHandler.CLIPBOARD_CUT); + } + // disabling for 0122, not sure what this does //inputHandler.addKeyBinding("C+\\", InputHandler.TOGGLE_RECT); - // for 0122, these have been changed for better compatability + // for 0122, these have been changed for better compatibility // HOME and END now mean the beginning/end of the document - if (Base.isMacOS()) { + // for 0176 changed this to a preference so that the Mac OS X people + // can get the "normal" behavior as well if they prefer. + if (Preferences.getBoolean("editor.keys.home_and_end_travel_far")) { inputHandler.addKeyBinding("HOME", InputHandler.DOCUMENT_HOME); inputHandler.addKeyBinding("END", InputHandler.DOCUMENT_END); inputHandler.addKeyBinding("S+HOME", InputHandler.SELECT_DOC_HOME); diff --git a/app/src/processing/app/syntax/TextAreaPainter.java b/app/src/processing/app/syntax/TextAreaPainter.java index 229df09b7..cc93aeded 100644 --- a/app/src/processing/app/syntax/TextAreaPainter.java +++ b/app/src/processing/app/syntax/TextAreaPainter.java @@ -12,6 +12,7 @@ package processing.app.syntax; import processing.app.*; +import processing.app.syntax.im.CompositionTextPainter; import javax.swing.ToolTipManager; import javax.swing.text.*; @@ -33,6 +34,9 @@ implements TabExpander, Printable /** Current setting for editor.antialias preference */ boolean antialias; + /** A specific painter composed by the InputMethod.*/ + protected CompositionTextPainter compositionTextPainter; + /** * Creates a new repaint manager. This should be not be called * directly. @@ -73,6 +77,16 @@ implements TabExpander, Printable eolMarkers = defaults.eolMarkers; } + /** + * Get CompositionTextPainter. if CompositionTextPainter is not created, create it. + */ + public CompositionTextPainter getCompositionTextpainter(){ + if(compositionTextPainter == null){ + compositionTextPainter = new CompositionTextPainter(textArea); + } + return compositionTextPainter; + } + /** * Returns if this component can be traversed by pressing the * Tab key. This returns false. @@ -602,7 +616,12 @@ implements TabExpander, Printable y += fm.getHeight(); x = Utilities.drawTabbedText(currentLine,x,y,gfx,this,0); - + /* + * Draw characters via input method. + */ + if (compositionTextPainter != null && compositionTextPainter.hasComposedTextLayout()) { + compositionTextPainter.draw(gfx, lineHighlightColor); + } if (eolMarkers) { gfx.setColor(eolMarkerColor); gfx.drawString(".",x,y); @@ -625,7 +644,12 @@ implements TabExpander, Printable x = SyntaxUtilities.paintSyntaxLine(currentLine, currentLineTokens, styles, this, gfx, x, y); - + /* + * Draw characters via input method. + */ + if (compositionTextPainter != null && compositionTextPainter.hasComposedTextLayout()) { + compositionTextPainter.draw(gfx, lineHighlightColor); + } if (eolMarkers) { gfx.setColor(eolMarkerColor); gfx.drawString(".",x,y); diff --git a/app/src/processing/app/syntax/im/CompositionTextManager.java b/app/src/processing/app/syntax/im/CompositionTextManager.java new file mode 100644 index 000000000..3c2bec063 --- /dev/null +++ b/app/src/processing/app/syntax/im/CompositionTextManager.java @@ -0,0 +1,187 @@ +package processing.app.syntax.im; + +import java.awt.Font; +import java.awt.FontMetrics; +import java.awt.Graphics2D; +import java.awt.Point; +import java.awt.Rectangle; +import java.awt.font.FontRenderContext; +import java.awt.font.TextAttribute; +import java.awt.font.TextLayout; +import java.text.AttributedCharacterIterator; +import java.text.AttributedString; + +import javax.swing.text.BadLocationException; + +import processing.app.syntax.JEditTextArea; +import processing.app.syntax.TextAreaPainter; + +/** + * This class Manage texts from input method + * by begin-process-end steps. + * + * First, if a user start inputing via input method, + * beginCompositionText is called from InputMethodSupport. + * Second, the user continues from input method, processCompositionText is called + * and reflect user inputs to text area. + * Finally the user try to commit text, endCompositionText is called. + * + * @author Takashi Maekawa (takachin@generative.info) + */ + +public class CompositionTextManager { + private JEditTextArea textArea; + private String prevComposeString; + private int prevCommittedCount; + private boolean isInputProcess; + private int initialCaretPosition; + public static final int COMPOSING_UNDERBAR_HEIGHT = 5; + + /** + * Create text manager class with a textarea. + * @param textArea texarea component for PDE. + */ + public CompositionTextManager(JEditTextArea textArea) { + this.textArea = textArea; + prevComposeString = ""; + isInputProcess = false; + prevCommittedCount = 0; + } + + /** + * Get this text manager is whether in input process or not. + */ + public boolean getIsInputProcess() { + return isInputProcess; + } + + /** + * Called when a user begins input from input method. + * This method initializes text manager. + * + * @param text Text from InputMethodEvent. + * @param commited_count Numbers of committed characters in text. + */ + public void beginCompositionText(AttributedCharacterIterator text, int committed_count) { + isInputProcess = true; + prevComposeString = ""; + initialCaretPosition = textArea.getCaretPosition(); + processCompositionText(text, committed_count); + } + + /** + * Called when a user processing input characters and + * select candidates from input method. + * + * @param text Text from InputMethodEvent. + * @param commited_count Numbers of committed characters in text. + */ + public void processCompositionText(AttributedCharacterIterator text, int committed_count) { + int layoutCaretPosition = initialCaretPosition + committed_count; + CompositionTextPainter compositionPainter = textArea.getPainter().getCompositionTextpainter(); + compositionPainter.setComposedTextLayout(getTextLayout(text, committed_count), layoutCaretPosition); + int textLength = text.getEndIndex() - text.getBeginIndex() - committed_count; + StringBuffer unCommitedStringBuf = new StringBuffer(textLength); + char c; + for (c = text.setIndex(committed_count); c != AttributedCharacterIterator.DONE + && textLength > 0; c = text.next(), --textLength) { + unCommitedStringBuf.append(c); + } + String unCommittedString = unCommitedStringBuf.toString(); + try { + if(canRemovePreviousInput(committed_count)){ + textArea.getDocument().remove(layoutCaretPosition, prevComposeString.length()); + } + textArea.getDocument().insertString(layoutCaretPosition, unCommittedString, null); + if(committed_count > 0){ + initialCaretPosition = initialCaretPosition + committed_count; + } + prevComposeString = unCommittedString; + prevCommittedCount = committed_count; + } catch (BadLocationException e) { + e.printStackTrace(); + } + } + + private boolean canRemovePreviousInput(int committed_count){ + return (prevCommittedCount == committed_count || prevCommittedCount > committed_count); + } + + /** + * Called when a user fixed text from input method or delete all + * composition text. This method resets CompositionTextPainter. + * + * @param text Text from InputMethodEvent. + * @param commited_count Numbers of committed characters in text. + */ + public void endCompositionText(AttributedCharacterIterator text, int committed_count) { + isInputProcess = false; + /* + * If there are no committed characters, remove it all from textarea. + * This case will happen if a user delete all composing characters by backspace or delete key. + * If it does, these previous characters are needed to be deleted. + */ + if(committed_count == 0){ + removeNotCommittedText(text); + } + CompositionTextPainter compositionPainter = textArea.getPainter().getCompositionTextpainter(); + compositionPainter.invalidateComposedTextLayout(initialCaretPosition + committed_count); + prevComposeString = ""; + isInputProcess = false; + } + + private void removeNotCommittedText(AttributedCharacterIterator text){ + if (prevComposeString.length() == 0) { + return; + } + try { + textArea.getDocument().remove(initialCaretPosition, prevComposeString.length()); + } catch (BadLocationException e) { + e.printStackTrace(); + } + } + + private TextLayout getTextLayout(AttributedCharacterIterator text, int committed_count) { + AttributedString composed = new AttributedString(text, committed_count, text.getEndIndex()); + Font font = textArea.getPainter().getFont(); + FontRenderContext context = ((Graphics2D) (textArea.getPainter().getGraphics())).getFontRenderContext(); + composed.addAttribute(TextAttribute.FONT, font); + TextLayout layout = new TextLayout(composed.getIterator(), context); + return layout; + } + + private Point getCaretLocation() { + Point loc = new Point(); + TextAreaPainter painter = textArea.getPainter(); + FontMetrics fm = painter.getFontMetrics(); + int offsetY = fm.getHeight() - COMPOSING_UNDERBAR_HEIGHT; + int lineIndex = textArea.getCaretLine(); + loc.y = lineIndex * fm.getHeight() + offsetY; + int offsetX = textArea.getCaretPosition() + - textArea.getLineStartOffset(lineIndex); + loc.x = textArea.offsetToX(lineIndex, offsetX); + return loc; + } + + public Rectangle getTextLocation() { + Point caret = getCaretLocation(); + return getCaretRectangle(caret.x, caret.y); + } + + private Rectangle getCaretRectangle(int x, int y) { + TextAreaPainter painter = textArea.getPainter(); + Point origin = painter.getLocationOnScreen(); + int height = painter.getFontMetrics().getHeight(); + return new Rectangle(origin.x + x, origin.y + y, 0, height); + } + + public AttributedCharacterIterator getCommittedText(int beginIndex, int endIndex) { + int length = endIndex - beginIndex; + String textAreaString = textArea.getText(beginIndex, length); + return new AttributedString(textAreaString).getIterator(); + } + + public int getInsertPositionOffset() { + return textArea.getCaretPosition() * -1; + } +} diff --git a/app/src/processing/app/syntax/im/CompositionTextPainter.java b/app/src/processing/app/syntax/im/CompositionTextPainter.java new file mode 100644 index 000000000..0084f491f --- /dev/null +++ b/app/src/processing/app/syntax/im/CompositionTextPainter.java @@ -0,0 +1,124 @@ +package processing.app.syntax.im; + +import java.awt.Color; +import java.awt.FontMetrics; +import java.awt.Graphics; +import java.awt.Graphics2D; +import java.awt.Point; +import java.awt.font.TextLayout; + +import processing.app.syntax.JEditTextArea; +import processing.app.syntax.TextAreaPainter; + +/** + * Paint texts from input method. Text via input method are transmitted by + * AttributedCaharacterIterator. This class helps the PDE's TextAreaPainter + * to handle AttributedCaharacterIterator. + * + * For practical purposes, paint to textarea is done by TextLayout class. + * Because TextLayout class is easy to draw composing texts. (For example, + * draw underline composing texts, focus when select from candidates text.) + * + * @author Takashi Maekawa (takachin@generative.info) + */ +public class CompositionTextPainter { + private TextLayout composedTextLayout; + private int composedBeginCaretPosition = 0; + private JEditTextArea textArea; + + /** + * Constructor for painter. + * @param textarea textarea used by PDE. + */ + public CompositionTextPainter(JEditTextArea textArea) { + this.textArea = textArea; + composedTextLayout = null; + } + + /** + * Check the painter has TextLayout. + * If a user input via InputMethod, this result will return true. + * @param textarea textarea used by PDE. + */ + public boolean hasComposedTextLayout() { + return (composedTextLayout != null); + } + + /** + * Set TextLayout to the painter. + * TextLayout will be created and set by CompositionTextManager. + * + * @see CompositionTextManager + * @param textarea textarea used by PDE. + */ + public void setComposedTextLayout(TextLayout composedTextLayout, int composedStartCaretPosition) { + this.composedTextLayout = composedTextLayout; + this.composedBeginCaretPosition = composedStartCaretPosition; + } + + /** + * Invalidate this TextLayout to set null. + * If a user end input via InputMethod, this method will called from CompositionTextManager.endCompositionText + */ + public void invalidateComposedTextLayout(int composedEndCaretPosition) { + this.composedTextLayout = null; + this.composedBeginCaretPosition = composedEndCaretPosition; + //this.composedBeginCaretPosition = textArea.getCaretPosition(); + } + + /** + * Draw text via input method with composed text information. + * This method can draw texts with some underlines to illustrate converting characters. + * + * This method is workaround for TextAreaPainter. + * Because, TextAreaPainter can't treat AttributedCharacterIterator directly. + * AttributedCharacterIterator has very important information when composing text. + * It has a map where are converted characters and committed characters. + * Ideally, changing TextAreaPainter method can treat AttributedCharacterIterator is better. But it's very tough!! + * So I choose to write some code as a workaround. + * + * This draw method is proceeded with the following steps. + * 1. Original TextAreaPainter draws characters. + * 2. This refillComposedArea method erase previous paint characters by textarea's background color. + * The refill area is only square that width and height defined by characters with input method. + * 3. CompositionTextPainter.draw method paints composed text. It was actually drawn by TextLayout. + * + * @param gfx set TextAreaPainter's Graphics object. + * @param fillBackGroundColor set textarea's background. + */ + public void draw(Graphics gfx, Color fillBackGroundColor) { + assert(composedTextLayout != null); + Point composedLoc = getCaretLocation(); + refillComposedArea(fillBackGroundColor, composedLoc.x, composedLoc.y); + composedTextLayout.draw((Graphics2D) gfx, composedLoc.x, composedLoc.y); + } + + /** + * Fill color to erase characters drawn by original TextAreaPainter. + * + * @param fillColor fill color to erase characters drawn by original TextAreaPainter method. + * @param x x-coordinate where to fill. + * @param y y-coordinate where to fill. + */ + private void refillComposedArea(Color fillColor, int x, int y) { + Graphics gfx = textArea.getPainter().getGraphics(); + gfx.setColor(fillColor); + FontMetrics fm = textArea.getPainter().getFontMetrics(); + int newY = y - (fm.getHeight() - CompositionTextManager.COMPOSING_UNDERBAR_HEIGHT); + int paintHeight = fm.getHeight(); + int paintWidth = (int) composedTextLayout.getBounds().getWidth(); + gfx.fillRect(x, newY, paintWidth, paintHeight); + } + + private Point getCaretLocation() { + Point loc = new Point(); + TextAreaPainter painter = textArea.getPainter(); + FontMetrics fm = painter.getFontMetrics(); + int offsetY = fm.getHeight() - CompositionTextManager.COMPOSING_UNDERBAR_HEIGHT; + int lineIndex = textArea.getCaretLine(); + loc.y = lineIndex * fm.getHeight() + offsetY; + int offsetX = composedBeginCaretPosition - textArea.getLineStartOffset(lineIndex); + loc.x = textArea.offsetToX(lineIndex, offsetX); + return loc; + } +} diff --git a/app/src/processing/app/syntax/im/InputMethodSupport.java b/app/src/processing/app/syntax/im/InputMethodSupport.java new file mode 100644 index 000000000..33a86bb1a --- /dev/null +++ b/app/src/processing/app/syntax/im/InputMethodSupport.java @@ -0,0 +1,105 @@ +package processing.app.syntax.im; + +import java.awt.Rectangle; +import java.awt.event.InputMethodEvent; +import java.awt.event.InputMethodListener; +import java.awt.font.TextHitInfo; +import java.awt.im.InputMethodRequests; +import java.text.AttributedCharacterIterator; + +import processing.app.syntax.JEditTextArea; + +/** + * Support in-line Japanese input for PDE. (Maybe Chinese, Korean and more) + * This class is implemented by Java Input Method Framework and handles + * If you would like to know more about Java Input Method Framework, + * Please see http://java.sun.com/j2se/1.5.0/docs/guide/imf/ + * + * This class is implemented to fix Bug #854. + * http://dev.processing.org/bugs/show_bug.cgi?id=854 + * + * @author Takashi Maekawa (takachin@generative.info) + */ +public class InputMethodSupport implements InputMethodRequests, + InputMethodListener { + + private int committed_count = 0; + private CompositionTextManager textManager; + + public InputMethodSupport(JEditTextArea textArea) { + textManager = new CompositionTextManager(textArea); + textArea.enableInputMethods(true); + textArea.addInputMethodListener(this); + } + + public Rectangle getTextLocation(TextHitInfo offset) { + return textManager.getTextLocation(); + } + + public TextHitInfo getLocationOffset(int x, int y) { + return null; + } + + public int getInsertPositionOffset() { + return textManager.getInsertPositionOffset(); + } + + public AttributedCharacterIterator getCommittedText(int beginIndex, + int endIndex, AttributedCharacterIterator.Attribute[] attributes) { + return textManager.getCommittedText(beginIndex, endIndex); + } + + public int getCommittedTextLength() { + return committed_count; + } + + public AttributedCharacterIterator cancelLatestCommittedText( + AttributedCharacterIterator.Attribute[] attributes) { + return null; + } + + public AttributedCharacterIterator getSelectedText( + AttributedCharacterIterator.Attribute[] attributes) { + return null; + } + + /** + * Handles events from InputMethod. + * This method judges whether beginning of input or + * progress of input or end and call related method. + * + * @param event event from Input Method. + */ + public void inputMethodTextChanged(InputMethodEvent event) { + AttributedCharacterIterator text = event.getText(); + committed_count = event.getCommittedCharacterCount(); + if(isBeginInputProcess(text, textManager)){ + textManager.beginCompositionText(text, committed_count); + caretPositionChanged(event); + return; + } + if (isInputProcess(text)){ + textManager.processCompositionText(text, committed_count); + caretPositionChanged(event); + return; + } + textManager.endCompositionText(text, committed_count); + caretPositionChanged(event); + } + + private boolean isBeginInputProcess(AttributedCharacterIterator text, CompositionTextManager textManager){ + if(text == null) + return false; + return (isInputProcess(text) && !textManager.getIsInputProcess()); + } + + private boolean isInputProcess(AttributedCharacterIterator text){ + if(text == null) + return false; + return (text.getEndIndex() - (text.getBeginIndex() + committed_count) > 0); + } + + public void caretPositionChanged(InputMethodEvent event) { + event.consume(); + } +} diff --git a/app/src/processing/app/tools/ColorSelector.java b/app/src/processing/app/tools/ColorSelector.java index d4843d18a..de1402239 100644 --- a/app/src/processing/app/tools/ColorSelector.java +++ b/app/src/processing/app/tools/ColorSelector.java @@ -120,6 +120,7 @@ public class ColorSelector implements Tool, DocumentListener { frame.setVisible(false); } }); + Base.setIcon(frame); hueField.getDocument().addDocumentListener(this); @@ -444,19 +445,25 @@ public class ColorSelector implements Tool, DocumentListener { } public Dimension getPreferredSize() { - //System.out.println("getting pref " + WIDE + " " + HIGH); return new Dimension(WIDE, HIGH); } public Dimension getMinimumSize() { - //System.out.println("getting min " + WIDE + " " + HIGH); return new Dimension(WIDE, HIGH); } public Dimension getMaximumSize() { - //System.out.println("getting max " + WIDE + " " + HIGH); return new Dimension(WIDE, HIGH); } + + public void keyPressed() { + if (key == ESC) { + ColorSelector.this.frame.setVisible(false); + // don't quit out of processing + // http://dev.processing.org/bugs/show_bug.cgi?id=1006 + key = 0; + } + } } @@ -506,19 +513,25 @@ public class ColorSelector implements Tool, DocumentListener { } public Dimension getPreferredSize() { - //System.out.println("s getting pref " + WIDE + " " + HIGH); return new Dimension(WIDE, HIGH); } public Dimension getMinimumSize() { - //System.out.println("s getting min " + WIDE + " " + HIGH); return new Dimension(WIDE, HIGH); } public Dimension getMaximumSize() { - //System.out.println("s getting max " + WIDE + " " + HIGH); return new Dimension(WIDE, HIGH); } + + public void keyPressed() { + if (key == ESC) { + ColorSelector.this.frame.setVisible(false); + // don't quit out of processing + // http://dev.processing.org/bugs/show_bug.cgi?id=1006 + key = 0; + } + } } @@ -540,7 +553,7 @@ public class ColorSelector implements Tool, DocumentListener { public Dimension getPreferredSize() { if (!allowHex) { - return new Dimension(35, super.getPreferredSize().height); + return new Dimension(45, super.getPreferredSize().height); } return super.getPreferredSize(); } diff --git a/app/src/processing/app/tools/CreateFont.java b/app/src/processing/app/tools/CreateFont.java index 663798985..62d2ce4c0 100644 --- a/app/src/processing/app/tools/CreateFont.java +++ b/app/src/processing/app/tools/CreateFont.java @@ -3,7 +3,7 @@ /* Part of the Processing project - http://processing.org - Copyright (c) 2004-06 Ben Fry and Casey Reas + Copyright (c) 2004-10 Ben Fry and Casey Reas Copyright (c) 2001-04 Massachusetts Institute of Technology This program is free software; you can redistribute it and/or modify @@ -37,7 +37,7 @@ import javax.swing.event.*; /** - * gui interface to font creation heaven/hell. + * GUI tool for font creation heaven/hell. */ public class CreateFont extends JFrame implements Tool { Editor editor; @@ -46,30 +46,22 @@ public class CreateFont extends JFrame implements Tool { Dimension windowSize; JList fontSelector; - //JComboBox styleSelector; JTextField sizeSelector; - JCheckBox allBox; + JButton charsetButton; JCheckBox smoothBox; - JTextArea sample; + JComponent sample; JButton okButton; JTextField filenameField; - Hashtable table; + HashMap table; boolean smooth = true; - boolean all = false; Font font; String[] list; int selection = -1; - - //static { - //System.out.println("yep yep yep"); - //} - //static final String styles[] = { - //"Plain", "Bold", "Italic", "Bold Italic" - //}; + CharacterSelector charSelector; public CreateFont() { @@ -117,7 +109,7 @@ public class CreateFont extends JFrame implements Tool { Font fonts[] = ge.getAllFonts(); String flist[] = new String[fonts.length]; - table = new Hashtable(); + table = new HashMap(); int index = 0; for (int i = 0; i < fonts.length; i++) { @@ -150,20 +142,8 @@ public class CreateFont extends JFrame implements Tool { Dimension d1 = new Dimension(13, 13); pain.add(new Box.Filler(d1, d1, d1)); - // see http://rinkworks.com/words/pangrams.shtml - sample = new JTextArea("The quick brown fox blah blah.") { - // Forsaking monastic tradition, twelve jovial friars gave up their - // vocation for a questionable existence on the flying trapeze. - public void paintComponent(Graphics g) { - //System.out.println("disabling aa"); - Graphics2D g2 = (Graphics2D) g; - g2.setRenderingHint(RenderingHints.KEY_TEXT_ANTIALIASING, - smooth ? - RenderingHints.VALUE_TEXT_ANTIALIAS_ON : - RenderingHints.VALUE_TEXT_ANTIALIAS_OFF); - super.paintComponent(g2); - } - }; + sample = new SampleComponent(this); + // Seems that in some instances, no default font is set // http://dev.processing.org/bugs/show_bug.cgi?id=777 sample.setFont(new Font("Dialog", Font.PLAIN, 12)); @@ -193,14 +173,22 @@ public class CreateFont extends JFrame implements Tool { smoothBox.setSelected(smooth); panel.add(smoothBox); - allBox = new JCheckBox("All Characters"); - allBox.addActionListener(new ActionListener() { +// allBox = new JCheckBox("All Characters"); +// allBox.addActionListener(new ActionListener() { +// public void actionPerformed(ActionEvent e) { +// all = allBox.isSelected(); +// } +// }); +// allBox.setSelected(all); +// panel.add(allBox); + charsetButton = new JButton("Characters..."); + charsetButton.addActionListener(new ActionListener() { public void actionPerformed(ActionEvent e) { - all = allBox.isSelected(); + //showCharacterList(); + charSelector.setVisible(true); } }); - allBox.setSelected(all); - panel.add(allBox); + panel.add(charsetButton); pain.add(panel); @@ -239,6 +227,7 @@ public class CreateFont extends JFrame implements Tool { Base.registerWindowCloseKeys(root, disposer); Base.setIcon(this); + setResizable(false); pack(); // do this after pack so it doesn't affect layout @@ -251,6 +240,9 @@ public class CreateFont extends JFrame implements Tool { setLocation((screen.width - windowSize.width) / 2, (screen.height - windowSize.height) / 2); + + // create this behind the scenes + charSelector = new CharacterSelector(); } @@ -259,26 +251,6 @@ public class CreateFont extends JFrame implements Tool { } - /** - * make the window vertically resizable - */ - public Dimension getMaximumSize() { - return new Dimension(windowSize.width, 2000); - } - - public Dimension getMinimumSize() { - return windowSize; - } - - - /* - public void show(File targetFolder) { - this.targetFolder = targetFolder; - show(); - } - */ - - public void update() { int fontsize = 0; try { @@ -313,7 +285,7 @@ public class CreateFont extends JFrame implements Tool { return; } - String filename = filenameField.getText(); + String filename = filenameField.getText().trim(); if (filename.length() == 0) { JOptionPane.showMessageDialog(this, "Enter a file name for the font.", "Lameness", JOptionPane.WARNING_MESSAGE); @@ -323,23 +295,519 @@ public class CreateFont extends JFrame implements Tool { filename += ".vlw"; } + // Please implement me properly. The schematic is below, but not debugged. + // http://dev.processing.org/bugs/show_bug.cgi?id=1464 + +// final String filename2 = filename; +// final int fontsize2 = fontsize; +// SwingUtilities.invokeLater(new Runnable() { +// public void run() { try { Font instance = (Font) table.get(list[selection]); font = instance.deriveFont(Font.PLAIN, fontsize); - PFont f = new PFont(font, smooth, all ? null : PFont.DEFAULT_CHARSET); + //PFont f = new PFont(font, smooth, all ? null : PFont.CHARSET); + PFont f = new PFont(font, smooth, charSelector.getCharacters()); + +// PFont f = new PFont(font, smooth, null); +// char[] charset = charSelector.getCharacters(); +// ProgressMonitor progressMonitor = new ProgressMonitor(CreateFont.this, +// "Creating font", "", 0, charset.length); +// progressMonitor.setProgress(0); +// for (int i = 0; i < charset.length; i++) { +// System.out.println(charset[i]); +// f.index(charset[i]); // load this char +// progressMonitor.setProgress(i+1); +// } // make sure the 'data' folder exists File folder = editor.getSketch().prepareDataFolder(); f.save(new FileOutputStream(new File(folder, filename))); } catch (IOException e) { - JOptionPane.showMessageDialog(this, + JOptionPane.showMessageDialog(CreateFont.this, "An error occurred while creating font.", "No font for you", JOptionPane.WARNING_MESSAGE); e.printStackTrace(); } +// } +// }); setVisible(false); } + + + /** + * make the window vertically resizable + */ + public Dimension getMaximumSize() { + return new Dimension(windowSize.width, 2000); } + + + public Dimension getMinimumSize() { + return windowSize; + } + + + /* + public void show(File targetFolder) { + this.targetFolder = targetFolder; + show(); + } + */ +} + + +/** + * Component that draws the sample text. This is its own subclassed component + * because Mac OS X controls seem to reset the RenderingHints for smoothing + * so that they cannot be overridden properly for JLabel or JTextArea. + * @author fry + */ +class SampleComponent extends JComponent { + // see http://rinkworks.com/words/pangrams.shtml + String text = + "Forsaking monastic tradition, twelve jovial friars gave up their " + + "vocation for a questionable existence on the flying trapeze."; + int high = 80; + + CreateFont parent; + + public SampleComponent(CreateFont p) { + this.parent = p; + + // and yet, we still need an inner class to handle the basics. + // or no, maybe i'll refactor this as a separate class! + // maybe a few getters and setters? mmm? + addMouseListener(new MouseAdapter() { + public void mousePressed(MouseEvent e) { + String input = + (String) JOptionPane.showInputDialog(parent, + "Enter new sample text:", + "Sample Text", + JOptionPane.PLAIN_MESSAGE, + null, // icon + null, // choices + text); + if (input != null) { + text = input; + parent.repaint(); + } + } + }); + } + + public void paintComponent(Graphics g) { +// System.out.println("smoothing set to " + smooth); + Graphics2D g2 = (Graphics2D) g; + g2.setColor(Color.WHITE); + Dimension dim = getSize(); + g2.fillRect(0, 0, dim.width, dim.height); + g2.setColor(Color.BLACK); + + g2.setRenderingHint(RenderingHints.KEY_TEXT_ANTIALIASING, + parent.smooth ? + RenderingHints.VALUE_TEXT_ANTIALIAS_ON : + RenderingHints.VALUE_TEXT_ANTIALIAS_OFF); + // add this one as well (after 1.0.9) + g2.setRenderingHint(RenderingHints.KEY_ANTIALIASING, + parent.smooth ? + RenderingHints.VALUE_ANTIALIAS_ON : + RenderingHints.VALUE_ANTIALIAS_OFF); + //super.paintComponent(g2); + Font font = getFont(); + int ascent = g2.getFontMetrics().getAscent(); +// System.out.println(f.getName()); + g2.setFont(font); + g2.drawString(text, 5, dim.height - (dim.height - ascent) / 2); + } + + public Dimension getPreferredSize() { + return new Dimension(400, high); + } + + public Dimension getMaximumSize() { + return new Dimension(10000, high); + } + + public Dimension getMinimumSize() { + return new Dimension(100, high); + } +} + + +/** + * Frame for selecting which characters will be included with the font. + */ +class CharacterSelector extends JFrame { + JRadioButton defaultCharsButton; + JRadioButton allCharsButton; + JRadioButton unicodeCharsButton; + JScrollPane unicodeBlockScroller; + JList charsetList; + + + public CharacterSelector() { + super("Character Selector"); + + charsetList = new CheckBoxList(); + DefaultListModel model = new DefaultListModel(); + charsetList.setModel(model); + for (String item : blockNames) { + model.addElement(new JCheckBox(item)); + } + + unicodeBlockScroller = + new JScrollPane(charsetList, + ScrollPaneConstants.VERTICAL_SCROLLBAR_ALWAYS, + ScrollPaneConstants.HORIZONTAL_SCROLLBAR_NEVER); + + Container outer = getContentPane(); + outer.setLayout(new BorderLayout()); + + JPanel pain = new JPanel(); + pain.setBorder(new EmptyBorder(13, 13, 13, 13)); + outer.add(pain, BorderLayout.CENTER); + + pain.setLayout(new BoxLayout(pain, BoxLayout.Y_AXIS)); + + String labelText = + "Default characters will include most bitmaps for Mac OS\n" + + "and Windows Latin scripts. Including all characters may\n" + + "require large amounts of memory for all of the bitmaps.\n" + + "For greater control, you can select specific Unicode blocks."; + JTextArea textarea = new JTextArea(labelText); + textarea.setBorder(new EmptyBorder(13, 8, 13, 8)); + textarea.setBackground(null); + textarea.setEditable(false); + textarea.setHighlighter(null); + textarea.setFont(new Font("Dialog", Font.PLAIN, 12)); + pain.add(textarea); + + ActionListener listener = new ActionListener() { + public void actionPerformed(ActionEvent e) { + //System.out.println("action " + unicodeCharsButton.isSelected()); + //unicodeBlockScroller.setEnabled(unicodeCharsButton.isSelected()); + charsetList.setEnabled(unicodeCharsButton.isSelected()); + } + }; + defaultCharsButton = new JRadioButton("Default Characters"); + allCharsButton = new JRadioButton("All Characters"); + unicodeCharsButton = new JRadioButton("Specific Unicode Blocks"); + + defaultCharsButton.addActionListener(listener); + allCharsButton.addActionListener(listener); + unicodeCharsButton.addActionListener(listener); + + ButtonGroup group = new ButtonGroup(); + group.add(defaultCharsButton); + group.add(allCharsButton); + group.add(unicodeCharsButton); + + JPanel radioPanel = new JPanel(); + //radioPanel.setBackground(Color.red); + radioPanel.setLayout(new BoxLayout(radioPanel, BoxLayout.Y_AXIS)); + radioPanel.add(defaultCharsButton); + radioPanel.add(allCharsButton); + radioPanel.add(unicodeCharsButton); + + JPanel rightStuff = new JPanel(); + rightStuff.setLayout(new BoxLayout(rightStuff, BoxLayout.X_AXIS)); + rightStuff.add(radioPanel); + rightStuff.add(Box.createHorizontalGlue()); + pain.add(rightStuff); + pain.add(Box.createVerticalStrut(13)); + +// pain.add(radioPanel); + +// pain.add(defaultCharsButton); +// pain.add(allCharsButton); +// pain.add(unicodeCharsButton); + + defaultCharsButton.setSelected(true); + charsetList.setEnabled(false); + + //frame.getContentPane().add(scroller); + pain.add(unicodeBlockScroller); + pain.add(Box.createVerticalStrut(8)); + + JPanel buttons = new JPanel(); + JButton okButton = new JButton("OK"); + okButton.addActionListener(new ActionListener() { + public void actionPerformed(ActionEvent e) { + setVisible(false); + } + }); + okButton.setEnabled(true); + buttons.add(okButton); + pain.add(buttons); + + JRootPane root = getRootPane(); + root.setDefaultButton(okButton); + ActionListener disposer = new ActionListener() { + public void actionPerformed(ActionEvent actionEvent) { + setVisible(false); + } + }; + Base.registerWindowCloseKeys(root, disposer); + Base.setIcon(this); + + pack(); + + Dimension screen = Toolkit.getDefaultToolkit().getScreenSize(); + Dimension windowSize = getSize(); + + setLocation((screen.width - windowSize.width) / 2, + (screen.height - windowSize.height) / 2); + } + + + protected char[] getCharacters() { + if (defaultCharsButton.isSelected()) { + return PFont.CHARSET; + } + + char[] charset = new char[65536]; + if (allCharsButton.isSelected()) { + for (int i = 0; i < 0xFFFF; i++) { + charset[i] = (char) i; + } + } else { + DefaultListModel model = (DefaultListModel) charsetList.getModel(); + int index = 0; + for (int i = 0; i < BLOCKS.length; i++) { + if (((JCheckBox) model.get(i)).isSelected()) { + for (int j = blockStart[i]; j <= blockStop[i]; j++) { + charset[index++] = (char) j; + } + } + } + charset = PApplet.subset(charset, 0, index); + } + //System.out.println("Creating font with " + charset.length + " characters."); + return charset; + } + + + // http://www.unicode.org/Public/UNIDATA/Blocks.txt + static final String[] BLOCKS = { + "0000..007F; Basic Latin", + "0080..00FF; Latin-1 Supplement", + "0100..017F; Latin Extended-A", + "0180..024F; Latin Extended-B", + "0250..02AF; IPA Extensions", + "02B0..02FF; Spacing Modifier Letters", + "0300..036F; Combining Diacritical Marks", + "0370..03FF; Greek and Coptic", + "0400..04FF; Cyrillic", + "0500..052F; Cyrillic Supplement", + "0530..058F; Armenian", + "0590..05FF; Hebrew", + "0600..06FF; Arabic", + "0700..074F; Syriac", + "0750..077F; Arabic Supplement", + "0780..07BF; Thaana", + "07C0..07FF; NKo", + "0800..083F; Samaritan", + "0900..097F; Devanagari", + "0980..09FF; Bengali", + "0A00..0A7F; Gurmukhi", + "0A80..0AFF; Gujarati", + "0B00..0B7F; Oriya", + "0B80..0BFF; Tamil", + "0C00..0C7F; Telugu", + "0C80..0CFF; Kannada", + "0D00..0D7F; Malayalam", + "0D80..0DFF; Sinhala", + "0E00..0E7F; Thai", + "0E80..0EFF; Lao", + "0F00..0FFF; Tibetan", + "1000..109F; Myanmar", + "10A0..10FF; Georgian", + "1100..11FF; Hangul Jamo", + "1200..137F; Ethiopic", + "1380..139F; Ethiopic Supplement", + "13A0..13FF; Cherokee", + "1400..167F; Unified Canadian Aboriginal Syllabics", + "1680..169F; Ogham", + "16A0..16FF; Runic", + "1700..171F; Tagalog", + "1720..173F; Hanunoo", + "1740..175F; Buhid", + "1760..177F; Tagbanwa", + "1780..17FF; Khmer", + "1800..18AF; Mongolian", + "18B0..18FF; Unified Canadian Aboriginal Syllabics Extended", + "1900..194F; Limbu", + "1950..197F; Tai Le", + "1980..19DF; New Tai Lue", + "19E0..19FF; Khmer Symbols", + "1A00..1A1F; Buginese", + "1A20..1AAF; Tai Tham", + "1B00..1B7F; Balinese", + "1B80..1BBF; Sundanese", + "1C00..1C4F; Lepcha", + "1C50..1C7F; Ol Chiki", + "1CD0..1CFF; Vedic Extensions", + "1D00..1D7F; Phonetic Extensions", + "1D80..1DBF; Phonetic Extensions Supplement", + "1DC0..1DFF; Combining Diacritical Marks Supplement", + "1E00..1EFF; Latin Extended Additional", + "1F00..1FFF; Greek Extended", + "2000..206F; General Punctuation", + "2070..209F; Superscripts and Subscripts", + "20A0..20CF; Currency Symbols", + "20D0..20FF; Combining Diacritical Marks for Symbols", + "2100..214F; Letterlike Symbols", + "2150..218F; Number Forms", + "2190..21FF; Arrows", + "2200..22FF; Mathematical Operators", + "2300..23FF; Miscellaneous Technical", + "2400..243F; Control Pictures", + "2440..245F; Optical Character Recognition", + "2460..24FF; Enclosed Alphanumerics", + "2500..257F; Box Drawing", + "2580..259F; Block Elements", + "25A0..25FF; Geometric Shapes", + "2600..26FF; Miscellaneous Symbols", + "2700..27BF; Dingbats", + "27C0..27EF; Miscellaneous Mathematical Symbols-A", + "27F0..27FF; Supplemental Arrows-A", + "2800..28FF; Braille Patterns", + "2900..297F; Supplemental Arrows-B", + "2980..29FF; Miscellaneous Mathematical Symbols-B", + "2A00..2AFF; Supplemental Mathematical Operators", + "2B00..2BFF; Miscellaneous Symbols and Arrows", + "2C00..2C5F; Glagolitic", + "2C60..2C7F; Latin Extended-C", + "2C80..2CFF; Coptic", + "2D00..2D2F; Georgian Supplement", + "2D30..2D7F; Tifinagh", + "2D80..2DDF; Ethiopic Extended", + "2DE0..2DFF; Cyrillic Extended-A", + "2E00..2E7F; Supplemental Punctuation", + "2E80..2EFF; CJK Radicals Supplement", + "2F00..2FDF; Kangxi Radicals", + "2FF0..2FFF; Ideographic Description Characters", + "3000..303F; CJK Symbols and Punctuation", + "3040..309F; Hiragana", + "30A0..30FF; Katakana", + "3100..312F; Bopomofo", + "3130..318F; Hangul Compatibility Jamo", + "3190..319F; Kanbun", + "31A0..31BF; Bopomofo Extended", + "31C0..31EF; CJK Strokes", + "31F0..31FF; Katakana Phonetic Extensions", + "3200..32FF; Enclosed CJK Letters and Months", + "3300..33FF; CJK Compatibility", + "3400..4DBF; CJK Unified Ideographs Extension A", + "4DC0..4DFF; Yijing Hexagram Symbols", + "4E00..9FFF; CJK Unified Ideographs", + "A000..A48F; Yi Syllables", + "A490..A4CF; Yi Radicals", + "A4D0..A4FF; Lisu", + "A500..A63F; Vai", + "A640..A69F; Cyrillic Extended-B", + "A6A0..A6FF; Bamum", + "A700..A71F; Modifier Tone Letters", + "A720..A7FF; Latin Extended-D", + "A800..A82F; Syloti Nagri", + "A830..A83F; Common Indic Number Forms", + "A840..A87F; Phags-pa", + "A880..A8DF; Saurashtra", + "A8E0..A8FF; Devanagari Extended", + "A900..A92F; Kayah Li", + "A930..A95F; Rejang", + "A960..A97F; Hangul Jamo Extended-A", + "A980..A9DF; Javanese", + "AA00..AA5F; Cham", + "AA60..AA7F; Myanmar Extended-A", + "AA80..AADF; Tai Viet", + "ABC0..ABFF; Meetei Mayek", + "AC00..D7AF; Hangul Syllables", + "D7B0..D7FF; Hangul Jamo Extended-B", + "D800..DB7F; High Surrogates", + "DB80..DBFF; High Private Use Surrogates", + "DC00..DFFF; Low Surrogates", + "E000..F8FF; Private Use Area", + "F900..FAFF; CJK Compatibility Ideographs", + "FB00..FB4F; Alphabetic Presentation Forms", + "FB50..FDFF; Arabic Presentation Forms-A", + "FE00..FE0F; Variation Selectors", + "FE10..FE1F; Vertical Forms", + "FE20..FE2F; Combining Half Marks", + "FE30..FE4F; CJK Compatibility Forms", + "FE50..FE6F; Small Form Variants", + "FE70..FEFF; Arabic Presentation Forms-B", + "FF00..FFEF; Halfwidth and Fullwidth Forms", + "FFF0..FFFF; Specials" + }; + + static String[] blockNames; + static int[] blockStart; + static int[] blockStop; + static { + int count = BLOCKS.length; + blockNames = new String[count]; + blockStart = new int[count]; + blockStop = new int[count]; + for (int i = 0; i < count; i++) { + String line = BLOCKS[i]; + blockStart[i] = PApplet.unhex(line.substring(0, 4)); + blockStop[i] = PApplet.unhex(line.substring(6, 10)); + blockNames[i] = line.substring(12); + } +// PApplet.println(codePointStop); +// PApplet.println(codePoints); + } +} + + +// Code for this CheckBoxList class found on the net, though I've lost the +// link. If you run across the original version, please let me know so that +// the original author can be credited properly. It was from a snippet +// collection, but it seems to have been picked up so many places with others +// placing their copyright on it, that I haven't been able to determine the +// original author. [fry 20100216] +class CheckBoxList extends JList { + protected static Border noFocusBorder = new EmptyBorder(1, 1, 1, 1); + + public CheckBoxList() { + setCellRenderer(new CellRenderer()); + + addMouseListener(new MouseAdapter() { + public void mousePressed(MouseEvent e) { + if (isEnabled()) { + int index = locationToIndex(e.getPoint()); + + if (index != -1) { + JCheckBox checkbox = (JCheckBox) + getModel().getElementAt(index); + checkbox.setSelected(!checkbox.isSelected()); + repaint(); + } + } + } + }); + setSelectionMode(ListSelectionModel.SINGLE_SELECTION); + } + + + protected class CellRenderer implements ListCellRenderer { + public Component getListCellRendererComponent(JList list, Object value, + int index, boolean isSelected, + boolean cellHasFocus) { + JCheckBox checkbox = (JCheckBox) value; + checkbox.setBackground(isSelected ? getSelectionBackground() : getBackground()); + checkbox.setForeground(isSelected ? getSelectionForeground() : getForeground()); + //checkbox.setEnabled(isEnabled()); + checkbox.setEnabled(list.isEnabled()); + checkbox.setFont(getFont()); + checkbox.setFocusPainted(false); + checkbox.setBorderPainted(true); + checkbox.setBorder(isSelected ? UIManager.getBorder("List.focusCellHighlightBorder") : noFocusBorder); + return checkbox; + } + } +} \ No newline at end of file diff --git a/app/src/processing/app/windows/Platform.java b/app/src/processing/app/windows/Platform.java index cdc685ecf..63e76145a 100644 --- a/app/src/processing/app/windows/Platform.java +++ b/app/src/processing/app/windows/Platform.java @@ -3,7 +3,7 @@ /* Part of the Processing project - http://processing.org - Copyright (c) 2008 Ben Fry and Casey Reas + Copyright (c) 2008-2009 Ben Fry and Casey Reas This program is free software; you can redistribute it and/or modify it under the terms of the GNU General Public License as published by @@ -25,6 +25,9 @@ package processing.app.windows; import java.io.File; import java.io.UnsupportedEncodingException; +import com.sun.jna.Library; +import com.sun.jna.Native; + import processing.app.Base; import processing.app.Preferences; import processing.app.windows.Registry.REGISTRY_ROOT_KEY; @@ -265,4 +268,38 @@ public class Platform extends processing.app.Platform { // not tested //Runtime.getRuntime().exec("start explorer \"" + folder + "\""); } + + + // . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . + + + // Code partially thanks to Richard Quirk from: + // http://quirkygba.blogspot.com/2009/11/setting-environment-variables-in-java.html + + static WinLibC clib = (WinLibC) Native.loadLibrary("msvcrt", WinLibC.class); + + public interface WinLibC extends Library { + //WinLibC INSTANCE = (WinLibC) Native.loadLibrary("msvcrt", WinLibC.class); + //libc = Native.loadLibrary("msvcrt", WinLibC.class); + public int _putenv(String name); +} + + + public void setenv(String variable, String value) { + //WinLibC clib = WinLibC.INSTANCE; + clib._putenv(variable + "=" + value); + } + + + public String getenv(String variable) { + return System.getenv(variable); + } + + + public int unsetenv(String variable) { + //WinLibC clib = WinLibC.INSTANCE; + //clib._putenv(variable + "="); + //return 0; + return clib._putenv(variable + "="); + } } diff --git a/build/macosx/make.sh b/build/macosx/make.sh index 12601e0b5..0b1ac3eea 100755 --- a/build/macosx/make.sh +++ b/build/macosx/make.sh @@ -113,6 +113,7 @@ javac \ src/processing/app/macosx/*.java \ src/processing/app/preproc/*.java \ src/processing/app/syntax/*.java \ + src/processing/app/syntax/im/*.java \ src/processing/app/tools/*.java cd ../build/macosx/work/classes diff --git a/build/shared/lib/preferences.txt b/build/shared/lib/preferences.txt index 0dc7963f6..fc74866a3 100755 --- a/build/shared/lib/preferences.txt +++ b/build/shared/lib/preferences.txt @@ -72,8 +72,15 @@ platform.auto_file_type_associations = true # default size for the main window -default.window.width = 500 -default.window.height = 600 +editor.window.width.default = 500 +editor.window.height.default = 600 + +editor.window.width.min = 400 +editor.window.height.min = 500 +# tested as approx 440 on OS X +editor.window.height.min.macosx = 450 +# tested to be 515 on Windows XP, this leaves some room +editor.window.height.min.windows = 530 # font size for editor editor.font=Monospaced,plain,12 @@ -92,6 +99,21 @@ editor.caret.blink=true # area that's not in use by the text (replaced with tildes) editor.invalid=false +# enable ctrl-ins, shift-ins, shift-delete for cut/copy/paste +# on windows and linux, but disable on the mac +editor.keys.alternative_cut_copy_paste = true +editor.keys.alternative_cut_copy_paste.macosx = false + +# true if shift-backspace sends the delete character, +# false if shift-backspace just means backspace +editor.keys.shift_backspace_is_delete = true + +# home and end keys should only travel to the start/end of the current line +editor.keys.home_and_end_travel_far = false +# the OS X HI Guidelines say that home/end are relative to the document +# if you don't like it, this is the preference to change +editor.keys.home_and_end_travel_far.macosx = true + console = true console.output.file = stdout.txt console.error.file = stderr.txt @@ -197,14 +219,14 @@ preproc.substitute_unicode = true # viewed in (at least) Mozilla or IE. useful when debugging the preprocessor. preproc.output_parse_tree = false -# imports to use by default (changed for 0149, some imports removed) -preproc.imports = java.applet,java.awt,java.awt.image,java.awt.event,java.io,java.net,java.text,java.util,java.util.zip,java.util.regex +# Changed after 1.0.9 to a new name, and also includes the specific entries +preproc.imports.list = java.applet.*,java.awt.Dimension,java.awt.Frame,java.awt.event.MouseEvent,java.awt.event.KeyEvent,java.awt.event.FocusEvent,java.awt.Image,java.io.*,java.net.*,java.text.*,java.util.*,java.util.zip.*,java.util.regex.* # set the browser to be used on linux browser.linux = mozilla # set to the program to be used for launching apps on linux -#launcher.linux = gnome-open +#launcher.linux = xdg-open # FULL SCREEN (PRESENT MODE) run.present.bgcolor = #666666 diff --git a/core/.project b/core/.project index 9884df8b9..e791e6fcd 100644 --- a/core/.project +++ b/core/.project @@ -1,17 +1,17 @@ - - - core - - - - - - org.eclipse.jdt.core.javabuilder - - - - - - org.eclipse.jdt.core.javanature - - + + + processing-core + + + + + + org.eclipse.jdt.core.javabuilder + + + + + + org.eclipse.jdt.core.javanature + + diff --git a/core/.settings/org.eclipse.jdt.core.prefs b/core/.settings/org.eclipse.jdt.core.prefs index f80f9b559..c06b36105 100644 --- a/core/.settings/org.eclipse.jdt.core.prefs +++ b/core/.settings/org.eclipse.jdt.core.prefs @@ -1,261 +1,271 @@ -#Thu Aug 28 17:36:28 EDT 2008 -eclipse.preferences.version=1 -org.eclipse.jdt.core.compiler.codegen.targetPlatform=1.5 -org.eclipse.jdt.core.compiler.compliance=1.5 -org.eclipse.jdt.core.compiler.problem.assertIdentifier=error -org.eclipse.jdt.core.compiler.problem.enumIdentifier=error -org.eclipse.jdt.core.compiler.source=1.5 -org.eclipse.jdt.core.formatter.align_type_members_on_columns=false -org.eclipse.jdt.core.formatter.alignment_for_arguments_in_allocation_expression=16 -org.eclipse.jdt.core.formatter.alignment_for_arguments_in_enum_constant=16 -org.eclipse.jdt.core.formatter.alignment_for_arguments_in_explicit_constructor_call=16 -org.eclipse.jdt.core.formatter.alignment_for_arguments_in_method_invocation=18 -org.eclipse.jdt.core.formatter.alignment_for_arguments_in_qualified_allocation_expression=16 -org.eclipse.jdt.core.formatter.alignment_for_assignment=0 -org.eclipse.jdt.core.formatter.alignment_for_binary_expression=18 -org.eclipse.jdt.core.formatter.alignment_for_compact_if=16 -org.eclipse.jdt.core.formatter.alignment_for_conditional_expression=82 -org.eclipse.jdt.core.formatter.alignment_for_enum_constants=0 -org.eclipse.jdt.core.formatter.alignment_for_expressions_in_array_initializer=16 -org.eclipse.jdt.core.formatter.alignment_for_multiple_fields=16 -org.eclipse.jdt.core.formatter.alignment_for_parameters_in_constructor_declaration=18 -org.eclipse.jdt.core.formatter.alignment_for_parameters_in_method_declaration=18 -org.eclipse.jdt.core.formatter.alignment_for_selector_in_method_invocation=16 -org.eclipse.jdt.core.formatter.alignment_for_superclass_in_type_declaration=16 -org.eclipse.jdt.core.formatter.alignment_for_superinterfaces_in_enum_declaration=16 -org.eclipse.jdt.core.formatter.alignment_for_superinterfaces_in_type_declaration=16 -org.eclipse.jdt.core.formatter.alignment_for_throws_clause_in_constructor_declaration=16 -org.eclipse.jdt.core.formatter.alignment_for_throws_clause_in_method_declaration=16 -org.eclipse.jdt.core.formatter.blank_lines_after_imports=1 -org.eclipse.jdt.core.formatter.blank_lines_after_package=1 -org.eclipse.jdt.core.formatter.blank_lines_before_field=1 -org.eclipse.jdt.core.formatter.blank_lines_before_first_class_body_declaration=0 -org.eclipse.jdt.core.formatter.blank_lines_before_imports=1 -org.eclipse.jdt.core.formatter.blank_lines_before_member_type=1 -org.eclipse.jdt.core.formatter.blank_lines_before_method=1 -org.eclipse.jdt.core.formatter.blank_lines_before_new_chunk=1 -org.eclipse.jdt.core.formatter.blank_lines_before_package=0 -org.eclipse.jdt.core.formatter.blank_lines_between_import_groups=1 -org.eclipse.jdt.core.formatter.blank_lines_between_type_declarations=1 -org.eclipse.jdt.core.formatter.brace_position_for_annotation_type_declaration=end_of_line -org.eclipse.jdt.core.formatter.brace_position_for_anonymous_type_declaration=end_of_line -org.eclipse.jdt.core.formatter.brace_position_for_array_initializer=end_of_line -org.eclipse.jdt.core.formatter.brace_position_for_block=end_of_line -org.eclipse.jdt.core.formatter.brace_position_for_block_in_case=end_of_line -org.eclipse.jdt.core.formatter.brace_position_for_constructor_declaration=end_of_line -org.eclipse.jdt.core.formatter.brace_position_for_enum_constant=end_of_line -org.eclipse.jdt.core.formatter.brace_position_for_enum_declaration=end_of_line -org.eclipse.jdt.core.formatter.brace_position_for_method_declaration=end_of_line -org.eclipse.jdt.core.formatter.brace_position_for_switch=end_of_line -org.eclipse.jdt.core.formatter.brace_position_for_type_declaration=end_of_line -org.eclipse.jdt.core.formatter.comment.clear_blank_lines_in_block_comment=false -org.eclipse.jdt.core.formatter.comment.clear_blank_lines_in_javadoc_comment=false -org.eclipse.jdt.core.formatter.comment.format_block_comments=true -org.eclipse.jdt.core.formatter.comment.format_header=false -org.eclipse.jdt.core.formatter.comment.format_html=true -org.eclipse.jdt.core.formatter.comment.format_javadoc_comments=true -org.eclipse.jdt.core.formatter.comment.format_line_comments=true -org.eclipse.jdt.core.formatter.comment.format_source_code=true -org.eclipse.jdt.core.formatter.comment.indent_parameter_description=true -org.eclipse.jdt.core.formatter.comment.indent_root_tags=true -org.eclipse.jdt.core.formatter.comment.insert_new_line_before_root_tags=insert -org.eclipse.jdt.core.formatter.comment.insert_new_line_for_parameter=insert -org.eclipse.jdt.core.formatter.comment.line_length=80 -org.eclipse.jdt.core.formatter.compact_else_if=true -org.eclipse.jdt.core.formatter.continuation_indentation=2 -org.eclipse.jdt.core.formatter.continuation_indentation_for_array_initializer=2 -org.eclipse.jdt.core.formatter.format_guardian_clause_on_one_line=false -org.eclipse.jdt.core.formatter.indent_body_declarations_compare_to_annotation_declaration_header=true -org.eclipse.jdt.core.formatter.indent_body_declarations_compare_to_enum_constant_header=true -org.eclipse.jdt.core.formatter.indent_body_declarations_compare_to_enum_declaration_header=true -org.eclipse.jdt.core.formatter.indent_body_declarations_compare_to_type_header=true -org.eclipse.jdt.core.formatter.indent_breaks_compare_to_cases=true -org.eclipse.jdt.core.formatter.indent_empty_lines=false -org.eclipse.jdt.core.formatter.indent_statements_compare_to_block=true -org.eclipse.jdt.core.formatter.indent_statements_compare_to_body=true -org.eclipse.jdt.core.formatter.indent_switchstatements_compare_to_cases=true -org.eclipse.jdt.core.formatter.indent_switchstatements_compare_to_switch=false -org.eclipse.jdt.core.formatter.indentation.size=2 -org.eclipse.jdt.core.formatter.insert_new_line_after_annotation=insert -org.eclipse.jdt.core.formatter.insert_new_line_after_opening_brace_in_array_initializer=do not insert -org.eclipse.jdt.core.formatter.insert_new_line_at_end_of_file_if_missing=do not insert -org.eclipse.jdt.core.formatter.insert_new_line_before_catch_in_try_statement=do not insert -org.eclipse.jdt.core.formatter.insert_new_line_before_closing_brace_in_array_initializer=do not insert -org.eclipse.jdt.core.formatter.insert_new_line_before_else_in_if_statement=do not insert -org.eclipse.jdt.core.formatter.insert_new_line_before_finally_in_try_statement=do not insert -org.eclipse.jdt.core.formatter.insert_new_line_before_while_in_do_statement=do not insert -org.eclipse.jdt.core.formatter.insert_new_line_in_empty_annotation_declaration=insert -org.eclipse.jdt.core.formatter.insert_new_line_in_empty_anonymous_type_declaration=insert -org.eclipse.jdt.core.formatter.insert_new_line_in_empty_block=insert -org.eclipse.jdt.core.formatter.insert_new_line_in_empty_enum_constant=insert -org.eclipse.jdt.core.formatter.insert_new_line_in_empty_enum_declaration=insert -org.eclipse.jdt.core.formatter.insert_new_line_in_empty_method_body=insert -org.eclipse.jdt.core.formatter.insert_new_line_in_empty_type_declaration=insert -org.eclipse.jdt.core.formatter.insert_space_after_and_in_type_parameter=insert -org.eclipse.jdt.core.formatter.insert_space_after_assignment_operator=insert -org.eclipse.jdt.core.formatter.insert_space_after_at_in_annotation=do not insert -org.eclipse.jdt.core.formatter.insert_space_after_at_in_annotation_type_declaration=do not insert -org.eclipse.jdt.core.formatter.insert_space_after_binary_operator=insert -org.eclipse.jdt.core.formatter.insert_space_after_closing_angle_bracket_in_type_arguments=insert -org.eclipse.jdt.core.formatter.insert_space_after_closing_angle_bracket_in_type_parameters=insert -org.eclipse.jdt.core.formatter.insert_space_after_closing_brace_in_block=insert -org.eclipse.jdt.core.formatter.insert_space_after_closing_paren_in_cast=insert -org.eclipse.jdt.core.formatter.insert_space_after_colon_in_assert=insert -org.eclipse.jdt.core.formatter.insert_space_after_colon_in_case=insert -org.eclipse.jdt.core.formatter.insert_space_after_colon_in_conditional=insert -org.eclipse.jdt.core.formatter.insert_space_after_colon_in_for=insert -org.eclipse.jdt.core.formatter.insert_space_after_colon_in_labeled_statement=insert -org.eclipse.jdt.core.formatter.insert_space_after_comma_in_allocation_expression=insert -org.eclipse.jdt.core.formatter.insert_space_after_comma_in_annotation=insert -org.eclipse.jdt.core.formatter.insert_space_after_comma_in_array_initializer=insert -org.eclipse.jdt.core.formatter.insert_space_after_comma_in_constructor_declaration_parameters=insert -org.eclipse.jdt.core.formatter.insert_space_after_comma_in_constructor_declaration_throws=insert -org.eclipse.jdt.core.formatter.insert_space_after_comma_in_enum_constant_arguments=insert -org.eclipse.jdt.core.formatter.insert_space_after_comma_in_enum_declarations=insert -org.eclipse.jdt.core.formatter.insert_space_after_comma_in_explicitconstructorcall_arguments=insert -org.eclipse.jdt.core.formatter.insert_space_after_comma_in_for_increments=insert -org.eclipse.jdt.core.formatter.insert_space_after_comma_in_for_inits=insert -org.eclipse.jdt.core.formatter.insert_space_after_comma_in_method_declaration_parameters=insert -org.eclipse.jdt.core.formatter.insert_space_after_comma_in_method_declaration_throws=insert -org.eclipse.jdt.core.formatter.insert_space_after_comma_in_method_invocation_arguments=insert -org.eclipse.jdt.core.formatter.insert_space_after_comma_in_multiple_field_declarations=insert -org.eclipse.jdt.core.formatter.insert_space_after_comma_in_multiple_local_declarations=insert -org.eclipse.jdt.core.formatter.insert_space_after_comma_in_parameterized_type_reference=insert -org.eclipse.jdt.core.formatter.insert_space_after_comma_in_superinterfaces=insert -org.eclipse.jdt.core.formatter.insert_space_after_comma_in_type_arguments=insert -org.eclipse.jdt.core.formatter.insert_space_after_comma_in_type_parameters=insert -org.eclipse.jdt.core.formatter.insert_space_after_ellipsis=insert -org.eclipse.jdt.core.formatter.insert_space_after_opening_angle_bracket_in_parameterized_type_reference=do not insert -org.eclipse.jdt.core.formatter.insert_space_after_opening_angle_bracket_in_type_arguments=do not insert -org.eclipse.jdt.core.formatter.insert_space_after_opening_angle_bracket_in_type_parameters=do not insert -org.eclipse.jdt.core.formatter.insert_space_after_opening_brace_in_array_initializer=insert -org.eclipse.jdt.core.formatter.insert_space_after_opening_bracket_in_array_allocation_expression=do not insert -org.eclipse.jdt.core.formatter.insert_space_after_opening_bracket_in_array_reference=do not insert -org.eclipse.jdt.core.formatter.insert_space_after_opening_paren_in_annotation=do not insert -org.eclipse.jdt.core.formatter.insert_space_after_opening_paren_in_cast=do not insert -org.eclipse.jdt.core.formatter.insert_space_after_opening_paren_in_catch=do not insert -org.eclipse.jdt.core.formatter.insert_space_after_opening_paren_in_constructor_declaration=do not insert -org.eclipse.jdt.core.formatter.insert_space_after_opening_paren_in_enum_constant=do not insert -org.eclipse.jdt.core.formatter.insert_space_after_opening_paren_in_for=do not insert -org.eclipse.jdt.core.formatter.insert_space_after_opening_paren_in_if=do not insert -org.eclipse.jdt.core.formatter.insert_space_after_opening_paren_in_method_declaration=do not insert -org.eclipse.jdt.core.formatter.insert_space_after_opening_paren_in_method_invocation=do not insert -org.eclipse.jdt.core.formatter.insert_space_after_opening_paren_in_parenthesized_expression=do not insert -org.eclipse.jdt.core.formatter.insert_space_after_opening_paren_in_switch=do not insert -org.eclipse.jdt.core.formatter.insert_space_after_opening_paren_in_synchronized=do not insert -org.eclipse.jdt.core.formatter.insert_space_after_opening_paren_in_while=do not insert -org.eclipse.jdt.core.formatter.insert_space_after_postfix_operator=do not insert -org.eclipse.jdt.core.formatter.insert_space_after_prefix_operator=do not insert -org.eclipse.jdt.core.formatter.insert_space_after_question_in_conditional=insert -org.eclipse.jdt.core.formatter.insert_space_after_question_in_wildcard=do not insert -org.eclipse.jdt.core.formatter.insert_space_after_semicolon_in_for=insert -org.eclipse.jdt.core.formatter.insert_space_after_unary_operator=do not insert -org.eclipse.jdt.core.formatter.insert_space_before_and_in_type_parameter=insert -org.eclipse.jdt.core.formatter.insert_space_before_assignment_operator=insert -org.eclipse.jdt.core.formatter.insert_space_before_at_in_annotation_type_declaration=insert -org.eclipse.jdt.core.formatter.insert_space_before_binary_operator=insert -org.eclipse.jdt.core.formatter.insert_space_before_closing_angle_bracket_in_parameterized_type_reference=do not insert -org.eclipse.jdt.core.formatter.insert_space_before_closing_angle_bracket_in_type_arguments=do not insert -org.eclipse.jdt.core.formatter.insert_space_before_closing_angle_bracket_in_type_parameters=do not insert -org.eclipse.jdt.core.formatter.insert_space_before_closing_brace_in_array_initializer=insert -org.eclipse.jdt.core.formatter.insert_space_before_closing_bracket_in_array_allocation_expression=do not insert -org.eclipse.jdt.core.formatter.insert_space_before_closing_bracket_in_array_reference=do not insert -org.eclipse.jdt.core.formatter.insert_space_before_closing_paren_in_annotation=do not insert -org.eclipse.jdt.core.formatter.insert_space_before_closing_paren_in_cast=do not insert -org.eclipse.jdt.core.formatter.insert_space_before_closing_paren_in_catch=do not insert -org.eclipse.jdt.core.formatter.insert_space_before_closing_paren_in_constructor_declaration=do not insert -org.eclipse.jdt.core.formatter.insert_space_before_closing_paren_in_enum_constant=do not insert -org.eclipse.jdt.core.formatter.insert_space_before_closing_paren_in_for=do not insert -org.eclipse.jdt.core.formatter.insert_space_before_closing_paren_in_if=do not insert -org.eclipse.jdt.core.formatter.insert_space_before_closing_paren_in_method_declaration=do not insert -org.eclipse.jdt.core.formatter.insert_space_before_closing_paren_in_method_invocation=do not insert -org.eclipse.jdt.core.formatter.insert_space_before_closing_paren_in_parenthesized_expression=do not insert -org.eclipse.jdt.core.formatter.insert_space_before_closing_paren_in_switch=do not insert -org.eclipse.jdt.core.formatter.insert_space_before_closing_paren_in_synchronized=do not insert -org.eclipse.jdt.core.formatter.insert_space_before_closing_paren_in_while=do not insert -org.eclipse.jdt.core.formatter.insert_space_before_colon_in_assert=insert -org.eclipse.jdt.core.formatter.insert_space_before_colon_in_case=do not insert -org.eclipse.jdt.core.formatter.insert_space_before_colon_in_conditional=insert -org.eclipse.jdt.core.formatter.insert_space_before_colon_in_default=do not insert -org.eclipse.jdt.core.formatter.insert_space_before_colon_in_for=insert -org.eclipse.jdt.core.formatter.insert_space_before_colon_in_labeled_statement=do not insert -org.eclipse.jdt.core.formatter.insert_space_before_comma_in_allocation_expression=do not insert -org.eclipse.jdt.core.formatter.insert_space_before_comma_in_annotation=do not insert -org.eclipse.jdt.core.formatter.insert_space_before_comma_in_array_initializer=do not insert -org.eclipse.jdt.core.formatter.insert_space_before_comma_in_constructor_declaration_parameters=do not insert -org.eclipse.jdt.core.formatter.insert_space_before_comma_in_constructor_declaration_throws=do not insert -org.eclipse.jdt.core.formatter.insert_space_before_comma_in_enum_constant_arguments=do not insert -org.eclipse.jdt.core.formatter.insert_space_before_comma_in_enum_declarations=do not insert -org.eclipse.jdt.core.formatter.insert_space_before_comma_in_explicitconstructorcall_arguments=do not insert -org.eclipse.jdt.core.formatter.insert_space_before_comma_in_for_increments=do not insert -org.eclipse.jdt.core.formatter.insert_space_before_comma_in_for_inits=do not insert -org.eclipse.jdt.core.formatter.insert_space_before_comma_in_method_declaration_parameters=do not insert -org.eclipse.jdt.core.formatter.insert_space_before_comma_in_method_declaration_throws=do not insert -org.eclipse.jdt.core.formatter.insert_space_before_comma_in_method_invocation_arguments=do not insert -org.eclipse.jdt.core.formatter.insert_space_before_comma_in_multiple_field_declarations=do not insert -org.eclipse.jdt.core.formatter.insert_space_before_comma_in_multiple_local_declarations=do not insert -org.eclipse.jdt.core.formatter.insert_space_before_comma_in_parameterized_type_reference=do not insert -org.eclipse.jdt.core.formatter.insert_space_before_comma_in_superinterfaces=do not insert -org.eclipse.jdt.core.formatter.insert_space_before_comma_in_type_arguments=do not insert -org.eclipse.jdt.core.formatter.insert_space_before_comma_in_type_parameters=do not insert -org.eclipse.jdt.core.formatter.insert_space_before_ellipsis=do not insert -org.eclipse.jdt.core.formatter.insert_space_before_opening_angle_bracket_in_parameterized_type_reference=do not insert -org.eclipse.jdt.core.formatter.insert_space_before_opening_angle_bracket_in_type_arguments=do not insert -org.eclipse.jdt.core.formatter.insert_space_before_opening_angle_bracket_in_type_parameters=do not insert -org.eclipse.jdt.core.formatter.insert_space_before_opening_brace_in_annotation_type_declaration=insert -org.eclipse.jdt.core.formatter.insert_space_before_opening_brace_in_anonymous_type_declaration=insert -org.eclipse.jdt.core.formatter.insert_space_before_opening_brace_in_array_initializer=insert -org.eclipse.jdt.core.formatter.insert_space_before_opening_brace_in_block=insert -org.eclipse.jdt.core.formatter.insert_space_before_opening_brace_in_constructor_declaration=insert -org.eclipse.jdt.core.formatter.insert_space_before_opening_brace_in_enum_constant=insert -org.eclipse.jdt.core.formatter.insert_space_before_opening_brace_in_enum_declaration=insert -org.eclipse.jdt.core.formatter.insert_space_before_opening_brace_in_method_declaration=insert -org.eclipse.jdt.core.formatter.insert_space_before_opening_brace_in_switch=insert -org.eclipse.jdt.core.formatter.insert_space_before_opening_brace_in_type_declaration=insert -org.eclipse.jdt.core.formatter.insert_space_before_opening_bracket_in_array_allocation_expression=do not insert -org.eclipse.jdt.core.formatter.insert_space_before_opening_bracket_in_array_reference=do not insert -org.eclipse.jdt.core.formatter.insert_space_before_opening_bracket_in_array_type_reference=do not insert -org.eclipse.jdt.core.formatter.insert_space_before_opening_paren_in_annotation=do not insert -org.eclipse.jdt.core.formatter.insert_space_before_opening_paren_in_annotation_type_member_declaration=do not insert -org.eclipse.jdt.core.formatter.insert_space_before_opening_paren_in_catch=insert -org.eclipse.jdt.core.formatter.insert_space_before_opening_paren_in_constructor_declaration=do not insert -org.eclipse.jdt.core.formatter.insert_space_before_opening_paren_in_enum_constant=do not insert -org.eclipse.jdt.core.formatter.insert_space_before_opening_paren_in_for=insert -org.eclipse.jdt.core.formatter.insert_space_before_opening_paren_in_if=insert -org.eclipse.jdt.core.formatter.insert_space_before_opening_paren_in_method_declaration=do not insert -org.eclipse.jdt.core.formatter.insert_space_before_opening_paren_in_method_invocation=do not insert -org.eclipse.jdt.core.formatter.insert_space_before_opening_paren_in_parenthesized_expression=do not insert -org.eclipse.jdt.core.formatter.insert_space_before_opening_paren_in_switch=insert -org.eclipse.jdt.core.formatter.insert_space_before_opening_paren_in_synchronized=insert -org.eclipse.jdt.core.formatter.insert_space_before_opening_paren_in_while=insert -org.eclipse.jdt.core.formatter.insert_space_before_parenthesized_expression_in_return=insert -org.eclipse.jdt.core.formatter.insert_space_before_parenthesized_expression_in_throw=insert -org.eclipse.jdt.core.formatter.insert_space_before_postfix_operator=do not insert -org.eclipse.jdt.core.formatter.insert_space_before_prefix_operator=do not insert -org.eclipse.jdt.core.formatter.insert_space_before_question_in_conditional=insert -org.eclipse.jdt.core.formatter.insert_space_before_question_in_wildcard=do not insert -org.eclipse.jdt.core.formatter.insert_space_before_semicolon=do not insert -org.eclipse.jdt.core.formatter.insert_space_before_semicolon_in_for=do not insert -org.eclipse.jdt.core.formatter.insert_space_before_unary_operator=do not insert -org.eclipse.jdt.core.formatter.insert_space_between_brackets_in_array_type_reference=do not insert -org.eclipse.jdt.core.formatter.insert_space_between_empty_braces_in_array_initializer=do not insert -org.eclipse.jdt.core.formatter.insert_space_between_empty_brackets_in_array_allocation_expression=do not insert -org.eclipse.jdt.core.formatter.insert_space_between_empty_parens_in_annotation_type_member_declaration=do not insert -org.eclipse.jdt.core.formatter.insert_space_between_empty_parens_in_constructor_declaration=do not insert -org.eclipse.jdt.core.formatter.insert_space_between_empty_parens_in_enum_constant=do not insert -org.eclipse.jdt.core.formatter.insert_space_between_empty_parens_in_method_declaration=do not insert -org.eclipse.jdt.core.formatter.insert_space_between_empty_parens_in_method_invocation=do not insert -org.eclipse.jdt.core.formatter.keep_else_statement_on_same_line=false -org.eclipse.jdt.core.formatter.keep_empty_array_initializer_on_one_line=false -org.eclipse.jdt.core.formatter.keep_imple_if_on_one_line=false -org.eclipse.jdt.core.formatter.keep_then_statement_on_same_line=false -org.eclipse.jdt.core.formatter.lineSplit=80 -org.eclipse.jdt.core.formatter.never_indent_block_comments_on_first_column=false -org.eclipse.jdt.core.formatter.never_indent_line_comments_on_first_column=false -org.eclipse.jdt.core.formatter.number_of_blank_lines_at_beginning_of_method_body=0 -org.eclipse.jdt.core.formatter.number_of_empty_lines_to_preserve=1 -org.eclipse.jdt.core.formatter.put_empty_statement_on_new_line=true -org.eclipse.jdt.core.formatter.tabulation.char=space -org.eclipse.jdt.core.formatter.tabulation.size=2 -org.eclipse.jdt.core.formatter.use_tabs_only_for_leading_indentations=false -org.eclipse.jdt.core.formatter.wrap_before_binary_operator=true +#Thu Mar 04 09:10:18 EST 2010 +eclipse.preferences.version=1 +org.eclipse.jdt.core.compiler.codegen.inlineJsrBytecode=enabled +org.eclipse.jdt.core.compiler.codegen.targetPlatform=1.5 +org.eclipse.jdt.core.compiler.codegen.unusedLocal=preserve +org.eclipse.jdt.core.compiler.compliance=1.5 +org.eclipse.jdt.core.compiler.debug.lineNumber=generate +org.eclipse.jdt.core.compiler.debug.localVariable=generate +org.eclipse.jdt.core.compiler.debug.sourceFile=generate +org.eclipse.jdt.core.compiler.problem.assertIdentifier=error +org.eclipse.jdt.core.compiler.problem.enumIdentifier=error +org.eclipse.jdt.core.compiler.source=1.5 +org.eclipse.jdt.core.formatter.align_type_members_on_columns=false +org.eclipse.jdt.core.formatter.alignment_for_arguments_in_allocation_expression=18 +org.eclipse.jdt.core.formatter.alignment_for_arguments_in_enum_constant=16 +org.eclipse.jdt.core.formatter.alignment_for_arguments_in_explicit_constructor_call=18 +org.eclipse.jdt.core.formatter.alignment_for_arguments_in_method_invocation=20 +org.eclipse.jdt.core.formatter.alignment_for_arguments_in_qualified_allocation_expression=16 +org.eclipse.jdt.core.formatter.alignment_for_assignment=0 +org.eclipse.jdt.core.formatter.alignment_for_binary_expression=16 +org.eclipse.jdt.core.formatter.alignment_for_compact_if=16 +org.eclipse.jdt.core.formatter.alignment_for_conditional_expression=80 +org.eclipse.jdt.core.formatter.alignment_for_enum_constants=0 +org.eclipse.jdt.core.formatter.alignment_for_expressions_in_array_initializer=36 +org.eclipse.jdt.core.formatter.alignment_for_multiple_fields=16 +org.eclipse.jdt.core.formatter.alignment_for_parameters_in_constructor_declaration=18 +org.eclipse.jdt.core.formatter.alignment_for_parameters_in_method_declaration=18 +org.eclipse.jdt.core.formatter.alignment_for_selector_in_method_invocation=16 +org.eclipse.jdt.core.formatter.alignment_for_superclass_in_type_declaration=16 +org.eclipse.jdt.core.formatter.alignment_for_superinterfaces_in_enum_declaration=16 +org.eclipse.jdt.core.formatter.alignment_for_superinterfaces_in_type_declaration=16 +org.eclipse.jdt.core.formatter.alignment_for_throws_clause_in_constructor_declaration=16 +org.eclipse.jdt.core.formatter.alignment_for_throws_clause_in_method_declaration=16 +org.eclipse.jdt.core.formatter.blank_lines_after_imports=1 +org.eclipse.jdt.core.formatter.blank_lines_after_package=1 +org.eclipse.jdt.core.formatter.blank_lines_before_field=0 +org.eclipse.jdt.core.formatter.blank_lines_before_first_class_body_declaration=0 +org.eclipse.jdt.core.formatter.blank_lines_before_imports=1 +org.eclipse.jdt.core.formatter.blank_lines_before_member_type=1 +org.eclipse.jdt.core.formatter.blank_lines_before_method=1 +org.eclipse.jdt.core.formatter.blank_lines_before_new_chunk=1 +org.eclipse.jdt.core.formatter.blank_lines_before_package=0 +org.eclipse.jdt.core.formatter.blank_lines_between_import_groups=0 +org.eclipse.jdt.core.formatter.blank_lines_between_type_declarations=1 +org.eclipse.jdt.core.formatter.brace_position_for_annotation_type_declaration=end_of_line +org.eclipse.jdt.core.formatter.brace_position_for_anonymous_type_declaration=end_of_line +org.eclipse.jdt.core.formatter.brace_position_for_array_initializer=end_of_line +org.eclipse.jdt.core.formatter.brace_position_for_block=end_of_line +org.eclipse.jdt.core.formatter.brace_position_for_block_in_case=end_of_line +org.eclipse.jdt.core.formatter.brace_position_for_constructor_declaration=end_of_line +org.eclipse.jdt.core.formatter.brace_position_for_enum_constant=end_of_line +org.eclipse.jdt.core.formatter.brace_position_for_enum_declaration=end_of_line +org.eclipse.jdt.core.formatter.brace_position_for_method_declaration=end_of_line +org.eclipse.jdt.core.formatter.brace_position_for_switch=end_of_line +org.eclipse.jdt.core.formatter.brace_position_for_type_declaration=end_of_line +org.eclipse.jdt.core.formatter.comment.clear_blank_lines_in_block_comment=false +org.eclipse.jdt.core.formatter.comment.clear_blank_lines_in_javadoc_comment=false +org.eclipse.jdt.core.formatter.comment.format_block_comments=false +org.eclipse.jdt.core.formatter.comment.format_header=false +org.eclipse.jdt.core.formatter.comment.format_html=true +org.eclipse.jdt.core.formatter.comment.format_javadoc_comments=false +org.eclipse.jdt.core.formatter.comment.format_line_comments=false +org.eclipse.jdt.core.formatter.comment.format_source_code=true +org.eclipse.jdt.core.formatter.comment.indent_parameter_description=true +org.eclipse.jdt.core.formatter.comment.indent_root_tags=true +org.eclipse.jdt.core.formatter.comment.insert_new_line_before_root_tags=insert +org.eclipse.jdt.core.formatter.comment.insert_new_line_for_parameter=insert +org.eclipse.jdt.core.formatter.comment.line_length=80 +org.eclipse.jdt.core.formatter.compact_else_if=true +org.eclipse.jdt.core.formatter.continuation_indentation=2 +org.eclipse.jdt.core.formatter.continuation_indentation_for_array_initializer=2 +org.eclipse.jdt.core.formatter.format_guardian_clause_on_one_line=false +org.eclipse.jdt.core.formatter.indent_body_declarations_compare_to_annotation_declaration_header=true +org.eclipse.jdt.core.formatter.indent_body_declarations_compare_to_enum_constant_header=true +org.eclipse.jdt.core.formatter.indent_body_declarations_compare_to_enum_declaration_header=true +org.eclipse.jdt.core.formatter.indent_body_declarations_compare_to_type_header=true +org.eclipse.jdt.core.formatter.indent_breaks_compare_to_cases=true +org.eclipse.jdt.core.formatter.indent_empty_lines=false +org.eclipse.jdt.core.formatter.indent_statements_compare_to_block=true +org.eclipse.jdt.core.formatter.indent_statements_compare_to_body=true +org.eclipse.jdt.core.formatter.indent_switchstatements_compare_to_cases=true +org.eclipse.jdt.core.formatter.indent_switchstatements_compare_to_switch=false +org.eclipse.jdt.core.formatter.indentation.size=2 +org.eclipse.jdt.core.formatter.insert_new_line_after_annotation=insert +org.eclipse.jdt.core.formatter.insert_new_line_after_annotation_on_local_variable=insert +org.eclipse.jdt.core.formatter.insert_new_line_after_annotation_on_member=insert +org.eclipse.jdt.core.formatter.insert_new_line_after_annotation_on_parameter=do not insert +org.eclipse.jdt.core.formatter.insert_new_line_after_opening_brace_in_array_initializer=do not insert +org.eclipse.jdt.core.formatter.insert_new_line_at_end_of_file_if_missing=do not insert +org.eclipse.jdt.core.formatter.insert_new_line_before_catch_in_try_statement=do not insert +org.eclipse.jdt.core.formatter.insert_new_line_before_closing_brace_in_array_initializer=do not insert +org.eclipse.jdt.core.formatter.insert_new_line_before_else_in_if_statement=do not insert +org.eclipse.jdt.core.formatter.insert_new_line_before_finally_in_try_statement=do not insert +org.eclipse.jdt.core.formatter.insert_new_line_before_while_in_do_statement=do not insert +org.eclipse.jdt.core.formatter.insert_new_line_in_empty_annotation_declaration=insert +org.eclipse.jdt.core.formatter.insert_new_line_in_empty_anonymous_type_declaration=insert +org.eclipse.jdt.core.formatter.insert_new_line_in_empty_block=insert +org.eclipse.jdt.core.formatter.insert_new_line_in_empty_enum_constant=insert +org.eclipse.jdt.core.formatter.insert_new_line_in_empty_enum_declaration=insert +org.eclipse.jdt.core.formatter.insert_new_line_in_empty_method_body=insert +org.eclipse.jdt.core.formatter.insert_new_line_in_empty_type_declaration=insert +org.eclipse.jdt.core.formatter.insert_space_after_and_in_type_parameter=insert +org.eclipse.jdt.core.formatter.insert_space_after_assignment_operator=insert +org.eclipse.jdt.core.formatter.insert_space_after_at_in_annotation=do not insert +org.eclipse.jdt.core.formatter.insert_space_after_at_in_annotation_type_declaration=do not insert +org.eclipse.jdt.core.formatter.insert_space_after_binary_operator=insert +org.eclipse.jdt.core.formatter.insert_space_after_closing_angle_bracket_in_type_arguments=insert +org.eclipse.jdt.core.formatter.insert_space_after_closing_angle_bracket_in_type_parameters=insert +org.eclipse.jdt.core.formatter.insert_space_after_closing_brace_in_block=insert +org.eclipse.jdt.core.formatter.insert_space_after_closing_paren_in_cast=insert +org.eclipse.jdt.core.formatter.insert_space_after_colon_in_assert=insert +org.eclipse.jdt.core.formatter.insert_space_after_colon_in_case=insert +org.eclipse.jdt.core.formatter.insert_space_after_colon_in_conditional=insert +org.eclipse.jdt.core.formatter.insert_space_after_colon_in_for=insert +org.eclipse.jdt.core.formatter.insert_space_after_colon_in_labeled_statement=insert +org.eclipse.jdt.core.formatter.insert_space_after_comma_in_allocation_expression=insert +org.eclipse.jdt.core.formatter.insert_space_after_comma_in_annotation=insert +org.eclipse.jdt.core.formatter.insert_space_after_comma_in_array_initializer=insert +org.eclipse.jdt.core.formatter.insert_space_after_comma_in_constructor_declaration_parameters=insert +org.eclipse.jdt.core.formatter.insert_space_after_comma_in_constructor_declaration_throws=insert +org.eclipse.jdt.core.formatter.insert_space_after_comma_in_enum_constant_arguments=insert +org.eclipse.jdt.core.formatter.insert_space_after_comma_in_enum_declarations=insert +org.eclipse.jdt.core.formatter.insert_space_after_comma_in_explicitconstructorcall_arguments=insert +org.eclipse.jdt.core.formatter.insert_space_after_comma_in_for_increments=insert +org.eclipse.jdt.core.formatter.insert_space_after_comma_in_for_inits=insert +org.eclipse.jdt.core.formatter.insert_space_after_comma_in_method_declaration_parameters=insert +org.eclipse.jdt.core.formatter.insert_space_after_comma_in_method_declaration_throws=insert +org.eclipse.jdt.core.formatter.insert_space_after_comma_in_method_invocation_arguments=insert +org.eclipse.jdt.core.formatter.insert_space_after_comma_in_multiple_field_declarations=insert +org.eclipse.jdt.core.formatter.insert_space_after_comma_in_multiple_local_declarations=insert +org.eclipse.jdt.core.formatter.insert_space_after_comma_in_parameterized_type_reference=insert +org.eclipse.jdt.core.formatter.insert_space_after_comma_in_superinterfaces=insert +org.eclipse.jdt.core.formatter.insert_space_after_comma_in_type_arguments=insert +org.eclipse.jdt.core.formatter.insert_space_after_comma_in_type_parameters=insert +org.eclipse.jdt.core.formatter.insert_space_after_ellipsis=insert +org.eclipse.jdt.core.formatter.insert_space_after_opening_angle_bracket_in_parameterized_type_reference=do not insert +org.eclipse.jdt.core.formatter.insert_space_after_opening_angle_bracket_in_type_arguments=do not insert +org.eclipse.jdt.core.formatter.insert_space_after_opening_angle_bracket_in_type_parameters=do not insert +org.eclipse.jdt.core.formatter.insert_space_after_opening_brace_in_array_initializer=insert +org.eclipse.jdt.core.formatter.insert_space_after_opening_bracket_in_array_allocation_expression=do not insert +org.eclipse.jdt.core.formatter.insert_space_after_opening_bracket_in_array_reference=do not insert +org.eclipse.jdt.core.formatter.insert_space_after_opening_paren_in_annotation=do not insert +org.eclipse.jdt.core.formatter.insert_space_after_opening_paren_in_cast=do not insert +org.eclipse.jdt.core.formatter.insert_space_after_opening_paren_in_catch=do not insert +org.eclipse.jdt.core.formatter.insert_space_after_opening_paren_in_constructor_declaration=do not insert +org.eclipse.jdt.core.formatter.insert_space_after_opening_paren_in_enum_constant=do not insert +org.eclipse.jdt.core.formatter.insert_space_after_opening_paren_in_for=do not insert +org.eclipse.jdt.core.formatter.insert_space_after_opening_paren_in_if=do not insert +org.eclipse.jdt.core.formatter.insert_space_after_opening_paren_in_method_declaration=do not insert +org.eclipse.jdt.core.formatter.insert_space_after_opening_paren_in_method_invocation=do not insert +org.eclipse.jdt.core.formatter.insert_space_after_opening_paren_in_parenthesized_expression=do not insert +org.eclipse.jdt.core.formatter.insert_space_after_opening_paren_in_switch=do not insert +org.eclipse.jdt.core.formatter.insert_space_after_opening_paren_in_synchronized=do not insert +org.eclipse.jdt.core.formatter.insert_space_after_opening_paren_in_while=do not insert +org.eclipse.jdt.core.formatter.insert_space_after_postfix_operator=do not insert +org.eclipse.jdt.core.formatter.insert_space_after_prefix_operator=do not insert +org.eclipse.jdt.core.formatter.insert_space_after_question_in_conditional=insert +org.eclipse.jdt.core.formatter.insert_space_after_question_in_wildcard=do not insert +org.eclipse.jdt.core.formatter.insert_space_after_semicolon_in_for=insert +org.eclipse.jdt.core.formatter.insert_space_after_unary_operator=do not insert +org.eclipse.jdt.core.formatter.insert_space_before_and_in_type_parameter=insert +org.eclipse.jdt.core.formatter.insert_space_before_assignment_operator=insert +org.eclipse.jdt.core.formatter.insert_space_before_at_in_annotation_type_declaration=insert +org.eclipse.jdt.core.formatter.insert_space_before_binary_operator=insert +org.eclipse.jdt.core.formatter.insert_space_before_closing_angle_bracket_in_parameterized_type_reference=do not insert +org.eclipse.jdt.core.formatter.insert_space_before_closing_angle_bracket_in_type_arguments=do not insert +org.eclipse.jdt.core.formatter.insert_space_before_closing_angle_bracket_in_type_parameters=do not insert +org.eclipse.jdt.core.formatter.insert_space_before_closing_brace_in_array_initializer=insert +org.eclipse.jdt.core.formatter.insert_space_before_closing_bracket_in_array_allocation_expression=do not insert +org.eclipse.jdt.core.formatter.insert_space_before_closing_bracket_in_array_reference=do not insert +org.eclipse.jdt.core.formatter.insert_space_before_closing_paren_in_annotation=do not insert +org.eclipse.jdt.core.formatter.insert_space_before_closing_paren_in_cast=do not insert +org.eclipse.jdt.core.formatter.insert_space_before_closing_paren_in_catch=do not insert +org.eclipse.jdt.core.formatter.insert_space_before_closing_paren_in_constructor_declaration=do not insert +org.eclipse.jdt.core.formatter.insert_space_before_closing_paren_in_enum_constant=do not insert +org.eclipse.jdt.core.formatter.insert_space_before_closing_paren_in_for=do not insert +org.eclipse.jdt.core.formatter.insert_space_before_closing_paren_in_if=do not insert +org.eclipse.jdt.core.formatter.insert_space_before_closing_paren_in_method_declaration=do not insert +org.eclipse.jdt.core.formatter.insert_space_before_closing_paren_in_method_invocation=do not insert +org.eclipse.jdt.core.formatter.insert_space_before_closing_paren_in_parenthesized_expression=do not insert +org.eclipse.jdt.core.formatter.insert_space_before_closing_paren_in_switch=do not insert +org.eclipse.jdt.core.formatter.insert_space_before_closing_paren_in_synchronized=do not insert +org.eclipse.jdt.core.formatter.insert_space_before_closing_paren_in_while=do not insert +org.eclipse.jdt.core.formatter.insert_space_before_colon_in_assert=insert +org.eclipse.jdt.core.formatter.insert_space_before_colon_in_case=do not insert +org.eclipse.jdt.core.formatter.insert_space_before_colon_in_conditional=insert +org.eclipse.jdt.core.formatter.insert_space_before_colon_in_default=do not insert +org.eclipse.jdt.core.formatter.insert_space_before_colon_in_for=insert +org.eclipse.jdt.core.formatter.insert_space_before_colon_in_labeled_statement=do not insert +org.eclipse.jdt.core.formatter.insert_space_before_comma_in_allocation_expression=do not insert +org.eclipse.jdt.core.formatter.insert_space_before_comma_in_annotation=do not insert +org.eclipse.jdt.core.formatter.insert_space_before_comma_in_array_initializer=do not insert +org.eclipse.jdt.core.formatter.insert_space_before_comma_in_constructor_declaration_parameters=do not insert +org.eclipse.jdt.core.formatter.insert_space_before_comma_in_constructor_declaration_throws=do not insert +org.eclipse.jdt.core.formatter.insert_space_before_comma_in_enum_constant_arguments=do not insert +org.eclipse.jdt.core.formatter.insert_space_before_comma_in_enum_declarations=do not insert +org.eclipse.jdt.core.formatter.insert_space_before_comma_in_explicitconstructorcall_arguments=do not insert +org.eclipse.jdt.core.formatter.insert_space_before_comma_in_for_increments=do not insert +org.eclipse.jdt.core.formatter.insert_space_before_comma_in_for_inits=do not insert +org.eclipse.jdt.core.formatter.insert_space_before_comma_in_method_declaration_parameters=do not insert +org.eclipse.jdt.core.formatter.insert_space_before_comma_in_method_declaration_throws=do not insert +org.eclipse.jdt.core.formatter.insert_space_before_comma_in_method_invocation_arguments=do not insert +org.eclipse.jdt.core.formatter.insert_space_before_comma_in_multiple_field_declarations=do not insert +org.eclipse.jdt.core.formatter.insert_space_before_comma_in_multiple_local_declarations=do not insert +org.eclipse.jdt.core.formatter.insert_space_before_comma_in_parameterized_type_reference=do not insert +org.eclipse.jdt.core.formatter.insert_space_before_comma_in_superinterfaces=do not insert +org.eclipse.jdt.core.formatter.insert_space_before_comma_in_type_arguments=do not insert +org.eclipse.jdt.core.formatter.insert_space_before_comma_in_type_parameters=do not insert +org.eclipse.jdt.core.formatter.insert_space_before_ellipsis=do not insert +org.eclipse.jdt.core.formatter.insert_space_before_opening_angle_bracket_in_parameterized_type_reference=do not insert +org.eclipse.jdt.core.formatter.insert_space_before_opening_angle_bracket_in_type_arguments=do not insert +org.eclipse.jdt.core.formatter.insert_space_before_opening_angle_bracket_in_type_parameters=do not insert +org.eclipse.jdt.core.formatter.insert_space_before_opening_brace_in_annotation_type_declaration=insert +org.eclipse.jdt.core.formatter.insert_space_before_opening_brace_in_anonymous_type_declaration=insert +org.eclipse.jdt.core.formatter.insert_space_before_opening_brace_in_array_initializer=insert +org.eclipse.jdt.core.formatter.insert_space_before_opening_brace_in_block=insert +org.eclipse.jdt.core.formatter.insert_space_before_opening_brace_in_constructor_declaration=insert +org.eclipse.jdt.core.formatter.insert_space_before_opening_brace_in_enum_constant=insert +org.eclipse.jdt.core.formatter.insert_space_before_opening_brace_in_enum_declaration=insert +org.eclipse.jdt.core.formatter.insert_space_before_opening_brace_in_method_declaration=insert +org.eclipse.jdt.core.formatter.insert_space_before_opening_brace_in_switch=insert +org.eclipse.jdt.core.formatter.insert_space_before_opening_brace_in_type_declaration=insert +org.eclipse.jdt.core.formatter.insert_space_before_opening_bracket_in_array_allocation_expression=do not insert +org.eclipse.jdt.core.formatter.insert_space_before_opening_bracket_in_array_reference=do not insert +org.eclipse.jdt.core.formatter.insert_space_before_opening_bracket_in_array_type_reference=do not insert +org.eclipse.jdt.core.formatter.insert_space_before_opening_paren_in_annotation=do not insert +org.eclipse.jdt.core.formatter.insert_space_before_opening_paren_in_annotation_type_member_declaration=do not insert +org.eclipse.jdt.core.formatter.insert_space_before_opening_paren_in_catch=insert +org.eclipse.jdt.core.formatter.insert_space_before_opening_paren_in_constructor_declaration=do not insert +org.eclipse.jdt.core.formatter.insert_space_before_opening_paren_in_enum_constant=do not insert +org.eclipse.jdt.core.formatter.insert_space_before_opening_paren_in_for=insert +org.eclipse.jdt.core.formatter.insert_space_before_opening_paren_in_if=insert +org.eclipse.jdt.core.formatter.insert_space_before_opening_paren_in_method_declaration=do not insert +org.eclipse.jdt.core.formatter.insert_space_before_opening_paren_in_method_invocation=do not insert +org.eclipse.jdt.core.formatter.insert_space_before_opening_paren_in_parenthesized_expression=do not insert +org.eclipse.jdt.core.formatter.insert_space_before_opening_paren_in_switch=insert +org.eclipse.jdt.core.formatter.insert_space_before_opening_paren_in_synchronized=insert +org.eclipse.jdt.core.formatter.insert_space_before_opening_paren_in_while=insert +org.eclipse.jdt.core.formatter.insert_space_before_parenthesized_expression_in_return=insert +org.eclipse.jdt.core.formatter.insert_space_before_parenthesized_expression_in_throw=insert +org.eclipse.jdt.core.formatter.insert_space_before_postfix_operator=do not insert +org.eclipse.jdt.core.formatter.insert_space_before_prefix_operator=do not insert +org.eclipse.jdt.core.formatter.insert_space_before_question_in_conditional=insert +org.eclipse.jdt.core.formatter.insert_space_before_question_in_wildcard=do not insert +org.eclipse.jdt.core.formatter.insert_space_before_semicolon=do not insert +org.eclipse.jdt.core.formatter.insert_space_before_semicolon_in_for=do not insert +org.eclipse.jdt.core.formatter.insert_space_before_unary_operator=do not insert +org.eclipse.jdt.core.formatter.insert_space_between_brackets_in_array_type_reference=do not insert +org.eclipse.jdt.core.formatter.insert_space_between_empty_braces_in_array_initializer=do not insert +org.eclipse.jdt.core.formatter.insert_space_between_empty_brackets_in_array_allocation_expression=do not insert +org.eclipse.jdt.core.formatter.insert_space_between_empty_parens_in_annotation_type_member_declaration=do not insert +org.eclipse.jdt.core.formatter.insert_space_between_empty_parens_in_constructor_declaration=do not insert +org.eclipse.jdt.core.formatter.insert_space_between_empty_parens_in_enum_constant=do not insert +org.eclipse.jdt.core.formatter.insert_space_between_empty_parens_in_method_declaration=do not insert +org.eclipse.jdt.core.formatter.insert_space_between_empty_parens_in_method_invocation=do not insert +org.eclipse.jdt.core.formatter.join_lines_in_comments=true +org.eclipse.jdt.core.formatter.join_wrapped_lines=true +org.eclipse.jdt.core.formatter.keep_else_statement_on_same_line=false +org.eclipse.jdt.core.formatter.keep_empty_array_initializer_on_one_line=false +org.eclipse.jdt.core.formatter.keep_imple_if_on_one_line=false +org.eclipse.jdt.core.formatter.keep_then_statement_on_same_line=false +org.eclipse.jdt.core.formatter.lineSplit=80 +org.eclipse.jdt.core.formatter.never_indent_block_comments_on_first_column=false +org.eclipse.jdt.core.formatter.never_indent_line_comments_on_first_column=false +org.eclipse.jdt.core.formatter.number_of_blank_lines_at_beginning_of_method_body=0 +org.eclipse.jdt.core.formatter.number_of_empty_lines_to_preserve=1 +org.eclipse.jdt.core.formatter.put_empty_statement_on_new_line=true +org.eclipse.jdt.core.formatter.tabulation.char=space +org.eclipse.jdt.core.formatter.tabulation.size=2 +org.eclipse.jdt.core.formatter.use_tabs_only_for_leading_indentations=false +org.eclipse.jdt.core.formatter.wrap_before_binary_operator=true diff --git a/core/.settings/org.eclipse.jdt.ui.prefs b/core/.settings/org.eclipse.jdt.ui.prefs index cfbda4c3e..f0ea5a6a6 100644 --- a/core/.settings/org.eclipse.jdt.ui.prefs +++ b/core/.settings/org.eclipse.jdt.ui.prefs @@ -1,5 +1,5 @@ -#Thu Jan 10 10:50:38 PST 2008 +#Fri Feb 19 16:20:47 EST 2010 eclipse.preferences.version=1 -formatter_profile=_two spaces no tabs +formatter_profile=_processing formatter_settings_version=11 org.eclipse.jdt.ui.text.custom_code_templates= diff --git a/core/build.xml b/core/build.xml new file mode 100644 index 000000000..5a8836abe --- /dev/null +++ b/core/build.xml @@ -0,0 +1,26 @@ + + + + + + + + + + + + + + + + + + + + + diff --git a/core/done.txt b/core/done.txt index 6147f40ca..e09233a15 100644 --- a/core/done.txt +++ b/core/done.txt @@ -1,3 +1,58 @@ +0178 core (private) +X filter(DILATE/ERODE) +X dilate(boolean) has bug in clamping of top kernel coordinate +X http://dev.processing.org/bugs/show_bug.cgi?id=1477 +X deprecated 'screen', adding screenW and screenH +X write implementation for get/set methods inside PImage (w/o pixels[]) + + +0177 core (private) +X no changes + + +0176 core (private) +X opengl sketches run at 30fps in present mode on OS X +o still having problems w/ full screen non-FSEM +X http://dev.processing.org/bugs/show_bug.cgi?id=1425 +X PFont not working well with lots of characters +X only create bitmap chars on the fly when needed (in createFont) +X Implement better caching mechanism when creating large fonts +X http://dev.processing.org/bugs/show_bug.cgi?id=1111 +X fix problem with "create font" still showing anti-aliased text +X don't make fonts power of 2 +X PGraphics3D: beginDraw does not release old textures +X http://dev.processing.org/bugs/show_bug.cgi?id=1423 +X fix from taifun_browser +X removing camera() and perspective() from setSize() trashes resize +X probably regression b/c camera/perspective can't be called then +X http://dev.processing.org/bugs/show_bug.cgi?id=1391 + + +0175 core (private) +X changed createInputRaw() to only bother checking URLs if : present + + +0174 core (private) +X svg paths that use 'e' (exponent) not handled properly +X http://dev.processing.org/bugs/show_bug.cgi?id=1408 + + +0173 core (private) +X Re-enabled hack for temporary clipping. +X Clipping still needs to be implemented properly, however. Please help! +X http://dev.processing.org/bugs/show_bug.cgi?id=1393 + + +0172 core (private) +X no changes to the core (or were there?) + + +0171 core (1.0.9) +X Blurred PImages in OPENGL sketches +X removed NPOT texture support (for further testing) +X http://dev.processing.org/bugs/show_bug.cgi?id=1352 + + 0170 core (1.0.8) X added some min/max functions that work with doubles X not sure if those are staying in or not diff --git a/core/methods/.classpath b/core/methods/.classpath new file mode 100644 index 000000000..d9132e9f4 --- /dev/null +++ b/core/methods/.classpath @@ -0,0 +1,7 @@ + + + + + + + diff --git a/core/methods/.project b/core/methods/.project new file mode 100644 index 000000000..629f1c16a --- /dev/null +++ b/core/methods/.project @@ -0,0 +1,17 @@ + + + preproc + + + + + + org.eclipse.jdt.core.javabuilder + + + + + + org.eclipse.jdt.core.javanature + + diff --git a/core/methods/build.xml b/core/methods/build.xml new file mode 100644 index 000000000..c37b243eb --- /dev/null +++ b/core/methods/build.xml @@ -0,0 +1,28 @@ + + + + + + + + + + + + + + + + + + + + + + + diff --git a/core/methods/demo/PApplet.java b/core/methods/demo/PApplet.java new file mode 100644 index 000000000..b2a09c1bb --- /dev/null +++ b/core/methods/demo/PApplet.java @@ -0,0 +1,9483 @@ +/* -*- mode: java; c-basic-offset: 2; indent-tabs-mode: nil -*- */ + +/* + Part of the Processing project - http://processing.org + + Copyright (c) 2004-10 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, version 2.1. + + 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.applet.*; +import java.awt.*; +import java.awt.event.*; +import java.awt.image.*; +import java.io.*; +import java.lang.reflect.*; +import java.net.*; +import java.text.*; +import java.util.*; +import java.util.regex.*; +import java.util.zip.*; + +import javax.imageio.ImageIO; +import javax.swing.JFileChooser; +import javax.swing.SwingUtilities; + +import processing.core.PShape; + + +/** + * Base class for all sketches that use processing.core. + *

+ * Note that you should not use AWT or Swing components inside a Processing + * applet. The surface is made to automatically update itself, and will cause + * problems with redraw of components drawn above it. If you'd like to + * integrate other Java components, see below. + *

+ * As of release 0145, Processing uses active mode rendering in all cases. + * 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(). + * For code that needs to run on the EDT, use SwingUtilities.invokeLater(). + * When doing so, be careful to synchronize between that code (since + * invokeLater() will make your code run from the EDT) and the Processing + * animation 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 release 0136 of Processing, we have discontinued support for versions + * of Java prior to 1.5. We don't have enough people to support it, and for a + * project of our size, we should be focusing on the future, rather than + * working around legacy Java code. In addition, Java 1.5 gives us access to + * better timing facilities which will improve the steadiness of animation. + *

+ * This class extends Applet instead of JApplet because 1) historically, + * we supported Java 1.1, which does not include Swing (without an + * additional, sizable, download), and 2) Swing is a bloated piece of crap. + * A Processing applet is a heavyweight AWT component, and can be used the + * same as any other AWT component, with or without Swing. + *

+ * Similarly, Processing runs in a Frame and not a JFrame. However, there's + * nothing to prevent you from embedding a PApplet into a JFrame, it's just + * that the base version uses a regular AWT frame because there's simply + * no need for swing in that context. If people want to use Swing, they can + * embed themselves as they wish. + *

+ * It is possible to use PApplet, along with core.jar in other projects. + * In addition to enabling you to use Java 1.5+ features with your sketch, + * this also allows you to embed a Processing drawing area into another Java + * application. This means you can use standard GUI controls with a Processing + * sketch. Because AWT and Swing GUI components cannot be used on top of a + * PApplet, you can instead embed the PApplet inside another GUI the way you + * would any other Component. + *

+ * It is also possible to resize the Processing window by including + * frame.setResizable(true) inside your setup() method. + * Note that the Java method frame.setSize() will not work unless + * you first set the frame to be resizable. + *

+ * Because the default animation thread will run at 60 frames per second, + * an embedded PApplet can make the parent sluggish. You can use frameRate() + * to make it update less often, or you can use noLoop() and loop() to disable + * and then re-enable looping. If you want to only update the sketch + * intermittently, use noLoop() inside setup(), and redraw() whenever + * the screen needs to be updated once (or loop() to re-enable the animation + * thread). The following example embeds a sketch and also uses the noLoop() + * and redraw() methods. You need not use noLoop() and redraw() when embedding + * if you want your application to animate continuously. + * 

+ * public class ExampleFrame extends Frame {
+ *
+ *     public ExampleFrame() {
+ *         super("Embedded PApplet");
+ *
+ *         setLayout(new BorderLayout());
+ *         PApplet embed = new Embedded();
+ *         add(embed, BorderLayout.CENTER);
+ *
+ *         // important to call this whenever embedding a PApplet.
+ *         // It ensures that the animation thread is started and
+ *         // that other internal variables are properly set.
+ *         embed.init();
+ *     }
+ * }
+ *
+ * public class Embedded extends PApplet {
+ *
+ *     public void setup() {
+ *         // original setup code here ...
+ *         size(400, 400);
+ *
+ *         // prevent thread from starving everything else
+ *         noLoop();
+ *     }
+ *
+ *     public void draw() {
+ *         // drawing code goes here
+ *     }
+ *
+ *     public void mousePressed() {
+ *         // do something based on mouse movement
+ *
+ *         // update the screen (run draw once)
+ *         redraw();
+ *     }
+ * }
+ *
+ * + *

Processing on multiple displays

+ *

I was asked about Processing with multiple displays, and for lack of a + * better place to document it, things will go here.

+ *

You can address both screens by making a window the width of both, + * and the height of the maximum of both screens. In this case, do not use + * present mode, because that's exclusive to one screen. Basically it'll + * give you a PApplet that spans both screens. If using one half to control + * and the other half for graphics, you'd just have to put the 'live' stuff + * on one half of the canvas, the control stuff on the other. This works + * better in windows because on the mac we can't get rid of the menu bar + * unless it's running in present mode.

+ *

For more control, you need to write straight java code that uses p5. + * You can create two windows, that are shown on two separate screens, + * that have their own PApplet. this is just one of the tradeoffs of one of + * the things that we don't support in p5 from within the environment + * itself (we must draw the line somewhere), because of how messy it would + * get to start talking about multiple screens. It's also not that tough to + * do by hand w/ some Java code.

+ * @usage Web & Application + */ +public class PApplet extends Applet + implements PConstants, Runnable, + MouseListener, MouseMotionListener, KeyListener, FocusListener +{ + /** + * Full name of the Java version (i.e. 1.5.0_11). + * Prior to 0125, this was only the first three digits. + */ + public static final String javaVersionName = + System.getProperty("java.version"); + + /** + * Version of Java that's in use, whether 1.1 or 1.3 or whatever, + * stored as a float. + *

+ * Note that because this is stored as a float, the values may + * not be exactly 1.3 or 1.4. Instead, make sure you're + * comparing against 1.3f or 1.4f, which will have the same amount + * of error (i.e. 1.40000001). This could just be a double, but + * since Processing only uses floats, it's safer for this to be a float + * because there's no good way to specify a double with the preproc. + */ + public static final float javaVersion = + new Float(javaVersionName.substring(0, 3)).floatValue(); + + /** + * Current platform in use. + *

+ * Equivalent to System.getProperty("os.name"), just used internally. + */ + + /** + * Current platform in use, one of the + * PConstants WINDOWS, MACOSX, MACOS9, LINUX or OTHER. + */ + static public int platform; + + /** + * Name associated with the current 'platform' (see PConstants.platformNames) + */ + //static public String platformName; + + static { + String osname = System.getProperty("os.name"); + + if (osname.indexOf("Mac") != -1) { + platform = MACOSX; + + } else if (osname.indexOf("Windows") != -1) { + platform = WINDOWS; + + } else if (osname.equals("Linux")) { // true for the ibm vm + platform = LINUX; + + } else { + platform = OTHER; + } + } + + /** + * Modifier flags for the shortcut key used to trigger menus. + * (Cmd on Mac OS X, Ctrl on Linux and Windows) + */ + static public final int MENU_SHORTCUT = + Toolkit.getDefaultToolkit().getMenuShortcutKeyMask(); + + /** The PGraphics renderer associated with this PApplet */ + public PGraphics g; + + //protected Object glock = new Object(); // for sync + + /** The frame containing this applet (if any) */ + public Frame frame; + + /** + * The screen size when the applet was started. + *

+ * Access this via screen.width and screen.height. To make an applet + * run at full screen, use size(screen.width, screen.height). + *

+ * If you have multiple displays, this will be the size of the main + * display. Running full screen across multiple displays isn't + * particularly supported, and requires more monkeying with the values. + * This probably can't/won't be fixed until/unless I get a dual head + * system. + *

+ * Note that this won't update if you change the resolution + * of your screen once the the applet is running. + *

+ * This variable is not static, because future releases need to be better + * at handling multiple displays. + */ + public Dimension screen = + Toolkit.getDefaultToolkit().getScreenSize(); + + /** + * A leech graphics object that is echoing all events. + */ + public PGraphics recorder; + + /** + * Command line options passed in from main(). + *

+ * This does not include the arguments passed in to PApplet itself. + */ + public String args[]; + + /** Path to sketch folder */ + public String sketchPath; //folder; + + /** When debugging headaches */ + static final boolean THREAD_DEBUG = false; + + /** Default width and height for applet when not specified */ + static public final int DEFAULT_WIDTH = 100; + static public final int DEFAULT_HEIGHT = 100; + + /** + * Minimum dimensions for the window holding an applet. + * This varies between platforms, Mac OS X 10.3 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 lets you + * make windows with negative sizes. + */ + static public final int MIN_WINDOW_WIDTH = 128; + static public final int MIN_WINDOW_HEIGHT = 128; + + /** + * Exception thrown when size() is called the first time. + *

+ * This is used internally so that setup() is forced to run twice + * when the renderer is changed. This is the only way for us to handle + * invoking the new renderer while also in the midst of rendering. + */ + static public class RendererChangeException extends RuntimeException { } + + /** + * true if no size() command has been executed. This is used to wait until + * a size has been set before placing in the window and showing it. + */ + public boolean defaultSize; + + volatile boolean resizeRequest; + volatile int resizeWidth; + volatile int resizeHeight; + + /** + * Array containing the values for all the pixels in the display window. These values are of the color datatype. This array is the size of the display window. For example, if the image is 100x100 pixels, there will be 10000 values and if the window is 200x300 pixels, there will be 60000 values. The index value defines the position of a value within the array. For example, the statment color b = pixels[230] will set the variable b to be equal to the value at that location in the array.

Before accessing this array, the data must loaded with the loadPixels() function. After the array data has been modified, the updatePixels() function must be run to update the changes. Without loadPixels(), running the code may (or will in future releases) result in a NullPointerException. + * Pixel buffer from this applet's PGraphics. + *

+ * When used with OpenGL or Java2D, this value will + * be null until loadPixels() has been called. + * + * @webref image:pixels + * @see processing.core.PApplet#loadPixels() + * @see processing.core.PApplet#updatePixels() + * @see processing.core.PApplet#get(int, int, int, int) + * @see processing.core.PApplet#set(int, int, int) + * @see processing.core.PImage + */ + public int pixels[]; + + /** width of this applet's associated PGraphics + * @webref environment + */ + public int width; + + /** height of this applet's associated PGraphics + * @webref environment + * */ + public int height; + + /** + * The system variable mouseX always contains the current horizontal coordinate of the mouse. + * @webref input:mouse + * @see PApplet#mouseY + * @see PApplet#mousePressed + * @see PApplet#mousePressed() + * @see PApplet#mouseReleased() + * @see PApplet#mouseMoved() + * @see PApplet#mouseDragged() + * + * */ + public int mouseX; + + /** + * The system variable mouseY always contains the current vertical coordinate of the mouse. + * @webref input:mouse + * @see PApplet#mouseX + * @see PApplet#mousePressed + * @see PApplet#mousePressed() + * @see PApplet#mouseReleased() + * @see PApplet#mouseMoved() + * @see PApplet#mouseDragged() + * */ + public int mouseY; + + /** + * Previous x/y position of the mouse. This will be a different value + * when inside a mouse handler (like the mouseMoved() method) versus + * when inside draw(). Inside draw(), pmouseX is updated once each + * frame, but inside mousePressed() and friends, it's updated each time + * an event comes through. Be sure to use only one or the other type of + * means for tracking pmouseX and pmouseY within your sketch, otherwise + * you're gonna run into trouble. + * @webref input:mouse + * @see PApplet#pmouseY + * @see PApplet#mouseX + * @see PApplet#mouseY + */ + public int pmouseX; + + /** + * @webref input:mouse + * @see PApplet#pmouseX + * @see PApplet#mouseX + * @see PApplet#mouseY + */ + public int pmouseY; + + /** + * previous mouseX/Y for the draw loop, separated out because this is + * separate from the pmouseX/Y when inside the mouse event handlers. + */ + protected int dmouseX, dmouseY; + + /** + * pmouseX/Y for the event handlers (mousePressed(), mouseDragged() etc) + * these are different because mouse events are queued to the end of + * draw, so the previous position has to be updated on each event, + * as opposed to the pmouseX/Y that's used inside draw, which is expected + * to be updated once per trip through draw(). + */ + protected int emouseX, emouseY; + + /** + * Used to set pmouseX/Y to mouseX/Y the first time mouseX/Y are used, + * otherwise pmouseX/Y are always zero, causing a nasty jump. + *

+ * Just using (frameCount == 0) won't work since mouseXxxxx() + * may not be called until a couple frames into things. + */ + public boolean firstMouse; + + /** + * Processing automatically tracks if the mouse button is pressed and which button is pressed. + * The value of the system variable mouseButton is either LEFT, RIGHT, or CENTER depending on which button is pressed. + *

Advanced:

+ * If running on Mac OS, a ctrl-click will be interpreted as + * the righthand mouse button (unlike Java, which reports it as + * the left mouse). + * @webref input:mouse + * @see PApplet#mouseX + * @see PApplet#mouseY + * @see PApplet#mousePressed() + * @see PApplet#mouseReleased() + * @see PApplet#mouseMoved() + * @see PApplet#mouseDragged() + */ + public int mouseButton; + + /** + * Variable storing if a mouse button is pressed. The value of the system variable mousePressed is true if a mouse button is pressed and false if a button is not pressed. + * @webref input:mouse + * @see PApplet#mouseX + * @see PApplet#mouseY + * @see PApplet#mouseReleased() + * @see PApplet#mouseMoved() + * @see PApplet#mouseDragged() + */ + public boolean mousePressed; + public MouseEvent mouseEvent; + + /** + * The system variable key 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 keyCode 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 the key variable instead of keyCode + * If you're making 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. + * =advanced + * + * Last key pressed. + *

+ * If it's a coded key, i.e. UP/DOWN/CTRL/SHIFT/ALT, + * this will be set to CODED (0xffff or 65535). + * @webref input:keyboard + * @see PApplet#keyCode + * @see PApplet#keyPressed + * @see PApplet#keyPressed() + * @see PApplet#keyReleased() + */ + public char key; + + /** + * The variable keyCode is used to detect special keys such as the UP, 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 key variable instead of keyCode + * If you're making 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. + *

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 KeyEvent reference. + * + * =advanced + * When "key" is set to CODED, this will contain a Java key code. + *

+ * For the arrow keys, keyCode will be one of UP, DOWN, LEFT and RIGHT. + * Also available are ALT, CONTROL and SHIFT. A full set of constants + * can be obtained from java.awt.event.KeyEvent, from the VK_XXXX variables. + * @webref input:keyboard + * @see PApplet#key + * @see PApplet#keyPressed + * @see PApplet#keyPressed() + * @see PApplet#keyReleased() + */ + public int keyCode; + + /** + * The boolean system variable keyPressed is true if any key is pressed and false if no keys are pressed. + * @webref input:keyboard + * @see PApplet#key + * @see PApplet#keyCode + * @see PApplet#keyPressed() + * @see PApplet#keyReleased() + */ + public boolean keyPressed; + + /** + * the last KeyEvent object passed into a mouse function. + */ + public KeyEvent keyEvent; + + /** + * Gets set to true/false as the applet gains/loses focus. + * @webref environment + */ + public boolean focused = false; + + /** + * true if the applet is online. + *

+ * This can be used to test how the applet should behave + * since online situations are different (no file writing, etc). + * @webref environment + */ + public boolean online = false; + + /** + * Time in milliseconds when the applet was started. + *

+ * Used by the millis() function. + */ + long millisOffset; + + /** + * The current value of frames per second. + *

+ * The initial value will be 10 fps, and will be updated with each + * frame thereafter. The value is not instantaneous (since that + * wouldn't be very useful since it would jump around so much), + * but is instead averaged (integrated) over several frames. + * As such, this value won't be valid until after 5-10 frames. + */ + public float frameRate = 10; + /** Last time in nanoseconds that frameRate was checked */ + protected long frameRateLastNanos = 0; + + /** As of release 0116, frameRate(60) is called as a default */ + protected float frameRateTarget = 60; + protected long frameRatePeriod = 1000000000L / 60L; + + protected boolean looping; + + /** flag set to true when a redraw is asked for by the user */ + protected boolean redraw; + + /** + * How many frames have been displayed since the applet started. + *

+ * This value is read-only do not attempt to set it, + * otherwise bad things will happen. + *

+ * Inside setup(), frameCount is 0. + * For the first iteration of draw(), frameCount will equal 1. + */ + public int frameCount; + + /** + * true if this applet has had it. + */ + public boolean finished; + + /** + * true if exit() has been called so that things shut down + * once the main thread kicks off. + */ + protected boolean exitCalled; + + Thread thread; + + protected RegisteredMethods sizeMethods; + protected RegisteredMethods preMethods, drawMethods, postMethods; + protected RegisteredMethods mouseEventMethods, keyEventMethods; + protected RegisteredMethods disposeMethods; + + // messages to send if attached as an external vm + + /** + * Position of the upper-lefthand corner of the editor window + * that launched this applet. + */ + static public final String ARGS_EDITOR_LOCATION = "--editor-location"; + + /** + * Location for where to position the applet window on screen. + *

+ * This is used by the editor to when saving the previous applet + * location, or could be used by other classes to launch at a + * specific position on-screen. + */ + static public final String ARGS_EXTERNAL = "--external"; + + static public final String ARGS_LOCATION = "--location"; + + static public final String ARGS_DISPLAY = "--display"; + + static public final String ARGS_BGCOLOR = "--bgcolor"; + + static public final String ARGS_PRESENT = "--present"; + + static public final String ARGS_EXCLUSIVE = "--exclusive"; + + static public final String ARGS_STOP_COLOR = "--stop-color"; + + static public final String ARGS_HIDE_STOP = "--hide-stop"; + + /** + * Allows the user or PdeEditor to set a specific sketch folder path. + *

+ * Used by PdeEditor to pass in the location where saveFrame() + * and all that stuff should write things. + */ + static public final String ARGS_SKETCH_FOLDER = "--sketch-path"; + + /** + * When run externally to a PdeEditor, + * this is sent by the applet when it quits. + */ + //static public final String EXTERNAL_QUIT = "__QUIT__"; + static public final String EXTERNAL_STOP = "__STOP__"; + + /** + * When run externally to a PDE Editor, this is sent by the applet + * whenever the window is moved. + *

+ * This is used so that the editor can re-open the sketch window + * in the same position as the user last left it. + */ + static public final String EXTERNAL_MOVE = "__MOVE__"; + + /** true if this sketch is being run by the PDE */ + boolean external = false; + + + static final String ERROR_MIN_MAX = + "Cannot use min() or max() on an empty array."; + + + // during rev 0100 dev cycle, working on new threading model, + // but need to disable and go conservative with changes in order + // to get pdf and audio working properly first. + // for 0116, the CRUSTY_THREADS are being disabled to fix lots of bugs. + //static final boolean CRUSTY_THREADS = false; //true; + + + public void init() { +// println("Calling init()"); + + // send tab keys through to the PApplet + setFocusTraversalKeysEnabled(false); + + millisOffset = System.currentTimeMillis(); + + finished = false; // just for clarity + + // this will be cleared by draw() if it is not overridden + looping = true; + redraw = true; // draw this guy once + firstMouse = true; + + // these need to be inited before setup + sizeMethods = new RegisteredMethods(); + preMethods = new RegisteredMethods(); + drawMethods = new RegisteredMethods(); + postMethods = new RegisteredMethods(); + mouseEventMethods = new RegisteredMethods(); + keyEventMethods = new RegisteredMethods(); + disposeMethods = new RegisteredMethods(); + + try { + getAppletContext(); + online = true; + } catch (NullPointerException e) { + online = false; + } + + try { + if (sketchPath == null) { + sketchPath = System.getProperty("user.dir"); + } + } catch (Exception e) { } // may be a security problem + + Dimension size = getSize(); + if ((size.width != 0) && (size.height != 0)) { + // When this PApplet is embedded inside a Java application with other + // Component objects, its size() may already be set externally (perhaps + // by a LayoutManager). In this case, honor that size as the default. + // Size of the component is set, just create a renderer. + g = makeGraphics(size.width, size.height, getSketchRenderer(), null, true); + // This doesn't call setSize() or setPreferredSize() because the fact + // that a size was already set means that someone is already doing it. + + } else { + // Set the default size, until the user specifies otherwise + this.defaultSize = true; + int w = getSketchWidth(); + int h = getSketchHeight(); + g = makeGraphics(w, h, getSketchRenderer(), null, true); + // Fire component resize event + setSize(w, h); + setPreferredSize(new Dimension(w, h)); + } + width = g.width; + height = g.height; + + addListeners(); + + // this is automatically called in applets + // though it's here for applications anyway + start(); + } + + + public int getSketchWidth() { + return DEFAULT_WIDTH; + } + + + public int getSketchHeight() { + return DEFAULT_HEIGHT; + } + + + public String getSketchRenderer() { + return JAVA2D; + } + + + /** + * 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. + */ + public void start() { + // When running inside a browser, start() will be called when someone + // returns to a page containing this applet. + // http://dev.processing.org/bugs/show_bug.cgi?id=581 + finished = false; + + if (thread != null) return; + thread = new Thread(this, "Animation Thread"); + thread.start(); + } + + + /** + * 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. + */ + public void stop() { + // bringing this back for 0111, hoping it'll help opengl shutdown + finished = true; // why did i comment this out? + + // don't run stop and disposers twice + if (thread == null) return; + thread = null; + + // call to shut down renderer, in case it needs it (pdf does) + if (g != null) g.dispose(); + + // maybe this should be done earlier? might help ensure it gets called + // before the vm just craps out since 1.5 craps out so aggressively. + disposeMethods.handle(); + } + + + /** + * 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. + *

+ * This also attempts to call PApplet.stop(), in case there + * was an inadvertent override of the stop() function by a user. + *

+ * 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. + * no guarantees on when they're run (on browser quit, or + * when moving between pages), though. + */ + public void destroy() { + ((PApplet)this).stop(); + } + + + /** + * This returns the last width and height specified by the user + * via the size() command. + */ +// public Dimension getPreferredSize() { +// return new Dimension(width, height); +// } + + +// public void addNotify() { +// super.addNotify(); +// println("addNotify()"); +// } + + + + ////////////////////////////////////////////////////////////// + + + public class RegisteredMethods { + int count; + Object objects[]; + Method methods[]; + + + // convenience version for no args + public void handle() { + handle(new Object[] { }); + } + + public void handle(Object oargs[]) { + for (int i = 0; i < count; i++) { + try { + //System.out.println(objects[i] + " " + args); + methods[i].invoke(objects[i], oargs); + } catch (Exception e) { + e.printStackTrace(); + } + } + } + + public void add(Object object, Method method) { + if (objects == null) { + objects = new Object[5]; + methods = new Method[5]; + } + if (count == objects.length) { + objects = (Object[]) PApplet.expand(objects); + methods = (Method[]) PApplet.expand(methods); +// Object otemp[] = new Object[count << 1]; +// System.arraycopy(objects, 0, otemp, 0, count); +// objects = otemp; +// Method mtemp[] = new Method[count << 1]; +// System.arraycopy(methods, 0, mtemp, 0, count); +// methods = mtemp; + } + objects[count] = object; + methods[count] = method; + count++; + } + + + /** + * Removes first object/method pair matched (and only the first, + * must be called multiple times if object is registered multiple times). + * Does not shrink array afterwards, silently returns if method not found. + */ + public void remove(Object object, Method method) { + int index = findIndex(object, method); + if (index != -1) { + // shift remaining methods by one to preserve ordering + count--; + for (int i = index; i < count; i++) { + objects[i] = objects[i+1]; + methods[i] = methods[i+1]; + } + // clean things out for the gc's sake + objects[count] = null; + methods[count] = null; + } + } + + protected int findIndex(Object object, Method method) { + for (int i = 0; i < count; i++) { + if (objects[i] == object && methods[i].equals(method)) { + //objects[i].equals() might be overridden, so use == for safety + // since here we do care about actual object identity + //methods[i]==method is never true even for same method, so must use + // equals(), this should be safe because of object identity + return i; + } + } + return -1; + } + } + + + public void registerSize(Object o) { + Class methodArgs[] = new Class[] { Integer.TYPE, Integer.TYPE }; + registerWithArgs(sizeMethods, "size", o, methodArgs); + } + + public void registerPre(Object o) { + registerNoArgs(preMethods, "pre", o); + } + + public void registerDraw(Object o) { + registerNoArgs(drawMethods, "draw", o); + } + + public void registerPost(Object o) { + registerNoArgs(postMethods, "post", o); + } + + public void registerMouseEvent(Object o) { + Class methodArgs[] = new Class[] { MouseEvent.class }; + registerWithArgs(mouseEventMethods, "mouseEvent", o, methodArgs); + } + + + public void registerKeyEvent(Object o) { + Class methodArgs[] = new Class[] { KeyEvent.class }; + registerWithArgs(keyEventMethods, "keyEvent", o, methodArgs); + } + + public void registerDispose(Object o) { + registerNoArgs(disposeMethods, "dispose", o); + } + + + protected void registerNoArgs(RegisteredMethods meth, + String name, Object o) { + Class c = o.getClass(); + try { + Method method = c.getMethod(name, new Class[] {}); + meth.add(o, method); + + } catch (NoSuchMethodException nsme) { + die("There is no public " + name + "() method in the class " + + o.getClass().getName()); + + } catch (Exception e) { + die("Could not register " + name + " + () for " + o, e); + } + } + + + protected void registerWithArgs(RegisteredMethods meth, + String name, Object o, Class cargs[]) { + Class c = o.getClass(); + try { + Method method = c.getMethod(name, cargs); + meth.add(o, method); + + } catch (NoSuchMethodException nsme) { + die("There is no public " + name + "() method in the class " + + o.getClass().getName()); + + } catch (Exception e) { + die("Could not register " + name + " + () for " + o, e); + } + } + + + public void unregisterSize(Object o) { + Class methodArgs[] = new Class[] { Integer.TYPE, Integer.TYPE }; + unregisterWithArgs(sizeMethods, "size", o, methodArgs); + } + + public void unregisterPre(Object o) { + unregisterNoArgs(preMethods, "pre", o); + } + + public void unregisterDraw(Object o) { + unregisterNoArgs(drawMethods, "draw", o); + } + + public void unregisterPost(Object o) { + unregisterNoArgs(postMethods, "post", o); + } + + public void unregisterMouseEvent(Object o) { + Class methodArgs[] = new Class[] { MouseEvent.class }; + unregisterWithArgs(mouseEventMethods, "mouseEvent", o, methodArgs); + } + + public void unregisterKeyEvent(Object o) { + Class methodArgs[] = new Class[] { KeyEvent.class }; + unregisterWithArgs(keyEventMethods, "keyEvent", o, methodArgs); + } + + public void unregisterDispose(Object o) { + unregisterNoArgs(disposeMethods, "dispose", o); + } + + + protected void unregisterNoArgs(RegisteredMethods meth, + String name, Object o) { + Class c = o.getClass(); + try { + Method method = c.getMethod(name, new Class[] {}); + meth.remove(o, method); + } catch (Exception e) { + die("Could not unregister " + name + "() for " + o, e); + } + } + + + protected void unregisterWithArgs(RegisteredMethods meth, + String name, Object o, Class cargs[]) { + Class c = o.getClass(); + try { + Method method = c.getMethod(name, cargs); + meth.remove(o, method); + } catch (Exception e) { + die("Could not unregister " + name + "() for " + o, e); + } + } + + + ////////////////////////////////////////////////////////////// + + + public void setup() { + } + + + public void draw() { + // if no draw method, then shut things down + //System.out.println("no draw method, goodbye"); + finished = true; + } + + + ////////////////////////////////////////////////////////////// + + + protected void resizeRenderer(int iwidth, int iheight) { +// println("resizeRenderer request for " + iwidth + " " + iheight); + if (width != iwidth || height != iheight) { +// println(" former size was " + width + " " + height); + g.setSize(iwidth, iheight); + width = iwidth; + height = iheight; + } + } + + + /** + * Defines the dimension of the display window in units of pixels. The size() function must be the first line in setup(). If size() is not called, the default size of the window is 100x100 pixels. The system variables width and height are set by the parameters passed to the size() function.

+ * Do not use variables as the parameters to size() command, because it will cause problems when exporting your sketch. When variables are used, the dimensions of your sketch cannot be determined during export. Instead, employ numeric values in the size() statement, and then use the built-in width and height variables inside your program when you need the dimensions of the display window are needed.

+ * The MODE parameters selects which rendering engine to use. For example, if you will be drawing 3D shapes for the web use P3D, if you want to export a program with OpenGL graphics acceleration use OPENGL. A brief description of the four primary renderers follows:

JAVA2D - The default renderer. This renderer supports two dimensional drawing and provides higher image quality in overall, but generally slower than P2D.

P2D (Processing 2D) - Fast 2D renderer, best used with pixel data, but not as accurate as the JAVA2D default.

P3D (Processing 3D) - Fast 3D renderer for the web. Sacrifices rendering quality for quick 3D drawing.

OPENGL - High speed 3D graphics renderer that makes use of OpenGL-compatible graphics hardware is available. Keep in mind that OpenGL is not magic pixie dust that makes any sketch faster (though it's close), so other rendering options may produce better results depending on the nature of your code. Also note that with OpenGL, all graphics are smoothed: the smooth() and noSmooth() commands are ignored.

PDF - 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 → PDF to make use of the library. More information can be found in the PDF library reference. + * If you're manipulating pixels (using methods like get() or blend(), or manipulating the pixels[] array), P2D and P3D will usually be faster than the default (JAVA2D) setting, and often the OPENGL setting as well. Similarly, when handling lots of images, or doing video playback, P2D and P3D will tend to be faster.

+ * The P2D, P3D, and OPENGL renderers do not support strokeCap() or strokeJoin(), which can lead to ugly results when using strokeWeight(). (Bug 955)

+ * For the most elegant and accurate results when drawing in 2D, particularly when using smooth(), use the JAVA2D renderer setting. It may be slower than the others, but is the most complete, which is why it's the default. Advanced users will want to switch to other renderers as they learn the tradeoffs.

+ * Rendering graphics requires tradeoffs between speed, accuracy, and general usefulness of the available features. None of the renderers are perfect, so we provide multiple options so that you can decide what tradeoffs make the most sense for your project. We'd prefer all of them to have perfect visual accuracy, high performance, and support a wide range of features, but that's simply not possible.

+ * 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 screen that's 800x600 could support size(1600, 300), since it's the same number of pixels. This varies widely so you'll have to try different rendering modes and sizes until you get what you're looking for. If you need something larger, use createGraphics to create a non-visible drawing surface. + *

Again, the size() method must be the first line of the code (or first item inside setup). Any code that appears before the size() command may run more than once, which can lead to confusing results. + * + * =advanced + * Starts up and creates a two-dimensional drawing surface, + * or resizes the current drawing surface. + *

+ * This should be the first thing called inside of setup(). + *

+ * If using Java 1.3 or later, this will default to using + * PGraphics2, the Java2D-based renderer. If using Java 1.1, + * or if PGraphics2 is not available, then PGraphics will be used. + * To set your own renderer, use the other version of the size() + * method that takes a renderer as its last parameter. + *

+ * If called once a renderer has already been set, this will + * use the previous renderer and simply resize it. + * + * @webref structure + * @param iwidth width of the display window in units of pixels + * @param iheight height of the display window in units of pixels + */ + public void size(int iwidth, int iheight) { + size(iwidth, iheight, JAVA2D, null); + } + + /** + * + * @param irenderer Either P2D, P3D, JAVA2D, or OPENGL + */ + public void size(int iwidth, int iheight, String irenderer) { + size(iwidth, iheight, irenderer, null); + } + + + /** + * Creates a new PGraphics object and sets it to the specified size. + * + * Note that you cannot change the renderer once outside of setup(). + * In most cases, you can call size() to give it a new size, + * but you need to always ask for the same renderer, otherwise + * you're gonna run into trouble. + * + * The size() method should *only* be called from inside the setup() or + * draw() methods, so that it is properly run on the main animation thread. + * To change the size of a PApplet externally, use setSize(), which will + * update the component size, and queue a resize of the renderer as well. + */ + public void size(final int iwidth, final int iheight, + String irenderer, String ipath) { + // Run this from the EDT, just cuz it's AWT stuff (or maybe later Swing) + SwingUtilities.invokeLater(new Runnable() { + public void run() { + // Set the preferred size so that the layout managers can handle it + setPreferredSize(new Dimension(iwidth, iheight)); + setSize(iwidth, iheight); + } + }); + + // ensure that this is an absolute path + if (ipath != null) ipath = savePath(ipath); + + String currentRenderer = g.getClass().getName(); + if (currentRenderer.equals(irenderer)) { + // Avoid infinite loop of throwing exception to reset renderer + resizeRenderer(iwidth, iheight); + //redraw(); // will only be called insize draw() + + } else { // renderer is being changed + // otherwise ok to fall through and create renderer below + // the renderer is changing, so need to create a new object + g = makeGraphics(iwidth, iheight, irenderer, ipath, true); + width = iwidth; + height = iheight; + + // fire resize event to make sure the applet is the proper size +// setSize(iwidth, iheight); + // this is the function that will run if the user does their own + // size() command inside setup, so set defaultSize to false. + defaultSize = false; + + // throw an exception so that setup() is called again + // but with a properly sized render + // this is for opengl, which needs a valid, properly sized + // display before calling anything inside setup(). + throw new RendererChangeException(); + } + } + + + /** + * Creates and returns a new PGraphics object of the types P2D, P3D, and JAVA2D. Use this class if you need to draw into an off-screen graphics buffer. It's not possible to use createGraphics() with OPENGL, because it doesn't allow offscreen use. The DXF and PDF renderers require the filename parameter. + *

It's important to call any drawing commands between beginDraw() and endDraw() statements. This is also true for any commands that affect drawing, such as smooth() or colorMode(). + *

Unlike the main drawing surface which is completely opaque, surfaces created with createGraphics() can have transparency. This makes it possible to draw into a graphics and maintain the alpha channel. By using save() to write a PNG or TGA file, the transparency of the graphics object will be honored. Note that transparency levels are binary: pixels are either complete opaque or transparent. For the time being (as of release 0127), this means that text characters will be opaque blocks. This will be fixed in a future release (Bug 641). + * + * =advanced + * Create an offscreen PGraphics object for drawing. This can be used + * for bitmap or vector images drawing or rendering. + *

    + *
  • Do not use "new PGraphicsXxxx()", use this method. This method + * ensures that internal variables are set up properly that tie the + * new graphics context back to its parent PApplet. + *
  • The basic way to create bitmap images is to use the saveFrame() + * function. + *
  • If you want to create a really large scene and write that, + * first make sure that you've allocated a lot of memory in the Preferences. + *
  • If you want to create images that are larger than the screen, + * you should create your own PGraphics object, draw to that, and use + * save(). + * For now, it's best to use P3D in this scenario. + * P2D is currently disabled, and the JAVA2D default will give mixed + * results. An example of using P3D: + * 
    +   *
+   * PGraphics big;
+   *
+   * void setup() {
+   *   big = createGraphics(3000, 3000, P3D);
+   *
+   *   big.beginDraw();
+   *   big.background(128);
+   *   big.line(20, 1800, 1800, 900);
+   *   // etc..
+   *   big.endDraw();
+   *
+   *   // make sure the file is written to the sketch folder
+   *   big.save("big.tif");
+   * }
+   *
+   *
    + *
  • It's important to always wrap drawing to createGraphics() with + * beginDraw() and endDraw() (beginFrame() and endFrame() prior to + * revision 0115). The reason is that the renderer needs to know when + * drawing has stopped, so that it can update itself internally. + * This also handles calling the defaults() method, for people familiar + * with that. + *
  • It's not possible to use createGraphics() with the OPENGL renderer, + * because it doesn't allow offscreen use. + *
  • With Processing 0115 and later, it's possible to write images in + * formats other than the default .tga and .tiff. The exact formats and + * background information can be found in the developer's reference for + * PImage.save(). + *
+ * + * @webref rendering + * @param iwidth width in pixels + * @param iheight height in pixels + * @param irenderer Either P2D (not yet implemented), P3D, JAVA2D, PDF, DXF + * + * @see processing.core.PGraphics + * + */ + public PGraphics createGraphics(int iwidth, int iheight, + String irenderer) { + PGraphics pg = makeGraphics(iwidth, iheight, irenderer, null, false); + //pg.parent = this; // make save() work + return pg; + } + + + /** + * Create an offscreen graphics surface for drawing, in this case + * for a renderer that writes to a file (such as PDF or DXF). + * @param ipath the name of the file (can be an absolute or relative path) + */ + public PGraphics createGraphics(int iwidth, int iheight, + String irenderer, String ipath) { + if (ipath != null) { + ipath = savePath(ipath); + } + PGraphics pg = makeGraphics(iwidth, iheight, irenderer, ipath, false); + pg.parent = this; // make save() work + return pg; + } + + + /** + * Version of createGraphics() used internally. + * + * @param ipath must be an absolute path, usually set via savePath() + * @oaram applet the parent applet object, this should only be non-null + * in cases where this is the main drawing surface object. + */ + protected PGraphics makeGraphics(int iwidth, int iheight, + String irenderer, String ipath, + boolean iprimary) { + if (irenderer.equals(OPENGL)) { + if (PApplet.platform == WINDOWS) { + String s = System.getProperty("java.version"); + if (s != null) { + if (s.equals("1.5.0_10")) { + System.err.println("OpenGL support is broken with Java 1.5.0_10"); + System.err.println("See http://dev.processing.org" + + "/bugs/show_bug.cgi?id=513 for more info."); + throw new RuntimeException("Please update your Java " + + "installation (see bug #513)"); + } + } + } + } + +// if (irenderer.equals(P2D)) { +// throw new RuntimeException("The P2D renderer is currently disabled, " + +// "please use P3D or JAVA2D."); +// } + + String openglError = + "Before using OpenGL, first select " + + "Import Library > opengl from the Sketch menu."; + + try { + /* + Class rendererClass = Class.forName(irenderer); + + Class constructorParams[] = null; + Object constructorValues[] = null; + + if (ipath == null) { + constructorParams = new Class[] { + Integer.TYPE, Integer.TYPE, PApplet.class + }; + constructorValues = new Object[] { + new Integer(iwidth), new Integer(iheight), this + }; + } else { + constructorParams = new Class[] { + Integer.TYPE, Integer.TYPE, PApplet.class, String.class + }; + constructorValues = new Object[] { + new Integer(iwidth), new Integer(iheight), this, ipath + }; + } + + Constructor constructor = + rendererClass.getConstructor(constructorParams); + PGraphics pg = (PGraphics) constructor.newInstance(constructorValues); + */ + + Class rendererClass = + Thread.currentThread().getContextClassLoader().loadClass(irenderer); + + //Class params[] = null; + //PApplet.println(rendererClass.getConstructors()); + Constructor constructor = rendererClass.getConstructor(new Class[] { }); + PGraphics pg = (PGraphics) constructor.newInstance(); + + pg.setParent(this); + pg.setPrimary(iprimary); + if (ipath != null) pg.setPath(ipath); + pg.setSize(iwidth, iheight); + + // everything worked, return it + return pg; + + } catch (InvocationTargetException ite) { + String msg = ite.getTargetException().getMessage(); + if ((msg != null) && + (msg.indexOf("no jogl in java.library.path") != -1)) { + throw new RuntimeException(openglError + + " (The native library is missing.)"); + + } else { + ite.getTargetException().printStackTrace(); + Throwable target = ite.getTargetException(); + if (platform == MACOSX) target.printStackTrace(System.out); // bug + // neither of these help, or work + //target.printStackTrace(System.err); + //System.err.flush(); + //System.out.println(System.err); // and the object isn't null + throw new RuntimeException(target.getMessage()); + } + + } catch (ClassNotFoundException cnfe) { + if (cnfe.getMessage().indexOf("processing.opengl.PGraphicsGL") != -1) { + throw new RuntimeException(openglError + + " (The library .jar file is missing.)"); + } else { + throw new RuntimeException("You need to use \"Import Library\" " + + "to add " + irenderer + " to your sketch."); + } + + } catch (Exception e) { + //System.out.println("ex3"); + if ((e instanceof IllegalArgumentException) || + (e instanceof NoSuchMethodException) || + (e instanceof IllegalAccessException)) { + e.printStackTrace(); + /* + String msg = "public " + + irenderer.substring(irenderer.lastIndexOf('.') + 1) + + "(int width, int height, PApplet parent" + + ((ipath == null) ? "" : ", String filename") + + ") does not exist."; + */ + String msg = irenderer + " needs to be updated " + + "for the current release of Processing."; + throw new RuntimeException(msg); + + } else { + if (platform == MACOSX) e.printStackTrace(System.out); + throw new RuntimeException(e.getMessage()); + } + } + } + + + /** + * Creates a new PImage (the datatype for storing images). This provides a fresh buffer of pixels to play with. Set the size of the buffer with the width and height parameters. The format 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 new PImage(). + * =advanced + * Preferred method of creating new PImage objects, ensures that a + * reference to the parent PApplet is included, which makes save() work + * without needing an absolute path. + * + * @webref image + * @param wide width in pixels + * @param high height in pixels + * @param format Either RGB, ARGB, ALPHA (grayscale alpha channel) + * + * @see processing.core.PImage + * @see processing.core.PGraphics + */ + public PImage createImage(int wide, int high, int format) { + PImage image = new PImage(wide, high, format); + image.parent = this; // make save() work + return image; + } + + + // . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . + + + public void update(Graphics screen) { + paint(screen); + } + + + //synchronized public void paint(Graphics screen) { // shutting off for 0146 + public void paint(Graphics screen) { + // ignore the very first call to paint, since it's coming + // from the o.s., and the applet will soon update itself anyway. + if (frameCount == 0) { +// println("Skipping frame"); + // paint() may be called more than once before things + // are finally painted to the screen and the thread gets going + return; + } + + // without ignoring the first call, the first several frames + // are confused because paint() gets called in the midst of + // the initial nextFrame() call, so there are multiple + // updates fighting with one another. + + // g.image is synchronized so that draw/loop and paint don't + // try to fight over it. this was causing a randomized slowdown + // that would cut the frameRate into a third on macosx, + // and is probably related to the windows sluggishness bug too + + // make sure the screen is visible and usable + // (also prevents over-drawing when using PGraphicsOpenGL) + if ((g != null) && (g.image != null)) { +// println("inside paint(), screen.drawImage()"); + screen.drawImage(g.image, 0, 0, null); + } + } + + + // active paint method + protected void paint() { + try { + Graphics screen = this.getGraphics(); + if (screen != null) { + if ((g != null) && (g.image != null)) { + screen.drawImage(g.image, 0, 0, null); + } + Toolkit.getDefaultToolkit().sync(); + } + } catch (Exception e) { + // Seen on applet destroy, maybe can ignore? + e.printStackTrace(); + +// } finally { +// if (g != null) { +// g.dispose(); +// } + } + } + + + ////////////////////////////////////////////////////////////// + + + /** + * Main method for the primary animation thread. + * + * Painting in AWT and Swing + */ + public void run() { // not good to make this synchronized, locks things up + long beforeTime = System.nanoTime(); + long overSleepTime = 0L; + + int noDelays = 0; + // Number of frames with a delay of 0 ms before the + // animation thread yields to other running threads. + final int NO_DELAYS_PER_YIELD = 15; + + /* + // this has to be called after the exception is thrown, + // otherwise the supporting libs won't have a valid context to draw to + Object methodArgs[] = + new Object[] { new Integer(width), new Integer(height) }; + sizeMethods.handle(methodArgs); + */ + + while ((Thread.currentThread() == thread) && !finished) { + // Don't resize the renderer from the EDT (i.e. from a ComponentEvent), + // otherwise it may attempt a resize mid-render. + if (resizeRequest) { + resizeRenderer(resizeWidth, resizeHeight); + resizeRequest = false; + } + + // render a single frame + handleDraw(); + + if (frameCount == 1) { + // Call the request focus event once the image is sure to be on + // screen and the component is valid. The OpenGL renderer will + // request focus for its canvas inside beginDraw(). + // http://java.sun.com/j2se/1.4.2/docs/api/java/awt/doc-files/FocusSpec.html + //println("requesting focus"); + requestFocus(); + } + + // wait for update & paint to happen before drawing next frame + // this is necessary since the drawing is sometimes in a + // separate thread, meaning that the next frame will start + // before the update/paint is completed + + long afterTime = System.nanoTime(); + long timeDiff = afterTime - beforeTime; + //System.out.println("time diff is " + timeDiff); + long sleepTime = (frameRatePeriod - timeDiff) - overSleepTime; + + if (sleepTime > 0) { // some time left in this cycle + try { +// Thread.sleep(sleepTime / 1000000L); // nanoseconds -> milliseconds + Thread.sleep(sleepTime / 1000000L, (int) (sleepTime % 1000000L)); + noDelays = 0; // Got some sleep, not delaying anymore + } catch (InterruptedException ex) { } + + overSleepTime = (System.nanoTime() - afterTime) - sleepTime; + //System.out.println(" oversleep is " + overSleepTime); + + } else { // sleepTime <= 0; the frame took longer than the period +// excess -= sleepTime; // store excess time value + overSleepTime = 0L; + + if (noDelays > NO_DELAYS_PER_YIELD) { + Thread.yield(); // give another thread a chance to run + noDelays = 0; + } + } + + beforeTime = System.nanoTime(); + } + + stop(); // call to shutdown libs? + + // If the user called the exit() function, the window should close, + // rather than the sketch just halting. + if (exitCalled) { + exit2(); + } + } + + + //synchronized public void handleDisplay() { + public void handleDraw() { + if (g != null && (looping || redraw)) { + if (!g.canDraw()) { + // Don't draw if the renderer is not yet ready. + // (e.g. OpenGL has to wait for a peer to be on screen) + return; + } + + //System.out.println("handleDraw() " + frameCount); + + g.beginDraw(); + if (recorder != null) { + recorder.beginDraw(); + } + + long now = System.nanoTime(); + + if (frameCount == 0) { + try { + //println("Calling setup()"); + setup(); + //println("Done with setup()"); + + } catch (RendererChangeException e) { + // Give up, instead set the new renderer and re-attempt setup() + return; + } + this.defaultSize = false; + + } else { // frameCount > 0, meaning an actual draw() + // update the current frameRate + double rate = 1000000.0 / ((now - frameRateLastNanos) / 1000000.0); + float instantaneousRate = (float) rate / 1000.0f; + frameRate = (frameRate * 0.9f) + (instantaneousRate * 0.1f); + + preMethods.handle(); + + // use dmouseX/Y as previous mouse pos, since this is the + // last position the mouse was in during the previous draw. + pmouseX = dmouseX; + pmouseY = dmouseY; + + //println("Calling draw()"); + draw(); + //println("Done calling draw()"); + + // dmouseX/Y is updated only once per frame (unlike emouseX/Y) + dmouseX = mouseX; + dmouseY = mouseY; + + // these are called *after* loop so that valid + // drawing commands can be run inside them. it can't + // be before, since a call to background() would wipe + // out anything that had been drawn so far. + dequeueMouseEvents(); + dequeueKeyEvents(); + + drawMethods.handle(); + + redraw = false; // unset 'redraw' flag in case it was set + // (only do this once draw() has run, not just setup()) + + } + + g.endDraw(); + if (recorder != null) { + recorder.endDraw(); + } + + frameRateLastNanos = now; + frameCount++; + + // Actively render the screen + paint(); + +// repaint(); +// getToolkit().sync(); // force repaint now (proper method) + + postMethods.handle(); + } + } + + + ////////////////////////////////////////////////////////////// + + + + synchronized public void redraw() { + if (!looping) { + redraw = true; +// if (thread != null) { +// // wake from sleep (necessary otherwise it'll be +// // up to 10 seconds before update) +// if (CRUSTY_THREADS) { +// thread.interrupt(); +// } else { +// synchronized (blocker) { +// blocker.notifyAll(); +// } +// } +// } + } + } + + + synchronized public void loop() { + if (!looping) { + looping = true; + } + } + + + synchronized public void noLoop() { + if (looping) { + looping = false; + } + } + + + ////////////////////////////////////////////////////////////// + + + public void addListeners() { + addMouseListener(this); + addMouseMotionListener(this); + addKeyListener(this); + addFocusListener(this); + + addComponentListener(new ComponentAdapter() { + public void componentResized(ComponentEvent e) { + Component c = e.getComponent(); + //System.out.println("componentResized() " + c); + Rectangle bounds = c.getBounds(); + resizeRequest = true; + resizeWidth = bounds.width; + resizeHeight = bounds.height; + } + }); + } + + + ////////////////////////////////////////////////////////////// + + + MouseEvent mouseEventQueue[] = new MouseEvent[10]; + int mouseEventCount; + + protected void enqueueMouseEvent(MouseEvent e) { + synchronized (mouseEventQueue) { + if (mouseEventCount == mouseEventQueue.length) { + MouseEvent temp[] = new MouseEvent[mouseEventCount << 1]; + System.arraycopy(mouseEventQueue, 0, temp, 0, mouseEventCount); + mouseEventQueue = temp; + } + mouseEventQueue[mouseEventCount++] = e; + } + } + + protected void dequeueMouseEvents() { + synchronized (mouseEventQueue) { + for (int i = 0; i < mouseEventCount; i++) { + mouseEvent = mouseEventQueue[i]; + handleMouseEvent(mouseEvent); + } + mouseEventCount = 0; + } + } + + + /** + * Actually take action based on a mouse event. + * Internally updates mouseX, mouseY, mousePressed, and mouseEvent. + * Then it calls the event type with no params, + * i.e. mousePressed() or mouseReleased() that the user may have + * overloaded to do something more useful. + */ + protected void handleMouseEvent(MouseEvent event) { + int id = event.getID(); + + // http://dev.processing.org/bugs/show_bug.cgi?id=170 + // also prevents mouseExited() on the mac from hosing the mouse + // position, because x/y are bizarre values on the exit event. + // see also the id check below.. both of these go together + if ((id == MouseEvent.MOUSE_DRAGGED) || + (id == MouseEvent.MOUSE_MOVED)) { + pmouseX = emouseX; + pmouseY = emouseY; + mouseX = event.getX(); + mouseY = event.getY(); + } + + mouseEvent = event; + + int modifiers = event.getModifiers(); + if ((modifiers & InputEvent.BUTTON1_MASK) != 0) { + mouseButton = LEFT; + } else if ((modifiers & InputEvent.BUTTON2_MASK) != 0) { + mouseButton = CENTER; + } else if ((modifiers & InputEvent.BUTTON3_MASK) != 0) { + mouseButton = RIGHT; + } + // if running on macos, allow ctrl-click as right mouse + if (platform == MACOSX) { + if (mouseEvent.isPopupTrigger()) { + mouseButton = RIGHT; + } + } + + mouseEventMethods.handle(new Object[] { event }); + + // this used to only be called on mouseMoved and mouseDragged + // change it back if people run into trouble + if (firstMouse) { + pmouseX = mouseX; + pmouseY = mouseY; + dmouseX = mouseX; + dmouseY = mouseY; + firstMouse = false; + } + + //println(event); + + switch (id) { + case MouseEvent.MOUSE_PRESSED: + mousePressed = true; + mousePressed(); + break; + case MouseEvent.MOUSE_RELEASED: + mousePressed = false; + mouseReleased(); + break; + case MouseEvent.MOUSE_CLICKED: + mouseClicked(); + break; + case MouseEvent.MOUSE_DRAGGED: + mouseDragged(); + break; + case MouseEvent.MOUSE_MOVED: + mouseMoved(); + break; + } + + if ((id == MouseEvent.MOUSE_DRAGGED) || + (id == MouseEvent.MOUSE_MOVED)) { + emouseX = mouseX; + emouseY = mouseY; + } + } + + + /** + * Figure out how to process a mouse event. When loop() has been + * called, the events will be queued up until drawing is complete. + * If noLoop() has been called, then events will happen immediately. + */ + protected void checkMouseEvent(MouseEvent event) { + if (looping) { + enqueueMouseEvent(event); + } else { + handleMouseEvent(event); + } + } + + + /** + * If you override this or any function that takes a "MouseEvent e" + * without calling its super.mouseXxxx() then mouseX, mouseY, + * mousePressed, and mouseEvent will no longer be set. + */ + public void mousePressed(MouseEvent e) { + checkMouseEvent(e); + } + + public void mouseReleased(MouseEvent e) { + checkMouseEvent(e); + } + + public void mouseClicked(MouseEvent e) { + checkMouseEvent(e); + } + + public void mouseEntered(MouseEvent e) { + checkMouseEvent(e); + } + + public void mouseExited(MouseEvent e) { + checkMouseEvent(e); + } + + public void mouseDragged(MouseEvent e) { + checkMouseEvent(e); + } + + public void mouseMoved(MouseEvent e) { + checkMouseEvent(e); + } + + + /** + * The mousePressed() function is called once after every time a mouse button is pressed. The mouseButton variable (see the related reference entry) can be used to determine which button has been pressed. + * =advanced + * + * If you must, use + * int button = mouseEvent.getButton(); + * to figure out which button was clicked. It will be one of: + * MouseEvent.BUTTON1, MouseEvent.BUTTON2, MouseEvent.BUTTON3 + * Note, however, that this is completely inconsistent across + * platforms. + * @webref input:mouse + * @see PApplet#mouseX + * @see PApplet#mouseY + * @see PApplet#mousePressed + * @see PApplet#mouseReleased() + * @see PApplet#mouseMoved() + * @see PApplet#mouseDragged() + */ + public void mousePressed() { } + + /** + * The mouseReleased() function is called every time a mouse button is released. + * @webref input:mouse + * @see PApplet#mouseX + * @see PApplet#mouseY + * @see PApplet#mousePressed + * @see PApplet#mousePressed() + * @see PApplet#mouseMoved() + * @see PApplet#mouseDragged() + */ + public void mouseReleased() { } + + /** + * The mouseClicked() function is called once after a mouse button has been pressed and then released. + * =advanced + * When the mouse is clicked, mousePressed() will be called, + * then mouseReleased(), then mouseClicked(). Note that + * mousePressed is already false inside of mouseClicked(). + * @webref input:mouse + * @see PApplet#mouseX + * @see PApplet#mouseY + * @see PApplet#mouseButton + * @see PApplet#mousePressed() + * @see PApplet#mouseReleased() + * @see PApplet#mouseMoved() + * @see PApplet#mouseDragged() + */ + public void mouseClicked() { } + + /** + * The mouseDragged() function is called once every time the mouse moves and a mouse button is pressed. + * @webref input:mouse + * @see PApplet#mouseX + * @see PApplet#mouseY + * @see PApplet#mousePressed + * @see PApplet#mousePressed() + * @see PApplet#mouseReleased() + * @see PApplet#mouseMoved() + */ + public void mouseDragged() { } + + /** + * The mouseMoved() function is called every time the mouse moves and a mouse button is not pressed. + * @webref input:mouse + * @see PApplet#mouseX + * @see PApplet#mouseY + * @see PApplet#mousePressed + * @see PApplet#mousePressed() + * @see PApplet#mouseReleased() + * @see PApplet#mouseDragged() + */ + public void mouseMoved() { } + + + ////////////////////////////////////////////////////////////// + + + KeyEvent keyEventQueue[] = new KeyEvent[10]; + int keyEventCount; + + protected void enqueueKeyEvent(KeyEvent e) { + synchronized (keyEventQueue) { + if (keyEventCount == keyEventQueue.length) { + KeyEvent temp[] = new KeyEvent[keyEventCount << 1]; + System.arraycopy(keyEventQueue, 0, temp, 0, keyEventCount); + keyEventQueue = temp; + } + keyEventQueue[keyEventCount++] = e; + } + } + + protected void dequeueKeyEvents() { + synchronized (keyEventQueue) { + for (int i = 0; i < keyEventCount; i++) { + keyEvent = keyEventQueue[i]; + handleKeyEvent(keyEvent); + } + keyEventCount = 0; + } + } + + + protected void handleKeyEvent(KeyEvent event) { + keyEvent = event; + key = event.getKeyChar(); + keyCode = event.getKeyCode(); + + keyEventMethods.handle(new Object[] { event }); + + switch (event.getID()) { + case KeyEvent.KEY_PRESSED: + keyPressed = true; + keyPressed(); + break; + case KeyEvent.KEY_RELEASED: + keyPressed = false; + keyReleased(); + break; + case KeyEvent.KEY_TYPED: + keyTyped(); + break; + } + + // if someone else wants to intercept the key, they should + // set key to zero (or something besides the ESC). + if (event.getID() == KeyEvent.KEY_PRESSED) { + if (key == KeyEvent.VK_ESCAPE) { + exit(); + } + // When running tethered to the Processing application, respond to + // Ctrl-W (or Cmd-W) events by closing the sketch. Disable this behavior + // when running independently, because this sketch may be one component + // embedded inside an application that has its own close behavior. + if (external && + event.getModifiers() == MENU_SHORTCUT && + event.getKeyCode() == 'W') { + exit(); + } + } + } + + + protected void checkKeyEvent(KeyEvent event) { + if (looping) { + enqueueKeyEvent(event); + } else { + handleKeyEvent(event); + } + } + + + /** + * Overriding keyXxxxx(KeyEvent e) functions will cause the 'key', + * 'keyCode', and 'keyEvent' variables to no longer work; + * key events will no longer be queued until the end of draw(); + * and the keyPressed(), keyReleased() and keyTyped() methods + * will no longer be called. + */ + public void keyPressed(KeyEvent e) { checkKeyEvent(e); } + public void keyReleased(KeyEvent e) { checkKeyEvent(e); } + public void keyTyped(KeyEvent e) { checkKeyEvent(e); } + + + /** + * + * The keyPressed() function is called once every time a key is pressed. The key that was pressed is stored in the key variable. + *

For non-ASCII keys, use the keyCode 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 the key variable instead of keyCode + * If you're making 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 configured. + * =advanced + * + * Called each time a single key on the keyboard is pressed. + * Because of how operating systems handle key repeats, holding + * down a key will cause multiple calls to keyPressed(), because + * the OS repeat takes over. + *

+ * Examples for key handling: + * (Tested on Windows XP, please notify if different on other + * platforms, I have a feeling Mac OS and Linux may do otherwise) + * 

+   * 1. Pressing 'a' on the keyboard:
+   *    keyPressed  with key == 'a' and keyCode == 'A'
+   *    keyTyped    with key == 'a' and keyCode ==  0
+   *    keyReleased with key == 'a' and keyCode == 'A'
+   *
+   * 2. Pressing 'A' on the keyboard:
+   *    keyPressed  with key == 'A' and keyCode == 'A'
+   *    keyTyped    with key == 'A' and keyCode ==  0
+   *    keyReleased with key == 'A' and keyCode == 'A'
+   *
+   * 3. Pressing 'shift', then 'a' on the keyboard (caps lock is off):
+   *    keyPressed  with key == CODED and keyCode == SHIFT
+   *    keyPressed  with key == 'A'   and keyCode == 'A'
+   *    keyTyped    with key == 'A'   and keyCode == 0
+   *    keyReleased with key == 'A'   and keyCode == 'A'
+   *    keyReleased with key == CODED and keyCode == SHIFT
+   *
+   * 4. Holding down the 'a' key.
+   *    The following will happen several times,
+   *    depending on your machine's "key repeat rate" settings:
+   *    keyPressed  with key == 'a' and keyCode == 'A'
+   *    keyTyped    with key == 'a' and keyCode ==  0
+   *    When you finally let go, you'll get:
+   *    keyReleased with key == 'a' and keyCode == 'A'
+   *
+   * 5. Pressing and releasing the 'shift' key
+   *    keyPressed  with key == CODED and keyCode == SHIFT
+   *    keyReleased with key == CODED and keyCode == SHIFT
+   *    (note there is no keyTyped)
+   *
+   * 6. Pressing the tab key in an applet with Java 1.4 will
+   *    normally do nothing, but PApplet dynamically shuts
+   *    this behavior off if Java 1.4 is in use (tested 1.4.2_05 Windows).
+   *    Java 1.1 (Microsoft VM) passes the TAB key through normally.
+   *    Not tested on other platforms or for 1.3.
+   *
+ * @see PApplet#key + * @see PApplet#keyCode + * @see PApplet#keyPressed + * @see PApplet#keyReleased() + * @webref input:keyboard + */ + public void keyPressed() { } + + + /** + * The keyReleased() function is called once every time a key is released. The key that was released will be stored in the key variable. See key and keyReleased for more information. + * + * @see PApplet#key + * @see PApplet#keyCode + * @see PApplet#keyPressed + * @see PApplet#keyPressed() + * @webref input:keyboard + */ + public void keyReleased() { } + + + /** + * Only called for "regular" keys like letters, + * see keyPressed() for full documentation. + */ + public void keyTyped() { } + + + ////////////////////////////////////////////////////////////// + + // i am focused man, and i'm not afraid of death. + // and i'm going all out. i circle the vultures in a van + // and i run the block. + + + public void focusGained() { } + + public void focusGained(FocusEvent e) { + focused = true; + focusGained(); + } + + + public void focusLost() { } + + public void focusLost(FocusEvent e) { + focused = false; + focusLost(); + } + + + ////////////////////////////////////////////////////////////// + + // getting the time + + + /** + * Returns the number of milliseconds (thousandths of a second) since starting an applet. This information is often used for timing animation sequences. + * + * =advanced + *

+ * This is a function, rather than a variable, because it may + * change multiple times per frame. + * + * @webref input:time_date + * @see processing.core.PApplet#second() + * @see processing.core.PApplet#minute() + * @see processing.core.PApplet#hour() + * @see processing.core.PApplet#day() + * @see processing.core.PApplet#month() + * @see processing.core.PApplet#year() + * + */ + public int millis() { + return (int) (System.currentTimeMillis() - millisOffset); + } + + /** Seconds position of the current time. + * + * @webref input:time_date + * @see processing.core.PApplet#millis() + * @see processing.core.PApplet#minute() + * @see processing.core.PApplet#hour() + * @see processing.core.PApplet#day() + * @see processing.core.PApplet#month() + * @see processing.core.PApplet#year() + * */ + static public int second() { + return Calendar.getInstance().get(Calendar.SECOND); + } + + /** + * Processing communicates with the clock on your computer. The minute() function returns the current minute as a value from 0 - 59. + * + * @webref input:time_date + * @see processing.core.PApplet#millis() + * @see processing.core.PApplet#second() + * @see processing.core.PApplet#hour() + * @see processing.core.PApplet#day() + * @see processing.core.PApplet#month() + * @see processing.core.PApplet#year() + * + * */ + static public int minute() { + return Calendar.getInstance().get(Calendar.MINUTE); + } + + /** + * Processing communicates with the clock on your computer. The hour() function returns the current hour as a value from 0 - 23. + * =advanced + * Hour position of the current time in international format (0-23). + *

+ * To convert this value to American time:
+ * 

int yankeeHour = (hour() % 12);
+   * if (yankeeHour == 0) yankeeHour = 12;
+ * + * @webref input:time_date + * @see processing.core.PApplet#millis() + * @see processing.core.PApplet#second() + * @see processing.core.PApplet#minute() + * @see processing.core.PApplet#day() + * @see processing.core.PApplet#month() + * @see processing.core.PApplet#year() + * + */ + static public int hour() { + return Calendar.getInstance().get(Calendar.HOUR_OF_DAY); + } + + /** + * Processing communicates with the clock on your computer. The day() function returns the current day as a value from 1 - 31. + * =advanced + * Get the current day of the month (1 through 31). + *

+ * If you're looking for the day of the week (M-F or whatever) + * or day of the year (1..365) then use java's Calendar.get() + * + * @webref input:time_date + * @see processing.core.PApplet#millis() + * @see processing.core.PApplet#second() + * @see processing.core.PApplet#minute() + * @see processing.core.PApplet#hour() + * @see processing.core.PApplet#month() + * @see processing.core.PApplet#year() + */ + static public int day() { + return Calendar.getInstance().get(Calendar.DAY_OF_MONTH); + } + + /** + * Processing communicates with the clock on your computer. The month() function returns the current month as a value from 1 - 12. + * + * @webref input:time_date + * @see processing.core.PApplet#millis() + * @see processing.core.PApplet#second() + * @see processing.core.PApplet#minute() + * @see processing.core.PApplet#hour() + * @see processing.core.PApplet#day() + * @see processing.core.PApplet#year() + */ + static public int month() { + // months are number 0..11 so change to colloquial 1..12 + return Calendar.getInstance().get(Calendar.MONTH) + 1; + } + + /** + * Processing communicates with the clock on your computer. + * The year() function returns the current year as an integer (2003, 2004, 2005, etc). + * + * @webref input:time_date + * @see processing.core.PApplet#millis() + * @see processing.core.PApplet#second() + * @see processing.core.PApplet#minute() + * @see processing.core.PApplet#hour() + * @see processing.core.PApplet#day() + * @see processing.core.PApplet#month() + */ + static public int year() { + return Calendar.getInstance().get(Calendar.YEAR); + } + + + ////////////////////////////////////////////////////////////// + + // controlling time (playing god) + + + /** + * The delay() function causes the program to halt for a specified time. + * Delay times are specified in thousandths of a second. For example, + * running delay(3000) will stop the program for three seconds and + * delay(500) will stop the program for a half-second. Remember: the + * display window is updated only at the end of draw(), so putting more + * than one delay() inside draw() will simply add them together and the new + * frame will be drawn when the total delay is over. + *

+ * I'm not sure if this is even helpful anymore, as the screen isn't + * updated before or after the delay, meaning which means it just + * makes the app lock up temporarily. + */ + public void delay(int napTime) { + if (frameCount != 0) { + if (napTime > 0) { + try { + Thread.sleep(napTime); + } catch (InterruptedException e) { } + } + } + } + + + /** + * Specifies the number of frames to be displayed every second. + * If the processor is not fast enough to maintain the specified rate, it will not be achieved. + * For example, the function call frameRate(30) will attempt to refresh 30 times a second. + * It is recommended to set the frame rate within setup(). The default rate is 60 frames per second. + * =advanced + * Set a target frameRate. This will cause delay() to be called + * after each frame so that the sketch synchronizes to a particular speed. + * Note that this only sets the maximum frame rate, it cannot be used to + * make a slow sketch go faster. Sketches have no default frame rate + * setting, and will attempt to use maximum processor power to achieve + * maximum speed. + * @webref environment + * @param newRateTarget number of frames per second + * @see PApplet#delay(int) + */ + public void frameRate(float newRateTarget) { + frameRateTarget = newRateTarget; + frameRatePeriod = (long) (1000000000.0 / frameRateTarget); + } + + + ////////////////////////////////////////////////////////////// + + + /** + * Reads the value of a param. + * Values are always read as a String so if you want them to be an integer or other datatype they must be converted. + * The param() function will only work in a web browser. + * The function should be called inside setup(), + * otherwise the applet may not yet be initialized and connected to its parent web browser. + * + * @webref input:web + * @usage Web + * + * @param what name of the param to read + */ + public String param(String what) { + if (online) { + return getParameter(what); + + } else { + System.err.println("param() only works inside a web browser"); + } + return null; + } + + + /** + * Displays message in the browser's status area. This is the text area in the lower left corner of the browser. + * The status() function will only work when the Processing program is running in a web browser. + * =advanced + * Show status in the status bar of a web browser, or in the + * System.out console. Eventually this might show status in the + * p5 environment itself, rather than relying on the console. + * + * @webref input:web + * @usage Web + * @param what any valid String + */ + public void status(String what) { + if (online) { + showStatus(what); + + } else { + System.out.println(what); // something more interesting? + } + } + + + public void link(String here) { + link(here, null); + } + + + /** + * Links to a webpage either in the same window or in a new window. The complete URL must be specified. + * =advanced + * Link to an external page without all the muss. + *

+ * When run with an applet, uses the browser to open the url, + * for applications, attempts to launch a browser with the url. + *

+ * Works on Mac OS X and Windows. For Linux, use: + * 

open(new String[] { "firefox", url });
+ * or whatever you want as your browser, since Linux doesn't + * yet have a standard method for launching URLs. + * + * @webref input:web + * @param url complete url as a String in quotes + * @param frameTitle name of the window to load the URL as a string in quotes + * + */ + public void link(String url, String frameTitle) { + if (online) { + try { + if (frameTitle == null) { + getAppletContext().showDocument(new URL(url)); + } else { + getAppletContext().showDocument(new URL(url), frameTitle); + } + } catch (Exception e) { + e.printStackTrace(); + throw new RuntimeException("Could not open " + url); + } + } else { + try { + if (platform == WINDOWS) { + // the following uses a shell execute to launch the .html file + // note that under cygwin, the .html files have to be chmodded +x + // after they're unpacked from the zip file. i don't know why, + // and don't understand what this does in terms of windows + // permissions. without the chmod, the command prompt says + // "Access is denied" in both cygwin and the "dos" prompt. + //Runtime.getRuntime().exec("cmd /c " + currentDir + "\\reference\\" + + // referenceFile + ".html"); + + // replace ampersands with control sequence for DOS. + // solution contributed by toxi on the bugs board. + url = url.replaceAll("&","^&"); + + // open dos prompt, give it 'start' command, which will + // open the url properly. start by itself won't work since + // it appears to need cmd + Runtime.getRuntime().exec("cmd /c start " + url); + + } else if (platform == MACOSX) { + //com.apple.mrj.MRJFileUtils.openURL(url); + try { +// Class mrjFileUtils = Class.forName("com.apple.mrj.MRJFileUtils"); +// Method openMethod = +// mrjFileUtils.getMethod("openURL", new Class[] { String.class }); + Class eieio = Class.forName("com.apple.eio.FileManager"); + Method openMethod = + eieio.getMethod("openURL", new Class[] { String.class }); + openMethod.invoke(null, new Object[] { url }); + } catch (Exception e) { + e.printStackTrace(); + } + } else { + //throw new RuntimeException("Can't open URLs for this platform"); + // Just pass it off to open() and hope for the best + open(url); + } + } catch (IOException e) { + e.printStackTrace(); + throw new RuntimeException("Could not open " + url); + } + } + } + + + /** + * Attempts to open an application or file using your platform's launcher. The file parameter is a String specifying the file name and location. The location parameter must be a full path name, or the name of an executable in the system's PATH. In most cases, using a full path is the best option, rather than relying on the system PATH. Be sure to make the file executable before attempting to open it (chmod +x). + *

+ * The args 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, open("jikes -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 exec(String[]) function is a shortcut for Runtime.getRuntime.exec(String[]). + * + * @webref input:files + * @param filename name of the file + * @usage Application + */ + static public void open(String filename) { + open(new String[] { filename }); + } + + + static String openLauncher; + + /** + * Launch a process using a platforms shell. This version uses an array + * to make it easier to deal with spaces in the individual elements. + * (This avoids the situation of trying to put single or double quotes + * around different bits). + * + * @param list of commands passed to the command line + */ + static public Process open(String argv[]) { + String[] params = null; + + if (platform == WINDOWS) { + // just launching the .html file via the shell works + // but make sure to chmod +x the .html files first + // also place quotes around it in case there's a space + // in the user.dir part of the url + params = new String[] { "cmd", "/c" }; + + } else if (platform == MACOSX) { + params = new String[] { "open" }; + + } else if (platform == LINUX) { + if (openLauncher == null) { + // Attempt to use gnome-open + try { + Process p = Runtime.getRuntime().exec(new String[] { "gnome-open" }); + /*int result =*/ p.waitFor(); + // Not installed will throw an IOException (JDK 1.4.2, Ubuntu 7.04) + openLauncher = "gnome-open"; + } catch (Exception e) { } + } + if (openLauncher == null) { + // Attempt with kde-open + try { + Process p = Runtime.getRuntime().exec(new String[] { "kde-open" }); + /*int result =*/ p.waitFor(); + openLauncher = "kde-open"; + } catch (Exception e) { } + } + if (openLauncher == null) { + System.err.println("Could not find gnome-open or kde-open, " + + "the open() command may not work."); + } + if (openLauncher != null) { + params = new String[] { openLauncher }; + } + //} else { // give up and just pass it to Runtime.exec() + //open(new String[] { filename }); + //params = new String[] { filename }; + } + if (params != null) { + // If the 'open', 'gnome-open' or 'cmd' are already included + if (params[0].equals(argv[0])) { + // then don't prepend those params again + return exec(argv); + } else { + params = concat(params, argv); + return exec(params); + } + } else { + return exec(argv); + } + } + + + static public Process exec(String[] argv) { + try { + return Runtime.getRuntime().exec(argv); + } catch (Exception e) { + e.printStackTrace(); + throw new RuntimeException("Could not open " + join(argv, ' ')); + } + } + + + ////////////////////////////////////////////////////////////// + + + /** + * Function for an applet/application to kill itself and + * display an error. Mostly this is here to be improved later. + */ + public void die(String what) { + stop(); + throw new RuntimeException(what); + } + + + /** + * Same as above but with an exception. Also needs work. + */ + public void die(String what, Exception e) { + if (e != null) e.printStackTrace(); + die(what); + } + + + /** + * Call to safely exit the sketch when finished. For instance, + * to render a single frame, save it, and quit. + */ + public void exit() { + if (thread == null) { + // exit immediately, stop() has already been called, + // meaning that the main thread has long since exited + exit2(); + + } else if (looping) { + // stop() will be called as the thread exits + finished = true; + // tell the code to call exit2() to do a System.exit() + // once the next draw() has completed + exitCalled = true; + + } else if (!looping) { + // if not looping, need to call stop explicitly, + // because the main thread will be sleeping + stop(); + + // now get out + exit2(); + } + } + + + void exit2() { + try { + System.exit(0); + } catch (SecurityException e) { + // don't care about applet security exceptions + } + } + + + + ////////////////////////////////////////////////////////////// + + + public void method(String name) { +// final Object o = this; +// final Class c = getClass(); + try { + Method method = getClass().getMethod(name, new Class[] {}); + method.invoke(this, new Object[] { }); + + } catch (IllegalArgumentException e) { + e.printStackTrace(); + } catch (IllegalAccessException e) { + e.printStackTrace(); + } catch (InvocationTargetException e) { + e.getTargetException().printStackTrace(); + } catch (NoSuchMethodException nsme) { + System.err.println("There is no public " + name + "() method " + + "in the class " + getClass().getName()); + } catch (Exception e) { + e.printStackTrace(); + } + } + + + public void thread(final String name) { + Thread later = new Thread() { + public void run() { + method(name); + } + }; + later.start(); + } + + + /* + public void thread(String name) { + final Object o = this; + final Class c = getClass(); + try { + final Method method = c.getMethod(name, new Class[] {}); + Thread later = new Thread() { + public void run() { + try { + method.invoke(o, new Object[] { }); + + } catch (IllegalArgumentException e) { + e.printStackTrace(); + } catch (IllegalAccessException e) { + e.printStackTrace(); + } catch (InvocationTargetException e) { + e.getTargetException().printStackTrace(); + } + } + }; + later.start(); + + } catch (NoSuchMethodException nsme) { + System.err.println("There is no " + name + "() method " + + "in the class " + getClass().getName()); + + } catch (Exception e) { + e.printStackTrace(); + } + } + */ + + + + ////////////////////////////////////////////////////////////// + + // SCREEN GRABASS + + + /** + * Intercepts any relative paths to make them absolute (relative + * to the sketch folder) before passing to save() in PImage. + * (Changed in 0100) + */ + public void save(String filename) { + g.save(savePath(filename)); + } + + + /** + * Grab an image of what's currently in the drawing area and save it + * as a .tif or .tga file. + *

+ * Best used just before endDraw() at the end of your draw(). + * This can only create .tif or .tga images, so if neither extension + * is specified it defaults to writing a tiff and adds a .tif suffix. + */ + public void saveFrame() { + try { + g.save(savePath("screen-" + nf(frameCount, 4) + ".tif")); + } catch (SecurityException se) { + System.err.println("Can't use saveFrame() when running in a browser, " + + "unless using a signed applet."); + } + } + + + /** + * Save the current frame as a .tif or .tga image. + *

+ * The String passed in can contain a series of # signs + * that will be replaced with the screengrab number. + * 

+   * i.e. saveFrame("blah-####.tif");
+   *      // saves a numbered tiff image, replacing the
+   *      // #### signs with zeros and the frame number
+ */ + public void saveFrame(String what) { + try { + g.save(savePath(insertFrame(what))); + } catch (SecurityException se) { + System.err.println("Can't use saveFrame() when running in a browser, " + + "unless using a signed applet."); + } + } + + + /** + * Check a string for #### signs to see if the frame number should be + * inserted. Used for functions like saveFrame() and beginRecord() to + * replace the # marks with the frame number. If only one # is used, + * it will be ignored, under the assumption that it's probably not + * intended to be the frame number. + */ + protected String insertFrame(String what) { + int first = what.indexOf('#'); + int last = what.lastIndexOf('#'); + + if ((first != -1) && (last - first > 0)) { + String prefix = what.substring(0, first); + int count = last - first + 1; + String suffix = what.substring(last + 1); + return prefix + nf(frameCount, count) + suffix; + } + return what; // no change + } + + + + ////////////////////////////////////////////////////////////// + + // CURSOR + + // + + + int cursorType = ARROW; // cursor type + boolean cursorVisible = true; // cursor visibility flag + PImage invisibleCursor; + + + /** + * Set the cursor type + * @param cursorType either ARROW, CROSS, HAND, MOVE, TEXT, WAIT + */ + public void cursor(int cursorType) { + setCursor(Cursor.getPredefinedCursor(cursorType)); + cursorVisible = true; + this.cursorType = cursorType; + } + + + /** + * Replace the cursor with the specified PImage. The x- and y- + * coordinate of the center will be the center of the image. + */ + public void cursor(PImage image) { + cursor(image, image.width/2, image.height/2); + } + + + /** + * Sets the cursor to a predefined symbol, an image, or turns it on if already hidden. + * If you are trying to set an image as the cursor, it is recommended to make the size 16x16 or 32x32 pixels. + * It is not possible to load an image as the cursor if you are exporting your program for the Web. + * The values for parameters x and y must be less than the dimensions of the image. + * =advanced + * Set a custom cursor to an image with a specific hotspot. + * Only works with JDK 1.2 and later. + * Currently seems to be broken on Java 1.4 for Mac OS X + *

+ * Based on code contributed by Amit Pitaru, plus additional + * code to handle Java versions via reflection by Jonathan Feinberg. + * Reflection removed for release 0128 and later. + * @webref environment + * @see PApplet#noCursor() + * @param image any variable of type PImage + * @param hotspotX the horizonal active spot of the cursor + * @param hotspotY the vertical active spot of the cursor + */ + public void cursor(PImage image, int hotspotX, int hotspotY) { + // don't set this as cursor type, instead use cursor_type + // to save the last cursor used in case cursor() is called + //cursor_type = Cursor.CUSTOM_CURSOR; + Image jimage = + createImage(new MemoryImageSource(image.width, image.height, + image.pixels, 0, image.width)); + Point hotspot = new Point(hotspotX, hotspotY); + Toolkit tk = Toolkit.getDefaultToolkit(); + Cursor cursor = tk.createCustomCursor(jimage, hotspot, "Custom Cursor"); + setCursor(cursor); + cursorVisible = true; + } + + + /** + * Show the cursor after noCursor() was called. + * Notice that the program remembers the last set cursor type + */ + public void cursor() { + // maybe should always set here? seems dangerous, since + // it's likely that java will set the cursor to something + // else on its own, and the applet will be stuck b/c bagel + // thinks that the cursor is set to one particular thing + if (!cursorVisible) { + cursorVisible = true; + setCursor(Cursor.getPredefinedCursor(cursorType)); + } + } + + + /** + * Hides the cursor from view. Will not work when running the program in a web browser. + * =advanced + * Hide the cursor by creating a transparent image + * and using it as a custom cursor. + * @webref environment + * @see PApplet#cursor() + * @usage Application + */ + public void noCursor() { + if (!cursorVisible) return; // don't hide if already hidden. + + if (invisibleCursor == null) { + invisibleCursor = new PImage(16, 16, ARGB); + } + // was formerly 16x16, but the 0x0 was added by jdf as a fix + // for macosx, which wasn't honoring the invisible cursor + cursor(invisibleCursor, 8, 8); + cursorVisible = false; + } + + + ////////////////////////////////////////////////////////////// + + + static public void print(byte what) { + System.out.print(what); + System.out.flush(); + } + + static public void print(boolean what) { + System.out.print(what); + System.out.flush(); + } + + static public void print(char what) { + System.out.print(what); + System.out.flush(); + } + + static public void print(int what) { + System.out.print(what); + System.out.flush(); + } + + static public void print(float what) { + System.out.print(what); + System.out.flush(); + } + + static public void print(String what) { + System.out.print(what); + System.out.flush(); + } + + static public void print(Object what) { + if (what == null) { + // special case since this does fuggly things on > 1.1 + System.out.print("null"); + } else { + System.out.println(what.toString()); + } + } + + // + + static public void println() { + System.out.println(); + } + + // + + static public void println(byte what) { + print(what); System.out.println(); + } + + static public void println(boolean what) { + print(what); System.out.println(); + } + + static public void println(char what) { + print(what); System.out.println(); + } + + static public void println(int what) { + print(what); System.out.println(); + } + + static public void println(float what) { + print(what); System.out.println(); + } + + static public void println(String what) { + print(what); System.out.println(); + } + + static public void println(Object what) { + if (what == null) { + // special case since this does fuggly things on > 1.1 + System.out.println("null"); + + } else { + String name = what.getClass().getName(); + if (name.charAt(0) == '[') { + switch (name.charAt(1)) { + case '[': + // don't even mess with multi-dimensional arrays (case '[') + // or anything else that's not int, float, boolean, char + System.out.println(what); + break; + + case 'L': + // print a 1D array of objects as individual elements + Object poo[] = (Object[]) what; + for (int i = 0; i < poo.length; i++) { + if (poo[i] instanceof String) { + System.out.println("[" + i + "] \"" + poo[i] + "\""); + } else { + System.out.println("[" + i + "] " + poo[i]); + } + } + break; + + case 'Z': // boolean + boolean zz[] = (boolean[]) what; + for (int i = 0; i < zz.length; i++) { + System.out.println("[" + i + "] " + zz[i]); + } + break; + + case 'B': // byte + byte bb[] = (byte[]) what; + for (int i = 0; i < bb.length; i++) { + System.out.println("[" + i + "] " + bb[i]); + } + break; + + case 'C': // char + char cc[] = (char[]) what; + for (int i = 0; i < cc.length; i++) { + System.out.println("[" + i + "] '" + cc[i] + "'"); + } + break; + + case 'I': // int + int ii[] = (int[]) what; + for (int i = 0; i < ii.length; i++) { + System.out.println("[" + i + "] " + ii[i]); + } + break; + + case 'F': // float + float ff[] = (float[]) what; + for (int i = 0; i < ff.length; i++) { + System.out.println("[" + i + "] " + ff[i]); + } + break; + + /* + case 'D': // double + double dd[] = (double[]) what; + for (int i = 0; i < dd.length; i++) { + System.out.println("[" + i + "] " + dd[i]); + } + break; + */ + + default: + System.out.println(what); + } + } else { // not an array + System.out.println(what); + } + } + } + + // + + /* + // not very useful, because it only works for public (and protected?) + // fields of a class, not local variables to methods + public void printvar(String name) { + try { + Field field = getClass().getDeclaredField(name); + println(name + " = " + field.get(this)); + } catch (Exception e) { + e.printStackTrace(); + } + } + */ + + + ////////////////////////////////////////////////////////////// + + // MATH + + // lots of convenience methods for math with floats. + // doubles are overkill for processing applets, and casting + // things all the time is annoying, thus the functions below. + + + static public final float abs(float n) { + return (n < 0) ? -n : n; + } + + static public final int abs(int n) { + return (n < 0) ? -n : n; + } + + static public final float sq(float a) { + return a*a; + } + + static public final float sqrt(float a) { + return (float)Math.sqrt(a); + } + + static public final float log(float a) { + return (float)Math.log(a); + } + + static public final float exp(float a) { + return (float)Math.exp(a); + } + + static public final float pow(float a, float b) { + return (float)Math.pow(a, b); + } + + + static public final int max(int a, int b) { + return (a > b) ? a : b; + } + + static public final float max(float a, float b) { + return (a > b) ? a : b; + } + + /* + static public final double max(double a, double b) { + return (a > b) ? a : b; + } + */ + + + static public final int max(int a, int b, int c) { + return (a > b) ? ((a > c) ? a : c) : ((b > c) ? b : c); + } + + static public final float max(float a, float b, float c) { + return (a > b) ? ((a > c) ? a : c) : ((b > c) ? b : c); + } + + + /** + * Find the maximum value in an array. + * Throws an ArrayIndexOutOfBoundsException if the array is length 0. + * @param list the source array + * @return The maximum value + */ + static public final int max(int[] list) { + if (list.length == 0) { + throw new ArrayIndexOutOfBoundsException(ERROR_MIN_MAX); + } + int max = list[0]; + for (int i = 1; i < list.length; i++) { + if (list[i] > max) max = list[i]; + } + return max; + } + + /** + * Find the maximum value in an array. + * Throws an ArrayIndexOutOfBoundsException if the array is length 0. + * @param list the source array + * @return The maximum value + */ + static public final float max(float[] list) { + if (list.length == 0) { + throw new ArrayIndexOutOfBoundsException(ERROR_MIN_MAX); + } + float max = list[0]; + for (int i = 1; i < list.length; i++) { + if (list[i] > max) max = list[i]; + } + return max; + } + + + /** + * Find the maximum value in an array. + * Throws an ArrayIndexOutOfBoundsException if the array is length 0. + * @param list the source array + * @return The maximum value + */ + /* + static public final double max(double[] list) { + if (list.length == 0) { + throw new ArrayIndexOutOfBoundsException(ERROR_MIN_MAX); + } + double max = list[0]; + for (int i = 1; i < list.length; i++) { + if (list[i] > max) max = list[i]; + } + return max; + } + */ + + + static public final int min(int a, int b) { + return (a < b) ? a : b; + } + + static public final float min(float a, float b) { + return (a < b) ? a : b; + } + + /* + static public final double min(double a, double b) { + return (a < b) ? a : b; + } + */ + + + static public final int min(int a, int b, int c) { + return (a < b) ? ((a < c) ? a : c) : ((b < c) ? b : c); + } + + static public final float min(float a, float b, float c) { + return (a < b) ? ((a < c) ? a : c) : ((b < c) ? b : c); + } + + /* + static public final double min(double a, double b, double c) { + return (a < b) ? ((a < c) ? a : c) : ((b < c) ? b : c); + } + */ + + + /** + * Find the minimum value in an array. + * Throws an ArrayIndexOutOfBoundsException if the array is length 0. + * @param list the source array + * @return The minimum value + */ + static public final int min(int[] list) { + if (list.length == 0) { + throw new ArrayIndexOutOfBoundsException(ERROR_MIN_MAX); + } + int min = list[0]; + for (int i = 1; i < list.length; i++) { + if (list[i] < min) min = list[i]; + } + return min; + } + + + /** + * Find the minimum value in an array. + * Throws an ArrayIndexOutOfBoundsException if the array is length 0. + * @param list the source array + * @return The minimum value + */ + static public final float min(float[] list) { + if (list.length == 0) { + throw new ArrayIndexOutOfBoundsException(ERROR_MIN_MAX); + } + float min = list[0]; + for (int i = 1; i < list.length; i++) { + if (list[i] < min) min = list[i]; + } + return min; + } + + + /** + * Find the minimum value in an array. + * Throws an ArrayIndexOutOfBoundsException if the array is length 0. + * @param list the source array + * @return The minimum value + */ + /* + static public final double min(double[] list) { + if (list.length == 0) { + throw new ArrayIndexOutOfBoundsException(ERROR_MIN_MAX); + } + double min = list[0]; + for (int i = 1; i < list.length; i++) { + if (list[i] < min) min = list[i]; + } + return min; + } + */ + + static public final int constrain(int amt, int low, int high) { + return (amt < low) ? low : ((amt > high) ? high : amt); + } + + static public final float constrain(float amt, float low, float high) { + return (amt < low) ? low : ((amt > high) ? high : amt); + } + + + static public final float sin(float angle) { + return (float)Math.sin(angle); + } + + static public final float cos(float angle) { + return (float)Math.cos(angle); + } + + static public final float tan(float angle) { + return (float)Math.tan(angle); + } + + + static public final float asin(float value) { + return (float)Math.asin(value); + } + + static public final float acos(float value) { + return (float)Math.acos(value); + } + + static public final float atan(float value) { + return (float)Math.atan(value); + } + + static public final float atan2(float a, float b) { + return (float)Math.atan2(a, b); + } + + + static public final float degrees(float radians) { + return radians * RAD_TO_DEG; + } + + static public final float radians(float degrees) { + return degrees * DEG_TO_RAD; + } + + + static public final int ceil(float what) { + return (int) Math.ceil(what); + } + + static public final int floor(float what) { + return (int) Math.floor(what); + } + + static public final int round(float what) { + return (int) Math.round(what); + } + + + static public final float mag(float a, float b) { + return (float)Math.sqrt(a*a + b*b); + } + + static public final float mag(float a, float b, float c) { + return (float)Math.sqrt(a*a + b*b + c*c); + } + + + static public final float dist(float x1, float y1, float x2, float y2) { + return sqrt(sq(x2-x1) + sq(y2-y1)); + } + + static public final float dist(float x1, float y1, float z1, + float x2, float y2, float z2) { + return sqrt(sq(x2-x1) + sq(y2-y1) + sq(z2-z1)); + } + + + static public final float lerp(float start, float stop, float amt) { + return start + (stop-start) * amt; + } + + /** + * Normalize a value to exist between 0 and 1 (inclusive). + * Mathematically the opposite of lerp(), figures out what proportion + * a particular value is relative to start and stop coordinates. + */ + static public final float norm(float value, float start, float stop) { + return (value - start) / (stop - start); + } + + /** + * Convenience function to map a variable from one coordinate space + * to another. Equivalent to unlerp() followed by lerp(). + */ + static public final float map(float value, + float istart, float istop, + float ostart, float ostop) { + return ostart + (ostop - ostart) * ((value - istart) / (istop - istart)); + } + + + /* + static public final double map(double value, + double istart, double istop, + double ostart, double ostop) { + return ostart + (ostop - ostart) * ((value - istart) / (istop - istart)); + } + */ + + + + ////////////////////////////////////////////////////////////// + + // RANDOM NUMBERS + + + Random internalRandom; + + /** + * Return a random number in the range [0, howbig). + *

+ * The number returned will range from zero up to + * (but not including) 'howbig'. + */ + public final float random(float howbig) { + // for some reason (rounding error?) Math.random() * 3 + // can sometimes return '3' (once in ~30 million tries) + // so a check was added to avoid the inclusion of 'howbig' + + // avoid an infinite loop + if (howbig == 0) return 0; + + // internal random number object + if (internalRandom == null) internalRandom = new Random(); + + float value = 0; + do { + //value = (float)Math.random() * howbig; + value = internalRandom.nextFloat() * howbig; + } while (value == howbig); + return value; + } + + + /** + * Return a random number in the range [howsmall, howbig). + *

+ * The number returned will range from 'howsmall' up to + * (but not including 'howbig'. + *

+ * If howsmall is >= howbig, howsmall will be returned, + * meaning that random(5, 5) will return 5 (useful) + * and random(7, 4) will return 7 (not useful.. better idea?) + */ + public final float random(float howsmall, float howbig) { + if (howsmall >= howbig) return howsmall; + float diff = howbig - howsmall; + return random(diff) + howsmall; + } + + + public final void randomSeed(long what) { + // internal random number object + if (internalRandom == null) internalRandom = new Random(); + internalRandom.setSeed(what); + } + + + + ////////////////////////////////////////////////////////////// + + // PERLIN NOISE + + // [toxi 040903] + // octaves and amplitude amount per octave are now user controlled + // via the noiseDetail() function. + + // [toxi 030902] + // cleaned up code and now using bagel's cosine table to speed up + + // [toxi 030901] + // implementation by the german demo group farbrausch + // as used in their demo "art": http://www.farb-rausch.de/fr010src.zip + + static final int PERLIN_YWRAPB = 4; + static final int PERLIN_YWRAP = 1<>= 1; + } + + if (x<0) x=-x; + if (y<0) y=-y; + if (z<0) z=-z; + + int xi=(int)x, yi=(int)y, zi=(int)z; + float xf = (float)(x-xi); + float yf = (float)(y-yi); + float zf = (float)(z-zi); + float rxf, ryf; + + float r=0; + float ampl=0.5f; + + float n1,n2,n3; + + for (int i=0; i=1.0f) { xi++; xf--; } + if (yf>=1.0f) { yi++; yf--; } + if (zf>=1.0f) { zi++; zf--; } + } + return r; + } + + // [toxi 031112] + // now adjusts to the size of the cosLUT used via + // the new variables, defined above + private float noise_fsc(float i) { + // using bagel's cosine table instead + return 0.5f*(1.0f-perlin_cosTable[(int)(i*perlin_PI)%perlin_TWOPI]); + } + + // [toxi 040903] + // make perlin noise quality user controlled to allow + // for different levels of detail. lower values will produce + // smoother results as higher octaves are surpressed + + public void noiseDetail(int lod) { + if (lod>0) perlin_octaves=lod; + } + + public void noiseDetail(int lod, float falloff) { + if (lod>0) perlin_octaves=lod; + if (falloff>0) perlin_amp_falloff=falloff; + } + + public void noiseSeed(long what) { + if (perlinRandom == null) perlinRandom = new Random(); + perlinRandom.setSeed(what); + // force table reset after changing the random number seed [0122] + perlin = null; + } + + + + // . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . + + + protected String[] loadImageFormats; + + + /** + * Load an image from the data folder or a local directory. + * Supports .gif (including transparency), .tga, and .jpg images. + * In Java 1.3 or later, .png images are + * + * also supported. + *

+ * Generally, loadImage() should only be used during setup, because + * re-loading images inside draw() is likely to cause a significant + * delay while memory is allocated and the thread blocks while waiting + * for the image to load because loading is not asynchronous. + *

+ * To load several images asynchronously, see more information in the + * FAQ about writing your own threaded image loading method. + *

+ * As of 0096, returns null if no image of that name is found, + * rather than an error. + *

+ * Release 0115 also provides support for reading TIFF and RLE-encoded + * Targa (.tga) files written by Processing via save() and saveFrame(). + * Other TIFF and Targa files will probably not load, use a different + * format (gif, jpg and png are safest bets) when creating images with + * another application to use with Processing. + *

+ * Also in release 0115, more image formats (BMP and others) can + * be read when using Java 1.4 and later. Because many people still + * use Java 1.1 and 1.3, these formats are not recommended for + * work that will be posted on the web. To get a list of possible + * image formats for use with Java 1.4 and later, use the following: + * println(javax.imageio.ImageIO.getReaderFormatNames()) + *

+ * Images are loaded via a byte array that is passed to + * Toolkit.createImage(). Unfortunately, we cannot use Applet.getImage() + * because it takes a URL argument, which would be a pain in the a-- + * to make work consistently for online and local sketches. + * Sometimes this causes problems, resulting in issues like + * Bug 279 + * and + * Bug 305. + * In release 0115, everything was instead run through javax.imageio, + * but that turned out to be very slow, see + * Bug 392. + * As a result, starting with 0116, the following happens: + *

    + *
  • TGA and TIFF images are loaded using the internal load methods. + *
  • JPG, GIF, and PNG images are loaded via loadBytes(). + *
  • If the image still isn't loaded, it's passed to javax.imageio. + *
+ * For releases 0116 and later, if you have problems such as those seen + * in Bugs 279 and 305, use Applet.getImage() instead. You'll be stuck + * with the limitations of getImage() (the headache of dealing with + * online/offline use). Set up your own MediaTracker, and pass the resulting + * java.awt.Image to the PImage constructor that takes an AWT image. + */ + public PImage loadImage(String filename) { + return loadImage(filename, null); + } + + + /** + * Loads an image into a variable of type PImage. Four types of images ( .gif, .jpg, .tga, .png) images may be loaded. To load correctly, images must be located in the data directory of the current sketch. In most cases, load all images in setup() to preload them at the start of the program. Loading images inside draw() will reduce the speed of a program. + *

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 signed applet. + *

The extension parameter is used to determine the image type in cases where the image filename does not end with a proper extension. Specify the extension as the second parameter to loadImage(), as shown in the third example on this page. + *

If an image is not loaded successfully, the null value is 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 from loadImage() is null.

Depending on the type of error, a PImage object may still be returned, but the width and height of the image will be set to -1. This happens if bad image data is returned or cannot be decoded properly. Sometimes this happens with image URLs that produce a 403 error or that redirect to a password prompt, because loadImage() will attempt to interpret the HTML as image data. + * + * =advanced + * Identical to loadImage, but allows you to specify the type of + * image by its extension. Especially useful when downloading from + * CGI scripts. + *

+ * Use 'unknown' as the extension to pass off to the default + * image loader that handles gif, jpg, and png. + * + * @webref image:loading_displaying + * @param filename name of file to load, can be .gif, .jpg, .tga, or a handful of other image types depending on your platform. + * @param extension the type of image to load, for example "png", "gif", "jpg" + * + * @see processing.core.PImage + * @see processing.core.PApplet#image(PImage, float, float, float, float) + * @see processing.core.PApplet#imageMode(int) + * @see processing.core.PApplet#background(float, float, float) + */ + public PImage loadImage(String filename, String extension) { + if (extension == null) { + String lower = filename.toLowerCase(); + int dot = filename.lastIndexOf('.'); + if (dot == -1) { + extension = "unknown"; // no extension found + } + extension = lower.substring(dot + 1); + + // check for, and strip any parameters on the url, i.e. + // filename.jpg?blah=blah&something=that + int question = extension.indexOf('?'); + if (question != -1) { + extension = extension.substring(0, question); + } + } + + // just in case. them users will try anything! + extension = extension.toLowerCase(); + + if (extension.equals("tga")) { + try { + return loadImageTGA(filename); + } catch (IOException e) { + e.printStackTrace(); + return null; + } + } + + if (extension.equals("tif") || extension.equals("tiff")) { + byte bytes[] = loadBytes(filename); + return (bytes == null) ? null : PImage.loadTIFF(bytes); + } + + // For jpeg, gif, and png, load them using createImage(), + // because the javax.imageio code was found to be much slower, see + // Bug 392. + try { + if (extension.equals("jpg") || extension.equals("jpeg") || + extension.equals("gif") || extension.equals("png") || + extension.equals("unknown")) { + byte bytes[] = loadBytes(filename); + if (bytes == null) { + return null; + } else { + Image awtImage = Toolkit.getDefaultToolkit().createImage(bytes); + PImage image = loadImageMT(awtImage); + if (image.width == -1) { + System.err.println("The file " + filename + + " contains bad image data, or may not be an image."); + } + // if it's a .gif image, test to see if it has transparency + if (extension.equals("gif") || extension.equals("png")) { + image.checkAlpha(); + } + return image; + } + } + } catch (Exception e) { + // show error, but move on to the stuff below, see if it'll work + e.printStackTrace(); + } + + if (loadImageFormats == null) { + loadImageFormats = ImageIO.getReaderFormatNames(); + } + if (loadImageFormats != null) { + for (int i = 0; i < loadImageFormats.length; i++) { + if (extension.equals(loadImageFormats[i])) { + return loadImageIO(filename); + } + } + } + + // failed, could not load image after all those attempts + System.err.println("Could not find a method to load " + filename); + return null; + } + + public PImage requestImage(String filename) { + return requestImage(filename, null); + } + + + /** + * This function load images on a separate thread so that your sketch does not freeze while images load during setup(). While the image is loading, its width and height will be 0. If an error occurs while loading the image, its width and height will be set to -1. You'll know when the image has loaded properly because its width and height will be greater than 0. Asynchronous image loading (particularly when downloading from a server) can dramatically improve performance.

+ * The extension parameter is used to determine the image type in cases where the image filename does not end with a proper extension. Specify the extension as the second parameter to requestImage(). + * + * @webref image:loading_displaying + * @param filename name of file to load, can be .gif, .jpg, .tga, or a handful of other image types depending on your platform + * @param extension the type of image to load, for example "png", "gif", "jpg" + * + * @see processing.core.PApplet#loadImage(String, String) + * @see processing.core.PImage + */ + public PImage requestImage(String filename, String extension) { + PImage vessel = createImage(0, 0, ARGB); + AsyncImageLoader ail = + new AsyncImageLoader(filename, extension, vessel); + ail.start(); + return vessel; + } + + + /** + * By trial and error, four image loading threads seem to work best when + * loading images from online. This is consistent with the number of open + * connections that web browsers will maintain. The variable is made public + * (however no accessor has been added since it's esoteric) if you really + * want to have control over the value used. For instance, when loading local + * files, it might be better to only have a single thread (or two) loading + * images so that you're disk isn't simply jumping around. + */ + public int requestImageMax = 4; + volatile int requestImageCount; + + class AsyncImageLoader extends Thread { + String filename; + String extension; + PImage vessel; + + public AsyncImageLoader(String filename, String extension, PImage vessel) { + this.filename = filename; + this.extension = extension; + this.vessel = vessel; + } + + public void run() { + while (requestImageCount == requestImageMax) { + try { + Thread.sleep(10); + } catch (InterruptedException e) { } + } + requestImageCount++; + + PImage actual = loadImage(filename, extension); + + // An error message should have already printed + if (actual == null) { + vessel.width = -1; + vessel.height = -1; + + } else { + vessel.width = actual.width; + vessel.height = actual.height; + vessel.format = actual.format; + vessel.pixels = actual.pixels; + } + requestImageCount--; + } + } + + + /** + * Load an AWT image synchronously by setting up a MediaTracker for + * a single image, and blocking until it has loaded. + */ + protected PImage loadImageMT(Image awtImage) { + MediaTracker tracker = new MediaTracker(this); + tracker.addImage(awtImage, 0); + try { + tracker.waitForAll(); + } catch (InterruptedException e) { + //e.printStackTrace(); // non-fatal, right? + } + + PImage image = new PImage(awtImage); + image.parent = this; + return image; + } + + + /** + * Use Java 1.4 ImageIO methods to load an image. + */ + protected PImage loadImageIO(String filename) { + InputStream stream = createInput(filename); + if (stream == null) { + System.err.println("The image " + filename + " could not be found."); + return null; + } + + try { + BufferedImage bi = ImageIO.read(stream); + PImage outgoing = new PImage(bi.getWidth(), bi.getHeight()); + outgoing.parent = this; + + bi.getRGB(0, 0, outgoing.width, outgoing.height, + outgoing.pixels, 0, outgoing.width); + + // check the alpha for this image + // was gonna call getType() on the image to see if RGB or ARGB, + // but it's not actually useful, since gif images will come through + // as TYPE_BYTE_INDEXED, which means it'll still have to check for + // the transparency. also, would have to iterate through all the other + // types and guess whether alpha was in there, so.. just gonna stick + // with the old method. + outgoing.checkAlpha(); + + // return the image + return outgoing; + + } catch (Exception e) { + e.printStackTrace(); + return null; + } + } + + + /** + * Targa image loader for RLE-compressed TGA files. + *

+ * Rewritten for 0115 to read/write RLE-encoded targa images. + * For 0125, non-RLE encoded images are now supported, along with + * images whose y-order is reversed (which is standard for TGA files). + */ + protected PImage loadImageTGA(String filename) throws IOException { + InputStream is = createInput(filename); + if (is == null) return null; + + byte header[] = new byte[18]; + int offset = 0; + do { + int count = is.read(header, offset, header.length - offset); + if (count == -1) return null; + offset += count; + } while (offset < 18); + + /* + header[2] image type code + 2 (0x02) - Uncompressed, RGB images. + 3 (0x03) - Uncompressed, black and white images. + 10 (0x0A) - Runlength encoded RGB images. + 11 (0x0B) - Compressed, black and white images. (grayscale?) + + header[16] is the bit depth (8, 24, 32) + + header[17] image descriptor (packed bits) + 0x20 is 32 = origin upper-left + 0x28 is 32 + 8 = origin upper-left + 32 bits + + 7 6 5 4 3 2 1 0 + 128 64 32 16 8 4 2 1 + */ + + int format = 0; + + if (((header[2] == 3) || (header[2] == 11)) && // B&W, plus RLE or not + (header[16] == 8) && // 8 bits + ((header[17] == 0x8) || (header[17] == 0x28))) { // origin, 32 bit + format = ALPHA; + + } else if (((header[2] == 2) || (header[2] == 10)) && // RGB, RLE or not + (header[16] == 24) && // 24 bits + ((header[17] == 0x20) || (header[17] == 0))) { // origin + format = RGB; + + } else if (((header[2] == 2) || (header[2] == 10)) && + (header[16] == 32) && + ((header[17] == 0x8) || (header[17] == 0x28))) { // origin, 32 + format = ARGB; + } + + if (format == 0) { + System.err.println("Unknown .tga file format for " + filename); + //" (" + header[2] + " " + + //(header[16] & 0xff) + " " + + //hex(header[17], 2) + ")"); + return null; + } + + int w = ((header[13] & 0xff) << 8) + (header[12] & 0xff); + int h = ((header[15] & 0xff) << 8) + (header[14] & 0xff); + PImage outgoing = createImage(w, h, format); + + // where "reversed" means upper-left corner (normal for most of + // the modernized world, but "reversed" for the tga spec) + boolean reversed = (header[17] & 0x20) != 0; + + if ((header[2] == 2) || (header[2] == 3)) { // not RLE encoded + if (reversed) { + int index = (h-1) * w; + switch (format) { + case ALPHA: + for (int y = h-1; y >= 0; y--) { + for (int x = 0; x < w; x++) { + outgoing.pixels[index + x] = is.read(); + } + index -= w; + } + break; + case RGB: + for (int y = h-1; y >= 0; y--) { + for (int x = 0; x < w; x++) { + outgoing.pixels[index + x] = + is.read() | (is.read() << 8) | (is.read() << 16) | + 0xff000000; + } + index -= w; + } + break; + case ARGB: + for (int y = h-1; y >= 0; y--) { + for (int x = 0; x < w; x++) { + outgoing.pixels[index + x] = + is.read() | (is.read() << 8) | (is.read() << 16) | + (is.read() << 24); + } + index -= w; + } + } + } else { // not reversed + int count = w * h; + switch (format) { + case ALPHA: + for (int i = 0; i < count; i++) { + outgoing.pixels[i] = is.read(); + } + break; + case RGB: + for (int i = 0; i < count; i++) { + outgoing.pixels[i] = + is.read() | (is.read() << 8) | (is.read() << 16) | + 0xff000000; + } + break; + case ARGB: + for (int i = 0; i < count; i++) { + outgoing.pixels[i] = + is.read() | (is.read() << 8) | (is.read() << 16) | + (is.read() << 24); + } + break; + } + } + + } else { // header[2] is 10 or 11 + int index = 0; + int px[] = outgoing.pixels; + + while (index < px.length) { + int num = is.read(); + boolean isRLE = (num & 0x80) != 0; + if (isRLE) { + num -= 127; // (num & 0x7F) + 1 + int pixel = 0; + switch (format) { + case ALPHA: + pixel = is.read(); + break; + case RGB: + pixel = 0xFF000000 | + is.read() | (is.read() << 8) | (is.read() << 16); + //(is.read() << 16) | (is.read() << 8) | is.read(); + break; + case ARGB: + pixel = is.read() | + (is.read() << 8) | (is.read() << 16) | (is.read() << 24); + break; + } + for (int i = 0; i < num; i++) { + px[index++] = pixel; + if (index == px.length) break; + } + } else { // write up to 127 bytes as uncompressed + num += 1; + switch (format) { + case ALPHA: + for (int i = 0; i < num; i++) { + px[index++] = is.read(); + } + break; + case RGB: + for (int i = 0; i < num; i++) { + px[index++] = 0xFF000000 | + is.read() | (is.read() << 8) | (is.read() << 16); + //(is.read() << 16) | (is.read() << 8) | is.read(); + } + break; + case ARGB: + for (int i = 0; i < num; i++) { + px[index++] = is.read() | //(is.read() << 24) | + (is.read() << 8) | (is.read() << 16) | (is.read() << 24); + //(is.read() << 16) | (is.read() << 8) | is.read(); + } + break; + } + } + } + + if (!reversed) { + int[] temp = new int[w]; + for (int y = 0; y < h/2; y++) { + int z = (h-1) - y; + System.arraycopy(px, y*w, temp, 0, w); + System.arraycopy(px, z*w, px, y*w, w); + System.arraycopy(temp, 0, px, z*w, w); + } + } + } + + return outgoing; + } + + + + ////////////////////////////////////////////////////////////// + + // SHAPE I/O + + + /** + * Loads vector shapes into a variable of type PShape. Currently, only SVG files may be loaded. + * To load correctly, the file must be located in the data directory of the current sketch. + * In most cases, loadShape() should be used inside setup() because loading shapes inside draw() will reduce the speed of a sketch. + *

+ * 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 signed applet. + *

+ * If a shape is not loaded successfully, the null value is 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 from loadShape() is null. + * + * @webref shape:loading_displaying + * @see PShape + * @see PApplet#shape(PShape) + * @see PApplet#shapeMode(int) + */ + public PShape loadShape(String filename) { + if (filename.toLowerCase().endsWith(".svg")) { + return new PShapeSVG(this, filename); + } + return null; + } + + + + ////////////////////////////////////////////////////////////// + + // FONT I/O + + + public PFont loadFont(String filename) { + try { + InputStream input = createInput(filename); + return new PFont(input); + + } catch (Exception e) { + die("Could not load font " + filename + ". " + + "Make sure that the font has been copied " + + "to the data folder of your sketch.", e); + } + return null; + } + + + public PFont createFont(String name, float size) { + return createFont(name, size, true, PFont.DEFAULT_CHARSET); + } + + + public PFont createFont(String name, float size, boolean smooth) { + return createFont(name, size, smooth, PFont.DEFAULT_CHARSET); + } + + + /** + * Create a .vlw font on the fly from either a font name that's + * installed on the system, or from a .ttf or .otf that's inside + * the data folder of this sketch. + *

+ * Only works with Java 1.3 or later. Many .otf fonts don't seem + * to be supported by Java, perhaps because they're CFF based? + *

+ * Font names are inconsistent across platforms and Java versions. + * On Mac OS X, Java 1.3 uses the font menu name of the font, + * whereas Java 1.4 uses the PostScript name of the font. Java 1.4 + * on OS X will also accept the font menu name as well. On Windows, + * it appears that only the menu names are used, no matter what + * Java version is in use. Naming system unknown/untested for 1.5. + *

+ * Use 'null' for the charset if you want to use any of the 65,536 + * unicode characters that exist in the font. Note that this can + * produce an enormous file or may cause an OutOfMemoryError. + */ + public PFont createFont(String name, float size, + boolean smooth, char charset[]) { + String lowerName = name.toLowerCase(); + Font baseFont = null; + + try { + if (lowerName.endsWith(".otf") || lowerName.endsWith(".ttf")) { + InputStream stream = createInput(name); + if (stream == null) { + System.err.println("The font \"" + name + "\" " + + "is missing or inaccessible, make sure " + + "the URL is valid or that the file has been " + + "added to your sketch and is readable."); + return null; + } + baseFont = Font.createFont(Font.TRUETYPE_FONT, createInput(name)); + + } else { + //baseFont = new Font(name, Font.PLAIN, 1); + baseFont = PFont.findFont(name); + } + } catch (Exception e) { + System.err.println("Problem using createFont() with " + name); + e.printStackTrace(); + } + return new PFont(baseFont.deriveFont(size), smooth, charset); + } + + + + ////////////////////////////////////////////////////////////// + + // FILE/FOLDER SELECTION + + + public File selectedFile; + protected Frame parentFrame; + + + protected void checkParentFrame() { + if (parentFrame == null) { + Component comp = getParent(); + while (comp != null) { + if (comp instanceof Frame) { + parentFrame = (Frame) comp; + break; + } + comp = comp.getParent(); + } + // Who you callin' a hack? + if (parentFrame == null) { + parentFrame = new Frame(); + } + } + } + + + /** + * Open a platform-specific file chooser dialog to select a file for input. + * @return full path to the selected file, or null if no selection. + */ + public String selectInput() { + return selectInput("Select a file..."); + } + + + /** + * Opens a platform-specific file chooser dialog to select a file for input. This function returns the full path to the selected file as a String, or null if no selection. + * + * @webref input:files + * @param prompt message you want the user to see in the file chooser + * @return full path to the selected file, or null if canceled. + * + * @see processing.core.PApplet#selectOutput(String) + * @see processing.core.PApplet#selectFolder(String) + */ + public String selectInput(String prompt) { + return selectFileImpl(prompt, FileDialog.LOAD); + } + + + /** + * Open a platform-specific file save dialog to select a file for output. + * @return full path to the file entered, or null if canceled. + */ + public String selectOutput() { + return selectOutput("Save as..."); + } + + + /** + * Open a platform-specific file save dialog to create of select a file for output. + * This function returns the full path to the selected file as a String, or null if no selection. + * If you select an existing file, that file will be replaced. + * Alternatively, you can navigate to a folder and create a new file to write to. + * + * @param prompt message you want the user to see in the file chooser + * @return full path to the file entered, or null if canceled. + * + * @webref input:files + * @see processing.core.PApplet#selectInput(String) + * @see processing.core.PApplet#selectFolder(String) + */ + public String selectOutput(String prompt) { + return selectFileImpl(prompt, FileDialog.SAVE); + } + + + protected String selectFileImpl(final String prompt, final int mode) { + checkParentFrame(); + + try { + SwingUtilities.invokeAndWait(new Runnable() { + public void run() { + FileDialog fileDialog = + new FileDialog(parentFrame, prompt, mode); + fileDialog.setVisible(true); + String directory = fileDialog.getDirectory(); + String filename = fileDialog.getFile(); + selectedFile = + (filename == null) ? null : new File(directory, filename); + } + }); + return (selectedFile == null) ? null : selectedFile.getAbsolutePath(); + + } catch (Exception e) { + e.printStackTrace(); + return null; + } + } + + + public String selectFolder() { + return selectFolder("Select a folder..."); + } + + + /** + * Opens a platform-specific file chooser dialog to select a folder for input. + * This function returns the full path to the selected folder as a String, or null if no selection. + * + * @webref input:files + * @param prompt message you want the user to see in the file chooser + * @return full path to the selected folder, or null if no selection. + * + * @see processing.core.PApplet#selectOutput(String) + * @see processing.core.PApplet#selectInput(String) + */ + public String selectFolder(final String prompt) { + checkParentFrame(); + + try { + SwingUtilities.invokeAndWait(new Runnable() { + public void run() { + if (platform == MACOSX) { + FileDialog fileDialog = + new FileDialog(parentFrame, prompt, FileDialog.LOAD); + System.setProperty("apple.awt.fileDialogForDirectories", "true"); + fileDialog.setVisible(true); + System.setProperty("apple.awt.fileDialogForDirectories", "false"); + String filename = fileDialog.getFile(); + selectedFile = (filename == null) ? null : + new File(fileDialog.getDirectory(), fileDialog.getFile()); + } else { + JFileChooser fileChooser = new JFileChooser(); + fileChooser.setDialogTitle(prompt); + fileChooser.setFileSelectionMode(JFileChooser.DIRECTORIES_ONLY); + + int returned = fileChooser.showOpenDialog(parentFrame); + System.out.println(returned); + if (returned == JFileChooser.CANCEL_OPTION) { + selectedFile = null; + } else { + selectedFile = fileChooser.getSelectedFile(); + } + } + } + }); + return (selectedFile == null) ? null : selectedFile.getAbsolutePath(); + + } catch (Exception e) { + e.printStackTrace(); + return null; + } + } + + + + ////////////////////////////////////////////////////////////// + + // READERS AND WRITERS + + + /** + * I want to read lines from a file. I have RSI from typing these + * eight lines of code so many times. + */ + public BufferedReader createReader(String filename) { + try { + InputStream is = createInput(filename); + if (is == null) { + System.err.println(filename + " does not exist or could not be read"); + return null; + } + return createReader(is); + + } catch (Exception e) { + if (filename == null) { + System.err.println("Filename passed to reader() was null"); + } else { + System.err.println("Couldn't create a reader for " + filename); + } + } + return null; + } + + + /** + * I want to read lines from a file. And I'm still annoyed. + */ + static public BufferedReader createReader(File file) { + try { + InputStream is = new FileInputStream(file); + if (file.getName().toLowerCase().endsWith(".gz")) { + is = new GZIPInputStream(is); + } + return createReader(is); + + } catch (Exception e) { + if (file == null) { + throw new RuntimeException("File passed to createReader() was null"); + } else { + e.printStackTrace(); + throw new RuntimeException("Couldn't create a reader for " + + file.getAbsolutePath()); + } + } + //return null; + } + + + /** + * I want to read lines from a stream. If I have to type the + * following lines any more I'm gonna send Sun my medical bills. + */ + static public BufferedReader createReader(InputStream input) { + InputStreamReader isr = null; + try { + isr = new InputStreamReader(input, "UTF-8"); + } catch (UnsupportedEncodingException e) { } // not gonna happen + return new BufferedReader(isr); + } + + + /** + * I want to print lines to a file. Why can't I? + */ + public PrintWriter createWriter(String filename) { + return createWriter(saveFile(filename)); + } + + + /** + * I want to print lines to a file. I have RSI from typing these + * eight lines of code so many times. + */ + static public PrintWriter createWriter(File file) { + try { + createPath(file); // make sure in-between folders exist + OutputStream output = new FileOutputStream(file); + if (file.getName().toLowerCase().endsWith(".gz")) { + output = new GZIPOutputStream(output); + } + return createWriter(output); + + } catch (Exception e) { + if (file == null) { + throw new RuntimeException("File passed to createWriter() was null"); + } else { + e.printStackTrace(); + throw new RuntimeException("Couldn't create a writer for " + + file.getAbsolutePath()); + } + } + //return null; + } + + + /** + * I want to print lines to a file. Why am I always explaining myself? + * It's the JavaSoft API engineers who need to explain themselves. + */ + static public PrintWriter createWriter(OutputStream output) { + try { + OutputStreamWriter osw = new OutputStreamWriter(output, "UTF-8"); + return new PrintWriter(osw); + } catch (UnsupportedEncodingException e) { } // not gonna happen + return null; + } + + + ////////////////////////////////////////////////////////////// + + // FILE INPUT + + + /** + * @deprecated As of release 0136, use createInput() instead. + */ + public InputStream openStream(String filename) { + return createInput(filename); + } + + + /** + * This is a method for advanced programmers to open a Java InputStream. The method is useful if you want to use the facilities provided by PApplet to easily open files from the data folder or from a URL, but want an InputStream object so that you can use other Java methods to take more control of how the stream is read. + *

If the requested item doesn't exist, null is returned. + *

In earlier releases, this method was called openStream(). + *

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 will be printed to the console. This helps prevent issues that appear 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. + *

The filename passed in can be:
+ * - A URL, for instance openStream("http://processing.org/");
+ * - A file in the sketch's data folder
+ * - The full path to a file to be opened locally (when running as an application) + *

+ * If the file ends with .gz, the stream will automatically be gzip decompressed. If you don't want the automatic decompression, use the related function createInputRaw(). + * + * =advanced + * Simplified method to open a Java InputStream. + *

+ * This method is useful if you want to use the facilities provided + * by PApplet to easily open things from the data folder or from a URL, + * but want an InputStream object so that you can use other Java + * methods to take more control of how the stream is read. + *

+ * If the requested item doesn't exist, null is returned. + * (Prior to 0096, die() would be called, killing the applet) + *

+ * For 0096+, the "data" folder is exported intact with subfolders, + * and openStream() properly handles subdirectories from the data folder + *

+ * If not online, this will also check to see if the user is asking + * for a file whose name isn't properly capitalized. This helps prevent + * issues when a sketch is exported to the web, where case sensitivity + * matters, as opposed to Windows and the Mac OS default where + * case sensitivity is preserved but ignored. + *

+ * It is strongly recommended that libraries use this method to open + * data files, so that the loading sequence is handled in the same way + * as functions like loadBytes(), loadImage(), etc. + *

+ * The filename passed in can be: + *

    + *
  • A URL, for instance openStream("http://processing.org/"); + *
  • A file in the sketch's data folder + *
  • Another file to be opened locally (when running as an application) + *
+ * + * @webref input:files + * @see processing.core.PApplet#createOutput(String) + * @see processing.core.PApplet#selectOutput(String) + * @see processing.core.PApplet#selectInput(String) + * + * @param filename the name of the file to use as input + * + */ + public InputStream createInput(String filename) { + InputStream input = createInputRaw(filename); + if ((input != null) && filename.toLowerCase().endsWith(".gz")) { + try { + return new GZIPInputStream(input); + } catch (IOException e) { + e.printStackTrace(); + return null; + } + } + return input; + } + + + /** + * Call openStream() without automatic gzip decompression. + */ + public InputStream createInputRaw(String filename) { + InputStream stream = null; + + if (filename == null) return null; + + if (filename.length() == 0) { + // an error will be called by the parent function + //System.err.println("The filename passed to openStream() was empty."); + return null; + } + + // safe to check for this as a url first. this will prevent online + // access logs from being spammed with GET /sketchfolder/http://blahblah + if (filename.indexOf(":") != -1) { // at least smells like URL + try { + URL url = new URL(filename); + stream = url.openStream(); + return stream; + + } catch (MalformedURLException mfue) { + // not a url, that's fine + + } catch (FileNotFoundException fnfe) { + // Java 1.5 likes to throw this when URL not available. (fix for 0119) + // http://dev.processing.org/bugs/show_bug.cgi?id=403 + + } catch (IOException e) { + // changed for 0117, shouldn't be throwing exception + e.printStackTrace(); + //System.err.println("Error downloading from URL " + filename); + return null; + //throw new RuntimeException("Error downloading from URL " + filename); + } + } + + // Moved this earlier than the getResourceAsStream() checks, because + // calling getResourceAsStream() on a directory lists its contents. + // http://dev.processing.org/bugs/show_bug.cgi?id=716 + try { + // First see if it's in a data folder. This may fail by throwing + // a SecurityException. If so, this whole block will be skipped. + File file = new File(dataPath(filename)); + if (!file.exists()) { + // next see if it's just in the sketch folder + file = new File(sketchPath, filename); + } + if (file.isDirectory()) { + return null; + } + if (file.exists()) { + try { + // handle case sensitivity check + String filePath = file.getCanonicalPath(); + String filenameActual = new File(filePath).getName(); + // make sure there isn't a subfolder prepended to the name + String filenameShort = new File(filename).getName(); + // if the actual filename is the same, but capitalized + // differently, warn the user. + //if (filenameActual.equalsIgnoreCase(filenameShort) && + //!filenameActual.equals(filenameShort)) { + if (!filenameActual.equals(filenameShort)) { + throw new RuntimeException("This file is named " + + filenameActual + " not " + + filename + ". Rename the file " + + "or change your code."); + } + } catch (IOException e) { } + } + + // if this file is ok, may as well just load it + stream = new FileInputStream(file); + if (stream != null) return stream; + + // have to break these out because a general Exception might + // catch the RuntimeException being thrown above + } catch (IOException ioe) { + } catch (SecurityException se) { } + + // Using getClassLoader() prevents java from converting dots + // to slashes or requiring a slash at the beginning. + // (a slash as a prefix means that it'll load from the root of + // the jar, rather than trying to dig into the package location) + ClassLoader cl = getClass().getClassLoader(); + + // by default, data files are exported to the root path of the jar. + // (not the data folder) so check there first. + stream = cl.getResourceAsStream("data/" + filename); + if (stream != null) { + String cn = stream.getClass().getName(); + // this is an irritation of sun's java plug-in, which will return + // a non-null stream for an object that doesn't exist. like all good + // things, this is probably introduced in java 1.5. awesome! + // http://dev.processing.org/bugs/show_bug.cgi?id=359 + if (!cn.equals("sun.plugin.cache.EmptyInputStream")) { + return stream; + } + } + + // When used with an online script, also need to check without the + // data folder, in case it's not in a subfolder called 'data'. + // http://dev.processing.org/bugs/show_bug.cgi?id=389 + stream = cl.getResourceAsStream(filename); + if (stream != null) { + String cn = stream.getClass().getName(); + if (!cn.equals("sun.plugin.cache.EmptyInputStream")) { + return stream; + } + } + + try { + // attempt to load from a local file, used when running as + // an application, or as a signed applet + try { // first try to catch any security exceptions + try { + stream = new FileInputStream(dataPath(filename)); + if (stream != null) return stream; + } catch (IOException e2) { } + + try { + stream = new FileInputStream(sketchPath(filename)); + if (stream != null) return stream; + } catch (Exception e) { } // ignored + + try { + stream = new FileInputStream(filename); + if (stream != null) return stream; + } catch (IOException e1) { } + + } catch (SecurityException se) { } // online, whups + + } catch (Exception e) { + //die(e.getMessage(), e); + e.printStackTrace(); + } + return null; + } + + + static public InputStream createInput(File file) { + if (file == null) { + throw new IllegalArgumentException("File passed to createInput() was null"); + } + try { + InputStream input = new FileInputStream(file); + if (file.getName().toLowerCase().endsWith(".gz")) { + return new GZIPInputStream(input); + } + return input; + + } catch (IOException e) { + System.err.println("Could not createInput() for " + file); + e.printStackTrace(); + return null; + } + } + + + /** + * 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 restriction requires a signed applet. + * + * @webref input:files + * @param filename name of a file in the data folder or a URL. + * + * @see processing.core.PApplet#loadStrings(String) + * @see processing.core.PApplet#saveStrings(String, String[]) + * @see processing.core.PApplet#saveBytes(String, byte[]) + * + */ + public byte[] loadBytes(String filename) { + InputStream is = createInput(filename); + if (is != null) return loadBytes(is); + + System.err.println("The file \"" + filename + "\" " + + "is missing or inaccessible, make sure " + + "the URL is valid or that the file has been " + + "added to your sketch and is readable."); + return null; + } + + + static public byte[] loadBytes(InputStream input) { + try { + BufferedInputStream bis = new BufferedInputStream(input); + ByteArrayOutputStream out = new ByteArrayOutputStream(); + + int c = bis.read(); + while (c != -1) { + out.write(c); + c = bis.read(); + } + return out.toByteArray(); + + } catch (IOException e) { + e.printStackTrace(); + //throw new RuntimeException("Couldn't load bytes from stream"); + } + return null; + } + + + static public byte[] loadBytes(File file) { + InputStream is = createInput(file); + return loadBytes(is); + } + + + static public String[] loadStrings(File file) { + InputStream is = createInput(file); + if (is != null) return loadStrings(is); + return null; + } + + + /** + * 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 signed applet. + *

If the file is not available or an error occurs, null 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 are moved to other platforms. + * + * =advanced + * Load data from a file and shove it into a String array. + *

+ * Exceptions are handled internally, when an error, occurs, an + * exception is printed to the console and 'null' is returned, + * but the program continues running. This is a tradeoff between + * 1) showing the user that there was a problem but 2) not requiring + * that all i/o code is contained in try/catch blocks, for the sake + * of new users (or people who are just trying to get things done + * in a "scripting" fashion. If you want to handle exceptions, + * use Java methods for I/O. + * + * @webref input:files + * @param filename name of the file or url to load + * + * @see processing.core.PApplet#loadBytes(String) + * @see processing.core.PApplet#saveStrings(String, String[]) + * @see processing.core.PApplet#saveBytes(String, byte[]) + */ + public String[] loadStrings(String filename) { + InputStream is = createInput(filename); + if (is != null) return loadStrings(is); + + System.err.println("The file \"" + filename + "\" " + + "is missing or inaccessible, make sure " + + "the URL is valid or that the file has been " + + "added to your sketch and is readable."); + return null; + } + + + static public String[] loadStrings(InputStream input) { + try { + BufferedReader reader = + new BufferedReader(new InputStreamReader(input, "UTF-8")); + + String lines[] = new String[100]; + int lineCount = 0; + String line = null; + while ((line = reader.readLine()) != null) { + if (lineCount == lines.length) { + String temp[] = new String[lineCount << 1]; + System.arraycopy(lines, 0, temp, 0, lineCount); + lines = temp; + } + lines[lineCount++] = line; + } + reader.close(); + + if (lineCount == lines.length) { + return lines; + } + + // resize array to appropriate amount for these lines + String output[] = new String[lineCount]; + System.arraycopy(lines, 0, output, 0, lineCount); + return output; + + } catch (IOException e) { + e.printStackTrace(); + //throw new RuntimeException("Error inside loadStrings()"); + } + return null; + } + + + + ////////////////////////////////////////////////////////////// + + // FILE OUTPUT + + + /** + * Similar to createInput() (formerly openStream), this creates a Java + * OutputStream 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 null will be + * returned. + *

+ * Future releases may also add support for handling HTTP POST via this + * method (for better symmetry with createInput), however that's maybe a + * little too clever (and then we'd have to add the same features to the + * other file functions like createWriter). Who you callin' bloated? + */ + public OutputStream createOutput(String filename) { + return createOutput(saveFile(filename)); + } + + + static public OutputStream createOutput(File file) { + try { + createPath(file); // make sure the path exists + FileOutputStream fos = new FileOutputStream(file); + if (file.getName().toLowerCase().endsWith(".gz")) { + return new GZIPOutputStream(fos); + } + return fos; + + } catch (IOException e) { + e.printStackTrace(); + } + return null; + } + + + /** + * Save the contents of a stream to a file in the sketch folder. + * This is basically saveBytes(blah, loadBytes()), but done + * more efficiently (and with less confusing syntax). + */ + public void saveStream(String targetFilename, String sourceLocation) { + saveStream(saveFile(targetFilename), sourceLocation); + } + + + /** + * 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. + */ + public void saveStream(File targetFile, String sourceLocation) { + saveStream(targetFile, createInputRaw(sourceLocation)); + } + + + static public void saveStream(File targetFile, InputStream sourceStream) { + File tempFile = null; + try { + File parentDir = targetFile.getParentFile(); + tempFile = File.createTempFile(targetFile.getName(), null, parentDir); + + BufferedInputStream bis = new BufferedInputStream(sourceStream, 16384); + FileOutputStream fos = new FileOutputStream(tempFile); + BufferedOutputStream bos = new BufferedOutputStream(fos); + + byte[] buffer = new byte[8192]; + int bytesRead; + while ((bytesRead = bis.read(buffer)) != -1) { + bos.write(buffer, 0, bytesRead); + } + + bos.flush(); + bos.close(); + bos = null; + + if (!tempFile.renameTo(targetFile)) { + System.err.println("Could not rename temporary file " + + tempFile.getAbsolutePath()); + } + } catch (IOException e) { + if (tempFile != null) { + tempFile.delete(); + } + e.printStackTrace(); + } + } + + + /** + * Saves bytes to a file to inside the sketch folder. + * The filename can be a relative path, i.e. "poo/bytefun.txt" + * would save to a file named "bytefun.txt" to a subfolder + * called 'poo' inside the sketch folder. If the in-between + * subfolders don't exist, they'll be created. + */ + public void saveBytes(String filename, byte buffer[]) { + saveBytes(saveFile(filename), buffer); + } + + + /** + * Saves bytes to a specific File location specified by the user. + */ + static public void saveBytes(File file, byte buffer[]) { + File tempFile = null; + try { + File parentDir = file.getParentFile(); + tempFile = File.createTempFile(file.getName(), null, parentDir); + + /* + String filename = file.getAbsolutePath(); + createPath(filename); + OutputStream output = new FileOutputStream(file); + if (file.getName().toLowerCase().endsWith(".gz")) { + output = new GZIPOutputStream(output); + } + */ + OutputStream output = createOutput(tempFile); + saveBytes(output, buffer); + output.close(); + output = null; + + if (!tempFile.renameTo(file)) { + System.err.println("Could not rename temporary file " + + tempFile.getAbsolutePath()); + } + + } catch (IOException e) { + System.err.println("error saving bytes to " + file); + if (tempFile != null) { + tempFile.delete(); + } + e.printStackTrace(); + } + } + + + /** + * Spews a buffer of bytes to an OutputStream. + */ + static public void saveBytes(OutputStream output, byte buffer[]) { + try { + output.write(buffer); + output.flush(); + + } catch (IOException e) { + e.printStackTrace(); + } + } + + // + + public void saveStrings(String filename, String strings[]) { + saveStrings(saveFile(filename), strings); + } + + + static public void saveStrings(File file, String strings[]) { + saveStrings(createOutput(file), strings); + /* + try { + String location = file.getAbsolutePath(); + createPath(location); + OutputStream output = new FileOutputStream(location); + if (file.getName().toLowerCase().endsWith(".gz")) { + output = new GZIPOutputStream(output); + } + saveStrings(output, strings); + output.close(); + + } catch (IOException e) { + e.printStackTrace(); + } + */ + } + + + static public void saveStrings(OutputStream output, String strings[]) { + PrintWriter writer = createWriter(output); + for (int i = 0; i < strings.length; i++) { + writer.println(strings[i]); + } + writer.flush(); + writer.close(); + } + + + ////////////////////////////////////////////////////////////// + + + /** + * 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(), + * see the examples in the main description text for PApplet. + */ + public String sketchPath(String where) { + if (sketchPath == null) { + return where; +// throw new RuntimeException("The applet was not inited properly, " + +// "or security restrictions prevented " + +// "it from determining its path."); + } + // isAbsolute() could throw an access exception, but so will writing + // to the local disk using the sketch path, so this is safe here. + // for 0120, added a try/catch anyways. + try { + if (new File(where).isAbsolute()) return where; + } catch (Exception e) { } + + return sketchPath + File.separator + where; + } + + + public File sketchFile(String where) { + return new File(sketchPath(where)); + } + + + /** + * 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 + * possible to save data into the jar file, because it will often be running + * from a server, or marked in-use if running from a local file system. + * With this in mind, saving to the data path doesn't make sense anyway. + * If you know you're running locally, and want to save to the data folder, + * use saveXxxx("data/blah.dat"). + */ + public String savePath(String where) { + if (where == null) return null; + String filename = sketchPath(where); + createPath(filename); + return filename; + } + + + /** + * Identical to savePath(), but returns a File object. + */ + public File saveFile(String where) { + return new File(savePath(where)); + } + + + /** + * Return a full path to an item in the data folder. + *

+ * In this method, the data path is defined not as the applet's actual + * data path, but a folder titled "data" in the sketch's working + * directory. When running inside the PDE, this will be the sketch's + * "data" folder. However, when exported (as application or applet), + * sketch's data folder is exported as part of the applications jar file, + * and it's not possible to read/write from the jar file in a generic way. + * If you need to read data from the jar file, you should use other methods + * such as createInput(), createReader(), or loadStrings(). + */ + public String dataPath(String where) { + // isAbsolute() could throw an access exception, but so will writing + // to the local disk using the sketch path, so this is safe here. + if (new File(where).isAbsolute()) return where; + + return sketchPath + File.separator + "data" + File.separator + where; + } + + + /** + * Return a full path to an item in the data folder as a File object. + * See the dataPath() method for more information. + */ + public File dataFile(String where) { + return new File(dataPath(where)); + } + + + /** + * Takes a path and creates any in-between folders if they don't + * already exist. Useful when trying to save to a subfolder that + * may not actually exist. + */ + static public void createPath(String path) { + createPath(new File(path)); + } + + + static public void createPath(File file) { + try { + String parent = file.getParent(); + if (parent != null) { + File unit = new File(parent); + if (!unit.exists()) unit.mkdirs(); + } + } catch (SecurityException se) { + System.err.println("You don't have permissions to create " + + file.getAbsolutePath()); + } + } + + + + ////////////////////////////////////////////////////////////// + + // SORT + + + static public byte[] sort(byte what[]) { + return sort(what, what.length); + } + + + static public byte[] sort(byte[] what, int count) { + byte[] outgoing = new byte[what.length]; + System.arraycopy(what, 0, outgoing, 0, what.length); + Arrays.sort(outgoing, 0, count); + return outgoing; + } + + + static public char[] sort(char what[]) { + return sort(what, what.length); + } + + + static public char[] sort(char[] what, int count) { + char[] outgoing = new char[what.length]; + System.arraycopy(what, 0, outgoing, 0, what.length); + Arrays.sort(outgoing, 0, count); + return outgoing; + } + + + static public int[] sort(int what[]) { + return sort(what, what.length); + } + + + static public int[] sort(int[] what, int count) { + int[] outgoing = new int[what.length]; + System.arraycopy(what, 0, outgoing, 0, what.length); + Arrays.sort(outgoing, 0, count); + return outgoing; + } + + + static public float[] sort(float what[]) { + return sort(what, what.length); + } + + + static public float[] sort(float[] what, int count) { + float[] outgoing = new float[what.length]; + System.arraycopy(what, 0, outgoing, 0, what.length); + Arrays.sort(outgoing, 0, count); + return outgoing; + } + + + static public String[] sort(String what[]) { + return sort(what, what.length); + } + + + static public String[] sort(String[] what, int count) { + String[] outgoing = new String[what.length]; + System.arraycopy(what, 0, outgoing, 0, what.length); + Arrays.sort(outgoing, 0, count); + return outgoing; + } + + + + ////////////////////////////////////////////////////////////// + + // ARRAY UTILITIES + + + /** + * Calls System.arraycopy(), included here so that we can + * avoid people needing to learn about the System object + * before they can just copy an array. + */ + static public void arrayCopy(Object src, int srcPosition, + Object dst, int dstPosition, + int length) { + System.arraycopy(src, srcPosition, dst, dstPosition, length); + } + + + /** + * Convenience method for arraycopy(). + * Identical to arraycopy(src, 0, dst, 0, length); + */ + static public void arrayCopy(Object src, Object dst, int length) { + System.arraycopy(src, 0, dst, 0, length); + } + + + /** + * Shortcut to copy the entire contents of + * the source into the destination array. + * Identical to arraycopy(src, 0, dst, 0, src.length); + */ + static public void arrayCopy(Object src, Object dst) { + System.arraycopy(src, 0, dst, 0, Array.getLength(src)); + } + + // + + /** + * @deprecated Use arrayCopy() instead. + */ + static public void arraycopy(Object src, int srcPosition, + Object dst, int dstPosition, + int length) { + System.arraycopy(src, srcPosition, dst, dstPosition, length); + } + + /** + * @deprecated Use arrayCopy() instead. + */ + static public void arraycopy(Object src, Object dst, int length) { + System.arraycopy(src, 0, dst, 0, length); + } + + /** + * @deprecated Use arrayCopy() instead. + */ + static public void arraycopy(Object src, Object dst) { + System.arraycopy(src, 0, dst, 0, Array.getLength(src)); + } + + // + + static public boolean[] expand(boolean list[]) { + return expand(list, list.length << 1); + } + + static public boolean[] expand(boolean list[], int newSize) { + boolean temp[] = new boolean[newSize]; + System.arraycopy(list, 0, temp, 0, Math.min(newSize, list.length)); + return temp; + } + + + static public byte[] expand(byte list[]) { + return expand(list, list.length << 1); + } + + static public byte[] expand(byte list[], int newSize) { + byte temp[] = new byte[newSize]; + System.arraycopy(list, 0, temp, 0, Math.min(newSize, list.length)); + return temp; + } + + + static public char[] expand(char list[]) { + return expand(list, list.length << 1); + } + + static public char[] expand(char list[], int newSize) { + char temp[] = new char[newSize]; + System.arraycopy(list, 0, temp, 0, Math.min(newSize, list.length)); + return temp; + } + + + static public int[] expand(int list[]) { + return expand(list, list.length << 1); + } + + static public int[] expand(int list[], int newSize) { + int temp[] = new int[newSize]; + System.arraycopy(list, 0, temp, 0, Math.min(newSize, list.length)); + return temp; + } + + + static public float[] expand(float list[]) { + return expand(list, list.length << 1); + } + + static public float[] expand(float list[], int newSize) { + float temp[] = new float[newSize]; + System.arraycopy(list, 0, temp, 0, Math.min(newSize, list.length)); + return temp; + } + + + static public String[] expand(String list[]) { + return expand(list, list.length << 1); + } + + static public String[] expand(String list[], int newSize) { + String temp[] = new String[newSize]; + // in case the new size is smaller than list.length + System.arraycopy(list, 0, temp, 0, Math.min(newSize, list.length)); + return temp; + } + + + static public Object expand(Object array) { + return expand(array, Array.getLength(array) << 1); + } + + static public Object expand(Object list, int newSize) { + Class type = list.getClass().getComponentType(); + Object temp = Array.newInstance(type, newSize); + System.arraycopy(list, 0, temp, 0, + Math.min(Array.getLength(list), newSize)); + return temp; + } + + // + + // contract() has been removed in revision 0124, use subset() instead. + // (expand() is also functionally equivalent) + + // + + static public byte[] append(byte b[], byte value) { + b = expand(b, b.length + 1); + b[b.length-1] = value; + return b; + } + + static public char[] append(char b[], char value) { + b = expand(b, b.length + 1); + b[b.length-1] = value; + return b; + } + + static public int[] append(int b[], int value) { + b = expand(b, b.length + 1); + b[b.length-1] = value; + return b; + } + + static public float[] append(float b[], float value) { + b = expand(b, b.length + 1); + b[b.length-1] = value; + return b; + } + + static public String[] append(String b[], String value) { + b = expand(b, b.length + 1); + b[b.length-1] = value; + return b; + } + + static public Object append(Object b, Object value) { + int length = Array.getLength(b); + b = expand(b, length + 1); + Array.set(b, length, value); + return b; + } + + // + + static public boolean[] shorten(boolean list[]) { + return subset(list, 0, list.length-1); + } + + static public byte[] shorten(byte list[]) { + return subset(list, 0, list.length-1); + } + + static public char[] shorten(char list[]) { + return subset(list, 0, list.length-1); + } + + static public int[] shorten(int list[]) { + return subset(list, 0, list.length-1); + } + + static public float[] shorten(float list[]) { + return subset(list, 0, list.length-1); + } + + static public String[] shorten(String list[]) { + return subset(list, 0, list.length-1); + } + + static public Object shorten(Object list) { + int length = Array.getLength(list); + return subset(list, 0, length - 1); + } + + // + + static final public boolean[] splice(boolean list[], + boolean v, int index) { + boolean outgoing[] = new boolean[list.length + 1]; + System.arraycopy(list, 0, outgoing, 0, index); + outgoing[index] = v; + System.arraycopy(list, index, outgoing, index + 1, + list.length - index); + return outgoing; + } + + static final public boolean[] splice(boolean list[], + boolean v[], int index) { + boolean outgoing[] = new boolean[list.length + v.length]; + System.arraycopy(list, 0, outgoing, 0, index); + System.arraycopy(v, 0, outgoing, index, v.length); + System.arraycopy(list, index, outgoing, index + v.length, + list.length - index); + return outgoing; + } + + + static final public byte[] splice(byte list[], + byte v, int index) { + byte outgoing[] = new byte[list.length + 1]; + System.arraycopy(list, 0, outgoing, 0, index); + outgoing[index] = v; + System.arraycopy(list, index, outgoing, index + 1, + list.length - index); + return outgoing; + } + + static final public byte[] splice(byte list[], + byte v[], int index) { + byte outgoing[] = new byte[list.length + v.length]; + System.arraycopy(list, 0, outgoing, 0, index); + System.arraycopy(v, 0, outgoing, index, v.length); + System.arraycopy(list, index, outgoing, index + v.length, + list.length - index); + return outgoing; + } + + + static final public char[] splice(char list[], + char v, int index) { + char outgoing[] = new char[list.length + 1]; + System.arraycopy(list, 0, outgoing, 0, index); + outgoing[index] = v; + System.arraycopy(list, index, outgoing, index + 1, + list.length - index); + return outgoing; + } + + static final public char[] splice(char list[], + char v[], int index) { + char outgoing[] = new char[list.length + v.length]; + System.arraycopy(list, 0, outgoing, 0, index); + System.arraycopy(v, 0, outgoing, index, v.length); + System.arraycopy(list, index, outgoing, index + v.length, + list.length - index); + return outgoing; + } + + + static final public int[] splice(int list[], + int v, int index) { + int outgoing[] = new int[list.length + 1]; + System.arraycopy(list, 0, outgoing, 0, index); + outgoing[index] = v; + System.arraycopy(list, index, outgoing, index + 1, + list.length - index); + return outgoing; + } + + static final public int[] splice(int list[], + int v[], int index) { + int outgoing[] = new int[list.length + v.length]; + System.arraycopy(list, 0, outgoing, 0, index); + System.arraycopy(v, 0, outgoing, index, v.length); + System.arraycopy(list, index, outgoing, index + v.length, + list.length - index); + return outgoing; + } + + + static final public float[] splice(float list[], + float v, int index) { + float outgoing[] = new float[list.length + 1]; + System.arraycopy(list, 0, outgoing, 0, index); + outgoing[index] = v; + System.arraycopy(list, index, outgoing, index + 1, + list.length - index); + return outgoing; + } + + static final public float[] splice(float list[], + float v[], int index) { + float outgoing[] = new float[list.length + v.length]; + System.arraycopy(list, 0, outgoing, 0, index); + System.arraycopy(v, 0, outgoing, index, v.length); + System.arraycopy(list, index, outgoing, index + v.length, + list.length - index); + return outgoing; + } + + + static final public String[] splice(String list[], + String v, int index) { + String outgoing[] = new String[list.length + 1]; + System.arraycopy(list, 0, outgoing, 0, index); + outgoing[index] = v; + System.arraycopy(list, index, outgoing, index + 1, + list.length - index); + return outgoing; + } + + static final public String[] splice(String list[], + String v[], int index) { + String outgoing[] = new String[list.length + v.length]; + System.arraycopy(list, 0, outgoing, 0, index); + System.arraycopy(v, 0, outgoing, index, v.length); + System.arraycopy(list, index, outgoing, index + v.length, + list.length - index); + return outgoing; + } + + + static final public Object splice(Object list, Object v, int index) { + Object[] outgoing = null; + int length = Array.getLength(list); + + // check whether item being spliced in is an array + if (v.getClass().getName().charAt(0) == '[') { + int vlength = Array.getLength(v); + outgoing = new Object[length + vlength]; + System.arraycopy(list, 0, outgoing, 0, index); + System.arraycopy(v, 0, outgoing, index, vlength); + System.arraycopy(list, index, outgoing, index + vlength, length - index); + + } else { + outgoing = new Object[length + 1]; + System.arraycopy(list, 0, outgoing, 0, index); + Array.set(outgoing, index, v); + System.arraycopy(list, index, outgoing, index + 1, length - index); + } + return outgoing; + } + + // + + static public boolean[] subset(boolean list[], int start) { + return subset(list, start, list.length - start); + } + + static public boolean[] subset(boolean list[], int start, int count) { + boolean output[] = new boolean[count]; + System.arraycopy(list, start, output, 0, count); + return output; + } + + + static public byte[] subset(byte list[], int start) { + return subset(list, start, list.length - start); + } + + static public byte[] subset(byte list[], int start, int count) { + byte output[] = new byte[count]; + System.arraycopy(list, start, output, 0, count); + return output; + } + + + static public char[] subset(char list[], int start) { + return subset(list, start, list.length - start); + } + + static public char[] subset(char list[], int start, int count) { + char output[] = new char[count]; + System.arraycopy(list, start, output, 0, count); + return output; + } + + + static public int[] subset(int list[], int start) { + return subset(list, start, list.length - start); + } + + static public int[] subset(int list[], int start, int count) { + int output[] = new int[count]; + System.arraycopy(list, start, output, 0, count); + return output; + } + + + static public float[] subset(float list[], int start) { + return subset(list, start, list.length - start); + } + + static public float[] subset(float list[], int start, int count) { + float output[] = new float[count]; + System.arraycopy(list, start, output, 0, count); + return output; + } + + + static public String[] subset(String list[], int start) { + return subset(list, start, list.length - start); + } + + static public String[] subset(String list[], int start, int count) { + String output[] = new String[count]; + System.arraycopy(list, start, output, 0, count); + return output; + } + + + static public Object subset(Object list, int start) { + int length = Array.getLength(list); + return subset(list, start, length - start); + } + + static public Object subset(Object list, int start, int count) { + Class type = list.getClass().getComponentType(); + Object outgoing = Array.newInstance(type, count); + System.arraycopy(list, start, outgoing, 0, count); + return outgoing; + } + + // + + static public boolean[] concat(boolean a[], boolean b[]) { + boolean c[] = new boolean[a.length + b.length]; + System.arraycopy(a, 0, c, 0, a.length); + System.arraycopy(b, 0, c, a.length, b.length); + return c; + } + + static public byte[] concat(byte a[], byte b[]) { + byte c[] = new byte[a.length + b.length]; + System.arraycopy(a, 0, c, 0, a.length); + System.arraycopy(b, 0, c, a.length, b.length); + return c; + } + + static public char[] concat(char a[], char b[]) { + char c[] = new char[a.length + b.length]; + System.arraycopy(a, 0, c, 0, a.length); + System.arraycopy(b, 0, c, a.length, b.length); + return c; + } + + static public int[] concat(int a[], int b[]) { + int c[] = new int[a.length + b.length]; + System.arraycopy(a, 0, c, 0, a.length); + System.arraycopy(b, 0, c, a.length, b.length); + return c; + } + + static public float[] concat(float a[], float b[]) { + float c[] = new float[a.length + b.length]; + System.arraycopy(a, 0, c, 0, a.length); + System.arraycopy(b, 0, c, a.length, b.length); + return c; + } + + static public String[] concat(String a[], String b[]) { + String c[] = new String[a.length + b.length]; + System.arraycopy(a, 0, c, 0, a.length); + System.arraycopy(b, 0, c, a.length, b.length); + return c; + } + + static public Object concat(Object a, Object b) { + Class type = a.getClass().getComponentType(); + int alength = Array.getLength(a); + int blength = Array.getLength(b); + Object outgoing = Array.newInstance(type, alength + blength); + System.arraycopy(a, 0, outgoing, 0, alength); + System.arraycopy(b, 0, outgoing, alength, blength); + return outgoing; + } + + // + + static public boolean[] reverse(boolean list[]) { + boolean outgoing[] = new boolean[list.length]; + int length1 = list.length - 1; + for (int i = 0; i < list.length; i++) { + outgoing[i] = list[length1 - i]; + } + return outgoing; + } + + static public byte[] reverse(byte list[]) { + byte outgoing[] = new byte[list.length]; + int length1 = list.length - 1; + for (int i = 0; i < list.length; i++) { + outgoing[i] = list[length1 - i]; + } + return outgoing; + } + + static public char[] reverse(char list[]) { + char outgoing[] = new char[list.length]; + int length1 = list.length - 1; + for (int i = 0; i < list.length; i++) { + outgoing[i] = list[length1 - i]; + } + return outgoing; + } + + static public int[] reverse(int list[]) { + int outgoing[] = new int[list.length]; + int length1 = list.length - 1; + for (int i = 0; i < list.length; i++) { + outgoing[i] = list[length1 - i]; + } + return outgoing; + } + + static public float[] reverse(float list[]) { + float outgoing[] = new float[list.length]; + int length1 = list.length - 1; + for (int i = 0; i < list.length; i++) { + outgoing[i] = list[length1 - i]; + } + return outgoing; + } + + static public String[] reverse(String list[]) { + String outgoing[] = new String[list.length]; + int length1 = list.length - 1; + for (int i = 0; i < list.length; i++) { + outgoing[i] = list[length1 - i]; + } + return outgoing; + } + + static public Object reverse(Object list) { + Class type = list.getClass().getComponentType(); + int length = Array.getLength(list); + Object outgoing = Array.newInstance(type, length); + for (int i = 0; i < length; i++) { + Array.set(outgoing, i, Array.get(list, (length - 1) - i)); + } + return outgoing; + } + + + + ////////////////////////////////////////////////////////////// + + // STRINGS + + + /** + * Remove whitespace characters from the beginning and ending + * of a String. Works like String.trim() but includes the + * unicode nbsp character as well. + */ + static public String trim(String str) { + return str.replace('\u00A0', ' ').trim(); + } + + + /** + * Trim the whitespace from a String array. This returns a new + * array and does not affect the passed-in array. + */ + static public String[] trim(String[] array) { + String[] outgoing = new String[array.length]; + for (int i = 0; i < array.length; i++) { + outgoing[i] = array[i].replace('\u00A0', ' ').trim(); + } + return outgoing; + } + + + /** + * Join an array of Strings together as a single String, + * separated by the whatever's passed in for the separator. + */ + static public String join(String str[], char separator) { + return join(str, String.valueOf(separator)); + } + + + /** + * Join an array of Strings together as a single String, + * separated by the whatever's passed in for the separator. + *

+ * To use this on numbers, first pass the array to nf() or nfs() + * to get a list of String objects, then use join on that. + * 

+   * e.g. String stuff[] = { "apple", "bear", "cat" };
+   *      String list = join(stuff, ", ");
+   *      // list is now "apple, bear, cat"
+ */ + static public String join(String str[], String separator) { + StringBuffer buffer = new StringBuffer(); + for (int i = 0; i < str.length; i++) { + if (i != 0) buffer.append(separator); + buffer.append(str[i]); + } + return buffer.toString(); + } + + + /** + * Split the provided String at wherever whitespace occurs. + * Multiple whitespace (extra spaces or tabs or whatever) + * between items will count as a single break. + *

+ * The whitespace characters are "\t\n\r\f", which are the defaults + * for java.util.StringTokenizer, plus the unicode non-breaking space + * character, which is found commonly on files created by or used + * in conjunction with Mac OS X (character 160, or 0x00A0 in hex). + * 

+   * i.e. splitTokens("a b") -> { "a", "b" }
+   *      splitTokens("a    b") -> { "a", "b" }
+   *      splitTokens("a\tb") -> { "a", "b" }
+   *      splitTokens("a \t  b  ") -> { "a", "b" }
+ */ + static public String[] splitTokens(String what) { + return splitTokens(what, WHITESPACE); + } + + + /** + * Splits a string into pieces, using any of the chars in the + * String 'delim' as separator characters. For instance, + * in addition to white space, you might want to treat commas + * as a separator. The delimeter characters won't appear in + * the returned String array. + * 
+   * i.e. splitTokens("a, b", " ,") -> { "a", "b" }
+   *
+ * To include all the whitespace possibilities, use the variable + * WHITESPACE, found in PConstants: + * 
+   * i.e. splitTokens("a   | b", WHITESPACE + "|");  ->  { "a", "b" }
+ */ + static public String[] splitTokens(String what, String delim) { + StringTokenizer toker = new StringTokenizer(what, delim); + String pieces[] = new String[toker.countTokens()]; + + int index = 0; + while (toker.hasMoreTokens()) { + pieces[index++] = toker.nextToken(); + } + return pieces; + } + + + /** + * Split a string into pieces along a specific character. + * Most commonly used to break up a String along a space or a tab + * character. + *

+ * This operates differently than the others, where the + * single delimeter is the only breaking point, and consecutive + * delimeters will produce an empty string (""). This way, + * one can split on tab characters, but maintain the column + * alignments (of say an excel file) where there are empty columns. + */ + static public String[] split(String what, char delim) { + // do this so that the exception occurs inside the user's + // program, rather than appearing to be a bug inside split() + if (what == null) return null; + //return split(what, String.valueOf(delim)); // huh + + char chars[] = what.toCharArray(); + int splitCount = 0; //1; + for (int i = 0; i < chars.length; i++) { + if (chars[i] == delim) splitCount++; + } + // make sure that there is something in the input string + //if (chars.length > 0) { + // if the last char is a delimeter, get rid of it.. + //if (chars[chars.length-1] == delim) splitCount--; + // on second thought, i don't agree with this, will disable + //} + if (splitCount == 0) { + String splits[] = new String[1]; + splits[0] = new String(what); + return splits; + } + //int pieceCount = splitCount + 1; + String splits[] = new String[splitCount + 1]; + int splitIndex = 0; + int startIndex = 0; + for (int i = 0; i < chars.length; i++) { + if (chars[i] == delim) { + splits[splitIndex++] = + new String(chars, startIndex, i-startIndex); + startIndex = i + 1; + } + } + //if (startIndex != chars.length) { + splits[splitIndex] = + new String(chars, startIndex, chars.length-startIndex); + //} + return splits; + } + + + /** + * Split a String on a specific delimiter. Unlike Java's String.split() + * method, this does not parse the delimiter as a regexp because it's more + * confusing than necessary, and String.split() is always available for + * those who want regexp. + */ + static public String[] split(String what, String delim) { + ArrayList items = new ArrayList(); + int index; + int offset = 0; + while ((index = what.indexOf(delim, offset)) != -1) { + items.add(what.substring(offset, index)); + offset = index + delim.length(); + } + items.add(what.substring(offset)); + String[] outgoing = new String[items.size()]; + items.toArray(outgoing); + return outgoing; + } + + + /** + * Match a string with a regular expression, and returns the match as an + * array. The first index is the matching expression, and array elements + * [1] and higher represent each of the groups (sequences found in parens). + * + * This uses multiline matching (Pattern.MULTILINE) and dotall mode + * (Pattern.DOTALL) by default, so that ^ and $ match the beginning and + * end of any lines found in the source, and the . operator will also + * pick up newline characters. + */ + static public String[] match(String what, String regexp) { + Pattern p = Pattern.compile(regexp, Pattern.MULTILINE | Pattern.DOTALL); + Matcher m = p.matcher(what); + if (m.find()) { + int count = m.groupCount() + 1; + String[] groups = new String[count]; + for (int i = 0; i < count; i++) { + groups[i] = m.group(i); + } + return groups; + } + return null; + } + + + /** + * Identical to match(), except that it returns an array of all matches in + * the specified String, rather than just the first. + */ + static public String[][] matchAll(String what, String regexp) { + Pattern p = Pattern.compile(regexp, Pattern.MULTILINE | Pattern.DOTALL); + Matcher m = p.matcher(what); + ArrayList results = new ArrayList(); + int count = m.groupCount() + 1; + while (m.find()) { + String[] groups = new String[count]; + for (int i = 0; i < count; i++) { + groups[i] = m.group(i); + } + results.add(groups); + } + if (results.isEmpty()) { + return null; + } + String[][] matches = new String[results.size()][count]; + for (int i = 0; i < matches.length; i++) { + matches[i] = (String[]) results.get(i); + } + return matches; + } + + + + ////////////////////////////////////////////////////////////// + + // CASTING FUNCTIONS, INSERTED BY PREPROC + + + /** + * Convert a char to a boolean. 'T', 't', and '1' will become the + * boolean value true, while 'F', 'f', or '0' will become false. + */ + /* + static final public boolean parseBoolean(char what) { + return ((what == 't') || (what == 'T') || (what == '1')); + } + */ + + /** + *

Convert an integer to a boolean. Because of how Java handles upgrading + * numbers, this will also cover byte and char (as they will upgrade to + * an int without any sort of explicit cast).

+ *

The preprocessor will convert boolean(what) to parseBoolean(what).

+ * @return false if 0, true if any other number + */ + static final public boolean parseBoolean(int what) { + return (what != 0); + } + + /* + // removed because this makes no useful sense + static final public boolean parseBoolean(float what) { + return (what != 0); + } + */ + + /** + * Convert the string "true" or "false" to a boolean. + * @return true if 'what' is "true" or "TRUE", false otherwise + */ + static final public boolean parseBoolean(String what) { + return new Boolean(what).booleanValue(); + } + + // . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . + + /* + // removed, no need to introduce strange syntax from other languages + static final public boolean[] parseBoolean(char what[]) { + boolean outgoing[] = new boolean[what.length]; + for (int i = 0; i < what.length; i++) { + outgoing[i] = + ((what[i] == 't') || (what[i] == 'T') || (what[i] == '1')); + } + return outgoing; + } + */ + + /** + * Convert a byte array to a boolean array. Each element will be + * evaluated identical to the integer case, where a byte equal + * to zero will return false, and any other value will return true. + * @return array of boolean elements + */ + static final public boolean[] parseBoolean(byte what[]) { + boolean outgoing[] = new boolean[what.length]; + for (int i = 0; i < what.length; i++) { + outgoing[i] = (what[i] != 0); + } + return outgoing; + } + + /** + * Convert an int array to a boolean array. An int equal + * to zero will return false, and any other value will return true. + * @return array of boolean elements + */ + static final public boolean[] parseBoolean(int what[]) { + boolean outgoing[] = new boolean[what.length]; + for (int i = 0; i < what.length; i++) { + outgoing[i] = (what[i] != 0); + } + return outgoing; + } + + /* + // removed, not necessary... if necessary, convert to int array first + static final public boolean[] parseBoolean(float what[]) { + boolean outgoing[] = new boolean[what.length]; + for (int i = 0; i < what.length; i++) { + outgoing[i] = (what[i] != 0); + } + return outgoing; + } + */ + + static final public boolean[] parseBoolean(String what[]) { + boolean outgoing[] = new boolean[what.length]; + for (int i = 0; i < what.length; i++) { + outgoing[i] = new Boolean(what[i]).booleanValue(); + } + return outgoing; + } + + // . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . + + static final public byte parseByte(boolean what) { + return what ? (byte)1 : 0; + } + + static final public byte parseByte(char what) { + return (byte) what; + } + + static final public byte parseByte(int what) { + return (byte) what; + } + + static final public byte parseByte(float what) { + return (byte) what; + } + + /* + // nixed, no precedent + static final public byte[] parseByte(String what) { // note: array[] + return what.getBytes(); + } + */ + + // . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . + + static final public byte[] parseByte(boolean what[]) { + byte outgoing[] = new byte[what.length]; + for (int i = 0; i < what.length; i++) { + outgoing[i] = what[i] ? (byte)1 : 0; + } + return outgoing; + } + + static final public byte[] parseByte(char what[]) { + byte outgoing[] = new byte[what.length]; + for (int i = 0; i < what.length; i++) { + outgoing[i] = (byte) what[i]; + } + return outgoing; + } + + static final public byte[] parseByte(int what[]) { + byte outgoing[] = new byte[what.length]; + for (int i = 0; i < what.length; i++) { + outgoing[i] = (byte) what[i]; + } + return outgoing; + } + + static final public byte[] parseByte(float what[]) { + byte outgoing[] = new byte[what.length]; + for (int i = 0; i < what.length; i++) { + outgoing[i] = (byte) what[i]; + } + return outgoing; + } + + /* + static final public byte[][] parseByte(String what[]) { // note: array[][] + byte outgoing[][] = new byte[what.length][]; + for (int i = 0; i < what.length; i++) { + outgoing[i] = what[i].getBytes(); + } + return outgoing; + } + */ + + // . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . + + /* + static final public char parseChar(boolean what) { // 0/1 or T/F ? + return what ? 't' : 'f'; + } + */ + + static final public char parseChar(byte what) { + return (char) (what & 0xff); + } + + static final public char parseChar(int what) { + return (char) what; + } + + /* + static final public char parseChar(float what) { // nonsensical + return (char) what; + } + + static final public char[] parseChar(String what) { // note: array[] + return what.toCharArray(); + } + */ + + // . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . + + /* + static final public char[] parseChar(boolean what[]) { // 0/1 or T/F ? + char outgoing[] = new char[what.length]; + for (int i = 0; i < what.length; i++) { + outgoing[i] = what[i] ? 't' : 'f'; + } + return outgoing; + } + */ + + static final public char[] parseChar(byte what[]) { + char outgoing[] = new char[what.length]; + for (int i = 0; i < what.length; i++) { + outgoing[i] = (char) (what[i] & 0xff); + } + return outgoing; + } + + static final public char[] parseChar(int what[]) { + char outgoing[] = new char[what.length]; + for (int i = 0; i < what.length; i++) { + outgoing[i] = (char) what[i]; + } + return outgoing; + } + + /* + static final public char[] parseChar(float what[]) { // nonsensical + char outgoing[] = new char[what.length]; + for (int i = 0; i < what.length; i++) { + outgoing[i] = (char) what[i]; + } + return outgoing; + } + + static final public char[][] parseChar(String what[]) { // note: array[][] + char outgoing[][] = new char[what.length][]; + for (int i = 0; i < what.length; i++) { + outgoing[i] = what[i].toCharArray(); + } + return outgoing; + } + */ + + // . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . + + static final public int parseInt(boolean what) { + return what ? 1 : 0; + } + + /** + * Note that parseInt() will un-sign a signed byte value. + */ + static final public int parseInt(byte what) { + return what & 0xff; + } + + /** + * Note that parseInt('5') is unlike String in the sense that it + * won't return 5, but the ascii value. This is because ((int) someChar) + * returns the ascii value, and parseInt() is just longhand for the cast. + */ + static final public int parseInt(char what) { + return what; + } + + /** + * Same as floor(), or an (int) cast. + */ + static final public int parseInt(float what) { + return (int) what; + } + + /** + * Parse a String into an int value. Returns 0 if the value is bad. + */ + static final public int parseInt(String what) { + return parseInt(what, 0); + } + + /** + * Parse a String to an int, and provide an alternate value that + * should be used when the number is invalid. + */ + static final public int parseInt(String what, int otherwise) { + try { + int offset = what.indexOf('.'); + if (offset == -1) { + return Integer.parseInt(what); + } else { + return Integer.parseInt(what.substring(0, offset)); + } + } catch (NumberFormatException e) { } + return otherwise; + } + + // . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . + + static final public int[] parseInt(boolean what[]) { + int list[] = new int[what.length]; + for (int i = 0; i < what.length; i++) { + list[i] = what[i] ? 1 : 0; + } + return list; + } + + static final public int[] parseInt(byte what[]) { // note this unsigns + int list[] = new int[what.length]; + for (int i = 0; i < what.length; i++) { + list[i] = (what[i] & 0xff); + } + return list; + } + + static final public int[] parseInt(char what[]) { + int list[] = new int[what.length]; + for (int i = 0; i < what.length; i++) { + list[i] = what[i]; + } + return list; + } + + static public int[] parseInt(float what[]) { + int inties[] = new int[what.length]; + for (int i = 0; i < what.length; i++) { + inties[i] = (int)what[i]; + } + return inties; + } + + /** + * Make an array of int elements from an array of String objects. + * If the String can't be parsed as a number, it will be set to zero. + * + * String s[] = { "1", "300", "44" }; + * int numbers[] = parseInt(s); + * + * numbers will contain { 1, 300, 44 } + */ + static public int[] parseInt(String what[]) { + return parseInt(what, 0); + } + + /** + * Make an array of int elements from an array of String objects. + * If the String can't be parsed as a number, its entry in the + * array will be set to the value of the "missing" parameter. + * + * String s[] = { "1", "300", "apple", "44" }; + * int numbers[] = parseInt(s, 9999); + * + * numbers will contain { 1, 300, 9999, 44 } + */ + static public int[] parseInt(String what[], int missing) { + int output[] = new int[what.length]; + for (int i = 0; i < what.length; i++) { + try { + output[i] = Integer.parseInt(what[i]); + } catch (NumberFormatException e) { + output[i] = missing; + } + } + return output; + } + + // . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . + + /* + static final public float parseFloat(boolean what) { + return what ? 1 : 0; + } + */ + + /** + * Convert an int to a float value. Also handles bytes because of + * Java's rules for upgrading values. + */ + static final public float parseFloat(int what) { // also handles byte + return (float)what; + } + + static final public float parseFloat(String what) { + return parseFloat(what, Float.NaN); + } + + static final public float parseFloat(String what, float otherwise) { + try { + return new Float(what).floatValue(); + } catch (NumberFormatException e) { } + + return otherwise; + } + + // . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . + + /* + static final public float[] parseFloat(boolean what[]) { + float floaties[] = new float[what.length]; + for (int i = 0; i < what.length; i++) { + floaties[i] = what[i] ? 1 : 0; + } + return floaties; + } + + static final public float[] parseFloat(char what[]) { + float floaties[] = new float[what.length]; + for (int i = 0; i < what.length; i++) { + floaties[i] = (char) what[i]; + } + return floaties; + } + */ + + static final public float[] parseByte(byte what[]) { + float floaties[] = new float[what.length]; + for (int i = 0; i < what.length; i++) { + floaties[i] = what[i]; + } + return floaties; + } + + static final public float[] parseFloat(int what[]) { + float floaties[] = new float[what.length]; + for (int i = 0; i < what.length; i++) { + floaties[i] = what[i]; + } + return floaties; + } + + static final public float[] parseFloat(String what[]) { + return parseFloat(what, Float.NaN); + } + + static final public float[] parseFloat(String what[], float missing) { + float output[] = new float[what.length]; + for (int i = 0; i < what.length; i++) { + try { + output[i] = new Float(what[i]).floatValue(); + } catch (NumberFormatException e) { + output[i] = missing; + } + } + return output; + } + + // . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . + + static final public String str(boolean x) { + return String.valueOf(x); + } + + static final public String str(byte x) { + return String.valueOf(x); + } + + static final public String str(char x) { + return String.valueOf(x); + } + + static final public String str(int x) { + return String.valueOf(x); + } + + static final public String str(float x) { + return String.valueOf(x); + } + + // . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . + + static final public String[] str(boolean x[]) { + String s[] = new String[x.length]; + for (int i = 0; i < x.length; i++) s[i] = String.valueOf(x[i]); + return s; + } + + static final public String[] str(byte x[]) { + String s[] = new String[x.length]; + for (int i = 0; i < x.length; i++) s[i] = String.valueOf(x[i]); + return s; + } + + static final public String[] str(char x[]) { + String s[] = new String[x.length]; + for (int i = 0; i < x.length; i++) s[i] = String.valueOf(x[i]); + return s; + } + + static final public String[] str(int x[]) { + String s[] = new String[x.length]; + for (int i = 0; i < x.length; i++) s[i] = String.valueOf(x[i]); + return s; + } + + static final public String[] str(float x[]) { + String s[] = new String[x.length]; + for (int i = 0; i < x.length; i++) s[i] = String.valueOf(x[i]); + return s; + } + + + ////////////////////////////////////////////////////////////// + + // INT NUMBER FORMATTING + + + /** + * Integer number formatter. + */ + static private NumberFormat int_nf; + static private int int_nf_digits; + static private boolean int_nf_commas; + + + static public String[] nf(int num[], int digits) { + String formatted[] = new String[num.length]; + for (int i = 0; i < formatted.length; i++) { + formatted[i] = nf(num[i], digits); + } + return formatted; + } + + + static public String nf(int num, int digits) { + if ((int_nf != null) && + (int_nf_digits == digits) && + !int_nf_commas) { + return int_nf.format(num); + } + + int_nf = NumberFormat.getInstance(); + int_nf.setGroupingUsed(false); // no commas + int_nf_commas = false; + int_nf.setMinimumIntegerDigits(digits); + int_nf_digits = digits; + return int_nf.format(num); + } + + + static public String[] nfc(int num[]) { + String formatted[] = new String[num.length]; + for (int i = 0; i < formatted.length; i++) { + formatted[i] = nfc(num[i]); + } + return formatted; + } + + + static public String nfc(int num) { + if ((int_nf != null) && + (int_nf_digits == 0) && + int_nf_commas) { + return int_nf.format(num); + } + + int_nf = NumberFormat.getInstance(); + int_nf.setGroupingUsed(true); + int_nf_commas = true; + int_nf.setMinimumIntegerDigits(0); + int_nf_digits = 0; + return int_nf.format(num); + } + + + /** + * number format signed (or space) + * Formats a number but leaves a blank space in the front + * when it's positive so that it can be properly aligned with + * numbers that have a negative sign in front of them. + */ + static public String nfs(int num, int digits) { + return (num < 0) ? nf(num, digits) : (' ' + nf(num, digits)); + } + + static public String[] nfs(int num[], int digits) { + String formatted[] = new String[num.length]; + for (int i = 0; i < formatted.length; i++) { + formatted[i] = nfs(num[i], digits); + } + return formatted; + } + + // + + /** + * number format positive (or plus) + * Formats a number, always placing a - or + sign + * in the front when it's negative or positive. + */ + static public String nfp(int num, int digits) { + return (num < 0) ? nf(num, digits) : ('+' + nf(num, digits)); + } + + static public String[] nfp(int num[], int digits) { + String formatted[] = new String[num.length]; + for (int i = 0; i < formatted.length; i++) { + formatted[i] = nfp(num[i], digits); + } + return formatted; + } + + + + ////////////////////////////////////////////////////////////// + + // FLOAT NUMBER FORMATTING + + + static private NumberFormat float_nf; + static private int float_nf_left, float_nf_right; + static private boolean float_nf_commas; + + + static public String[] nf(float num[], int left, int right) { + String formatted[] = new String[num.length]; + for (int i = 0; i < formatted.length; i++) { + formatted[i] = nf(num[i], left, right); + } + return formatted; + } + + + static public String nf(float num, int left, int right) { + if ((float_nf != null) && + (float_nf_left == left) && + (float_nf_right == right) && + !float_nf_commas) { + return float_nf.format(num); + } + + float_nf = NumberFormat.getInstance(); + float_nf.setGroupingUsed(false); + float_nf_commas = false; + + if (left != 0) float_nf.setMinimumIntegerDigits(left); + if (right != 0) { + float_nf.setMinimumFractionDigits(right); + float_nf.setMaximumFractionDigits(right); + } + float_nf_left = left; + float_nf_right = right; + return float_nf.format(num); + } + + + static public String[] nfc(float num[], int right) { + String formatted[] = new String[num.length]; + for (int i = 0; i < formatted.length; i++) { + formatted[i] = nfc(num[i], right); + } + return formatted; + } + + + static public String nfc(float num, int right) { + if ((float_nf != null) && + (float_nf_left == 0) && + (float_nf_right == right) && + float_nf_commas) { + return float_nf.format(num); + } + + float_nf = NumberFormat.getInstance(); + float_nf.setGroupingUsed(true); + float_nf_commas = true; + + if (right != 0) { + float_nf.setMinimumFractionDigits(right); + float_nf.setMaximumFractionDigits(right); + } + float_nf_left = 0; + float_nf_right = right; + return float_nf.format(num); + } + + + /** + * Number formatter that takes into account whether the number + * has a sign (positive, negative, etc) in front of it. + */ + static public String[] nfs(float num[], int left, int right) { + String formatted[] = new String[num.length]; + for (int i = 0; i < formatted.length; i++) { + formatted[i] = nfs(num[i], left, right); + } + return formatted; + } + + static public String nfs(float num, int left, int right) { + return (num < 0) ? nf(num, left, right) : (' ' + nf(num, left, right)); + } + + + static public String[] nfp(float num[], int left, int right) { + String formatted[] = new String[num.length]; + for (int i = 0; i < formatted.length; i++) { + formatted[i] = nfp(num[i], left, right); + } + return formatted; + } + + static public String nfp(float num, int left, int right) { + return (num < 0) ? nf(num, left, right) : ('+' + nf(num, left, right)); + } + + + + ////////////////////////////////////////////////////////////// + + // HEX/BINARY CONVERSION + + + static final public String hex(byte what) { + return hex(what, 2); + } + + static final public String hex(char what) { + return hex(what, 4); + } + + static final public String hex(int what) { + return hex(what, 8); + } + + static final public String hex(int what, int digits) { + String stuff = Integer.toHexString(what).toUpperCase(); + + int length = stuff.length(); + if (length > digits) { + return stuff.substring(length - digits); + + } else if (length < digits) { + return "00000000".substring(8 - (digits-length)) + stuff; + } + return stuff; + } + + static final public int unhex(String what) { + // has to parse as a Long so that it'll work for numbers bigger than 2^31 + return (int) (Long.parseLong(what, 16)); + } + + // + + /** + * Returns a String that contains the binary value of a byte. + * The returned value will always have 8 digits. + */ + static final public String binary(byte what) { + return binary(what, 8); + } + + /** + * Returns a String that contains the binary value of a char. + * The returned value will always have 16 digits because chars + * are two bytes long. + */ + static final public String binary(char what) { + return binary(what, 16); + } + + /** + * Returns a String that contains the binary value of an int. + * The length depends on the size of the number itself. + * An int can be up to 32 binary digits, but that seems like + * overkill for almost any situation, so this function just + * auto-size. If you want a specific number of digits (like all 32) + * use binary(int what, int digits) to specify how many digits. + */ + static final public String binary(int what) { + return Integer.toBinaryString(what); + //return binary(what, 32); + } + + /** + * Returns a String that contains the binary value of an int. + * The digits parameter determines how many digits will be used. + */ + static final public String binary(int what, int digits) { + String stuff = Integer.toBinaryString(what); + + int length = stuff.length(); + if (length > digits) { + return stuff.substring(length - digits); + + } else if (length < digits) { + int offset = 32 - (digits-length); + return "00000000000000000000000000000000".substring(offset) + stuff; + } + return stuff; + } + + + /** + * Unpack a binary String into an int. + * i.e. unbinary("00001000") would return 8. + */ + static final public int unbinary(String what) { + return Integer.parseInt(what, 2); + } + + + + ////////////////////////////////////////////////////////////// + + // COLOR FUNCTIONS + + // moved here so that they can work without + // the graphics actually being instantiated (outside setup) + + + public final int color(int gray) { + if (g == null) { + if (gray > 255) gray = 255; else if (gray < 0) gray = 0; + return 0xff000000 | (gray << 16) | (gray << 8) | gray; + } + return g.color(gray); + } + + + public final int color(float fgray) { + if (g == null) { + int gray = (int) fgray; + if (gray > 255) gray = 255; else if (gray < 0) gray = 0; + return 0xff000000 | (gray << 16) | (gray << 8) | gray; + } + return g.color(fgray); + } + + + /** + * As of 0116 this also takes color(#FF8800, alpha) + * + * @param gray number specifying value between white and black + */ + public final int color(int gray, int alpha) { + if (g == null) { + if (alpha > 255) alpha = 255; else if (alpha < 0) alpha = 0; + if (gray > 255) { + // then assume this is actually a #FF8800 + return (alpha << 24) | (gray & 0xFFFFFF); + } else { + //if (gray > 255) gray = 255; else if (gray < 0) gray = 0; + return (alpha << 24) | (gray << 16) | (gray << 8) | gray; + } + } + return g.color(gray, alpha); + } + + + public final int color(float fgray, float falpha) { + if (g == null) { + int gray = (int) fgray; + int alpha = (int) falpha; + if (gray > 255) gray = 255; else if (gray < 0) gray = 0; + if (alpha > 255) alpha = 255; else if (alpha < 0) alpha = 0; + return 0xff000000 | (gray << 16) | (gray << 8) | gray; + } + return g.color(fgray, falpha); + } + + + public final int color(int x, int y, int z) { + if (g == null) { + if (x > 255) x = 255; else if (x < 0) x = 0; + if (y > 255) y = 255; else if (y < 0) y = 0; + if (z > 255) z = 255; else if (z < 0) z = 0; + + return 0xff000000 | (x << 16) | (y << 8) | z; + } + return g.color(x, y, z); + } + + + public final int color(float x, float y, float z) { + if (g == null) { + if (x > 255) x = 255; else if (x < 0) x = 0; + if (y > 255) y = 255; else if (y < 0) y = 0; + if (z > 255) z = 255; else if (z < 0) z = 0; + + return 0xff000000 | ((int)x << 16) | ((int)y << 8) | (int)z; + } + return g.color(x, y, z); + } + + + public final int color(int x, int y, int z, int a) { + if (g == null) { + if (a > 255) a = 255; else if (a < 0) a = 0; + if (x > 255) x = 255; else if (x < 0) x = 0; + if (y > 255) y = 255; else if (y < 0) y = 0; + if (z > 255) z = 255; else if (z < 0) z = 0; + + return (a << 24) | (x << 16) | (y << 8) | z; + } + return g.color(x, y, z, a); + } + + /** + * Creates colors for storing in variables of the color datatype. The parameters are interpreted as RGB or HSB values depending on the current colorMode(). The default mode is RGB values from 0 to 255 and therefore, the function call color(255, 204, 0) will return a bright yellow color. More about how colors are stored can be found in the reference for the color datatype. + * + * @webref color:creating_reading + * @param x red or hue values relative to the current color range + * @param y green or saturation values relative to the current color range + * @param z blue or brightness values relative to the current color range + * @param a alpha relative to current color range + * + * @see processing.core.PApplet#colorMode(int) + * @ref color_datatype + */ + public final int color(float x, float y, float z, float a) { + if (g == null) { + if (a > 255) a = 255; else if (a < 0) a = 0; + if (x > 255) x = 255; else if (x < 0) x = 0; + if (y > 255) y = 255; else if (y < 0) y = 0; + if (z > 255) z = 255; else if (z < 0) z = 0; + + return ((int)a << 24) | ((int)x << 16) | ((int)y << 8) | (int)z; + } + return g.color(x, y, z, a); + } + + + + ////////////////////////////////////////////////////////////// + + // MAIN + + + /** + * Set this sketch to communicate its state back to the PDE. + *

+ * This uses the stderr stream to write positions of the window + * (so that it will be saved by the PDE for the next run) and + * notify on quit. See more notes in the Worker class. + */ + public void setupExternalMessages() { + + frame.addComponentListener(new ComponentAdapter() { + public void componentMoved(ComponentEvent e) { + Point where = ((Frame) e.getSource()).getLocation(); + System.err.println(PApplet.EXTERNAL_MOVE + " " + + where.x + " " + where.y); + System.err.flush(); // doesn't seem to help or hurt + } + }); + + frame.addWindowListener(new WindowAdapter() { + public void windowClosing(WindowEvent e) { +// System.err.println(PApplet.EXTERNAL_QUIT); +// System.err.flush(); // important +// System.exit(0); + exit(); // don't quit, need to just shut everything down (0133) + } + }); + } + + + /** + * Set up a listener that will fire proper component resize events + * in cases where frame.setResizable(true) is called. + */ + public void setupFrameResizeListener() { + frame.addComponentListener(new ComponentAdapter() { + + public void componentResized(ComponentEvent e) { + // Ignore bad resize events fired during setup to fix + // http://dev.processing.org/bugs/show_bug.cgi?id=341 + // This should also fix the blank screen on Linux bug + // http://dev.processing.org/bugs/show_bug.cgi?id=282 + if (frame.isResizable()) { + // might be multiple resize calls before visible (i.e. first + // when pack() is called, then when it's resized for use). + // ignore them because it's not the user resizing things. + Frame farm = (Frame) e.getComponent(); + if (farm.isVisible()) { + Insets insets = farm.getInsets(); + Dimension windowSize = farm.getSize(); + int usableW = windowSize.width - insets.left - insets.right; + int usableH = windowSize.height - insets.top - insets.bottom; + + // the ComponentListener in PApplet will handle calling size() + setBounds(insets.left, insets.top, usableW, usableH); + } + } + } + }); + } + + + /** + * GIF image of the Processing logo. + */ + static public final byte[] ICON_IMAGE = { + 71, 73, 70, 56, 57, 97, 16, 0, 16, 0, -77, 0, 0, 0, 0, 0, -1, -1, -1, 12, + 12, 13, -15, -15, -14, 45, 57, 74, 54, 80, 111, 47, 71, 97, 62, 88, 117, + 1, 14, 27, 7, 41, 73, 15, 52, 85, 2, 31, 55, 4, 54, 94, 18, 69, 109, 37, + 87, 126, -1, -1, -1, 33, -7, 4, 1, 0, 0, 15, 0, 44, 0, 0, 0, 0, 16, 0, 16, + 0, 0, 4, 122, -16, -107, 114, -86, -67, 83, 30, -42, 26, -17, -100, -45, + 56, -57, -108, 48, 40, 122, -90, 104, 67, -91, -51, 32, -53, 77, -78, -100, + 47, -86, 12, 76, -110, -20, -74, -101, 97, -93, 27, 40, 20, -65, 65, 48, + -111, 99, -20, -112, -117, -123, -47, -105, 24, 114, -112, 74, 69, 84, 25, + 93, 88, -75, 9, 46, 2, 49, 88, -116, -67, 7, -19, -83, 60, 38, 3, -34, 2, + 66, -95, 27, -98, 13, 4, -17, 55, 33, 109, 11, 11, -2, -128, 121, 123, 62, + 91, 120, -128, 127, 122, 115, 102, 2, 119, 0, -116, -113, -119, 6, 102, + 121, -108, -126, 5, 18, 6, 4, -102, -101, -100, 114, 15, 17, 0, 59 + }; + + + /** + * main() method for running this class from the command line. + *

+ * The options shown here are not yet finalized and will be + * changing over the next several releases. + *

+ * The simplest way to turn and applet into an application is to + * add the following code to your program: + * 

static public void main(String args[]) {
+   *   PApplet.main(new String[] { "YourSketchName" });
+   * }
+ * This will properly launch your applet from a double-clickable + * .jar or from the command line. + * 
+   * Parameters useful for launching or also used by the PDE:
+   *
+   * --location=x,y        upper-lefthand corner of where the applet
+   *                       should appear on screen. if not used,
+   *                       the default is to center on the main screen.
+   *
+   * --present             put the applet into full screen presentation
+   *                       mode. requires java 1.4 or later.
+   *
+   * --exclusive           use full screen exclusive mode when presenting.
+   *                       disables new windows or interaction with other
+   *                       monitors, this is like a "game" mode.
+   *
+   * --hide-stop           use to hide the stop button in situations where
+   *                       you don't want to allow users to exit. also
+   *                       see the FAQ on information for capturing the ESC
+   *                       key when running in presentation mode.
+   *
+   * --stop-color=#xxxxxx  color of the 'stop' text used to quit an
+   *                       sketch when it's in present mode.
+   *
+   * --bgcolor=#xxxxxx     background color of the window.
+   *
+   * --sketch-path         location of where to save files from functions
+   *                       like saveStrings() or saveFrame(). defaults to
+   *                       the folder that the java application was
+   *                       launched from, which means if this isn't set by
+   *                       the pde, everything goes into the same folder
+   *                       as processing.exe.
+   *
+   * --display=n           set what display should be used by this applet.
+   *                       displays are numbered starting from 1.
+   *
+   * Parameters used by Processing when running via the PDE
+   *
+   * --external            set when the applet is being used by the PDE
+   *
+   * --editor-location=x,y position of the upper-lefthand corner of the
+   *                       editor window, for placement of applet window
+   *
+ */ + static public void main(String args[]) { + // Disable abyssmally slow Sun renderer on OS X 10.5. + if (platform == MACOSX) { + // Only run this on OS X otherwise it can cause a permissions error. + // http://dev.processing.org/bugs/show_bug.cgi?id=976 + System.setProperty("apple.awt.graphics.UseQuartz", "true"); + } + + // This doesn't do anything. +// if (platform == WINDOWS) { +// // For now, disable the D3D renderer on Java 6u10 because +// // it causes problems with Present mode. +// // http://dev.processing.org/bugs/show_bug.cgi?id=1009 +// System.setProperty("sun.java2d.d3d", "false"); +// } + + if (args.length < 1) { + System.err.println("Usage: PApplet "); + System.err.println("For additional options, " + + "see the Javadoc for PApplet"); + System.exit(1); + } + + boolean external = false; + int[] location = null; + int[] editorLocation = null; + + String name = null; + boolean present = false; + boolean exclusive = false; + Color backgroundColor = Color.BLACK; + Color stopColor = Color.GRAY; + GraphicsDevice displayDevice = null; + boolean hideStop = false; + + String param = null, value = null; + + // try to get the user folder. if running under java web start, + // this may cause a security exception if the code is not signed. + // http://processing.org/discourse/yabb_beta/YaBB.cgi?board=Integrate;action=display;num=1159386274 + String folder = null; + try { + folder = System.getProperty("user.dir"); + } catch (Exception e) { } + + int argIndex = 0; + while (argIndex < args.length) { + int equals = args[argIndex].indexOf('='); + if (equals != -1) { + param = args[argIndex].substring(0, equals); + value = args[argIndex].substring(equals + 1); + + if (param.equals(ARGS_EDITOR_LOCATION)) { + external = true; + editorLocation = parseInt(split(value, ',')); + + } else if (param.equals(ARGS_DISPLAY)) { + int deviceIndex = Integer.parseInt(value) - 1; + + //DisplayMode dm = device.getDisplayMode(); + //if ((dm.getWidth() == 1024) && (dm.getHeight() == 768)) { + + GraphicsEnvironment environment = + GraphicsEnvironment.getLocalGraphicsEnvironment(); + GraphicsDevice devices[] = environment.getScreenDevices(); + if ((deviceIndex >= 0) && (deviceIndex < devices.length)) { + displayDevice = devices[deviceIndex]; + } else { + System.err.println("Display " + value + " does not exist, " + + "using the default display instead."); + } + + } else if (param.equals(ARGS_BGCOLOR)) { + if (value.charAt(0) == '#') value = value.substring(1); + backgroundColor = new Color(Integer.parseInt(value, 16)); + + } else if (param.equals(ARGS_STOP_COLOR)) { + if (value.charAt(0) == '#') value = value.substring(1); + stopColor = new Color(Integer.parseInt(value, 16)); + + } else if (param.equals(ARGS_SKETCH_FOLDER)) { + folder = value; + + } else if (param.equals(ARGS_LOCATION)) { + location = parseInt(split(value, ',')); + } + + } else { + if (args[argIndex].equals(ARGS_PRESENT)) { + present = true; + + } else if (args[argIndex].equals(ARGS_EXCLUSIVE)) { + exclusive = true; + + } else if (args[argIndex].equals(ARGS_HIDE_STOP)) { + hideStop = true; + + } else if (args[argIndex].equals(ARGS_EXTERNAL)) { + external = true; + + } else { + name = args[argIndex]; + break; + } + } + argIndex++; + } + + // Set this property before getting into any GUI init code + //System.setProperty("com.apple.mrj.application.apple.menu.about.name", name); + // This )*)(*@#$ Apple crap don't work no matter where you put it + // (static method of the class, at the top of main, wherever) + + if (displayDevice == null) { + GraphicsEnvironment environment = + GraphicsEnvironment.getLocalGraphicsEnvironment(); + displayDevice = environment.getDefaultScreenDevice(); + } + + Frame frame = new Frame(displayDevice.getDefaultConfiguration()); + /* + Frame frame = null; + if (displayDevice != null) { + frame = new Frame(displayDevice.getDefaultConfiguration()); + } else { + frame = new Frame(); + } + */ + //Dimension screen = Toolkit.getDefaultToolkit().getScreenSize(); + + // remove the grow box by default + // users who want it back can call frame.setResizable(true) + frame.setResizable(false); + + // Set the trimmings around the image + Image image = Toolkit.getDefaultToolkit().createImage(ICON_IMAGE); + frame.setIconImage(image); + frame.setTitle(name); + + final PApplet applet; + try { + Class c = Thread.currentThread().getContextClassLoader().loadClass(name); + applet = (PApplet) c.newInstance(); + } catch (Exception e) { + throw new RuntimeException(e); + } + + // these are needed before init/start + applet.frame = frame; + applet.sketchPath = folder; + applet.args = PApplet.subset(args, 1); + applet.external = external; + + // Need to save the window bounds at full screen, + // because pack() will cause the bounds to go to zero. + // http://dev.processing.org/bugs/show_bug.cgi?id=923 + Rectangle fullScreenRect = null; + + // For 0149, moving this code (up to the pack() method) before init(). + // For OpenGL (and perhaps other renderers in the future), a peer is + // needed before a GLDrawable can be created. So pack() needs to be + // called on the Frame before applet.init(), which itself calls size(), + // and launches the Thread that will kick off setup(). + // http://dev.processing.org/bugs/show_bug.cgi?id=891 + // http://dev.processing.org/bugs/show_bug.cgi?id=908 + if (present) { + frame.setUndecorated(true); + frame.setBackground(backgroundColor); + if (exclusive) { + displayDevice.setFullScreenWindow(frame); + frame.setExtendedState(java.awt.Frame.MAXIMIZED_BOTH); + fullScreenRect = frame.getBounds(); + } else { + DisplayMode mode = displayDevice.getDisplayMode(); + fullScreenRect = new Rectangle(0, 0, mode.getWidth(), mode.getHeight()); + frame.setBounds(fullScreenRect); + frame.setVisible(true); + } + } + frame.setLayout(null); + frame.add(applet); + if (present) { + frame.invalidate(); + } else { + frame.pack(); + } + // insufficient, places the 100x100 sketches offset strangely + //frame.validate(); + + applet.init(); + + // Wait until the applet has figured out its width. + // In a static mode app, this will be after setup() has completed, + // and the empty draw() has set "finished" to true. + // TODO make sure this won't hang if the applet has an exception. + while (applet.defaultSize && !applet.finished) { + //System.out.println("default size"); + try { + Thread.sleep(5); + + } catch (InterruptedException e) { + //System.out.println("interrupt"); + } + } + //println("not default size " + applet.width + " " + applet.height); + //println(" (g width/height is " + applet.g.width + "x" + applet.g.height + ")"); + + if (present) { + // After the pack(), the screen bounds are gonna be 0s + frame.setBounds(fullScreenRect); + applet.setBounds((fullScreenRect.width - applet.width) / 2, + (fullScreenRect.height - applet.height) / 2, + applet.width, applet.height); + + if (!hideStop) { + Label label = new Label("stop"); + label.setForeground(stopColor); + label.addMouseListener(new MouseAdapter() { + public void mousePressed(MouseEvent e) { + System.exit(0); + } + }); + frame.add(label); + + Dimension labelSize = label.getPreferredSize(); + // sometimes shows up truncated on mac + //System.out.println("label width is " + labelSize.width); + labelSize = new Dimension(100, labelSize.height); + label.setSize(labelSize); + label.setLocation(20, fullScreenRect.height - labelSize.height - 20); + } + + // not always running externally when in present mode + if (external) { + applet.setupExternalMessages(); + } + + } else { // if not presenting + // can't do pack earlier cuz present mode don't like it + // (can't go full screen with a frame after calling pack) + // frame.pack(); // get insets. get more. + Insets insets = frame.getInsets(); + + int windowW = Math.max(applet.width, MIN_WINDOW_WIDTH) + + insets.left + insets.right; + int windowH = Math.max(applet.height, MIN_WINDOW_HEIGHT) + + insets.top + insets.bottom; + + frame.setSize(windowW, windowH); + + if (location != null) { + // a specific location was received from PdeRuntime + // (applet has been run more than once, user placed window) + frame.setLocation(location[0], location[1]); + + } else if (external) { + int locationX = editorLocation[0] - 20; + int locationY = editorLocation[1]; + + if (locationX - windowW > 10) { + // if it fits to the left of the window + frame.setLocation(locationX - windowW, locationY); + + } else { // doesn't fit + // if it fits inside the editor window, + // offset slightly from upper lefthand corner + // so that it's plunked inside the text area + locationX = editorLocation[0] + 66; + locationY = editorLocation[1] + 66; + + if ((locationX + windowW > applet.screen.width - 33) || + (locationY + windowH > applet.screen.height - 33)) { + // otherwise center on screen + locationX = (applet.screen.width - windowW) / 2; + locationY = (applet.screen.height - windowH) / 2; + } + frame.setLocation(locationX, locationY); + } + } else { // just center on screen + frame.setLocation((applet.screen.width - applet.width) / 2, + (applet.screen.height - applet.height) / 2); + } + + if (backgroundColor == Color.black) { //BLACK) { + // this means no bg color unless specified + backgroundColor = SystemColor.control; + } + frame.setBackground(backgroundColor); + + int usableWindowH = windowH - insets.top - insets.bottom; + applet.setBounds((windowW - applet.width)/2, + insets.top + (usableWindowH - applet.height)/2, + applet.width, applet.height); + + if (external) { + applet.setupExternalMessages(); + + } else { // !external + frame.addWindowListener(new WindowAdapter() { + public void windowClosing(WindowEvent e) { + System.exit(0); + } + }); + } + + // handle frame resizing events + applet.setupFrameResizeListener(); + + // all set for rockin + if (applet.displayable()) { + frame.setVisible(true); + } + } + + applet.requestFocus(); // ask for keydowns + //System.out.println("exiting main()"); + } + + + ////////////////////////////////////////////////////////////// + + + /** + * Begin recording to a new renderer of the specified type, using the width + * and height of the main drawing surface. + */ + public PGraphics beginRecord(String renderer, String filename) { + filename = insertFrame(filename); + PGraphics rec = createGraphics(width, height, renderer, filename); + beginRecord(rec); + return rec; + } + + + /** + * Begin recording (echoing) commands to the specified PGraphics object. + */ + public void beginRecord(PGraphics recorder) { + this.recorder = recorder; + recorder.beginDraw(); + } + + + public void endRecord() { + if (recorder != null) { + recorder.endDraw(); + recorder.dispose(); + recorder = null; + } + } + + + /** + * Begin recording raw shape data to a renderer of the specified type, + * using the width and height of the main drawing surface. + * + * If hashmarks (###) are found in the filename, they'll be replaced + * by the current frame number (frameCount). + */ + public PGraphics beginRaw(String renderer, String filename) { + filename = insertFrame(filename); + PGraphics rec = createGraphics(width, height, renderer, filename); + g.beginRaw(rec); + return rec; + } + + + /** + * Begin recording raw shape data to the specified renderer. + * + * This simply echoes to g.beginRaw(), but since is placed here (rather than + * generated by preproc.pl) for clarity and so that it doesn't echo the + * command should beginRecord() be in use. + */ + public void beginRaw(PGraphics rawGraphics) { + g.beginRaw(rawGraphics); + } + + + /** + * Stop recording raw shape data to the specified renderer. + * + * This simply echoes to g.beginRaw(), but since is placed here (rather than + * generated by preproc.pl) for clarity and so that it doesn't echo the + * command should beginRecord() be in use. + */ + public void endRaw() { + g.endRaw(); + } + + + ////////////////////////////////////////////////////////////// + + + /** + * Loads the pixel data for the display window into the pixels[] array. This function must always be called before reading from or writing to pixels[]. + *

Certain renderers may or may not seem to require loadPixels() or updatePixels(). However, the rule is that any time you want to manipulate the pixels[] array, you must first call loadPixels(), and after changes have been made, call updatePixels(). Even if the renderer may not seem to use this function in the current Processing release, this will always be subject to change. + * =advanced + * Override the g.pixels[] function to set the pixels[] array + * that's part of the PApplet object. Allows the use of + * pixels[] in the code, rather than g.pixels[]. + * + * @webref image:pixels + * @see processing.core.PApplet#pixels + * @see processing.core.PApplet#updatePixels() + */ + public void loadPixels() { + g.loadPixels(); + pixels = g.pixels; + } + + /** + * Updates the display window with the data in the pixels[] array. Use in conjunction with loadPixels(). If you're only reading pixels from the array, there's no need to call updatePixels() unless there are changes. + *

Certain renderers may or may not seem to require loadPixels() or updatePixels(). However, the rule is that any time you want to manipulate the pixels[] array, you must first call loadPixels(), and after changes have been made, call updatePixels(). 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 updatePixels(), however this may be implemented in the future. + * + * @webref image:pixels + * + * @see processing.core.PApplet#loadPixels() + * @see processing.core.PApplet#updatePixels() + * + */ + public void updatePixels() { + g.updatePixels(); + } + + + public void updatePixels(int x1, int y1, int x2, int y2) { + g.updatePixels(x1, y1, x2, y2); + } + + + ////////////////////////////////////////////////////////////// + + // EVERYTHING BELOW THIS LINE IS AUTOMATICALLY GENERATED. NO TOUCH! + // This includes all of the comments, which are automatically pulled + // from their respective functions in PGraphics or PImage. + + // public functions for processing.core + + + public void flush() { + if (recorder != null) recorder.flush(); + g.flush(); + } + + + /** + * Enable a hint option. + *

+ * For the most part, hints are temporary api quirks, + * for which a proper api hasn't been properly worked out. + * for instance SMOOTH_IMAGES existed because smooth() + * wasn't yet implemented, but it will soon go away. + *

+ * They also exist for obscure features in the graphics + * engine, like enabling/disabling single pixel lines + * that ignore the zbuffer, the way they do in alphabot. + *

+ * Current hint options: + *

    + *
  • DISABLE_DEPTH_TEST - + * turns off the z-buffer in the P3D or OPENGL renderers. + *
+ */ + public void hint(int which) { + if (recorder != null) recorder.hint(which); + g.hint(which); + } + + + /** + * Start a new shape of type POLYGON + */ + public void beginShape() { + if (recorder != null) recorder.beginShape(); + g.beginShape(); + } + + + /** + * Start a new shape. + *

+ * Differences between beginShape() and line() and point() methods. + *

+ * beginShape() is intended to be more flexible at the expense of being + * a little more complicated to use. it handles more complicated shapes + * that can consist of many connected lines (so you get joins) or lines + * mixed with curves. + *

+ * The line() and point() command are for the far more common cases + * (particularly for our audience) that simply need to draw a line + * or a point on the screen. + *

+ * From the code side of things, line() may or may not call beginShape() + * to do the drawing. In the beta code, they do, but in the alpha code, + * they did not. they might be implemented one way or the other depending + * on tradeoffs of runtime efficiency vs. implementation efficiency &mdash + * meaning the speed that things run at vs. the speed it takes me to write + * the code and maintain it. for beta, the latter is most important so + * that's how things are implemented. + */ + public void beginShape(int kind) { + if (recorder != null) recorder.beginShape(kind); + g.beginShape(kind); + } + + + /** + * Sets whether the upcoming vertex is part of an edge. + * Equivalent to glEdgeFlag(), for people familiar with OpenGL. + */ + public void edge(boolean edge) { + if (recorder != null) recorder.edge(edge); + g.edge(edge); + } + + + /** + * Sets the current normal vector. Only applies with 3D rendering + * and inside a beginShape/endShape block. + *

+ * This is for drawing three dimensional shapes and surfaces, + * allowing you to specify a vector perpendicular to the surface + * of the shape, which determines how lighting affects it. + *

+ * For the most part, PGraphics3D will attempt to automatically + * assign normals to shapes, but since that's imperfect, + * this is a better option when you want more control. + *

+ * For people familiar with OpenGL, this function is basically + * identical to glNormal3f(). + */ + public void normal(float nx, float ny, float nz) { + if (recorder != null) recorder.normal(nx, ny, nz); + g.normal(nx, ny, nz); + } + + + /** + * Set texture mode to either to use coordinates based on the IMAGE + * (more intuitive for new users) or NORMALIZED (better for advanced chaps) + */ + public void textureMode(int mode) { + if (recorder != null) recorder.textureMode(mode); + g.textureMode(mode); + } + + + /** + * Set texture image for current shape. + * Needs to be called between @see beginShape and @see endShape + * + * @param image reference to a PImage object + */ + public void texture(PImage image) { + if (recorder != null) recorder.texture(image); + g.texture(image); + } + + + public void vertex(float x, float y) { + if (recorder != null) recorder.vertex(x, y); + g.vertex(x, y); + } + + + public void vertex(float x, float y, float z) { + if (recorder != null) recorder.vertex(x, y, z); + g.vertex(x, y, z); + } + + + /** + * Used by renderer subclasses or PShape to efficiently pass in already + * formatted vertex information. + * @param v vertex parameters, as a float array of length VERTEX_FIELD_COUNT + */ + public void vertex(float[] v) { + if (recorder != null) recorder.vertex(v); + g.vertex(v); + } + + + public void vertex(float x, float y, float u, float v) { + if (recorder != null) recorder.vertex(x, y, u, v); + g.vertex(x, y, u, v); + } + + + public void vertex(float x, float y, float z, float u, float v) { + if (recorder != null) recorder.vertex(x, y, z, u, v); + g.vertex(x, y, z, u, v); + } + + + /** This feature is in testing, do not use or rely upon its implementation */ + public void breakShape() { + if (recorder != null) recorder.breakShape(); + g.breakShape(); + } + + + public void endShape() { + if (recorder != null) recorder.endShape(); + g.endShape(); + } + + + public void endShape(int mode) { + if (recorder != null) recorder.endShape(mode); + g.endShape(mode); + } + + + public void bezierVertex(float x2, float y2, + float x3, float y3, + float x4, float y4) { + if (recorder != null) recorder.bezierVertex(x2, y2, x3, y3, x4, y4); + g.bezierVertex(x2, y2, x3, y3, x4, y4); + } + + + public void bezierVertex(float x2, float y2, float z2, + float x3, float y3, float z3, + float x4, float y4, float z4) { + if (recorder != null) recorder.bezierVertex(x2, y2, z2, x3, y3, z3, x4, y4, z4); + g.bezierVertex(x2, y2, z2, x3, y3, z3, x4, y4, z4); + } + + + public void curveVertex(float x, float y) { + if (recorder != null) recorder.curveVertex(x, y); + g.curveVertex(x, y); + } + + + public void curveVertex(float x, float y, float z) { + if (recorder != null) recorder.curveVertex(x, y, z); + g.curveVertex(x, y, z); + } + + + public void point(float x, float y) { + if (recorder != null) recorder.point(x, y); + g.point(x, y); + } + + + public void point(float x, float y, float z) { + if (recorder != null) recorder.point(x, y, z); + g.point(x, y, z); + } + + + public void line(float x1, float y1, float x2, float y2) { + if (recorder != null) recorder.line(x1, y1, x2, y2); + g.line(x1, y1, x2, y2); + } + + + public void line(float x1, float y1, float z1, + float x2, float y2, float z2) { + if (recorder != null) recorder.line(x1, y1, z1, x2, y2, z2); + g.line(x1, y1, z1, x2, y2, z2); + } + + + public void triangle(float x1, float y1, float x2, float y2, + float x3, float y3) { + if (recorder != null) recorder.triangle(x1, y1, x2, y2, x3, y3); + g.triangle(x1, y1, x2, y2, x3, y3); + } + + + public void quad(float x1, float y1, float x2, float y2, + float x3, float y3, float x4, float y4) { + if (recorder != null) recorder.quad(x1, y1, x2, y2, x3, y3, x4, y4); + g.quad(x1, y1, x2, y2, x3, y3, x4, y4); + } + + + public void rectMode(int mode) { + if (recorder != null) recorder.rectMode(mode); + g.rectMode(mode); + } + + + public void rect(float a, float b, float c, float d) { + if (recorder != null) recorder.rect(a, b, c, d); + g.rect(a, b, c, d); + } + + + public void ellipseMode(int mode) { + if (recorder != null) recorder.ellipseMode(mode); + g.ellipseMode(mode); + } + + + public void ellipse(float a, float b, float c, float d) { + if (recorder != null) recorder.ellipse(a, b, c, d); + g.ellipse(a, b, c, d); + } + + + /** + * Identical parameters and placement to ellipse, + * but draws only an arc of that ellipse. + *

+ * start and stop are always radians because angleMode() was goofy. + * ellipseMode() sets the placement. + *

+ * also tries to be smart about start < stop. + */ + public void arc(float a, float b, float c, float d, + float start, float stop) { + if (recorder != null) recorder.arc(a, b, c, d, start, stop); + g.arc(a, b, c, d, start, stop); + } + + + public void box(float size) { + if (recorder != null) recorder.box(size); + g.box(size); + } + + + public void box(float w, float h, float d) { + if (recorder != null) recorder.box(w, h, d); + g.box(w, h, d); + } + + + public void sphereDetail(int res) { + if (recorder != null) recorder.sphereDetail(res); + g.sphereDetail(res); + } + + + /** + * Set the detail level for approximating a sphere. The ures and vres params + * control the horizontal and vertical resolution. + * + * Code for sphereDetail() submitted by toxi [031031]. + * Code for enhanced u/v version from davbol [080801]. + */ + public void sphereDetail(int ures, int vres) { + if (recorder != null) recorder.sphereDetail(ures, vres); + g.sphereDetail(ures, vres); + } + + + /** + * Draw a sphere with radius r centered at coordinate 0, 0, 0. + *

+ * Implementation notes: + *

+ * cache all the points of the sphere in a static array + * top and bottom are just a bunch of triangles that land + * in the center point + *

+ * sphere is a series of concentric circles who radii vary + * along the shape, based on, er.. cos or something + * 

+   * [toxi 031031] new sphere code. removed all multiplies with
+   * radius, as scale() will take care of that anyway
+   *
+   * [toxi 031223] updated sphere code (removed modulos)
+   * and introduced sphereAt(x,y,z,r)
+   * to avoid additional translate()'s on the user/sketch side
+   *
+   * [davbol 080801] now using separate sphereDetailU/V
+   *
+ */ + public void sphere(float r) { + if (recorder != null) recorder.sphere(r); + g.sphere(r); + } + + + /** + * Evalutes quadratic bezier at point t for points a, b, c, d. + * t varies between 0 and 1, and a and d are the on curve points, + * b and c are the control points. this can be done once with the + * x coordinates and a second time with the y coordinates to get + * the location of a bezier curve at t. + *

+ * For instance, to convert the following example:

+   * stroke(255, 102, 0);
+   * line(85, 20, 10, 10);
+   * line(90, 90, 15, 80);
+   * stroke(0, 0, 0);
+   * bezier(85, 20, 10, 10, 90, 90, 15, 80);
+   *
+   * // draw it in gray, using 10 steps instead of the default 20
+   * // this is a slower way to do it, but useful if you need
+   * // to do things with the coordinates at each step
+   * stroke(128);
+   * beginShape(LINE_STRIP);
+   * for (int i = 0; i <= 10; i++) {
+   *   float t = i / 10.0f;
+   *   float x = bezierPoint(85, 10, 90, 15, t);
+   *   float y = bezierPoint(20, 10, 90, 80, t);
+   *   vertex(x, y);
+   * }
+   * endShape();
+ */ + public float bezierPoint(float a, float b, float c, float d, float t) { + return g.bezierPoint(a, b, c, d, t); + } + + + /** + * Provide the tangent at the given point on the bezier curve. + * Fix from davbol for 0136. + */ + public float bezierTangent(float a, float b, float c, float d, float t) { + return g.bezierTangent(a, b, c, d, t); + } + + + public void bezierDetail(int detail) { + if (recorder != null) recorder.bezierDetail(detail); + g.bezierDetail(detail); + } + + + /** + * Draw a cubic bezier curve. The first and last points are + * the on-curve points. The middle two are the 'control' points, + * or 'handles' in an application like Illustrator. + *

+ * Identical to typing: + * 

beginShape();
+   * vertex(x1, y1);
+   * bezierVertex(x2, y2, x3, y3, x4, y4);
+   * endShape();
+   *
+ * In Postscript-speak, this would be: + * 
moveto(x1, y1);
+   * curveto(x2, y2, x3, y3, x4, y4);
+ * If you were to try and continue that curve like so: + * 
curveto(x5, y5, x6, y6, x7, y7);
+ * This would be done in processing by adding these statements: + * 
bezierVertex(x5, y5, x6, y6, x7, y7)
+   *
+ * To draw a quadratic (instead of cubic) curve, + * use the control point twice by doubling it: + * 
bezier(x1, y1, cx, cy, cx, cy, x2, y2);
+ */ + public void bezier(float x1, float y1, + float x2, float y2, + float x3, float y3, + float x4, float y4) { + if (recorder != null) recorder.bezier(x1, y1, x2, y2, x3, y3, x4, y4); + g.bezier(x1, y1, x2, y2, x3, y3, x4, y4); + } + + + public void bezier(float x1, float y1, float z1, + float x2, float y2, float z2, + float x3, float y3, float z3, + float x4, float y4, float z4) { + if (recorder != null) recorder.bezier(x1, y1, z1, x2, y2, z2, x3, y3, z3, x4, y4, z4); + g.bezier(x1, y1, z1, x2, y2, z2, x3, y3, z3, x4, y4, z4); + } + + + /** + * Get a location along a catmull-rom curve segment. + * + * @param t Value between zero and one for how far along the segment + */ + public float curvePoint(float a, float b, float c, float d, float t) { + return g.curvePoint(a, b, c, d, t); + } + + + /** + * Calculate the tangent at a t value (0..1) on a Catmull-Rom curve. + * Code thanks to Dave Bollinger (Bug #715) + */ + public float curveTangent(float a, float b, float c, float d, float t) { + return g.curveTangent(a, b, c, d, t); + } + + + public void curveDetail(int detail) { + if (recorder != null) recorder.curveDetail(detail); + g.curveDetail(detail); + } + + + public void curveTightness(float tightness) { + if (recorder != null) recorder.curveTightness(tightness); + g.curveTightness(tightness); + } + + + /** + * Draws a segment of Catmull-Rom curve. + *

+ * As of 0070, this function no longer doubles the first and + * last points. The curves are a bit more boring, but it's more + * mathematically correct, and properly mirrored in curvePoint(). + *

+ * Identical to typing out:

+   * beginShape();
+   * curveVertex(x1, y1);
+   * curveVertex(x2, y2);
+   * curveVertex(x3, y3);
+   * curveVertex(x4, y4);
+   * endShape();
+   *
+ */ + public void curve(float x1, float y1, + float x2, float y2, + float x3, float y3, + float x4, float y4) { + if (recorder != null) recorder.curve(x1, y1, x2, y2, x3, y3, x4, y4); + g.curve(x1, y1, x2, y2, x3, y3, x4, y4); + } + + + public void curve(float x1, float y1, float z1, + float x2, float y2, float z2, + float x3, float y3, float z3, + float x4, float y4, float z4) { + if (recorder != null) recorder.curve(x1, y1, z1, x2, y2, z2, x3, y3, z3, x4, y4, z4); + g.curve(x1, y1, z1, x2, y2, z2, x3, y3, z3, x4, y4, z4); + } + + + /** + * If true in PImage, use bilinear interpolation for copy() + * operations. When inherited by PGraphics, also controls shapes. + */ + public void smooth() { + if (recorder != null) recorder.smooth(); + g.smooth(); + } + + + /** + * Disable smoothing. See smooth(). + */ + public void noSmooth() { + if (recorder != null) recorder.noSmooth(); + g.noSmooth(); + } + + + /** + * The mode can only be set to CORNERS, CORNER, and CENTER. + *

+ * Support for CENTER was added in release 0146. + */ + public void imageMode(int mode) { + if (recorder != null) recorder.imageMode(mode); + g.imageMode(mode); + } + + + public void image(PImage image, float x, float y) { + if (recorder != null) recorder.image(image, x, y); + g.image(image, x, y); + } + + + public void image(PImage image, float x, float y, float c, float d) { + if (recorder != null) recorder.image(image, x, y, c, d); + g.image(image, x, y, c, d); + } + + + /** + * Draw an image(), also specifying u/v coordinates. + * In this method, the u, v coordinates are always based on image space + * location, regardless of the current textureMode(). + */ + public void image(PImage image, + float a, float b, float c, float d, + int u1, int v1, int u2, int v2) { + if (recorder != null) recorder.image(image, a, b, c, d, u1, v1, u2, v2); + g.image(image, a, b, c, d, u1, v1, u2, v2); + } + + + /** + * Set the orientation for the shape() command (like imageMode() or rectMode()). + * @param mode Either CORNER, CORNERS, or CENTER. + */ + public void shapeMode(int mode) { + if (recorder != null) recorder.shapeMode(mode); + g.shapeMode(mode); + } + + + public void shape(PShape shape) { + if (recorder != null) recorder.shape(shape); + g.shape(shape); + } + + + /** + * Convenience method to draw at a particular location. + */ + public void shape(PShape shape, float x, float y) { + if (recorder != null) recorder.shape(shape, x, y); + g.shape(shape, x, y); + } + + + public void shape(PShape shape, float x, float y, float c, float d) { + if (recorder != null) recorder.shape(shape, x, y, c, d); + g.shape(shape, x, y, c, d); + } + + + /** + * Sets the alignment of the text to one of LEFT, CENTER, or RIGHT. + * This will also reset the vertical text alignment to BASELINE. + */ + public void textAlign(int align) { + if (recorder != null) recorder.textAlign(align); + g.textAlign(align); + } + + + /** + * Sets the horizontal and vertical alignment of the text. The horizontal + * alignment can be one of LEFT, CENTER, or RIGHT. The vertical alignment + * can be TOP, BOTTOM, CENTER, or the BASELINE (the default). + */ + public void textAlign(int alignX, int alignY) { + if (recorder != null) recorder.textAlign(alignX, alignY); + g.textAlign(alignX, alignY); + } + + + /** + * Returns the ascent of the current font at the current size. + * This is a method, rather than a variable inside the PGraphics object + * because it requires calculation. + */ + public float textAscent() { + return g.textAscent(); + } + + + /** + * Returns the descent of the current font at the current size. + * This is a method, rather than a variable inside the PGraphics object + * because it requires calculation. + */ + public float textDescent() { + return g.textDescent(); + } + + + /** + * Sets the current font. The font's size will be the "natural" + * size of this font (the size that was set when using "Create Font"). + * The leading will also be reset. + */ + public void textFont(PFont which) { + if (recorder != null) recorder.textFont(which); + g.textFont(which); + } + + + /** + * Useful function to set the font and size at the same time. + */ + public void textFont(PFont which, float size) { + if (recorder != null) recorder.textFont(which, size); + g.textFont(which, size); + } + + + /** + * Set the text leading to a specific value. If using a custom + * value for the text leading, you'll have to call textLeading() + * again after any calls to textSize(). + */ + public void textLeading(float leading) { + if (recorder != null) recorder.textLeading(leading); + g.textLeading(leading); + } + + + /** + * Sets the text rendering/placement to be either SCREEN (direct + * to the screen, exact coordinates, only use the font's original size) + * or MODEL (the default, where text is manipulated by translate() and + * can have a textSize). The text size cannot be set when using + * textMode(SCREEN), because it uses the pixels directly from the font. + */ + public void textMode(int mode) { + if (recorder != null) recorder.textMode(mode); + g.textMode(mode); + } + + + /** + * Sets the text size, also resets the value for the leading. + */ + public void textSize(float size) { + if (recorder != null) recorder.textSize(size); + g.textSize(size); + } + + + public float textWidth(char c) { + return g.textWidth(c); + } + + + /** + * Return the width of a line of text. If the text has multiple + * lines, this returns the length of the longest line. + */ + public float textWidth(String str) { + return g.textWidth(str); + } + + + /** + * TODO not sure if this stays... + */ + public float textWidth(char[] chars, int start, int length) { + return g.textWidth(chars, start, length); + } + + + /** + * Write text where we just left off. + */ + public void text(char c) { + if (recorder != null) recorder.text(c); + g.text(c); + } + + + /** + * Draw a single character on screen. + * Extremely slow when used with textMode(SCREEN) and Java 2D, + * because loadPixels has to be called first and updatePixels last. + */ + public void text(char c, float x, float y) { + if (recorder != null) recorder.text(c, x, y); + g.text(c, x, y); + } + + + /** + * Draw a single character on screen (with a z coordinate) + */ + public void text(char c, float x, float y, float z) { + if (recorder != null) recorder.text(c, x, y, z); + g.text(c, x, y, z); + } + + + /** + * Write text where we just left off. + */ + public void text(String str) { + if (recorder != null) recorder.text(str); + g.text(str); + } + + + /** + * Draw a chunk of text. + * Newlines that are \n (Unix newline or linefeed char, ascii 10) + * are honored, but \r (carriage return, Windows and Mac OS) are + * ignored. + */ + public void text(String str, float x, float y) { + if (recorder != null) recorder.text(str, x, y); + g.text(str, x, y); + } + + + /** + * Method to draw text from an array of chars. This method will usually be + * more efficient than drawing from a String object, because the String will + * not be converted to a char array before drawing. + */ + public void text(char[] chars, int start, int stop, float x, float y) { + if (recorder != null) recorder.text(chars, start, stop, x, y); + g.text(chars, start, stop, x, y); + } + + + /** + * Same as above but with a z coordinate. + */ + public void text(String str, float x, float y, float z) { + if (recorder != null) recorder.text(str, x, y, z); + g.text(str, x, y, z); + } + + + public void text(char[] chars, int start, int stop, + float x, float y, float z) { + if (recorder != null) recorder.text(chars, start, stop, x, y, z); + g.text(chars, start, stop, x, y, z); + } + + + /** + * 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. + */ + public void text(String str, float x1, float y1, float x2, float y2) { + if (recorder != null) recorder.text(str, x1, y1, x2, y2); + g.text(str, x1, y1, x2, y2); + } + + + public void text(String s, float x1, float y1, float x2, float y2, float z) { + if (recorder != null) recorder.text(s, x1, y1, x2, y2, z); + g.text(s, x1, y1, x2, y2, z); + } + + + public void text(int num, float x, float y) { + if (recorder != null) recorder.text(num, x, y); + g.text(num, x, y); + } + + + public void text(int num, float x, float y, float z) { + if (recorder != null) recorder.text(num, x, y, z); + g.text(num, x, y, z); + } + + + /** + * This does a basic number formatting, to avoid the + * generally ugly appearance of printing floats. + * Users who want more control should use their own nf() cmmand, + * or if they want the long, ugly version of float, + * use String.valueOf() to convert the float to a String first. + */ + public void text(float num, float x, float y) { + if (recorder != null) recorder.text(num, x, y); + g.text(num, x, y); + } + + + public void text(float num, float x, float y, float z) { + if (recorder != null) recorder.text(num, x, y, z); + g.text(num, x, y, z); + } + + + /** + * Push a copy of the current transformation matrix onto the stack. + */ + public void pushMatrix() { + if (recorder != null) recorder.pushMatrix(); + g.pushMatrix(); + } + + + /** + * Replace the current transformation matrix with the top of the stack. + */ + public void popMatrix() { + if (recorder != null) recorder.popMatrix(); + g.popMatrix(); + } + + + /** + * Translate in X and Y. + */ + public void translate(float tx, float ty) { + if (recorder != null) recorder.translate(tx, ty); + g.translate(tx, ty); + } + + + /** + * Translate in X, Y, and Z. + */ + public void translate(float tx, float ty, float tz) { + if (recorder != null) recorder.translate(tx, ty, tz); + g.translate(tx, ty, tz); + } + + + /** + * Two dimensional rotation. + * + * Same as rotateZ (this is identical to a 3D rotation along the z-axis) + * but included for clarity. It'd be weird for people drawing 2D graphics + * to be using rotateZ. And they might kick our a-- for the confusion. + * + * Additional background. + */ + public void rotate(float angle) { + if (recorder != null) recorder.rotate(angle); + g.rotate(angle); + } + + + /** + * Rotate around the X axis. + */ + public void rotateX(float angle) { + if (recorder != null) recorder.rotateX(angle); + g.rotateX(angle); + } + + + /** + * Rotate around the Y axis. + */ + public void rotateY(float angle) { + if (recorder != null) recorder.rotateY(angle); + g.rotateY(angle); + } + + + /** + * Rotate around the Z axis. + * + * The functions rotate() and rotateZ() are identical, it's just that it make + * sense to have rotate() and then rotateX() and rotateY() when using 3D; + * nor does it make sense to use a function called rotateZ() if you're only + * doing things in 2D. so we just decided to have them both be the same. + */ + public void rotateZ(float angle) { + if (recorder != null) recorder.rotateZ(angle); + g.rotateZ(angle); + } + + + /** + * Rotate about a vector in space. Same as the glRotatef() function. + */ + public void rotate(float angle, float vx, float vy, float vz) { + if (recorder != null) recorder.rotate(angle, vx, vy, vz); + g.rotate(angle, vx, vy, vz); + } + + + /** + * Scale in all dimensions. + */ + public void scale(float s) { + if (recorder != null) recorder.scale(s); + g.scale(s); + } + + + /** + * Scale in X and Y. Equivalent to scale(sx, sy, 1). + * + * Not recommended for use in 3D, because the z-dimension is just + * scaled by 1, since there's no way to know what else to scale it by. + */ + public void scale(float sx, float sy) { + if (recorder != null) recorder.scale(sx, sy); + g.scale(sx, sy); + } + + + /** + * Scale in X, Y, and Z. + */ + public void scale(float x, float y, float z) { + if (recorder != null) recorder.scale(x, y, z); + g.scale(x, y, z); + } + + + /** + * Set the current transformation matrix to identity. + */ + public void resetMatrix() { + if (recorder != null) recorder.resetMatrix(); + g.resetMatrix(); + } + + + public void applyMatrix(PMatrix source) { + if (recorder != null) recorder.applyMatrix(source); + g.applyMatrix(source); + } + + + public void applyMatrix(PMatrix2D source) { + if (recorder != null) recorder.applyMatrix(source); + g.applyMatrix(source); + } + + + /** + * Apply a 3x2 affine transformation matrix. + */ + public void applyMatrix(float n00, float n01, float n02, + float n10, float n11, float n12) { + if (recorder != null) recorder.applyMatrix(n00, n01, n02, n10, n11, n12); + g.applyMatrix(n00, n01, n02, n10, n11, n12); + } + + + public void applyMatrix(PMatrix3D source) { + if (recorder != null) recorder.applyMatrix(source); + g.applyMatrix(source); + } + + + /** + * Apply a 4x4 transformation matrix. + */ + public void applyMatrix(float n00, float n01, float n02, float n03, + float n10, float n11, float n12, float n13, + float n20, float n21, float n22, float n23, + float n30, float n31, float n32, float n33) { + if (recorder != null) recorder.applyMatrix(n00, n01, n02, n03, n10, n11, n12, n13, n20, n21, n22, n23, n30, n31, n32, n33); + g.applyMatrix(n00, n01, n02, n03, n10, n11, n12, n13, n20, n21, n22, n23, n30, n31, n32, n33); + } + + + public PMatrix getMatrix() { + return g.getMatrix(); + } + + + /** + * Copy the current transformation matrix into the specified target. + * Pass in null to create a new matrix. + */ + public PMatrix2D getMatrix(PMatrix2D target) { + return g.getMatrix(target); + } + + + /** + * Copy the current transformation matrix into the specified target. + * Pass in null to create a new matrix. + */ + public PMatrix3D getMatrix(PMatrix3D target) { + return g.getMatrix(target); + } + + + /** + * Set the current transformation matrix to the contents of another. + */ + public void setMatrix(PMatrix source) { + if (recorder != null) recorder.setMatrix(source); + g.setMatrix(source); + } + + + /** + * Set the current transformation to the contents of the specified source. + */ + public void setMatrix(PMatrix2D source) { + if (recorder != null) recorder.setMatrix(source); + g.setMatrix(source); + } + + + /** + * Set the current transformation to the contents of the specified source. + */ + public void setMatrix(PMatrix3D source) { + if (recorder != null) recorder.setMatrix(source); + g.setMatrix(source); + } + + + /** + * Print the current model (or "transformation") matrix. + */ + public void printMatrix() { + if (recorder != null) recorder.printMatrix(); + g.printMatrix(); + } + + + public void beginCamera() { + if (recorder != null) recorder.beginCamera(); + g.beginCamera(); + } + + + public void endCamera() { + if (recorder != null) recorder.endCamera(); + g.endCamera(); + } + + + public void camera() { + if (recorder != null) recorder.camera(); + g.camera(); + } + + + public void camera(float eyeX, float eyeY, float eyeZ, + float centerX, float centerY, float centerZ, + float upX, float upY, float upZ) { + if (recorder != null) recorder.camera(eyeX, eyeY, eyeZ, centerX, centerY, centerZ, upX, upY, upZ); + g.camera(eyeX, eyeY, eyeZ, centerX, centerY, centerZ, upX, upY, upZ); + } + + + public void printCamera() { + if (recorder != null) recorder.printCamera(); + g.printCamera(); + } + + + public void ortho() { + if (recorder != null) recorder.ortho(); + g.ortho(); + } + + + public void ortho(float left, float right, + float bottom, float top, + float near, float far) { + if (recorder != null) recorder.ortho(left, right, bottom, top, near, far); + g.ortho(left, right, bottom, top, near, far); + } + + + public void perspective() { + if (recorder != null) recorder.perspective(); + g.perspective(); + } + + + public void perspective(float fovy, float aspect, float zNear, float zFar) { + if (recorder != null) recorder.perspective(fovy, aspect, zNear, zFar); + g.perspective(fovy, aspect, zNear, zFar); + } + + + public void frustum(float left, float right, + float bottom, float top, + float near, float far) { + if (recorder != null) recorder.frustum(left, right, bottom, top, near, far); + g.frustum(left, right, bottom, top, near, far); + } + + + public void printProjection() { + if (recorder != null) recorder.printProjection(); + g.printProjection(); + } + + + /** + * Given an x and y coordinate, returns the x position of where + * that point would be placed on screen, once affected by translate(), + * scale(), or any other transformations. + */ + public float screenX(float x, float y) { + return g.screenX(x, y); + } + + + /** + * Given an x and y coordinate, returns the y position of where + * that point would be placed on screen, once affected by translate(), + * scale(), or any other transformations. + */ + public float screenY(float x, float y) { + return g.screenY(x, y); + } + + + /** + * Maps a three dimensional point to its placement on-screen. + *

+ * Given an (x, y, z) coordinate, returns the x position of where + * that point would be placed on screen, once affected by translate(), + * scale(), or any other transformations. + */ + public float screenX(float x, float y, float z) { + return g.screenX(x, y, z); + } + + + /** + * Maps a three dimensional point to its placement on-screen. + *

+ * Given an (x, y, z) coordinate, returns the y position of where + * that point would be placed on screen, once affected by translate(), + * scale(), or any other transformations. + */ + public float screenY(float x, float y, float z) { + return g.screenY(x, y, z); + } + + + /** + * Maps a three dimensional point to its placement on-screen. + *

+ * Given an (x, y, z) coordinate, returns its z value. + * This value can be used to determine if an (x, y, z) coordinate + * is in front or in back of another (x, y, z) coordinate. + * The units are based on how the zbuffer is set up, and don't + * relate to anything "real". They're only useful for in + * comparison to another value obtained from screenZ(), + * or directly out of the zbuffer[]. + */ + public float screenZ(float x, float y, float z) { + return g.screenZ(x, y, z); + } + + + /** + * Returns the model space x value for an x, y, z coordinate. + *

+ * This will give you a coordinate after it has been transformed + * by translate(), rotate(), and camera(), but not yet transformed + * by the projection matrix. For instance, his can be useful for + * figuring out how points in 3D space relate to the edge + * coordinates of a shape. + */ + public float modelX(float x, float y, float z) { + return g.modelX(x, y, z); + } + + + /** + * Returns the model space y value for an x, y, z coordinate. + */ + public float modelY(float x, float y, float z) { + return g.modelY(x, y, z); + } + + + /** + * Returns the model space z value for an x, y, z coordinate. + */ + public float modelZ(float x, float y, float z) { + return g.modelZ(x, y, z); + } + + + public void pushStyle() { + if (recorder != null) recorder.pushStyle(); + g.pushStyle(); + } + + + public void popStyle() { + if (recorder != null) recorder.popStyle(); + g.popStyle(); + } + + + public void style(PStyle s) { + if (recorder != null) recorder.style(s); + g.style(s); + } + + + public void strokeWeight(float weight) { + if (recorder != null) recorder.strokeWeight(weight); + g.strokeWeight(weight); + } + + + public void strokeJoin(int join) { + if (recorder != null) recorder.strokeJoin(join); + g.strokeJoin(join); + } + + + public void strokeCap(int cap) { + if (recorder != null) recorder.strokeCap(cap); + g.strokeCap(cap); + } + + + public void noStroke() { + if (recorder != null) recorder.noStroke(); + g.noStroke(); + } + + + /** + * Set the tint to either a grayscale or ARGB value. + * See notes attached to the fill() function. + */ + public void stroke(int rgb) { + if (recorder != null) recorder.stroke(rgb); + g.stroke(rgb); + } + + + public void stroke(int rgb, float alpha) { + if (recorder != null) recorder.stroke(rgb, alpha); + g.stroke(rgb, alpha); + } + + + public void stroke(float gray) { + if (recorder != null) recorder.stroke(gray); + g.stroke(gray); + } + + + public void stroke(float gray, float alpha) { + if (recorder != null) recorder.stroke(gray, alpha); + g.stroke(gray, alpha); + } + + + public void stroke(float x, float y, float z) { + if (recorder != null) recorder.stroke(x, y, z); + g.stroke(x, y, z); + } + + + public void stroke(float x, float y, float z, float a) { + if (recorder != null) recorder.stroke(x, y, z, a); + g.stroke(x, y, z, a); + } + + + public void noTint() { + if (recorder != null) recorder.noTint(); + g.noTint(); + } + + + /** + * Set the tint to either a grayscale or ARGB value. + */ + public void tint(int rgb) { + if (recorder != null) recorder.tint(rgb); + g.tint(rgb); + } + + + public void tint(int rgb, float alpha) { + if (recorder != null) recorder.tint(rgb, alpha); + g.tint(rgb, alpha); + } + + + public void tint(float gray) { + if (recorder != null) recorder.tint(gray); + g.tint(gray); + } + + + public void tint(float gray, float alpha) { + if (recorder != null) recorder.tint(gray, alpha); + g.tint(gray, alpha); + } + + + public void tint(float x, float y, float z) { + if (recorder != null) recorder.tint(x, y, z); + g.tint(x, y, z); + } + + + public void tint(float x, float y, float z, float a) { + if (recorder != null) recorder.tint(x, y, z, a); + g.tint(x, y, z, a); + } + + + public void noFill() { + if (recorder != null) recorder.noFill(); + g.noFill(); + } + + + /** + * Set the fill to either a grayscale value or an ARGB int. + */ + public void fill(int rgb) { + if (recorder != null) recorder.fill(rgb); + g.fill(rgb); + } + + + public void fill(int rgb, float alpha) { + if (recorder != null) recorder.fill(rgb, alpha); + g.fill(rgb, alpha); + } + + + public void fill(float gray) { + if (recorder != null) recorder.fill(gray); + g.fill(gray); + } + + + public void fill(float gray, float alpha) { + if (recorder != null) recorder.fill(gray, alpha); + g.fill(gray, alpha); + } + + + public void fill(float x, float y, float z) { + if (recorder != null) recorder.fill(x, y, z); + g.fill(x, y, z); + } + + + public void fill(float x, float y, float z, float a) { + if (recorder != null) recorder.fill(x, y, z, a); + g.fill(x, y, z, a); + } + + + public void ambient(int rgb) { + if (recorder != null) recorder.ambient(rgb); + g.ambient(rgb); + } + + + public void ambient(float gray) { + if (recorder != null) recorder.ambient(gray); + g.ambient(gray); + } + + + public void ambient(float x, float y, float z) { + if (recorder != null) recorder.ambient(x, y, z); + g.ambient(x, y, z); + } + + + public void specular(int rgb) { + if (recorder != null) recorder.specular(rgb); + g.specular(rgb); + } + + + public void specular(float gray) { + if (recorder != null) recorder.specular(gray); + g.specular(gray); + } + + + public void specular(float x, float y, float z) { + if (recorder != null) recorder.specular(x, y, z); + g.specular(x, y, z); + } + + + public void shininess(float shine) { + if (recorder != null) recorder.shininess(shine); + g.shininess(shine); + } + + + public void emissive(int rgb) { + if (recorder != null) recorder.emissive(rgb); + g.emissive(rgb); + } + + + public void emissive(float gray) { + if (recorder != null) recorder.emissive(gray); + g.emissive(gray); + } + + + public void emissive(float x, float y, float z) { + if (recorder != null) recorder.emissive(x, y, z); + g.emissive(x, y, z); + } + + + public void lights() { + if (recorder != null) recorder.lights(); + g.lights(); + } + + + public void noLights() { + if (recorder != null) recorder.noLights(); + g.noLights(); + } + + + public void ambientLight(float red, float green, float blue) { + if (recorder != null) recorder.ambientLight(red, green, blue); + g.ambientLight(red, green, blue); + } + + + public void ambientLight(float red, float green, float blue, + float x, float y, float z) { + if (recorder != null) recorder.ambientLight(red, green, blue, x, y, z); + g.ambientLight(red, green, blue, x, y, z); + } + + + public void directionalLight(float red, float green, float blue, + float nx, float ny, float nz) { + if (recorder != null) recorder.directionalLight(red, green, blue, nx, ny, nz); + g.directionalLight(red, green, blue, nx, ny, nz); + } + + + public void pointLight(float red, float green, float blue, + float x, float y, float z) { + if (recorder != null) recorder.pointLight(red, green, blue, x, y, z); + g.pointLight(red, green, blue, x, y, z); + } + + + public void spotLight(float red, float green, float blue, + float x, float y, float z, + float nx, float ny, float nz, + float angle, float concentration) { + if (recorder != null) recorder.spotLight(red, green, blue, x, y, z, nx, ny, nz, angle, concentration); + g.spotLight(red, green, blue, x, y, z, nx, ny, nz, angle, concentration); + } + + + public void lightFalloff(float constant, float linear, float quadratic) { + if (recorder != null) recorder.lightFalloff(constant, linear, quadratic); + g.lightFalloff(constant, linear, quadratic); + } + + + public void lightSpecular(float x, float y, float z) { + if (recorder != null) recorder.lightSpecular(x, y, z); + g.lightSpecular(x, y, z); + } + + + /** + * Set the background to a gray or ARGB color. + *

+ * For the main drawing surface, the alpha value will be ignored. However, + * alpha can be used on PGraphics objects from createGraphics(). This is + * the only way to set all the pixels partially transparent, for instance. + *

+ * Note that background() should be called before any transformations occur, + * because some implementations may require the current transformation matrix + * to be identity before drawing. + */ + public void background(int rgb) { + if (recorder != null) recorder.background(rgb); + g.background(rgb); + } + + + /** + * See notes about alpha in background(x, y, z, a). + */ + public void background(int rgb, float alpha) { + if (recorder != null) recorder.background(rgb, alpha); + g.background(rgb, alpha); + } + + + /** + * Set the background to a grayscale value, based on the + * current colorMode. + */ + public void background(float gray) { + if (recorder != null) recorder.background(gray); + g.background(gray); + } + + + /** + * See notes about alpha in background(x, y, z, a). + */ + public void background(float gray, float alpha) { + if (recorder != null) recorder.background(gray, alpha); + g.background(gray, alpha); + } + + + /** + * Set the background to an r, g, b or h, s, b value, + * based on the current colorMode. + */ + public void background(float x, float y, float z) { + if (recorder != null) recorder.background(x, y, z); + g.background(x, y, z); + } + + + /** + * Clear the background with a color that includes an alpha value. This can + * only be used with objects created by createGraphics(), because the main + * drawing surface cannot be set transparent. + *

+ * It might be tempting to use this function to partially clear the screen + * on each frame, however that's not how this function works. When calling + * background(), the pixels will be replaced with pixels that have that level + * of transparency. To do a semi-transparent overlay, use fill() with alpha + * and draw a rectangle. + */ + public void background(float x, float y, float z, float a) { + if (recorder != null) recorder.background(x, y, z, a); + g.background(x, y, z, a); + } + + + /** + * 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. Using image.filter(OPAQUE) will handle this easily. + *

+ * When using 3D, this will also clear the zbuffer (if it exists). + */ + public void background(PImage image) { + if (recorder != null) recorder.background(image); + g.background(image); + } + + + public void colorMode(int mode) { + if (recorder != null) recorder.colorMode(mode); + g.colorMode(mode); + } + + + public void colorMode(int mode, float max) { + if (recorder != null) recorder.colorMode(mode, max); + g.colorMode(mode, max); + } + + + /** + * Set the colorMode and the maximum values for (r, g, b) + * or (h, s, b). + *

+ * Note that this doesn't set the maximum for the alpha value, + * which might be confusing if for instance you switched to + * 

colorMode(HSB, 360, 100, 100);
+ * because the alpha values were still between 0 and 255. + */ + public void colorMode(int mode, float maxX, float maxY, float maxZ) { + if (recorder != null) recorder.colorMode(mode, maxX, maxY, maxZ); + g.colorMode(mode, maxX, maxY, maxZ); + } + + + public void colorMode(int mode, + float maxX, float maxY, float maxZ, float maxA) { + if (recorder != null) recorder.colorMode(mode, maxX, maxY, maxZ, maxA); + g.colorMode(mode, maxX, maxY, maxZ, maxA); + } + + + public final float alpha(int what) { + return g.alpha(what); + } + + + public final float red(int what) { + return g.red(what); + } + + + public final float green(int what) { + return g.green(what); + } + + + public final float blue(int what) { + return g.blue(what); + } + + + public final float hue(int what) { + return g.hue(what); + } + + + public final float saturation(int what) { + return g.saturation(what); + } + + + public final float brightness(int what) { + return g.brightness(what); + } + + + /** + * Interpolate between two colors, using the current color mode. + */ + public int lerpColor(int c1, int c2, float amt) { + return g.lerpColor(c1, c2, amt); + } + + + /** + * Interpolate between two colors. Like lerp(), but for the + * individual color components of a color supplied as an int value. + */ + static public int lerpColor(int c1, int c2, float amt, int mode) { + return PGraphics.lerpColor(c1, c2, amt, mode); + } + + + /** + * Return true if this renderer should be drawn to the screen. Defaults to + * returning true, since nearly all renderers are on-screen beasts. But can + * be overridden for subclasses like PDF so that a window doesn't open up. + *

+ * A better name? showFrame, displayable, isVisible, visible, shouldDisplay, + * what to call this? + */ + public boolean displayable() { + return g.displayable(); + } + + + /** + * Store data of some kind for a renderer that requires extra metadata of + * some kind. Usually this is a renderer-specific representation of the + * image data, for instance a BufferedImage with tint() settings applied for + * PGraphicsJava2D, or resized image data and OpenGL texture indices for + * PGraphicsOpenGL. + */ + public void setCache(Object parent, Object storage) { + if (recorder != null) recorder.setCache(parent, storage); + g.setCache(parent, storage); + } + + + /** + * Get cache storage data for the specified renderer. Because each renderer + * will cache data in different formats, it's necessary to store cache data + * keyed by the renderer object. Otherwise, attempting to draw the same + * image to both a PGraphicsJava2D and a PGraphicsOpenGL will cause errors. + * @param parent The PGraphics object (or any object, really) associated + * @return data stored for the specified parent + */ + public Object getCache(Object parent) { + return g.getCache(parent); + } + + + /** + * Remove information associated with this renderer from the cache, if any. + * @param parent The PGraphics object whose cache data should be removed + */ + public void removeCache(Object parent) { + if (recorder != null) recorder.removeCache(parent); + g.removeCache(parent); + } + + + /** + * Returns an ARGB "color" type (a packed 32 bit int with the color. + * If the coordinate is outside the image, zero is returned + * (black, but completely transparent). + *

+ * If the image is in RGB format (i.e. on a PVideo object), + * the value will get its high bits set, just to avoid cases where + * they haven't been set already. + *

+ * If the image is in ALPHA format, this returns a white with its + * alpha value set. + *

+ * This function is included primarily for beginners. It is quite + * slow because it has to check to see if the x, y that was provided + * is inside the bounds, and then has to check to see what image + * type it is. If you want things to be more efficient, access the + * pixels[] array directly. + */ + public int get(int x, int y) { + return g.get(x, y); + } + + + /** + * Reads the color of any pixel or grabs a group of pixels. If no parameters are specified, the entire image is returned. Get the value of one pixel by specifying an x,y coordinate. Get a section of the display window by specifing an additional width and height parameter. 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. Even though you may have drawn a shape with colorMode(HSB), the numbers returned will be in RGB. + *

Getting the color of a single pixel with get(x, y) is easy, but not as fast as grabbing the data directly from pixels[]. The equivalent statement to "get(x, y)" using pixels[] is "pixels[y*width+x]". Processing requires calling loadPixels() to load the display window data into the pixels[] array before getting the values. + *

As of release 0149, this function ignores imageMode(). + * + * @webref + * @brief Reads the color of any pixel or grabs a rectangle of pixels + * @param x x-coordinate of the pixel + * @param y y-coordinate of the pixel + * @param w width of pixel rectangle to get + * @param h height of pixel rectangle to get + * + * @see processing.core.PImage#set(int, int, int) + * @see processing.core.PImage#pixels + * @see processing.core.PImage#copy(PImage, int, int, int, int, int, int, int, int) + */ + public PImage get(int x, int y, int w, int h) { + return g.get(x, y, w, h); + } + + + /** + * Returns a copy of this PImage. Equivalent to get(0, 0, width, height). + */ + public PImage get() { + return g.get(); + } + + + /** + * Changes the color of any pixel or writes an image directly into the image. The x and y parameter specify the pixel or the upper-left corner of the image. The color parameter specifies the color value.

Setting the color of a single pixel with set(x, y) is easy, but not as fast as putting the data directly into pixels[]. The equivalent statement to "set(x, y, #000000)" using pixels[] is "pixels[y*width+x] = #000000". Processing requires calling loadPixels() to load the display window data into the pixels[] array before getting the values and calling updatePixels() to update the window. + *

As of release 0149, this function ignores imageMode(). + * + * @webref + * @brief Writes a color to any pixel or writes an image into another + * @param x x-coordinate of the pixel or upper-left corner of the image + * @param y y-coordinate of the pixel or upper-left corner of the image + * @param c any value of the color datatype + * + * @see processing.core.PImage#get(int, int, int, int) + * @see processing.core.PImage#pixels + * @see processing.core.PImage#copy(PImage, int, int, int, int, int, int, int, int) + */ + public void set(int x, int y, int c) { + if (recorder != null) recorder.set(x, y, c); + g.set(x, y, c); + } + + + /** + * Efficient method of drawing an image's pixels directly to this surface. + * No variations are employed, meaning that any scale, tint, or imageMode + * settings will be ignored. + */ + public void set(int x, int y, PImage src) { + if (recorder != null) recorder.set(x, y, src); + g.set(x, y, src); + } + + + /** + * Set alpha channel for an image. Black colors in the source + * image will make the destination image completely transparent, + * and white will make things fully opaque. Gray values will + * be in-between steps. + *

+ * Strictly speaking the "blue" value from the source image is + * used as the alpha color. For a fully grayscale image, this + * is correct, but for a color image it's not 100% accurate. + * For a more accurate conversion, first use filter(GRAY) + * which will make the image into a "correct" grayscale by + * performing a proper luminance-based conversion. + * + * @param maskArray any array of Integer numbers used as the alpha channel, needs to be same length as the image's pixel array + */ + public void mask(int maskArray[]) { + if (recorder != null) recorder.mask(maskArray); + g.mask(maskArray); + } + + + /** + * Masks part of an image from displaying by loading another image and 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 same length as the target image's pixels array and should contain only grayscale data of values between 0-255. + * @webref + * @brief Masks part of the image from displaying + * @param maskImg any PImage object used as the alpha channel for "img", needs to be same size as "img" + */ + public void mask(PImage maskImg) { + if (recorder != null) recorder.mask(maskImg); + g.mask(maskImg); + } + + + public void filter(int kind) { + if (recorder != null) recorder.filter(kind); + g.filter(kind); + } + + + /** + * Filters an image as defined by one of the following modes:

THRESHOLD - converts the image to black and white pixels depending if 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 + * =advanced + * Method to apply a variety of basic filters to this image. + *

+ *

    + *
  • filter(BLUR) provides a basic blur. + *
  • filter(GRAY) converts the image to grayscale based on luminance. + *
  • filter(INVERT) will invert the color components in the image. + *
  • filter(OPAQUE) set all the high bits in the image to opaque + *
  • filter(THRESHOLD) converts the image to black and white. + *
  • filter(DILATE) grow white/light areas + *
  • filter(ERODE) shrink white/light areas + *
+ * Luminance conversion code contributed by + * toxi + *

+ * Gaussian blur code contributed by + * Mario Klingemann + * + * @webref + * @brief Converts the image to grayscale or black and white + * @param kind Either THRESHOLD, GRAY, INVERT, POSTERIZE, BLUR, OPAQUE, ERODE, or DILATE + * @param param in the range from 0 to 1 + */ + public void filter(int kind, float param) { + if (recorder != null) recorder.filter(kind, param); + g.filter(kind, param); + } + + + /** + * Copy things from one area of this image + * to another area in the same image. + */ + public void copy(int sx, int sy, int sw, int sh, + int dx, int dy, int dw, int dh) { + if (recorder != null) recorder.copy(sx, sy, sw, sh, dx, dy, dw, dh); + g.copy(sx, sy, sw, sh, dx, dy, dw, dh); + } + + + /** + * Copies a region of pixels from one image into another. If the source and destination regions aren't the same size, it will automatically resize 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 imageMode(). + * + * @webref + * @brief Copies the entire image + * @param sx X coordinate of the source's upper left corner + * @param sy Y coordinate of the source's upper left corner + * @param sw source image width + * @param sh source image height + * @param dx X coordinate of the destination's upper left corner + * @param dy Y coordinate of the destination's upper left corner + * @param dw destination image width + * @param dh destination image height + * @param src an image variable referring to the source image. + * + * @see processing.core.PApplet#alpha(int) + * @see processing.core.PApplet#blend(PImage, int, int, int, int, int, int, int, int, int) + */ + public void copy(PImage src, + int sx, int sy, int sw, int sh, + int dx, int dy, int dw, int dh) { + if (recorder != null) recorder.copy(src, sx, sy, sw, sh, dx, dy, dw, dh); + g.copy(src, sx, sy, sw, sh, dx, dy, dw, dh); + } + + + /** + * Blend two colors based on a particular mode. + *

    + *
  • REPLACE - destination colour equals colour of source pixel: C = A. + * Sometimes called "Normal" or "Copy" in other software. + * + *
  • BLEND - linear interpolation of colours: + * C = A*factor + B + * + *
  • ADD - additive blending with white clip: + * C = min(A*factor + B, 255). + * Clipped to 0..255, Photoshop calls this "Linear Burn", + * and Director calls it "Add Pin". + * + *
  • SUBTRACT - substractive blend with black clip: + * C = max(B - A*factor, 0). + * Clipped to 0..255, Photoshop calls this "Linear Dodge", + * and Director calls it "Subtract Pin". + * + *
  • DARKEST - only the darkest colour succeeds: + * C = min(A*factor, B). + * Illustrator calls this "Darken". + * + *
  • LIGHTEST - only the lightest colour succeeds: + * C = max(A*factor, B). + * Illustrator calls this "Lighten". + * + *
  • 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. + *
+ *

A useful reference for blending modes and their algorithms can be + * found in the SVG + * specification.

+ *

It is important to note that Processing uses "fast" code, not + * necessarily "correct" code. No biggie, most software does. A nitpicker + * can find numerous "off by 1 division" problems in the blend code where + * >>8 or >>7 is used when strictly speaking + * /255.0 or /127.0 should have been used.

+ *

For instance, exclusion (not intended for real-time use) reads + * r1 + r2 - ((2 * r1 * r2) / 255) because 255 == 1.0 + * not 256 == 1.0. In other words, (255*255)>>8 is not + * the same as (255*255)/255. But for real-time use the shifts + * are preferrable, and the difference is insignificant for applications + * built with Processing.

+ */ + static public int blendColor(int c1, int c2, int mode) { + return PGraphics.blendColor(c1, c2, mode); + } + + + /** + * Blends one area of this image to another area. + * + * + * @see processing.core.PImage#blendColor(int,int,int) + */ + public void blend(int sx, int sy, int sw, int sh, + int dx, int dy, int dw, int dh, int mode) { + if (recorder != null) recorder.blend(sx, sy, sw, sh, dx, dy, dw, dh, mode); + g.blend(sx, sy, sw, sh, dx, dy, dw, dh, mode); + } + + + /** + * Blends a region of pixels into the image specified by the img 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 srcImg parameter is not used, the display window is used as the source image.

+ * As of release 0149, this function ignores imageMode(). + * + * @webref + * @brief Copies a pixel or rectangle of pixels using different blending modes + * @param src an image variable referring to the source image + * @param sx X coordinate of the source's upper left corner + * @param sy Y coordinate of the source's upper left corner + * @param sw source image width + * @param sh source image height + * @param dx X coordinate of the destinations's upper left corner + * @param dy Y coordinate of the destinations's upper left corner + * @param dw destination image width + * @param dh destination image height + * @param mode Either BLEND, ADD, SUBTRACT, LIGHTEST, DARKEST, DIFFERENCE, EXCLUSION, MULTIPLY, SCREEN, OVERLAY, HARD_LIGHT, SOFT_LIGHT, DODGE, BURN + * + * @see processing.core.PApplet#alpha(int) + * @see processing.core.PApplet#copy(PImage, int, int, int, int, int, int, int, int) + * @see processing.core.PImage#blendColor(int,int,int) + */ + public void blend(PImage src, + int sx, int sy, int sw, int sh, + int dx, int dy, int dw, int dh, int mode) { + if (recorder != null) recorder.blend(src, sx, sy, sw, sh, dx, dy, dw, dh, mode); + g.blend(src, sx, sy, sw, sh, dx, dy, dw, dh, mode); + } +} diff --git a/core/methods/demo/PGraphics.java b/core/methods/demo/PGraphics.java new file mode 100644 index 000000000..95834f24b --- /dev/null +++ b/core/methods/demo/PGraphics.java @@ -0,0 +1,5075 @@ +/* -*- mode: java; c-basic-offset: 2; indent-tabs-mode: nil -*- */ + +/* + Part of the Processing project - http://processing.org + + Copyright (c) 2004-09 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.*; +import java.util.HashMap; + + +/** + * Main graphics and rendering context, as well as the base API implementation for processing "core". + * Use this class if you need to draw into an off-screen graphics buffer. + * A PGraphics object can be constructed with the createGraphics() function. + * The beginDraw() and endDraw() methods (see above example) are necessary to set up the buffer and to finalize it. + * The fields and methods for this class are extensive; + * for a complete list visit the developer's reference: http://dev.processing.org/reference/core/ + * =advanced + * Main graphics and rendering context, as well as the base API implementation. + * + *

Subclassing and initializing PGraphics objects

+ * Starting in release 0149, subclasses of PGraphics are handled differently. + * The constructor for subclasses takes no parameters, instead a series of + * functions are called by the hosting PApplet to specify its attributes. + *
    + *
  • setParent(PApplet) - is called to specify the parent PApplet. + *
  • setPrimary(boolean) - called with true if this PGraphics will be the + * primary drawing surface used by the sketch, or false if not. + *
  • setPath(String) - called when the renderer needs a filename or output + * path, such as with the PDF or DXF renderers. + *
  • setSize(int, int) - this is called last, at which point it's safe for + * the renderer to complete its initialization routine. + *
+ * The functions were broken out because of the growing number of parameters + * such as these that might be used by a renderer, yet with the exception of + * setSize(), it's not clear which will be necessary. So while the size could + * be passed in to the constructor instead of a setSize() function, a function + * would still be needed that would notify the renderer that it was time to + * finish its initialization. Thus, setSize() simply does both. + * + *

Know your rights: public vs. private methods

+ * Methods that are protected are often subclassed by other renderers, however + * they are not set 'public' because they shouldn't be part of the user-facing + * public API accessible from PApplet. That is, we don't want sketches calling + * textModeCheck() or vertexTexture() directly. + * + *

Handling warnings and exceptions

+ * Methods that are unavailable generally show a warning, unless their lack of + * availability will soon cause another exception. For instance, if a method + * like getMatrix() returns null because it is unavailable, an exception will + * be thrown stating that the method is unavailable, rather than waiting for + * the NullPointerException that will occur when the sketch tries to use that + * method. As of release 0149, warnings will only be shown once, and exceptions + * have been changed to warnings where possible. + * + *

Using xxxxImpl() for subclassing smoothness

+ * The xxxImpl() methods are generally renderer-specific handling for some + * subset if tasks for a particular function (vague enough for you?) For + * instance, imageImpl() handles drawing an image whose x/y/w/h and u/v coords + * have been specified, and screen placement (independent of imageMode) has + * been determined. There's no point in all renderers implementing the + * if (imageMode == BLAH) placement/sizing logic, so that's handled + * by PGraphics, which then calls imageImpl() once all that is figured out. + * + *

His brother PImage

+ * PGraphics subclasses PImage so that it can be drawn and manipulated in a + * similar fashion. As such, many methods are inherited from PGraphics, + * though many are unavailable: for instance, resize() is not likely to be + * implemented; the same goes for mask(), depending on the situation. + * + *

What's in PGraphics, what ain't

+ * For the benefit of subclasses, as much as possible has been placed inside + * PGraphics. For instance, bezier interpolation code and implementations of + * the strokeCap() method (that simply sets the strokeCap variable) are + * handled here. Features that will vary widely between renderers are located + * inside the subclasses themselves. For instance, all matrix handling code + * is per-renderer: Java 2D uses its own AffineTransform, P2D uses a PMatrix2D, + * and PGraphics3D needs to keep continually update forward and reverse + * transformations. A proper (future) OpenGL implementation will have all its + * matrix madness handled by the card. Lighting also falls under this + * category, however the base material property settings (emissive, specular, + * et al.) are handled in PGraphics because they use the standard colorMode() + * logic. Subclasses should override methods like emissiveFromCalc(), which + * is a point where a valid color has been defined internally, and can be + * applied in some manner based on the calcXxxx values. + * + *

What's in the PGraphics documentation, what ain't

+ * Some things are noted here, some things are not. For public API, always + * refer to the reference + * on Processing.org for proper explanations. No attempt has been made to + * keep the javadoc up to date or complete. It's an enormous task for + * which we simply do not have the time. That is, it's not something that + * to be done once—it's a matter of keeping the multiple references + * synchronized (to say nothing of the translation issues), while targeting + * them for their separate audiences. Ouch. + * + * We're working right now on synchronizing the two references, so the website reference + * is generated from the javadoc comments. Yay. + * + * @webref rendering + * @instanceName graphics any object of the type PGraphics + * @usage Web & Application + * @see processing.core.PApplet#createGraphics(int, int, String) + */ +public class PGraphics extends PImage implements PConstants { + + // ........................................................ + + // width and height are already inherited from PImage + + + /// width minus one (useful for many calculations) + protected int width1; + + /// height minus one (useful for many calculations) + protected int height1; + + /// width * height (useful for many calculations) + public int pixelCount; + + /// true if smoothing is enabled (read-only) + public boolean smooth = false; + + // ........................................................ + + /// true if defaults() has been called a first time + protected boolean settingsInited; + + /// set to a PGraphics object being used inside a beginRaw/endRaw() block + protected PGraphics raw; + + // ........................................................ + + /** path to the file being saved for this renderer (if any) */ + protected String path; + + /** + * true if this is the main drawing surface for a particular sketch. + * This would be set to false for an offscreen buffer or if it were + * created any other way than size(). When this is set, the listeners + * are also added to the sketch. + */ + protected boolean primarySurface; + + // ........................................................ + + /** + * Array of hint[] items. These are hacks to get around various + * temporary workarounds inside the environment. + *

+ * Note that this array cannot be static, as a hint() may result in a + * runtime change specific to a renderer. For instance, calling + * hint(DISABLE_DEPTH_TEST) has to call glDisable() right away on an + * instance of PGraphicsOpenGL. + *

+ * The hints[] array is allocated early on because it might + * be used inside beginDraw(), allocate(), etc. + */ + protected boolean[] hints = new boolean[HINT_COUNT]; + + + //////////////////////////////////////////////////////////// + + // STYLE PROPERTIES + + // Also inherits imageMode() and smooth() (among others) from PImage. + + /** The current colorMode */ + public int colorMode; // = RGB; + + /** Max value for red (or hue) set by colorMode */ + public float colorModeX; // = 255; + + /** Max value for green (or saturation) set by colorMode */ + public float colorModeY; // = 255; + + /** Max value for blue (or value) set by colorMode */ + public float colorModeZ; // = 255; + + /** Max value for alpha set by colorMode */ + public float colorModeA; // = 255; + + /** True if colors are not in the range 0..1 */ + boolean colorModeScale; // = true; + + /** True if colorMode(RGB, 255) */ + boolean colorModeDefault; // = true; + + // ........................................................ + + // Tint color for images + + /** + * True if tint() is enabled (read-only). + * + * Using tint/tintColor seems a better option for naming than + * tintEnabled/tint because the latter seems ugly, even though + * g.tint as the actual color seems a little more intuitive, + * it's just that g.tintEnabled is even more unintuitive. + * Same goes for fill and stroke, et al. + */ + public boolean tint; + + /** tint that was last set (read-only) */ + public int tintColor; + + protected boolean tintAlpha; + protected float tintR, tintG, tintB, tintA; + protected int tintRi, tintGi, tintBi, tintAi; + + // ........................................................ + + // Fill color + + /** true if fill() is enabled, (read-only) */ + public boolean fill; + + /** fill that was last set (read-only) */ + public int fillColor = 0xffFFFFFF; + + protected boolean fillAlpha; + protected float fillR, fillG, fillB, fillA; + protected int fillRi, fillGi, fillBi, fillAi; + + // ........................................................ + + // Stroke color + + /** true if stroke() is enabled, (read-only) */ + public boolean stroke; + + /** stroke that was last set (read-only) */ + public int strokeColor = 0xff000000; + + protected boolean strokeAlpha; + protected float strokeR, strokeG, strokeB, strokeA; + protected int strokeRi, strokeGi, strokeBi, strokeAi; + + // ........................................................ + + // Additional stroke properties + + static protected final float DEFAULT_STROKE_WEIGHT = 1; + static protected final int DEFAULT_STROKE_JOIN = MITER; + static protected final int DEFAULT_STROKE_CAP = ROUND; + + /** + * Last value set by strokeWeight() (read-only). This has a default + * setting, rather than fighting with renderers about whether that + * renderer supports thick lines. + */ + public float strokeWeight = DEFAULT_STROKE_WEIGHT; + + /** + * Set by strokeJoin() (read-only). This has a default setting + * so that strokeJoin() need not be called by defaults, + * because subclasses may not implement it (i.e. PGraphicsGL) + */ + public int strokeJoin = DEFAULT_STROKE_JOIN; + + /** + * Set by strokeCap() (read-only). This has a default setting + * so that strokeCap() need not be called by defaults, + * because subclasses may not implement it (i.e. PGraphicsGL) + */ + public int strokeCap = DEFAULT_STROKE_CAP; + + // ........................................................ + + // Shape placement properties + + // imageMode() is inherited from PImage + + /** The current rect mode (read-only) */ + public int rectMode; + + /** The current ellipse mode (read-only) */ + public int ellipseMode; + + /** The current shape alignment mode (read-only) */ + public int shapeMode; + + /** The current image alignment (read-only) */ + public int imageMode = CORNER; + + // ........................................................ + + // Text and font properties + + /** The current text font (read-only) */ + public PFont textFont; + + /** The current text align (read-only) */ + public int textAlign = LEFT; + + /** The current vertical text alignment (read-only) */ + public int textAlignY = BASELINE; + + /** The current text mode (read-only) */ + public int textMode = MODEL; + + /** The current text size (read-only) */ + public float textSize; + + /** The current text leading (read-only) */ + public float textLeading; + + // ........................................................ + + // Material properties + +// PMaterial material; +// PMaterial[] materialStack; +// int materialStackPointer; + + public float ambientR, ambientG, ambientB; + public float specularR, specularG, specularB; + public float emissiveR, emissiveG, emissiveB; + public float shininess; + + + // Style stack + + static final int STYLE_STACK_DEPTH = 64; + PStyle[] styleStack = new PStyle[STYLE_STACK_DEPTH]; + int styleStackDepth; + + + //////////////////////////////////////////////////////////// + + + /** Last background color that was set, zero if an image */ + public int backgroundColor = 0xffCCCCCC; + + protected boolean backgroundAlpha; + protected float backgroundR, backgroundG, backgroundB, backgroundA; + protected int backgroundRi, backgroundGi, backgroundBi, backgroundAi; + + // ........................................................ + + /** + * Current model-view matrix transformation of the form m[row][column], + * which is a "column vector" (as opposed to "row vector") matrix. + */ +// PMatrix matrix; +// public float m00, m01, m02, m03; +// public float m10, m11, m12, m13; +// public float m20, m21, m22, m23; +// public float m30, m31, m32, m33; + +// static final int MATRIX_STACK_DEPTH = 32; +// float[][] matrixStack = new float[MATRIX_STACK_DEPTH][16]; +// float[][] matrixInvStack = new float[MATRIX_STACK_DEPTH][16]; +// int matrixStackDepth; + + static final int MATRIX_STACK_DEPTH = 32; + + // ........................................................ + + /** + * Java AWT Image object associated with this renderer. For P2D and P3D, + * this will be associated with their MemoryImageSource. For PGraphicsJava2D, + * it will be the offscreen drawing buffer. + */ + public Image image; + + // ........................................................ + + // internal color for setting/calculating + protected float calcR, calcG, calcB, calcA; + protected int calcRi, calcGi, calcBi, calcAi; + protected int calcColor; + protected boolean calcAlpha; + + /** The last RGB value converted to HSB */ + int cacheHsbKey; + /** Result of the last conversion to HSB */ + float[] cacheHsbValue = new float[3]; + + // ........................................................ + + /** + * Type of shape passed to beginShape(), + * zero if no shape is currently being drawn. + */ + protected int shape; + + // vertices + static final int DEFAULT_VERTICES = 512; + protected float vertices[][] = + new float[DEFAULT_VERTICES][VERTEX_FIELD_COUNT]; + protected int vertexCount; // total number of vertices + + // ........................................................ + + protected boolean bezierInited = false; + public int bezierDetail = 20; + + // used by both curve and bezier, so just init here + protected PMatrix3D bezierBasisMatrix = + new PMatrix3D(-1, 3, -3, 1, + 3, -6, 3, 0, + -3, 3, 0, 0, + 1, 0, 0, 0); + + //protected PMatrix3D bezierForwardMatrix; + protected PMatrix3D bezierDrawMatrix; + + // ........................................................ + + protected boolean curveInited = false; + protected int curveDetail = 20; + public float curveTightness = 0; + // catmull-rom basis matrix, perhaps with optional s parameter + protected PMatrix3D curveBasisMatrix; + protected PMatrix3D curveDrawMatrix; + + protected PMatrix3D bezierBasisInverse; + protected PMatrix3D curveToBezierMatrix; + + // ........................................................ + + // spline vertices + + protected float curveVertices[][]; + protected int curveVertexCount; + + // ........................................................ + + // precalculate sin/cos lookup tables [toxi] + // circle resolution is determined from the actual used radii + // passed to ellipse() method. this will automatically take any + // scale transformations into account too + + // [toxi 031031] + // changed table's precision to 0.5 degree steps + // introduced new vars for more flexible code + static final protected float sinLUT[]; + static final protected float cosLUT[]; + static final protected float SINCOS_PRECISION = 0.5f; + static final protected int SINCOS_LENGTH = (int) (360f / SINCOS_PRECISION); + static { + sinLUT = new float[SINCOS_LENGTH]; + cosLUT = new float[SINCOS_LENGTH]; + for (int i = 0; i < SINCOS_LENGTH; i++) { + sinLUT[i] = (float) Math.sin(i * DEG_TO_RAD * SINCOS_PRECISION); + cosLUT[i] = (float) Math.cos(i * DEG_TO_RAD * SINCOS_PRECISION); + } + } + + // ........................................................ + + /** The current font if a Java version of it is installed */ + //protected Font textFontNative; + + /** Metrics for the current native Java font */ + //protected FontMetrics textFontNativeMetrics; + + /** Last text position, because text often mixed on lines together */ + protected float textX, textY, textZ; + + /** + * Internal buffer used by the text() functions + * because the String object is slow + */ + protected char[] textBuffer = new char[8 * 1024]; + protected char[] textWidthBuffer = new char[8 * 1024]; + + protected int textBreakCount; + protected int[] textBreakStart; + protected int[] textBreakStop; + + // ........................................................ + + public boolean edge = true; + + // ........................................................ + + /// normal calculated per triangle + static protected final int NORMAL_MODE_AUTO = 0; + /// one normal manually specified per shape + static protected final int NORMAL_MODE_SHAPE = 1; + /// normals specified for each shape vertex + static protected final int NORMAL_MODE_VERTEX = 2; + + /// Current mode for normals, one of AUTO, SHAPE, or VERTEX + protected int normalMode; + + /// Keep track of how many calls to normal, to determine the mode. + //protected int normalCount; + + /** Current normal vector. */ + public float normalX, normalY, normalZ; + + // ........................................................ + + /** + * Sets whether texture coordinates passed to + * vertex() calls will be based on coordinates that are + * based on the IMAGE or NORMALIZED. + */ + public int textureMode; + + /** + * Current horizontal coordinate for texture, will always + * be between 0 and 1, even if using textureMode(IMAGE). + */ + public float textureU; + + /** Current vertical coordinate for texture, see above. */ + public float textureV; + + /** Current image being used as a texture */ + public PImage textureImage; + + // ........................................................ + + // [toxi031031] new & faster sphere code w/ support flexibile resolutions + // will be set by sphereDetail() or 1st call to sphere() + float sphereX[], sphereY[], sphereZ[]; + + /// Number of U steps (aka "theta") around longitudinally spanning 2*pi + public int sphereDetailU = 0; + /// Number of V steps (aka "phi") along latitudinally top-to-bottom spanning pi + public int sphereDetailV = 0; + + + ////////////////////////////////////////////////////////////// + + // INTERNAL + + + /** + * Constructor for the PGraphics object. Use this to ensure that + * the defaults get set properly. In a subclass, use this(w, h) + * as the first line of a subclass' constructor to properly set + * the internal fields and defaults. + * + */ + public PGraphics() { + } + + + public void setParent(PApplet parent) { // ignore + this.parent = parent; + } + + + /** + * Set (or unset) this as the main drawing surface. Meaning that it can + * safely be set to opaque (and given a default gray background), or anything + * else that goes along with that. + */ + public void setPrimary(boolean primary) { // ignore + this.primarySurface = primary; + + // base images must be opaque (for performance and general + // headache reasons.. argh, a semi-transparent opengl surface?) + // use createGraphics() if you want a transparent surface. + if (primarySurface) { + format = RGB; + } + } + + + public void setPath(String path) { // ignore + this.path = path; + } + + + /** + * The final step in setting up a renderer, set its size of this renderer. + * This was formerly handled by the constructor, but instead it's been broken + * out so that setParent/setPrimary/setPath can be handled differently. + * + * Important that this is ignored by preproc.pl because otherwise it will + * override setSize() in PApplet/Applet/Component, which will 1) not call + * super.setSize(), and 2) will cause the renderer to be resized from the + * event thread (EDT), causing a nasty crash as it collides with the + * animation thread. + */ + public void setSize(int w, int h) { // ignore + width = w; + height = h; + width1 = width - 1; + height1 = height - 1; + + allocate(); + reapplySettings(); + } + + + /** + * Allocate memory for this renderer. Generally will need to be implemented + * for all renderers. + */ + protected void allocate() { } + + + /** + * Handle any takedown for this graphics context. + *

+ * This is called when a sketch is shut down and this renderer was + * specified using the size() command, or inside endRecord() and + * endRaw(), in order to shut things off. + */ + public void dispose() { // ignore + } + + + + ////////////////////////////////////////////////////////////// + + // FRAME + + + /** + * Some renderers have requirements re: when they are ready to draw. + */ + public boolean canDraw() { // ignore + return true; + } + + + /** + * Sets the default properties for a PGraphics object. It should be called before anything is drawn into the object. + * =advanced + *

+ * When creating your own PGraphics, you should call this before + * drawing anything. + * + * @webref + * @brief Sets up the rendering context + */ + public void beginDraw() { // ignore + } + + + /** + * Finalizes the rendering of a PGraphics object so that it can be shown on screen. + * =advanced + *

+ * When creating your own PGraphics, you should call this when + * you're finished drawing. + * + * @webref + * @brief Finalizes the renderering context + */ + public void endDraw() { // ignore + } + + + public void flush() { + // no-op, mostly for P3D to write sorted stuff + } + + + protected void checkSettings() { + if (!settingsInited) defaultSettings(); + } + + + /** + * Set engine's default values. This has to be called by PApplet, + * somewhere inside setup() or draw() because it talks to the + * graphics buffer, meaning that for subclasses like OpenGL, there + * needs to be a valid graphics context to mess with otherwise + * you'll get some good crashing action. + * + * This is currently called by checkSettings(), during beginDraw(). + */ + protected void defaultSettings() { // ignore +// System.out.println("PGraphics.defaultSettings() " + width + " " + height); + + noSmooth(); // 0149 + + colorMode(RGB, 255); + fill(255); + stroke(0); + // other stroke attributes are set in the initializers + // inside the class (see above, strokeWeight = 1 et al) + + // init shape stuff + shape = 0; + + // init matrices (must do before lights) + //matrixStackDepth = 0; + + rectMode(CORNER); + ellipseMode(DIAMETER); + + // no current font + textFont = null; + textSize = 12; + textLeading = 14; + textAlign = LEFT; + textMode = MODEL; + + // if this fella is associated with an applet, then clear its background. + // if it's been created by someone else through createGraphics, + // they have to call background() themselves, otherwise everything gets + // a gray background (when just a transparent surface or an empty pdf + // is what's desired). + // this background() call is for the Java 2D and OpenGL renderers. + if (primarySurface) { + //System.out.println("main drawing surface bg " + getClass().getName()); + background(backgroundColor); + } + + settingsInited = true; + // defaultSettings() overlaps reapplySettings(), don't do both + //reapplySettings = false; + } + + + /** + * Re-apply current settings. Some methods, such as textFont(), require that + * their methods be called (rather than simply setting the textFont variable) + * because they affect the graphics context, or they require parameters from + * the context (e.g. getting native fonts for text). + * + * This will only be called from an allocate(), which is only called from + * size(), which is safely called from inside beginDraw(). And it cannot be + * called before defaultSettings(), so we should be safe. + */ + protected void reapplySettings() { +// System.out.println("attempting reapplySettings()"); + if (!settingsInited) return; // if this is the initial setup, no need to reapply + +// System.out.println(" doing reapplySettings"); +// new Exception().printStackTrace(System.out); + + colorMode(colorMode, colorModeX, colorModeY, colorModeZ); + if (fill) { +// PApplet.println(" fill " + PApplet.hex(fillColor)); + fill(fillColor); + } else { + noFill(); + } + if (stroke) { + stroke(strokeColor); + + // The if() statements should be handled inside the functions, + // otherwise an actual reset/revert won't work properly. + //if (strokeWeight != DEFAULT_STROKE_WEIGHT) { + strokeWeight(strokeWeight); + //} +// if (strokeCap != DEFAULT_STROKE_CAP) { + strokeCap(strokeCap); +// } +// if (strokeJoin != DEFAULT_STROKE_JOIN) { + strokeJoin(strokeJoin); +// } + } else { + noStroke(); + } + if (tint) { + tint(tintColor); + } else { + noTint(); + } + if (smooth) { + smooth(); + } else { + // Don't bother setting this, cuz it'll anger P3D. + noSmooth(); + } + if (textFont != null) { +// System.out.println(" textFont in reapply is " + textFont); + // textFont() resets the leading, so save it in case it's changed + float saveLeading = textLeading; + textFont(textFont, textSize); + textLeading(saveLeading); + } + textMode(textMode); + textAlign(textAlign, textAlignY); + background(backgroundColor); + + //reapplySettings = false; + } + + + ////////////////////////////////////////////////////////////// + + // HINTS + + /** + * Enable a hint option. + *

+ * For the most part, hints are temporary api quirks, + * for which a proper api hasn't been properly worked out. + * for instance SMOOTH_IMAGES existed because smooth() + * wasn't yet implemented, but it will soon go away. + *

+ * They also exist for obscure features in the graphics + * engine, like enabling/disabling single pixel lines + * that ignore the zbuffer, the way they do in alphabot. + *

+ * Current hint options: + *

    + *
  • DISABLE_DEPTH_TEST - + * turns off the z-buffer in the P3D or OPENGL renderers. + *
+ */ + public void hint(int which) { + if (which > 0) { + hints[which] = true; + } else { + hints[-which] = false; + } + } + + + + ////////////////////////////////////////////////////////////// + + // VERTEX SHAPES + + /** + * Start a new shape of type POLYGON + */ + public void beginShape() { + beginShape(POLYGON); + } + + + /** + * Start a new shape. + *

+ * Differences between beginShape() and line() and point() methods. + *

+ * beginShape() is intended to be more flexible at the expense of being + * a little more complicated to use. it handles more complicated shapes + * that can consist of many connected lines (so you get joins) or lines + * mixed with curves. + *

+ * The line() and point() command are for the far more common cases + * (particularly for our audience) that simply need to draw a line + * or a point on the screen. + *

+ * From the code side of things, line() may or may not call beginShape() + * to do the drawing. In the beta code, they do, but in the alpha code, + * they did not. they might be implemented one way or the other depending + * on tradeoffs of runtime efficiency vs. implementation efficiency &mdash + * meaning the speed that things run at vs. the speed it takes me to write + * the code and maintain it. for beta, the latter is most important so + * that's how things are implemented. + */ + public void beginShape(int kind) { + shape = kind; + } + + + /** + * Sets whether the upcoming vertex is part of an edge. + * Equivalent to glEdgeFlag(), for people familiar with OpenGL. + */ + public void edge(boolean edge) { + this.edge = edge; + } + + + /** + * Sets the current normal vector. Only applies with 3D rendering + * and inside a beginShape/endShape block. + *

+ * This is for drawing three dimensional shapes and surfaces, + * allowing you to specify a vector perpendicular to the surface + * of the shape, which determines how lighting affects it. + *

+ * For the most part, PGraphics3D will attempt to automatically + * assign normals to shapes, but since that's imperfect, + * this is a better option when you want more control. + *

+ * For people familiar with OpenGL, this function is basically + * identical to glNormal3f(). + */ + public void normal(float nx, float ny, float nz) { + normalX = nx; + normalY = ny; + normalZ = nz; + + // if drawing a shape and the normal hasn't been set yet, + // then we need to set the normals for each vertex so far + if (shape != 0) { + if (normalMode == NORMAL_MODE_AUTO) { + // either they set the normals, or they don't [0149] +// for (int i = vertex_start; i < vertexCount; i++) { +// vertices[i][NX] = normalX; +// vertices[i][NY] = normalY; +// vertices[i][NZ] = normalZ; +// } + // One normal per begin/end shape + normalMode = NORMAL_MODE_SHAPE; + + } else if (normalMode == NORMAL_MODE_SHAPE) { + // a separate normal for each vertex + normalMode = NORMAL_MODE_VERTEX; + } + } + } + + + /** + * Set texture mode to either to use coordinates based on the IMAGE + * (more intuitive for new users) or NORMALIZED (better for advanced chaps) + */ + public void textureMode(int mode) { + this.textureMode = mode; + } + + + /** + * Set texture image for current shape. + * Needs to be called between @see beginShape and @see endShape + * + * @param image reference to a PImage object + */ + public void texture(PImage image) { + textureImage = image; + } + + + protected void vertexCheck() { + if (vertexCount == vertices.length) { + float temp[][] = new float[vertexCount << 1][VERTEX_FIELD_COUNT]; + System.arraycopy(vertices, 0, temp, 0, vertexCount); + vertices = temp; + } + } + + + public void vertex(float x, float y) { + vertexCheck(); + float[] vertex = vertices[vertexCount]; + + curveVertexCount = 0; + + vertex[X] = x; + vertex[Y] = y; + + vertex[EDGE] = edge ? 1 : 0; + +// if (fill) { +// vertex[R] = fillR; +// vertex[G] = fillG; +// vertex[B] = fillB; +// vertex[A] = fillA; +// } + if (fill || textureImage != null) { + if (textureImage == null) { + vertex[R] = fillR; + vertex[G] = fillG; + vertex[B] = fillB; + vertex[A] = fillA; + } else { + if (tint) { + vertex[R] = tintR; + vertex[G] = tintG; + vertex[B] = tintB; + vertex[A] = tintA; + } else { + vertex[R] = 1; + vertex[G] = 1; + vertex[B] = 1; + vertex[A] = 1; + } + } + } + + if (stroke) { + vertex[SR] = strokeR; + vertex[SG] = strokeG; + vertex[SB] = strokeB; + vertex[SA] = strokeA; + vertex[SW] = strokeWeight; + } + + if (textureImage != null) { + vertex[U] = textureU; + vertex[V] = textureV; + } + + vertexCount++; + } + + + public void vertex(float x, float y, float z) { + vertexCheck(); + float[] vertex = vertices[vertexCount]; + + // only do this if we're using an irregular (POLYGON) shape that + // will go through the triangulator. otherwise it'll do thinks like + // disappear in mathematically odd ways + // http://dev.processing.org/bugs/show_bug.cgi?id=444 + if (shape == POLYGON) { + if (vertexCount > 0) { + float pvertex[] = vertices[vertexCount-1]; + if ((Math.abs(pvertex[X] - x) < EPSILON) && + (Math.abs(pvertex[Y] - y) < EPSILON) && + (Math.abs(pvertex[Z] - z) < EPSILON)) { + // this vertex is identical, don't add it, + // because it will anger the triangulator + return; + } + } + } + + // User called vertex(), so that invalidates anything queued up for curve + // vertices. If this is internally called by curveVertexSegment, + // then curveVertexCount will be saved and restored. + curveVertexCount = 0; + + vertex[X] = x; + vertex[Y] = y; + vertex[Z] = z; + + vertex[EDGE] = edge ? 1 : 0; + + if (fill || textureImage != null) { + if (textureImage == null) { + vertex[R] = fillR; + vertex[G] = fillG; + vertex[B] = fillB; + vertex[A] = fillA; + } else { + if (tint) { + vertex[R] = tintR; + vertex[G] = tintG; + vertex[B] = tintB; + vertex[A] = tintA; + } else { + vertex[R] = 1; + vertex[G] = 1; + vertex[B] = 1; + vertex[A] = 1; + } + } + + vertex[AR] = ambientR; + vertex[AG] = ambientG; + vertex[AB] = ambientB; + + vertex[SPR] = specularR; + vertex[SPG] = specularG; + vertex[SPB] = specularB; + //vertex[SPA] = specularA; + + vertex[SHINE] = shininess; + + vertex[ER] = emissiveR; + vertex[EG] = emissiveG; + vertex[EB] = emissiveB; + } + + if (stroke) { + vertex[SR] = strokeR; + vertex[SG] = strokeG; + vertex[SB] = strokeB; + vertex[SA] = strokeA; + vertex[SW] = strokeWeight; + } + + if (textureImage != null) { + vertex[U] = textureU; + vertex[V] = textureV; + } + + vertex[NX] = normalX; + vertex[NY] = normalY; + vertex[NZ] = normalZ; + + vertex[BEEN_LIT] = 0; + + vertexCount++; + } + + + /** + * Used by renderer subclasses or PShape to efficiently pass in already + * formatted vertex information. + * @param v vertex parameters, as a float array of length VERTEX_FIELD_COUNT + */ + public void vertex(float[] v) { + vertexCheck(); + curveVertexCount = 0; + float[] vertex = vertices[vertexCount]; + System.arraycopy(v, 0, vertex, 0, VERTEX_FIELD_COUNT); + vertexCount++; + } + + + public void vertex(float x, float y, float u, float v) { + vertexTexture(u, v); + vertex(x, y); + } + + + public void vertex(float x, float y, float z, float u, float v) { + vertexTexture(u, v); + vertex(x, y, z); + } + + + /** + * Internal method to copy all style information for the given vertex. + * Can be overridden by subclasses to handle only properties pertinent to + * that renderer. (e.g. no need to copy the emissive color in P2D) + */ +// protected void vertexStyle() { +// } + + + /** + * Set (U, V) coords for the next vertex in the current shape. + * This is ugly as its own function, and will (almost?) always be + * coincident with a call to vertex. As of beta, this was moved to + * the protected method you see here, and called from an optional + * param of and overloaded vertex(). + *

+ * The parameters depend on the current textureMode. When using + * textureMode(IMAGE), the coordinates will be relative to the size + * of the image texture, when used with textureMode(NORMAL), + * they'll be in the range 0..1. + *

+ * Used by both PGraphics2D (for images) and PGraphics3D. + */ + protected void vertexTexture(float u, float v) { + if (textureImage == null) { + throw new RuntimeException("You must first call texture() before " + + "using u and v coordinates with vertex()"); + } + if (textureMode == IMAGE) { + u /= (float) textureImage.width; + v /= (float) textureImage.height; + } + + textureU = u; + textureV = v; + + if (textureU < 0) textureU = 0; + else if (textureU > 1) textureU = 1; + + if (textureV < 0) textureV = 0; + else if (textureV > 1) textureV = 1; + } + + + /** This feature is in testing, do not use or rely upon its implementation */ + public void breakShape() { + showWarning("This renderer cannot currently handle concave shapes, " + + "or shapes with holes."); + } + + + public void endShape() { + endShape(OPEN); + } + + + public void endShape(int mode) { + } + + + + ////////////////////////////////////////////////////////////// + + // CURVE/BEZIER VERTEX HANDLING + + + protected void bezierVertexCheck() { + if (shape == 0 || shape != POLYGON) { + throw new RuntimeException("beginShape() or beginShape(POLYGON) " + + "must be used before bezierVertex()"); + } + if (vertexCount == 0) { + throw new RuntimeException("vertex() must be used at least once" + + "before bezierVertex()"); + } + } + + + public void bezierVertex(float x2, float y2, + float x3, float y3, + float x4, float y4) { + bezierInitCheck(); + bezierVertexCheck(); + PMatrix3D draw = bezierDrawMatrix; + + float[] prev = vertices[vertexCount-1]; + float x1 = prev[X]; + float y1 = prev[Y]; + + float xplot1 = draw.m10*x1 + draw.m11*x2 + draw.m12*x3 + draw.m13*x4; + float xplot2 = draw.m20*x1 + draw.m21*x2 + draw.m22*x3 + draw.m23*x4; + float xplot3 = draw.m30*x1 + draw.m31*x2 + draw.m32*x3 + draw.m33*x4; + + float yplot1 = draw.m10*y1 + draw.m11*y2 + draw.m12*y3 + draw.m13*y4; + float yplot2 = draw.m20*y1 + draw.m21*y2 + draw.m22*y3 + draw.m23*y4; + float yplot3 = draw.m30*y1 + draw.m31*y2 + draw.m32*y3 + draw.m33*y4; + + for (int j = 0; j < bezierDetail; j++) { + x1 += xplot1; xplot1 += xplot2; xplot2 += xplot3; + y1 += yplot1; yplot1 += yplot2; yplot2 += yplot3; + vertex(x1, y1); + } + } + + + public void bezierVertex(float x2, float y2, float z2, + float x3, float y3, float z3, + float x4, float y4, float z4) { + bezierInitCheck(); + bezierVertexCheck(); + PMatrix3D draw = bezierDrawMatrix; + + float[] prev = vertices[vertexCount-1]; + float x1 = prev[X]; + float y1 = prev[Y]; + float z1 = prev[Z]; + + float xplot1 = draw.m10*x1 + draw.m11*x2 + draw.m12*x3 + draw.m13*x4; + float xplot2 = draw.m20*x1 + draw.m21*x2 + draw.m22*x3 + draw.m23*x4; + float xplot3 = draw.m30*x1 + draw.m31*x2 + draw.m32*x3 + draw.m33*x4; + + float yplot1 = draw.m10*y1 + draw.m11*y2 + draw.m12*y3 + draw.m13*y4; + float yplot2 = draw.m20*y1 + draw.m21*y2 + draw.m22*y3 + draw.m23*y4; + float yplot3 = draw.m30*y1 + draw.m31*y2 + draw.m32*y3 + draw.m33*y4; + + float zplot1 = draw.m10*z1 + draw.m11*z2 + draw.m12*z3 + draw.m13*z4; + float zplot2 = draw.m20*z1 + draw.m21*z2 + draw.m22*z3 + draw.m23*z4; + float zplot3 = draw.m30*z1 + draw.m31*z2 + draw.m32*z3 + draw.m33*z4; + + for (int j = 0; j < bezierDetail; j++) { + x1 += xplot1; xplot1 += xplot2; xplot2 += xplot3; + y1 += yplot1; yplot1 += yplot2; yplot2 += yplot3; + z1 += zplot1; zplot1 += zplot2; zplot2 += zplot3; + vertex(x1, y1, z1); + } + } + + + /** + * Perform initialization specific to curveVertex(), and handle standard + * error modes. Can be overridden by subclasses that need the flexibility. + */ + protected void curveVertexCheck() { + if (shape != POLYGON) { + throw new RuntimeException("You must use beginShape() or " + + "beginShape(POLYGON) before curveVertex()"); + } + // to improve code init time, allocate on first use. + if (curveVertices == null) { + curveVertices = new float[128][3]; + } + + if (curveVertexCount == curveVertices.length) { + // Can't use PApplet.expand() cuz it doesn't do the copy properly + float[][] temp = new float[curveVertexCount << 1][3]; + System.arraycopy(curveVertices, 0, temp, 0, curveVertexCount); + curveVertices = temp; + } + curveInitCheck(); + } + + + public void curveVertex(float x, float y) { + curveVertexCheck(); + float[] vertex = curveVertices[curveVertexCount]; + vertex[X] = x; + vertex[Y] = y; + curveVertexCount++; + + // draw a segment if there are enough points + if (curveVertexCount > 3) { + curveVertexSegment(curveVertices[curveVertexCount-4][X], + curveVertices[curveVertexCount-4][Y], + curveVertices[curveVertexCount-3][X], + curveVertices[curveVertexCount-3][Y], + curveVertices[curveVertexCount-2][X], + curveVertices[curveVertexCount-2][Y], + curveVertices[curveVertexCount-1][X], + curveVertices[curveVertexCount-1][Y]); + } + } + + + public void curveVertex(float x, float y, float z) { + curveVertexCheck(); + float[] vertex = curveVertices[curveVertexCount]; + vertex[X] = x; + vertex[Y] = y; + vertex[Z] = z; + curveVertexCount++; + + // draw a segment if there are enough points + if (curveVertexCount > 3) { + curveVertexSegment(curveVertices[curveVertexCount-4][X], + curveVertices[curveVertexCount-4][Y], + curveVertices[curveVertexCount-4][Z], + curveVertices[curveVertexCount-3][X], + curveVertices[curveVertexCount-3][Y], + curveVertices[curveVertexCount-3][Z], + curveVertices[curveVertexCount-2][X], + curveVertices[curveVertexCount-2][Y], + curveVertices[curveVertexCount-2][Z], + curveVertices[curveVertexCount-1][X], + curveVertices[curveVertexCount-1][Y], + curveVertices[curveVertexCount-1][Z]); + } + } + + + /** + * Handle emitting a specific segment of Catmull-Rom curve. This can be + * overridden by subclasses that need more efficient rendering options. + */ + protected void curveVertexSegment(float x1, float y1, + float x2, float y2, + float x3, float y3, + float x4, float y4) { + float x0 = x2; + float y0 = y2; + + PMatrix3D draw = curveDrawMatrix; + + float xplot1 = draw.m10*x1 + draw.m11*x2 + draw.m12*x3 + draw.m13*x4; + float xplot2 = draw.m20*x1 + draw.m21*x2 + draw.m22*x3 + draw.m23*x4; + float xplot3 = draw.m30*x1 + draw.m31*x2 + draw.m32*x3 + draw.m33*x4; + + float yplot1 = draw.m10*y1 + draw.m11*y2 + draw.m12*y3 + draw.m13*y4; + float yplot2 = draw.m20*y1 + draw.m21*y2 + draw.m22*y3 + draw.m23*y4; + float yplot3 = draw.m30*y1 + draw.m31*y2 + draw.m32*y3 + draw.m33*y4; + + // vertex() will reset splineVertexCount, so save it + int savedCount = curveVertexCount; + + vertex(x0, y0); + for (int j = 0; j < curveDetail; j++) { + x0 += xplot1; xplot1 += xplot2; xplot2 += xplot3; + y0 += yplot1; yplot1 += yplot2; yplot2 += yplot3; + vertex(x0, y0); + } + curveVertexCount = savedCount; + } + + + /** + * Handle emitting a specific segment of Catmull-Rom curve. This can be + * overridden by subclasses that need more efficient rendering options. + */ + protected void curveVertexSegment(float x1, float y1, float z1, + float x2, float y2, float z2, + float x3, float y3, float z3, + float x4, float y4, float z4) { + float x0 = x2; + float y0 = y2; + float z0 = z2; + + PMatrix3D draw = curveDrawMatrix; + + float xplot1 = draw.m10*x1 + draw.m11*x2 + draw.m12*x3 + draw.m13*x4; + float xplot2 = draw.m20*x1 + draw.m21*x2 + draw.m22*x3 + draw.m23*x4; + float xplot3 = draw.m30*x1 + draw.m31*x2 + draw.m32*x3 + draw.m33*x4; + + float yplot1 = draw.m10*y1 + draw.m11*y2 + draw.m12*y3 + draw.m13*y4; + float yplot2 = draw.m20*y1 + draw.m21*y2 + draw.m22*y3 + draw.m23*y4; + float yplot3 = draw.m30*y1 + draw.m31*y2 + draw.m32*y3 + draw.m33*y4; + + // vertex() will reset splineVertexCount, so save it + int savedCount = curveVertexCount; + + float zplot1 = draw.m10*z1 + draw.m11*z2 + draw.m12*z3 + draw.m13*z4; + float zplot2 = draw.m20*z1 + draw.m21*z2 + draw.m22*z3 + draw.m23*z4; + float zplot3 = draw.m30*z1 + draw.m31*z2 + draw.m32*z3 + draw.m33*z4; + + vertex(x0, y0, z0); + for (int j = 0; j < curveDetail; j++) { + x0 += xplot1; xplot1 += xplot2; xplot2 += xplot3; + y0 += yplot1; yplot1 += yplot2; yplot2 += yplot3; + z0 += zplot1; zplot1 += zplot2; zplot2 += zplot3; + vertex(x0, y0, z0); + } + curveVertexCount = savedCount; + } + + + + ////////////////////////////////////////////////////////////// + + // SIMPLE SHAPES WITH ANALOGUES IN beginShape() + + + public void point(float x, float y) { + beginShape(POINTS); + vertex(x, y); + endShape(); + } + + + public void point(float x, float y, float z) { + beginShape(POINTS); + vertex(x, y, z); + endShape(); + } + + + public void line(float x1, float y1, float x2, float y2) { + beginShape(LINES); + vertex(x1, y1); + vertex(x2, y2); + endShape(); + } + + + public void line(float x1, float y1, float z1, + float x2, float y2, float z2) { + beginShape(LINES); + vertex(x1, y1, z1); + vertex(x2, y2, z2); + endShape(); + } + + + public void triangle(float x1, float y1, float x2, float y2, + float x3, float y3) { + beginShape(TRIANGLES); + vertex(x1, y1); + vertex(x2, y2); + vertex(x3, y3); + endShape(); + } + + + public void quad(float x1, float y1, float x2, float y2, + float x3, float y3, float x4, float y4) { + beginShape(QUADS); + vertex(x1, y1); + vertex(x2, y2); + vertex(x3, y3); + vertex(x4, y4); + endShape(); + } + + + + ////////////////////////////////////////////////////////////// + + // RECT + + + public void rectMode(int mode) { + rectMode = mode; + } + + + public void rect(float a, float b, float c, float d) { + float hradius, vradius; + switch (rectMode) { + case CORNERS: + break; + case CORNER: + c += a; d += b; + break; + case RADIUS: + hradius = c; + vradius = d; + c = a + hradius; + d = b + vradius; + a -= hradius; + b -= vradius; + break; + case CENTER: + hradius = c / 2.0f; + vradius = d / 2.0f; + c = a + hradius; + d = b + vradius; + a -= hradius; + b -= vradius; + } + + if (a > c) { + float temp = a; a = c; c = temp; + } + + if (b > d) { + float temp = b; b = d; d = temp; + } + + rectImpl(a, b, c, d); + } + + + protected void rectImpl(float x1, float y1, float x2, float y2) { + quad(x1, y1, x2, y1, x2, y2, x1, y2); + } + + + + ////////////////////////////////////////////////////////////// + + // ELLIPSE AND ARC + + + public void ellipseMode(int mode) { + ellipseMode = mode; + } + + + public void ellipse(float a, float b, float c, float d) { + float x = a; + float y = b; + float w = c; + float h = d; + + if (ellipseMode == CORNERS) { + w = c - a; + h = d - b; + + } else if (ellipseMode == RADIUS) { + x = a - c; + y = b - d; + w = c * 2; + h = d * 2; + + } else if (ellipseMode == DIAMETER) { + x = a - c/2f; + y = b - d/2f; + } + + if (w < 0) { // undo negative width + x += w; + w = -w; + } + + if (h < 0) { // undo negative height + y += h; + h = -h; + } + + ellipseImpl(x, y, w, h); + } + + + protected void ellipseImpl(float x, float y, float w, float h) { + } + + + /** + * Identical parameters and placement to ellipse, + * but draws only an arc of that ellipse. + *

+ * start and stop are always radians because angleMode() was goofy. + * ellipseMode() sets the placement. + *

+ * also tries to be smart about start < stop. + */ + public void arc(float a, float b, float c, float d, + float start, float stop) { + float x = a; + float y = b; + float w = c; + float h = d; + + if (ellipseMode == CORNERS) { + w = c - a; + h = d - b; + + } else if (ellipseMode == RADIUS) { + x = a - c; + y = b - d; + w = c * 2; + h = d * 2; + + } else if (ellipseMode == CENTER) { + x = a - c/2f; + y = b - d/2f; + } + + // make sure this loop will exit before starting while + if (Float.isInfinite(start) || Float.isInfinite(stop)) return; +// while (stop < start) stop += TWO_PI; + if (stop < start) return; // why bother + + // make sure that we're starting at a useful point + while (start < 0) { + start += TWO_PI; + stop += TWO_PI; + } + + if (stop - start > TWO_PI) { + start = 0; + stop = TWO_PI; + } + + arcImpl(x, y, w, h, start, stop); + } + + + /** + * Start and stop are in radians, converted by the parent function. + * Note that the radians can be greater (or less) than TWO_PI. + * This is so that an arc can be drawn that crosses zero mark, + * and the user will still collect $200. + */ + protected void arcImpl(float x, float y, float w, float h, + float start, float stop) { + } + + + + ////////////////////////////////////////////////////////////// + + // BOX + + + public void box(float size) { + box(size, size, size); + } + + + // TODO not the least bit efficient, it even redraws lines + // along the vertices. ugly ugly ugly! + public void box(float w, float h, float d) { + float x1 = -w/2f; float x2 = w/2f; + float y1 = -h/2f; float y2 = h/2f; + float z1 = -d/2f; float z2 = d/2f; + + beginShape(QUADS); + + // front + normal(0, 0, 1); + vertex(x1, y1, z1); + vertex(x2, y1, z1); + vertex(x2, y2, z1); + vertex(x1, y2, z1); + + // right + normal(1, 0, 0); + vertex(x2, y1, z1); + vertex(x2, y1, z2); + vertex(x2, y2, z2); + vertex(x2, y2, z1); + + // back + normal(0, 0, -1); + vertex(x2, y1, z2); + vertex(x1, y1, z2); + vertex(x1, y2, z2); + vertex(x2, y2, z2); + + // left + normal(-1, 0, 0); + vertex(x1, y1, z2); + vertex(x1, y1, z1); + vertex(x1, y2, z1); + vertex(x1, y2, z2); + + // top + normal(0, 1, 0); + vertex(x1, y1, z2); + vertex(x2, y1, z2); + vertex(x2, y1, z1); + vertex(x1, y1, z1); + + // bottom + normal(0, -1, 0); + vertex(x1, y2, z1); + vertex(x2, y2, z1); + vertex(x2, y2, z2); + vertex(x1, y2, z2); + + endShape(); + } + + + + ////////////////////////////////////////////////////////////// + + // SPHERE + + + public void sphereDetail(int res) { + sphereDetail(res, res); + } + + + /** + * Set the detail level for approximating a sphere. The ures and vres params + * control the horizontal and vertical resolution. + * + * Code for sphereDetail() submitted by toxi [031031]. + * Code for enhanced u/v version from davbol [080801]. + */ + public void sphereDetail(int ures, int vres) { + if (ures < 3) ures = 3; // force a minimum res + if (vres < 2) vres = 2; // force a minimum res + if ((ures == sphereDetailU) && (vres == sphereDetailV)) return; + + float delta = (float)SINCOS_LENGTH/ures; + float[] cx = new float[ures]; + float[] cz = new float[ures]; + // calc unit circle in XZ plane + for (int i = 0; i < ures; i++) { + cx[i] = cosLUT[(int) (i*delta) % SINCOS_LENGTH]; + cz[i] = sinLUT[(int) (i*delta) % SINCOS_LENGTH]; + } + // computing vertexlist + // vertexlist starts at south pole + int vertCount = ures * (vres-1) + 2; + int currVert = 0; + + // re-init arrays to store vertices + sphereX = new float[vertCount]; + sphereY = new float[vertCount]; + sphereZ = new float[vertCount]; + + float angle_step = (SINCOS_LENGTH*0.5f)/vres; + float angle = angle_step; + + // step along Y axis + for (int i = 1; i < vres; i++) { + float curradius = sinLUT[(int) angle % SINCOS_LENGTH]; + float currY = -cosLUT[(int) angle % SINCOS_LENGTH]; + for (int j = 0; j < ures; j++) { + sphereX[currVert] = cx[j] * curradius; + sphereY[currVert] = currY; + sphereZ[currVert++] = cz[j] * curradius; + } + angle += angle_step; + } + sphereDetailU = ures; + sphereDetailV = vres; + } + + + /** + * Draw a sphere with radius r centered at coordinate 0, 0, 0. + *

+ * Implementation notes: + *

+ * cache all the points of the sphere in a static array + * top and bottom are just a bunch of triangles that land + * in the center point + *

+ * sphere is a series of concentric circles who radii vary + * along the shape, based on, er.. cos or something + * 

+   * [toxi 031031] new sphere code. removed all multiplies with
+   * radius, as scale() will take care of that anyway
+   *
+   * [toxi 031223] updated sphere code (removed modulos)
+   * and introduced sphereAt(x,y,z,r)
+   * to avoid additional translate()'s on the user/sketch side
+   *
+   * [davbol 080801] now using separate sphereDetailU/V
+   *
+ */ + public void sphere(float r) { + if ((sphereDetailU < 3) || (sphereDetailV < 2)) { + sphereDetail(30); + } + + pushMatrix(); + scale(r); + edge(false); + + // 1st ring from south pole + beginShape(TRIANGLE_STRIP); + for (int i = 0; i < sphereDetailU; i++) { + normal(0, -1, 0); + vertex(0, -1, 0); + normal(sphereX[i], sphereY[i], sphereZ[i]); + vertex(sphereX[i], sphereY[i], sphereZ[i]); + } + //normal(0, -1, 0); + vertex(0, -1, 0); + normal(sphereX[0], sphereY[0], sphereZ[0]); + vertex(sphereX[0], sphereY[0], sphereZ[0]); + endShape(); + + int v1,v11,v2; + + // middle rings + int voff = 0; + for (int i = 2; i < sphereDetailV; i++) { + v1 = v11 = voff; + voff += sphereDetailU; + v2 = voff; + beginShape(TRIANGLE_STRIP); + for (int j = 0; j < sphereDetailU; j++) { + normal(sphereX[v1], sphereY[v1], sphereZ[v1]); + vertex(sphereX[v1], sphereY[v1], sphereZ[v1++]); + normal(sphereX[v2], sphereY[v2], sphereZ[v2]); + vertex(sphereX[v2], sphereY[v2], sphereZ[v2++]); + } + // close each ring + v1 = v11; + v2 = voff; + normal(sphereX[v1], sphereY[v1], sphereZ[v1]); + vertex(sphereX[v1], sphereY[v1], sphereZ[v1]); + normal(sphereX[v2], sphereY[v2], sphereZ[v2]); + vertex(sphereX[v2], sphereY[v2], sphereZ[v2]); + endShape(); + } + + // add the northern cap + beginShape(TRIANGLE_STRIP); + for (int i = 0; i < sphereDetailU; i++) { + v2 = voff + i; + normal(sphereX[v2], sphereY[v2], sphereZ[v2]); + vertex(sphereX[v2], sphereY[v2], sphereZ[v2]); + normal(0, 1, 0); + vertex(0, 1, 0); + } + normal(sphereX[voff], sphereY[voff], sphereZ[voff]); + vertex(sphereX[voff], sphereY[voff], sphereZ[voff]); + normal(0, 1, 0); + vertex(0, 1, 0); + endShape(); + + edge(true); + popMatrix(); + } + + + + ////////////////////////////////////////////////////////////// + + // BEZIER + + + /** + * Evalutes quadratic bezier at point t for points a, b, c, d. + * t varies between 0 and 1, and a and d are the on curve points, + * b and c are the control points. this can be done once with the + * x coordinates and a second time with the y coordinates to get + * the location of a bezier curve at t. + *

+ * For instance, to convert the following example:

+   * stroke(255, 102, 0);
+   * line(85, 20, 10, 10);
+   * line(90, 90, 15, 80);
+   * stroke(0, 0, 0);
+   * bezier(85, 20, 10, 10, 90, 90, 15, 80);
+   *
+   * // draw it in gray, using 10 steps instead of the default 20
+   * // this is a slower way to do it, but useful if you need
+   * // to do things with the coordinates at each step
+   * stroke(128);
+   * beginShape(LINE_STRIP);
+   * for (int i = 0; i <= 10; i++) {
+   *   float t = i / 10.0f;
+   *   float x = bezierPoint(85, 10, 90, 15, t);
+   *   float y = bezierPoint(20, 10, 90, 80, t);
+   *   vertex(x, y);
+   * }
+   * endShape();
+ */ + public float bezierPoint(float a, float b, float c, float d, float t) { + float t1 = 1.0f - t; + return a*t1*t1*t1 + 3*b*t*t1*t1 + 3*c*t*t*t1 + d*t*t*t; + } + + + /** + * Provide the tangent at the given point on the bezier curve. + * Fix from davbol for 0136. + */ + public float bezierTangent(float a, float b, float c, float d, float t) { + return (3*t*t * (-a+3*b-3*c+d) + + 6*t * (a-2*b+c) + + 3 * (-a+b)); + } + + + protected void bezierInitCheck() { + if (!bezierInited) { + bezierInit(); + } + } + + + protected void bezierInit() { + // overkill to be broken out, but better parity with the curve stuff below + bezierDetail(bezierDetail); + bezierInited = true; + } + + + public void bezierDetail(int detail) { + bezierDetail = detail; + + if (bezierDrawMatrix == null) { + bezierDrawMatrix = new PMatrix3D(); + } + + // setup matrix for forward differencing to speed up drawing + splineForward(detail, bezierDrawMatrix); + + // multiply the basis and forward diff matrices together + // saves much time since this needn't be done for each curve + //mult_spline_matrix(bezierForwardMatrix, bezier_basis, bezierDrawMatrix, 4); + //bezierDrawMatrix.set(bezierForwardMatrix); + bezierDrawMatrix.apply(bezierBasisMatrix); + } + + + /** + * Draw a cubic bezier curve. The first and last points are + * the on-curve points. The middle two are the 'control' points, + * or 'handles' in an application like Illustrator. + *

+ * Identical to typing: + * 

beginShape();
+   * vertex(x1, y1);
+   * bezierVertex(x2, y2, x3, y3, x4, y4);
+   * endShape();
+   *
+ * In Postscript-speak, this would be: + * 
moveto(x1, y1);
+   * curveto(x2, y2, x3, y3, x4, y4);
+ * If you were to try and continue that curve like so: + * 
curveto(x5, y5, x6, y6, x7, y7);
+ * This would be done in processing by adding these statements: + * 
bezierVertex(x5, y5, x6, y6, x7, y7)
+   *
+ * To draw a quadratic (instead of cubic) curve, + * use the control point twice by doubling it: + * 
bezier(x1, y1, cx, cy, cx, cy, x2, y2);
+ */ + public void bezier(float x1, float y1, + float x2, float y2, + float x3, float y3, + float x4, float y4) { + beginShape(); + vertex(x1, y1); + bezierVertex(x2, y2, x3, y3, x4, y4); + endShape(); + } + + + public void bezier(float x1, float y1, float z1, + float x2, float y2, float z2, + float x3, float y3, float z3, + float x4, float y4, float z4) { + beginShape(); + vertex(x1, y1, z1); + bezierVertex(x2, y2, z2, + x3, y3, z3, + x4, y4, z4); + endShape(); + } + + + + ////////////////////////////////////////////////////////////// + + // CATMULL-ROM CURVE + + + /** + * Get a location along a catmull-rom curve segment. + * + * @param t Value between zero and one for how far along the segment + */ + public float curvePoint(float a, float b, float c, float d, float t) { + curveInitCheck(); + + float tt = t * t; + float ttt = t * tt; + PMatrix3D cb = curveBasisMatrix; + + // not optimized (and probably need not be) + return (a * (ttt*cb.m00 + tt*cb.m10 + t*cb.m20 + cb.m30) + + b * (ttt*cb.m01 + tt*cb.m11 + t*cb.m21 + cb.m31) + + c * (ttt*cb.m02 + tt*cb.m12 + t*cb.m22 + cb.m32) + + d * (ttt*cb.m03 + tt*cb.m13 + t*cb.m23 + cb.m33)); + } + + + /** + * Calculate the tangent at a t value (0..1) on a Catmull-Rom curve. + * Code thanks to Dave Bollinger (Bug #715) + */ + public float curveTangent(float a, float b, float c, float d, float t) { + curveInitCheck(); + + float tt3 = t * t * 3; + float t2 = t * 2; + PMatrix3D cb = curveBasisMatrix; + + // not optimized (and probably need not be) + return (a * (tt3*cb.m00 + t2*cb.m10 + cb.m20) + + b * (tt3*cb.m01 + t2*cb.m11 + cb.m21) + + c * (tt3*cb.m02 + t2*cb.m12 + cb.m22) + + d * (tt3*cb.m03 + t2*cb.m13 + cb.m23) ); + } + + + public void curveDetail(int detail) { + curveDetail = detail; + curveInit(); + } + + + public void curveTightness(float tightness) { + curveTightness = tightness; + curveInit(); + } + + + protected void curveInitCheck() { + if (!curveInited) { + curveInit(); + } + } + + + /** + * Set the number of segments to use when drawing a Catmull-Rom + * curve, and setting the s parameter, which defines how tightly + * the curve fits to each vertex. Catmull-Rom curves are actually + * a subset of this curve type where the s is set to zero. + *

+ * (This function is not optimized, since it's not expected to + * be called all that often. there are many juicy and obvious + * opimizations in here, but it's probably better to keep the + * code more readable) + */ + protected void curveInit() { + // allocate only if/when used to save startup time + if (curveDrawMatrix == null) { + curveBasisMatrix = new PMatrix3D(); + curveDrawMatrix = new PMatrix3D(); + curveInited = true; + } + + float s = curveTightness; + curveBasisMatrix.set((s-1)/2f, (s+3)/2f, (-3-s)/2f, (1-s)/2f, + (1-s), (-5-s)/2f, (s+2), (s-1)/2f, + (s-1)/2f, 0, (1-s)/2f, 0, + 0, 1, 0, 0); + + //setup_spline_forward(segments, curveForwardMatrix); + splineForward(curveDetail, curveDrawMatrix); + + if (bezierBasisInverse == null) { + bezierBasisInverse = bezierBasisMatrix.get(); + bezierBasisInverse.invert(); + curveToBezierMatrix = new PMatrix3D(); + } + + // TODO only needed for PGraphicsJava2D? if so, move it there + // actually, it's generally useful for other renderers, so keep it + // or hide the implementation elsewhere. + curveToBezierMatrix.set(curveBasisMatrix); + curveToBezierMatrix.preApply(bezierBasisInverse); + + // multiply the basis and forward diff matrices together + // saves much time since this needn't be done for each curve + curveDrawMatrix.apply(curveBasisMatrix); + } + + + /** + * Draws a segment of Catmull-Rom curve. + *

+ * As of 0070, this function no longer doubles the first and + * last points. The curves are a bit more boring, but it's more + * mathematically correct, and properly mirrored in curvePoint(). + *

+ * Identical to typing out:

+   * beginShape();
+   * curveVertex(x1, y1);
+   * curveVertex(x2, y2);
+   * curveVertex(x3, y3);
+   * curveVertex(x4, y4);
+   * endShape();
+   *
+ */ + public void curve(float x1, float y1, + float x2, float y2, + float x3, float y3, + float x4, float y4) { + beginShape(); + curveVertex(x1, y1); + curveVertex(x2, y2); + curveVertex(x3, y3); + curveVertex(x4, y4); + endShape(); + } + + + public void curve(float x1, float y1, float z1, + float x2, float y2, float z2, + float x3, float y3, float z3, + float x4, float y4, float z4) { + beginShape(); + curveVertex(x1, y1, z1); + curveVertex(x2, y2, z2); + curveVertex(x3, y3, z3); + curveVertex(x4, y4, z4); + endShape(); + } + + + + ////////////////////////////////////////////////////////////// + + // SPLINE UTILITY FUNCTIONS (used by both Bezier and Catmull-Rom) + + + /** + * Setup forward-differencing matrix to be used for speedy + * curve rendering. It's based on using a specific number + * of curve segments and just doing incremental adds for each + * vertex of the segment, rather than running the mathematically + * expensive cubic equation. + * @param segments number of curve segments to use when drawing + * @param matrix target object for the new matrix + */ + protected void splineForward(int segments, PMatrix3D matrix) { + float f = 1.0f / segments; + float ff = f * f; + float fff = ff * f; + + matrix.set(0, 0, 0, 1, + fff, ff, f, 0, + 6*fff, 2*ff, 0, 0, + 6*fff, 0, 0, 0); + } + + + + ////////////////////////////////////////////////////////////// + + // SMOOTHING + + + /** + * If true in PImage, use bilinear interpolation for copy() + * operations. When inherited by PGraphics, also controls shapes. + */ + public void smooth() { + smooth = true; + } + + + /** + * Disable smoothing. See smooth(). + */ + public void noSmooth() { + smooth = false; + } + + + + ////////////////////////////////////////////////////////////// + + // IMAGE + + + /** + * The mode can only be set to CORNERS, CORNER, and CENTER. + *

+ * Support for CENTER was added in release 0146. + */ + public void imageMode(int mode) { + if ((mode == CORNER) || (mode == CORNERS) || (mode == CENTER)) { + imageMode = mode; + } else { + String msg = + "imageMode() only works with CORNER, CORNERS, or CENTER"; + throw new RuntimeException(msg); + } + } + + + public void image(PImage image, float x, float y) { + // Starting in release 0144, image errors are simply ignored. + // loadImageAsync() sets width and height to -1 when loading fails. + if (image.width == -1 || image.height == -1) return; + + if (imageMode == CORNER || imageMode == CORNERS) { + imageImpl(image, + x, y, x+image.width, y+image.height, + 0, 0, image.width, image.height); + + } else if (imageMode == CENTER) { + float x1 = x - image.width/2; + float y1 = y - image.height/2; + imageImpl(image, + x1, y1, x1+image.width, y1+image.height, + 0, 0, image.width, image.height); + } + } + + + public void image(PImage image, float x, float y, float c, float d) { + image(image, x, y, c, d, 0, 0, image.width, image.height); + } + + + /** + * Draw an image(), also specifying u/v coordinates. + * In this method, the u, v coordinates are always based on image space + * location, regardless of the current textureMode(). + */ + public void image(PImage image, + float a, float b, float c, float d, + int u1, int v1, int u2, int v2) { + // Starting in release 0144, image errors are simply ignored. + // loadImageAsync() sets width and height to -1 when loading fails. + if (image.width == -1 || image.height == -1) return; + + if (imageMode == CORNER) { + if (c < 0) { // reset a negative width + a += c; c = -c; + } + if (d < 0) { // reset a negative height + b += d; d = -d; + } + + imageImpl(image, + a, b, a + c, b + d, + u1, v1, u2, v2); + + } else if (imageMode == CORNERS) { + if (c < a) { // reverse because x2 < x1 + float temp = a; a = c; c = temp; + } + if (d < b) { // reverse because y2 < y1 + float temp = b; b = d; d = temp; + } + + imageImpl(image, + a, b, c, d, + u1, v1, u2, v2); + + } else if (imageMode == CENTER) { + // c and d are width/height + if (c < 0) c = -c; + if (d < 0) d = -d; + float x1 = a - c/2; + float y1 = b - d/2; + + imageImpl(image, + x1, y1, x1 + c, y1 + d, + u1, v1, u2, v2); + } + } + + + /** + * Expects x1, y1, x2, y2 coordinates where (x2 >= x1) and (y2 >= y1). + * If tint() has been called, the image will be colored. + *

+ * The default implementation draws an image as a textured quad. + * The (u, v) coordinates are in image space (they're ints, after all..) + */ + protected void imageImpl(PImage image, + float x1, float y1, float x2, float y2, + int u1, int v1, int u2, int v2) { + boolean savedStroke = stroke; +// boolean savedFill = fill; + int savedTextureMode = textureMode; + + stroke = false; +// fill = true; + textureMode = IMAGE; + +// float savedFillR = fillR; +// float savedFillG = fillG; +// float savedFillB = fillB; +// float savedFillA = fillA; +// +// if (tint) { +// fillR = tintR; +// fillG = tintG; +// fillB = tintB; +// fillA = tintA; +// +// } else { +// fillR = 1; +// fillG = 1; +// fillB = 1; +// fillA = 1; +// } + + beginShape(QUADS); + texture(image); + vertex(x1, y1, u1, v1); + vertex(x1, y2, u1, v2); + vertex(x2, y2, u2, v2); + vertex(x2, y1, u2, v1); + endShape(); + + stroke = savedStroke; +// fill = savedFill; + textureMode = savedTextureMode; + +// fillR = savedFillR; +// fillG = savedFillG; +// fillB = savedFillB; +// fillA = savedFillA; + } + + + + ////////////////////////////////////////////////////////////// + + // SHAPE + + + /** + * Set the orientation for the shape() command (like imageMode() or rectMode()). + * @param mode Either CORNER, CORNERS, or CENTER. + */ + public void shapeMode(int mode) { + this.shapeMode = mode; + } + + + public void shape(PShape shape) { + if (shape.isVisible()) { // don't do expensive matrix ops if invisible + if (shapeMode == CENTER) { + pushMatrix(); + translate(-shape.getWidth()/2, -shape.getHeight()/2); + } + + shape.draw(this); // needs to handle recorder too + + if (shapeMode == CENTER) { + popMatrix(); + } + } + } + + + /** + * Convenience method to draw at a particular location. + */ + public void shape(PShape shape, float x, float y) { + if (shape.isVisible()) { // don't do expensive matrix ops if invisible + pushMatrix(); + + if (shapeMode == CENTER) { + translate(x - shape.getWidth()/2, y - shape.getHeight()/2); + + } else if ((shapeMode == CORNER) || (shapeMode == CORNERS)) { + translate(x, y); + } + shape.draw(this); + + popMatrix(); + } + } + + + public void shape(PShape shape, float x, float y, float c, float d) { + if (shape.isVisible()) { // don't do expensive matrix ops if invisible + pushMatrix(); + + if (shapeMode == CENTER) { + // x and y are center, c and d refer to a diameter + translate(x - c/2f, y - d/2f); + scale(c / shape.getWidth(), d / shape.getHeight()); + + } else if (shapeMode == CORNER) { + translate(x, y); + scale(c / shape.getWidth(), d / shape.getHeight()); + + } else if (shapeMode == CORNERS) { + // c and d are x2/y2, make them into width/height + c -= x; + d -= y; + // then same as above + translate(x, y); + scale(c / shape.getWidth(), d / shape.getHeight()); + } + shape.draw(this); + + popMatrix(); + } + } + + + + ////////////////////////////////////////////////////////////// + + // TEXT/FONTS + + + /** + * Sets the alignment of the text to one of LEFT, CENTER, or RIGHT. + * This will also reset the vertical text alignment to BASELINE. + */ + public void textAlign(int align) { + textAlign(align, BASELINE); + } + + + /** + * Sets the horizontal and vertical alignment of the text. The horizontal + * alignment can be one of LEFT, CENTER, or RIGHT. The vertical alignment + * can be TOP, BOTTOM, CENTER, or the BASELINE (the default). + */ + public void textAlign(int alignX, int alignY) { + textAlign = alignX; + textAlignY = alignY; + } + + + /** + * Returns the ascent of the current font at the current size. + * This is a method, rather than a variable inside the PGraphics object + * because it requires calculation. + */ + public float textAscent() { + if (textFont == null) { + showTextFontException("textAscent"); + } + return textFont.ascent() * ((textMode == SCREEN) ? textFont.size : textSize); + } + + + /** + * Returns the descent of the current font at the current size. + * This is a method, rather than a variable inside the PGraphics object + * because it requires calculation. + */ + public float textDescent() { + if (textFont == null) { + showTextFontException("textDescent"); + } + return textFont.descent() * ((textMode == SCREEN) ? textFont.size : textSize); + } + + + /** + * Sets the current font. The font's size will be the "natural" + * size of this font (the size that was set when using "Create Font"). + * The leading will also be reset. + */ + public void textFont(PFont which) { + if (which != null) { + textFont = which; + if (hints[ENABLE_NATIVE_FONTS]) { + //if (which.font == null) { + which.findFont(); + //} + } + /* + textFontNative = which.font; + + //textFontNativeMetrics = null; + // changed for rev 0104 for textMode(SHAPE) in opengl + if (textFontNative != null) { + // TODO need a better way to handle this. could use reflection to get + // rid of the warning, but that'd be a little silly. supporting this is + // an artifact of supporting java 1.1, otherwise we'd use getLineMetrics, + // as recommended by the @deprecated flag. + textFontNativeMetrics = + Toolkit.getDefaultToolkit().getFontMetrics(textFontNative); + // The following is what needs to be done, however we need to be able + // to get the actual graphics context where the drawing is happening. + // For instance, parent.getGraphics() doesn't work for OpenGL since + // an OpenGL drawing surface is an embedded component. +// if (parent != null) { +// textFontNativeMetrics = parent.getGraphics().getFontMetrics(textFontNative); +// } + + // float w = font.getStringBounds(text, g2.getFontRenderContext()).getWidth(); + } + */ + textSize(which.size); + + } else { + throw new RuntimeException(ERROR_TEXTFONT_NULL_PFONT); + } + } + + + /** + * Useful function to set the font and size at the same time. + */ + public void textFont(PFont which, float size) { + textFont(which); + textSize(size); + } + + + /** + * Set the text leading to a specific value. If using a custom + * value for the text leading, you'll have to call textLeading() + * again after any calls to textSize(). + */ + public void textLeading(float leading) { + textLeading = leading; + } + + + /** + * Sets the text rendering/placement to be either SCREEN (direct + * to the screen, exact coordinates, only use the font's original size) + * or MODEL (the default, where text is manipulated by translate() and + * can have a textSize). The text size cannot be set when using + * textMode(SCREEN), because it uses the pixels directly from the font. + */ + public void textMode(int mode) { + // CENTER and MODEL overlap (they're both 3) + if ((mode == LEFT) || (mode == RIGHT)) { + showWarning("Since Processing beta, textMode() is now textAlign()."); + return; + } +// if ((mode != SCREEN) && (mode != MODEL)) { +// showError("Only textMode(SCREEN) and textMode(MODEL) " + +// "are available with this renderer."); +// } + + if (textModeCheck(mode)) { + textMode = mode; + } else { + String modeStr = String.valueOf(mode); + switch (mode) { + case SCREEN: modeStr = "SCREEN"; break; + case MODEL: modeStr = "MODEL"; break; + case SHAPE: modeStr = "SHAPE"; break; + } + showWarning("textMode(" + modeStr + ") is not supported by this renderer."); + } + + // reset the font to its natural size + // (helps with width calculations and all that) + //if (textMode == SCREEN) { + //textSize(textFont.size); + //} + + //} else { + //throw new RuntimeException("use textFont() before textMode()"); + //} + } + + + protected boolean textModeCheck(int mode) { + return true; + } + + + /** + * Sets the text size, also resets the value for the leading. + */ + public void textSize(float size) { + if (textFont != null) { +// if ((textMode == SCREEN) && (size != textFont.size)) { +// throw new RuntimeException("textSize() is ignored with " + +// "textMode(SCREEN)"); +// } + textSize = size; + textLeading = (textAscent() + textDescent()) * 1.275f; + + } else { + showTextFontException("textSize"); + } + } + + + // ........................................................ + + + public float textWidth(char c) { + textWidthBuffer[0] = c; + return textWidthImpl(textWidthBuffer, 0, 1); + } + + + /** + * Return the width of a line of text. If the text has multiple + * lines, this returns the length of the longest line. + */ + public float textWidth(String str) { + if (textFont == null) { + showTextFontException("textWidth"); + } + + int length = str.length(); + if (length > textWidthBuffer.length) { + textWidthBuffer = new char[length + 10]; + } + str.getChars(0, length, textWidthBuffer, 0); + + float wide = 0; + int index = 0; + int start = 0; + + while (index < length) { + if (textWidthBuffer[index] == '\n') { + wide = Math.max(wide, textWidthImpl(textWidthBuffer, start, index)); + start = index+1; + } + index++; + } + if (start < length) { + wide = Math.max(wide, textWidthImpl(textWidthBuffer, start, index)); + } + return wide; + } + + + /** + * TODO not sure if this stays... + */ + public float textWidth(char[] chars, int start, int length) { + return textWidthImpl(chars, start, start + length); + } + + + /** + * Implementation of returning the text width of + * the chars [start, stop) in the buffer. + * Unlike the previous version that was inside PFont, this will + * return the size not of a 1 pixel font, but the actual current size. + */ + protected float textWidthImpl(char buffer[], int start, int stop) { + float wide = 0; + for (int i = start; i < stop; i++) { + // could add kerning here, but it just ain't implemented + wide += textFont.width(buffer[i]) * textSize; + } + return wide; + } + + + // ........................................................ + + + /** + * Write text where we just left off. + */ + public void text(char c) { + text(c, textX, textY, textZ); + } + + + /** + * Draw a single character on screen. + * Extremely slow when used with textMode(SCREEN) and Java 2D, + * because loadPixels has to be called first and updatePixels last. + */ + public void text(char c, float x, float y) { + if (textFont == null) { + showTextFontException("text"); + } + + if (textMode == SCREEN) loadPixels(); + + if (textAlignY == CENTER) { + y += textAscent() / 2; + } else if (textAlignY == TOP) { + y += textAscent(); + } else if (textAlignY == BOTTOM) { + y -= textDescent(); + //} else if (textAlignY == BASELINE) { + // do nothing + } + + textBuffer[0] = c; + textLineAlignImpl(textBuffer, 0, 1, x, y); + + if (textMode == SCREEN) updatePixels(); + } + + + /** + * Draw a single character on screen (with a z coordinate) + */ + public void text(char c, float x, float y, float z) { +// if ((z != 0) && (textMode == SCREEN)) { +// String msg = "textMode(SCREEN) cannot have a z coordinate"; +// throw new RuntimeException(msg); +// } + + if (z != 0) translate(0, 0, z); // slowness, badness + + text(c, x, y); + textZ = z; + + if (z != 0) translate(0, 0, -z); + } + + + /** + * Write text where we just left off. + */ + public void text(String str) { + text(str, textX, textY, textZ); + } + + + /** + * Draw a chunk of text. + * Newlines that are \n (Unix newline or linefeed char, ascii 10) + * are honored, but \r (carriage return, Windows and Mac OS) are + * ignored. + */ + public void text(String str, float x, float y) { + if (textFont == null) { + showTextFontException("text"); + } + + if (textMode == SCREEN) loadPixels(); + + int length = str.length(); + if (length > textBuffer.length) { + textBuffer = new char[length + 10]; + } + str.getChars(0, length, textBuffer, 0); + text(textBuffer, 0, length, x, y); + } + + + /** + * Method to draw text from an array of chars. This method will usually be + * more efficient than drawing from a String object, because the String will + * not be converted to a char array before drawing. + */ + public void text(char[] chars, int start, int stop, float x, float y) { + // If multiple lines, sum the height of the additional lines + float high = 0; //-textAscent(); + for (int i = start; i < stop; i++) { + if (chars[i] == '\n') { + high += textLeading; + } + } + if (textAlignY == CENTER) { + // for a single line, this adds half the textAscent to y + // for multiple lines, subtract half the additional height + //y += (textAscent() - textDescent() - high)/2; + y += (textAscent() - high)/2; + } else if (textAlignY == TOP) { + // for a single line, need to add textAscent to y + // for multiple lines, no different + y += textAscent(); + } else if (textAlignY == BOTTOM) { + // for a single line, this is just offset by the descent + // for multiple lines, subtract leading for each line + y -= textDescent() + high; + //} else if (textAlignY == BASELINE) { + // do nothing + } + +// int start = 0; + int index = 0; + while (index < stop) { //length) { + if (chars[index] == '\n') { + textLineAlignImpl(chars, start, index, x, y); + start = index + 1; + y += textLeading; + } + index++; + } + if (start < stop) { //length) { + textLineAlignImpl(chars, start, index, x, y); + } + if (textMode == SCREEN) updatePixels(); + } + + + /** + * Same as above but with a z coordinate. + */ + public void text(String str, float x, float y, float z) { + if (z != 0) translate(0, 0, z); // slow! + + text(str, x, y); + textZ = z; + + if (z != 0) translate(0, 0, -z); // inaccurate! + } + + + public void text(char[] chars, int start, int stop, + float x, float y, float z) { + if (z != 0) translate(0, 0, z); // slow! + + text(chars, start, stop, x, y); + textZ = z; + + if (z != 0) translate(0, 0, -z); // inaccurate! + } + + + /** + * 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. + */ + public void text(String str, float x1, float y1, float x2, float y2) { + if (textFont == null) { + showTextFontException("text"); + } + + if (textMode == SCREEN) loadPixels(); + + float hradius, vradius; + switch (rectMode) { + case CORNER: + x2 += x1; y2 += y1; + break; + case RADIUS: + hradius = x2; + vradius = y2; + x2 = x1 + hradius; + y2 = y1 + vradius; + x1 -= hradius; + y1 -= vradius; + break; + case CENTER: + hradius = x2 / 2.0f; + vradius = y2 / 2.0f; + x2 = x1 + hradius; + y2 = y1 + vradius; + x1 -= hradius; + y1 -= vradius; + } + if (x2 < x1) { + float temp = x1; x1 = x2; x2 = temp; + } + if (y2 < y1) { + float temp = y1; y1 = y2; y2 = temp; + } + +// float currentY = y1; + float boxWidth = x2 - x1; + +// // ala illustrator, the text itself must fit inside the box +// currentY += textAscent(); //ascent() * textSize; +// // if the box is already too small, tell em to f off +// if (currentY > y2) return; + + float spaceWidth = textWidth(' '); + + if (textBreakStart == null) { + textBreakStart = new int[20]; + textBreakStop = new int[20]; + } + textBreakCount = 0; + + int length = str.length(); + if (length + 1 > textBuffer.length) { + textBuffer = new char[length + 1]; + } + str.getChars(0, length, textBuffer, 0); + // add a fake newline to simplify calculations + textBuffer[length++] = '\n'; + + int sentenceStart = 0; + for (int i = 0; i < length; i++) { + if (textBuffer[i] == '\n') { +// currentY = textSentence(textBuffer, sentenceStart, i, +// lineX, boxWidth, currentY, y2, spaceWidth); + boolean legit = + textSentence(textBuffer, sentenceStart, i, boxWidth, spaceWidth); + if (!legit) break; +// if (Float.isNaN(currentY)) break; // word too big (or error) +// if (currentY > y2) break; // past the box + sentenceStart = i + 1; + } + } + + // lineX is the position where the text starts, which is adjusted + // to left/center/right based on the current textAlign + float lineX = x1; //boxX1; + if (textAlign == CENTER) { + lineX = lineX + boxWidth/2f; + } else if (textAlign == RIGHT) { + lineX = x2; //boxX2; + } + + float boxHeight = y2 - y1; + //int lineFitCount = 1 + PApplet.floor((boxHeight - textAscent()) / textLeading); + // incorporate textAscent() for the top (baseline will be y1 + ascent) + // and textDescent() for the bottom, so that lower parts of letters aren't + // outside the box. [0151] + float topAndBottom = textAscent() + textDescent(); + int lineFitCount = 1 + PApplet.floor((boxHeight - topAndBottom) / textLeading); + int lineCount = Math.min(textBreakCount, lineFitCount); + + if (textAlignY == CENTER) { + float lineHigh = textAscent() + textLeading * (lineCount - 1); + float y = y1 + textAscent() + (boxHeight - lineHigh) / 2; + for (int i = 0; i < lineCount; i++) { + textLineAlignImpl(textBuffer, textBreakStart[i], textBreakStop[i], lineX, y); + y += textLeading; + } + + } else if (textAlignY == BOTTOM) { + float y = y2 - textDescent() - textLeading * (lineCount - 1); + for (int i = 0; i < lineCount; i++) { + textLineAlignImpl(textBuffer, textBreakStart[i], textBreakStop[i], lineX, y); + y += textLeading; + } + + } else { // TOP or BASELINE just go to the default + float y = y1 + textAscent(); + for (int i = 0; i < lineCount; i++) { + textLineAlignImpl(textBuffer, textBreakStart[i], textBreakStop[i], lineX, y); + y += textLeading; + } + } + + if (textMode == SCREEN) updatePixels(); + } + + + /** + * Emit a sentence of text, defined as a chunk of text without any newlines. + * @param stop non-inclusive, the end of the text in question + */ + protected boolean textSentence(char[] buffer, int start, int stop, + float boxWidth, float spaceWidth) { + float runningX = 0; + + // Keep track of this separately from index, since we'll need to back up + // from index when breaking words that are too long to fit. + int lineStart = start; + int wordStart = start; + int index = start; + while (index <= stop) { + // boundary of a word or end of this sentence + if ((buffer[index] == ' ') || (index == stop)) { + float wordWidth = textWidthImpl(buffer, wordStart, index); + + if (runningX + wordWidth > boxWidth) { + if (runningX != 0) { + // Next word is too big, output the current line and advance + index = wordStart; + textSentenceBreak(lineStart, index); + // Eat whitespace because multiple spaces don't count for s* + // when they're at the end of a line. + while ((index < stop) && (buffer[index] == ' ')) { + index++; + } + } else { // (runningX == 0) + // If this is the first word on the line, and its width is greater + // than the width of the text box, then break the word where at the + // max width, and send the rest of the word to the next line. + do { + index--; + if (index == wordStart) { + // Not a single char will fit on this line. screw 'em. + //System.out.println("screw you"); + return false; //Float.NaN; + } + wordWidth = textWidthImpl(buffer, wordStart, index); + } while (wordWidth > boxWidth); + + //textLineImpl(buffer, lineStart, index, x, y); + textSentenceBreak(lineStart, index); + } + lineStart = index; + wordStart = index; + runningX = 0; + + } else if (index == stop) { + // last line in the block, time to unload + //textLineImpl(buffer, lineStart, index, x, y); + textSentenceBreak(lineStart, index); +// y += textLeading; + index++; + + } else { // this word will fit, just add it to the line + runningX += wordWidth + spaceWidth; + wordStart = index + 1; // move on to the next word + index++; + } + } else { // not a space or the last character + index++; // this is just another letter + } + } +// return y; + return true; + } + + + protected void textSentenceBreak(int start, int stop) { + if (textBreakCount == textBreakStart.length) { + textBreakStart = PApplet.expand(textBreakStart); + textBreakStop = PApplet.expand(textBreakStop); + } + textBreakStart[textBreakCount] = start; + textBreakStop[textBreakCount] = stop; + textBreakCount++; + } + + + public void text(String s, float x1, float y1, float x2, float y2, float z) { + if (z != 0) translate(0, 0, z); // slowness, badness + + text(s, x1, y1, x2, y2); + textZ = z; + + if (z != 0) translate(0, 0, -z); // TEMPORARY HACK! SLOW! + } + + + public void text(int num, float x, float y) { + text(String.valueOf(num), x, y); + } + + + public void text(int num, float x, float y, float z) { + text(String.valueOf(num), x, y, z); + } + + + /** + * This does a basic number formatting, to avoid the + * generally ugly appearance of printing floats. + * Users who want more control should use their own nf() cmmand, + * or if they want the long, ugly version of float, + * use String.valueOf() to convert the float to a String first. + */ + public void text(float num, float x, float y) { + text(PApplet.nfs(num, 0, 3), x, y); + } + + + public void text(float num, float x, float y, float z) { + text(PApplet.nfs(num, 0, 3), x, y, z); + } + + + + ////////////////////////////////////////////////////////////// + + // TEXT IMPL + + // These are most likely to be overridden by subclasses, since the other + // (public) functions handle generic features like setting alignment. + + + /** + * Handles placement of a text line, then calls textLineImpl + * to actually render at the specific point. + */ + protected void textLineAlignImpl(char buffer[], int start, int stop, + float x, float y) { + if (textAlign == CENTER) { + x -= textWidthImpl(buffer, start, stop) / 2f; + + } else if (textAlign == RIGHT) { + x -= textWidthImpl(buffer, start, stop); + } + + textLineImpl(buffer, start, stop, x, y); + } + + + /** + * Implementation of actual drawing for a line of text. + */ + protected void textLineImpl(char buffer[], int start, int stop, + float x, float y) { + for (int index = start; index < stop; index++) { + textCharImpl(buffer[index], x, y); + + // this doesn't account for kerning + x += textWidth(buffer[index]); + } + textX = x; + textY = y; + textZ = 0; // this will get set by the caller if non-zero + } + + + protected void textCharImpl(char ch, float x, float y) { //, float z) { + int index = textFont.index(ch); + if (index == -1) return; + + PImage glyph = textFont.images[index]; + + if (textMode == MODEL) { + float high = (float) textFont.height[index] / textFont.fheight; + float bwidth = (float) textFont.width[index] / textFont.fwidth; + float lextent = (float) textFont.leftExtent[index] / textFont.fwidth; + float textent = (float) textFont.topExtent[index] / textFont.fheight; + + float x1 = x + lextent * textSize; + float y1 = y - textent * textSize; + float x2 = x1 + bwidth * textSize; + float y2 = y1 + high * textSize; + + textCharModelImpl(glyph, + x1, y1, x2, y2, + //x1, y1, z, x2, y2, z, + textFont.width[index], textFont.height[index]); + + } else if (textMode == SCREEN) { + int xx = (int) x + textFont.leftExtent[index];; + int yy = (int) y - textFont.topExtent[index]; + + int w0 = textFont.width[index]; + int h0 = textFont.height[index]; + + textCharScreenImpl(glyph, xx, yy, w0, h0); + } + } + + + protected void textCharModelImpl(PImage glyph, + float x1, float y1, //float z1, + float x2, float y2, //float z2, + int u2, int v2) { + boolean savedTint = tint; + int savedTintColor = tintColor; + float savedTintR = tintR; + float savedTintG = tintG; + float savedTintB = tintB; + float savedTintA = tintA; + boolean savedTintAlpha = tintAlpha; + + tint = true; + tintColor = fillColor; + tintR = fillR; + tintG = fillG; + tintB = fillB; + tintA = fillA; + tintAlpha = fillAlpha; + + imageImpl(glyph, x1, y1, x2, y2, 0, 0, u2, v2); + + tint = savedTint; + tintColor = savedTintColor; + tintR = savedTintR; + tintG = savedTintG; + tintB = savedTintB; + tintA = savedTintA; + tintAlpha = savedTintAlpha; + } + + + protected void textCharScreenImpl(PImage glyph, + int xx, int yy, + int w0, int h0) { + int x0 = 0; + int y0 = 0; + + if ((xx >= width) || (yy >= height) || + (xx + w0 < 0) || (yy + h0 < 0)) return; + + if (xx < 0) { + x0 -= xx; + w0 += xx; + xx = 0; + } + if (yy < 0) { + y0 -= yy; + h0 += yy; + yy = 0; + } + if (xx + w0 > width) { + w0 -= ((xx + w0) - width); + } + if (yy + h0 > height) { + h0 -= ((yy + h0) - height); + } + + int fr = fillRi; + int fg = fillGi; + int fb = fillBi; + int fa = fillAi; + + int pixels1[] = glyph.pixels; //images[glyph].pixels; + + // TODO this can be optimized a bit + for (int row = y0; row < y0 + h0; row++) { + for (int col = x0; col < x0 + w0; col++) { + int a1 = (fa * pixels1[row * textFont.twidth + col]) >> 8; + int a2 = a1 ^ 0xff; + //int p1 = pixels1[row * glyph.width + col]; + int p2 = pixels[(yy + row-y0)*width + (xx+col-x0)]; + + pixels[(yy + row-y0)*width + xx+col-x0] = + (0xff000000 | + (((a1 * fr + a2 * ((p2 >> 16) & 0xff)) & 0xff00) << 8) | + (( a1 * fg + a2 * ((p2 >> 8) & 0xff)) & 0xff00) | + (( a1 * fb + a2 * ( p2 & 0xff)) >> 8)); + } + } + } + + + + ////////////////////////////////////////////////////////////// + + // MATRIX STACK + + + /** + * Push a copy of the current transformation matrix onto the stack. + */ + public void pushMatrix() { + showMethodWarning("pushMatrix"); + } + + + /** + * Replace the current transformation matrix with the top of the stack. + */ + public void popMatrix() { + showMethodWarning("popMatrix"); + } + + + + ////////////////////////////////////////////////////////////// + + // MATRIX TRANSFORMATIONS + + + /** + * Translate in X and Y. + */ + public void translate(float tx, float ty) { + showMissingWarning("translate"); + } + + + /** + * Translate in X, Y, and Z. + */ + public void translate(float tx, float ty, float tz) { + showMissingWarning("translate"); + } + + + /** + * Two dimensional rotation. + * + * Same as rotateZ (this is identical to a 3D rotation along the z-axis) + * but included for clarity. It'd be weird for people drawing 2D graphics + * to be using rotateZ. And they might kick our a-- for the confusion. + * + * Additional background. + */ + public void rotate(float angle) { + showMissingWarning("rotate"); + } + + + /** + * Rotate around the X axis. + */ + public void rotateX(float angle) { + showMethodWarning("rotateX"); + } + + + /** + * Rotate around the Y axis. + */ + public void rotateY(float angle) { + showMethodWarning("rotateY"); + } + + + /** + * Rotate around the Z axis. + * + * The functions rotate() and rotateZ() are identical, it's just that it make + * sense to have rotate() and then rotateX() and rotateY() when using 3D; + * nor does it make sense to use a function called rotateZ() if you're only + * doing things in 2D. so we just decided to have them both be the same. + */ + public void rotateZ(float angle) { + showMethodWarning("rotateZ"); + } + + + /** + * Rotate about a vector in space. Same as the glRotatef() function. + */ + public void rotate(float angle, float vx, float vy, float vz) { + showMissingWarning("rotate"); + } + + + /** + * Scale in all dimensions. + */ + public void scale(float s) { + showMissingWarning("scale"); + } + + + /** + * Scale in X and Y. Equivalent to scale(sx, sy, 1). + * + * Not recommended for use in 3D, because the z-dimension is just + * scaled by 1, since there's no way to know what else to scale it by. + */ + public void scale(float sx, float sy) { + showMissingWarning("scale"); + } + + + /** + * Scale in X, Y, and Z. + */ + public void scale(float x, float y, float z) { + showMissingWarning("scale"); + } + + + ////////////////////////////////////////////////////////////// + + // MATRIX FULL MONTY + + + /** + * Set the current transformation matrix to identity. + */ + public void resetMatrix() { + showMethodWarning("resetMatrix"); + } + + + public void applyMatrix(PMatrix source) { + if (source instanceof PMatrix2D) { + applyMatrix((PMatrix2D) source); + } else if (source instanceof PMatrix3D) { + applyMatrix((PMatrix3D) source); + } + } + + + public void applyMatrix(PMatrix2D source) { + applyMatrix(source.m00, source.m01, source.m02, + source.m10, source.m11, source.m12); + } + + + /** + * Apply a 3x2 affine transformation matrix. + */ + public void applyMatrix(float n00, float n01, float n02, + float n10, float n11, float n12) { + showMissingWarning("applyMatrix"); + } + + + public void applyMatrix(PMatrix3D source) { + applyMatrix(source.m00, source.m01, source.m02, source.m03, + source.m10, source.m11, source.m12, source.m13, + source.m20, source.m21, source.m22, source.m23, + source.m30, source.m31, source.m32, source.m33); + } + + + /** + * Apply a 4x4 transformation matrix. + */ + public void applyMatrix(float n00, float n01, float n02, float n03, + float n10, float n11, float n12, float n13, + float n20, float n21, float n22, float n23, + float n30, float n31, float n32, float n33) { + showMissingWarning("applyMatrix"); + } + + + + ////////////////////////////////////////////////////////////// + + // MATRIX GET/SET/PRINT + + + public PMatrix getMatrix() { + showMissingWarning("getMatrix"); + return null; + } + + + /** + * Copy the current transformation matrix into the specified target. + * Pass in null to create a new matrix. + */ + public PMatrix2D getMatrix(PMatrix2D target) { + showMissingWarning("getMatrix"); + return null; + } + + + /** + * Copy the current transformation matrix into the specified target. + * Pass in null to create a new matrix. + */ + public PMatrix3D getMatrix(PMatrix3D target) { + showMissingWarning("getMatrix"); + return null; + } + + + /** + * Set the current transformation matrix to the contents of another. + */ + public void setMatrix(PMatrix source) { + if (source instanceof PMatrix2D) { + setMatrix((PMatrix2D) source); + } else if (source instanceof PMatrix3D) { + setMatrix((PMatrix3D) source); + } + } + + + /** + * Set the current transformation to the contents of the specified source. + */ + public void setMatrix(PMatrix2D source) { + showMissingWarning("setMatrix"); + } + + + /** + * Set the current transformation to the contents of the specified source. + */ + public void setMatrix(PMatrix3D source) { + showMissingWarning("setMatrix"); + } + + + /** + * Print the current model (or "transformation") matrix. + */ + public void printMatrix() { + showMethodWarning("printMatrix"); + } + + + + ////////////////////////////////////////////////////////////// + + // CAMERA + + + public void beginCamera() { + showMethodWarning("beginCamera"); + } + + + public void endCamera() { + showMethodWarning("endCamera"); + } + + + public void camera() { + showMissingWarning("camera"); + } + + + public void camera(float eyeX, float eyeY, float eyeZ, + float centerX, float centerY, float centerZ, + float upX, float upY, float upZ) { + showMissingWarning("camera"); + } + + + public void printCamera() { + showMethodWarning("printCamera"); + } + + + + ////////////////////////////////////////////////////////////// + + // PROJECTION + + + public void ortho() { + showMissingWarning("ortho"); + } + + + public void ortho(float left, float right, + float bottom, float top, + float near, float far) { + showMissingWarning("ortho"); + } + + + public void perspective() { + showMissingWarning("perspective"); + } + + + public void perspective(float fovy, float aspect, float zNear, float zFar) { + showMissingWarning("perspective"); + } + + + public void frustum(float left, float right, + float bottom, float top, + float near, float far) { + showMethodWarning("frustum"); + } + + + public void printProjection() { + showMethodWarning("printCamera"); + } + + + + ////////////////////////////////////////////////////////////// + + // SCREEN TRANSFORMS + + + /** + * Given an x and y coordinate, returns the x position of where + * that point would be placed on screen, once affected by translate(), + * scale(), or any other transformations. + */ + public float screenX(float x, float y) { + showMissingWarning("screenX"); + return 0; + } + + + /** + * Given an x and y coordinate, returns the y position of where + * that point would be placed on screen, once affected by translate(), + * scale(), or any other transformations. + */ + public float screenY(float x, float y) { + showMissingWarning("screenY"); + return 0; + } + + + /** + * Maps a three dimensional point to its placement on-screen. + *

+ * Given an (x, y, z) coordinate, returns the x position of where + * that point would be placed on screen, once affected by translate(), + * scale(), or any other transformations. + */ + public float screenX(float x, float y, float z) { + showMissingWarning("screenX"); + return 0; + } + + + /** + * Maps a three dimensional point to its placement on-screen. + *

+ * Given an (x, y, z) coordinate, returns the y position of where + * that point would be placed on screen, once affected by translate(), + * scale(), or any other transformations. + */ + public float screenY(float x, float y, float z) { + showMissingWarning("screenY"); + return 0; + } + + + /** + * Maps a three dimensional point to its placement on-screen. + *

+ * Given an (x, y, z) coordinate, returns its z value. + * This value can be used to determine if an (x, y, z) coordinate + * is in front or in back of another (x, y, z) coordinate. + * The units are based on how the zbuffer is set up, and don't + * relate to anything "real". They're only useful for in + * comparison to another value obtained from screenZ(), + * or directly out of the zbuffer[]. + */ + public float screenZ(float x, float y, float z) { + showMissingWarning("screenZ"); + return 0; + } + + + /** + * Returns the model space x value for an x, y, z coordinate. + *

+ * This will give you a coordinate after it has been transformed + * by translate(), rotate(), and camera(), but not yet transformed + * by the projection matrix. For instance, his can be useful for + * figuring out how points in 3D space relate to the edge + * coordinates of a shape. + */ + public float modelX(float x, float y, float z) { + showMissingWarning("modelX"); + return 0; + } + + + /** + * Returns the model space y value for an x, y, z coordinate. + */ + public float modelY(float x, float y, float z) { + showMissingWarning("modelY"); + return 0; + } + + + /** + * Returns the model space z value for an x, y, z coordinate. + */ + public float modelZ(float x, float y, float z) { + showMissingWarning("modelZ"); + return 0; + } + + + + ////////////////////////////////////////////////////////////// + + // STYLE + + + public void pushStyle() { + if (styleStackDepth == styleStack.length) { + styleStack = (PStyle[]) PApplet.expand(styleStack); + } + if (styleStack[styleStackDepth] == null) { + styleStack[styleStackDepth] = new PStyle(); + } + PStyle s = styleStack[styleStackDepth++]; + getStyle(s); + } + + + public void popStyle() { + if (styleStackDepth == 0) { + throw new RuntimeException("Too many popStyle() without enough pushStyle()"); + } + styleStackDepth--; + style(styleStack[styleStackDepth]); + } + + + public void style(PStyle s) { + // if (s.smooth) { + // smooth(); + // } else { + // noSmooth(); + // } + + imageMode(s.imageMode); + rectMode(s.rectMode); + ellipseMode(s.ellipseMode); + shapeMode(s.shapeMode); + + if (s.tint) { + tint(s.tintColor); + } else { + noTint(); + } + if (s.fill) { + fill(s.fillColor); + } else { + noFill(); + } + if (s.stroke) { + stroke(s.strokeColor); + } else { + noStroke(); + } + strokeWeight(s.strokeWeight); + strokeCap(s.strokeCap); + strokeJoin(s.strokeJoin); + + // Set the colorMode() for the material properties. + // TODO this is really inefficient, need to just have a material() method, + // but this has the least impact to the API. + colorMode(RGB, 1); + ambient(s.ambientR, s.ambientG, s.ambientB); + emissive(s.emissiveR, s.emissiveG, s.emissiveB); + specular(s.specularR, s.specularG, s.specularB); + shininess(s.shininess); + + /* + s.ambientR = ambientR; + s.ambientG = ambientG; + s.ambientB = ambientB; + s.specularR = specularR; + s.specularG = specularG; + s.specularB = specularB; + s.emissiveR = emissiveR; + s.emissiveG = emissiveG; + s.emissiveB = emissiveB; + s.shininess = shininess; + */ + // material(s.ambientR, s.ambientG, s.ambientB, + // s.emissiveR, s.emissiveG, s.emissiveB, + // s.specularR, s.specularG, s.specularB, + // s.shininess); + + // Set this after the material properties. + colorMode(s.colorMode, + s.colorModeX, s.colorModeY, s.colorModeZ, s.colorModeA); + + // This is a bit asymmetric, since there's no way to do "noFont()", + // and a null textFont will produce an error (since usually that means that + // the font couldn't load properly). So in some cases, the font won't be + // 'cleared' to null, even though that's technically correct. + if (s.textFont != null) { + textFont(s.textFont, s.textSize); + textLeading(s.textLeading); + } + // These don't require a font to be set. + textAlign(s.textAlign, s.textAlignY); + textMode(s.textMode); + } + + + public PStyle getStyle() { // ignore + return getStyle(null); + } + + + public PStyle getStyle(PStyle s) { // ignore + if (s == null) { + s = new PStyle(); + } + + s.imageMode = imageMode; + s.rectMode = rectMode; + s.ellipseMode = ellipseMode; + s.shapeMode = shapeMode; + + s.colorMode = colorMode; + s.colorModeX = colorModeX; + s.colorModeY = colorModeY; + s.colorModeZ = colorModeZ; + s.colorModeA = colorModeA; + + s.tint = tint; + s.tintColor = tintColor; + s.fill = fill; + s.fillColor = fillColor; + s.stroke = stroke; + s.strokeColor = strokeColor; + s.strokeWeight = strokeWeight; + s.strokeCap = strokeCap; + s.strokeJoin = strokeJoin; + + s.ambientR = ambientR; + s.ambientG = ambientG; + s.ambientB = ambientB; + s.specularR = specularR; + s.specularG = specularG; + s.specularB = specularB; + s.emissiveR = emissiveR; + s.emissiveG = emissiveG; + s.emissiveB = emissiveB; + s.shininess = shininess; + + s.textFont = textFont; + s.textAlign = textAlign; + s.textAlignY = textAlignY; + s.textMode = textMode; + s.textSize = textSize; + s.textLeading = textLeading; + + return s; + } + + + + ////////////////////////////////////////////////////////////// + + // STROKE CAP/JOIN/WEIGHT + + + public void strokeWeight(float weight) { + strokeWeight = weight; + } + + + public void strokeJoin(int join) { + strokeJoin = join; + } + + + public void strokeCap(int cap) { + strokeCap = cap; + } + + + + ////////////////////////////////////////////////////////////// + + // STROKE COLOR + + + public void noStroke() { + stroke = false; + } + + + /** + * Set the tint to either a grayscale or ARGB value. + * See notes attached to the fill() function. + */ + public void stroke(int rgb) { +// if (((rgb & 0xff000000) == 0) && (rgb <= colorModeX)) { // see above +// stroke((float) rgb); +// +// } else { +// colorCalcARGB(rgb, colorModeA); +// strokeFromCalc(); +// } + colorCalc(rgb); + strokeFromCalc(); + } + + + public void stroke(int rgb, float alpha) { +// if (((rgb & 0xff000000) == 0) && (rgb <= colorModeX)) { +// stroke((float) rgb, alpha); +// +// } else { +// colorCalcARGB(rgb, alpha); +// strokeFromCalc(); +// } + colorCalc(rgb, alpha); + strokeFromCalc(); + } + + + public void stroke(float gray) { + colorCalc(gray); + strokeFromCalc(); + } + + + public void stroke(float gray, float alpha) { + colorCalc(gray, alpha); + strokeFromCalc(); + } + + + public void stroke(float x, float y, float z) { + colorCalc(x, y, z); + strokeFromCalc(); + } + + + public void stroke(float x, float y, float z, float a) { + colorCalc(x, y, z, a); + strokeFromCalc(); + } + + + protected void strokeFromCalc() { + stroke = true; + strokeR = calcR; + strokeG = calcG; + strokeB = calcB; + strokeA = calcA; + strokeRi = calcRi; + strokeGi = calcGi; + strokeBi = calcBi; + strokeAi = calcAi; + strokeColor = calcColor; + strokeAlpha = calcAlpha; + } + + + + ////////////////////////////////////////////////////////////// + + // TINT COLOR + + + public void noTint() { + tint = false; + } + + + /** + * Set the tint to either a grayscale or ARGB value. + */ + public void tint(int rgb) { +// if (((rgb & 0xff000000) == 0) && (rgb <= colorModeX)) { +// tint((float) rgb); +// +// } else { +// colorCalcARGB(rgb, colorModeA); +// tintFromCalc(); +// } + colorCalc(rgb); + tintFromCalc(); + } + + public void tint(int rgb, float alpha) { +// if (((rgb & 0xff000000) == 0) && (rgb <= colorModeX)) { +// tint((float) rgb, alpha); +// +// } else { +// colorCalcARGB(rgb, alpha); +// tintFromCalc(); +// } + colorCalc(rgb, alpha); + tintFromCalc(); + } + + public void tint(float gray) { + colorCalc(gray); + tintFromCalc(); + } + + + public void tint(float gray, float alpha) { + colorCalc(gray, alpha); + tintFromCalc(); + } + + + public void tint(float x, float y, float z) { + colorCalc(x, y, z); + tintFromCalc(); + } + + + public void tint(float x, float y, float z, float a) { + colorCalc(x, y, z, a); + tintFromCalc(); + } + + + protected void tintFromCalc() { + tint = true; + tintR = calcR; + tintG = calcG; + tintB = calcB; + tintA = calcA; + tintRi = calcRi; + tintGi = calcGi; + tintBi = calcBi; + tintAi = calcAi; + tintColor = calcColor; + tintAlpha = calcAlpha; + } + + + + ////////////////////////////////////////////////////////////// + + // FILL COLOR + + + public void noFill() { + fill = false; + } + + + /** + * Set the fill to either a grayscale value or an ARGB int. + */ + public void fill(int rgb) { +// if (((rgb & 0xff000000) == 0) && (rgb <= colorModeX)) { // see above +// fill((float) rgb); +// +// } else { +// colorCalcARGB(rgb, colorModeA); +// fillFromCalc(); +// } + colorCalc(rgb); + fillFromCalc(); + } + + + public void fill(int rgb, float alpha) { +// if (((rgb & 0xff000000) == 0) && (rgb <= colorModeX)) { // see above +// fill((float) rgb, alpha); +// +// } else { +// colorCalcARGB(rgb, alpha); +// fillFromCalc(); +// } + colorCalc(rgb, alpha); + fillFromCalc(); + } + + + public void fill(float gray) { + colorCalc(gray); + fillFromCalc(); + } + + + public void fill(float gray, float alpha) { + colorCalc(gray, alpha); + fillFromCalc(); + } + + + public void fill(float x, float y, float z) { + colorCalc(x, y, z); + fillFromCalc(); + } + + + public void fill(float x, float y, float z, float a) { + colorCalc(x, y, z, a); + fillFromCalc(); + } + + + protected void fillFromCalc() { + fill = true; + fillR = calcR; + fillG = calcG; + fillB = calcB; + fillA = calcA; + fillRi = calcRi; + fillGi = calcGi; + fillBi = calcBi; + fillAi = calcAi; + fillColor = calcColor; + fillAlpha = calcAlpha; + } + + + + ////////////////////////////////////////////////////////////// + + // MATERIAL PROPERTIES + + + public void ambient(int rgb) { +// if (((rgb & 0xff000000) == 0) && (rgb <= colorModeX)) { +// ambient((float) rgb); +// +// } else { +// colorCalcARGB(rgb, colorModeA); +// ambientFromCalc(); +// } + colorCalc(rgb); + ambientFromCalc(); + } + + + public void ambient(float gray) { + colorCalc(gray); + ambientFromCalc(); + } + + + public void ambient(float x, float y, float z) { + colorCalc(x, y, z); + ambientFromCalc(); + } + + + protected void ambientFromCalc() { + ambientR = calcR; + ambientG = calcG; + ambientB = calcB; + } + + + public void specular(int rgb) { +// if (((rgb & 0xff000000) == 0) && (rgb <= colorModeX)) { +// specular((float) rgb); +// +// } else { +// colorCalcARGB(rgb, colorModeA); +// specularFromCalc(); +// } + colorCalc(rgb); + specularFromCalc(); + } + + + public void specular(float gray) { + colorCalc(gray); + specularFromCalc(); + } + + + public void specular(float x, float y, float z) { + colorCalc(x, y, z); + specularFromCalc(); + } + + + protected void specularFromCalc() { + specularR = calcR; + specularG = calcG; + specularB = calcB; + } + + + public void shininess(float shine) { + shininess = shine; + } + + + public void emissive(int rgb) { +// if (((rgb & 0xff000000) == 0) && (rgb <= colorModeX)) { +// emissive((float) rgb); +// +// } else { +// colorCalcARGB(rgb, colorModeA); +// emissiveFromCalc(); +// } + colorCalc(rgb); + emissiveFromCalc(); + } + + + public void emissive(float gray) { + colorCalc(gray); + emissiveFromCalc(); + } + + + public void emissive(float x, float y, float z) { + colorCalc(x, y, z); + emissiveFromCalc(); + } + + + protected void emissiveFromCalc() { + emissiveR = calcR; + emissiveG = calcG; + emissiveB = calcB; + } + + + + ////////////////////////////////////////////////////////////// + + // LIGHTS + + // The details of lighting are very implementation-specific, so this base + // class does not handle any details of settings lights. It does however + // display warning messages that the functions are not available. + + + public void lights() { + showMethodWarning("lights"); + } + + public void noLights() { + showMethodWarning("noLights"); + } + + public void ambientLight(float red, float green, float blue) { + showMethodWarning("ambientLight"); + } + + public void ambientLight(float red, float green, float blue, + float x, float y, float z) { + showMethodWarning("ambientLight"); + } + + public void directionalLight(float red, float green, float blue, + float nx, float ny, float nz) { + showMethodWarning("directionalLight"); + } + + public void pointLight(float red, float green, float blue, + float x, float y, float z) { + showMethodWarning("pointLight"); + } + + public void spotLight(float red, float green, float blue, + float x, float y, float z, + float nx, float ny, float nz, + float angle, float concentration) { + showMethodWarning("spotLight"); + } + + public void lightFalloff(float constant, float linear, float quadratic) { + showMethodWarning("lightFalloff"); + } + + public void lightSpecular(float x, float y, float z) { + showMethodWarning("lightSpecular"); + } + + + + ////////////////////////////////////////////////////////////// + + // BACKGROUND + + /** + * Set the background to a gray or ARGB color. + *

+ * For the main drawing surface, the alpha value will be ignored. However, + * alpha can be used on PGraphics objects from createGraphics(). This is + * the only way to set all the pixels partially transparent, for instance. + *

+ * Note that background() should be called before any transformations occur, + * because some implementations may require the current transformation matrix + * to be identity before drawing. + */ + public void background(int rgb) { +// if (((rgb & 0xff000000) == 0) && (rgb <= colorModeX)) { +// background((float) rgb); +// +// } else { +// if (format == RGB) { +// rgb |= 0xff000000; // ignore alpha for main drawing surface +// } +// colorCalcARGB(rgb, colorModeA); +// backgroundFromCalc(); +// backgroundImpl(); +// } + colorCalc(rgb); + backgroundFromCalc(); + } + + + /** + * See notes about alpha in background(x, y, z, a). + */ + public void background(int rgb, float alpha) { +// if (format == RGB) { +// background(rgb); // ignore alpha for main drawing surface +// +// } else { +// if (((rgb & 0xff000000) == 0) && (rgb <= colorModeX)) { +// background((float) rgb, alpha); +// +// } else { +// colorCalcARGB(rgb, alpha); +// backgroundFromCalc(); +// backgroundImpl(); +// } +// } + colorCalc(rgb, alpha); + backgroundFromCalc(); + } + + + /** + * Set the background to a grayscale value, based on the + * current colorMode. + */ + public void background(float gray) { + colorCalc(gray); + backgroundFromCalc(); +// backgroundImpl(); + } + + + /** + * See notes about alpha in background(x, y, z, a). + */ + public void background(float gray, float alpha) { + if (format == RGB) { + background(gray); // ignore alpha for main drawing surface + + } else { + colorCalc(gray, alpha); + backgroundFromCalc(); +// backgroundImpl(); + } + } + + + /** + * Set the background to an r, g, b or h, s, b value, + * based on the current colorMode. + */ + public void background(float x, float y, float z) { + colorCalc(x, y, z); + backgroundFromCalc(); +// backgroundImpl(); + } + + + /** + * Clear the background with a color that includes an alpha value. This can + * only be used with objects created by createGraphics(), because the main + * drawing surface cannot be set transparent. + *

+ * It might be tempting to use this function to partially clear the screen + * on each frame, however that's not how this function works. When calling + * background(), the pixels will be replaced with pixels that have that level + * of transparency. To do a semi-transparent overlay, use fill() with alpha + * and draw a rectangle. + */ + public void background(float x, float y, float z, float a) { +// if (format == RGB) { +// background(x, y, z); // don't allow people to set alpha +// +// } else { +// colorCalc(x, y, z, a); +// backgroundFromCalc(); +// backgroundImpl(); +// } + colorCalc(x, y, z, a); + backgroundFromCalc(); + } + + + protected void backgroundFromCalc() { + backgroundR = calcR; + backgroundG = calcG; + backgroundB = calcB; + backgroundA = (format == RGB) ? colorModeA : calcA; + backgroundRi = calcRi; + backgroundGi = calcGi; + backgroundBi = calcBi; + backgroundAi = (format == RGB) ? 255 : calcAi; + backgroundAlpha = (format == RGB) ? false : calcAlpha; + backgroundColor = calcColor; + + backgroundImpl(); + } + + + /** + * 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. Using image.filter(OPAQUE) will handle this easily. + *

+ * When using 3D, this will also clear the zbuffer (if it exists). + */ + public void background(PImage image) { + if ((image.width != width) || (image.height != height)) { + throw new RuntimeException(ERROR_BACKGROUND_IMAGE_SIZE); + } + if ((image.format != RGB) && (image.format != ARGB)) { + throw new RuntimeException(ERROR_BACKGROUND_IMAGE_FORMAT); + } + backgroundColor = 0; // just zero it out for images + backgroundImpl(image); + } + + + /** + * Actually set the background image. This is separated from the error + * handling and other semantic goofiness that is shared across renderers. + */ + protected void backgroundImpl(PImage image) { + // blit image to the screen + set(0, 0, image); + } + + + /** + * Actual implementation of clearing the background, now that the + * internal variables for background color have been set. Called by the + * backgroundFromCalc() method, which is what all the other background() + * methods call once the work is done. + */ + protected void backgroundImpl() { + pushStyle(); + pushMatrix(); + resetMatrix(); + fill(backgroundColor); + rect(0, 0, width, height); + popMatrix(); + popStyle(); + } + + + /** + * Callback to handle clearing the background when begin/endRaw is in use. + * Handled as separate function for OpenGL (or other) subclasses that + * override backgroundImpl() but still needs this to work properly. + */ +// protected void backgroundRawImpl() { +// if (raw != null) { +// raw.colorMode(RGB, 1); +// raw.noStroke(); +// raw.fill(backgroundR, backgroundG, backgroundB); +// raw.beginShape(TRIANGLES); +// +// raw.vertex(0, 0); +// raw.vertex(width, 0); +// raw.vertex(0, height); +// +// raw.vertex(width, 0); +// raw.vertex(width, height); +// raw.vertex(0, height); +// +// raw.endShape(); +// } +// } + + + + ////////////////////////////////////////////////////////////// + + // COLOR MODE + + + public void colorMode(int mode) { + colorMode(mode, colorModeX, colorModeY, colorModeZ, colorModeA); + } + + + public void colorMode(int mode, float max) { + colorMode(mode, max, max, max, max); + } + + + /** + * Set the colorMode and the maximum values for (r, g, b) + * or (h, s, b). + *

+ * Note that this doesn't set the maximum for the alpha value, + * which might be confusing if for instance you switched to + * 

colorMode(HSB, 360, 100, 100);
+ * because the alpha values were still between 0 and 255. + */ + public void colorMode(int mode, float maxX, float maxY, float maxZ) { + colorMode(mode, maxX, maxY, maxZ, colorModeA); + } + + + public void colorMode(int mode, + float maxX, float maxY, float maxZ, float maxA) { + colorMode = mode; + + colorModeX = maxX; // still needs to be set for hsb + colorModeY = maxY; + colorModeZ = maxZ; + colorModeA = maxA; + + // if color max values are all 1, then no need to scale + colorModeScale = + ((maxA != 1) || (maxX != maxY) || (maxY != maxZ) || (maxZ != maxA)); + + // if color is rgb/0..255 this will make it easier for the + // red() green() etc functions + colorModeDefault = (colorMode == RGB) && + (colorModeA == 255) && (colorModeX == 255) && + (colorModeY == 255) && (colorModeZ == 255); + } + + + + ////////////////////////////////////////////////////////////// + + // COLOR CALCULATIONS + + // Given input values for coloring, these functions will fill the calcXxxx + // variables with values that have been properly filtered through the + // current colorMode settings. + + // Renderers that need to subclass any drawing properties such as fill or + // stroke will usally want to override methods like fillFromCalc (or the + // same for stroke, ambient, etc.) That way the color calcuations are + // covered by this based PGraphics class, leaving only a single function + // to override/implement in the subclass. + + + /** + * Set the fill to either a grayscale value or an ARGB int. + *

+ * The problem with this code is that it has to detect between these two + * situations automatically. This is done by checking to see if the high bits + * (the alpha for 0xAA000000) is set, and if not, whether the color value + * that follows is less than colorModeX (first param passed to colorMode). + *

+ * This auto-detect would break in the following situation: + * 

size(256, 256);
+   * for (int i = 0; i < 256; i++) {
+   *   color c = color(0, 0, 0, i);
+   *   stroke(c);
+   *   line(i, 0, i, 256);
+   * }
+ * ...on the first time through the loop, where (i == 0), since the color + * itself is zero (black) then it would appear indistinguishable from code + * that reads "fill(0)". The solution is to use the four parameter versions + * of stroke or fill to more directly specify the desired result. + */ + protected void colorCalc(int rgb) { + if (((rgb & 0xff000000) == 0) && (rgb <= colorModeX)) { + colorCalc((float) rgb); + + } else { + colorCalcARGB(rgb, colorModeA); + } + } + + + protected void colorCalc(int rgb, float alpha) { + if (((rgb & 0xff000000) == 0) && (rgb <= colorModeX)) { // see above + colorCalc((float) rgb, alpha); + + } else { + colorCalcARGB(rgb, alpha); + } + } + + + protected void colorCalc(float gray) { + colorCalc(gray, colorModeA); + } + + + protected void colorCalc(float gray, float alpha) { + if (gray > colorModeX) gray = colorModeX; + if (alpha > colorModeA) alpha = colorModeA; + + if (gray < 0) gray = 0; + if (alpha < 0) alpha = 0; + + calcR = colorModeScale ? (gray / colorModeX) : gray; + calcG = calcR; + calcB = calcR; + calcA = colorModeScale ? (alpha / colorModeA) : alpha; + + calcRi = (int)(calcR*255); calcGi = (int)(calcG*255); + calcBi = (int)(calcB*255); calcAi = (int)(calcA*255); + calcColor = (calcAi << 24) | (calcRi << 16) | (calcGi << 8) | calcBi; + calcAlpha = (calcAi != 255); + } + + + protected void colorCalc(float x, float y, float z) { + colorCalc(x, y, z, colorModeA); + } + + + protected void colorCalc(float x, float y, float z, float a) { + if (x > colorModeX) x = colorModeX; + if (y > colorModeY) y = colorModeY; + if (z > colorModeZ) z = colorModeZ; + if (a > colorModeA) a = colorModeA; + + if (x < 0) x = 0; + if (y < 0) y = 0; + if (z < 0) z = 0; + if (a < 0) a = 0; + + switch (colorMode) { + case RGB: + if (colorModeScale) { + calcR = x / colorModeX; + calcG = y / colorModeY; + calcB = z / colorModeZ; + calcA = a / colorModeA; + } else { + calcR = x; calcG = y; calcB = z; calcA = a; + } + break; + + case HSB: + x /= colorModeX; // h + y /= colorModeY; // s + z /= colorModeZ; // b + + calcA = colorModeScale ? (a/colorModeA) : a; + + if (y == 0) { // saturation == 0 + calcR = calcG = calcB = z; + + } else { + float which = (x - (int)x) * 6.0f; + float f = which - (int)which; + float p = z * (1.0f - y); + float q = z * (1.0f - y * f); + float t = z * (1.0f - (y * (1.0f - f))); + + switch ((int)which) { + case 0: calcR = z; calcG = t; calcB = p; break; + case 1: calcR = q; calcG = z; calcB = p; break; + case 2: calcR = p; calcG = z; calcB = t; break; + case 3: calcR = p; calcG = q; calcB = z; break; + case 4: calcR = t; calcG = p; calcB = z; break; + case 5: calcR = z; calcG = p; calcB = q; break; + } + } + break; + } + calcRi = (int)(255*calcR); calcGi = (int)(255*calcG); + calcBi = (int)(255*calcB); calcAi = (int)(255*calcA); + calcColor = (calcAi << 24) | (calcRi << 16) | (calcGi << 8) | calcBi; + calcAlpha = (calcAi != 255); + } + + + /** + * Unpacks AARRGGBB color for direct use with colorCalc. + *

+ * Handled here with its own function since this is indepenent + * of the color mode. + *

+ * Strangely the old version of this code ignored the alpha + * value. not sure if that was a bug or what. + *

+ * Note, no need for a bounds check since it's a 32 bit number. + */ + protected void colorCalcARGB(int argb, float alpha) { + if (alpha == colorModeA) { + calcAi = (argb >> 24) & 0xff; + calcColor = argb; + } else { + calcAi = (int) (((argb >> 24) & 0xff) * (alpha / colorModeA)); + calcColor = (calcAi << 24) | (argb & 0xFFFFFF); + } + calcRi = (argb >> 16) & 0xff; + calcGi = (argb >> 8) & 0xff; + calcBi = argb & 0xff; + calcA = (float)calcAi / 255.0f; + calcR = (float)calcRi / 255.0f; + calcG = (float)calcGi / 255.0f; + calcB = (float)calcBi / 255.0f; + calcAlpha = (calcAi != 255); + } + + + + ////////////////////////////////////////////////////////////// + + // COLOR DATATYPE STUFFING + + // The 'color' primitive type in Processing syntax is in fact a 32-bit int. + // These functions handle stuffing color values into a 32-bit cage based + // on the current colorMode settings. + + // These functions are really slow (because they take the current colorMode + // into account), but they're easy to use. Advanced users can write their + // own bit shifting operations to setup 'color' data types. + + + public final int color(int gray) { // ignore + if (((gray & 0xff000000) == 0) && (gray <= colorModeX)) { + if (colorModeDefault) { + // bounds checking to make sure the numbers aren't to high or low + if (gray > 255) gray = 255; else if (gray < 0) gray = 0; + return 0xff000000 | (gray << 16) | (gray << 8) | gray; + } else { + colorCalc(gray); + } + } else { + colorCalcARGB(gray, colorModeA); + } + return calcColor; + } + + + public final int color(float gray) { // ignore + colorCalc(gray); + return calcColor; + } + + + /** + * @param gray can be packed ARGB or a gray in this case + */ + public final int color(int gray, int alpha) { // ignore + if (colorModeDefault) { + // bounds checking to make sure the numbers aren't to high or low + if (gray > 255) gray = 255; else if (gray < 0) gray = 0; + if (alpha > 255) alpha = 255; else if (alpha < 0) alpha = 0; + + return ((alpha & 0xff) << 24) | (gray << 16) | (gray << 8) | gray; + } + colorCalc(gray, alpha); + return calcColor; + } + + + /** + * @param rgb can be packed ARGB or a gray in this case + */ + public final int color(int rgb, float alpha) { // ignore + if (((rgb & 0xff000000) == 0) && (rgb <= colorModeX)) { + colorCalc(rgb, alpha); + } else { + colorCalcARGB(rgb, alpha); + } + return calcColor; + } + + + public final int color(float gray, float alpha) { // ignore + colorCalc(gray, alpha); + return calcColor; + } + + + public final int color(int x, int y, int z) { // ignore + if (colorModeDefault) { + // bounds checking to make sure the numbers aren't to high or low + if (x > 255) x = 255; else if (x < 0) x = 0; + if (y > 255) y = 255; else if (y < 0) y = 0; + if (z > 255) z = 255; else if (z < 0) z = 0; + + return 0xff000000 | (x << 16) | (y << 8) | z; + } + colorCalc(x, y, z); + return calcColor; + } + + + public final int color(float x, float y, float z) { // ignore + colorCalc(x, y, z); + return calcColor; + } + + + public final int color(int x, int y, int z, int a) { // ignore + if (colorModeDefault) { + // bounds checking to make sure the numbers aren't to high or low + if (a > 255) a = 255; else if (a < 0) a = 0; + if (x > 255) x = 255; else if (x < 0) x = 0; + if (y > 255) y = 255; else if (y < 0) y = 0; + if (z > 255) z = 255; else if (z < 0) z = 0; + + return (a << 24) | (x << 16) | (y << 8) | z; + } + colorCalc(x, y, z, a); + return calcColor; + } + + + public final int color(float x, float y, float z, float a) { // ignore + colorCalc(x, y, z, a); + return calcColor; + } + + + + ////////////////////////////////////////////////////////////// + + // COLOR DATATYPE EXTRACTION + + // Vee have veys of making the colors talk. + + + public final float alpha(int what) { + float c = (what >> 24) & 0xff; + if (colorModeA == 255) return c; + return (c / 255.0f) * colorModeA; + } + + + public final float red(int what) { + float c = (what >> 16) & 0xff; + if (colorModeDefault) return c; + return (c / 255.0f) * colorModeX; + } + + + public final float green(int what) { + float c = (what >> 8) & 0xff; + if (colorModeDefault) return c; + return (c / 255.0f) * colorModeY; + } + + + public final float blue(int what) { + float c = (what) & 0xff; + if (colorModeDefault) return c; + return (c / 255.0f) * colorModeZ; + } + + + public final float hue(int what) { + if (what != cacheHsbKey) { + Color.RGBtoHSB((what >> 16) & 0xff, (what >> 8) & 0xff, + what & 0xff, cacheHsbValue); + cacheHsbKey = what; + } + return cacheHsbValue[0] * colorModeX; + } + + + public final float saturation(int what) { + if (what != cacheHsbKey) { + Color.RGBtoHSB((what >> 16) & 0xff, (what >> 8) & 0xff, + what & 0xff, cacheHsbValue); + cacheHsbKey = what; + } + return cacheHsbValue[1] * colorModeY; + } + + + public final float brightness(int what) { + if (what != cacheHsbKey) { + Color.RGBtoHSB((what >> 16) & 0xff, (what >> 8) & 0xff, + what & 0xff, cacheHsbValue); + cacheHsbKey = what; + } + return cacheHsbValue[2] * colorModeZ; + } + + + + ////////////////////////////////////////////////////////////// + + // COLOR DATATYPE INTERPOLATION + + // Against our better judgement. + + + /** + * Interpolate between two colors, using the current color mode. + */ + public int lerpColor(int c1, int c2, float amt) { + return lerpColor(c1, c2, amt, colorMode); + } + + static float[] lerpColorHSB1; + static float[] lerpColorHSB2; + + /** + * Interpolate between two colors. Like lerp(), but for the + * individual color components of a color supplied as an int value. + */ + static public int lerpColor(int c1, int c2, float amt, int mode) { + if (mode == RGB) { + float a1 = ((c1 >> 24) & 0xff); + float r1 = (c1 >> 16) & 0xff; + float g1 = (c1 >> 8) & 0xff; + float b1 = c1 & 0xff; + float a2 = (c2 >> 24) & 0xff; + float r2 = (c2 >> 16) & 0xff; + float g2 = (c2 >> 8) & 0xff; + float b2 = c2 & 0xff; + + return (((int) (a1 + (a2-a1)*amt) << 24) | + ((int) (r1 + (r2-r1)*amt) << 16) | + ((int) (g1 + (g2-g1)*amt) << 8) | + ((int) (b1 + (b2-b1)*amt))); + + } else if (mode == HSB) { + if (lerpColorHSB1 == null) { + lerpColorHSB1 = new float[3]; + lerpColorHSB2 = new float[3]; + } + + float a1 = (c1 >> 24) & 0xff; + float a2 = (c2 >> 24) & 0xff; + int alfa = ((int) (a1 + (a2-a1)*amt)) << 24; + + Color.RGBtoHSB((c1 >> 16) & 0xff, (c1 >> 8) & 0xff, c1 & 0xff, + lerpColorHSB1); + Color.RGBtoHSB((c2 >> 16) & 0xff, (c2 >> 8) & 0xff, c2 & 0xff, + lerpColorHSB2); + + /* If mode is HSB, this will take the shortest path around the + * color wheel to find the new color. For instance, red to blue + * will go red violet blue (backwards in hue space) rather than + * cycling through ROYGBIV. + */ + // Disabling rollover (wasn't working anyway) for 0126. + // Otherwise it makes full spectrum scale impossible for + // those who might want it...in spite of how despicable + // a full spectrum scale might be. + // roll around when 0.9 to 0.1 + // more than 0.5 away means that it should roll in the other direction + /* + float h1 = lerpColorHSB1[0]; + float h2 = lerpColorHSB2[0]; + if (Math.abs(h1 - h2) > 0.5f) { + if (h1 > h2) { + // i.e. h1 is 0.7, h2 is 0.1 + h2 += 1; + } else { + // i.e. h1 is 0.1, h2 is 0.7 + h1 += 1; + } + } + float ho = (PApplet.lerp(lerpColorHSB1[0], lerpColorHSB2[0], amt)) % 1.0f; + */ + float ho = PApplet.lerp(lerpColorHSB1[0], lerpColorHSB2[0], amt); + float so = PApplet.lerp(lerpColorHSB1[1], lerpColorHSB2[1], amt); + float bo = PApplet.lerp(lerpColorHSB1[2], lerpColorHSB2[2], amt); + + return alfa | (Color.HSBtoRGB(ho, so, bo) & 0xFFFFFF); + } + return 0; + } + + + + ////////////////////////////////////////////////////////////// + + // BEGINRAW/ENDRAW + + + /** + * Record individual lines and triangles by echoing them to another renderer. + */ + public void beginRaw(PGraphics rawGraphics) { // ignore + this.raw = rawGraphics; + rawGraphics.beginDraw(); + } + + + public void endRaw() { // ignore + if (raw != null) { + // for 3D, need to flush any geometry that's been stored for sorting + // (particularly if the ENABLE_DEPTH_SORT hint is set) + flush(); + + // just like beginDraw, this will have to be called because + // endDraw() will be happening outside of draw() + raw.endDraw(); + raw.dispose(); + raw = null; + } + } + + + + ////////////////////////////////////////////////////////////// + + // WARNINGS and EXCEPTIONS + + + static protected HashMap warnings; + + + /** + * Show a renderer error, and keep track of it so that it's only shown once. + * @param msg the error message (which will be stored for later comparison) + */ + static public void showWarning(String msg) { // ignore + if (warnings == null) { + warnings = new HashMap(); + } + if (!warnings.containsKey(msg)) { + System.err.println(msg); + warnings.put(msg, new Object()); + } + } + + + /** + * Display a warning that the specified method is only available with 3D. + * @param method The method name (no parentheses) + */ + static protected void showDepthWarning(String method) { + showWarning(method + "() can only be used with a renderer that " + + "supports 3D, such as P3D or OPENGL."); + } + + + /** + * Display a warning that the specified method that takes x, y, z parameters + * can only be used with x and y parameters in this renderer. + * @param method The method name (no parentheses) + */ + static protected void showDepthWarningXYZ(String method) { + showWarning(method + "() with x, y, and z coordinates " + + "can only be used with a renderer that " + + "supports 3D, such as P3D or OPENGL. " + + "Use a version without a z-coordinate instead."); + } + + + /** + * Display a warning that the specified method is simply unavailable. + */ + static protected void showMethodWarning(String method) { + showWarning(method + "() is not available with this renderer."); + } + + + /** + * Error that a particular variation of a method is unavailable (even though + * other variations are). For instance, if vertex(x, y, u, v) is not + * available, but vertex(x, y) is just fine. + */ + static protected void showVariationWarning(String str) { + showWarning(str + " is not available with this renderer."); + } + + + /** + * Display a warning that the specified method is not implemented, meaning + * that it could be either a completely missing function, although other + * variations of it may still work properly. + */ + static protected void showMissingWarning(String method) { + showWarning(method + "(), or this particular variation of it, " + + "is not available with this renderer."); + } + + + /** + * Show an renderer-related exception that halts the program. Currently just + * wraps the message as a RuntimeException and throws it, but might do + * something more specific might be used in the future. + */ + static public void showException(String msg) { // ignore + throw new RuntimeException(msg); + } + + + /** + * Throw an exeption that halts the program because textFont() has not been + * used prior to the specified method. + */ + static protected void showTextFontException(String method) { + throw new RuntimeException("Use textFont() before " + method + "()"); + } + + + + ////////////////////////////////////////////////////////////// + + // RENDERER SUPPORT QUERIES + + + /** + * Return true if this renderer should be drawn to the screen. Defaults to + * returning true, since nearly all renderers are on-screen beasts. But can + * be overridden for subclasses like PDF so that a window doesn't open up. + *

+ * A better name? showFrame, displayable, isVisible, visible, shouldDisplay, + * what to call this? + */ + public boolean displayable() { + return true; + } + + + /** + * Return true if this renderer supports 2D drawing. Defaults to true. + */ + public boolean is2D() { + return true; + } + + + /** + * Return true if this renderer supports 2D drawing. Defaults to true. + */ + public boolean is3D() { + return false; + } +} diff --git a/core/methods/demo/PImage.java b/core/methods/demo/PImage.java new file mode 100644 index 000000000..276617825 --- /dev/null +++ b/core/methods/demo/PImage.java @@ -0,0 +1,2862 @@ +/* -*- mode: java; c-basic-offset: 2; indent-tabs-mode: nil -*- */ + +/* + Part of the Processing project - http://processing.org + + Copyright (c) 2004-08 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.image.*; +import java.io.*; +import java.util.HashMap; + +import javax.imageio.ImageIO; + + + + +/** + * Datatype for storing images. Processing can display .gif, .jpg, .tga, and .png images. Images may be displayed in 2D and 3D space. + * Before an image is used, it must be loaded with the loadImage() function. + * The PImage object contains fields for the width and height of the image, + * as well as an array called pixels[] which contains the values for every pixel in the image. + * A group of methods, described below, allow easy access to the image's pixels and alpha channel and simplify the process of compositing. + *

Before using the pixels[] array, be sure to use the loadPixels() method on the image to make sure that the pixel data is properly loaded. + *

To create a new image, use the createImage() function (do not use new PImage()). + * =advanced + * + * Storage class for pixel data. This is the base class for most image and + * pixel information, such as PGraphics and the video library classes. + *

+ * Code for copying, resizing, scaling, and blending contributed + * by toxi. + *

+ * + * @webref image + * @usage Web & Application + * @instanceName img any variable of type PImage + * @see processing.core.PApplet#loadImage(String) + * @see processing.core.PApplet#imageMode(int) + * @see processing.core.PApplet#createImage(int, int) + */ +public class PImage implements PConstants, Cloneable { + + /** + * Format for this image, one of RGB, ARGB or ALPHA. + * note that RGB images still require 0xff in the high byte + * because of how they'll be manipulated by other functions + */ + public int format; + + /** + * Array containing the values for all the pixels in the image. These values are of the color datatype. + * This array is the size of the image, meaning if the image is 100x100 pixels, there will be 10000 values + * and if the window is 200x300 pixels, there will be 60000 values. + * The index value defines the position of a value within the array. + * For example, the statement color b = img.pixels[230] will set the variable b equal to the value at that location in the array. + * Before accessing this array, the data must loaded with the loadPixels() method. + * After the array data has been modified, the updatePixels() method must be run to update the changes. + * Without loadPixels(), running the code may (or will in future releases) result in a NullPointerException. + * @webref + * @brief Array containing the color of every pixel in the image + */ + public int[] pixels; + + /** + * The width of the image in units of pixels. + * @webref + * @brief Image width + */ + public int width; + /** + * The height of the image in units of pixels. + * @webref + * @brief Image height + */ + public int height; + + /** + * Path to parent object that will be used with save(). + * This prevents users from needing savePath() to use PImage.save(). + */ + public PApplet parent; + + + // . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . + + + /** for subclasses that need to store info about the image */ + protected HashMap cacheMap; + + + /** modified portion of the image */ + protected boolean modified; + protected int mx1, my1, mx2, my2; + + + // . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . + + + // private fields + private int fracU, ifU, fracV, ifV, u1, u2, v1, v2, sX, sY, iw, iw1, ih1; + private int ul, ll, ur, lr, cUL, cLL, cUR, cLR; + private int srcXOffset, srcYOffset; + private int r, g, b, a; + private int[] srcBuffer; + + // fixed point precision is limited to 15 bits!! + static final int PRECISIONB = 15; + static final int PRECISIONF = 1 << PRECISIONB; + static final int PREC_MAXVAL = PRECISIONF-1; + static final int PREC_ALPHA_SHIFT = 24-PRECISIONB; + static final int PREC_RED_SHIFT = 16-PRECISIONB; + + // internal kernel stuff for the gaussian blur filter + private int blurRadius; + private int blurKernelSize; + private int[] blurKernel; + private int[][] blurMult; + + + ////////////////////////////////////////////////////////////// + + + /** + * Create an empty image object, set its format to RGB. + * The pixel array is not allocated. + */ + public PImage() { + format = ARGB; // default to ARGB images for release 0116 +// cache = null; + } + + + /** + * Create a new RGB (alpha ignored) image of a specific size. + * All pixels are set to zero, meaning black, but since the + * alpha is zero, it will be transparent. + */ + public PImage(int width, int height) { + init(width, height, RGB); + + // toxi: is it maybe better to init the image with max alpha enabled? + //for(int i=0; i(); + cacheMap.put(parent, storage); + } + + + /** + * Get cache storage data for the specified renderer. Because each renderer + * will cache data in different formats, it's necessary to store cache data + * keyed by the renderer object. Otherwise, attempting to draw the same + * image to both a PGraphicsJava2D and a PGraphicsOpenGL will cause errors. + * @param parent The PGraphics object (or any object, really) associated + * @return data stored for the specified parent + */ + public Object getCache(Object parent) { + if (cacheMap == null) return null; + return cacheMap.get(parent); + } + + + /** + * Remove information associated with this renderer from the cache, if any. + * @param parent The PGraphics object whose cache data should be removed + */ + public void removeCache(Object parent) { + if (cacheMap != null) { + cacheMap.remove(parent); + } + } + + + + ////////////////////////////////////////////////////////////// + + // MARKING IMAGE AS MODIFIED / FOR USE w/ GET/SET + + + public boolean isModified() { // ignore + return modified; + } + + + public void setModified() { // ignore + modified = true; + } + + + public void setModified(boolean m) { // ignore + modified = m; + } + + + /** + * Loads the pixel data for the image into its pixels[] array. This function must always be called before reading from or writing to pixels[]. + *

Certain renderers may or may not seem to require loadPixels() or updatePixels(). However, the rule is that any time you want to manipulate the pixels[] array, you must first call loadPixels(), and after changes have been made, call updatePixels(). Even if the renderer may not seem to use this function in the current Processing release, this will always be subject to change. + * =advanced + * Call this when you want to mess with the pixels[] array. + *

+ * For subclasses where the pixels[] buffer isn't set by default, + * this should copy all data into the pixels[] array + * + * @webref + * @brief Loads the pixel data for the image into its pixels[] array + */ + public void loadPixels() { // ignore + } + + public void updatePixels() { // ignore + updatePixelsImpl(0, 0, width, height); + } + + /** + * Updates the image with the data in its pixels[] array. Use in conjunction with loadPixels(). If you're only reading pixels from the array, there's no need to call updatePixels(). + *

Certain renderers may or may not seem to require loadPixels() or updatePixels(). However, the rule is that any time you want to manipulate the pixels[] array, you must first call loadPixels(), and after changes have been made, call updatePixels(). 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 updatePixels(), however this may be implemented in the future. + * =advanced + * Mark the pixels in this region as needing an update. + * This is not currently used by any of the renderers, however the api + * is structured this way in the hope of being able to use this to + * speed things up in the future. + * @webref + * @brief Updates the image with the data in its pixels[] array + * @param x + * @param y + * @param w + * @param h + */ + public void updatePixels(int x, int y, int w, int h) { // ignore +// if (imageMode == CORNER) { // x2, y2 are w/h +// x2 += x1; +// y2 += y1; +// +// } else if (imageMode == CENTER) { +// x1 -= x2 / 2; +// y1 -= y2 / 2; +// x2 += x1; +// y2 += y1; +// } + updatePixelsImpl(x, y, w, h); + } + + + protected void updatePixelsImpl(int x, int y, int w, int h) { + int x2 = x + w; + int y2 = y + h; + + if (!modified) { + mx1 = x; + mx2 = x2; + my1 = y; + my2 = y2; + modified = true; + + } else { + if (x < mx1) mx1 = x; + if (x > mx2) mx2 = x; + if (y < my1) my1 = y; + if (y > my2) my2 = y; + + if (x2 < mx1) mx1 = x2; + if (x2 > mx2) mx2 = x2; + if (y2 < my1) my1 = y2; + if (y2 > my2) my2 = y2; + } + } + + + + ////////////////////////////////////////////////////////////// + + // COPYING IMAGE DATA + + + /** + * Duplicate an image, returns new PImage object. + * The pixels[] array for the new object will be unique + * and recopied from the source image. This is implemented as an + * override of Object.clone(). We recommend using get() instead, + * because it prevents you from needing to catch the + * CloneNotSupportedException, and from doing a cast from the result. + */ + public Object clone() throws CloneNotSupportedException { // ignore + PImage c = (PImage) super.clone(); + + // super.clone() will only copy the reference to the pixels + // array, so this will do a proper duplication of it instead. + c.pixels = new int[width * height]; + System.arraycopy(pixels, 0, c.pixels, 0, pixels.length); + + // return the goods + return c; + } + + + /** + * Resize the image to a new width and height. To make the image scale proportionally, use 0 as the value for the wide or high parameter. + * + * @webref + * @brief Changes the size of an image to a new width and height + * @param wide the resized image width + * @param high the resized image height + * + * @see processing.core.PImage#get(int, int, int, int) + */ + public void resize(int wide, int high) { // ignore + // Make sure that the pixels[] array is valid + loadPixels(); + + if (wide <= 0 && high <= 0) { + width = 0; // Gimme a break, don't waste my time + height = 0; + pixels = new int[0]; + + } else { + if (wide == 0) { // Use height to determine relative size + float diff = (float) high / (float) height; + wide = (int) (width * diff); + } else if (high == 0) { // Use the width to determine relative size + float diff = (float) wide / (float) width; + high = (int) (height * diff); + } + PImage temp = new PImage(wide, high, this.format); + temp.copy(this, 0, 0, width, height, 0, 0, wide, high); + this.width = wide; + this.height = high; + this.pixels = temp.pixels; + } + // Mark the pixels array as altered + updatePixels(); + } + + + + ////////////////////////////////////////////////////////////// + + // GET/SET PIXELS + + + /** + * Returns an ARGB "color" type (a packed 32 bit int with the color. + * If the coordinate is outside the image, zero is returned + * (black, but completely transparent). + *

+ * If the image is in RGB format (i.e. on a PVideo object), + * the value will get its high bits set, just to avoid cases where + * they haven't been set already. + *

+ * If the image is in ALPHA format, this returns a white with its + * alpha value set. + *

+ * This function is included primarily for beginners. It is quite + * slow because it has to check to see if the x, y that was provided + * is inside the bounds, and then has to check to see what image + * type it is. If you want things to be more efficient, access the + * pixels[] array directly. + */ + public int get(int x, int y) { + if ((x < 0) || (y < 0) || (x >= width) || (y >= height)) return 0; + + switch (format) { + case RGB: + return pixels[y*width + x] | 0xff000000; + + case ARGB: + return pixels[y*width + x]; + + case ALPHA: + return (pixels[y*width + x] << 24) | 0xffffff; + } + return 0; + } + + + /** + * Reads the color of any pixel or grabs a group of pixels. If no parameters are specified, the entire image is returned. Get the value of one pixel by specifying an x,y coordinate. Get a section of the display window by specifing an additional width and height parameter. 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. Even though you may have drawn a shape with colorMode(HSB), the numbers returned will be in RGB. + *

Getting the color of a single pixel with get(x, y) is easy, but not as fast as grabbing the data directly from pixels[]. The equivalent statement to "get(x, y)" using pixels[] is "pixels[y*width+x]". Processing requires calling loadPixels() to load the display window data into the pixels[] array before getting the values. + *

As of release 0149, this function ignores imageMode(). + * + * @webref + * @brief Reads the color of any pixel or grabs a rectangle of pixels + * @param x x-coordinate of the pixel + * @param y y-coordinate of the pixel + * @param w width of pixel rectangle to get + * @param h height of pixel rectangle to get + * + * @see processing.core.PImage#set(int, int, int) + * @see processing.core.PImage#pixels + * @see processing.core.PImage#copy(PImage, int, int, int, int, int, int, int, int) + */ + public PImage get(int x, int y, int w, int h) { + /* + if (imageMode == CORNERS) { // if CORNER, do nothing + //x2 += x1; y2 += y1; + // w/h are x2/y2 in this case, bring em down to size + w = (w - x); + h = (h - y); + } else if (imageMode == CENTER) { + x -= w/2; + y -= h/2; + } + */ + + if (x < 0) { + w += x; // clip off the left edge + x = 0; + } + if (y < 0) { + h += y; // clip off some of the height + y = 0; + } + + if (x + w > width) w = width - x; + if (y + h > height) h = height - y; + + return getImpl(x, y, w, h); + } + + + /** + * Internal function to actually handle getting a block of pixels that + * has already been properly cropped to a valid region. That is, x/y/w/h + * are guaranteed to be inside the image space, so the implementation can + * use the fastest possible pixel copying method. + */ + protected PImage getImpl(int x, int y, int w, int h) { + PImage newbie = new PImage(w, h, format); + newbie.parent = parent; + + int index = y*width + x; + int index2 = 0; + for (int row = y; row < y+h; row++) { + System.arraycopy(pixels, index, newbie.pixels, index2, w); + index += width; + index2 += w; + } + return newbie; + } + + + /** + * Returns a copy of this PImage. Equivalent to get(0, 0, width, height). + */ + public PImage get() { + try { + PImage clone = (PImage) clone(); + // don't want to pass this down to the others + // http://dev.processing.org/bugs/show_bug.cgi?id=1245 + clone.cacheMap = null; + return clone; + } catch (CloneNotSupportedException e) { + return null; + } + } + + /** + * Changes the color of any pixel or writes an image directly into the image. The x and y parameter specify the pixel or the upper-left corner of the image. The color parameter specifies the color value.

Setting the color of a single pixel with set(x, y) is easy, but not as fast as putting the data directly into pixels[]. The equivalent statement to "set(x, y, #000000)" using pixels[] is "pixels[y*width+x] = #000000". Processing requires calling loadPixels() to load the display window data into the pixels[] array before getting the values and calling updatePixels() to update the window. + *

As of release 0149, this function ignores imageMode(). + * + * @webref + * @brief Writes a color to any pixel or writes an image into another + * @param x x-coordinate of the pixel or upper-left corner of the image + * @param y y-coordinate of the pixel or upper-left corner of the image + * @param c any value of the color datatype + * + * @see processing.core.PImage#get(int, int, int, int) + * @see processing.core.PImage#pixels + * @see processing.core.PImage#copy(PImage, int, int, int, int, int, int, int, int) + */ + public void set(int x, int y, int c) { + if ((x < 0) || (y < 0) || (x >= width) || (y >= height)) return; + pixels[y*width + x] = c; + updatePixelsImpl(x, y, x+1, y+1); // slow? + } + + + /** + * Efficient method of drawing an image's pixels directly to this surface. + * No variations are employed, meaning that any scale, tint, or imageMode + * settings will be ignored. + */ + public void set(int x, int y, PImage src) { + int sx = 0; + int sy = 0; + int sw = src.width; + int sh = src.height; + +// if (imageMode == CENTER) { +// x -= src.width/2; +// y -= src.height/2; +// } + if (x < 0) { // off left edge + sx -= x; + sw += x; + x = 0; + } + if (y < 0) { // off top edge + sy -= y; + sh += y; + y = 0; + } + if (x + sw > width) { // off right edge + sw = width - x; + } + if (y + sh > height) { // off bottom edge + sh = height - y; + } + + // this could be nonexistant + if ((sw <= 0) || (sh <= 0)) return; + + setImpl(x, y, sx, sy, sw, sh, src); + } + + + /** + * Internal function to actually handle setting a block of pixels that + * has already been properly cropped from the image to a valid region. + */ + protected void setImpl(int dx, int dy, int sx, int sy, int sw, int sh, + PImage src) { + int srcOffset = sy * src.width + sx; + int dstOffset = dy * width + dx; + + for (int y = sy; y < sy + sh; y++) { + System.arraycopy(src.pixels, srcOffset, pixels, dstOffset, sw); + srcOffset += src.width; + dstOffset += width; + } + updatePixelsImpl(sx, sy, sx+sw, sy+sh); + } + + + + ////////////////////////////////////////////////////////////// + + // ALPHA CHANNEL + + + /** + * Set alpha channel for an image. Black colors in the source + * image will make the destination image completely transparent, + * and white will make things fully opaque. Gray values will + * be in-between steps. + *

+ * Strictly speaking the "blue" value from the source image is + * used as the alpha color. For a fully grayscale image, this + * is correct, but for a color image it's not 100% accurate. + * For a more accurate conversion, first use filter(GRAY) + * which will make the image into a "correct" grayscale by + * performing a proper luminance-based conversion. + * + * @param maskArray any array of Integer numbers used as the alpha channel, needs to be same length as the image's pixel array + */ + public void mask(int maskArray[]) { + loadPixels(); + // don't execute if mask image is different size + if (maskArray.length != pixels.length) { + throw new RuntimeException("The PImage used with mask() must be " + + "the same size as the applet."); + } + for (int i = 0; i < pixels.length; i++) { + pixels[i] = ((maskArray[i] & 0xff) << 24) | (pixels[i] & 0xffffff); + } + format = ARGB; + updatePixels(); + } + + + /** + * Masks part of an image from displaying by loading another image and 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 same length as the target image's pixels array and should contain only grayscale data of values between 0-255. + * @webref + * @brief Masks part of the image from displaying + * @param maskImg any PImage object used as the alpha channel for "img", needs to be same size as "img" + */ + public void mask(PImage maskImg) { + mask(maskImg.pixels); + } + + + + ////////////////////////////////////////////////////////////// + + // IMAGE FILTERS + public void filter(int kind) { + loadPixels(); + + switch (kind) { + case BLUR: + // TODO write basic low-pass filter blur here + // what does photoshop do on the edges with this guy? + // better yet.. why bother? just use gaussian with radius 1 + filter(BLUR, 1); + break; + + case GRAY: + if (format == ALPHA) { + // for an alpha image, convert it to an opaque grayscale + for (int i = 0; i < pixels.length; i++) { + int col = 255 - pixels[i]; + pixels[i] = 0xff000000 | (col << 16) | (col << 8) | col; + } + format = RGB; + + } else { + // Converts RGB image data into grayscale using + // weighted RGB components, and keeps alpha channel intact. + // [toxi 040115] + for (int i = 0; i < pixels.length; i++) { + int col = pixels[i]; + // luminance = 0.3*red + 0.59*green + 0.11*blue + // 0.30 * 256 = 77 + // 0.59 * 256 = 151 + // 0.11 * 256 = 28 + int lum = (77*(col>>16&0xff) + 151*(col>>8&0xff) + 28*(col&0xff))>>8; + pixels[i] = (col & ALPHA_MASK) | lum<<16 | lum<<8 | lum; + } + } + break; + + case INVERT: + for (int i = 0; i < pixels.length; i++) { + //pixels[i] = 0xff000000 | + pixels[i] ^= 0xffffff; + } + break; + + case POSTERIZE: + throw new RuntimeException("Use filter(POSTERIZE, int levels) " + + "instead of filter(POSTERIZE)"); + + case OPAQUE: + for (int i = 0; i < pixels.length; i++) { + pixels[i] |= 0xff000000; + } + format = RGB; + break; + + case THRESHOLD: + filter(THRESHOLD, 0.5f); + break; + + // [toxi20050728] added new filters + case ERODE: + dilate(true); + break; + + case DILATE: + dilate(false); + break; + } + updatePixels(); // mark as modified + } + + + /** + * Filters an image as defined by one of the following modes:

THRESHOLD - converts the image to black and white pixels depending if 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 + * =advanced + * Method to apply a variety of basic filters to this image. + *

+ *

    + *
  • filter(BLUR) provides a basic blur. + *
  • filter(GRAY) converts the image to grayscale based on luminance. + *
  • filter(INVERT) will invert the color components in the image. + *
  • filter(OPAQUE) set all the high bits in the image to opaque + *
  • filter(THRESHOLD) converts the image to black and white. + *
  • filter(DILATE) grow white/light areas + *
  • filter(ERODE) shrink white/light areas + *
+ * Luminance conversion code contributed by + * toxi + *

+ * Gaussian blur code contributed by + * Mario Klingemann + * + * @webref + * @brief Converts the image to grayscale or black and white + * @param kind Either THRESHOLD, GRAY, INVERT, POSTERIZE, BLUR, OPAQUE, ERODE, or DILATE + * @param param in the range from 0 to 1 + */ + public void filter(int kind, float param) { + loadPixels(); + + switch (kind) { + case BLUR: + if (format == ALPHA) + blurAlpha(param); + else if (format == ARGB) + blurARGB(param); + else + blurRGB(param); + break; + + case GRAY: + throw new RuntimeException("Use filter(GRAY) instead of " + + "filter(GRAY, param)"); + + case INVERT: + throw new RuntimeException("Use filter(INVERT) instead of " + + "filter(INVERT, param)"); + + case OPAQUE: + throw new RuntimeException("Use filter(OPAQUE) instead of " + + "filter(OPAQUE, param)"); + + case POSTERIZE: + int levels = (int)param; + if ((levels < 2) || (levels > 255)) { + throw new RuntimeException("Levels must be between 2 and 255 for " + + "filter(POSTERIZE, levels)"); + } + int levels1 = levels - 1; + for (int i = 0; i < pixels.length; i++) { + int rlevel = (pixels[i] >> 16) & 0xff; + int glevel = (pixels[i] >> 8) & 0xff; + int blevel = pixels[i] & 0xff; + rlevel = (((rlevel * levels) >> 8) * 255) / levels1; + glevel = (((glevel * levels) >> 8) * 255) / levels1; + blevel = (((blevel * levels) >> 8) * 255) / levels1; + pixels[i] = ((0xff000000 & pixels[i]) | + (rlevel << 16) | + (glevel << 8) | + blevel); + } + break; + + case THRESHOLD: // greater than or equal to the threshold + int thresh = (int) (param * 255); + for (int i = 0; i < pixels.length; i++) { + int max = Math.max((pixels[i] & RED_MASK) >> 16, + Math.max((pixels[i] & GREEN_MASK) >> 8, + (pixels[i] & BLUE_MASK))); + pixels[i] = (pixels[i] & ALPHA_MASK) | + ((max < thresh) ? 0x000000 : 0xffffff); + } + break; + + // [toxi20050728] added new filters + case ERODE: + throw new RuntimeException("Use filter(ERODE) instead of " + + "filter(ERODE, param)"); + case DILATE: + throw new RuntimeException("Use filter(DILATE) instead of " + + "filter(DILATE, param)"); + } + updatePixels(); // mark as modified + } + + + /** + * Optimized code for building the blur kernel. + * further optimized blur code (approx. 15% for radius=20) + * bigger speed gains for larger radii (~30%) + * added support for various image types (ALPHA, RGB, ARGB) + * [toxi 050728] + */ + protected void buildBlurKernel(float r) { + int radius = (int) (r * 3.5f); + radius = (radius < 1) ? 1 : ((radius < 248) ? radius : 248); + if (blurRadius != radius) { + blurRadius = radius; + blurKernelSize = 1 + blurRadius<<1; + blurKernel = new int[blurKernelSize]; + blurMult = new int[blurKernelSize][256]; + + int bk,bki; + int[] bm,bmi; + + for (int i = 1, radiusi = radius - 1; i < radius; i++) { + blurKernel[radius+i] = blurKernel[radiusi] = bki = radiusi * radiusi; + bm=blurMult[radius+i]; + bmi=blurMult[radiusi--]; + for (int j = 0; j < 256; j++) + bm[j] = bmi[j] = bki*j; + } + bk = blurKernel[radius] = radius * radius; + bm = blurMult[radius]; + for (int j = 0; j < 256; j++) + bm[j] = bk*j; + } + } + + + protected void blurAlpha(float r) { + int sum, cb; + int read, ri, ym, ymi, bk0; + int b2[] = new int[pixels.length]; + int yi = 0; + + buildBlurKernel(r); + + for (int y = 0; y < height; y++) { + for (int x = 0; x < width; x++) { + //cb = cg = cr = sum = 0; + cb = sum = 0; + read = x - blurRadius; + if (read<0) { + bk0=-read; + read=0; + } else { + if (read >= width) + break; + bk0=0; + } + for (int i = bk0; i < blurKernelSize; i++) { + if (read >= width) + break; + int c = pixels[read + yi]; + int[] bm=blurMult[i]; + cb += bm[c & BLUE_MASK]; + sum += blurKernel[i]; + read++; + } + ri = yi + x; + b2[ri] = cb / sum; + } + yi += width; + } + + yi = 0; + ym=-blurRadius; + ymi=ym*width; + + for (int y = 0; y < height; y++) { + for (int x = 0; x < width; x++) { + //cb = cg = cr = sum = 0; + cb = sum = 0; + if (ym<0) { + bk0 = ri = -ym; + read = x; + } else { + if (ym >= height) + break; + bk0 = 0; + ri = ym; + read = x + ymi; + } + for (int i = bk0; i < blurKernelSize; i++) { + if (ri >= height) + break; + int[] bm=blurMult[i]; + cb += bm[b2[read]]; + sum += blurKernel[i]; + ri++; + read += width; + } + pixels[x+yi] = (cb/sum); + } + yi += width; + ymi += width; + ym++; + } + } + + + protected void blurRGB(float r) { + int sum, cr, cg, cb; //, k; + int /*pixel,*/ read, ri, /*roff,*/ ym, ymi, /*riw,*/ bk0; + int r2[] = new int[pixels.length]; + int g2[] = new int[pixels.length]; + int b2[] = new int[pixels.length]; + int yi = 0; + + buildBlurKernel(r); + + for (int y = 0; y < height; y++) { + for (int x = 0; x < width; x++) { + cb = cg = cr = sum = 0; + read = x - blurRadius; + if (read<0) { + bk0=-read; + read=0; + } else { + if (read >= width) + break; + bk0=0; + } + for (int i = bk0; i < blurKernelSize; i++) { + if (read >= width) + break; + int c = pixels[read + yi]; + int[] bm=blurMult[i]; + cr += bm[(c & RED_MASK) >> 16]; + cg += bm[(c & GREEN_MASK) >> 8]; + cb += bm[c & BLUE_MASK]; + sum += blurKernel[i]; + read++; + } + ri = yi + x; + r2[ri] = cr / sum; + g2[ri] = cg / sum; + b2[ri] = cb / sum; + } + yi += width; + } + + yi = 0; + ym=-blurRadius; + ymi=ym*width; + + for (int y = 0; y < height; y++) { + for (int x = 0; x < width; x++) { + cb = cg = cr = sum = 0; + if (ym<0) { + bk0 = ri = -ym; + read = x; + } else { + if (ym >= height) + break; + bk0 = 0; + ri = ym; + read = x + ymi; + } + for (int i = bk0; i < blurKernelSize; i++) { + if (ri >= height) + break; + int[] bm=blurMult[i]; + cr += bm[r2[read]]; + cg += bm[g2[read]]; + cb += bm[b2[read]]; + sum += blurKernel[i]; + ri++; + read += width; + } + pixels[x+yi] = 0xff000000 | (cr/sum)<<16 | (cg/sum)<<8 | (cb/sum); + } + yi += width; + ymi += width; + ym++; + } + } + + + protected void blurARGB(float r) { + int sum, cr, cg, cb, ca; + int /*pixel,*/ read, ri, /*roff,*/ ym, ymi, /*riw,*/ bk0; + int wh = pixels.length; + int r2[] = new int[wh]; + int g2[] = new int[wh]; + int b2[] = new int[wh]; + int a2[] = new int[wh]; + int yi = 0; + + buildBlurKernel(r); + + for (int y = 0; y < height; y++) { + for (int x = 0; x < width; x++) { + cb = cg = cr = ca = sum = 0; + read = x - blurRadius; + if (read<0) { + bk0=-read; + read=0; + } else { + if (read >= width) + break; + bk0=0; + } + for (int i = bk0; i < blurKernelSize; i++) { + if (read >= width) + break; + int c = pixels[read + yi]; + int[] bm=blurMult[i]; + ca += bm[(c & ALPHA_MASK) >>> 24]; + cr += bm[(c & RED_MASK) >> 16]; + cg += bm[(c & GREEN_MASK) >> 8]; + cb += bm[c & BLUE_MASK]; + sum += blurKernel[i]; + read++; + } + ri = yi + x; + a2[ri] = ca / sum; + r2[ri] = cr / sum; + g2[ri] = cg / sum; + b2[ri] = cb / sum; + } + yi += width; + } + + yi = 0; + ym=-blurRadius; + ymi=ym*width; + + for (int y = 0; y < height; y++) { + for (int x = 0; x < width; x++) { + cb = cg = cr = ca = sum = 0; + if (ym<0) { + bk0 = ri = -ym; + read = x; + } else { + if (ym >= height) + break; + bk0 = 0; + ri = ym; + read = x + ymi; + } + for (int i = bk0; i < blurKernelSize; i++) { + if (ri >= height) + break; + int[] bm=blurMult[i]; + ca += bm[a2[read]]; + cr += bm[r2[read]]; + cg += bm[g2[read]]; + cb += bm[b2[read]]; + sum += blurKernel[i]; + ri++; + read += width; + } + pixels[x+yi] = (ca/sum)<<24 | (cr/sum)<<16 | (cg/sum)<<8 | (cb/sum); + } + yi += width; + ymi += width; + ym++; + } + } + + + /** + * Generic dilate/erode filter using luminance values + * as decision factor. [toxi 050728] + */ + protected void dilate(boolean isInverted) { + int currIdx=0; + int maxIdx=pixels.length; + int[] out=new int[maxIdx]; + + if (!isInverted) { + // erosion (grow light areas) + while (currIdx=maxRowIdx) + idxRight=currIdx; + if (idxUp<0) + idxUp=0; + if (idxDown>=maxIdx) + idxDown=currIdx; + + int colUp=pixels[idxUp]; + int colLeft=pixels[idxLeft]; + int colDown=pixels[idxDown]; + int colRight=pixels[idxRight]; + + // compute luminance + int currLum = + 77*(colOrig>>16&0xff) + 151*(colOrig>>8&0xff) + 28*(colOrig&0xff); + int lumLeft = + 77*(colLeft>>16&0xff) + 151*(colLeft>>8&0xff) + 28*(colLeft&0xff); + int lumRight = + 77*(colRight>>16&0xff) + 151*(colRight>>8&0xff) + 28*(colRight&0xff); + int lumUp = + 77*(colUp>>16&0xff) + 151*(colUp>>8&0xff) + 28*(colUp&0xff); + int lumDown = + 77*(colDown>>16&0xff) + 151*(colDown>>8&0xff) + 28*(colDown&0xff); + + if (lumLeft>currLum) { + colOut=colLeft; + currLum=lumLeft; + } + if (lumRight>currLum) { + colOut=colRight; + currLum=lumRight; + } + if (lumUp>currLum) { + colOut=colUp; + currLum=lumUp; + } + if (lumDown>currLum) { + colOut=colDown; + currLum=lumDown; + } + out[currIdx++]=colOut; + } + } + } else { + // dilate (grow dark areas) + while (currIdx=maxRowIdx) + idxRight=currIdx; + if (idxUp<0) + idxUp=0; + if (idxDown>=maxIdx) + idxDown=currIdx; + + int colUp=pixels[idxUp]; + int colLeft=pixels[idxLeft]; + int colDown=pixels[idxDown]; + int colRight=pixels[idxRight]; + + // compute luminance + int currLum = + 77*(colOrig>>16&0xff) + 151*(colOrig>>8&0xff) + 28*(colOrig&0xff); + int lumLeft = + 77*(colLeft>>16&0xff) + 151*(colLeft>>8&0xff) + 28*(colLeft&0xff); + int lumRight = + 77*(colRight>>16&0xff) + 151*(colRight>>8&0xff) + 28*(colRight&0xff); + int lumUp = + 77*(colUp>>16&0xff) + 151*(colUp>>8&0xff) + 28*(colUp&0xff); + int lumDown = + 77*(colDown>>16&0xff) + 151*(colDown>>8&0xff) + 28*(colDown&0xff); + + if (lumLeft
As of release 0149, this function ignores imageMode(). + * + * @webref + * @brief Copies the entire image + * @param sx X coordinate of the source's upper left corner + * @param sy Y coordinate of the source's upper left corner + * @param sw source image width + * @param sh source image height + * @param dx X coordinate of the destination's upper left corner + * @param dy Y coordinate of the destination's upper left corner + * @param dw destination image width + * @param dh destination image height + * @param src an image variable referring to the source image. + * + * @see processing.core.PApplet#alpha(int) + * @see processing.core.PApplet#blend(PImage, int, int, int, int, int, int, int, int, int) + */ + public void copy(PImage src, + int sx, int sy, int sw, int sh, + int dx, int dy, int dw, int dh) { + blend(src, sx, sy, sw, sh, dx, dy, dw, dh, REPLACE); + } + + + + ////////////////////////////////////////////////////////////// + + // BLEND + + + /** + * Blend two colors based on a particular mode. + *

    + *
  • REPLACE - destination colour equals colour of source pixel: C = A. + * Sometimes called "Normal" or "Copy" in other software. + * + *
  • BLEND - linear interpolation of colours: + * C = A*factor + B + * + *
  • ADD - additive blending with white clip: + * C = min(A*factor + B, 255). + * Clipped to 0..255, Photoshop calls this "Linear Burn", + * and Director calls it "Add Pin". + * + *
  • SUBTRACT - substractive blend with black clip: + * C = max(B - A*factor, 0). + * Clipped to 0..255, Photoshop calls this "Linear Dodge", + * and Director calls it "Subtract Pin". + * + *
  • DARKEST - only the darkest colour succeeds: + * C = min(A*factor, B). + * Illustrator calls this "Darken". + * + *
  • LIGHTEST - only the lightest colour succeeds: + * C = max(A*factor, B). + * Illustrator calls this "Lighten". + * + *
  • 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. + *
+ *

A useful reference for blending modes and their algorithms can be + * found in the SVG + * specification.

+ *

It is important to note that Processing uses "fast" code, not + * necessarily "correct" code. No biggie, most software does. A nitpicker + * can find numerous "off by 1 division" problems in the blend code where + * >>8 or >>7 is used when strictly speaking + * /255.0 or /127.0 should have been used.

+ *

For instance, exclusion (not intended for real-time use) reads + * r1 + r2 - ((2 * r1 * r2) / 255) because 255 == 1.0 + * not 256 == 1.0. In other words, (255*255)>>8 is not + * the same as (255*255)/255. But for real-time use the shifts + * are preferrable, and the difference is insignificant for applications + * built with Processing.

+ */ + static public int blendColor(int c1, int c2, int mode) { + switch (mode) { + case REPLACE: return c2; + case BLEND: return blend_blend(c1, c2); + + case ADD: return blend_add_pin(c1, c2); + case SUBTRACT: return blend_sub_pin(c1, c2); + + case LIGHTEST: return blend_lightest(c1, c2); + case DARKEST: return blend_darkest(c1, c2); + + case DIFFERENCE: return blend_difference(c1, c2); + case EXCLUSION: return blend_exclusion(c1, c2); + + case MULTIPLY: return blend_multiply(c1, c2); + case SCREEN: return blend_screen(c1, c2); + + case HARD_LIGHT: return blend_hard_light(c1, c2); + case SOFT_LIGHT: return blend_soft_light(c1, c2); + case OVERLAY: return blend_overlay(c1, c2); + + case DODGE: return blend_dodge(c1, c2); + case BURN: return blend_burn(c1, c2); + } + return 0; + } + + + /** + * Blends one area of this image to another area. + * + * + * @see processing.core.PImage#blendColor(int,int,int) + */ + public void blend(int sx, int sy, int sw, int sh, + int dx, int dy, int dw, int dh, int mode) { + blend(this, sx, sy, sw, sh, dx, dy, dw, dh, mode); + } + + + /** + * Blends a region of pixels into the image specified by the img 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 srcImg parameter is not used, the display window is used as the source image.

+ * As of release 0149, this function ignores imageMode(). + * + * @webref + * @brief Copies a pixel or rectangle of pixels using different blending modes + * @param src an image variable referring to the source image + * @param sx X coordinate of the source's upper left corner + * @param sy Y coordinate of the source's upper left corner + * @param sw source image width + * @param sh source image height + * @param dx X coordinate of the destinations's upper left corner + * @param dy Y coordinate of the destinations's upper left corner + * @param dw destination image width + * @param dh destination image height + * @param mode Either BLEND, ADD, SUBTRACT, LIGHTEST, DARKEST, DIFFERENCE, EXCLUSION, MULTIPLY, SCREEN, OVERLAY, HARD_LIGHT, SOFT_LIGHT, DODGE, BURN + * + * @see processing.core.PApplet#alpha(int) + * @see processing.core.PApplet#copy(PImage, int, int, int, int, int, int, int, int) + * @see processing.core.PImage#blendColor(int,int,int) + */ + public void blend(PImage src, + int sx, int sy, int sw, int sh, + int dx, int dy, int dw, int dh, int mode) { + /* + if (imageMode == CORNER) { // if CORNERS, do nothing + sx2 += sx1; + sy2 += sy1; + dx2 += dx1; + dy2 += dy1; + + } else if (imageMode == CENTER) { + sx1 -= sx2 / 2f; + sy1 -= sy2 / 2f; + sx2 += sx1; + sy2 += sy1; + dx1 -= dx2 / 2f; + dy1 -= dy2 / 2f; + dx2 += dx1; + dy2 += dy1; + } + */ + int sx2 = sx + sw; + int sy2 = sy + sh; + int dx2 = dx + dw; + int dy2 = dy + dh; + + loadPixels(); + if (src == this) { + if (intersect(sx, sy, sx2, sy2, dx, dy, dx2, dy2)) { + blit_resize(get(sx, sy, sx2 - sx, sy2 - sy), + 0, 0, sx2 - sx - 1, sy2 - sy - 1, + pixels, width, height, dx, dy, dx2, dy2, mode); + } else { + // same as below, except skip the loadPixels() because it'd be redundant + blit_resize(src, sx, sy, sx2, sy2, + pixels, width, height, dx, dy, dx2, dy2, mode); + } + } else { + src.loadPixels(); + blit_resize(src, sx, sy, sx2, sy2, + pixels, width, height, dx, dy, dx2, dy2, mode); + //src.updatePixels(); + } + updatePixels(); + } + + + /** + * Check to see if two rectangles intersect one another + */ + private boolean intersect(int sx1, int sy1, int sx2, int sy2, + int dx1, int dy1, int dx2, int dy2) { + int sw = sx2 - sx1 + 1; + int sh = sy2 - sy1 + 1; + int dw = dx2 - dx1 + 1; + int dh = dy2 - dy1 + 1; + + if (dx1 < sx1) { + dw += dx1 - sx1; + if (dw > sw) { + dw = sw; + } + } else { + int w = sw + sx1 - dx1; + if (dw > w) { + dw = w; + } + } + if (dy1 < sy1) { + dh += dy1 - sy1; + if (dh > sh) { + dh = sh; + } + } else { + int h = sh + sy1 - dy1; + if (dh > h) { + dh = h; + } + } + return !(dw <= 0 || dh <= 0); + } + + + ////////////////////////////////////////////////////////////// + + + /** + * Internal blitter/resizer/copier from toxi. + * Uses bilinear filtering if smooth() has been enabled + * 'mode' determines the blending mode used in the process. + */ + private void blit_resize(PImage img, + int srcX1, int srcY1, int srcX2, int srcY2, + int[] destPixels, int screenW, int screenH, + int destX1, int destY1, int destX2, int destY2, + int mode) { + if (srcX1 < 0) srcX1 = 0; + if (srcY1 < 0) srcY1 = 0; + if (srcX2 >= img.width) srcX2 = img.width - 1; + if (srcY2 >= img.height) srcY2 = img.height - 1; + + int srcW = srcX2 - srcX1; + int srcH = srcY2 - srcY1; + int destW = destX2 - destX1; + int destH = destY2 - destY1; + + boolean smooth = true; // may as well go with the smoothing these days + + if (!smooth) { + srcW++; srcH++; + } + + if (destW <= 0 || destH <= 0 || + srcW <= 0 || srcH <= 0 || + destX1 >= screenW || destY1 >= screenH || + srcX1 >= img.width || srcY1 >= img.height) { + return; + } + + int dx = (int) (srcW / (float) destW * PRECISIONF); + int dy = (int) (srcH / (float) destH * PRECISIONF); + + srcXOffset = (int) (destX1 < 0 ? -destX1 * dx : srcX1 * PRECISIONF); + srcYOffset = (int) (destY1 < 0 ? -destY1 * dy : srcY1 * PRECISIONF); + + if (destX1 < 0) { + destW += destX1; + destX1 = 0; + } + if (destY1 < 0) { + destH += destY1; + destY1 = 0; + } + + destW = low(destW, screenW - destX1); + destH = low(destH, screenH - destY1); + + int destOffset = destY1 * screenW + destX1; + srcBuffer = img.pixels; + + if (smooth) { + // use bilinear filtering + iw = img.width; + iw1 = img.width - 1; + ih1 = img.height - 1; + + switch (mode) { + + case BLEND: + for (int y = 0; y < destH; y++) { + filter_new_scanline(); + for (int x = 0; x < destW; x++) { + // davbol - renamed old blend_multiply to blend_blend + destPixels[destOffset + x] = + blend_blend(destPixels[destOffset + x], filter_bilinear()); + sX += dx; + } + destOffset += screenW; + srcYOffset += dy; + } + break; + + case ADD: + for (int y = 0; y < destH; y++) { + filter_new_scanline(); + for (int x = 0; x < destW; x++) { + destPixels[destOffset + x] = + blend_add_pin(destPixels[destOffset + x], filter_bilinear()); + sX += dx; + } + destOffset += screenW; + srcYOffset += dy; + } + break; + + case SUBTRACT: + for (int y = 0; y < destH; y++) { + filter_new_scanline(); + for (int x = 0; x < destW; x++) { + destPixels[destOffset + x] = + blend_sub_pin(destPixels[destOffset + x], filter_bilinear()); + sX += dx; + } + destOffset += screenW; + srcYOffset += dy; + } + break; + + case LIGHTEST: + for (int y = 0; y < destH; y++) { + filter_new_scanline(); + for (int x = 0; x < destW; x++) { + destPixels[destOffset + x] = + blend_lightest(destPixels[destOffset + x], filter_bilinear()); + sX += dx; + } + destOffset += screenW; + srcYOffset += dy; + } + break; + + case DARKEST: + for (int y = 0; y < destH; y++) { + filter_new_scanline(); + for (int x = 0; x < destW; x++) { + destPixels[destOffset + x] = + blend_darkest(destPixels[destOffset + x], filter_bilinear()); + sX += dx; + } + destOffset += screenW; + srcYOffset += dy; + } + break; + + case REPLACE: + for (int y = 0; y < destH; y++) { + filter_new_scanline(); + for (int x = 0; x < destW; x++) { + destPixels[destOffset + x] = filter_bilinear(); + sX += dx; + } + destOffset += screenW; + srcYOffset += dy; + } + break; + + case DIFFERENCE: + for (int y = 0; y < destH; y++) { + filter_new_scanline(); + for (int x = 0; x < destW; x++) { + destPixels[destOffset + x] = + blend_difference(destPixels[destOffset + x], filter_bilinear()); + sX += dx; + } + destOffset += screenW; + srcYOffset += dy; + } + break; + + case EXCLUSION: + for (int y = 0; y < destH; y++) { + filter_new_scanline(); + for (int x = 0; x < destW; x++) { + destPixels[destOffset + x] = + blend_exclusion(destPixels[destOffset + x], filter_bilinear()); + sX += dx; + } + destOffset += screenW; + srcYOffset += dy; + } + break; + + case MULTIPLY: + for (int y = 0; y < destH; y++) { + filter_new_scanline(); + for (int x = 0; x < destW; x++) { + destPixels[destOffset + x] = + blend_multiply(destPixels[destOffset + x], filter_bilinear()); + sX += dx; + } + destOffset += screenW; + srcYOffset += dy; + } + break; + + case SCREEN: + for (int y = 0; y < destH; y++) { + filter_new_scanline(); + for (int x = 0; x < destW; x++) { + destPixels[destOffset + x] = + blend_screen(destPixels[destOffset + x], filter_bilinear()); + sX += dx; + } + destOffset += screenW; + srcYOffset += dy; + } + break; + + case OVERLAY: + for (int y = 0; y < destH; y++) { + filter_new_scanline(); + for (int x = 0; x < destW; x++) { + destPixels[destOffset + x] = + blend_overlay(destPixels[destOffset + x], filter_bilinear()); + sX += dx; + } + destOffset += screenW; + srcYOffset += dy; + } + break; + + case HARD_LIGHT: + for (int y = 0; y < destH; y++) { + filter_new_scanline(); + for (int x = 0; x < destW; x++) { + destPixels[destOffset + x] = + blend_hard_light(destPixels[destOffset + x], filter_bilinear()); + sX += dx; + } + destOffset += screenW; + srcYOffset += dy; + } + break; + + case SOFT_LIGHT: + for (int y = 0; y < destH; y++) { + filter_new_scanline(); + for (int x = 0; x < destW; x++) { + destPixels[destOffset + x] = + blend_soft_light(destPixels[destOffset + x], filter_bilinear()); + sX += dx; + } + destOffset += screenW; + srcYOffset += dy; + } + break; + + // davbol - proposed 2007-01-09 + case DODGE: + for (int y = 0; y < destH; y++) { + filter_new_scanline(); + for (int x = 0; x < destW; x++) { + destPixels[destOffset + x] = + blend_dodge(destPixels[destOffset + x], filter_bilinear()); + sX += dx; + } + destOffset += screenW; + srcYOffset += dy; + } + break; + + case BURN: + for (int y = 0; y < destH; y++) { + filter_new_scanline(); + for (int x = 0; x < destW; x++) { + destPixels[destOffset + x] = + blend_burn(destPixels[destOffset + x], filter_bilinear()); + sX += dx; + } + destOffset += screenW; + srcYOffset += dy; + } + break; + + } + + } else { + // nearest neighbour scaling (++fast!) + switch (mode) { + + case BLEND: + for (int y = 0; y < destH; y++) { + sX = srcXOffset; + sY = (srcYOffset >> PRECISIONB) * img.width; + for (int x = 0; x < destW; x++) { + // davbol - renamed old blend_multiply to blend_blend + destPixels[destOffset + x] = + blend_blend(destPixels[destOffset + x], + srcBuffer[sY + (sX >> PRECISIONB)]); + sX += dx; + } + destOffset += screenW; + srcYOffset += dy; + } + break; + + case ADD: + for (int y = 0; y < destH; y++) { + sX = srcXOffset; + sY = (srcYOffset >> PRECISIONB) * img.width; + for (int x = 0; x < destW; x++) { + destPixels[destOffset + x] = + blend_add_pin(destPixels[destOffset + x], + srcBuffer[sY + (sX >> PRECISIONB)]); + sX += dx; + } + destOffset += screenW; + srcYOffset += dy; + } + break; + + case SUBTRACT: + for (int y = 0; y < destH; y++) { + sX = srcXOffset; + sY = (srcYOffset >> PRECISIONB) * img.width; + for (int x = 0; x < destW; x++) { + destPixels[destOffset + x] = + blend_sub_pin(destPixels[destOffset + x], + srcBuffer[sY + (sX >> PRECISIONB)]); + sX += dx; + } + destOffset += screenW; + srcYOffset += dy; + } + break; + + case LIGHTEST: + for (int y = 0; y < destH; y++) { + sX = srcXOffset; + sY = (srcYOffset >> PRECISIONB) * img.width; + for (int x = 0; x < destW; x++) { + destPixels[destOffset + x] = + blend_lightest(destPixels[destOffset + x], + srcBuffer[sY + (sX >> PRECISIONB)]); + sX += dx; + } + destOffset += screenW; + srcYOffset += dy; + } + break; + + case DARKEST: + for (int y = 0; y < destH; y++) { + sX = srcXOffset; + sY = (srcYOffset >> PRECISIONB) * img.width; + for (int x = 0; x < destW; x++) { + destPixels[destOffset + x] = + blend_darkest(destPixels[destOffset + x], + srcBuffer[sY + (sX >> PRECISIONB)]); + sX += dx; + } + destOffset += screenW; + srcYOffset += dy; + } + break; + + case REPLACE: + for (int y = 0; y < destH; y++) { + sX = srcXOffset; + sY = (srcYOffset >> PRECISIONB) * img.width; + for (int x = 0; x < destW; x++) { + destPixels[destOffset + x] = srcBuffer[sY + (sX >> PRECISIONB)]; + sX += dx; + } + destOffset += screenW; + srcYOffset += dy; + } + break; + + case DIFFERENCE: + for (int y = 0; y < destH; y++) { + sX = srcXOffset; + sY = (srcYOffset >> PRECISIONB) * img.width; + for (int x = 0; x < destW; x++) { + destPixels[destOffset + x] = + blend_difference(destPixels[destOffset + x], + srcBuffer[sY + (sX >> PRECISIONB)]); + sX += dx; + } + destOffset += screenW; + srcYOffset += dy; + } + break; + + case EXCLUSION: + for (int y = 0; y < destH; y++) { + sX = srcXOffset; + sY = (srcYOffset >> PRECISIONB) * img.width; + for (int x = 0; x < destW; x++) { + destPixels[destOffset + x] = + blend_exclusion(destPixels[destOffset + x], + srcBuffer[sY + (sX >> PRECISIONB)]); + sX += dx; + } + destOffset += screenW; + srcYOffset += dy; + } + break; + + case MULTIPLY: + for (int y = 0; y < destH; y++) { + sX = srcXOffset; + sY = (srcYOffset >> PRECISIONB) * img.width; + for (int x = 0; x < destW; x++) { + destPixels[destOffset + x] = + blend_multiply(destPixels[destOffset + x], + srcBuffer[sY + (sX >> PRECISIONB)]); + sX += dx; + } + destOffset += screenW; + srcYOffset += dy; + } + break; + + case SCREEN: + for (int y = 0; y < destH; y++) { + sX = srcXOffset; + sY = (srcYOffset >> PRECISIONB) * img.width; + for (int x = 0; x < destW; x++) { + destPixels[destOffset + x] = + blend_screen(destPixels[destOffset + x], + srcBuffer[sY + (sX >> PRECISIONB)]); + sX += dx; + } + destOffset += screenW; + srcYOffset += dy; + } + break; + + case OVERLAY: + for (int y = 0; y < destH; y++) { + sX = srcXOffset; + sY = (srcYOffset >> PRECISIONB) * img.width; + for (int x = 0; x < destW; x++) { + destPixels[destOffset + x] = + blend_overlay(destPixels[destOffset + x], + srcBuffer[sY + (sX >> PRECISIONB)]); + sX += dx; + } + destOffset += screenW; + srcYOffset += dy; + } + break; + + case HARD_LIGHT: + for (int y = 0; y < destH; y++) { + sX = srcXOffset; + sY = (srcYOffset >> PRECISIONB) * img.width; + for (int x = 0; x < destW; x++) { + destPixels[destOffset + x] = + blend_hard_light(destPixels[destOffset + x], + srcBuffer[sY + (sX >> PRECISIONB)]); + sX += dx; + } + destOffset += screenW; + srcYOffset += dy; + } + break; + + case SOFT_LIGHT: + for (int y = 0; y < destH; y++) { + sX = srcXOffset; + sY = (srcYOffset >> PRECISIONB) * img.width; + for (int x = 0; x < destW; x++) { + destPixels[destOffset + x] = + blend_soft_light(destPixels[destOffset + x], + srcBuffer[sY + (sX >> PRECISIONB)]); + sX += dx; + } + destOffset += screenW; + srcYOffset += dy; + } + break; + + // davbol - proposed 2007-01-09 + case DODGE: + for (int y = 0; y < destH; y++) { + sX = srcXOffset; + sY = (srcYOffset >> PRECISIONB) * img.width; + for (int x = 0; x < destW; x++) { + destPixels[destOffset + x] = + blend_dodge(destPixels[destOffset + x], + srcBuffer[sY + (sX >> PRECISIONB)]); + sX += dx; + } + destOffset += screenW; + srcYOffset += dy; + } + break; + + case BURN: + for (int y = 0; y < destH; y++) { + sX = srcXOffset; + sY = (srcYOffset >> PRECISIONB) * img.width; + for (int x = 0; x < destW; x++) { + destPixels[destOffset + x] = + blend_burn(destPixels[destOffset + x], + srcBuffer[sY + (sX >> PRECISIONB)]); + sX += dx; + } + destOffset += screenW; + srcYOffset += dy; + } + break; + + } + } + } + + + private void filter_new_scanline() { + sX = srcXOffset; + fracV = srcYOffset & PREC_MAXVAL; + ifV = PREC_MAXVAL - fracV; + v1 = (srcYOffset >> PRECISIONB) * iw; + v2 = low((srcYOffset >> PRECISIONB) + 1, ih1) * iw; + } + + + private int filter_bilinear() { + fracU = sX & PREC_MAXVAL; + ifU = PREC_MAXVAL - fracU; + ul = (ifU * ifV) >> PRECISIONB; + ll = (ifU * fracV) >> PRECISIONB; + ur = (fracU * ifV) >> PRECISIONB; + lr = (fracU * fracV) >> PRECISIONB; + u1 = (sX >> PRECISIONB); + u2 = low(u1 + 1, iw1); + + // get color values of the 4 neighbouring texels + cUL = srcBuffer[v1 + u1]; + cUR = srcBuffer[v1 + u2]; + cLL = srcBuffer[v2 + u1]; + cLR = srcBuffer[v2 + u2]; + + r = ((ul*((cUL&RED_MASK)>>16) + ll*((cLL&RED_MASK)>>16) + + ur*((cUR&RED_MASK)>>16) + lr*((cLR&RED_MASK)>>16)) + << PREC_RED_SHIFT) & RED_MASK; + + g = ((ul*(cUL&GREEN_MASK) + ll*(cLL&GREEN_MASK) + + ur*(cUR&GREEN_MASK) + lr*(cLR&GREEN_MASK)) + >>> PRECISIONB) & GREEN_MASK; + + b = (ul*(cUL&BLUE_MASK) + ll*(cLL&BLUE_MASK) + + ur*(cUR&BLUE_MASK) + lr*(cLR&BLUE_MASK)) + >>> PRECISIONB; + + a = ((ul*((cUL&ALPHA_MASK)>>>24) + ll*((cLL&ALPHA_MASK)>>>24) + + ur*((cUR&ALPHA_MASK)>>>24) + lr*((cLR&ALPHA_MASK)>>>24)) + << PREC_ALPHA_SHIFT) & ALPHA_MASK; + + return a | r | g | b; + } + + + + ////////////////////////////////////////////////////////////// + + // internal blending methods + + + private static int low(int a, int b) { + return (a < b) ? a : b; + } + + + private static int high(int a, int b) { + return (a > b) ? a : b; + } + + // davbol - added peg helper, equiv to constrain(n,0,255) + private static int peg(int n) { + return (n < 0) ? 0 : ((n > 255) ? 255 : n); + } + + private static int mix(int a, int b, int f) { + return a + (((b - a) * f) >> 8); + } + + + + ///////////////////////////////////////////////////////////// + + // BLEND MODE IMPLEMENTIONS + + + private static int blend_blend(int a, int b) { + int f = (b & ALPHA_MASK) >>> 24; + + return (low(((a & ALPHA_MASK) >>> 24) + f, 0xff) << 24 | + mix(a & RED_MASK, b & RED_MASK, f) & RED_MASK | + mix(a & GREEN_MASK, b & GREEN_MASK, f) & GREEN_MASK | + mix(a & BLUE_MASK, b & BLUE_MASK, f)); + } + + + /** + * additive blend with clipping + */ + private static int blend_add_pin(int a, int b) { + int f = (b & ALPHA_MASK) >>> 24; + + return (low(((a & ALPHA_MASK) >>> 24) + f, 0xff) << 24 | + low(((a & RED_MASK) + + ((b & RED_MASK) >> 8) * f), RED_MASK) & RED_MASK | + low(((a & GREEN_MASK) + + ((b & GREEN_MASK) >> 8) * f), GREEN_MASK) & GREEN_MASK | + low((a & BLUE_MASK) + + (((b & BLUE_MASK) * f) >> 8), BLUE_MASK)); + } + + + /** + * subtractive blend with clipping + */ + private static int blend_sub_pin(int a, int b) { + int f = (b & ALPHA_MASK) >>> 24; + + return (low(((a & ALPHA_MASK) >>> 24) + f, 0xff) << 24 | + high(((a & RED_MASK) - ((b & RED_MASK) >> 8) * f), + GREEN_MASK) & RED_MASK | + high(((a & GREEN_MASK) - ((b & GREEN_MASK) >> 8) * f), + BLUE_MASK) & GREEN_MASK | + high((a & BLUE_MASK) - (((b & BLUE_MASK) * f) >> 8), 0)); + } + + + /** + * only returns the blended lightest colour + */ + private static int blend_lightest(int a, int b) { + int f = (b & ALPHA_MASK) >>> 24; + + return (low(((a & ALPHA_MASK) >>> 24) + f, 0xff) << 24 | + high(a & RED_MASK, ((b & RED_MASK) >> 8) * f) & RED_MASK | + high(a & GREEN_MASK, ((b & GREEN_MASK) >> 8) * f) & GREEN_MASK | + high(a & BLUE_MASK, ((b & BLUE_MASK) * f) >> 8)); + } + + + /** + * only returns the blended darkest colour + */ + private static int blend_darkest(int a, int b) { + int f = (b & ALPHA_MASK) >>> 24; + + return (low(((a & ALPHA_MASK) >>> 24) + f, 0xff) << 24 | + mix(a & RED_MASK, + low(a & RED_MASK, + ((b & RED_MASK) >> 8) * f), f) & RED_MASK | + mix(a & GREEN_MASK, + low(a & GREEN_MASK, + ((b & GREEN_MASK) >> 8) * f), f) & GREEN_MASK | + mix(a & BLUE_MASK, + low(a & BLUE_MASK, + ((b & BLUE_MASK) * f) >> 8), f)); + } + + + /** + * returns the absolute value of the difference of the input colors + * C = |A - B| + */ + private static int blend_difference(int a, int b) { + // setup (this portion will always be the same) + int f = (b & ALPHA_MASK) >>> 24; + int ar = (a & RED_MASK) >> 16; + int ag = (a & GREEN_MASK) >> 8; + int ab = (a & BLUE_MASK); + int br = (b & RED_MASK) >> 16; + int bg = (b & GREEN_MASK) >> 8; + int bb = (b & BLUE_MASK); + // formula: + int cr = (ar > br) ? (ar-br) : (br-ar); + int cg = (ag > bg) ? (ag-bg) : (bg-ag); + int cb = (ab > bb) ? (ab-bb) : (bb-ab); + // alpha blend (this portion will always be the same) + return (low(((a & ALPHA_MASK) >>> 24) + f, 0xff) << 24 | + (peg(ar + (((cr - ar) * f) >> 8)) << 16) | + (peg(ag + (((cg - ag) * f) >> 8)) << 8) | + (peg(ab + (((cb - ab) * f) >> 8)) ) ); + } + + + /** + * Cousin of difference, algorithm used here is based on a Lingo version + * found here: http://www.mediamacros.com/item/item-1006687616/ + * (Not yet verified to be correct). + */ + private static int blend_exclusion(int a, int b) { + // setup (this portion will always be the same) + int f = (b & ALPHA_MASK) >>> 24; + int ar = (a & RED_MASK) >> 16; + int ag = (a & GREEN_MASK) >> 8; + int ab = (a & BLUE_MASK); + int br = (b & RED_MASK) >> 16; + int bg = (b & GREEN_MASK) >> 8; + int bb = (b & BLUE_MASK); + // formula: + int cr = ar + br - ((ar * br) >> 7); + int cg = ag + bg - ((ag * bg) >> 7); + int cb = ab + bb - ((ab * bb) >> 7); + // alpha blend (this portion will always be the same) + return (low(((a & ALPHA_MASK) >>> 24) + f, 0xff) << 24 | + (peg(ar + (((cr - ar) * f) >> 8)) << 16) | + (peg(ag + (((cg - ag) * f) >> 8)) << 8) | + (peg(ab + (((cb - ab) * f) >> 8)) ) ); + } + + + /** + * returns the product of the input colors + * C = A * B + */ + private static int blend_multiply(int a, int b) { + // setup (this portion will always be the same) + int f = (b & ALPHA_MASK) >>> 24; + int ar = (a & RED_MASK) >> 16; + int ag = (a & GREEN_MASK) >> 8; + int ab = (a & BLUE_MASK); + int br = (b & RED_MASK) >> 16; + int bg = (b & GREEN_MASK) >> 8; + int bb = (b & BLUE_MASK); + // formula: + int cr = (ar * br) >> 8; + int cg = (ag * bg) >> 8; + int cb = (ab * bb) >> 8; + // alpha blend (this portion will always be the same) + return (low(((a & ALPHA_MASK) >>> 24) + f, 0xff) << 24 | + (peg(ar + (((cr - ar) * f) >> 8)) << 16) | + (peg(ag + (((cg - ag) * f) >> 8)) << 8) | + (peg(ab + (((cb - ab) * f) >> 8)) ) ); + } + + + /** + * returns the inverse of the product of the inverses of the input colors + * (the inverse of multiply). C = 1 - (1-A) * (1-B) + */ + private static int blend_screen(int a, int b) { + // setup (this portion will always be the same) + int f = (b & ALPHA_MASK) >>> 24; + int ar = (a & RED_MASK) >> 16; + int ag = (a & GREEN_MASK) >> 8; + int ab = (a & BLUE_MASK); + int br = (b & RED_MASK) >> 16; + int bg = (b & GREEN_MASK) >> 8; + int bb = (b & BLUE_MASK); + // formula: + int cr = 255 - (((255 - ar) * (255 - br)) >> 8); + int cg = 255 - (((255 - ag) * (255 - bg)) >> 8); + int cb = 255 - (((255 - ab) * (255 - bb)) >> 8); + // alpha blend (this portion will always be the same) + return (low(((a & ALPHA_MASK) >>> 24) + f, 0xff) << 24 | + (peg(ar + (((cr - ar) * f) >> 8)) << 16) | + (peg(ag + (((cg - ag) * f) >> 8)) << 8) | + (peg(ab + (((cb - ab) * f) >> 8)) ) ); + } + + + /** + * returns either multiply or screen for darker or lighter values of A + * (the inverse of hard light) + * C = + * A < 0.5 : 2 * A * B + * A >=0.5 : 1 - (2 * (255-A) * (255-B)) + */ + private static int blend_overlay(int a, int b) { + // setup (this portion will always be the same) + int f = (b & ALPHA_MASK) >>> 24; + int ar = (a & RED_MASK) >> 16; + int ag = (a & GREEN_MASK) >> 8; + int ab = (a & BLUE_MASK); + int br = (b & RED_MASK) >> 16; + int bg = (b & GREEN_MASK) >> 8; + int bb = (b & BLUE_MASK); + // formula: + int cr = (ar < 128) ? ((ar*br)>>7) : (255-(((255-ar)*(255-br))>>7)); + int cg = (ag < 128) ? ((ag*bg)>>7) : (255-(((255-ag)*(255-bg))>>7)); + int cb = (ab < 128) ? ((ab*bb)>>7) : (255-(((255-ab)*(255-bb))>>7)); + // alpha blend (this portion will always be the same) + return (low(((a & ALPHA_MASK) >>> 24) + f, 0xff) << 24 | + (peg(ar + (((cr - ar) * f) >> 8)) << 16) | + (peg(ag + (((cg - ag) * f) >> 8)) << 8) | + (peg(ab + (((cb - ab) * f) >> 8)) ) ); + } + + + /** + * returns either multiply or screen for darker or lighter values of B + * (the inverse of overlay) + * C = + * B < 0.5 : 2 * A * B + * B >=0.5 : 1 - (2 * (255-A) * (255-B)) + */ + private static int blend_hard_light(int a, int b) { + // setup (this portion will always be the same) + int f = (b & ALPHA_MASK) >>> 24; + int ar = (a & RED_MASK) >> 16; + int ag = (a & GREEN_MASK) >> 8; + int ab = (a & BLUE_MASK); + int br = (b & RED_MASK) >> 16; + int bg = (b & GREEN_MASK) >> 8; + int bb = (b & BLUE_MASK); + // formula: + int cr = (br < 128) ? ((ar*br)>>7) : (255-(((255-ar)*(255-br))>>7)); + int cg = (bg < 128) ? ((ag*bg)>>7) : (255-(((255-ag)*(255-bg))>>7)); + int cb = (bb < 128) ? ((ab*bb)>>7) : (255-(((255-ab)*(255-bb))>>7)); + // alpha blend (this portion will always be the same) + return (low(((a & ALPHA_MASK) >>> 24) + f, 0xff) << 24 | + (peg(ar + (((cr - ar) * f) >> 8)) << 16) | + (peg(ag + (((cg - ag) * f) >> 8)) << 8) | + (peg(ab + (((cb - ab) * f) >> 8)) ) ); + } + + + /** + * returns the inverse multiply plus screen, which simplifies to + * C = 2AB + A^2 - 2A^2B + */ + private static int blend_soft_light(int a, int b) { + // setup (this portion will always be the same) + int f = (b & ALPHA_MASK) >>> 24; + int ar = (a & RED_MASK) >> 16; + int ag = (a & GREEN_MASK) >> 8; + int ab = (a & BLUE_MASK); + int br = (b & RED_MASK) >> 16; + int bg = (b & GREEN_MASK) >> 8; + int bb = (b & BLUE_MASK); + // formula: + int cr = ((ar*br)>>7) + ((ar*ar)>>8) - ((ar*ar*br)>>15); + int cg = ((ag*bg)>>7) + ((ag*ag)>>8) - ((ag*ag*bg)>>15); + int cb = ((ab*bb)>>7) + ((ab*ab)>>8) - ((ab*ab*bb)>>15); + // alpha blend (this portion will always be the same) + return (low(((a & ALPHA_MASK) >>> 24) + f, 0xff) << 24 | + (peg(ar + (((cr - ar) * f) >> 8)) << 16) | + (peg(ag + (((cg - ag) * f) >> 8)) << 8) | + (peg(ab + (((cb - ab) * f) >> 8)) ) ); + } + + + /** + * Returns the first (underlay) color divided by the inverse of + * the second (overlay) color. C = A / (255-B) + */ + private static int blend_dodge(int a, int b) { + // setup (this portion will always be the same) + int f = (b & ALPHA_MASK) >>> 24; + int ar = (a & RED_MASK) >> 16; + int ag = (a & GREEN_MASK) >> 8; + int ab = (a & BLUE_MASK); + int br = (b & RED_MASK) >> 16; + int bg = (b & GREEN_MASK) >> 8; + int bb = (b & BLUE_MASK); + // formula: + int cr = (br==255) ? 255 : peg((ar << 8) / (255 - br)); // division requires pre-peg()-ing + int cg = (bg==255) ? 255 : peg((ag << 8) / (255 - bg)); // " + int cb = (bb==255) ? 255 : peg((ab << 8) / (255 - bb)); // " + // alpha blend (this portion will always be the same) + return (low(((a & ALPHA_MASK) >>> 24) + f, 0xff) << 24 | + (peg(ar + (((cr - ar) * f) >> 8)) << 16) | + (peg(ag + (((cg - ag) * f) >> 8)) << 8) | + (peg(ab + (((cb - ab) * f) >> 8)) ) ); + } + + + /** + * returns the inverse of the inverse of the first (underlay) color + * divided by the second (overlay) color. C = 255 - (255-A) / B + */ + private static int blend_burn(int a, int b) { + // setup (this portion will always be the same) + int f = (b & ALPHA_MASK) >>> 24; + int ar = (a & RED_MASK) >> 16; + int ag = (a & GREEN_MASK) >> 8; + int ab = (a & BLUE_MASK); + int br = (b & RED_MASK) >> 16; + int bg = (b & GREEN_MASK) >> 8; + int bb = (b & BLUE_MASK); + // formula: + int cr = (br==0) ? 0 : 255 - peg(((255 - ar) << 8) / br); // division requires pre-peg()-ing + int cg = (bg==0) ? 0 : 255 - peg(((255 - ag) << 8) / bg); // " + int cb = (bb==0) ? 0 : 255 - peg(((255 - ab) << 8) / bb); // " + // alpha blend (this portion will always be the same) + return (low(((a & ALPHA_MASK) >>> 24) + f, 0xff) << 24 | + (peg(ar + (((cr - ar) * f) >> 8)) << 16) | + (peg(ag + (((cg - ag) * f) >> 8)) << 8) | + (peg(ab + (((cb - ab) * f) >> 8)) ) ); + } + + + ////////////////////////////////////////////////////////////// + + // FILE I/O + + + static byte TIFF_HEADER[] = { + 77, 77, 0, 42, 0, 0, 0, 8, 0, 9, 0, -2, 0, 4, 0, 0, 0, 1, 0, 0, + 0, 0, 1, 0, 0, 3, 0, 0, 0, 1, 0, 0, 0, 0, 1, 1, 0, 3, 0, 0, 0, 1, + 0, 0, 0, 0, 1, 2, 0, 3, 0, 0, 0, 3, 0, 0, 0, 122, 1, 6, 0, 3, 0, + 0, 0, 1, 0, 2, 0, 0, 1, 17, 0, 4, 0, 0, 0, 1, 0, 0, 3, 0, 1, 21, + 0, 3, 0, 0, 0, 1, 0, 3, 0, 0, 1, 22, 0, 3, 0, 0, 0, 1, 0, 0, 0, 0, + 1, 23, 0, 4, 0, 0, 0, 1, 0, 0, 0, 0, 0, 0, 0, 0, 0, 8, 0, 8, 0, 8 + }; + + + static final String TIFF_ERROR = + "Error: Processing can only read its own TIFF files."; + + static protected PImage loadTIFF(byte tiff[]) { + if ((tiff[42] != tiff[102]) || // width/height in both places + (tiff[43] != tiff[103])) { + System.err.println(TIFF_ERROR); + return null; + } + + int width = + ((tiff[30] & 0xff) << 8) | (tiff[31] & 0xff); + int height = + ((tiff[42] & 0xff) << 8) | (tiff[43] & 0xff); + + int count = + ((tiff[114] & 0xff) << 24) | + ((tiff[115] & 0xff) << 16) | + ((tiff[116] & 0xff) << 8) | + (tiff[117] & 0xff); + if (count != width * height * 3) { + System.err.println(TIFF_ERROR + " (" + width + ", " + height +")"); + return null; + } + + // check the rest of the header + for (int i = 0; i < TIFF_HEADER.length; i++) { + if ((i == 30) || (i == 31) || (i == 42) || (i == 43) || + (i == 102) || (i == 103) || + (i == 114) || (i == 115) || (i == 116) || (i == 117)) continue; + + if (tiff[i] != TIFF_HEADER[i]) { + System.err.println(TIFF_ERROR + " (" + i + ")"); + return null; + } + } + + PImage outgoing = new PImage(width, height, RGB); + int index = 768; + count /= 3; + for (int i = 0; i < count; i++) { + outgoing.pixels[i] = + 0xFF000000 | + (tiff[index++] & 0xff) << 16 | + (tiff[index++] & 0xff) << 8 | + (tiff[index++] & 0xff); + } + return outgoing; + } + + + protected boolean saveTIFF(OutputStream output) { + // shutting off the warning, people can figure this out themselves + /* + if (format != RGB) { + System.err.println("Warning: only RGB information is saved with " + + ".tif files. Use .tga or .png for ARGB images and others."); + } + */ + try { + byte tiff[] = new byte[768]; + System.arraycopy(TIFF_HEADER, 0, tiff, 0, TIFF_HEADER.length); + + tiff[30] = (byte) ((width >> 8) & 0xff); + tiff[31] = (byte) ((width) & 0xff); + tiff[42] = tiff[102] = (byte) ((height >> 8) & 0xff); + tiff[43] = tiff[103] = (byte) ((height) & 0xff); + + int count = width*height*3; + tiff[114] = (byte) ((count >> 24) & 0xff); + tiff[115] = (byte) ((count >> 16) & 0xff); + tiff[116] = (byte) ((count >> 8) & 0xff); + tiff[117] = (byte) ((count) & 0xff); + + // spew the header to the disk + output.write(tiff); + + for (int i = 0; i < pixels.length; i++) { + output.write((pixels[i] >> 16) & 0xff); + output.write((pixels[i] >> 8) & 0xff); + output.write(pixels[i] & 0xff); + } + output.flush(); + return true; + + } catch (IOException e) { + e.printStackTrace(); + } + return false; + } + + + /** + * Creates a Targa32 formatted byte sequence of specified + * pixel buffer using RLE compression. + *

+ * Also figured out how to avoid parsing the image upside-down + * (there's a header flag to set the image origin to top-left) + *

+ * Starting with revision 0092, the format setting is taken into account: + *
    + *
  • ALPHA images written as 8bit grayscale (uses lowest byte) + *
  • RGB → 24 bits + *
  • ARGB → 32 bits + *
+ * All versions are RLE compressed. + *

+ * Contributed by toxi 8-10 May 2005, based on this RLE + * specification + */ + protected boolean saveTGA(OutputStream output) { + byte header[] = new byte[18]; + + if (format == ALPHA) { // save ALPHA images as 8bit grayscale + header[2] = 0x0B; + header[16] = 0x08; + header[17] = 0x28; + + } else if (format == RGB) { + header[2] = 0x0A; + header[16] = 24; + header[17] = 0x20; + + } else if (format == ARGB) { + header[2] = 0x0A; + header[16] = 32; + header[17] = 0x28; + + } else { + throw new RuntimeException("Image format not recognized inside save()"); + } + // set image dimensions lo-hi byte order + header[12] = (byte) (width & 0xff); + header[13] = (byte) (width >> 8); + header[14] = (byte) (height & 0xff); + header[15] = (byte) (height >> 8); + + try { + output.write(header); + + int maxLen = height * width; + int index = 0; + int col; //, prevCol; + int[] currChunk = new int[128]; + + // 8bit image exporter is in separate loop + // to avoid excessive conditionals... + if (format == ALPHA) { + while (index < maxLen) { + boolean isRLE = false; + int rle = 1; + currChunk[0] = col = pixels[index] & 0xff; + while (index + rle < maxLen) { + if (col != (pixels[index + rle]&0xff) || rle == 128) { + isRLE = (rle > 1); + break; + } + rle++; + } + if (isRLE) { + output.write(0x80 | (rle - 1)); + output.write(col); + + } else { + rle = 1; + while (index + rle < maxLen) { + int cscan = pixels[index + rle] & 0xff; + if ((col != cscan && rle < 128) || rle < 3) { + currChunk[rle] = col = cscan; + } else { + if (col == cscan) rle -= 2; + break; + } + rle++; + } + output.write(rle - 1); + for (int i = 0; i < rle; i++) output.write(currChunk[i]); + } + index += rle; + } + } else { // export 24/32 bit TARGA + while (index < maxLen) { + boolean isRLE = false; + currChunk[0] = col = pixels[index]; + int rle = 1; + // try to find repeating bytes (min. len = 2 pixels) + // maximum chunk size is 128 pixels + while (index + rle < maxLen) { + if (col != pixels[index + rle] || rle == 128) { + isRLE = (rle > 1); // set flag for RLE chunk + break; + } + rle++; + } + if (isRLE) { + output.write(128 | (rle - 1)); + output.write(col & 0xff); + output.write(col >> 8 & 0xff); + output.write(col >> 16 & 0xff); + if (format == ARGB) output.write(col >>> 24 & 0xff); + + } else { // not RLE + rle = 1; + while (index + rle < maxLen) { + if ((col != pixels[index + rle] && rle < 128) || rle < 3) { + currChunk[rle] = col = pixels[index + rle]; + } else { + // check if the exit condition was the start of + // a repeating colour + if (col == pixels[index + rle]) rle -= 2; + break; + } + rle++; + } + // write uncompressed chunk + output.write(rle - 1); + if (format == ARGB) { + for (int i = 0; i < rle; i++) { + col = currChunk[i]; + output.write(col & 0xff); + output.write(col >> 8 & 0xff); + output.write(col >> 16 & 0xff); + output.write(col >>> 24 & 0xff); + } + } else { + for (int i = 0; i < rle; i++) { + col = currChunk[i]; + output.write(col & 0xff); + output.write(col >> 8 & 0xff); + output.write(col >> 16 & 0xff); + } + } + } + index += rle; + } + } + output.flush(); + return true; + + } catch (IOException e) { + e.printStackTrace(); + return false; + } + } + + + /** + * Use ImageIO functions from Java 1.4 and later to handle image save. + * Various formats are supported, typically jpeg, png, bmp, and wbmp. + * To get a list of the supported formats for writing, use:
+ * println(javax.imageio.ImageIO.getReaderFormatNames()) + */ + protected void saveImageIO(String path) throws IOException { + try { + BufferedImage bimage = + new BufferedImage(width, height, (format == ARGB) ? + BufferedImage.TYPE_INT_ARGB : + BufferedImage.TYPE_INT_RGB); + /* + Class bufferedImageClass = + Class.forName("java.awt.image.BufferedImage"); + Constructor bufferedImageConstructor = + bufferedImageClass.getConstructor(new Class[] { + Integer.TYPE, + Integer.TYPE, + Integer.TYPE }); + Field typeIntRgbField = bufferedImageClass.getField("TYPE_INT_RGB"); + int typeIntRgb = typeIntRgbField.getInt(typeIntRgbField); + Field typeIntArgbField = bufferedImageClass.getField("TYPE_INT_ARGB"); + int typeIntArgb = typeIntArgbField.getInt(typeIntArgbField); + Object bimage = + bufferedImageConstructor.newInstance(new Object[] { + new Integer(width), + new Integer(height), + new Integer((format == ARGB) ? typeIntArgb : typeIntRgb) + }); + */ + + bimage.setRGB(0, 0, width, height, pixels, 0, width); + /* + Method setRgbMethod = + bufferedImageClass.getMethod("setRGB", new Class[] { + Integer.TYPE, Integer.TYPE, + Integer.TYPE, Integer.TYPE, + pixels.getClass(), + Integer.TYPE, Integer.TYPE + }); + setRgbMethod.invoke(bimage, new Object[] { + new Integer(0), new Integer(0), + new Integer(width), new Integer(height), + pixels, new Integer(0), new Integer(width) + }); + */ + + File file = new File(path); + String extension = path.substring(path.lastIndexOf('.') + 1); + + ImageIO.write(bimage, extension, file); + /* + Class renderedImageClass = + Class.forName("java.awt.image.RenderedImage"); + Class ioClass = Class.forName("javax.imageio.ImageIO"); + Method writeMethod = + ioClass.getMethod("write", new Class[] { + renderedImageClass, String.class, File.class + }); + writeMethod.invoke(null, new Object[] { bimage, extension, file }); + */ + + } catch (Exception e) { + e.printStackTrace(); + throw new IOException("image save failed."); + } + } + + + protected String[] saveImageFormats; + + /** + * Saves the image into a file. Images are saved in TIFF, TARGA, JPEG, and PNG format depending on the extension within the filename parameter. + * For example, "image.tif" will have a TIFF image and "image.png" will save a PNG image. + * If no extension is included in the filename, the image will save in TIFF format and .tif will be added to the name. + * 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 save() while running the program in a web browser.

+ * To save an image created within the code, rather than through loading, it's necessary to make the image with the createImage() + * function so it is aware of the location of the program and can therefore save the file to the right place. + * See the createImage() reference for more information. + * + * =advanced + * Save this image to disk. + *

+ * As of revision 0100, this function requires an absolute path, + * in order to avoid confusion. To save inside the sketch folder, + * use the function savePath() from PApplet, or use saveFrame() instead. + * As of revision 0116, savePath() is not needed if this object has been + * created (as recommended) via createImage() or createGraphics() or + * one of its neighbors. + *

+ * As of revision 0115, when using Java 1.4 and later, you can write + * to several formats besides tga and tiff. If Java 1.4 is installed + * and the extension used is supported (usually png, jpg, jpeg, bmp, + * and tiff), then those methods will be used to write the image. + * To get a list of the supported formats for writing, use:
+ * println(javax.imageio.ImageIO.getReaderFormatNames()) + *

+ * To use the original built-in image writers, use .tga or .tif as the + * extension, or don't include an extension. When no extension is used, + * the extension .tif will be added to the file name. + *

+ * The ImageIO API claims to support wbmp files, however they probably + * require a black and white image. Basic testing produced a zero-length + * file with no error. + * + * @webref + * @brief Saves the image to a TIFF, TARGA, PNG, or JPEG file + * @param filename a sequence of letters and numbers + */ + public void save(String filename) { // ignore + boolean success = false; + + File file = new File(filename); + if (!file.isAbsolute()) { + if (parent != null) { + //file = new File(parent.savePath(filename)); + filename = parent.savePath(filename); + } else { + String msg = "PImage.save() requires an absolute path. " + + "Use createImage(), or pass savePath() to save()."; + PGraphics.showException(msg); + } + } + + // Make sure the pixel data is ready to go + loadPixels(); + + try { + OutputStream os = null; + + if (saveImageFormats == null) { + saveImageFormats = javax.imageio.ImageIO.getWriterFormatNames(); + } + if (saveImageFormats != null) { + for (int i = 0; i < saveImageFormats.length; i++) { + if (filename.endsWith("." + saveImageFormats[i])) { + saveImageIO(filename); + return; + } + } + } + + if (filename.toLowerCase().endsWith(".tga")) { + os = new BufferedOutputStream(new FileOutputStream(filename), 32768); + success = saveTGA(os); //, pixels, width, height, format); + + } else { + if (!filename.toLowerCase().endsWith(".tif") && + !filename.toLowerCase().endsWith(".tiff")) { + // if no .tif extension, add it.. + filename += ".tif"; + } + os = new BufferedOutputStream(new FileOutputStream(filename), 32768); + success = saveTIFF(os); //, pixels, width, height); + } + os.flush(); + os.close(); + + } catch (IOException e) { + //System.err.println("Error while saving image."); + e.printStackTrace(); + success = false; + } + if (!success) { + throw new RuntimeException("Error while saving image."); + } + } +} + diff --git a/core/methods/methods.jar b/core/methods/methods.jar new file mode 100644 index 0000000000000000000000000000000000000000..ff4276ba306846472b1e999976c4dbf742ec18d7 GIT binary patch literal 3725 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 0) { + break; + } + } + + // read the rest of the file and append it to the + while ((line = applet.readLine()) != null) { + content.append(line); + content.append('\n'); + } + + applet.close(); + process(out, graphicsFile); + process(out, imageFile); + + out.append('}'); + out.append('\n'); + + //} catch (IOException e) { + //e.printStackTrace(); + + } catch (Exception e) { + //ex.printStackTrace(); + throw new BuildException(e); + } + //out.flush(); + + String outString = out.toString(); + if (content.toString().equals(outString)) { + System.out.println("No changes to PApplet API."); + } else { + System.out.println("Updating PApplet with API changes " + + "from PImage or PGraphics."); + try { + PrintStream temp = new PrintStream(appletFile, "UTF-8"); + temp.print(outString); + temp.flush(); + temp.close(); + } catch (IOException e) { + //e.printStackTrace(); + throw new BuildException(e); + } + } + } + + + private void process(StringBuffer out, File input) throws IOException { + BufferedReader in = createReader(input); + int comments = 0; + String line = null; + StringBuffer commentBuffer = new StringBuffer(); + + while ((line = in.readLine()) != null) { + String decl = ""; + + // Keep track of comments + //if (line.matches(Pattern.quote("/*"))) { + if (line.indexOf("/*") != -1) { + comments++; + } + + //if (line.matches(Pattern.quote("*/"))) { + if (line.indexOf("*/") != -1) { + commentBuffer.append(line); + commentBuffer.append('\n'); + //System.out.println("comment is: " + commentBuffer.toString()); + comments--; + // otherwise gotSomething will be false, and nuke the comment + continue; + } + + // Ignore everything inside comments + if (comments > 0) { + commentBuffer.append(line); + commentBuffer.append('\n'); + continue; + } + + boolean gotSomething = false; + boolean gotStatic = false; + + Matcher result; + + if ((result = Pattern.compile("^\\s*public ([\\w\\[\\]]+) [a-zA-z_]+\\(.*$").matcher(line)).matches()) { + gotSomething = true; + + } else if ((result = Pattern.compile("^\\s*abstract public ([\\w\\[\\]]+) [a-zA-z_]+\\(.*$").matcher(line)).matches()) { + gotSomething = true; + + } else if ((result = Pattern.compile("^\\s*public final ([\\w\\[\\]]+) [a-zA-z_]+\\(.*$").matcher(line)).matches()) { + gotSomething = true; + + } else if ((result = Pattern.compile("^\\s*static public ([\\w\\[\\]]+) [a-zA-z_]+\\(.*$").matcher(line)).matches()) { + gotSomething = true; + gotStatic = true; + } + + // if function is marked "// ignore" then, uh, ignore it. + if (gotSomething && line.indexOf("// ignore") >= 0) { + gotSomething = false; + } + + String returns = ""; + if (gotSomething) { + if (result.group(1).equals("void")) { + returns = ""; + } else { + returns = "return "; + } + + // remove the abstract modifier + line = line.replaceFirst(Pattern.quote("abstract"), " "); + + // replace semicolons with a start def + line = line.replaceAll(Pattern.quote(";"), " {\n"); + + //out.println("\n\n" + line); + out.append('\n'); + out.append('\n'); + // end has its own newline + //out.print(commentBuffer.toString()); // TODO disabled for now XXXX + out.append(commentBuffer.toString()); // duplicates all comments + commentBuffer.setLength(0); + out.append(line); + out.append('\n'); + + decl += line; + while(line.indexOf(')') == -1) { + line = in.readLine(); + decl += line; + line = line.replaceAll("\\;\\s*$", " {\n"); + out.append(line); + out.append('\n'); + } + + result = Pattern.compile(".*?\\s(\\S+)\\(.*?").matcher(decl); + // try to match. don't remove this or things will stop working! + result.matches(); + String declName = result.group(1); + String gline = ""; + String rline = ""; + if (gotStatic) { + gline = " " + returns + "PGraphics." + declName + "("; + } else { + rline = " if (recorder != null) recorder." + declName + "("; + gline = " " + returns + "g." + declName + "("; + } + + decl = decl.replaceAll("\\s+", " "); // smush onto a single line + decl = decl.replaceFirst("^.*\\(", ""); + decl = decl.replaceFirst("\\).*$", ""); + + int prev = 0; + String parts[] = decl.split("\\, "); + + for (String part : parts) { + if (!part.trim().equals("")) { + String blargh[] = part.split(" "); + String theArg = blargh[1].replaceAll("[\\[\\]]", ""); + + if (prev != 0) { + gline += ", "; + rline += ", "; + } + + gline += theArg; + rline += theArg; + prev = 1; + } + } + + gline += ");"; + rline += ");"; + + if (!gotStatic && returns.equals("")) { + out.append(rline); + out.append('\n'); + } + out.append(gline); + out.append('\n'); + out.append(" }"); + out.append('\n'); + + } else { + commentBuffer.setLength(0); + } + } + + in.close(); + } + + + static BufferedReader createReader(File file) throws IOException { + FileInputStream fis = new FileInputStream(file); + return new BufferedReader(new InputStreamReader(fis, "UTF-8")); + } +} diff --git a/core/src/processing/core/PApplet.java b/core/src/processing/core/PApplet.java index 06541c547..60bbe3d75 100644 --- a/core/src/processing/core/PApplet.java +++ b/core/src/processing/core/PApplet.java @@ -3,7 +3,7 @@ /* Part of the Processing project - http://processing.org - Copyright (c) 2004-09 Ben Fry and Casey Reas + Copyright (c) 2004-10 Ben Fry and Casey Reas Copyright (c) 2001-04 Massachusetts Institute of Technology This library is free software; you can redistribute it and/or @@ -39,6 +39,8 @@ import javax.imageio.ImageIO; import javax.swing.JFileChooser; import javax.swing.SwingUtilities; +import processing.core.PShape; + /** * Base class for all sketches that use processing.core. @@ -157,6 +159,7 @@ import javax.swing.SwingUtilities; * itself (we must draw the line somewhere), because of how messy it would * get to start talking about multiple screens. It's also not that tough to * do by hand w/ some Java code.

+ * @usage Web & Application */ public class PApplet extends Applet implements PConstants, Runnable, @@ -217,6 +220,25 @@ public class PApplet extends Applet } } + /** + * Setting for whether to use the Quartz renderer on OS X. The Quartz + * renderer is on its way out for OS X, but Processing uses it by default + * because it's much faster than the Sun renderer. In some cases, however, + * the Quartz renderer is preferred. For instance, fonts are less thick + * when using the Sun renderer, so to improve how fonts look, + * change this setting before you call PApplet.main(). + * 
+   * static public void main(String[] args) {
+   *   PApplet.useQuartz = "false";
+   *   PApplet.main(new String[] { "YourSketch" });
+   * }
+   *
+ * This setting must be called before any AWT work happens, so that's why + * it's such a terrible hack in how it's employed here. Calling setProperty() + * inside setup() is a joke, since it's long since the AWT has been invoked. + */ + static public String useQuartz = "true"; + /** * Modifier flags for the shortcut key used to trigger menus. * (Cmd on Mac OS X, Ctrl on Linux and Windows) @@ -247,8 +269,15 @@ public class PApplet extends Applet * Note that this won't update if you change the resolution * of your screen once the the applet is running. *

- * This variable is not static, because future releases need to be better - * at handling multiple displays. + * This variable is not static because in the desktop version of Processing, + * not all instances of PApplet will necessarily be started on a screen of + * the same size. + */ + public int screenWidth, screenHeight; + + /** + * Use screenW and screenH instead. + * @deprecated */ public Dimension screen = Toolkit.getDefaultToolkit().getScreenSize(); @@ -305,23 +334,54 @@ public class PApplet extends Applet volatile int resizeHeight; /** + * Array containing the values for all the pixels in the display window. These values are of the color datatype. This array is the size of the display window. For example, if the image is 100x100 pixels, there will be 10000 values and if the window is 200x300 pixels, there will be 60000 values. The index value defines the position of a value within the array. For example, the statment color b = pixels[230] will set the variable b to be equal to the value at that location in the array.

Before accessing this array, the data must loaded with the loadPixels() function. After the array data has been modified, the updatePixels() function must be run to update the changes. Without loadPixels(), running the code may (or will in future releases) result in a NullPointerException. * Pixel buffer from this applet's PGraphics. *

* When used with OpenGL or Java2D, this value will * be null until loadPixels() has been called. + * + * @webref image:pixels + * @see processing.core.PApplet#loadPixels() + * @see processing.core.PApplet#updatePixels() + * @see processing.core.PApplet#get(int, int, int, int) + * @see processing.core.PApplet#set(int, int, int) + * @see processing.core.PImage */ public int pixels[]; - /** width of this applet's associated PGraphics */ + /** width of this applet's associated PGraphics + * @webref environment + */ public int width; - /** height of this applet's associated PGraphics */ + /** height of this applet's associated PGraphics + * @webref environment + * */ public int height; - /** current x position of the mouse */ + /** + * The system variable mouseX always contains the current horizontal coordinate of the mouse. + * @webref input:mouse + * @see PApplet#mouseY + * @see PApplet#mousePressed + * @see PApplet#mousePressed() + * @see PApplet#mouseReleased() + * @see PApplet#mouseMoved() + * @see PApplet#mouseDragged() + * + * */ public int mouseX; - /** current y position of the mouse */ + /** + * The system variable mouseY always contains the current vertical coordinate of the mouse. + * @webref input:mouse + * @see PApplet#mouseX + * @see PApplet#mousePressed + * @see PApplet#mousePressed() + * @see PApplet#mouseReleased() + * @see PApplet#mouseMoved() + * @see PApplet#mouseDragged() + * */ public int mouseY; /** @@ -332,8 +392,20 @@ public class PApplet extends Applet * an event comes through. Be sure to use only one or the other type of * means for tracking pmouseX and pmouseY within your sketch, otherwise * you're gonna run into trouble. + * @webref input:mouse + * @see PApplet#pmouseY + * @see PApplet#mouseX + * @see PApplet#mouseY */ - public int pmouseX, pmouseY; + public int pmouseX; + + /** + * @webref input:mouse + * @see PApplet#pmouseX + * @see PApplet#mouseX + * @see PApplet#mouseY + */ + public int pmouseY; /** * previous mouseX/Y for the draw loop, separated out because this is @@ -360,36 +432,84 @@ public class PApplet extends Applet public boolean firstMouse; /** - * Last mouse button pressed, one of LEFT, CENTER, or RIGHT. - *

+ * Processing automatically tracks if the mouse button is pressed and which button is pressed. + * The value of the system variable mouseButton is either LEFT, RIGHT, or CENTER depending on which button is pressed. + *

Advanced:

* If running on Mac OS, a ctrl-click will be interpreted as * the righthand mouse button (unlike Java, which reports it as * the left mouse). + * @webref input:mouse + * @see PApplet#mouseX + * @see PApplet#mouseY + * @see PApplet#mousePressed() + * @see PApplet#mouseReleased() + * @see PApplet#mouseMoved() + * @see PApplet#mouseDragged() */ public int mouseButton; + /** + * Variable storing if a mouse button is pressed. The value of the system variable mousePressed is true if a mouse button is pressed and false if a button is not pressed. + * @webref input:mouse + * @see PApplet#mouseX + * @see PApplet#mouseY + * @see PApplet#mouseReleased() + * @see PApplet#mouseMoved() + * @see PApplet#mouseDragged() + */ public boolean mousePressed; public MouseEvent mouseEvent; /** + * The system variable key 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 keyCode 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 the key variable instead of keyCode + * If you're making 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. + * =advanced + * * Last key pressed. *

* If it's a coded key, i.e. UP/DOWN/CTRL/SHIFT/ALT, * this will be set to CODED (0xffff or 65535). + * @webref input:keyboard + * @see PApplet#keyCode + * @see PApplet#keyPressed + * @see PApplet#keyPressed() + * @see PApplet#keyReleased() */ public char key; /** + * The variable keyCode is used to detect special keys such as the UP, 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 key variable instead of keyCode + * If you're making 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. + *

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 KeyEvent reference. + * + * =advanced * When "key" is set to CODED, this will contain a Java key code. *

* For the arrow keys, keyCode will be one of UP, DOWN, LEFT and RIGHT. * Also available are ALT, CONTROL and SHIFT. A full set of constants * can be obtained from java.awt.event.KeyEvent, from the VK_XXXX variables. + * @webref input:keyboard + * @see PApplet#key + * @see PApplet#keyPressed + * @see PApplet#keyPressed() + * @see PApplet#keyReleased() */ public int keyCode; /** - * true if the mouse is currently pressed. + * The boolean system variable keyPressed is true if any key is pressed and false if no keys are pressed. + * @webref input:keyboard + * @see PApplet#key + * @see PApplet#keyCode + * @see PApplet#keyPressed() + * @see PApplet#keyReleased() */ public boolean keyPressed; @@ -400,6 +520,7 @@ public class PApplet extends Applet /** * Gets set to true/false as the applet gains/loses focus. + * @webref environment */ public boolean focused = false; @@ -408,6 +529,7 @@ public class PApplet extends Applet *

* This can be used to test how the applet should behave * since online situations are different (no file writing, etc). + * @webref environment */ public boolean online = false; @@ -542,6 +664,10 @@ public class PApplet extends Applet public void init() { // println("Calling init()"); + Dimension screen = Toolkit.getDefaultToolkit().getScreenSize(); + screenWidth = screen.width; + screenHeight = screen.height; + // send tab keys through to the PApplet setFocusTraversalKeysEnabled(false); @@ -935,6 +1061,17 @@ public class PApplet extends Applet /** + * Defines the dimension of the display window in units of pixels. The size() function must be the first line in setup(). If size() is not called, the default size of the window is 100x100 pixels. The system variables width and height are set by the parameters passed to the size() function.

+ * Do not use variables as the parameters to size() command, because it will cause problems when exporting your sketch. When variables are used, the dimensions of your sketch cannot be determined during export. Instead, employ numeric values in the size() statement, and then use the built-in width and height variables inside your program when you need the dimensions of the display window are needed.

+ * The MODE parameters selects which rendering engine to use. For example, if you will be drawing 3D shapes for the web use P3D, if you want to export a program with OpenGL graphics acceleration use OPENGL. A brief description of the four primary renderers follows:

JAVA2D - The default renderer. This renderer supports two dimensional drawing and provides higher image quality in overall, but generally slower than P2D.

P2D (Processing 2D) - Fast 2D renderer, best used with pixel data, but not as accurate as the JAVA2D default.

P3D (Processing 3D) - Fast 3D renderer for the web. Sacrifices rendering quality for quick 3D drawing.

OPENGL - High speed 3D graphics renderer that makes use of OpenGL-compatible graphics hardware is available. Keep in mind that OpenGL is not magic pixie dust that makes any sketch faster (though it's close), so other rendering options may produce better results depending on the nature of your code. Also note that with OpenGL, all graphics are smoothed: the smooth() and noSmooth() commands are ignored.

PDF - 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 → PDF to make use of the library. More information can be found in the PDF library reference. + * If you're manipulating pixels (using methods like get() or blend(), or manipulating the pixels[] array), P2D and P3D will usually be faster than the default (JAVA2D) setting, and often the OPENGL setting as well. Similarly, when handling lots of images, or doing video playback, P2D and P3D will tend to be faster.

+ * The P2D, P3D, and OPENGL renderers do not support strokeCap() or strokeJoin(), which can lead to ugly results when using strokeWeight(). (Bug 955)

+ * For the most elegant and accurate results when drawing in 2D, particularly when using smooth(), use the JAVA2D renderer setting. It may be slower than the others, but is the most complete, which is why it's the default. Advanced users will want to switch to other renderers as they learn the tradeoffs.

+ * Rendering graphics requires tradeoffs between speed, accuracy, and general usefulness of the available features. None of the renderers are perfect, so we provide multiple options so that you can decide what tradeoffs make the most sense for your project. We'd prefer all of them to have perfect visual accuracy, high performance, and support a wide range of features, but that's simply not possible.

+ * 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 screen that's 800x600 could support size(1600, 300), since it's the same number of pixels. This varies widely so you'll have to try different rendering modes and sizes until you get what you're looking for. If you need something larger, use createGraphics to create a non-visible drawing surface. + *

Again, the size() method must be the first line of the code (or first item inside setup). Any code that appears before the size() command may run more than once, which can lead to confusing results. + * + * =advanced * Starts up and creates a two-dimensional drawing surface, * or resizes the current drawing surface. *

@@ -948,12 +1085,19 @@ public class PApplet extends Applet *

* If called once a renderer has already been set, this will * use the previous renderer and simply resize it. + * + * @webref structure + * @param iwidth width of the display window in units of pixels + * @param iheight height of the display window in units of pixels */ public void size(int iwidth, int iheight) { size(iwidth, iheight, JAVA2D, null); } - + /** + * + * @param irenderer Either P2D, P3D, JAVA2D, or OPENGL + */ public void size(int iwidth, int iheight, String irenderer) { size(iwidth, iheight, irenderer, null); } @@ -1015,6 +1159,11 @@ public class PApplet extends Applet /** + * Creates and returns a new PGraphics object of the types P2D, P3D, and JAVA2D. Use this class if you need to draw into an off-screen graphics buffer. It's not possible to use createGraphics() with OPENGL, because it doesn't allow offscreen use. The DXF and PDF renderers require the filename parameter. + *

It's important to call any drawing commands between beginDraw() and endDraw() statements. This is also true for any commands that affect drawing, such as smooth() or colorMode(). + *

Unlike the main drawing surface which is completely opaque, surfaces created with createGraphics() can have transparency. This makes it possible to draw into a graphics and maintain the alpha channel. By using save() to write a PNG or TGA file, the transparency of the graphics object will be honored. Note that transparency levels are binary: pixels are either complete opaque or transparent. For the time being (as of release 0127), this means that text characters will be opaque blocks. This will be fixed in a future release (Bug 641). + * + * =advanced * Create an offscreen PGraphics object for drawing. This can be used * for bitmap or vector images drawing or rendering. *

    @@ -1063,6 +1212,14 @@ public class PApplet extends Applet * background information can be found in the developer's reference for * PImage.save(). *
+ * + * @webref rendering + * @param iwidth width in pixels + * @param iheight height in pixels + * @param irenderer Either P2D (not yet implemented), P3D, JAVA2D, PDF, DXF + * + * @see processing.core.PGraphics + * */ public PGraphics createGraphics(int iwidth, int iheight, String irenderer) { @@ -1075,7 +1232,7 @@ public class PApplet extends Applet /** * Create an offscreen graphics surface for drawing, in this case * for a renderer that writes to a file (such as PDF or DXF). - * @param ipath can be an absolute or relative path + * @param ipath the name of the file (can be an absolute or relative path) */ public PGraphics createGraphics(int iwidth, int iheight, String irenderer, String ipath) { @@ -1219,9 +1376,21 @@ public class PApplet extends Applet /** + * Creates a new PImage (the datatype for storing images). This provides a fresh buffer of pixels to play with. Set the size of the buffer with the width and height parameters. The format 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 new PImage(). + * =advanced * Preferred method of creating new PImage objects, ensures that a * reference to the parent PApplet is included, which makes save() work * without needing an absolute path. + * + * @webref image + * @param wide width in pixels + * @param high height in pixels + * @param format Either RGB, ARGB, ALPHA (grayscale alpha channel) + * + * @see processing.core.PImage + * @see processing.core.PGraphics */ public PImage createImage(int wide, int high, int format) { PImage image = new PImage(wide, high, format); @@ -1678,35 +1847,75 @@ public class PApplet extends Applet /** - * Mouse has been pressed, and should be considered "down" - * until mouseReleased() is called. If you must, use + * The mousePressed() function is called once after every time a mouse button is pressed. The mouseButton variable (see the related reference entry) can be used to determine which button has been pressed. + * =advanced + * + * If you must, use * int button = mouseEvent.getButton(); * to figure out which button was clicked. It will be one of: * MouseEvent.BUTTON1, MouseEvent.BUTTON2, MouseEvent.BUTTON3 * Note, however, that this is completely inconsistent across * platforms. + * @webref input:mouse + * @see PApplet#mouseX + * @see PApplet#mouseY + * @see PApplet#mousePressed + * @see PApplet#mouseReleased() + * @see PApplet#mouseMoved() + * @see PApplet#mouseDragged() */ public void mousePressed() { } /** - * Mouse button has been released. + * The mouseReleased() function is called every time a mouse button is released. + * @webref input:mouse + * @see PApplet#mouseX + * @see PApplet#mouseY + * @see PApplet#mousePressed + * @see PApplet#mousePressed() + * @see PApplet#mouseMoved() + * @see PApplet#mouseDragged() */ public void mouseReleased() { } /** + * The mouseClicked() function is called once after a mouse button has been pressed and then released. + * =advanced * When the mouse is clicked, mousePressed() will be called, * then mouseReleased(), then mouseClicked(). Note that * mousePressed is already false inside of mouseClicked(). + * @webref input:mouse + * @see PApplet#mouseX + * @see PApplet#mouseY + * @see PApplet#mouseButton + * @see PApplet#mousePressed() + * @see PApplet#mouseReleased() + * @see PApplet#mouseMoved() + * @see PApplet#mouseDragged() */ public void mouseClicked() { } /** - * Mouse button is pressed and the mouse has been dragged. + * The mouseDragged() function is called once every time the mouse moves and a mouse button is pressed. + * @webref input:mouse + * @see PApplet#mouseX + * @see PApplet#mouseY + * @see PApplet#mousePressed + * @see PApplet#mousePressed() + * @see PApplet#mouseReleased() + * @see PApplet#mouseMoved() */ public void mouseDragged() { } /** - * Mouse button is not pressed but the mouse has changed locations. + * The mouseMoved() function is called every time the mouse moves and a mouse button is not pressed. + * @webref input:mouse + * @see PApplet#mouseX + * @see PApplet#mouseY + * @see PApplet#mousePressed + * @see PApplet#mousePressed() + * @see PApplet#mouseReleased() + * @see PApplet#mouseDragged() */ public void mouseMoved() { } @@ -1801,6 +2010,15 @@ public class PApplet extends Applet /** + * + * The keyPressed() function is called once every time a key is pressed. The key that was pressed is stored in the key variable. + *

For non-ASCII keys, use the keyCode 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 the key variable instead of keyCode + * If you're making 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 configured. + * =advanced + * * Called each time a single key on the keyboard is pressed. * Because of how operating systems handle key repeats, holding * down a key will cause multiple calls to keyPressed(), because @@ -1846,12 +2064,23 @@ public class PApplet extends Applet * Java 1.1 (Microsoft VM) passes the TAB key through normally. * Not tested on other platforms or for 1.3. * + * @see PApplet#key + * @see PApplet#keyCode + * @see PApplet#keyPressed + * @see PApplet#keyReleased() + * @webref input:keyboard */ public void keyPressed() { } /** - * See keyPressed(). + * The keyReleased() function is called once every time a key is released. The key that was released will be stored in the key variable. See key and keyReleased for more information. + * + * @see PApplet#key + * @see PApplet#keyCode + * @see PApplet#keyPressed + * @see PApplet#keyPressed() + * @webref input:keyboard */ public void keyReleased() { } @@ -1892,48 +2121,108 @@ public class PApplet extends Applet /** - * Get the number of milliseconds since the applet started. + * Returns the number of milliseconds (thousandths of a second) since starting an applet. This information is often used for timing animation sequences. + * + * =advanced *

* This is a function, rather than a variable, because it may * change multiple times per frame. + * + * @webref input:time_date + * @see processing.core.PApplet#second() + * @see processing.core.PApplet#minute() + * @see processing.core.PApplet#hour() + * @see processing.core.PApplet#day() + * @see processing.core.PApplet#month() + * @see processing.core.PApplet#year() + * */ public int millis() { return (int) (System.currentTimeMillis() - millisOffset); } - /** Seconds position of the current time. */ + /** Seconds position of the current time. + * + * @webref input:time_date + * @see processing.core.PApplet#millis() + * @see processing.core.PApplet#minute() + * @see processing.core.PApplet#hour() + * @see processing.core.PApplet#day() + * @see processing.core.PApplet#month() + * @see processing.core.PApplet#year() + * */ static public int second() { return Calendar.getInstance().get(Calendar.SECOND); } - /** Minutes position of the current time. */ + /** + * Processing communicates with the clock on your computer. The minute() function returns the current minute as a value from 0 - 59. + * + * @webref input:time_date + * @see processing.core.PApplet#millis() + * @see processing.core.PApplet#second() + * @see processing.core.PApplet#hour() + * @see processing.core.PApplet#day() + * @see processing.core.PApplet#month() + * @see processing.core.PApplet#year() + * + * */ static public int minute() { return Calendar.getInstance().get(Calendar.MINUTE); } /** + * Processing communicates with the clock on your computer. The hour() function returns the current hour as a value from 0 - 23. + * =advanced * Hour position of the current time in international format (0-23). *

* To convert this value to American time:
* 

int yankeeHour = (hour() % 12);
    * if (yankeeHour == 0) yankeeHour = 12;
+ * + * @webref input:time_date + * @see processing.core.PApplet#millis() + * @see processing.core.PApplet#second() + * @see processing.core.PApplet#minute() + * @see processing.core.PApplet#day() + * @see processing.core.PApplet#month() + * @see processing.core.PApplet#year() + * */ static public int hour() { return Calendar.getInstance().get(Calendar.HOUR_OF_DAY); } /** + * Processing communicates with the clock on your computer. The day() function returns the current day as a value from 1 - 31. + * =advanced * Get the current day of the month (1 through 31). *

* If you're looking for the day of the week (M-F or whatever) * or day of the year (1..365) then use java's Calendar.get() + * + * @webref input:time_date + * @see processing.core.PApplet#millis() + * @see processing.core.PApplet#second() + * @see processing.core.PApplet#minute() + * @see processing.core.PApplet#hour() + * @see processing.core.PApplet#month() + * @see processing.core.PApplet#year() */ static public int day() { return Calendar.getInstance().get(Calendar.DAY_OF_MONTH); } /** - * Get the current month in range 1 through 12. + * Processing communicates with the clock on your computer. The month() function returns the current month as a value from 1 - 12. + * + * @webref input:time_date + * @see processing.core.PApplet#millis() + * @see processing.core.PApplet#second() + * @see processing.core.PApplet#minute() + * @see processing.core.PApplet#hour() + * @see processing.core.PApplet#day() + * @see processing.core.PApplet#year() */ static public int month() { // months are number 0..11 so change to colloquial 1..12 @@ -1941,7 +2230,16 @@ public class PApplet extends Applet } /** - * Get the current year. + * Processing communicates with the clock on your computer. + * The year() function returns the current year as an integer (2003, 2004, 2005, etc). + * + * @webref input:time_date + * @see processing.core.PApplet#millis() + * @see processing.core.PApplet#second() + * @see processing.core.PApplet#minute() + * @see processing.core.PApplet#hour() + * @see processing.core.PApplet#day() + * @see processing.core.PApplet#month() */ static public int year() { return Calendar.getInstance().get(Calendar.YEAR); @@ -1978,12 +2276,20 @@ public class PApplet extends Applet /** + * Specifies the number of frames to be displayed every second. + * If the processor is not fast enough to maintain the specified rate, it will not be achieved. + * For example, the function call frameRate(30) will attempt to refresh 30 times a second. + * It is recommended to set the frame rate within setup(). The default rate is 60 frames per second. + * =advanced * Set a target frameRate. This will cause delay() to be called * after each frame so that the sketch synchronizes to a particular speed. * Note that this only sets the maximum frame rate, it cannot be used to * make a slow sketch go faster. Sketches have no default frame rate * setting, and will attempt to use maximum processor power to achieve * maximum speed. + * @webref environment + * @param newRateTarget number of frames per second + * @see PApplet#delay(int) */ public void frameRate(float newRateTarget) { frameRateTarget = newRateTarget; @@ -1995,8 +2301,16 @@ public class PApplet extends Applet /** - * Get a param from the web page, or (eventually) - * from a properties file. + * Reads the value of a param. + * Values are always read as a String so if you want them to be an integer or other datatype they must be converted. + * The param() function will only work in a web browser. + * The function should be called inside setup(), + * otherwise the applet may not yet be initialized and connected to its parent web browser. + * + * @webref input:web + * @usage Web + * + * @param what name of the param to read */ public String param(String what) { if (online) { @@ -2010,9 +2324,16 @@ public class PApplet extends Applet /** + * Displays message in the browser's status area. This is the text area in the lower left corner of the browser. + * The status() function will only work when the Processing program is running in a web browser. + * =advanced * Show status in the status bar of a web browser, or in the * System.out console. Eventually this might show status in the * p5 environment itself, rather than relying on the console. + * + * @webref input:web + * @usage Web + * @param what any valid String */ public void status(String what) { if (online) { @@ -2030,6 +2351,8 @@ public class PApplet extends Applet /** + * Links to a webpage either in the same window or in a new window. The complete URL must be specified. + * =advanced * Link to an external page without all the muss. *

* When run with an applet, uses the browser to open the url, @@ -2039,6 +2362,11 @@ public class PApplet extends Applet * 

open(new String[] { "firefox", url });
* or whatever you want as your browser, since Linux doesn't * yet have a standard method for launching URLs. + * + * @webref input:web + * @param url complete url as a String in quotes + * @param frameTitle name of the window to load the URL as a string in quotes + * */ public void link(String url, String frameTitle) { if (online) { @@ -2076,9 +2404,12 @@ public class PApplet extends Applet } else if (platform == MACOSX) { //com.apple.mrj.MRJFileUtils.openURL(url); try { - Class mrjFileUtils = Class.forName("com.apple.mrj.MRJFileUtils"); +// Class mrjFileUtils = Class.forName("com.apple.mrj.MRJFileUtils"); +// Method openMethod = +// mrjFileUtils.getMethod("openURL", new Class[] { String.class }); + Class eieio = Class.forName("com.apple.eio.FileManager"); Method openMethod = - mrjFileUtils.getMethod("openURL", new Class[] { String.class }); + eieio.getMethod("openURL", new Class[] { String.class }); openMethod.invoke(null, new Object[] { url }); } catch (Exception e) { e.printStackTrace(); @@ -2097,7 +2428,19 @@ public class PApplet extends Applet /** - * Attempt to open a file using the platform's shell. + * Attempts to open an application or file using your platform's launcher. The file parameter is a String specifying the file name and location. The location parameter must be a full path name, or the name of an executable in the system's PATH. In most cases, using a full path is the best option, rather than relying on the system PATH. Be sure to make the file executable before attempting to open it (chmod +x). + *

+ * The args 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, open("jikes -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 exec(String[]) function is a shortcut for Runtime.getRuntime.exec(String[]). + * + * @webref input:files + * @param filename name of the file + * @usage Application */ static public void open(String filename) { open(new String[] { filename }); @@ -2111,6 +2454,8 @@ public class PApplet extends Applet * to make it easier to deal with spaces in the individual elements. * (This avoids the situation of trying to put single or double quotes * around different bits). + * + * @param list of commands passed to the command line */ static public Process open(String argv[]) { String[] params = null; @@ -2397,6 +2742,7 @@ public class PApplet extends Applet /** * Set the cursor type + * @param cursorType either ARROW, CROSS, HAND, MOVE, TEXT, WAIT */ public void cursor(int cursorType) { setCursor(Cursor.getPredefinedCursor(cursorType)); @@ -2415,6 +2761,11 @@ public class PApplet extends Applet /** + * Sets the cursor to a predefined symbol, an image, or turns it on if already hidden. + * If you are trying to set an image as the cursor, it is recommended to make the size 16x16 or 32x32 pixels. + * It is not possible to load an image as the cursor if you are exporting your program for the Web. + * The values for parameters x and y must be less than the dimensions of the image. + * =advanced * Set a custom cursor to an image with a specific hotspot. * Only works with JDK 1.2 and later. * Currently seems to be broken on Java 1.4 for Mac OS X @@ -2422,6 +2773,11 @@ public class PApplet extends Applet * Based on code contributed by Amit Pitaru, plus additional * code to handle Java versions via reflection by Jonathan Feinberg. * Reflection removed for release 0128 and later. + * @webref environment + * @see PApplet#noCursor() + * @param image any variable of type PImage + * @param hotspotX the horizonal active spot of the cursor + * @param hotspotY the vertical active spot of the cursor */ public void cursor(PImage image, int hotspotX, int hotspotY) { // don't set this as cursor type, instead use cursor_type @@ -2455,8 +2811,13 @@ public class PApplet extends Applet /** + * Hides the cursor from view. Will not work when running the program in a web browser. + * =advanced * Hide the cursor by creating a transparent image * and using it as a custom cursor. + * @webref environment + * @see PApplet#cursor() + * @usage Application */ public void noCursor() { if (!cursorVisible) return; // don't hide if already hidden. @@ -3229,12 +3590,27 @@ public class PApplet extends Applet /** + * Loads an image into a variable of type PImage. Four types of images ( .gif, .jpg, .tga, .png) images may be loaded. To load correctly, images must be located in the data directory of the current sketch. In most cases, load all images in setup() to preload them at the start of the program. Loading images inside draw() will reduce the speed of a program. + *

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 signed applet. + *

The extension parameter is used to determine the image type in cases where the image filename does not end with a proper extension. Specify the extension as the second parameter to loadImage(), as shown in the third example on this page. + *

If an image is not loaded successfully, the null value is 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 from loadImage() is null.

Depending on the type of error, a PImage object may still be returned, but the width and height of the image will be set to -1. This happens if bad image data is returned or cannot be decoded properly. Sometimes this happens with image URLs that produce a 403 error or that redirect to a password prompt, because loadImage() will attempt to interpret the HTML as image data. + * + * =advanced * Identical to loadImage, but allows you to specify the type of * image by its extension. Especially useful when downloading from * CGI scripts. *

* Use 'unknown' as the extension to pass off to the default * image loader that handles gif, jpg, and png. + * + * @webref image:loading_displaying + * @param filename name of file to load, can be .gif, .jpg, .tga, or a handful of other image types depending on your platform. + * @param extension the type of image to load, for example "png", "gif", "jpg" + * + * @see processing.core.PImage + * @see processing.core.PApplet#image(PImage, float, float, float, float) + * @see processing.core.PApplet#imageMode(int) + * @see processing.core.PApplet#background(float, float, float) */ public PImage loadImage(String filename, String extension) { if (extension == null) { @@ -3315,12 +3691,22 @@ public class PApplet extends Applet return null; } - public PImage requestImage(String filename) { return requestImage(filename, null); } + /** + * This function load images on a separate thread so that your sketch does not freeze while images load during setup(). While the image is loading, its width and height will be 0. If an error occurs while loading the image, its width and height will be set to -1. You'll know when the image has loaded properly because its width and height will be greater than 0. Asynchronous image loading (particularly when downloading from a server) can dramatically improve performance.

+ * The extension parameter is used to determine the image type in cases where the image filename does not end with a proper extension. Specify the extension as the second parameter to requestImage(). + * + * @webref image:loading_displaying + * @param filename name of file to load, can be .gif, .jpg, .tga, or a handful of other image types depending on your platform + * @param extension the type of image to load, for example "png", "gif", "jpg" + * + * @see processing.core.PApplet#loadImage(String, String) + * @see processing.core.PImage + */ public PImage requestImage(String filename, String extension) { PImage vessel = createImage(0, 0, ARGB); AsyncImageLoader ail = @@ -3638,7 +4024,21 @@ public class PApplet extends Applet /** - * Load a geometry from a file as a PShape. Currently only supports SVG data. + * Loads vector shapes into a variable of type PShape. Currently, only SVG files may be loaded. + * To load correctly, the file must be located in the data directory of the current sketch. + * In most cases, loadShape() should be used inside setup() because loading shapes inside draw() will reduce the speed of a sketch. + *

+ * 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 signed applet. + *

+ * If a shape is not loaded successfully, the null value is 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 from loadShape() is null. + * + * @webref shape:loading_displaying + * @see PShape + * @see PApplet#shape(PShape) + * @see PApplet#shapeMode(int) */ public PShape loadShape(String filename) { if (filename.toLowerCase().endsWith(".svg")) { @@ -3668,13 +4068,25 @@ public class PApplet extends Applet } + /** + * Used by PGraphics to remove the requirement for loading a font! + */ + protected PFont createDefaultFont(float size) { +// Font f = new Font("SansSerif", Font.PLAIN, 12); +// println("n: " + f.getName()); +// println("fn: " + f.getFontName()); +// println("ps: " + f.getPSName()); + return createFont("SansSerif", size, true, null); + } + + public PFont createFont(String name, float size) { - return createFont(name, size, true, PFont.DEFAULT_CHARSET); + return createFont(name, size, true, null); } public PFont createFont(String name, float size, boolean smooth) { - return createFont(name, size, smooth, PFont.DEFAULT_CHARSET); + return createFont(name, size, smooth, null); } @@ -3683,8 +4095,8 @@ public class PApplet extends Applet * installed on the system, or from a .ttf or .otf that's inside * the data folder of this sketch. *

- * Only works with Java 1.3 or later. Many .otf fonts don't seem - * to be supported by Java, perhaps because they're CFF based? + * Many .otf fonts don't seem to be supported by Java, perhaps because + * they're CFF based? *

* Font names are inconsistent across platforms and Java versions. * On Mac OS X, Java 1.3 uses the font menu name of the font, @@ -3693,9 +4105,9 @@ public class PApplet extends Applet * it appears that only the menu names are used, no matter what * Java version is in use. Naming system unknown/untested for 1.5. *

- * Use 'null' for the charset if you want to use any of the 65,536 - * unicode characters that exist in the font. Note that this can - * produce an enormous file or may cause an OutOfMemoryError. + * Use 'null' for the charset if you want to dynamically create + * character bitmaps only as they're needed. (Version 1.0.9 and + * earlier would interpret null as all unicode characters.) */ public PFont createFont(String name, float size, boolean smooth, char charset[]) { @@ -3703,8 +4115,9 @@ public class PApplet extends Applet Font baseFont = null; try { + InputStream stream = null; if (lowerName.endsWith(".otf") || lowerName.endsWith(".ttf")) { - InputStream stream = createInput(name); + stream = createInput(name); if (stream == null) { System.err.println("The font \"" + name + "\" " + "is missing or inaccessible, make sure " + @@ -3715,14 +4128,16 @@ public class PApplet extends Applet baseFont = Font.createFont(Font.TRUETYPE_FONT, createInput(name)); } else { - //baseFont = new Font(name, Font.PLAIN, 1); baseFont = PFont.findFont(name); } + return new PFont(baseFont.deriveFont(size), smooth, charset, + stream != null); + } catch (Exception e) { - System.err.println("Problem using createFont() with " + name); + System.err.println("Problem createFont(" + name + ")"); e.printStackTrace(); + return null; } - return new PFont(baseFont.deriveFont(size), smooth, charset); } @@ -3764,9 +4179,14 @@ public class PApplet extends Applet /** - * Open a platform-specific file chooser dialog to select a file for input. - * @param prompt Mesage to show the user when prompting for a file. + * Opens a platform-specific file chooser dialog to select a file for input. This function returns the full path to the selected file as a String, or null if no selection. + * + * @webref input:files + * @param prompt message you want the user to see in the file chooser * @return full path to the selected file, or null if canceled. + * + * @see processing.core.PApplet#selectOutput(String) + * @see processing.core.PApplet#selectFolder(String) */ public String selectInput(String prompt) { return selectFileImpl(prompt, FileDialog.LOAD); @@ -3783,9 +4203,17 @@ public class PApplet extends Applet /** - * Open a platform-specific file save dialog to select a file for output. - * @param prompt Mesage to show the user when prompting for a file. + * Open a platform-specific file save dialog to create of select a file for output. + * This function returns the full path to the selected file as a String, or null if no selection. + * If you select an existing file, that file will be replaced. + * Alternatively, you can navigate to a folder and create a new file to write to. + * + * @param prompt message you want the user to see in the file chooser * @return full path to the file entered, or null if canceled. + * + * @webref input:files + * @see processing.core.PApplet#selectInput(String) + * @see processing.core.PApplet#selectFolder(String) */ public String selectOutput(String prompt) { return selectFileImpl(prompt, FileDialog.SAVE); @@ -3816,19 +4244,21 @@ public class PApplet extends Applet } - /** - * Open a platform-specific folder chooser dialog. - * @return full path to the selected folder, or null if no selection. - */ public String selectFolder() { return selectFolder("Select a folder..."); } /** - * Open a platform-specific folder chooser dialog. - * @param prompt Mesage to show the user when prompting for a file. + * Opens a platform-specific file chooser dialog to select a folder for input. + * This function returns the full path to the selected folder as a String, or null if no selection. + * + * @webref input:files + * @param prompt message you want the user to see in the file chooser * @return full path to the selected folder, or null if no selection. + * + * @see processing.core.PApplet#selectOutput(String) + * @see processing.core.PApplet#selectInput(String) */ public String selectFolder(final String prompt) { checkParentFrame(); @@ -3997,6 +4427,18 @@ public class PApplet extends Applet /** + * This is a method for advanced programmers to open a Java InputStream. The method is useful if you want to use the facilities provided by PApplet to easily open files from the data folder or from a URL, but want an InputStream object so that you can use other Java methods to take more control of how the stream is read. + *

If the requested item doesn't exist, null is returned. + *

In earlier releases, this method was called openStream(). + *

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 will be printed to the console. This helps prevent issues that appear 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. + *

The filename passed in can be:
+ * - A URL, for instance openStream("http://processing.org/");
+ * - A file in the sketch's data folder
+ * - The full path to a file to be opened locally (when running as an application) + *

+ * If the file ends with .gz, the stream will automatically be gzip decompressed. If you don't want the automatic decompression, use the related function createInputRaw(). + * + * =advanced * Simplified method to open a Java InputStream. *

* This method is useful if you want to use the facilities provided @@ -4026,6 +4468,14 @@ public class PApplet extends Applet *

  • A file in the sketch's data folder *
  • Another file to be opened locally (when running as an application) * + * + * @webref input:files + * @see processing.core.PApplet#createOutput(String) + * @see processing.core.PApplet#selectOutput(String) + * @see processing.core.PApplet#selectInput(String) + * + * @param filename the name of the file to use as input + * */ public InputStream createInput(String filename) { InputStream input = createInputRaw(filename); @@ -4057,24 +4507,26 @@ public class PApplet extends Applet // safe to check for this as a url first. this will prevent online // access logs from being spammed with GET /sketchfolder/http://blahblah - try { - URL url = new URL(filename); - stream = url.openStream(); - return stream; + if (filename.indexOf(":") != -1) { // at least smells like URL + try { + URL url = new URL(filename); + stream = url.openStream(); + return stream; - } catch (MalformedURLException mfue) { - // not a url, that's fine + } catch (MalformedURLException mfue) { + // not a url, that's fine - } catch (FileNotFoundException fnfe) { - // Java 1.5 likes to throw this when URL not available. (fix for 0119) - // http://dev.processing.org/bugs/show_bug.cgi?id=403 + } catch (FileNotFoundException fnfe) { + // Java 1.5 likes to throw this when URL not available. (fix for 0119) + // http://dev.processing.org/bugs/show_bug.cgi?id=403 - } catch (IOException e) { - // changed for 0117, shouldn't be throwing exception - e.printStackTrace(); - //System.err.println("Error downloading from URL " + filename); - return null; - //throw new RuntimeException("Error downloading from URL " + filename); + } catch (IOException e) { + // changed for 0117, shouldn't be throwing exception + e.printStackTrace(); + //System.err.println("Error downloading from URL " + filename); + return null; + //throw new RuntimeException("Error downloading from URL " + filename); + } } // Moved this earlier than the getResourceAsStream() checks, because @@ -4181,6 +4633,9 @@ public class PApplet extends Applet static public InputStream createInput(File file) { + if (file == null) { + throw new IllegalArgumentException("File passed to createInput() was null"); + } try { InputStream input = new FileInputStream(file); if (file.getName().toLowerCase().endsWith(".gz")) { @@ -4189,18 +4644,25 @@ public class PApplet extends Applet return input; } catch (IOException e) { - if (file == null) { - throw new RuntimeException("File passed to openStream() was null"); - - } else { - e.printStackTrace(); - throw new RuntimeException("Couldn't openStream() for " + - file.getAbsolutePath()); - } + System.err.println("Could not createInput() for " + file); + e.printStackTrace(); + return null; } } + /** + * 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 restriction requires a signed applet. + * + * @webref input:files + * @param filename name of a file in the data folder or a URL. + * + * @see processing.core.PApplet#loadStrings(String) + * @see processing.core.PApplet#saveStrings(String, String[]) + * @see processing.core.PApplet#saveBytes(String, byte[]) + * + */ public byte[] loadBytes(String filename) { InputStream is = createInput(filename); if (is != null) return loadBytes(is); @@ -4247,6 +4709,12 @@ public class PApplet extends Applet /** + * 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 signed applet. + *

    If the file is not available or an error occurs, null 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 are moved to other platforms. + * + * =advanced * Load data from a file and shove it into a String array. *

    * Exceptions are handled internally, when an error, occurs, an @@ -4257,6 +4725,13 @@ public class PApplet extends Applet * of new users (or people who are just trying to get things done * in a "scripting" fashion. If you want to handle exceptions, * use Java methods for I/O. + * + * @webref input:files + * @param filename name of the file or url to load + * + * @see processing.core.PApplet#loadBytes(String) + * @see processing.core.PApplet#saveStrings(String, String[]) + * @see processing.core.PApplet#saveBytes(String, byte[]) */ public String[] loadStrings(String filename) { InputStream is = createInput(filename); @@ -4491,10 +4966,10 @@ public class PApplet extends Applet static public void saveStrings(OutputStream output, String strings[]) { PrintWriter writer = createWriter(output); - for (int i = 0; i < strings.length; i++) { - writer.println(strings[i]); - } - writer.flush(); + for (int i = 0; i < strings.length; i++) { + writer.println(strings[i]); + } + writer.flush(); writer.close(); } @@ -6320,6 +6795,8 @@ public class PApplet extends Applet /** * As of 0116 this also takes color(#FF8800, alpha) + * + * @param gray number specifying value between white and black */ public final int color(int gray, int alpha) { if (g == null) { @@ -6384,7 +6861,18 @@ public class PApplet extends Applet return g.color(x, y, z, a); } - + /** + * Creates colors for storing in variables of the color datatype. The parameters are interpreted as RGB or HSB values depending on the current colorMode(). The default mode is RGB values from 0 to 255 and therefore, the function call color(255, 204, 0) will return a bright yellow color. More about how colors are stored can be found in the reference for the color datatype. + * + * @webref color:creating_reading + * @param x red or hue values relative to the current color range + * @param y green or saturation values relative to the current color range + * @param z blue or brightness values relative to the current color range + * @param a alpha relative to current color range + * + * @see processing.core.PApplet#colorMode(int) + * @ref color_datatype + */ public final int color(float x, float y, float z, float a) { if (g == null) { if (a > 255) a = 255; else if (a < 0) a = 0; @@ -6544,7 +7032,7 @@ public class PApplet extends Applet if (platform == MACOSX) { // Only run this on OS X otherwise it can cause a permissions error. // http://dev.processing.org/bugs/show_bug.cgi?id=976 - System.setProperty("apple.awt.graphics.UseQuartz", "true"); + System.setProperty("apple.awt.graphics.UseQuartz", useQuartz); } // This doesn't do anything. @@ -6709,6 +7197,7 @@ public class PApplet extends Applet frame.setBackground(backgroundColor); if (exclusive) { displayDevice.setFullScreenWindow(frame); + frame.setExtendedState(java.awt.Frame.MAXIMIZED_BOTH); fullScreenRect = frame.getBounds(); } else { DisplayMode mode = displayDevice.getDisplayMode(); @@ -6933,16 +7422,33 @@ public class PApplet extends Applet /** + * Loads the pixel data for the display window into the pixels[] array. This function must always be called before reading from or writing to pixels[]. + *

    Certain renderers may or may not seem to require loadPixels() or updatePixels(). However, the rule is that any time you want to manipulate the pixels[] array, you must first call loadPixels(), and after changes have been made, call updatePixels(). Even if the renderer may not seem to use this function in the current Processing release, this will always be subject to change. + * =advanced * Override the g.pixels[] function to set the pixels[] array * that's part of the PApplet object. Allows the use of * pixels[] in the code, rather than g.pixels[]. + * + * @webref image:pixels + * @see processing.core.PApplet#pixels + * @see processing.core.PApplet#updatePixels() */ public void loadPixels() { g.loadPixels(); pixels = g.pixels; } - + /** + * Updates the display window with the data in the pixels[] array. Use in conjunction with loadPixels(). If you're only reading pixels from the array, there's no need to call updatePixels() unless there are changes. + *

    Certain renderers may or may not seem to require loadPixels() or updatePixels(). However, the rule is that any time you want to manipulate the pixels[] array, you must first call loadPixels(), and after changes have been made, call updatePixels(). 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 updatePixels(), however this may be implemented in the future. + * + * @webref image:pixels + * + * @see processing.core.PApplet#loadPixels() + * @see processing.core.PApplet#updatePixels() + * + */ public void updatePixels() { g.updatePixels(); } @@ -6955,7 +7461,10 @@ public class PApplet extends Applet ////////////////////////////////////////////////////////////// - // everything below this line is automatically generated. no touch. + // EVERYTHING BELOW THIS LINE IS AUTOMATICALLY GENERATED. DO NOT TOUCH! + // This includes the Javadoc comments, which are automatically copied from + // the PImage and PGraphics source code files. + // public functions for processing.core @@ -7428,7 +7937,7 @@ public class PApplet extends Applet } - public void text(char[] chars, int start, int stop, + public void text(char[] chars, int start, int stop, float x, float y, float z) { if (recorder != null) recorder.text(chars, start, stop, x, y, z); g.text(chars, start, stop, x, y, z); @@ -8177,15 +8686,15 @@ public class PApplet extends Applet } - public void mask(int alpha[]) { - if (recorder != null) recorder.mask(alpha); - g.mask(alpha); + public void mask(int maskArray[]) { + if (recorder != null) recorder.mask(maskArray); + g.mask(maskArray); } - public void mask(PImage alpha) { - if (recorder != null) recorder.mask(alpha); - g.mask(alpha); + public void mask(PImage maskImg) { + if (recorder != null) recorder.mask(maskImg); + g.mask(maskImg); } diff --git a/core/src/processing/core/PConstants.java b/core/src/processing/core/PConstants.java index 24f0b9fa8..f1eae5882 100644 --- a/core/src/processing/core/PConstants.java +++ b/core/src/processing/core/PConstants.java @@ -34,6 +34,8 @@ import java.awt.event.KeyEvent; * 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 & Application */ public interface PConstants { @@ -158,11 +160,52 @@ public interface PConstants { // useful goodness - + + /** + * 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 sin() and cos(). + * + * @webref constants + * @see processing.core.PConstants#HALF_PI + * @see processing.core.PConstants#TWO_PI + * @see processing.core.PConstants#QUARTER_PI + * + */ static final float PI = (float) Math.PI; + /** + * 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 sin() and cos(). + * + * @webref constants + * @see processing.core.PConstants#PI + * @see processing.core.PConstants#TWO_PI + * @see processing.core.PConstants#QUARTER_PI + */ static final float HALF_PI = PI / 2.0f; static final float THIRD_PI = PI / 3.0f; + /** + * 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 sin() and cos(). + * + * @webref constants + * @see processing.core.PConstants#PI + * @see processing.core.PConstants#TWO_PI + * @see processing.core.PConstants#HALF_PI + */ static final float QUARTER_PI = PI / 4.0f; + /** + * 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 sin() and cos(). + * + * @webref constants + * @see processing.core.PConstants#PI + * @see processing.core.PConstants#HALF_PI + * @see processing.core.PConstants#QUARTER_PI + */ static final float TWO_PI = PI * 2.0f; static final float DEG_TO_RAD = PI/180.0f; diff --git a/core/src/processing/core/PFont.java b/core/src/processing/core/PFont.java index 74da5cb18..421cfb09e 100644 --- a/core/src/processing/core/PFont.java +++ b/core/src/processing/core/PFont.java @@ -3,13 +3,12 @@ /* Part of the Processing project - http://processing.org - Copyright (c) 2004-07 Ben Fry & Casey Reas + Copyright (c) 2004-10 Ben Fry & 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. + modify it under the terms of version 2.01 of the GNU Lesser General + Public License as published by the Free Software Foundation. This library is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of @@ -25,17 +24,16 @@ package processing.core; import java.awt.*; -import java.awt.image.BufferedImage; -import java.awt.image.Raster; +import java.awt.image.*; import java.io.*; -//import java.lang.reflect.*; import java.util.Arrays; +import java.util.HashMap; /** * Grayscale bitmap font class used by Processing. *

    - * Awful (and by that, I mean awesome) ascii (non)art for how this works: + * Awful (and by that, I mean awesome) ASCII (non-)art for how this works: * 

      *   |
  *   |                   height is the full used height of the image
@@ -56,8 +54,60 @@ import java.util.Arrays;
  */
 public class PFont implements PConstants {
 
-  public int charCount;
-  public PImage images[];
+  /** Number of character glyphs in this font. */
+  protected int glyphCount;
+  
+  /** 
+   * Actual glyph data. The length of this array won't necessarily be the 
+   * same size as glyphCount, in cases where lazy font loading is in use.
+   */
+  protected Glyph[] glyphs;
+
+  /**
+   * Name of the font as seen by Java when it was created.
+   * If the font is available, the native version will be used.
+   */
+  protected String name;
+
+  /** 
+   * Postscript name of the font that this bitmap was created from.
+   */
+  protected String psname;
+
+  /** 
+   * The original size of the font when it was first created 
+   */
+  protected int size;
+
+  /** true if smoothing was enabled for this font, used for native impl */
+  protected boolean smooth;
+
+  /** 
+   * The ascent of the font. If the 'd' character is present in this PFont, 
+   * this value is replaced with its pixel height, because the values returned
+   * by FontMetrics.getAscent() seem to be terrible. 
+   */
+  protected int ascent;
+  
+  /** 
+   * The descent of the font. If the 'p' character is present in this PFont, 
+   * this value is replaced with its lowest pixel height, because the values 
+   * returned by FontMetrics.getDescent() are gross. 
+   */
+  protected int descent;
+
+  /**
+   * A more efficient array lookup for straight ASCII characters. For Unicode
+   * characters, a QuickSort-style search is used. 
+   */
+  protected int[] ascii;
+
+  /**
+   * True if this font is set to load dynamically. This is the default when 
+   * createFont() method is called without a character set. Bitmap versions of 
+   * characters are only created when prompted by an index() call.
+   */
+  protected boolean lazy;
 
   /**
    * Native Java version of the font. If possible, this allows the
@@ -65,70 +115,179 @@ public class PFont implements PConstants {
    * in situations where that's faster.
    */
   protected Font font;
+
+  /** True if this font was loaded from a stream, rather than from the OS. */
+  protected boolean stream;
+  
+  /** 
+   * True if we've already tried to find the native AWT version of this font.
+   */
   protected boolean fontSearched;
 
   /**
-   * Name of the font as seen by Java when it was created.
-   * If the font is available, the native version will be used.
+   * Array of the native system fonts. Used to lookup native fonts by their 
+   * PostScript name. This is a workaround for a several year old Apple Java
+   * bug that they can't be bothered to fix. 
    */
-  public String name;
-
-  /**
-   * Postscript name of the font that this bitmap was created from.
-   */
-  public String psname;
-
-  /** "natural" size of the font (most often 48) */
-  public int size;
-
-  /** true if smoothing was enabled for this font, used for native impl */
-  public boolean smooth;
-
-  /** next power of 2 over the max image size (usually 64) */
-  public int mbox2;
-
-  /** floating point width (convenience) */
-  protected float fwidth;
-
-  /** floating point width (convenience) */
-  protected float fheight;
-
-  /** texture width, same as mbox2, but reserved for future use */
-  public int twidth;
-
-  /** texture height, same as mbox2, but reserved for future use */
-  public int theight;
-
-  public int value[];  // char code
-  public int height[]; // height of the bitmap data
-  public int width[];  // width of bitmap data
-  public int setWidth[];  // width displaced by the char
-  public int topExtent[];  // offset for the top
-  public int leftExtent[];  // offset for the left
-
-  public int ascent;
-  public int descent;
-
-  protected int ascii[];  // quick lookup for the ascii chars
-
-  // shared by the text() functions to avoid incessant allocation of memory
-  //protected char textBuffer[] = new char[8 * 1024];
-  //protected char widthBuffer[] = new char[8 * 1024];
-  
   static protected Font[] fonts;
+  static protected HashMap fontDifferent;
+
+
+  // objects to handle creation of font characters only as they're needed
+  BufferedImage lazyImage;
+  Graphics2D lazyGraphics;
+  FontMetrics lazyMetrics;
+  int[] lazySamples;  
 
 
   public PFont() { }  // for subclasses
 
 
+  /**
+   * Create a new Processing font from a native font, but don't create all the
+   * characters at once, instead wait until they're used to include them.
+   * @param font
+   * @param smooth
+   */
+  public PFont(Font font, boolean smooth) {
+    this(font, smooth, null);
+  }
+  
+  
+  /**
+   * Create a new image-based font on the fly. If charset is set to null, 
+   * the characters will only be created as bitmaps when they're drawn.
+   *
+   * @param font the font object to create from
+   * @param charset array of all unicode chars that should be included
+   * @param smooth true to enable smoothing/anti-aliasing
+   */
+  public PFont(Font font, boolean smooth, char charset[]) {
+    // save this so that we can use the native version
+    this.font = font;
+    this.smooth = smooth;
+
+    name = font.getName();
+    psname = font.getPSName();
+    size = font.getSize();
+
+    // no, i'm not interested in getting off the couch
+    lazy = true;
+    // not sure what else to do here
+    //mbox2 = 0; 
+
+    int initialCount = 10;
+    glyphs = new Glyph[initialCount];
+
+    ascii = new int[128];
+    Arrays.fill(ascii, -1);
+
+    int mbox3 = size * 3;
+
+    lazyImage = new BufferedImage(mbox3, mbox3, BufferedImage.TYPE_INT_RGB);
+    lazyGraphics = (Graphics2D) lazyImage.getGraphics();
+    lazyGraphics.setRenderingHint(RenderingHints.KEY_ANTIALIASING,
+                                  smooth ?
+                                  RenderingHints.VALUE_ANTIALIAS_ON :
+                                  RenderingHints.VALUE_ANTIALIAS_OFF);
+    // adding this for post-1.0.9
+    lazyGraphics.setRenderingHint(RenderingHints.KEY_TEXT_ANTIALIASING,
+                                  smooth ?
+                                  RenderingHints.VALUE_TEXT_ANTIALIAS_ON :
+                                  RenderingHints.VALUE_TEXT_ANTIALIAS_OFF);
+
+    lazyGraphics.setFont(font);
+    lazyMetrics = lazyGraphics.getFontMetrics();
+    lazySamples = new int[mbox3 * mbox3];
+
+    // These values are terrible/unusable. Verified again for Processing 1.1.
+    // They vary widely per-platform and per-font, so instead we'll use the 
+    // calculate-by-hand method of measuring pixels in characters.
+    //ascent = lazyMetrics.getAscent();
+    //descent = lazyMetrics.getDescent();
+
+    if (charset != null) {
+      // charset needs to be sorted to make index lookup run more quickly
+      // http://dev.processing.org/bugs/show_bug.cgi?id=494
+      Arrays.sort(charset);
+
+      glyphs = new Glyph[charset.length];
+
+      glyphCount = 0;
+      for (char c : charset) {
+        if (font.canDisplay(c)) {
+          glyphs[glyphCount++] = new Glyph(c);
+        }
+      }
+
+      // shorten the array if necessary
+      if (glyphCount != charset.length) {
+        glyphs = (Glyph[]) PApplet.subset(glyphs, 0, glyphCount);
+      }
+
+      // foreign font, so just make ascent the max topExtent
+      // for > 1.0.9, not doing this anymore. 
+      // instead using getAscent() and getDescent() values for these cases.
+//      if ((ascent == 0) && (descent == 0)) {
+//        //for (int i = 0; i < charCount; i++) {
+//        for (Glyph glyph : glyphs) {
+//          char cc = (char) glyph.value;
+//          //char cc = (char) glyphs[i].value;
+//          if (Character.isWhitespace(cc) ||
+//              (cc == '\u00A0') || (cc == '\u2007') || (cc == '\u202F')) {
+//            continue;
+//          }
+//          if (glyph.topExtent > ascent) {
+//            ascent = glyph.topExtent;
+//          }
+//          int d = -glyph.topExtent + glyph.height;
+//          if (d > descent) {
+//            descent = d;
+//          }
+//        }
+//      }
+    }
+
+    // If not already created, just create these two characters to calculate 
+    // the ascent and descent values for the font. This was tested to only 
+    // require 5-10 ms on a 2.4 GHz MacBook Pro.
+    // In versions 1.0.9 and earlier, fonts that could not display d or p
+    // used the max up/down values as calculated by looking through the font.
+    // That's no longer valid with the auto-generating fonts, so we'll just
+    // use getAscent() and getDescent() in such (minor) cases.
+    if (ascent == 0) {
+      if (font.canDisplay('d')) {
+        new Glyph('d');
+      } else {
+        ascent = lazyMetrics.getAscent();
+      }
+    }
+    if (descent == 0) {
+      if (font.canDisplay('p')) {
+        new Glyph('p');
+      } else {
+        descent = lazyMetrics.getDescent();
+      }
+    }
+  }
+  
+
+  /**
+   * Adds an additional parameter that indicates the font came from a file, 
+   * not a built-in OS font. 
+   */
+  public PFont(Font font, boolean smooth, char charset[], boolean stream) {
+    this(font, smooth, charset);
+    this.stream = stream;
+  }
+  
+
   public PFont(InputStream input) throws IOException {
     DataInputStream is = new DataInputStream(input);
 
     // number of character images stored in this font
-    charCount = is.readInt();
+    glyphCount = is.readInt();
 
-    // bit count is ignored since this is always 8
-    //int numBits = is.readInt();
     // used to be the bitCount, but now used for version number.
     // version 8 is any font before 69, so 9 is anything from 83+
     // 9 was buggy so gonna increment to 10.
@@ -137,62 +296,28 @@ public class PFont implements PConstants {
     // this was formerly ignored, now it's the actual font size
     //mbox = is.readInt();
     size = is.readInt();
+
     // this was formerly mboxY, the one that was used
     // this will make new fonts downward compatible
-    //mbox2 = is.readInt();
-    mbox2 = is.readInt();
-
-    fwidth = size; //mbox;
-    fheight = size; //mbox;
-
-    // size for image ("texture") is next power of 2
-    // over the font size. for most vlw fonts, the size is 48
-    // so the next power of 2 is 64.
-    // double-check to make sure that mbox2 is a power of 2
-    // there was a bug in the old font generator that broke this
-    //mbox2 = (int) Math.pow(2, Math.ceil(Math.log(mbox2) / Math.log(2)));
-    mbox2 = (int) Math.pow(2, Math.ceil(Math.log(mbox2) / Math.log(2)));
-    // size for the texture is stored in the font
-    twidth = theight = mbox2; //mbox2;
+    is.readInt();  // ignore the other mbox attribute
 
     ascent  = is.readInt();  // formerly baseHt (zero/ignored)
     descent = is.readInt();  // formerly ignored struct padding
 
     // allocate enough space for the character info
-    value       = new int[charCount];
-    height      = new int[charCount];
-    width       = new int[charCount];
-    setWidth    = new int[charCount];
-    topExtent   = new int[charCount];
-    leftExtent  = new int[charCount];
+    glyphs = new Glyph[glyphCount];
 
     ascii = new int[128];
-    for (int i = 0; i < 128; i++) ascii[i] = -1;
+    Arrays.fill(ascii, -1);
 
     // read the information about the individual characters
-    for (int i = 0; i < charCount; i++) {
-      value[i]      = is.readInt();
-      height[i]     = is.readInt();
-      width[i]      = is.readInt();
-      setWidth[i]   = is.readInt();
-      topExtent[i]  = is.readInt();
-      leftExtent[i] = is.readInt();
-
-      // pointer in the c version, ignored
-      is.readInt();
-
+    for (int i = 0; i < glyphCount; i++) {
+      Glyph glyph = new Glyph(is);
       // cache locations of the ascii charset
-      if (value[i] < 128) ascii[value[i]] = i;
-
-      // the values for getAscent() and getDescent() from FontMetrics
-      // seem to be way too large.. perhaps they're the max?
-      // as such, use a more traditional marker for ascent/descent
-      if (value[i] == 'd') {
-        if (ascent == 0) ascent = topExtent[i];
-      }
-      if (value[i] == 'p') {
-        if (descent == 0) descent = -topExtent[i] + height[i];
+      if (glyph.value < 128) {
+        ascii[glyph.value] = i;
       }
+      glyphs[i] = glyph;
     }
 
     // not a roman font, so throw an error and ask to re-build.
@@ -202,29 +327,8 @@ public class PFont implements PConstants {
                                  "re-create this font.");
     }
 
-    images = new PImage[charCount];
-    for (int i = 0; i < charCount; i++) {
-      images[i] = new PImage(twidth, theight, ALPHA);
-      int bitmapSize = height[i] * width[i];
-
-      byte temp[] = new byte[bitmapSize];
-      is.readFully(temp);
-
-      // convert the bitmap to an alpha channel
-      int w = width[i];
-      int h = height[i];
-      for (int y = 0; y < h; y++) {
-        for (int x = 0; x < w; x++) {
-          int valu = temp[y*w + x] & 0xff;
-          images[i].pixels[y * twidth + x] = valu;
-          //(valu << 24) | 0xFFFFFF;  // windows
-          //0xFFFFFF00 | valu;  // macosx
-
-          //System.out.print((images[i].pixels[y*64+x] > 128) ? "*" : ".");
-        }
-        //System.out.println();
-      }
-      //System.out.println();
+    for (Glyph glyph : glyphs) {
+      glyph.readBitmap(is);
     }
 
     if (version >= 10) {  // includes the font name at the end of the file
@@ -237,6 +341,100 @@ public class PFont implements PConstants {
   }
 
 
+  /**
+   * Write this PFont to an OutputStream.
+   * 
    
+   * This is used by the Create Font tool, or whatever anyone else dreams
+   * up for messing with fonts themselves.
+   * 
    
+   * It is assumed that the calling class will handle closing
+   * the stream when finished.
+   */
+  public void save(OutputStream output) throws IOException {
+    DataOutputStream os = new DataOutputStream(output);
+
+    os.writeInt(glyphCount);
+
+    if ((name == null) || (psname == null)) {
+      name = "";
+      psname = "";
+    }
+    
+    os.writeInt(11);      // formerly numBits, now used for version number
+    os.writeInt(size);    // formerly mboxX (was 64, now 48)
+    os.writeInt(0);       // formerly mboxY, now ignored
+    os.writeInt(ascent);  // formerly baseHt (was ignored)
+    os.writeInt(descent); // formerly struct padding for c version
+
+    for (int i = 0; i < glyphCount; i++) {
+      glyphs[i].writeHeader(os);
+    }
+
+    for (int i = 0; i < glyphCount; i++) {
+      glyphs[i].writeBitmap(os);
+    }
+
+    // version 11
+    os.writeUTF(name);
+    os.writeUTF(psname);
+    os.writeBoolean(smooth);
+
+    os.flush();
+  }
+
+
+  /**
+   * Create a new glyph, and add the character to the current font.
+   * @param c character to create an image for.
+   */
+  protected void addGlyph(char c) {
+    Glyph glyph = new Glyph(c);
+
+    if (glyphCount == glyphs.length) {
+      glyphs = (Glyph[]) PApplet.expand(glyphs);
+    }
+    if (glyphCount == 0) {
+      glyphs[glyphCount] = glyph;
+      if (glyph.value < 128) {
+        ascii[glyph.value] = 0;
+      }
+      
+    } else if (glyphs[glyphCount-1].value < glyph.value) {
+      glyphs[glyphCount] = glyph;
+      if (glyph.value < 128) {
+        ascii[glyph.value] = glyphCount;
+      }
+      
+    } else {
+      for (int i = 0; i < glyphCount; i++) {
+        if (glyphs[i].value > c) {
+          for (int j = glyphCount; j > i; --j) {
+            glyphs[j] = glyphs[j-1];
+            if (glyphs[j].value < 128) {
+              ascii[glyphs[j].value] = j;
+            }
+          }
+          glyphs[i] = glyph;
+          // cache locations of the ascii charset
+          if (c < 128) ascii[c] = i;
+          break;
+        }
+      }
+    }
+    glyphCount++;
+  }
+
+
+  public String getName() {
+    return name;
+  }
+
+
+  public String getPostScriptName() {
+    return psname;
+  }
+
+  
   /**
    * Set the native complement of this font.
    */
@@ -254,6 +452,11 @@ public class PFont implements PConstants {
 //    }
     return font;
   }
+  
+  
+  public boolean isStream() {
+    return stream;
+  }
 
 
   /**
@@ -284,77 +487,50 @@ public class PFont implements PConstants {
   }
 
 
-  /**
-   * Write this PFont to an OutputStream.
-   * 
    
-   * This is used by the Create Font tool, or whatever anyone else dreams
-   * up for messing with fonts themselves.
-   * 
    
-   * It is assumed that the calling class will handle closing
-   * the stream when finished.
-   */
-  public void save(OutputStream output) throws IOException {
-    DataOutputStream os = new DataOutputStream(output);
-
-    os.writeInt(charCount);
-
-    if ((name == null) || (psname == null)) {
-      name = "";
-      psname = "";
-    }
-    // formerly numBits, now used for version number
-    //os.writeInt((name != null) ? 11 : 8);
-    os.writeInt(11);
-
-    os.writeInt(size);    // formerly mboxX (was 64, now 48)
-    os.writeInt(mbox2);   // formerly mboxY (was 64, still 64)
-    os.writeInt(ascent);  // formerly baseHt (was ignored)
-    os.writeInt(descent); // formerly struct padding for c version
-
-    for (int i = 0; i < charCount; i++) {
-      os.writeInt(value[i]);
-      os.writeInt(height[i]);
-      os.writeInt(width[i]);
-      os.writeInt(setWidth[i]);
-      os.writeInt(topExtent[i]);
-      os.writeInt(leftExtent[i]);
-      os.writeInt(0); // padding
-    }
-
-    for (int i = 0; i < charCount; i++) {
-      for (int y = 0; y < height[i]; y++) {
-        for (int x = 0; x < width[i]; x++) {
-          os.write(images[i].pixels[y * mbox2 + x] & 0xff);
-        }
-      }
-    }
-
-    //if (name != null) {  // version 11
-    os.writeUTF(name);
-    os.writeUTF(psname);
-    os.writeBoolean(smooth);
-    //}
-
-    os.flush();
+  public Glyph getGlyph(char c) {
+    int index = index(c);
+    return (index == -1) ? null : glyphs[index];
   }
 
 
   /**
-   * Get index for the char (convert from unicode to bagel charset).
+   * Get index for the character.
    * @return index into arrays or -1 if not found
    */
-  public int index(char c) {
+  protected int index(char c) {
+    if (lazy) {
+      int index = indexActual(c);
+      if (index != -1) {
+        return index;
+      }
+      if (font.canDisplay(c)) {
+        // create the glyph
+        addGlyph(c);
+        // now where did i put that?      
+        return indexActual(c);
+        
+      } else {
+        return -1;
+      }
+
+    } else {
+      return indexActual(c);
+    }
+  }
+
+
+  protected int indexActual(char c) {
     // degenerate case, but the find function will have trouble
     // if there are somehow zero chars in the lookup
     //if (value.length == 0) return -1;
-    if (charCount == 0) return -1;
+    if (glyphCount == 0) return -1;
 
     // quicker lookup for the ascii fellers
     if (c < 128) return ascii[c];
 
     // some other unicode char, hunt it out
     //return index_hunt(c, 0, value.length-1);
-    return indexHunt(c, 0, charCount-1);
+    return indexHunt(c, 0, glyphCount-1);
   }
 
 
@@ -362,14 +538,14 @@ public class PFont implements PConstants {
     int pivot = (start + stop) / 2;
 
     // if this is the char, then return it
-    if (c == value[pivot]) return pivot;
+    if (c == glyphs[pivot].value) return pivot;
 
     // char doesn't exist, otherwise would have been the pivot
     //if (start == stop) return -1;
     if (start >= stop) return -1;
 
     // if it's in the lower half, continue searching that
-    if (c < value[pivot]) return indexHunt(c, start, pivot-1);
+    if (c < glyphs[pivot].value) return indexHunt(c, start, pivot-1);
 
     // if it's in the upper half, continue there
     return indexHunt(c, pivot+1, stop);
@@ -390,7 +566,7 @@ public class PFont implements PConstants {
    * The value is based on a font of size 1.
    */
   public float ascent() {
-    return ((float)ascent / fheight);
+    return ((float) ascent / (float) size);
   }
 
 
@@ -399,7 +575,7 @@ public class PFont implements PConstants {
    * The value is based on a font size of 1.
    */
   public float descent() {
-    return ((float)descent / fheight);
+    return ((float) descent / (float) size);
   }
 
 
@@ -412,7 +588,7 @@ public class PFont implements PConstants {
     int cc = index(c);
     if (cc == -1) return 0;
 
-    return ((float)setWidth[cc] / fwidth);
+    return ((float) glyphs[cc].setWidth / (float) size);
   }
 
 
@@ -465,200 +641,19 @@ public class PFont implements PConstants {
    * 
    
    * Not that I expect that to happen.
    */
-  static public char[] DEFAULT_CHARSET;
+  static public char[] CHARSET;
   static {
-    DEFAULT_CHARSET = new char[126-33+1 + EXTRA_CHARS.length];
+    CHARSET = new char[126-33+1 + EXTRA_CHARS.length];
     int index = 0;
     for (int i = 33; i <= 126; i++) {
-      DEFAULT_CHARSET[index++] = (char)i;
+      CHARSET[index++] = (char)i;
     }
     for (int i = 0; i < EXTRA_CHARS.length; i++) {
-      DEFAULT_CHARSET[index++] = EXTRA_CHARS[i];
+      CHARSET[index++] = EXTRA_CHARS[i];
     }
   };
 
 
-  /**
-   * Create a new image-based font on the fly.
-   *
-   * @param font the font object to create from
-   * @param charset array of all unicode chars that should be included
-   * @param smooth true to enable smoothing/anti-aliasing
-   */
-  public PFont(Font font, boolean smooth, char charset[]) {
-    // save this so that we can use the native version
-    this.font = font;
-    this.smooth = smooth;
-
-    name = font.getName();
-    psname = font.getPSName();
-
-    // fix regression from sorting (bug #564)
-    if (charset != null) {
-      // charset needs to be sorted to make index lookup run more quickly
-      // http://dev.processing.org/bugs/show_bug.cgi?id=494
-      Arrays.sort(charset);
-    }
-
-    // the count gets reset later based on how many of
-    // the chars are actually found inside the font.
-    this.charCount = (charset == null) ? 65536 : charset.length;
-    this.size = font.getSize();
-
-    fwidth = fheight = size;
-
-    PImage bitmaps[] = new PImage[charCount];
-
-    // allocate enough space for the character info
-    value       = new int[charCount];
-    height      = new int[charCount];
-    width       = new int[charCount];
-    setWidth    = new int[charCount];
-    topExtent   = new int[charCount];
-    leftExtent  = new int[charCount];
-
-    ascii = new int[128];
-    for (int i = 0; i < 128; i++) ascii[i] = -1;
-
-    int mbox3 = size * 3;
-
-    BufferedImage playground =
-      new BufferedImage(mbox3, mbox3, BufferedImage.TYPE_INT_RGB);
-
-    Graphics2D g = (Graphics2D) playground.getGraphics();
-    g.setRenderingHint(RenderingHints.KEY_ANTIALIASING,
-                       smooth ?
-                       RenderingHints.VALUE_ANTIALIAS_ON :
-                       RenderingHints.VALUE_ANTIALIAS_OFF);
-
-    g.setFont(font);
-    FontMetrics metrics = g.getFontMetrics();
-
-    int samples[] = new int[mbox3 * mbox3];
-
-    int maxWidthHeight = 0;
-    int index = 0;
-    for (int i = 0; i < charCount; i++) {
-      char c = (charset == null) ? (char)i : charset[i];
-
-      if (!font.canDisplay(c)) {  // skip chars not in the font
-        continue;
-      }
-
-      g.setColor(Color.white);
-      g.fillRect(0, 0, mbox3, mbox3);
-      g.setColor(Color.black);
-      g.drawString(String.valueOf(c), size, size * 2);
-
-      // grabs copy of the current data.. so no updates (do each time)
-      Raster raster = playground.getData();
-      raster.getSamples(0, 0, mbox3, mbox3, 0, samples);
-
-      int minX = 1000, maxX = 0;
-      int minY = 1000, maxY = 0;
-      boolean pixelFound = false;
-
-      for (int y = 0; y < mbox3; y++) {
-        for (int x = 0; x < mbox3; x++) {
-          //int sample = raster.getSample(x, y, 0);  // maybe?
-          int sample = samples[y * mbox3 + x] & 0xff;
-          // or int samples[] = raster.getPixel(x, y, null);
-
-          //if (sample == 0) {  // or just not white? hmm
-          if (sample != 255) {
-            if (x < minX) minX = x;
-            if (y < minY) minY = y;
-            if (x > maxX) maxX = x;
-            if (y > maxY) maxY = y;
-            pixelFound = true;
-          }
-        }
-      }
-
-      if (!pixelFound) {
-        minX = minY = 0;
-        maxX = maxY = 0;
-        // this will create a 1 pixel white (clear) character..
-        // maybe better to set one to -1 so nothing is added?
-      }
-
-      value[index] = c;
-      height[index] = (maxY - minY) + 1;
-      width[index] = (maxX - minX) + 1;
-      setWidth[index] = metrics.charWidth(c);
-      //System.out.println((char)c + " " + setWidth[index]);
-
-      // cache locations of the ascii charset
-      //if (value[i] < 128) ascii[value[i]] = i;
-      if (c < 128) ascii[c] = index;
-
-      // offset from vertical location of baseline
-      // of where the char was drawn (size*2)
-      topExtent[index] = size*2 - minY;
-
-      // offset from left of where coord was drawn
-      leftExtent[index] = minX - size;
-
-      if (c == 'd') {
-        ascent = topExtent[index];
-      }
-      if (c == 'p') {
-        descent = -topExtent[index] + height[index];
-      }
-
-      if (width[index] > maxWidthHeight) maxWidthHeight = width[index];
-      if (height[index] > maxWidthHeight) maxWidthHeight = height[index];
-
-      bitmaps[index] = new PImage(width[index], height[index], ALPHA);
-
-      for (int y = minY; y <= maxY; y++) {
-        for (int x = minX; x <= maxX; x++) {
-          int val = 255 - (samples[y * mbox3 + x] & 0xff);
-          int pindex = (y - minY) * width[index] + (x - minX);
-          bitmaps[index].pixels[pindex] = val;
-        }
-      }
-      index++;
-    }
-    charCount = index;
-
-    // foreign font, so just make ascent the max topExtent
-    if ((ascent == 0) && (descent == 0)) {
-      for (int i = 0; i < charCount; i++) {
-        char cc = (char) value[i];
-        if (Character.isWhitespace(cc) ||
-            (cc == '\u00A0') || (cc == '\u2007') || (cc == '\u202F')) {
-          continue;
-        }
-        if (topExtent[i] > ascent) {
-          ascent = topExtent[i];
-        }
-        int d = -topExtent[i] + height[i];
-        if (d > descent) {
-          descent = d;
-        }
-      }
-    }
-    // size for image/texture is next power of 2 over largest char
-    mbox2 = (int)
-      Math.pow(2, Math.ceil(Math.log(maxWidthHeight) / Math.log(2)));
-    twidth = theight = mbox2;
-
-    // shove the smaller PImage data into textures of next-power-of-2 size,
-    // so that this font can be used immediately by p5.
-    images = new PImage[charCount];
-    for (int i = 0; i < charCount; i++) {
-      images[i] = new PImage(mbox2, mbox2, ALPHA);
-      for (int y = 0; y < height[i]; y++) {
-        System.arraycopy(bitmaps[i].pixels, y*width[i],
-                         images[i].pixels, y*mbox2,
-                         width[i]);
-      }
-      bitmaps[i] = null;
-    }
-  }
-
-
   /**
    * Get a list of the fonts installed on the system that can be used
    * by Java. Not all fonts can be used in Java, in fact it's mostly
@@ -688,24 +683,195 @@ public class PFont implements PConstants {
       GraphicsEnvironment ge =
         GraphicsEnvironment.getLocalGraphicsEnvironment();
       fonts = ge.getAllFonts();
-    }
-  }
-
-
-  /** 
-   * Starting with Java 1.5, Apple broke the ability to specify most fonts.
-   * This has been filed as bug #4769141 at bugreporter.apple.com. More info at
-   * Bug 407.
-  */
-  static public Font findFont(String name) {
-    loadFonts();
-    if (PApplet.platform == PConstants.MACOSX) {
-      for (int i = 0; i < fonts.length; i++) {
-        if (name.equals(fonts[i].getName())) {
-          return fonts[i];
+      if (PApplet.platform == PConstants.MACOSX) {
+        fontDifferent = new HashMap();
+        for (Font font : fonts) {
+          // getName() returns the PostScript name on OS X 10.6 w/ Java 6.
+          fontDifferent.put(font.getName(), font);
+          //fontDifferent.put(font.getPSName(), font);
         }
       }
     }
+  }
+
+
+  /**
+   * Starting with Java 1.5, Apple broke the ability to specify most fonts.
+   * This bug was filed years ago as #4769141 at bugreporter.apple.com. More:
+   * Bug 407.
+   */
+  static public Font findFont(String name) {
+    loadFonts();
+    if (PApplet.platform == PConstants.MACOSX) {
+      Font maybe = fontDifferent.get(name);
+      if (maybe != null) {
+        return maybe;
+      }
+//      for (int i = 0; i < fonts.length; i++) {
+//        if (name.equals(fonts[i].getName())) {
+//          return fonts[i];
+//        }
+//      }
+    }
     return new Font(name, Font.PLAIN, 1);
   }
+  
+  
+  //////////////////////////////////////////////////////////////
+
+  
+  /**
+   * A single character, and its visage.
+   */
+  public class Glyph {
+    PImage image;
+    int value;
+    int height;
+    int width;
+    int setWidth;
+    int topExtent;
+    int leftExtent;
+    
+    
+    protected Glyph() {
+      // used when reading from a stream or for subclasses
+    }
+    
+    
+    protected Glyph(DataInputStream is) throws IOException {
+      readHeader(is);
+    }
+    
+    
+    protected void readHeader(DataInputStream is) throws IOException {
+      value = is.readInt();
+      height = is.readInt();
+      width = is.readInt();
+      setWidth = is.readInt();
+      topExtent = is.readInt();
+      leftExtent = is.readInt();
+
+      // pointer from a struct in the c version, ignored
+      is.readInt();
+      
+      // the values for getAscent() and getDescent() from FontMetrics
+      // seem to be way too large.. perhaps they're the max?
+      // as such, use a more traditional marker for ascent/descent
+      if (value == 'd') {
+        if (ascent == 0) ascent = topExtent;
+      }
+      if (value == 'p') {
+        if (descent == 0) descent = -topExtent + height;
+      }
+    }
+
+    
+    protected void writeHeader(DataOutputStream os) throws IOException {
+      os.writeInt(value);
+      os.writeInt(height);
+      os.writeInt(width);
+      os.writeInt(setWidth);
+      os.writeInt(topExtent);
+      os.writeInt(leftExtent);
+      os.writeInt(0); // padding
+    }
+    
+    
+    protected void readBitmap(DataInputStream is) throws IOException {
+      image = new PImage(width, height, ALPHA);
+      int bitmapSize = width * height;
+
+      byte[] temp = new byte[bitmapSize];
+      is.readFully(temp);
+
+      // convert the bitmap to an alpha channel
+      int w = width;
+      int h = height;
+      int[] pixels = image.pixels;
+      for (int y = 0; y < h; y++) {
+        for (int x = 0; x < w; x++) {
+          pixels[y * width + x] = temp[y*w + x] & 0xff;
+//          System.out.print((image.pixels[y*64+x] > 128) ? "*" : ".");
+        }
+//        System.out.println();
+      }
+//      System.out.println();
+    }
+    
+    
+    protected void writeBitmap(DataOutputStream os) throws IOException {
+      int[] pixels  = image.pixels;
+      for (int y = 0; y < height; y++) {
+        for (int x = 0; x < width; x++) {
+          os.write(pixels[y * width + x] & 0xff);
+        }
+      }
+    }
+
+
+    protected Glyph(char c) {
+      int mbox3 = size * 3;
+      lazyGraphics.setColor(Color.white);
+      lazyGraphics.fillRect(0, 0, mbox3, mbox3);
+      lazyGraphics.setColor(Color.black);
+      lazyGraphics.drawString(String.valueOf(c), size, size * 2);
+
+      WritableRaster raster = lazyImage.getRaster();
+      raster.getDataElements(0, 0, mbox3, mbox3, lazySamples);
+
+      int minX = 1000, maxX = 0;
+      int minY = 1000, maxY = 0;
+      boolean pixelFound = false;
+
+      for (int y = 0; y < mbox3; y++) {
+        for (int x = 0; x < mbox3; x++) {
+          int sample = lazySamples[y * mbox3 + x] & 0xff;
+          if (sample != 255) {
+            if (x < minX) minX = x;
+            if (y < minY) minY = y;
+            if (x > maxX) maxX = x;
+            if (y > maxY) maxY = y;
+            pixelFound = true;
+          }
+        }
+      }
+
+      if (!pixelFound) {
+        minX = minY = 0;
+        maxX = maxY = 0;
+        // this will create a 1 pixel white (clear) character..
+        // maybe better to set one to -1 so nothing is added?
+      }
+
+      value = c;
+      height = (maxY - minY) + 1;
+      width = (maxX - minX) + 1;
+      setWidth = lazyMetrics.charWidth(c);
+
+      // offset from vertical location of baseline
+      // of where the char was drawn (size*2)
+      topExtent = size*2 - minY;
+
+      // offset from left of where coord was drawn
+      leftExtent = minX - size;
+
+      image = new PImage(width, height, ALPHA);
+      int[] pixels = image.pixels;
+      for (int y = minY; y <= maxY; y++) {
+        for (int x = minX; x <= maxX; x++) {
+          int val = 255 - (lazySamples[y * mbox3 + x] & 0xff);
+          int pindex = (y - minY) * width + (x - minX);
+          pixels[pindex] = val;
+        }
+      }
+
+      // replace the ascent/descent values with something.. err, decent.
+      if (value == 'd') {
+        if (ascent == 0) ascent = topExtent;
+      }
+      if (value == 'p') {
+        if (descent == 0) descent = -topExtent + height;
+      }
+    }
+  }
 }
diff --git a/core/src/processing/core/PGraphics.java b/core/src/processing/core/PGraphics.java
index 346b11cd1..9d50cdedd 100644
--- a/core/src/processing/core/PGraphics.java
+++ b/core/src/processing/core/PGraphics.java
@@ -29,6 +29,13 @@ import java.util.HashMap;
 
 
 /**
+ * Main graphics and rendering context, as well as the base API implementation for processing "core".
+ * Use this class if you need to draw into an off-screen graphics buffer.
+ * A PGraphics object can be constructed with the createGraphics() function.
+ * The beginDraw() and endDraw() methods (see above example) are necessary to set up the buffer and to finalize it.
+ * The fields and methods for this class are extensive;
+ * for a complete list visit the developer's reference: http://dev.processing.org/reference/core/
+ * =advanced
  * Main graphics and rendering context, as well as the base API implementation.
  *
  * 
    Subclassing and initializing PGraphics objects
    
@@ -106,6 +113,14 @@ import java.util.HashMap;
  * to be done once—it's a matter of keeping the multiple references
  * synchronized (to say nothing of the translation issues), while targeting
  * them for their separate audiences. Ouch.
+ *
+ * We're working right now on synchronizing the two references, so the website reference
+ * is generated from the javadoc comments. Yay.
+ *
+ * @webref rendering
+ * @instanceName graphics any object of the type PGraphics
+ * @usage Web & Application
+ * @see processing.core.PApplet#createGraphics(int, int, String)
  */
 public class PGraphics extends PImage implements PConstants {
 
@@ -540,6 +555,7 @@ public class PGraphics extends PImage implements PConstants {
    * the defaults get set properly. In a subclass, use this(w, h)
    * as the first line of a subclass' constructor to properly set
    * the internal fields and defaults.
+   *
    */
   public PGraphics() {
   }
@@ -627,20 +643,28 @@ public class PGraphics extends PImage implements PConstants {
 
 
   /**
-   * Prepares the PGraphics for drawing.
+   * Sets the default properties for a PGraphics object. It should be called before anything is drawn into the object.
+   * =advanced
    * 
    
    * When creating your own PGraphics, you should call this before
    * drawing anything.
+   *
+   * @webref
+   * @brief Sets up the rendering context
    */
   public void beginDraw() {  // ignore
   }
 
 
   /**
-   * This will finalize rendering so that it can be shown on-screen.
+   * Finalizes the rendering of a PGraphics object so that it can be shown on screen.
+   * =advanced
    * 
    
    * When creating your own PGraphics, you should call this when
    * you're finished drawing.
+   *
+   * @webref
+   * @brief Finalizes the renderering context
    */
   public void endDraw() {  // ignore
   }
@@ -673,8 +697,12 @@ public class PGraphics extends PImage implements PConstants {
     colorMode(RGB, 255);
     fill(255);
     stroke(0);
-    // other stroke attributes are set in the initializers
-    // inside the class (see above, strokeWeight = 1 et al)
+    
+    // as of 0178, no longer relying on local versions of the variables
+    // being set, because subclasses may need to take extra action.
+    strokeWeight(DEFAULT_STROKE_WEIGHT);
+    strokeJoin(DEFAULT_STROKE_JOIN);
+    strokeCap(DEFAULT_STROKE_CAP);
 
     // init shape stuff
     shape = 0;
@@ -781,22 +809,22 @@ public class PGraphics extends PImage implements PConstants {
   // HINTS
 
   /**
-   * Enable a hint option.
-   * 
    
-   * For the most part, hints are temporary api quirks,
-   * for which a proper api hasn't been properly worked out.
-   * for instance SMOOTH_IMAGES existed because smooth()
-   * wasn't yet implemented, but it will soon go away.
-   * 
    
-   * They also exist for obscure features in the graphics
-   * engine, like enabling/disabling single pixel lines
-   * that ignore the zbuffer, the way they do in alphabot.
-   * 
    
-   * Current hint options:
-   * 
      
-   * 
    • DISABLE_DEPTH_TEST -
-   * turns off the z-buffer in the P3D or OPENGL renderers.
-   * 
    
+   * Set various hints and hacks for the renderer. This is used to handle obscure rendering features that cannot be implemented in a consistent manner across renderers. Many options will often graduate to standard features instead of hints over time.
+   * 

    hint(ENABLE_OPENGL_4X_SMOOTH) - Enable 4x anti-aliasing for OpenGL. This can help force anti-aliasing if it has not been enabled by the user. On some graphics cards, this can also be set by the graphics driver's control panel, however not all cards make this available. This hint must be called immediately after the size() command because it resets the renderer, obliterating any settings and anything drawn (and like size(), re-running the code that came before it again).
+   * 

    hint(DISABLE_OPENGL_2X_SMOOTH) - In Processing 1.0, Processing always enables 2x smoothing when the OpenGL renderer is used. This hint disables the default 2x smoothing and returns the smoothing behavior found in earlier releases, where smooth() and noSmooth() could be used to enable and disable smoothing, though the quality was inferior.
+   * 

    hint(ENABLE_NATIVE_FONTS) - Use the native version fonts when they are installed, rather than the bitmapped version from a .vlw file. This is useful with the JAVA2D renderer setting, as it will improve font rendering speed. This is not enabled by default, because it can be misleading while testing because the type will look great on your machine (because you have the font installed) but lousy on others' machines if the identical font is unavailable. This option can only be set per-sketch, and must be called before any use of textFont().
+   * 

    hint(DISABLE_DEPTH_TEST) - Disable the zbuffer, allowing you to draw on top of everything at will. When depth testing is disabled, items will be drawn to the screen sequentially, like a painting. This hint is most often used to draw in 3D, then draw in 2D on top of it (for instance, to draw GUI controls in 2D on top of a 3D interface). Starting in release 0149, this will also clear the depth buffer. Restore the default with hint(ENABLE_DEPTH_TEST), but note that with the depth buffer cleared, any 3D drawing that happens later in draw() will ignore existing shapes on the screen.
+   * 

    hint(ENABLE_DEPTH_SORT) - Enable primitive z-sorting of triangles and lines in P3D and OPENGL. This can slow performance considerably, and the algorithm is not yet perfect. Restore the default with hint(DISABLE_DEPTH_SORT).
+   * 

    hint(DISABLE_OPENGL_ERROR_REPORT) - Speeds up the OPENGL renderer setting by not checking for errors while running. Undo with hint(ENABLE_OPENGL_ERROR_REPORT).
+   * 

    As of release 0149, unhint() has been removed in favor of adding additional ENABLE/DISABLE constants to reset the default behavior. This prevents the double negatives, and also reinforces which hints can be enabled or disabled.
+   *
+   * @webref rendering
+   * @param which name of the hint to be enabled or disabled
+   *
+   * @see processing.core.PGraphics
+   * @see processing.core.PApplet#createGraphics(int, int, String, String)
+   * @see processing.core.PApplet#size(int, int)
    */
   public void hint(int which) {
     if (which > 0) {
@@ -1394,6 +1422,26 @@ public class PGraphics extends PImage implements PConstants {
   }
 
 
+  /**
+   * Draws a point, a coordinate in space at the dimension of one pixel.
+   * The first parameter is the horizontal value for the point, the second
+   * value is the vertical value for the point, and the optional third value
+   * is the depth value. Drawing this shape in 3D using the z
+   * parameter requires the P3D or OPENGL parameter in combination with
+   * size as shown in the above example.
+   * 

    Due to what appears to be a bug in Apple's Java implementation,
+   * the point() and set() methods are extremely slow in some circumstances
+   * when used with the default renderer. Using P2D or P3D will fix the
+   * problem. Grouping many calls to point() or set() together can also
+   * help. (Bug 1094)
+   *
+   * @webref shape:2d_primitives
+   * @param x x-coordinate of the point
+   * @param y y-coordinate of the point
+   * @param z z-coordinate of the point
+   *
+   * @see PGraphics#beginShape()
+   */
   public void point(float x, float y, float z) {
     beginShape(POINTS);
     vertex(x, y, z);
@@ -1409,6 +1457,32 @@ public class PGraphics extends PImage implements PConstants {
   }
 
 
+
+  /**
+   * Draws a line (a direct path between two points) to the screen.
+   * The version of line() with four parameters draws the line in 2D.
+   * To color a line, use the stroke() function. A line cannot be
+   * filled, therefore the fill() method will not affect the color
+   * of a line. 2D lines are drawn with a width of one pixel by default,
+   * but this can be changed with the strokeWeight() function.
+   * The version with six parameters allows the line to be placed anywhere
+   * within XYZ space. Drawing this shape in 3D using the z parameter
+   * requires the P3D or OPENGL parameter in combination with size as shown
+   * in the above example.
+   *
+   * @webref shape:2d_primitives
+   * @param x1 x-coordinate of the first point
+   * @param y1 y-coordinate of the first point
+   * @param z1 z-coordinate of the first point
+   * @param x2 x-coordinate of the second point
+   * @param y2 y-coordinate of the second point
+   * @param z2 z-coordinate of the second point
+   *
+   * @see PGraphics#strokeWeight(float)
+   * @see PGraphics#strokeJoin(int)
+   * @see PGraphics#strokeCap(int)
+   * @see PGraphics#beginShape()
+   */
   public void line(float x1, float y1, float z1,
                    float x2, float y2, float z2) {
     beginShape(LINES);
@@ -1418,6 +1492,21 @@ public class PGraphics extends PImage implements PConstants {
   }
 
 
+  /**
+   * A triangle is a plane created by connecting three points. The first two
+   * arguments specify the first point, the middle two arguments specify
+   * the second point, and the last two arguments specify the third point.
+   *
+   * @webref shape:2d_primitives
+   * @param x1 x-coordinate of the first point
+   * @param y1 y-coordinate of the first point
+   * @param x2 x-coordinate of the second point
+   * @param y2 y-coordinate of the second point
+   * @param x3 x-coordinate of the third point
+   * @param y3 y-coordinate of the third point
+   *
+   * @see PApplet#beginShape()
+   */
   public void triangle(float x1, float y1, float x2, float y2,
                        float x3, float y3) {
     beginShape(TRIANGLES);
@@ -1428,6 +1517,24 @@ public class PGraphics extends PImage implements PConstants {
   }
 
 
+  /**
+   * A quad is a quadrilateral, a four sided polygon. It is similar to
+   * a rectangle, but the angles between its edges are not constrained
+   * ninety degrees. The first pair of parameters (x1,y1) sets the
+   * first vertex and the subsequent pairs should proceed clockwise or
+   * counter-clockwise around the defined shape.
+   *
+   * @webref shape:2d_primitives
+   * @param x1 x-coordinate of the first corner
+   * @param y1 y-coordinate of the first corner
+   * @param x2 x-coordinate of the second corner
+   * @param y2 y-coordinate of the second corner
+   * @param x3 x-coordinate of the third corner
+   * @param y3 y-coordinate of the third corner
+   * @param x4 x-coordinate of the fourth corner
+   * @param y4 y-coordinate of the fourth corner
+   *
+   */
   public void quad(float x1, float y1, float x2, float y2,
                    float x3, float y3, float x4, float y4) {
     beginShape(QUADS);
@@ -1450,6 +1557,21 @@ public class PGraphics extends PImage implements PConstants {
   }
 
 
+  /**
+   * Draws a rectangle to the screen. A rectangle is a four-sided shape with
+   * every angle at ninety degrees. The first two parameters set the location,
+   * the third sets the width, and the fourth sets the height. The origin is
+   * changed with the rectMode() function.
+   *
+   * @webref shape:2d_primitives
+   * @param a x-coordinate of the rectangle
+   * @param b y-coordinate of the rectangle
+   * @param c width of the rectangle
+   * @param d height of the rectangle
+   *
+   * @see PGraphics#rectMode(int)
+   * @see PGraphics#quad(float, float, float, float, float, float, float, float)
+   */
   public void rect(float a, float b, float c, float d) {
     float hradius, vradius;
     switch (rectMode) {
@@ -1498,11 +1620,42 @@ public class PGraphics extends PImage implements PConstants {
   // ELLIPSE AND ARC
 
 
+  /**
+   * The origin of the ellipse is modified by the ellipseMode()
+   * function. The default configuration is ellipseMode(CENTER),
+   * which specifies the location of the ellipse as the center of the shape.
+   * The RADIUS mode is the same, but the width and height parameters to
+   * ellipse() specify the radius of the ellipse, rather than the
+   * diameter. The CORNER mode draws the shape from the upper-left corner
+   * of its bounding box. The CORNERS mode uses the four parameters to
+   * ellipse() to set two opposing corners of the ellipse's bounding
+   * box. The parameter must be written in "ALL CAPS" because Processing
+   * syntax is case sensitive.
+   *
+   * @webref shape:attributes
+   *
+   * @param mode        Either CENTER, RADIUS, CORNER, or CORNERS.
+   * @see PApplet#ellipse(float, float, float, float)
+   */
   public void ellipseMode(int mode) {
     ellipseMode = mode;
   }
 
 
+  /**
+   * Draws an ellipse (oval) in the display window. An ellipse with an equal
+   * width and height is a circle. The first two parameters set
+   * the location, the third sets the width, and the fourth sets the height.
+   * The origin may be changed with the ellipseMode() function.
+   *
+   * @webref shape:2d_primitives
+   * @param a x-coordinate of the ellipse
+   * @param b y-coordinate of the ellipse
+   * @param c width of the ellipse
+   * @param d height of the ellipse
+   *
+   * @see PApplet#ellipseMode(int)
+   */
   public void ellipse(float a, float b, float c, float d) {
     float x = a;
     float y = b;
@@ -1543,13 +1696,24 @@ public class PGraphics extends PImage implements PConstants {
 
 
   /**
-   * Identical parameters and placement to ellipse,
-   * but draws only an arc of that ellipse.
-   * 
    
-   * start and stop are always radians because angleMode() was goofy.
-   * ellipseMode() sets the placement.
-   * 
    
-   * also tries to be smart about start < stop.
+   * Draws an arc in the display window.
+   * Arcs are drawn along the outer edge of an ellipse defined by the
+   * x, y, width and height parameters.
+   * The origin or the arc's ellipse may be changed with the
+   * ellipseMode() function.
+   * The start and stop parameters specify the angles
+   * at which to draw the arc.
+   *
+   * @webref shape:2d_primitives
+   * @param a x-coordinate of the arc's ellipse
+   * @param b y-coordinate of the arc's ellipse
+   * @param c width of the arc's ellipse
+   * @param d height of the arc's ellipse
+   * @param start angle to start the arc, specified in radians
+   * @param stop angle to stop the arc, specified in radians
+   *
+   * @see PGraphics#ellipseMode(int)
+   * @see PGraphics#ellipse(float, float, float, float)
    */
   public void arc(float a, float b, float c, float d,
                   float start, float stop) {
@@ -1577,7 +1741,7 @@ public class PGraphics extends PImage implements PConstants {
     if (Float.isInfinite(start) || Float.isInfinite(stop)) return;
 //    while (stop < start) stop += TWO_PI;
     if (stop < start) return;  // why bother
-    
+
     // make sure that we're starting at a useful point
     while (start < 0) {
       start += TWO_PI;
@@ -1610,18 +1774,33 @@ public class PGraphics extends PImage implements PConstants {
   // BOX
 
 
+  /**
+   * @param size dimension of the box in all dimensions, creates a cube
+   */
   public void box(float size) {
     box(size, size, size);
   }
 
 
-  // TODO not the least bit efficient, it even redraws lines
-  // along the vertices. ugly ugly ugly!
+  /**
+   * A box is an extruded rectangle. A box with equal dimension
+   * on all sides is a cube.
+   *
+   * @webref shape:3d_primitives
+   * @param w dimension of the box in the x-dimension
+   * @param h dimension of the box in the y-dimension
+   * @param d dimension of the box in the z-dimension
+   *
+   * @see PApplet#sphere(float)
+   */
   public void box(float w, float h, float d) {
     float x1 = -w/2f; float x2 = w/2f;
     float y1 = -h/2f; float y2 = h/2f;
     float z1 = -d/2f; float z2 = d/2f;
 
+    // TODO not the least bit efficient, it even redraws lines
+    // along the vertices. ugly ugly ugly!
+
     beginShape(QUADS);
 
     // front
@@ -1676,17 +1855,44 @@ public class PGraphics extends PImage implements PConstants {
   // SPHERE
 
 
+  /**
+   * @param res number of segments (minimum 3) used per full circle revolution
+   */
   public void sphereDetail(int res) {
     sphereDetail(res, res);
   }
 
 
+  /**
+   * Controls the detail used to render a sphere by adjusting the number of
+   * vertices of the sphere mesh. The default resolution is 30, which creates
+   * a fairly detailed sphere definition with vertices every 360/30 = 12
+   * degrees. If you're going to render a great number of spheres per frame,
+   * it is advised to reduce the level of detail using this function.
+   * The setting stays active until sphereDetail() is called again with
+   * a new parameter and so should not be called prior to every
+   * sphere() statement, unless you wish to render spheres with
+   * different settings, e.g. using less detail for smaller spheres or ones
+   * further away from the camera. To control the detail of the horizontal
+   * and vertical resolution independently, use the version of the functions
+   * with two parameters.
+   *
+   * =advanced
+   * Code for sphereDetail() submitted by toxi [031031].
+   * Code for enhanced u/v version from davbol [080801].
+   *
+   * @webref shape:3d_primitives
+   * @param ures number of segments used horizontally (longitudinally)
+   *        per full circle revolution
+   * @param vres number of segments used vertically (latitudinally)
+   *        from top to bottom
+   *
+   * @see PGraphics#sphere(float)
+   */
   /**
    * Set the detail level for approximating a sphere. The ures and vres params
    * control the horizontal and vertical resolution.
    *
-   * Code for sphereDetail() submitted by toxi [031031].
-   * Code for enhanced u/v version from davbol [080801].
    */
   public void sphereDetail(int ures, int vres) {
     if (ures < 3) ures = 3; // force a minimum res
@@ -1732,6 +1938,8 @@ public class PGraphics extends PImage implements PConstants {
 
   /**
    * Draw a sphere with radius r centered at coordinate 0, 0, 0.
+   * A sphere is a hollow ball made from tessellated triangles.
+   * =advanced
    * 
    
    * Implementation notes:
    * 
    
@@ -1751,6 +1959,9 @@ public class PGraphics extends PImage implements PConstants {
    *
    * [davbol 080801] now using separate sphereDetailU/V
    *
    + * + * @webref shape:3d_primitives + * @param r the radius of the sphere */ public void sphere(float r) { if ((sphereDetailU < 3) || (sphereDetailV < 2)) { @@ -1825,14 +2036,18 @@ public class PGraphics extends PImage implements PConstants { // BEZIER + /** + * Evaluates the Bezier at point t for points a, b, c, d. The parameter t varies between 0 and 1, a and d are points on the curve, and b and c are the control points. This can be done once with the x coordinates and a second time with the y coordinates to get the location of a bezier curve at t. + */ /** * Evalutes quadratic bezier at point t for points a, b, c, d. - * t varies between 0 and 1, and a and d are the on curve points, - * b and c are the control points. this can be done once with the - * x coordinates and a second time with the y coordinates to get - * the location of a bezier curve at t. - *

    + * The parameter t varies between 0 and 1. The a and d parameters are the + * on-curve points, b and c are the control points. To make a two-dimensional + * curve, call this function once with the x coordinates and a second time + * with the y coordinates to get the location of a bezier curve at t. + * + * =advanced * For instance, to convert the following example:

        * stroke(255, 102, 0);
    * line(85, 20, 10, 10);
@@ -1852,6 +2067,17 @@ public class PGraphics extends PImage implements PConstants {
    *   vertex(x, y);
    * }
    * endShape();
    + * + * @webref shape:curves + * @param a coordinate of first point on the curve + * @param b coordinate of first control point + * @param c coordinate of second control point + * @param d coordinate of second point on the curve + * @param t value between 0 and 1 + * + * @see PGraphics#bezier(float, float, float, float, float, float, float, float, float, float, float, float) + * @see PGraphics#bezierVertex(float, float, float, float, float, float) + * @see PGraphics#curvePoint(float, float, float, float, float) */ public float bezierPoint(float a, float b, float c, float d, float t) { float t1 = 1.0f - t; @@ -1860,8 +2086,22 @@ public class PGraphics extends PImage implements PConstants { /** - * Provide the tangent at the given point on the bezier curve. - * Fix from davbol for 0136. + * Calculates the tangent of a point on a Bezier curve. There is a good + * definition of "tangent" at Wikipedia: http://en.wikipedia.org/wiki/Tangent + * + * =advanced + * Code submitted by Dave Bollinger (davol) for release 0136. + * + * @webref shape:curves + * @param a coordinate of first point on the curve + * @param b coordinate of first control point + * @param c coordinate of second control point + * @param d coordinate of second point on the curve + * @param t value between 0 and 1 + * + * @see PGraphics#bezier(float, float, float, float, float, float, float, float, float, float, float, float) + * @see PGraphics#bezierVertex(float, float, float, float, float, float) + * @see PGraphics#curvePoint(float, float, float, float, float) */ public float bezierTangent(float a, float b, float c, float d, float t) { return (3*t*t * (-a+3*b-3*c+d) + @@ -1884,6 +2124,16 @@ public class PGraphics extends PImage implements PConstants { } + /** + * Sets the resolution at which Beziers display. The default value is 20. This function is only useful when using the P3D or OPENGL renderer as the default (JAVA2D) renderer does not use this information. + * + * @webref shape:curves + * @param detail resolution of the curves + * + * @see PApplet#curve(float, float, float, float, float, float, float, float, float, float, float, float) + * @see PApplet#curveVertex(float, float) + * @see PApplet#curveTightness(float) + */ public void bezierDetail(int detail) { bezierDetail = detail; @@ -1903,6 +2153,15 @@ public class PGraphics extends PImage implements PConstants { /** + * Draws a Bezier curve on the screen. These curves are defined by a series + * of anchor and control points. The first two parameters specify the first + * anchor point and the last two parameters specify the other anchor point. + * The middle parameters specify the control points which define the shape + * of the curve. Bezier curves were developed by French engineer Pierre + * Bezier. Using the 3D version of requires rendering with P3D or OPENGL + * (see the Environment reference for more information). + * + * =advanced * Draw a cubic bezier curve. The first and last points are * the on-curve points. The middle two are the 'control' points, * or 'handles' in an application like Illustrator. @@ -1924,6 +2183,23 @@ public class PGraphics extends PImage implements PConstants { * To draw a quadratic (instead of cubic) curve, * use the control point twice by doubling it: * 
    bezier(x1, y1, cx, cy, cx, cy, x2, y2);
    + * + * @webref shape:curves + * @param x1 coordinates for the first anchor point + * @param y1 coordinates for the first anchor point + * @param z1 coordinates for the first anchor point + * @param x2 coordinates for the first control point + * @param y2 coordinates for the first control point + * @param z2 coordinates for the first control point + * @param x3 coordinates for the second control point + * @param y3 coordinates for the second control point + * @param z3 coordinates for the second control point + * @param x4 coordinates for the second anchor point + * @param y4 coordinates for the second anchor point + * @param z4 coordinates for the second anchor point + * + * @see PGraphics#bezierVertex(float, float, float, float, float, float) + * @see PGraphics#curve(float, float, float, float, float, float, float, float, float, float, float, float) */ public void bezier(float x1, float y1, float x2, float y2, @@ -1956,9 +2232,22 @@ public class PGraphics extends PImage implements PConstants { /** - * Get a location along a catmull-rom curve segment. + * Evalutes the Catmull-Rom curve at point t for points a, b, c, d. The + * parameter t varies between 0 and 1, a and d are points on the curve, + * and b and c are the control points. This can be done once with the x + * coordinates and a second time with the y coordinates to get the + * location of a curve at t. * - * @param t Value between zero and one for how far along the segment + * @webref shape:curves + * @param a coordinate of first point on the curve + * @param b coordinate of second point on the curve + * @param c coordinate of third point on the curve + * @param d coordinate of fourth point on the curve + * @param t value between 0 and 1 + * + * @see PGraphics#curve(float, float, float, float, float, float, float, float, float, float, float, float) + * @see PGraphics#curveVertex(float, float) + * @see PGraphics#bezierPoint(float, float, float, float, float) */ public float curvePoint(float a, float b, float c, float d, float t) { curveInitCheck(); @@ -1976,8 +2265,22 @@ public class PGraphics extends PImage implements PConstants { /** - * Calculate the tangent at a t value (0..1) on a Catmull-Rom curve. + * Calculates the tangent of a point on a Catmull-Rom curve. There is a good definition of "tangent" at Wikipedia: http://en.wikipedia.org/wiki/Tangent. + * + * =advanced * Code thanks to Dave Bollinger (Bug #715) + * + * @webref shape:curves + * @param a coordinate of first point on the curve + * @param b coordinate of first control point + * @param c coordinate of second control point + * @param d coordinate of second point on the curve + * @param t value between 0 and 1 + * + * @see PGraphics#curve(float, float, float, float, float, float, float, float, float, float, float, float) + * @see PGraphics#curveVertex(float, float) + * @see PGraphics#curvePoint(float, float, float, float, float) + * @see PGraphics#bezierTangent(float, float, float, float, float) */ public float curveTangent(float a, float b, float c, float d, float t) { curveInitCheck(); @@ -1994,12 +2297,41 @@ public class PGraphics extends PImage implements PConstants { } + /** + * Sets the resolution at which curves display. The default value is 20. + * This function is only useful when using the P3D or OPENGL renderer as + * the default (JAVA2D) renderer does not use this information. + * + * @webref shape:curves + * @param detail resolution of the curves + * + * @see PGraphics#curve(float, float, float, float, float, float, float, float, float, float, float, float) + * @see PGraphics#curveVertex(float, float) + * @see PGraphics#curveTightness(float) + */ public void curveDetail(int detail) { curveDetail = detail; curveInit(); } + /** + * Modifies the quality of forms created with curve() and + *curveVertex(). The parameter squishy determines how the + * curve fits to the vertex points. The value 0.0 is the default value for + * squishy (this value defines the curves to be Catmull-Rom splines) + * and the value 1.0 connects all the points with straight lines. + * Values within the range -5.0 and 5.0 will deform the curves but + * will leave them recognizable and as values increase in magnitude, + * they will continue to deform. + * + * @webref shape:curves + * @param tightness amount of deformation from the original vertices + * + * @see PGraphics#curve(float, float, float, float, float, float, float, float, float, float, float, float) + * @see PGraphics#curveVertex(float, float) + * + */ public void curveTightness(float tightness) { curveTightness = tightness; curveInit(); @@ -2060,10 +2392,20 @@ public class PGraphics extends PImage implements PConstants { /** - * Draws a segment of Catmull-Rom curve. - *

    - * As of 0070, this function no longer doubles the first and - * last points. The curves are a bit more boring, but it's more + * Draws a curved line on the screen. The first and second parameters + * specify the beginning control point and the last two parameters specify + * the ending control point. The middle parameters specify the start and + * stop of the curve. Longer curves can be created by putting a series of + * curve() functions together or using curveVertex(). + * An additional function called curveTightness() provides control + * for the visual quality of the curve. The curve() function is an + * implementation of Catmull-Rom splines. Using the 3D version of requires + * rendering with P3D or OPENGL (see the Environment reference for more + * information). + * + * =advanced + * As of revision 0070, this function no longer doubles the first + * and last points. The curves are a bit more boring, but it's more * mathematically correct, and properly mirrored in curvePoint(). *

    * Identical to typing out:

    @@ -2074,6 +2416,24 @@ public class PGraphics extends PImage implements PConstants {
    * curveVertex(x4, y4);
    * endShape();
    *
    + * + * @webref shape:curves + * @param x1 coordinates for the beginning control point + * @param y1 coordinates for the beginning control point + * @param z1 coordinates for the beginning control point + * @param x2 coordinates for the first point + * @param y2 coordinates for the first point + * @param z2 coordinates for the first point + * @param x3 coordinates for the second point + * @param y3 coordinates for the second point + * @param z3 coordinates for the second point + * @param x4 coordinates for the ending control point + * @param y4 coordinates for the ending control point + * @param z4 coordinates for the ending control point + * + * @see PGraphics#curveVertex(float, float) + * @see PGraphics#curveTightness(float) + * @see PGraphics#bezier(float, float, float, float, float, float, float, float, float, float, float, float) */ public void curve(float x1, float y1, float x2, float y2, @@ -2158,9 +2518,25 @@ public class PGraphics extends PImage implements PConstants { /** - * The mode can only be set to CORNERS, CORNER, and CENTER. - *

    - * Support for CENTER was added in release 0146. + * Modifies the location from which images draw. The default mode is + * imageMode(CORNER), which specifies the location to be the + * upper-left corner and uses the fourth and fifth parameters of + * image() to set the image's width and height. The syntax + * imageMode(CORNERS) uses the second and third parameters of + * image() to set the location of one corner of the image and + * uses the fourth and fifth parameters to set the opposite corner. + * Use imageMode(CENTER) to draw images centered at the given + * x and y position. + *

    The parameter to imageMode() must be written in + * ALL CAPS because Processing syntax is case sensitive. + * + * @webref image:loading_displaying + * @param mode Either CORNER, CORNERS, or CENTER + * + * @see processing.core.PApplet#loadImage(String, String) + * @see processing.core.PImage + * @see processing.core.PApplet#image(PImage, float, float, float, float) + * @see processing.core.PGraphics#background(float, float, float, float) */ public void imageMode(int mode) { if ((mode == CORNER) || (mode == CORNERS) || (mode == CENTER)) { @@ -2193,6 +2569,39 @@ public class PGraphics extends PImage implements PConstants { } + /** + * Displays images to the screen. The images must be in the sketch's "data" + * directory to load correctly. Select "Add file..." from the "Sketch" menu + * to add the image. Processing currently works with GIF, JPEG, and Targa + * images. The color of an image may be modified with the tint() + * function and if a GIF has transparency, it will maintain its transparency. + * The img parameter specifies the image to display and the x + * and y parameters define the location of the image from its + * upper-left corner. The image is displayed at its original size unless + * the width and height parameters specify a different size. + * The imageMode() function changes the way the parameters work. + * A call to imageMode(CORNERS) will change the width and height + * parameters to define the x and y values of the opposite corner of the + * image. + * + * =advanced + * Starting with release 0124, when using the default (JAVA2D) renderer, + * smooth() will also improve image quality of resized images. + * + * @webref image:loading_displaying + * @param image the image to display + * @param x x-coordinate of the image + * @param y y-coordinate of the image + * @param c width to display the image + * @param d height to display the image + * + * @see processing.core.PApplet#loadImage(String, String) + * @see processing.core.PImage + * @see processing.core.PGraphics#imageMode(int) + * @see processing.core.PGraphics#tint(float) + * @see processing.core.PGraphics#background(float, float, float, float) + * @see processing.core.PGraphics#alpha(int) + */ public void image(PImage image, float x, float y, float c, float d) { image(image, x, y, c, d, 0, 0, image.width, image.height); } @@ -2200,7 +2609,7 @@ public class PGraphics extends PImage implements PConstants { /** * Draw an image(), also specifying u/v coordinates. - * In this method, the u, v coordinates are always based on image space + * In this method, the u, v coordinates are always based on image space * location, regardless of the current textureMode(). */ public void image(PImage image, @@ -2310,8 +2719,24 @@ public class PGraphics extends PImage implements PConstants { /** - * Set the orientation for the shape() command (like imageMode() or rectMode()). - * @param mode Either CORNER, CORNERS, or CENTER. + * Modifies the location from which shapes draw. + * The default mode is shapeMode(CORNER), which specifies the + * location to be the upper left corner of the shape and uses the third + * and fourth parameters of shape() to specify the width and height. + * The syntax shapeMode(CORNERS) uses the first and second parameters + * of shape() to set the location of one corner and uses the third + * and fourth parameters to set the opposite corner. + * The syntax shapeMode(CENTER) draws the shape from its center point + * and uses the third and forth parameters of shape() to specify the + * width and height. + * The parameter must be written in "ALL CAPS" because Processing syntax + * is case sensitive. + * + * @param mode One of CORNER, CORNERS, CENTER + * + * @webref shape:loading_displaying + * @see PGraphics#shape(PShape) + * @see PGraphics#rectMode(int) */ public void shapeMode(int mode) { this.shapeMode = mode; @@ -2354,6 +2779,35 @@ public class PGraphics extends PImage implements PConstants { } + /** + * Displays shapes to the screen. The shapes must be in the sketch's "data" + * directory to load correctly. Select "Add file..." from the "Sketch" menu + * to add the shape. + * Processing currently works with SVG shapes only. + * The sh parameter specifies the shape to display and the x + * and y parameters define the location of the shape from its + * upper-left corner. + * The shape is displayed at its original size unless the width + * and height parameters specify a different size. + * The shapeMode() function changes the way the parameters work. + * A call to shapeMode(CORNERS), 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 P2D, P3D, and OPENGL. Those + * renderers do not yet support shapes that have holes or complicated breaks. + * + * @param shape + * @param x x-coordinate of the shape + * @param y y-coordinate of the shape + * @param c width to display the shape + * @param d height to display the shape + * + * @webref shape:loading_displaying + * @see PShape + * @see PGraphics#loadShape(String) + * @see PGraphics#shapeMode(int) + */ public void shape(PShape shape, float x, float y, float c, float d) { if (shape.isVisible()) { // don't do expensive matrix ops if invisible pushMatrix(); @@ -2415,7 +2869,7 @@ public class PGraphics extends PImage implements PConstants { */ public float textAscent() { if (textFont == null) { - showTextFontException("textAscent"); + defaultFontOrDeath("textAscent"); } return textFont.ascent() * ((textMode == SCREEN) ? textFont.size : textSize); } @@ -2428,7 +2882,7 @@ public class PGraphics extends PImage implements PConstants { */ public float textDescent() { if (textFont == null) { - showTextFontException("textDescent"); + defaultFontOrDeath("textDescent"); } return textFont.descent() * ((textMode == SCREEN) ? textFont.size : textSize); } @@ -2548,17 +3002,11 @@ public class PGraphics extends PImage implements PConstants { * Sets the text size, also resets the value for the leading. */ public void textSize(float size) { - if (textFont != null) { -// if ((textMode == SCREEN) && (size != textFont.size)) { -// throw new RuntimeException("textSize() is ignored with " + -// "textMode(SCREEN)"); -// } - textSize = size; - textLeading = (textAscent() + textDescent()) * 1.275f; - - } else { - showTextFontException("textSize"); + if (textFont == null) { + defaultFontOrDeath("textSize", size); } + textSize = size; + textLeading = (textAscent() + textDescent()) * 1.275f; } @@ -2577,7 +3025,7 @@ public class PGraphics extends PImage implements PConstants { */ public float textWidth(String str) { if (textFont == null) { - showTextFontException("textWidth"); + defaultFontOrDeath("textWidth"); } int length = str.length(); @@ -2604,14 +3052,14 @@ public class PGraphics extends PImage implements PConstants { } - /** + /** * TODO not sure if this stays... */ public float textWidth(char[] chars, int start, int length) { return textWidthImpl(chars, start, start + length); } - - + + /** * Implementation of returning the text width of * the chars [start, stop) in the buffer. @@ -2646,7 +3094,7 @@ public class PGraphics extends PImage implements PConstants { */ public void text(char c, float x, float y) { if (textFont == null) { - showTextFontException("text"); + defaultFontOrDeath("text"); } if (textMode == SCREEN) loadPixels(); @@ -2702,7 +3150,7 @@ public class PGraphics extends PImage implements PConstants { */ public void text(String str, float x, float y) { if (textFont == null) { - showTextFontException("text"); + defaultFontOrDeath("text"); } if (textMode == SCREEN) loadPixels(); @@ -2717,9 +3165,9 @@ public class PGraphics extends PImage implements PConstants { /** - * Method to draw text from an array of chars. This method will usually be - * more efficient than drawing from a String object, because the String will - * not be converted to a char array before drawing. + * Method to draw text from an array of chars. This method will usually be + * more efficient than drawing from a String object, because the String will + * not be converted to a char array before drawing. */ public void text(char[] chars, int start, int stop, float x, float y) { // If multiple lines, sum the height of the additional lines @@ -2776,7 +3224,7 @@ public class PGraphics extends PImage implements PConstants { } - public void text(char[] chars, int start, int stop, + public void text(char[] chars, int start, int stop, float x, float y, float z) { if (z != 0) translate(0, 0, z); // slow! @@ -2785,8 +3233,8 @@ public class PGraphics extends PImage implements PConstants { if (z != 0) translate(0, 0, -z); // inaccurate! } - - + + /** * Draw text in a box that is constrained to a particular size. * The current rectMode() determines what the coordinates mean @@ -2802,7 +3250,7 @@ public class PGraphics extends PImage implements PConstants { */ public void text(String str, float x1, float y1, float x2, float y2) { if (textFont == null) { - showTextFontException("text"); + defaultFontOrDeath("text"); } if (textMode == SCREEN) loadPixels(); @@ -3080,35 +3528,32 @@ public class PGraphics extends PImage implements PConstants { protected void textCharImpl(char ch, float x, float y) { //, float z) { - int index = textFont.index(ch); - if (index == -1) return; + PFont.Glyph glyph = textFont.getGlyph(ch); + if (glyph != null) { + if (textMode == MODEL) { + float high = glyph.height / (float) textFont.size; + float bwidth = glyph.width / (float) textFont.size; + float lextent = glyph.leftExtent / (float) textFont.size; + float textent = glyph.topExtent / (float) textFont.size; - PImage glyph = textFont.images[index]; + float x1 = x + lextent * textSize; + float y1 = y - textent * textSize; + float x2 = x1 + bwidth * textSize; + float y2 = y1 + high * textSize; - if (textMode == MODEL) { - float high = (float) textFont.height[index] / textFont.fheight; - float bwidth = (float) textFont.width[index] / textFont.fwidth; - float lextent = (float) textFont.leftExtent[index] / textFont.fwidth; - float textent = (float) textFont.topExtent[index] / textFont.fheight; + textCharModelImpl(glyph.image, + x1, y1, x2, y2, + glyph.width, glyph.height); - float x1 = x + lextent * textSize; - float y1 = y - textent * textSize; - float x2 = x1 + bwidth * textSize; - float y2 = y1 + high * textSize; + } else if (textMode == SCREEN) { + int xx = (int) x + glyph.leftExtent; + int yy = (int) y - glyph.topExtent; - textCharModelImpl(glyph, - x1, y1, x2, y2, - //x1, y1, z, x2, y2, z, - textFont.width[index], textFont.height[index]); + int w0 = glyph.width; + int h0 = glyph.height; - } else if (textMode == SCREEN) { - int xx = (int) x + textFont.leftExtent[index];; - int yy = (int) y - textFont.topExtent[index]; - - int w0 = textFont.width[index]; - int h0 = textFont.height[index]; - - textCharScreenImpl(glyph, xx, yy, w0, h0); + textCharScreenImpl(glyph.image, xx, yy, w0, h0); + } } } @@ -3181,7 +3626,8 @@ public class PGraphics extends PImage implements PConstants { // TODO this can be optimized a bit for (int row = y0; row < y0 + h0; row++) { for (int col = x0; col < x0 + w0; col++) { - int a1 = (fa * pixels1[row * textFont.twidth + col]) >> 8; + //int a1 = (fa * pixels1[row * textFont.twidth + col]) >> 8; + int a1 = (fa * pixels1[row * glyph.width + col]) >> 8; int a2 = a1 ^ 0xff; //int p1 = pixels1[row * glyph.width + col]; int p2 = pixels[(yy + row-y0)*width + (xx+col-x0)]; @@ -3801,6 +4247,14 @@ public class PGraphics extends PImage implements PConstants { // STROKE COLOR + /** + * Disables drawing the stroke (outline). If both noStroke() and + * noFill() are called, no shapes will be drawn to the screen. + * + * @webref color:setting + * + * @see PGraphics#stroke(float, float, float, float) + */ public void noStroke() { stroke = false; } @@ -3809,33 +4263,25 @@ public class PGraphics extends PImage implements PConstants { /** * Set the tint to either a grayscale or ARGB value. * See notes attached to the fill() function. + * @param rgb color value in hexadecimal notation + * (i.e. #FFCC00 or 0xFFFFCC00) or any value of the color datatype */ public void stroke(int rgb) { -// if (((rgb & 0xff000000) == 0) && (rgb <= colorModeX)) { // see above -// stroke((float) rgb); -// -// } else { -// colorCalcARGB(rgb, colorModeA); -// strokeFromCalc(); -// } colorCalc(rgb); strokeFromCalc(); } public void stroke(int rgb, float alpha) { -// if (((rgb & 0xff000000) == 0) && (rgb <= colorModeX)) { -// stroke((float) rgb, alpha); -// -// } else { -// colorCalcARGB(rgb, alpha); -// strokeFromCalc(); -// } colorCalc(rgb, alpha); strokeFromCalc(); } + /** + * + * @param gray specifies a value between white and black + */ public void stroke(float gray) { colorCalc(gray); strokeFromCalc(); @@ -3854,6 +4300,28 @@ public class PGraphics extends PImage implements PConstants { } + /** + * Sets the color used to draw lines and borders around shapes. This color + * is either specified in terms of the RGB or HSB color depending on the + * current colorMode() (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 CSS). + * When using the hexadecimal notation starting with "0x", the 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 colorMode(). + * The default maximum value is 255. + * + * @webref color:setting + * @param alpha opacity of the stroke + * @param x red or hue value (depending on the current color mode) + * @param y green or saturation value (depending on the current color mode) + * @param z blue or brightness value (depending on the current color mode) + */ public void stroke(float x, float y, float z, float a) { colorCalc(x, y, z, a); strokeFromCalc(); @@ -3881,6 +4349,13 @@ public class PGraphics extends PImage implements PConstants { // TINT COLOR + /** + * Removes the current fill value for displaying images and reverts to displaying images with their original hues. + * + * @webref image:loading_displaying + * @see processing.core.PGraphics#tint(float, float, float, float) + * @see processing.core.PGraphics#image(PImage, float, float, float, float) + */ public void noTint() { tint = false; } @@ -3890,29 +4365,25 @@ public class PGraphics extends PImage implements PConstants { * Set the tint to either a grayscale or ARGB value. */ public void tint(int rgb) { -// if (((rgb & 0xff000000) == 0) && (rgb <= colorModeX)) { -// tint((float) rgb); -// -// } else { -// colorCalcARGB(rgb, colorModeA); -// tintFromCalc(); -// } colorCalc(rgb); tintFromCalc(); } + + /** + * @param rgb color value in hexadecimal notation + * (i.e. #FFCC00 or 0xFFFFCC00) or any value of the color datatype + * @param alpha opacity of the image + */ public void tint(int rgb, float alpha) { -// if (((rgb & 0xff000000) == 0) && (rgb <= colorModeX)) { -// tint((float) rgb, alpha); -// -// } else { -// colorCalcARGB(rgb, alpha); -// tintFromCalc(); -// } colorCalc(rgb, alpha); tintFromCalc(); } + + /** + * @param gray any valid number + */ public void tint(float gray) { colorCalc(gray); tintFromCalc(); @@ -3931,6 +4402,35 @@ public class PGraphics extends PImage 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 + * colorMode() 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 CSS). + * When using the hexadecimal notation starting with "0x", the 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 colorMode(). + * The default maximum value is 255. + *

    The tint() method is also used to control the coloring of + * textures in 3D. + * + * @webref image:loading_displaying + * @param x red or hue value + * @param y green or saturation value + * @param z blue or brightness value + * + * @see processing.core.PGraphics#noTint() + * @see processing.core.PGraphics#image(PImage, float, float, float, float) + */ public void tint(float x, float y, float z, float a) { colorCalc(x, y, z, a); tintFromCalc(); @@ -3958,6 +4458,15 @@ public class PGraphics extends PImage implements PConstants { // FILL COLOR + /** + * Disables filling geometry. If both noStroke() and noFill() + * are called, no shapes will be drawn to the screen. + * + * @webref color:setting + * + * @see PGraphics#fill(float, float, float, float) + * + */ public void noFill() { fill = false; } @@ -3965,33 +4474,23 @@ public class PGraphics extends PImage implements PConstants { /** * Set the fill to either a grayscale value or an ARGB int. + * @param rgb color value in hexadecimal notation (i.e. #FFCC00 or 0xFFFFCC00) or any value of the color datatype */ public void fill(int rgb) { -// if (((rgb & 0xff000000) == 0) && (rgb <= colorModeX)) { // see above -// fill((float) rgb); -// -// } else { -// colorCalcARGB(rgb, colorModeA); -// fillFromCalc(); -// } colorCalc(rgb); fillFromCalc(); } public void fill(int rgb, float alpha) { -// if (((rgb & 0xff000000) == 0) && (rgb <= colorModeX)) { // see above -// fill((float) rgb, alpha); -// -// } else { -// colorCalcARGB(rgb, alpha); -// fillFromCalc(); -// } colorCalc(rgb, alpha); fillFromCalc(); } + /** + * @param gray number specifying value between white and black + */ public void fill(float gray) { colorCalc(gray); fillFromCalc(); @@ -4010,6 +4509,24 @@ public class PGraphics extends PImage implements PConstants { } + /** + * Sets the color used to fill shapes. For example, if you run fill(204, 102, 0), all subsequent shapes will be filled with orange. This color is either specified in terms of the RGB or HSB color depending on the current colorMode() (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 CSS). When using the hexadecimal notation starting with "0x", the 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 colorMode(). The default maximum value is 255. + *

    To change the color of an image (or a texture), use tint(). + * + * @webref color:setting + * @param x red or hue value + * @param y green or saturation value + * @param z blue or brightness value + * @param alpha opacity of the fill + * + * @see PGraphics#noFill() + * @see PGraphics#stroke(float) + * @see PGraphics#tint(float) + * @see PGraphics#background(float, float, float, float) + * @see PGraphics#colorMode(int, float, float, float, float) + */ public void fill(float x, float y, float z, float a) { colorCalc(x, y, z, a); fillFromCalc(); @@ -4196,6 +4713,7 @@ public class PGraphics extends PImage implements PConstants { // BACKGROUND + /** * Set the background to a gray or ARGB color. *

    @@ -4206,6 +4724,8 @@ public class PGraphics extends PImage implements PConstants { * Note that background() should be called before any transformations occur, * because some implementations may require the current transformation matrix * to be identity before drawing. + * + * @param rgb color value in hexadecimal notation (i.e. #FFCC00 or 0xFFFFCC00)
    or any value of the color datatype */ public void background(int rgb) { // if (((rgb & 0xff000000) == 0) && (rgb <= colorModeX)) { @@ -4259,6 +4779,8 @@ public class PGraphics extends PImage implements PConstants { /** * See notes about alpha in background(x, y, z, a). + * @param gray specifies a value between white and black + * @param alpha opacity of the background */ public void background(float gray, float alpha) { if (format == RGB) { @@ -4284,15 +4806,30 @@ public class PGraphics extends PImage implements PConstants { /** - * Clear the background with a color that includes an alpha value. This can + * The background() function sets the color used for the background of the Processing window. The default background is light gray. In the draw() 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 tint() setting. + *

    It is not possible to use transparency (alpha) in background colors with the main drawing surface, however they will work properly with createGraphics. + * + * =advanced + *

    Clear the background with a color that includes an alpha value. This can * only be used with objects created by createGraphics(), because the main - * drawing surface cannot be set transparent. - *

    - * It might be tempting to use this function to partially clear the screen + * drawing surface cannot be set transparent.

    + *

    It might be tempting to use this function to partially clear the screen * on each frame, however that's not how this function works. When calling * background(), the pixels will be replaced with pixels that have that level * of transparency. To do a semi-transparent overlay, use fill() with alpha - * and draw a rectangle. + * and draw a rectangle.

    + * + * @webref color:setting + * @param x red or hue value (depending on the current color mode) + * @param y green or saturation value (depending on the current color mode) + * @param z blue or brightness value (depending on the current color mode) + * + * @see PGraphics#stroke(float) + * @see PGraphics#fill(float) + * @see PGraphics#tint(float) + * @see PGraphics#colorMode(int) */ public void background(float x, float y, float z, float a) { // if (format == RGB) { @@ -4406,6 +4943,10 @@ public class PGraphics extends PImage implements PConstants { // COLOR MODE + /** + * @param mode Either RGB or HSB, corresponding to Red/Green/Blue and Hue/Saturation/Brightness + * @param max range for all color elements + */ public void colorMode(int mode) { colorMode(mode, colorModeX, colorModeY, colorModeZ, colorModeA); } @@ -4430,6 +4971,19 @@ public class PGraphics extends PImage implements PConstants { } + /** + * Changes the way Processing interprets color data. By default, the parameters for fill(), stroke(), background(), and color() are defined by values between 0 and 255 using the RGB color model. The colorMode() function is used to change the numerical range used for specifying colors and to switch color systems. For example, calling colorMode(RGB, 1.0) will specify that values are specified between 0 and 1. The limits for defining colors are altered by setting the parameters range1, range2, range3, and range 4. + * + * @webref color:setting + * @param maxX range for the red or hue depending on the current color mode + * @param maxY range for the green or saturation depending on the current color mode + * @param maxZ range for the blue or brightness depending on the current color mode + * @param maxA range for the alpha + * + * @see PGraphics#background(float) + * @see PGraphics#fill(float) + * @see PGraphics#stroke(float) + */ public void colorMode(int mode, float maxX, float maxY, float maxZ, float maxA) { colorMode = mode; @@ -4744,6 +5298,12 @@ public class PGraphics extends PImage implements PConstants { // Vee have veys of making the colors talk. + /** + * Extracts the alpha value from a color. + * + * @webref color:creating_reading + * @param what any value of the color datatype + */ public final float alpha(int what) { float c = (what >> 24) & 0xff; if (colorModeA == 255) return c; @@ -4751,6 +5311,19 @@ public class PGraphics extends PImage implements PConstants { } + /** + * Extracts the red value from a color, scaled to match current colorMode(). This value is always returned as a float so be careful not to assign it to an int value.

    The red() function is easy to use and undestand, but is slower than another technique. To achieve the same results when working in colorMode(RGB, 255), but with greater speed, use the >> (right shift) operator with a bit mask. For example, the following two lines of code are equivalent:
    float r1 = red(myColor);
    float r2 = myColor >> 16 & 0xFF;
    + * + * @webref color:creating_reading + * @param what any value of the color datatype + * + * @see PGraphics#green(int) + * @see PGraphics#blue(int) + * @see PGraphics#hue(int) + * @see PGraphics#saturation(int) + * @see PGraphics#brightness(int) + * @ref rightshift + */ public final float red(int what) { float c = (what >> 16) & 0xff; if (colorModeDefault) return c; @@ -4758,6 +5331,19 @@ public class PGraphics extends PImage implements PConstants { } + /** + * Extracts the green value from a color, scaled to match current colorMode(). This value is always returned as a float so be careful not to assign it to an int value.

    The green() function is easy to use and undestand, but is slower than another technique. To achieve the same results when working in colorMode(RGB, 255), but with greater speed, use the >> (right shift) operator with a bit mask. For example, the following two lines of code are equivalent:
    float r1 = green(myColor);
    float r2 = myColor >> 8 & 0xFF;
    + * + * @webref color:creating_reading + * @param what any value of the color datatype + * + * @see PGraphics#red(int) + * @see PGraphics#blue(int) + * @see PGraphics#hue(int) + * @see PGraphics#saturation(int) + * @see PGraphics#brightness(int) + * @ref rightshift + */ public final float green(int what) { float c = (what >> 8) & 0xff; if (colorModeDefault) return c; @@ -4765,6 +5351,18 @@ public class PGraphics extends PImage implements PConstants { } + /** + * Extracts the blue value from a color, scaled to match current colorMode(). This value is always returned as a float so be careful not to assign it to an int value.

    The blue() function is easy to use and undestand, but is slower than another technique. To achieve the same results when working in colorMode(RGB, 255), but with greater speed, use a bit mask to remove the other color components. For example, the following two lines of code are equivalent:
    float r1 = blue(myColor);
    float r2 = myColor & 0xFF;
    + * + * @webref color:creating_reading + * @param what any value of the color datatype + * + * @see PGraphics#red(int) + * @see PGraphics#green(int) + * @see PGraphics#hue(int) + * @see PGraphics#saturation(int) + * @see PGraphics#brightness(int) + */ public final float blue(int what) { float c = (what) & 0xff; if (colorModeDefault) return c; @@ -4772,6 +5370,18 @@ public class PGraphics extends PImage implements PConstants { } + /** + * Extracts the hue value from a color. + * + * @webref color:creating_reading + * @param what any value of the color datatype + * + * @see PGraphics#red(int) + * @see PGraphics#green(int) + * @see PGraphics#blue(int) + * @see PGraphics#saturation(int) + * @see PGraphics#brightness(int) + */ public final float hue(int what) { if (what != cacheHsbKey) { Color.RGBtoHSB((what >> 16) & 0xff, (what >> 8) & 0xff, @@ -4782,6 +5392,18 @@ public class PGraphics extends PImage implements PConstants { } + /** + * Extracts the saturation value from a color. + * + * @webref color:creating_reading + * @param what any value of the color datatype + * + * @see PGraphics#red(int) + * @see PGraphics#green(int) + * @see PGraphics#blue(int) + * @see PGraphics#hue(int) + * @see PGraphics#brightness(int) + */ public final float saturation(int what) { if (what != cacheHsbKey) { Color.RGBtoHSB((what >> 16) & 0xff, (what >> 8) & 0xff, @@ -4792,6 +5414,19 @@ public class PGraphics extends PImage implements PConstants { } + /** + * Extracts the brightness value from a color. + * + * + * @webref color:creating_reading + * @param what any value of the color datatype + * + * @see PGraphics#red(int) + * @see PGraphics#green(int) + * @see PGraphics#blue(int) + * @see PGraphics#hue(int) + * @see PGraphics#saturation(int) + */ public final float brightness(int what) { if (what != cacheHsbKey) { Color.RGBtoHSB((what >> 16) & 0xff, (what >> 8) & 0xff, @@ -4811,7 +5446,15 @@ public class PGraphics extends PImage implements PConstants { /** - * Interpolate between two colors, using the current color mode. + * Calculates a color or colors between two color at a specific increment. The amt parameter is the amount to interpolate between the two values where 0.0 equal to the first point, 0.1 is very near the first point, 0.5 is half-way in between, etc. + * + * @webref color:creating_reading + * @param c1 interpolate from this color + * @param c2 interpolate to this color + * @param amt between 0.0 and 1.0 + * + * @see PGraphics#blendColor(int, int, int) + * @see PGraphics#color(float, float, float, float) */ public int lerpColor(int c1, int c2, float amt) { return lerpColor(c1, c2, amt, colorMode); @@ -5007,11 +5650,24 @@ public class PGraphics extends PImage implements PConstants { /** - * Throw an exeption that halts the program because textFont() has not been - * used prior to the specified method. + * Same as below, but defaults to a 12 point font, just as MacWrite intended. */ - static protected void showTextFontException(String method) { - throw new RuntimeException("Use textFont() before " + method + "()"); + protected void defaultFontOrDeath(String method) { + defaultFontOrDeath(method, 12); + } + + + /** + * First try to create a default font, but if that's not possible, throw + * an exception that halts the program because textFont() has not been used + * prior to the specified method. + */ + protected void defaultFontOrDeath(String method, float size) { + if (parent != null) { + textFont = parent.createDefaultFont(size); + } else { + throw new RuntimeException("Use textFont() before " + method + "()"); + } } diff --git a/core/src/processing/core/PGraphics3D.java b/core/src/processing/core/PGraphics3D.java index 57dde4343..2a47d9547 100644 --- a/core/src/processing/core/PGraphics3D.java +++ b/core/src/processing/core/PGraphics3D.java @@ -52,9 +52,13 @@ public class PGraphics3D extends PGraphics { /** Inverse modelview matrix, used for lighting. */ public PMatrix3D modelviewInv; - /** - * The camera matrix, the modelview will be set to this on beginDraw. + /** + * Marks when changes to the size have occurred, so that the camera + * will be reset in beginDraw(). */ + protected boolean sizeChanged; + + /** The camera matrix, the modelview will be set to this on beginDraw. */ public PMatrix3D camera; /** Inverse camera matrix */ @@ -306,6 +310,9 @@ public class PGraphics3D extends PGraphics { * the pixel buffer for the new size. * * Note that this will nuke any cameraMode() settings. + * + * No drawing can happen in this function, and no talking to the graphics + * context. That is, no glXxxx() calls, or other things that change state. */ public void setSize(int iwidth, int iheight) { // ignore width = iwidth; @@ -357,13 +364,8 @@ public class PGraphics3D extends PGraphics { camera = new PMatrix3D(); cameraInv = new PMatrix3D(); - // set up the default camera -// camera(); - - // defaults to perspective, if the user has setup up their - // own projection, they'll need to fix it after resize anyway. - // this helps the people who haven't set up their own projection. -// perspective(); + // set this flag so that beginDraw() will do an update to the camera. + sizeChanged = true; } @@ -409,6 +411,19 @@ public class PGraphics3D extends PGraphics { // beginDraw/endDraw). if (!settingsInited) defaultSettings(); + if (sizeChanged) { + // set up the default camera + camera(); + + // defaults to perspective, if the user has setup up their + // own projection, they'll need to fix it after resize anyway. + // this helps the people who haven't set up their own projection. + perspective(); + + // clear the flag + sizeChanged = false; + } + resetMatrix(); // reset model matrix // reset vertices @@ -437,6 +452,7 @@ public class PGraphics3D extends PGraphics { shapeFirst = 0; // reset textures + Arrays.fill(textures, null); textureIndex = 0; normal(0, 0, 1); @@ -1350,7 +1366,10 @@ public class PGraphics3D extends PGraphics { boolean bClipped = false; int clippedCount = 0; -// cameraNear = -8; + // This is a hack for temporary clipping. Clipping still needs to + // be implemented properly, however. Please help! + // http://dev.processing.org/bugs/show_bug.cgi?id=1393 + cameraNear = -8; if (vertices[a][VZ] > cameraNear) { aClipped = true; clippedCount++; @@ -1364,15 +1383,15 @@ public class PGraphics3D extends PGraphics { clippedCount++; } if (clippedCount == 0) { -// if (vertices[a][VZ] < cameraFar && -// vertices[b][VZ] < cameraFar && +// if (vertices[a][VZ] < cameraFar && +// vertices[b][VZ] < cameraFar && // vertices[c][VZ] < cameraFar) { addTriangleWithoutClip(a, b, c); // } // } else if (true) { // return; - + } else if (clippedCount == 3) { // In this case there is only one visible point. |/| // So we'll have to make two new points on the clip line <| | diff --git a/core/src/processing/core/PGraphicsJava2D.java b/core/src/processing/core/PGraphicsJava2D.java index c45ae77ca..f72a566bb 100644 --- a/core/src/processing/core/PGraphicsJava2D.java +++ b/core/src/processing/core/PGraphicsJava2D.java @@ -967,6 +967,9 @@ public class PGraphicsJava2D extends PGraphics /*PGraphics2D*/ { public float textAscent() { + if (textFont == null) { + defaultFontOrDeath("textAscent"); + } Font font = textFont.getFont(); if (font == null) { return super.textAscent(); @@ -977,6 +980,9 @@ public class PGraphicsJava2D extends PGraphics /*PGraphics2D*/ { public float textDescent() { + if (textFont == null) { + defaultFontOrDeath("textAscent"); + } Font font = textFont.getFont(); if (font == null) { return super.textDescent(); @@ -1010,6 +1016,10 @@ public class PGraphicsJava2D extends PGraphics /*PGraphics2D*/ { * will get recorded properly. */ public void textSize(float size) { + if (textFont == null) { + defaultFontOrDeath("textAscent", size); + } + // if a native version available, derive this font // if (textFontNative != null) { // textFontNative = textFontNative.deriveFont(size); diff --git a/core/src/processing/core/PImage.java b/core/src/processing/core/PImage.java index c1b38f095..c9fa24780 100644 --- a/core/src/processing/core/PImage.java +++ b/core/src/processing/core/PImage.java @@ -31,13 +31,31 @@ import java.util.HashMap; import javax.imageio.ImageIO; + + /** + * Datatype for storing images. Processing can display .gif, .jpg, .tga, and .png images. Images may be displayed in 2D and 3D space. + * Before an image is used, it must be loaded with the loadImage() function. + * The PImage object contains fields for the width and height of the image, + * as well as an array called pixels[] which contains the values for every pixel in the image. + * A group of methods, described below, allow easy access to the image's pixels and alpha channel and simplify the process of compositing. + *

    Before using the pixels[] array, be sure to use the loadPixels() method on the image to make sure that the pixel data is properly loaded. + *

    To create a new image, use the createImage() function (do not use new PImage()). + * =advanced + * * Storage class for pixel data. This is the base class for most image and * pixel information, such as PGraphics and the video library classes. *

    * Code for copying, resizing, scaling, and blending contributed * by toxi. *

    + * + * @webref image + * @usage Web & Application + * @instanceName img any variable of type PImage + * @see processing.core.PApplet#loadImage(String) + * @see processing.core.PGraphics#imageMode(int) + * @see processing.core.PApplet#createImage(int, int) */ public class PImage implements PConstants, Cloneable { @@ -48,8 +66,32 @@ public class PImage implements PConstants, Cloneable { */ public int format; + /** + * Array containing the values for all the pixels in the image. These values are of the color datatype. + * This array is the size of the image, meaning if the image is 100x100 pixels, there will be 10000 values + * and if the window is 200x300 pixels, there will be 60000 values. + * The index value defines the position of a value within the array. + * For example, the statement color b = img.pixels[230] will set the variable b equal to the value at that location in the array. + * Before accessing this array, the data must loaded with the loadPixels() method. + * After the array data has been modified, the updatePixels() method must be run to update the changes. + * Without loadPixels(), running the code may (or will in future releases) result in a NullPointerException. + * @webref + * @brief Array containing the color of every pixel in the image + */ public int[] pixels; - public int width, height; + + /** + * The width of the image in units of pixels. + * @webref + * @brief Image width + */ + public int width; + /** + * The height of the image in units of pixels. + * @webref + * @brief Image height + */ + public int height; /** * Path to parent object that will be used with save(). @@ -125,7 +167,12 @@ public class PImage implements PConstants, Cloneable { // toxi: agreed and same reasons why i left it out ;) } - + /** + * + * @param width image width + * @param height image height + * @param format Either RGB, ARGB, ALPHA (grayscale alpha channel) + */ public PImage(int width, int height, int format) { init(width, height, format); } @@ -171,6 +218,8 @@ public class PImage implements PConstants, Cloneable { * Construct a new PImage from a java.awt.Image. This constructor assumes * that you've done the work of making sure a MediaTracker has been used * to fully download the data and that the img is valid. + * + * @param img assumes a MediaTracker has been used to fully download the data and the img is valid */ public PImage(java.awt.Image img) { if (img instanceof BufferedImage) { @@ -275,31 +324,39 @@ public class PImage implements PConstants, Cloneable { /** + * Loads the pixel data for the image into its pixels[] array. This function must always be called before reading from or writing to pixels[]. + *

    Certain renderers may or may not seem to require loadPixels() or updatePixels(). However, the rule is that any time you want to manipulate the pixels[] array, you must first call loadPixels(), and after changes have been made, call updatePixels(). Even if the renderer may not seem to use this function in the current Processing release, this will always be subject to change. + * =advanced * Call this when you want to mess with the pixels[] array. *

    * For subclasses where the pixels[] buffer isn't set by default, * this should copy all data into the pixels[] array + * + * @webref + * @brief Loads the pixel data for the image into its pixels[] array */ public void loadPixels() { // ignore } - - /** - * Call this when finished messing with the pixels[] array. - *

    - * Mark all pixels as needing update. - */ public void updatePixels() { // ignore updatePixelsImpl(0, 0, width, height); } - /** + * Updates the image with the data in its pixels[] array. Use in conjunction with loadPixels(). If you're only reading pixels from the array, there's no need to call updatePixels(). + *

    Certain renderers may or may not seem to require loadPixels() or updatePixels(). However, the rule is that any time you want to manipulate the pixels[] array, you must first call loadPixels(), and after changes have been made, call updatePixels(). 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 updatePixels(), however this may be implemented in the future. + * =advanced * Mark the pixels in this region as needing an update. - *

    * This is not currently used by any of the renderers, however the api * is structured this way in the hope of being able to use this to * speed things up in the future. + * @webref + * @brief Updates the image with the data in its pixels[] array + * @param x + * @param y + * @param w + * @param h */ public void updatePixels(int x, int y, int w, int h) { // ignore // if (imageMode == CORNER) { // x2, y2 are w/h @@ -369,8 +426,14 @@ public class PImage implements PConstants, Cloneable { /** - * Resize this image to a new width and height. - * Use 0 for wide or high to make that dimension scale proportionally. + * Resize the image to a new width and height. To make the image scale proportionally, use 0 as the value for the wide or high parameter. + * + * @webref + * @brief Changes the size of an image to a new width and height + * @param wide the resized image width + * @param high the resized image height + * + * @see processing.core.PImage#get(int, int, int, int) */ public void resize(int wide, int high) { // ignore // Make sure that the pixels[] array is valid @@ -442,8 +505,20 @@ public class PImage implements PConstants, Cloneable { /** - * Grab a subsection of a PImage, and copy it into a fresh PImage. - * As of release 0149, no longer honors imageMode() for the coordinates. + * Reads the color of any pixel or grabs a group of pixels. If no parameters are specified, the entire image is returned. Get the value of one pixel by specifying an x,y coordinate. Get a section of the display window by specifing an additional width and height parameter. 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. Even though you may have drawn a shape with colorMode(HSB), the numbers returned will be in RGB. + *

    Getting the color of a single pixel with get(x, y) is easy, but not as fast as grabbing the data directly from pixels[]. The equivalent statement to "get(x, y)" using pixels[] is "pixels[y*width+x]". Processing requires calling loadPixels() to load the display window data into the pixels[] array before getting the values. + *

    As of release 0149, this function ignores imageMode(). + * + * @webref + * @brief Reads the color of any pixel or grabs a rectangle of pixels + * @param x x-coordinate of the pixel + * @param y y-coordinate of the pixel + * @param w width of pixel rectangle to get + * @param h height of pixel rectangle to get + * + * @see processing.core.PImage#set(int, int, int) + * @see processing.core.PImage#pixels + * @see processing.core.PImage#copy(PImage, int, int, int, int, int, int, int, int) */ public PImage get(int x, int y, int w, int h) { /* @@ -512,7 +587,17 @@ public class PImage implements PConstants, Cloneable { /** - * Set a single pixel to the specified color. + * Changes the color of any pixel or writes an image directly into the display window. The x and y parameters specify the pixel to change and the color 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 x and y parameters define the coordinates for the upper-left corner of the image. + *

    Setting the color of a single pixel with set(x, y) is easy, but not as fast as putting the data directly into pixels[]. The equivalent statement to "set(x, y, #000000)" using pixels[] is "pixels[y*width+x] = #000000". You must call loadPixels() to load the display window data into the pixels[] array before setting the values and calling updatePixels() to update the window with any changes. + *

    As of release 1.0, this function ignores imageMode(). + *

    Due to what appears to be a bug in Apple's Java implementation, the point() and set() methods are extremely slow in some circumstances when used with the default renderer. Using P2D or P3D will fix the problem. Grouping many calls to point() or set() together can also help. (Bug 1094) + * =advanced + *

    As of release 0149, this function ignores imageMode(). + * + * @webref image:pixels + * @param x x-coordinate of the pixel + * @param y y-coordinate of the pixel + * @param c any value of the color datatype */ public void set(int x, int y, int c) { if ((x < 0) || (y < 0) || (x >= width) || (y >= height)) return; @@ -594,18 +679,20 @@ public class PImage implements PConstants, Cloneable { * used as the alpha color. For a fully grayscale image, this * is correct, but for a color image it's not 100% accurate. * For a more accurate conversion, first use filter(GRAY) - * which will make the image into a "correct" grayscake by + * which will make the image into a "correct" grayscale by * performing a proper luminance-based conversion. + * + * @param maskArray any array of Integer numbers used as the alpha channel, needs to be same length as the image's pixel array */ - public void mask(int alpha[]) { + public void mask(int maskArray[]) { loadPixels(); // don't execute if mask image is different size - if (alpha.length != pixels.length) { + if (maskArray.length != pixels.length) { throw new RuntimeException("The PImage used with mask() must be " + "the same size as the applet."); } for (int i = 0; i < pixels.length; i++) { - pixels[i] = ((alpha[i] & 0xff) << 24) | (pixels[i] & 0xffffff); + pixels[i] = ((maskArray[i] & 0xff) << 24) | (pixels[i] & 0xffffff); } format = ARGB; updatePixels(); @@ -613,10 +700,19 @@ public class PImage implements PConstants, Cloneable { /** - * Set alpha channel for an image using another image as the source. + * Masks part of an image from displaying by loading another image and 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 same length as the target image's pixels array and should contain only grayscale data of values between 0-255. + * @webref + * @brief Masks part of the image from displaying + * @param maskImg any PImage object used as the alpha channel for "img", needs to be same size as "img" */ - public void mask(PImage alpha) { - mask(alpha.pixels); + public void mask(PImage maskImg) { + maskImg.loadPixels(); + mask(maskImg.pixels); } @@ -624,26 +720,6 @@ public class PImage implements PConstants, Cloneable { ////////////////////////////////////////////////////////////// // IMAGE FILTERS - - - /** - * Method to apply a variety of basic filters to this image. - *

    - *

      - *
    • filter(BLUR) provides a basic blur. - *
    • filter(GRAY) converts the image to grayscale based on luminance. - *
    • filter(INVERT) will invert the color components in the image. - *
    • filter(OPAQUE) set all the high bits in the image to opaque - *
    • filter(THRESHOLD) converts the image to black and white. - *
    • filter(DILATE) grow white/light areas - *
    • filter(ERODE) shrink white/light areas - *
    - * Luminance conversion code contributed by - * toxi - *

    - * Gaussian blur code contributed by - * Mario Klingemann - */ public void filter(int kind) { loadPixels(); @@ -716,20 +792,29 @@ public class PImage implements PConstants, Cloneable { /** + * Filters an image as defined by one of the following modes:

    THRESHOLD - converts the image to black and white pixels depending if 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 + * =advanced * Method to apply a variety of basic filters to this image. - * These filters all take a parameter. *

    *

      - *
    • filter(BLUR, int radius) performs a gaussian blur of the - * specified radius. - *
    • filter(POSTERIZE, int levels) will posterize the image to - * between 2 and 255 levels. - *
    • filter(THRESHOLD, float center) allows you to set the - * center point for the threshold. It takes a value from 0 to 1.0. + *
    • filter(BLUR) provides a basic blur. + *
    • filter(GRAY) converts the image to grayscale based on luminance. + *
    • filter(INVERT) will invert the color components in the image. + *
    • filter(OPAQUE) set all the high bits in the image to opaque + *
    • filter(THRESHOLD) converts the image to black and white. + *
    • filter(DILATE) grow white/light areas + *
    • filter(ERODE) shrink white/light areas *
    + * Luminance conversion code contributed by + * toxi + *

    * Gaussian blur code contributed by * Mario Klingemann - * and later updated by toxi for better speed. + * + * @webref + * @brief Converts the image to grayscale or black and white + * @param kind Either THRESHOLD, GRAY, INVERT, POSTERIZE, BLUR, OPAQUE, ERODE, or DILATE + * @param param in the range from 0 to 1 */ public void filter(int kind, float param) { loadPixels(); @@ -1093,7 +1178,7 @@ public class PImage implements PConstants, Cloneable { if (idxRight>=maxRowIdx) idxRight=currIdx; if (idxUp<0) - idxUp=0; + idxUp=currIdx; if (idxDown>=maxIdx) idxDown=currIdx; @@ -1150,7 +1235,7 @@ public class PImage implements PConstants, Cloneable { if (idxRight>=maxRowIdx) idxRight=currIdx; if (idxUp<0) - idxUp=0; + idxUp=currIdx; if (idxDown>=maxIdx) idxDown=currIdx; @@ -1212,7 +1297,23 @@ public class PImage implements PConstants, Cloneable { /** - * Copies area of one image into another PImage object. + * Copies a region of pixels from one image into another. If the source and destination regions aren't the same size, it will automatically resize 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 imageMode(). + * + * @webref + * @brief Copies the entire image + * @param sx X coordinate of the source's upper left corner + * @param sy Y coordinate of the source's upper left corner + * @param sw source image width + * @param sh source image height + * @param dx X coordinate of the destination's upper left corner + * @param dy Y coordinate of the destination's upper left corner + * @param dw destination image width + * @param dh destination image height + * @param src an image variable referring to the source image. + * + * @see processing.core.PGraphics#alpha(int) + * @see processing.core.PImage#blend(PImage, int, int, int, int, int, int, int, int, int) */ public void copy(PImage src, int sx, int sy, int sw, int sh, @@ -1321,6 +1422,7 @@ public class PImage implements PConstants, Cloneable { /** * Blends one area of this image to another area. + * * @see processing.core.PImage#blendColor(int,int,int) */ public void blend(int sx, int sy, int sw, int sh, @@ -1330,7 +1432,39 @@ public class PImage implements PConstants, Cloneable { /** - * Copies area of one image into another PImage object. + * Blends a region of pixels into the image specified by the img 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 srcImg parameter is not used, the display window is used as the source image.

    + * As of release 0149, this function ignores imageMode(). + * + * @webref + * @brief Copies a pixel or rectangle of pixels using different blending modes + * @param src an image variable referring to the source image + * @param sx X coordinate of the source's upper left corner + * @param sy Y coordinate of the source's upper left corner + * @param sw source image width + * @param sh source image height + * @param dx X coordinate of the destinations's upper left corner + * @param dy Y coordinate of the destinations's upper left corner + * @param dw destination image width + * @param dh destination image height + * @param mode Either BLEND, ADD, SUBTRACT, LIGHTEST, DARKEST, DIFFERENCE, EXCLUSION, MULTIPLY, SCREEN, OVERLAY, HARD_LIGHT, SOFT_LIGHT, DODGE, BURN + * + * @see processing.core.PGraphics#alpha(int) + * @see processing.core.PGraphics#copy(PImage, int, int, int, int, int, int, int, int) * @see processing.core.PImage#blendColor(int,int,int) */ public void blend(PImage src, @@ -2628,6 +2762,16 @@ public class PImage implements PConstants, Cloneable { protected String[] saveImageFormats; /** + * Saves the image into a file. Images are saved in TIFF, TARGA, JPEG, and PNG format depending on the extension within the filename parameter. + * For example, "image.tif" will have a TIFF image and "image.png" will save a PNG image. + * If no extension is included in the filename, the image will save in TIFF format and .tif will be added to the name. + * 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 save() while running the program in a web browser.

    + * To save an image created within the code, rather than through loading, it's necessary to make the image with the createImage() + * function so it is aware of the location of the program and can therefore save the file to the right place. + * See the createImage() reference for more information. + * + * =advanced * Save this image to disk. *

    * As of revision 0100, this function requires an absolute path, @@ -2651,15 +2795,19 @@ public class PImage implements PConstants, Cloneable { * The ImageIO API claims to support wbmp files, however they probably * require a black and white image. Basic testing produced a zero-length * file with no error. + * + * @webref + * @brief Saves the image to a TIFF, TARGA, PNG, or JPEG file + * @param filename a sequence of letters and numbers */ - public void save(String path) { // ignore + public void save(String filename) { // ignore boolean success = false; - File file = new File(path); + File file = new File(filename); if (!file.isAbsolute()) { if (parent != null) { //file = new File(parent.savePath(filename)); - path = parent.savePath(path); + filename = parent.savePath(filename); } else { String msg = "PImage.save() requires an absolute path. " + "Use createImage(), or pass savePath() to save()."; @@ -2678,24 +2826,24 @@ public class PImage implements PConstants, Cloneable { } if (saveImageFormats != null) { for (int i = 0; i < saveImageFormats.length; i++) { - if (path.endsWith("." + saveImageFormats[i])) { - saveImageIO(path); + if (filename.endsWith("." + saveImageFormats[i])) { + saveImageIO(filename); return; } } } - if (path.toLowerCase().endsWith(".tga")) { - os = new BufferedOutputStream(new FileOutputStream(path), 32768); + if (filename.toLowerCase().endsWith(".tga")) { + os = new BufferedOutputStream(new FileOutputStream(filename), 32768); success = saveTGA(os); //, pixels, width, height, format); } else { - if (!path.toLowerCase().endsWith(".tif") && - !path.toLowerCase().endsWith(".tiff")) { + if (!filename.toLowerCase().endsWith(".tif") && + !filename.toLowerCase().endsWith(".tiff")) { // if no .tif extension, add it.. - path += ".tif"; + filename += ".tif"; } - os = new BufferedOutputStream(new FileOutputStream(path), 32768); + os = new BufferedOutputStream(new FileOutputStream(filename), 32768); success = saveTIFF(os); //, pixels, width, height); } os.flush(); diff --git a/core/src/processing/core/PPolygon.java b/core/src/processing/core/PPolygon.java index 2a20b7c78..0651fbe2d 100644 --- a/core/src/processing/core/PPolygon.java +++ b/core/src/processing/core/PPolygon.java @@ -419,7 +419,7 @@ public class PPolygon implements PConstants { int tr, tg, tb, ta; // System.out.println("P2D interp uv " + interpUV + " " + -// vertices[2][U] + " " + vertices[2][V]); +// vertices[2][U] + " " + vertices[2][V]); for (int x = lx; x <= rx; x++) { // map texture based on U, V coords in sp[U] and sp[V] if (interpUV) { diff --git a/core/src/processing/core/PShape.java b/core/src/processing/core/PShape.java index cf2274480..a1a5fb99e 100644 --- a/core/src/processing/core/PShape.java +++ b/core/src/processing/core/PShape.java @@ -25,8 +25,17 @@ package processing.core; import java.util.HashMap; +import processing.core.PApplet; + /** + * Datatype for storing shapes. Processing can currently load and display SVG (Scalable Vector Graphics) shapes. + * Before a shape is used, it must be loaded with the loadShape() function. The shape() function is used to draw the shape to the display window. + * The PShape object contain a group of methods, linked below, that can operate on the shape data. + *

    The loadShape() method supports SVG files created with Inkscape and Adobe Illustrator. + * It is not a full SVG implementation, but offers some straightforward support for handling vector data. + * =advanced + * * In-progress class to handle shape data, currently to be considered of * alpha or beta quality. Major structural work may be performed on this class * after the release of Processing 1.0. Such changes may include: @@ -51,6 +60,13 @@ import java.util.HashMap; *

    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().

    + * + * @webref Shape + * @usage Web & Application + * @see PApplet#shape(PShape) + * @see PApplet#loadShape(String) + * @see PApplet#shapeMode(int) + * @instanceName sh any variable of type PShape */ public class PShape implements PConstants { @@ -81,7 +97,17 @@ public class PShape implements PConstants { //protected float y; //protected float width; //protected float height; + /** + * The width of the PShape document. + * @webref + * @brief Shape document width + */ public float width; + /** + * The width of the PShape document. + * @webref + * @brief Shape document height + */ public float height; // set to false if the object is hidden in the layers palette @@ -178,21 +204,39 @@ public class PShape implements PConstants { return name; } - + /** + * Returns a boolean value "true" if the image is set to be visible, "false" if not. This is modified with the setVisible() parameter. + *

    The visibility of a shape is usually controlled by whatever program created the SVG file. + * For instance, this parameter is controlled by showing or hiding the shape in the layers palette in Adobe Illustrator. + * + * @webref + * @brief Returns a boolean value "true" if the image is set to be visible, "false" if not + */ public boolean isVisible() { return visible; } - + /** + * Sets the shape to be visible or invisible. This is determined by the value of the visible parameter. + *

    The visibility of a shape is usually controlled by whatever program created the SVG file. + * For instance, this parameter is controlled by showing or hiding the shape in the layers palette in Adobe Illustrator. + * @param visible "false" makes the shape invisible and "true" makes it visible + * @webref + * @brief Sets the shape to be visible or invisible + */ public void setVisible(boolean visible) { this.visible = visible; } /** + * Disables the shape's style data and uses Processing's current styles. Styles include attributes such as colors, stroke weight, and stroke joints. + * =advanced * Overrides this shape's style information and uses PGraphics styles and * colors. Identical to ignoreStyles(true). Also disables styles for all * child shapes. + * @webref + * @brief Disables the shape's style data and uses Processing styles */ public void disableStyle() { style = false; @@ -204,7 +248,9 @@ public class PShape implements PConstants { /** - * Re-enables style information (fill and stroke) set in the shape. + * Enables the shape's style data and ignores Processing's current styles. Styles include attributes such as colors, stroke weight, and stroke joints. + * @webref + * @brief Enables the shape's style data and ignores the Processing styles */ public void enableStyle() { style = true; @@ -591,12 +637,21 @@ public class PShape implements PConstants { return childCount; } - + /** + * + * @param index the layer position of the shape to get + */ public PShape getChild(int index) { return children[index]; } - + /** + * Extracts a child shape from a parent shape. Specify the name of the shape with the target parameter. + * The shape is returned as a PShape object, or null is returned if there is an error. + * @param target the name of the shape to get + * @webref + * @brief Returns a child element of a shape as a PShape object + */ public PShape getChild(String target) { if (name != null && name.equals(target)) { return this; @@ -675,34 +730,78 @@ public class PShape implements PConstants { // if matrix is null when one is called, // it is created and set to identity - public void translate(float tx, float ty) { checkMatrix(2); matrix.translate(tx, ty); } - + /** + * Specifies an amount to displace the shape. The x parameter specifies left/right translation, the y parameter specifies up/down translation, and the z parameter specifies translations toward/away from the screen. Subsequent calls to the method accumulates the effect. For example, calling translate(50, 0) and then translate(20, 0) is the same as translate(70, 0). This transformation is applied directly to the shape, it's not refreshed each time draw() is run. + *

    Using this method with the z parameter requires using the P3D or OPENGL parameter in combination with size. + * @webref + * @param tx left/right translation + * @param ty up/down translation + * @param tz forward/back translation + * @brief Displaces the shape + */ public void translate(float tx, float ty, float tz) { checkMatrix(3); matrix.translate(tx, ty, 0); } - - + + /** + * Rotates a shape around the x-axis the amount specified by the angle parameter. Angles should be specified in radians (values from 0 to TWO_PI) or converted to radians with the radians() method. + *

    Shapes are always rotated around the upper-left corner of their bounding box. Positive numbers rotate objects in a clockwise direction. + * Subsequent calls to the method accumulates the effect. For example, calling rotateX(HALF_PI) and then rotateX(HALF_PI) is the same as rotateX(PI). + * This transformation is applied directly to the shape, it's not refreshed each time draw() is run. + *

    This method requires a 3D renderer. You need to pass P3D or OPENGL as a third parameter into the size() method as shown in the example above. + * @param angle angle of rotation specified in radians + * @webref + * @brief Rotates the shape around the x-axis + */ public void rotateX(float angle) { rotate(angle, 1, 0, 0); } - + /** + * Rotates a shape around the y-axis the amount specified by the angle parameter. Angles should be specified in radians (values from 0 to TWO_PI) or converted to radians with the radians() method. + *

    Shapes are always rotated around the upper-left corner of their bounding box. Positive numbers rotate objects in a clockwise direction. + * Subsequent calls to the method accumulates the effect. For example, calling rotateY(HALF_PI) and then rotateY(HALF_PI) is the same as rotateY(PI). + * This transformation is applied directly to the shape, it's not refreshed each time draw() is run. + *

    This method requires a 3D renderer. You need to pass P3D or OPENGL as a third parameter into the size() method as shown in the example above. + * @param angle angle of rotation specified in radians + * @webref + * @brief Rotates the shape around the y-axis + */ public void rotateY(float angle) { rotate(angle, 0, 1, 0); } + /** + * Rotates a shape around the z-axis the amount specified by the angle parameter. Angles should be specified in radians (values from 0 to TWO_PI) or converted to radians with the radians() method. + *

    Shapes are always rotated around the upper-left corner of their bounding box. Positive numbers rotate objects in a clockwise direction. + * Subsequent calls to the method accumulates the effect. For example, calling rotateZ(HALF_PI) and then rotateZ(HALF_PI) is the same as rotateZ(PI). + * This transformation is applied directly to the shape, it's not refreshed each time draw() is run. + *

    This method requires a 3D renderer. You need to pass P3D or OPENGL as a third parameter into the size() method as shown in the example above. + * @param angle angle of rotation specified in radians + * @webref + * @brief Rotates the shape around the z-axis + */ public void rotateZ(float angle) { rotate(angle, 0, 0, 1); } - - + + /** + * Rotates a shape the amount specified by the angle parameter. Angles should be specified in radians (values from 0 to TWO_PI) or converted to radians with the radians() method. + *

    Shapes are always rotated around the upper-left corner of their bounding box. Positive numbers rotate objects in a clockwise direction. + * Transformations apply to everything that happens after and subsequent calls to the method accumulates the effect. + * For example, calling rotate(HALF_PI) and then rotate(HALF_PI) is the same as rotate(PI). + * This transformation is applied directly to the shape, it's not refreshed each time draw() is run. + * @param angle angle of rotation specified in radians + * @webref + * @brief Rotates the shape + */ public void rotate(float angle) { checkMatrix(2); // at least 2... matrix.rotate(angle); @@ -716,20 +815,34 @@ public class PShape implements PConstants { // - - + + /** + * @param s percentage to scale the object + */ public void scale(float s) { checkMatrix(2); // at least 2... matrix.scale(s); } - public void scale(float sx, float sy) { + public void scale(float x, float y) { checkMatrix(2); - matrix.scale(sx, sy); + matrix.scale(x, y); } + /** + * Increases or decreases the size of a shape by expanding and contracting vertices. Shapes always scale from the relative origin of their bounding box. + * Scale values are specified as decimal percentages. For example, the method call scale(2.0) increases the dimension of a shape by 200%. + * Subsequent calls to the method multiply the effect. For example, calling scale(2.0) and then scale(1.5) is the same as scale(3.0). + * This transformation is applied directly to the shape, it's not refreshed each time draw() is run. + *

    Using this fuction with the z parameter requires passing P3D or OPENGL into the size() parameter. + * @param x percentage to scale the object in the x-axis + * @param y percentage to scale the object in the y-axis + * @param z percentage to scale the object in the z-axis + * @webref + * @brief Increases and decreases the size of a shape + */ public void scale(float x, float y, float z) { checkMatrix(3); matrix.scale(x, y, z); diff --git a/core/src/processing/core/PShapeSVG.java b/core/src/processing/core/PShapeSVG.java index db1bd9e88..0bbf2c51a 100644 --- a/core/src/processing/core/PShapeSVG.java +++ b/core/src/processing/core/PShapeSVG.java @@ -457,7 +457,11 @@ public class PShapeSVG extends PShape { separate = false; } if (c == '-' && !lastSeparate) { - pathBuffer.append("|"); + // allow for 'e' notation in numbers, e.g. 2.10e-9 + // http://dev.processing.org/bugs/show_bug.cgi?id=1408 + if (i == 0 || pathDataChars[i-1] != 'e') { + pathBuffer.append("|"); + } } if (c != ',') { pathBuffer.append(c); //"" + pathDataBuffer.charAt(i)); diff --git a/core/src/processing/core/PVector.java b/core/src/processing/core/PVector.java index 91be2f52b..1fb4f1f76 100644 --- a/core/src/processing/core/PVector.java +++ b/core/src/processing/core/PVector.java @@ -428,8 +428,8 @@ public class PVector { public float dot(float x, float y, float z) { return this.x*x + this.y*y + this.z*z; } - - + + static public float dot(PVector v1, PVector v2) { return v1.x*v2.x + v1.y*v2.y + v1.z*v2.z; } diff --git a/core/src/processing/xml/XMLElement.java b/core/src/processing/xml/XMLElement.java index 873828996..1f1b28d9c 100644 --- a/core/src/processing/xml/XMLElement.java +++ b/core/src/processing/xml/XMLElement.java @@ -31,6 +31,10 @@ import processing.core.PApplet; /** + * XMLElement is a representation of an XML object. The object is able to parse XML code. The methods described here are the most basic. More are documented in the Developer's Reference. + *

    + * The encoding parameter inside XML files is ignored, only UTF-8 (or plain ASCII) are parsed properly. + * =advanced * XMLElement is an XML element. This is the base class used for the * Processing XML library, representing a single node of an XML tree. * @@ -38,6 +42,10 @@ import processing.core.PApplet; * * @author Marc De Scheemaecker * @author processing.org + * + * @webref data:composite + * @usage Web & Application + * @instanceName xml any variable of type XMLElement */ public class XMLElement implements Serializable { @@ -103,6 +111,7 @@ public class XMLElement implements Serializable { /** * Creates an empty element to be used for #PCDATA content. + * @nowebref */ public XMLElement() { this(null, null, null, NO_LINE); @@ -173,6 +182,7 @@ public class XMLElement implements Serializable { * @param namespace the namespace URI. * @param systemID the system ID of the XML data where the element starts. * @param lineNr the line in the XML data where the element starts. + * @nowebref */ public XMLElement(String fullName, String namespace, @@ -204,21 +214,25 @@ public class XMLElement implements Serializable { * wraps exception handling, for more advanced exception handling, * use the constructor that takes a Reader or InputStream. * @author processing.org - * @param filename - * @param parent + * @param filename name of the XML file to load + * @param parent typically use "this" */ public XMLElement(PApplet parent, String filename) { this(); parseFromReader(parent.createReader(filename)); } - + /** + * @nowebref + */ public XMLElement(Reader r) { this(); parseFromReader(r); } - + /** + * @nowebref + */ public XMLElement(String xml) { this(); parseFromReader(new StringReader(xml)); @@ -348,6 +362,8 @@ public class XMLElement implements Serializable { * Returns the full name (i.e. the name including an eventual namespace * prefix) of the element. * + * @webref + * @brief Returns the name of the element. * @return the name, or null if the element only contains #PCDATA. */ public String getName() { @@ -507,9 +523,12 @@ public class XMLElement implements Serializable { /** - * Returns the number of children. + * Returns the number of children for the element. * * @return the count. + * @webref + * @see processing.xml.XMLElement#getChild(int) + * @see processing.xml.XMLElement#getChildren(String) */ public int getChildCount() { return this.children.size(); @@ -554,27 +573,35 @@ public class XMLElement implements Serializable { /** * Quick accessor for an element at a particular index. * @author processing.org + * @param index the element */ - public XMLElement getChild(int which) { - return (XMLElement) children.elementAt(which); + public XMLElement getChild(int index) { + return (XMLElement) children.elementAt(index); } /** - * Get a child by its name or path. - * @param name element name or path/to/element + * Returns the child XMLElement as specified by the index parameter. The value of the index parameter must be less than the total number of children to avoid going out of the array storing the child elements. + * When the path parameter is specified, then it will return all children that match that path. The path is a series of elements and sub-elements, separated by slashes. + * * @return the element * @author processing.org + * + * @webref + * @see processing.xml.XMLElement#getChildCount() + * @see processing.xml.XMLElement#getChildren(String) + * @brief Get a child by its name or path. + * @param path path to a particular element */ - public XMLElement getChild(String name) { - if (name.indexOf('/') != -1) { - return getChildRecursive(PApplet.split(name, '/'), 0); + public XMLElement getChild(String path) { + if (path.indexOf('/') != -1) { + return getChildRecursive(PApplet.split(path, '/'), 0); } int childCount = getChildCount(); for (int i = 0; i < childCount; i++) { XMLElement kid = getChild(i); String kidName = kid.getName(); - if (kidName != null && kidName.equals(name)) { + if (kidName != null && kidName.equals(path)) { return kid; } } @@ -681,20 +708,27 @@ public class XMLElement implements Serializable { /** - * Get any children that match this name or path. Similar to getChild(), - * but will grab multiple matches rather than only the first. - * @param name element name or path/to/element + * Returns all of the children as an XMLElement array. + * When the path parameter is specified, then it will return all children that match that path. + * The path is a series of elements and sub-elements, separated by slashes. + * + * @param path element name or path/to/element * @return array of child elements that match * @author processing.org + * + * @webref + * @brief Returns all of the children as an XMLElement array. + * @see processing.xml.XMLElement#getChildCount() + * @see processing.xml.XMLElement#getChild(int) */ - public XMLElement[] getChildren(String name) { - if (name.indexOf('/') != -1) { - return getChildrenRecursive(PApplet.split(name, '/'), 0); + public XMLElement[] getChildren(String path) { + if (path.indexOf('/') != -1) { + return getChildrenRecursive(PApplet.split(path, '/'), 0); } // if it's a number, do an index instead // (returns a single element array, since this will be a single match - if (Character.isDigit(name.charAt(0))) { - return new XMLElement[] { getChild(Integer.parseInt(name)) }; + if (Character.isDigit(path.charAt(0))) { + return new XMLElement[] { getChild(Integer.parseInt(path)) }; } int childCount = getChildCount(); XMLElement[] matches = new XMLElement[childCount]; @@ -702,7 +736,7 @@ public class XMLElement implements Serializable { for (int i = 0; i < childCount; i++) { XMLElement kid = getChild(i); String kidName = kid.getName(); - if (kidName != null && kidName.equals(name)) { + if (kidName != null && kidName.equals(path)) { matches[matchCount++] = kid; } } @@ -882,12 +916,22 @@ public class XMLElement implements Serializable { } } - + public String getStringAttribute(String name) { return getAttribute(name); } - + /** + * Returns a String attribute of the element. + * If the default parameter is used and the attribute doesn't exist, the default value is returned. + * When using the version of the method without the default parameter, if the attribute doesn't exist, the value 0 is returned. + * + * @webref + * @param name the name of the attribute + * @param default Value value returned if the attribute is not found + * + * @brief Returns a String attribute of the element. + */ public String getStringAttribute(String name, String defaultValue) { return getAttribute(name, defaultValue); } @@ -899,18 +943,24 @@ public class XMLElement implements Serializable { return getAttribute(name, namespace, defaultValue); } - + /** + * Returns an integer attribute of the element. + */ public int getIntAttribute(String name) { return getIntAttribute(name, 0); } /** - * Returns the value of an attribute. + * Returns an integer attribute of the element. + * If the default parameter is used and the attribute doesn't exist, the default value is returned. + * When using the version of the method without the default parameter, if the attribute doesn't exist, the value 0 is returned. * - * @param name the non-null full name of the attribute. - * @param defaultValue the default value of the attribute. + * @param name the name of the attribute + * @param defaultValue value returned if the attribute is not found * + * @webref + * @brief Returns an integer attribute of the element. * @return the value, or defaultValue if the attribute does not exist. */ public int getIntAttribute(String name, @@ -944,12 +994,17 @@ public class XMLElement implements Serializable { /** - * Returns the value of an attribute. + * Returns a float attribute of the element. + * If the default parameter is used and the attribute doesn't exist, the default value is returned. + * When using the version of the method without the default parameter, if the attribute doesn't exist, the value 0 is returned. * - * @param name the non-null full name of the attribute. - * @param defaultValue the default value of the attribute. + * @param name the name of the attribute + * @param defaultValue value returned if the attribute is not found * * @return the value, or defaultValue if the attribute does not exist. + * + * @webref + * @brief Returns a float attribute of the element. */ public float getFloatAttribute(String name, float defaultValue) { @@ -966,6 +1021,7 @@ public class XMLElement implements Serializable { * @param defaultValue the default value of the attribute. * * @return the value, or defaultValue if the attribute does not exist. + * @nowebref */ public float getFloatAttribute(String name, String namespace, @@ -1253,11 +1309,15 @@ public class XMLElement implements Serializable { /** + * Returns the content of an element. If there is no such content, null is returned. + * =advanced * Return the #PCDATA content of the element. If the element has a * combination of #PCDATA content and child elements, the #PCDATA * sections can be retrieved as unnamed child objects. In this case, * this method returns null. * + * @webref + * @brief Returns the content of an element * @return the content. */ public String getContent() { diff --git a/core/todo.txt b/core/todo.txt index cf4488272..6b6ce087f 100644 --- a/core/todo.txt +++ b/core/todo.txt @@ -1,10 +1,85 @@ -0171 core -X Blurred PImages in OPENGL sketches -X removed NPOT texture support (for further testing) -X http://dev.processing.org/bugs/show_bug.cgi?id=1352 +0179 core +X screenWidth/Height instead of screenW/H +X open up the pdf library more (philho) +X http://dev.processing.org/bugs/show_bug.cgi?id=1343 +X cache font information for the PDF library to improve setup time +X when using createFont("xxxx.ttf"), should use textMode(SHAPE) with PDF +X because ttf files will not be installed on the system when opening pdf +X added error messages for users +X bring back old-style textAscent() +X needs to just quickly run characters d and p +X only takes a couple ms, so no problem +X pdf library +X throw an error with the black boxes +X throw an error if loading fonts from a file, and not using mode(SHAPE) +X implement default font +X this can be done to replace the exception handler in PGraphics +o however it needs to be a legit font, so that it works w/ pdf +o or maybe pdf just has its own default? +X create characters on the fly when createFont() is used +o memory leak problem with fonts in JAVA2D +X can't get this to crash anymore +o http://dev.processing.org/bugs/show_bug.cgi?id=1252 + +earlier +X if no draw() method, and renderer is not displayable, then exit +X static mode PDFs shouldn't just hang + + +big ones +_ ortho() behaving differently in P3D vs OPENGL +_ http://dev.processing.org/bugs/show_bug.cgi?id=100 +_ shows a blank canvas +_ (was only happening once b/c was drawing first in perspective) +_ seems to be mapping to 0, 0 - width/2, height/2 +_ fix 3D > OrthoVsPerspective example once ortho works properly +_ there's a depth problem in addition to the ortho weirdness +_ modelx/y/z broken when aiming a camera +_ http://dev.processing.org/bugs/show_bug.cgi?id=1074 +_ opengl + resize window => window content garbled +_ http://dev.processing.org/bugs/show_bug.cgi?id=1360 +_ modify PVector to include better methods for chaining operations +_ http://dev.processing.org/bugs/show_bug.cgi?id=1415 + +quickies +_ img.get() weirdness +_ http://dev.processing.org/bugs/show_bug.cgi?id=1198 +_ copy and blend scale when unnecessary +_ http://dev.processing.org/bugs/show_bug.cgi?id=1482 +_ add a limit to pushStyle() to catch unmatched sets? +_ http://dev.processing.org/bugs/show_bug.cgi?id=1368 +_ P2D transformation bug from ira +_ http://dev.processing.org/bugs/show_bug.cgi?id=1175 +_ resize not working in revision 5707 +_ camera() and perspective() were commented out in setSize() +_ http://dev.processing.org/bugs/show_bug.cgi?id=1391 +_ chopping out triangles in OpenGL (though it's only 2D drawing) +_ http://dev.processing.org/bugs/show_bug.cgi?id=1359 +_ make sure that get() and set() (for pixels and subsets) work w/ loaded images +_ make sure that get() and set() (for pixels and subsets) work w/ P2D +_ make sure that get() and set() (for pixels and subsets) work w/ P3D +_ consider adding skewX/Y +_ do them as shearX/Y +_ http://dev.processing.org/bugs/show_bug.cgi?id=1448 + +_ add setOutput() method across other renderers? + +_ opengl applet problems +_ http://dev.processing.org/bugs/show_bug.cgi?id=1364 + +_ method of threading but queue an event to be run when safe +_ e.g. queueing items like mouse/keybd, but generic fxns + +_ inconsistent anti-aliasing with OpenGL +_ http://dev.processing.org/bugs/show_bug.cgi?id=1413 +_ modify PVector to include better methods for chaining operations +_ http://dev.processing.org/bugs/show_bug.cgi?id=1415 + +_ selectInput() fails when called from within keyPressed() +_ http://dev.processing.org/bugs/show_bug.cgi?id=1220 + +_ add java.io.Reader (and Writer?) to imports -_ open up the pdf library more (philho) -_ http://dev.processing.org/bugs/show_bug.cgi?id=1343 _ changing vertex alpha in P3D in a QUAD_STRIP is ignored _ with smoothing, it works fine, but with PTriangle, it's not _ smooth() not working with applets an createGraphics(JAVA2D) @@ -12,6 +87,9 @@ _ but works fine with applications _ get() with OPENGL is grabbing the wrong coords _ http://dev.processing.org/bugs/show_bug.cgi?id=1349 +_ gl power of 2 with textures +_ P3D also seems to have trouble w/ textures edges.. bad math? + _ No textures render with hint(ENABLE_ACCURATE_TEXTURES) _ http://dev.processing.org/bugs/show_bug.cgi?id=985 _ need to remove the hint from the reference @@ -20,11 +98,14 @@ _ deal with issue of single pixel seam at the edge of textures _ http://dev.processing.org/bugs/show_bug.cgi?id=602 _ should vertexTexture() divide by width/height or width-1/height-1? +looping/events _ key and mouse events delivered out of order _ http://dev.processing.org/bugs/show_bug.cgi?id=638 _ key/mouse events have concurrency problems with noLoop() _ http://dev.processing.org/bugs/show_bug.cgi?id=1323 _ need to say "no drawing inside mouse/key events w/ noLoop" +_ redraw() doesn't work from within draw() +_ http://dev.processing.org/bugs/show_bug.cgi?id=1363 _ make the index lookup use numbers up to 256? @@ -34,8 +115,6 @@ _ public float textWidth(char[] chars, int start, int length) _ textAlign(JUSTIFY) (with implementation) _ http://dev.processing.org/bugs/show_bug.cgi?id=1309 -_ create characters on the fly when createFont() is used - _ Semitransparent rect drawn over image not rendered correctly _ http://dev.processing.org/bugs/show_bug.cgi?id=1280 @@ -49,8 +128,6 @@ _ http://dev.processing.org/bugs/show_bug.cgi?id=1176 _ what's the difference with ascent on loadFont vs. createFont? _ noCursor() doesn't work in present mode _ http://dev.processing.org/bugs/show_bug.cgi?id=1177 -_ modelx/y/z broken when aiming a camera -_ http://dev.processing.org/bugs/show_bug.cgi?id=1074 _ in P2D, two vertex() line calls with fill() causes duplicate output _ works fine in other renderers, has to do with tesselation _ http://dev.processing.org/bugs/show_bug.cgi?id=1191 @@ -67,14 +144,10 @@ _ what other methods should work with doubles? all math functions? _ seems like internal (mostly static) things, but not graphics api _ look into replacing nanoxml _ http://www.exampledepot.com/egs/javax.xml.parsers/pkg.html -_ if no draw() method, and renderer is not displayable, then exit -_ static mode PDFs shouldn't just hang [ known problems ] -_ memory leak problem with fonts in JAVA2D -_ http://dev.processing.org/bugs/show_bug.cgi?id=1252 _ OPENGL sketches flicker w/ Vista when background() not used inside draw() _ http://dev.processing.org/bugs/show_bug.cgi?id=930 _ Disabling Aero scheme sometimes prevents the problem @@ -142,16 +215,11 @@ _ make sure that filter, blend, copy, etc say that no loadPixels necessary rework some text/font code [1.0] -_ PFont not working well with lots of characters -_ only create bitmap chars on the fly when needed (in createFont) _ text placement is ugly, seems like fractional metrics problem _ http://dev.processing.org/bugs/show_bug.cgi?id=866 _ text(char c) with char 0 and undefined should print nothing _ perhaps also DEL or other nonprintables? _ book example 25-03 -_ when using createFont("xxxx.ttf"), should use textMode(SHAPE) with PDF -_ because ttf files will not be installed on the system when opening pdf -_ maybe just add this to the reference so that people know _ text position is quantized in JAVA2D _ http://dev.processing.org/bugs/show_bug.cgi?id=806 _ accessors inside PFont need a lot of work @@ -159,8 +227,6 @@ _ osx 10.5 (not 10.4) performing text width calculation differently _ http://dev.processing.org/bugs/show_bug.cgi?id=972 _ Automatically use textMode(SCREEN) with text() when possible _ http://dev.processing.org/bugs/show_bug.cgi?id=1020 -_ Implement better caching mechanism when creating large fonts -_ http://dev.processing.org/bugs/show_bug.cgi?id=1111 P2D, P3D, PPolygon [1.0] @@ -200,19 +266,12 @@ _ also needs fix for last edge and the seam threading and exiting -_ pdf sketches exiting before writing has finished _ writing image file (missing a flush() call?) on exit() fails _ lots of zero length files _ saveFrame() at the end of a draw mode program is problematic _ app might exit before the file has finished writing to disk _ need to block other activity inside screenGrab until finished _ http://processing.org/discourse/yabb/YaBB.cgi?board=Proce55ing_software_bugs;action=display;num=1081706752 -_ what's up with stop() vs exit()? -_ need to get this straightened for p5 (i.e. bc has this problem) -_ make sure the main() doesn't exit until the applet has finished -_ i.e. problem with main calling itself multiple times in Alpheus -_ if exit() (or stop) is called, then System.exit() gets called, -_ even though the main() wants to keep going _ for begin/endRecord, use a piggyback mechanism _ that way won't have to pass a PApplet around @@ -220,24 +279,32 @@ _ this has a big impact on the SVG library _ in fact, this maybe should be a library that does it _ so that the file size can be much smaller -_ when closing a sketch via the close box, make sure stop() getting called -X found a problem for release 0133 -_ test to see if it's working - _ STROKE_WEIGHT field in PGraphics3 is a disaster, because it's an int _ use the SW from vertex instead.. why set stroke in triangle vars at all? _ currently truncating to an int inside add_line_no_clip _ need to clean all this crap up +stop() mess +_ double stop() called with noLoop() +_ http://dev.processing.org/bugs/show_bug.cgi?id=1270 _ stop() not getting called _ http://dev.processing.org/bugs/show_bug.cgi?id=183 _ major problem for libraries _ and start() is supposedly called by the applet viewer _ http://java.sun.com/j2se/1.4.2/docs/api/java/applet/Applet.html#start() _ need to track this stuff down a bit +_ when closing a sketch via the close box, make sure stop() getting called +X found a problem for release 0133 +_ test to see if it's working +_ what's up with stop() vs exit()? +_ need to get this straightened for p5 (i.e. bc has this problem) +_ make sure the main() doesn't exit until the applet has finished +_ i.e. problem with main calling itself multiple times in Alpheus +_ if exit() (or stop) is called, then System.exit() gets called, +_ even though the main() wants to keep going +_ more chatter with this +_ http://dev.processing.org/bugs/show_bug.cgi?id=131 -_ method of threading but queue an event to be run when safe -_ e.g. queueing items like mouse/keybd, but generic fxns //////////////////////////////////////////////////////////////////// @@ -280,6 +347,8 @@ _ don't bother using a buffering stream, just handle internally. gah! _ remove some of the bloat, how can we make things more compact? _ i.e. if not using 3D, can leave out PGraphics3, PTriangle, PLine _ http://dev.processing.org/bugs/show_bug.cgi?id=127 +E4 _ add shuffle methods for arrays +E4 _ http://dev.processing.org/bugs/show_bug.cgi?id=1462 CORE / PApplet - main() @@ -309,7 +378,8 @@ _ or if the sketch window is foremost _ maybe a hack where a new menubar is added? _ --display not working on osx _ http://dev.processing.org/bugs/show_bug.cgi?id=531 - +_ "Target VM failed to initialize" when using Present mode on Mac OS X +_ http://dev.processing.org/bugs/show_bug.cgi?id=1257 CORE / PFont and text() @@ -412,13 +482,6 @@ CORE / PGraphics3D _ make thick lines draw perpendicular to the screen with P3D _ http://dev.processing.org/bugs/show_bug.cgi?id=956 _ ewjordan suggests building the quad in screen coords after perspective -_ ortho() behaving differently in P3D vs OPENGL -_ http://dev.processing.org/bugs/show_bug.cgi?id=100 -_ shows a blank canvas -_ (was only happening once b/c was drawing first in perspective) -_ seems to be mapping to 0, 0 - width/2, height/2 -_ fix 3D > OrthoVsPerspective example once ortho works properly -_ there's a depth problem in addition to the ortho weirdness _ improve hint(ENABLE_DEPTH_SORT) to use proper painter's algo _ http://dev.processing.org/bugs/show_bug.cgi?id=176 _ polygon z-order depth sorting with alpha in opengl @@ -433,11 +496,9 @@ _ images are losing pixels at the edges _ http://dev.processing.org/bugs/show_bug.cgi?id=102 _ odd error with some pixels from images not drawing properly _ http://processing.org/discourse/yabb_beta/YaBB.cgi?board=SoftwareBugs;action=display;num=1115681453 -_ clipping not yet completely implemented +_ clipping not implemented +_ http://dev.processing.org/bugs/show_bug.cgi?id=1393 _ http://processing.org/discourse/yabb_beta/YaBB.cgi?board=SoftwareBugs;action=display;num=1114184516 -_ Stroking a rect() leaves off the upper right pixel -_ http://dev.processing.org/bugs/show_bug.cgi?id=501 -_ clipping planes _ http://processing.org/discourse/yabb/YaBB.cgi?board=Proce55ing_software_bugs;action=display;num=1058491568;start=0 _ http://processing.org/discourse/yabb/YaBB.cgi?board=Proce55ing_software_bugs;action=display;num=1052313604;start=0 _ http://processing.org/discourse/yabb/YaBB.cgi?board=Proce55ing_Software;action=display;num=1095170607;start=0 @@ -449,6 +510,8 @@ _ or at least that things get ridiculously slow _ clipping issues here.. but also something in scan converter _ not clipping areas from offscreen _ huge geometry slows things way down +_ Stroking a rect() leaves off the upper right pixel +_ http://dev.processing.org/bugs/show_bug.cgi?id=501 _ box is not opaque _ problem is that lines are drawn second _ one pixel lines have no z value.. argh @@ -462,6 +525,8 @@ _ box(40); CORE / PImage +_ accuracy problems make alpha channel go to FE with image.copy() +_ http://dev.processing.org/bugs/show_bug.cgi?id=1420 _ improve blend() accuracy when using ADD _ http://dev.processing.org/bugs/show_bug.cgi?id=1008 _ includes code for a slow but more accurate mode @@ -603,6 +668,10 @@ LIBRARIES / PGraphicsPDF _ pdf not rendering unicode with beginRecord() _ http://dev.processing.org/bugs/show_bug.cgi?id=727 +_ pdf sketches exiting before writing has finished +_ people have to call exit() (so that dispose() is called in particular) +_ when using noLoop() and the PDF renderer, sketch should exit gracefully +_ because isDisplayable() returns false, there's no coming back from noLoop @@ -710,3 +779,4 @@ _ exactly how should pixel filling work with single pixel strokes? _ http://dev.processing.org/bugs/show_bug.cgi?id=1025 _ Writing XML files (clean up the API) _ http://dev.processing.org/bugs/show_bug.cgi?id=964 +_ consider bringing back text/image using cache/names From e5d56a1e59d825ab0cc9df1355c2ba0ddb181762 Mon Sep 17 00:00:00 2001 From: "David A. Mellis" Date: Sat, 8 May 2010 20:06:31 +0000 Subject: [PATCH 03/11] Redoing the error message parsing / handling. Now using Sketch.placeException() to map back to the sketch code files and line numbers. Showing more of the actual output of avr-gcc / avr-g++. --- app/src/processing/app/Sketch.java | 6 +- .../processing/app/StreamRedirectThread.java | 95 ---------- app/src/processing/app/debug/Compiler.java | 166 ++++-------------- .../app/debug/StreamRedirectThread.java | 84 --------- 4 files changed, 36 insertions(+), 315 deletions(-) delete mode 100644 app/src/processing/app/StreamRedirectThread.java delete mode 100644 app/src/processing/app/debug/StreamRedirectThread.java diff --git a/app/src/processing/app/Sketch.java b/app/src/processing/app/Sketch.java index 34b76d8d0..7f96c9dd3 100644 --- a/app/src/processing/app/Sketch.java +++ b/app/src/processing/app/Sketch.java @@ -1442,7 +1442,7 @@ public class Sketch { // first check to see if it's a .java file for (int i = 0; i < getCodeCount(); i++) { SketchCode code = getCode(i); - if (code.isExtension("java")) { + if (!code.isExtension(getDefaultExtension())) { if (dotJavaFilename.equals(code.getFileName())) { codeIndex = i; codeLine = dotJavaLine; @@ -1452,7 +1452,7 @@ public class Sketch { } // If not the preprocessed file at this point, then need to get out - if (!dotJavaFilename.equals(name + ".java")) { + if (!dotJavaFilename.equals(name + ".cpp")) { return null; } @@ -1462,7 +1462,7 @@ public class Sketch { for (int i = 0; i < getCodeCount(); i++) { SketchCode code = getCode(i); - if (code.isExtension("pde")) { + if (code.isExtension(getDefaultExtension())) { // System.out.println("preproc offset is " + code.getPreprocOffset()); // System.out.println("looking for line " + dotJavaLine); if (code.getPreprocOffset() <= dotJavaLine) { diff --git a/app/src/processing/app/StreamRedirectThread.java b/app/src/processing/app/StreamRedirectThread.java deleted file mode 100644 index 0d27a56e6..000000000 --- a/app/src/processing/app/StreamRedirectThread.java +++ /dev/null @@ -1,95 +0,0 @@ -/* - - * @(#)StreamRedirectThread.java 1.4 03/01/23 - * - * Copyright 2003 Sun Microsystems, Inc. All rights reserved. - * SUN PROPRIETARY/CONFIDENTIAL. Use is subject to license terms. - */ -/* - * Copyright (c) 1997-2001 by Sun Microsystems, Inc. All Rights Reserved. - * - * Sun grants you ("Licensee") a non-exclusive, royalty free, license to use, - * modify and redistribute this software in source and binary code form, - * provided that i) this copyright notice and license appear on all copies of - * the software; and ii) Licensee does not utilize the software in a manner - * which is disparaging to Sun. - * - * This software is provided "AS IS," without a warranty of any kind. ALL - * EXPRESS OR IMPLIED CONDITIONS, REPRESENTATIONS AND WARRANTIES, INCLUDING ANY - * IMPLIED WARRANTY OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE OR - * NON-INFRINGEMENT, ARE HEREBY EXCLUDED. SUN AND ITS LICENSORS SHALL NOT BE - * LIABLE FOR ANY DAMAGES SUFFERED BY LICENSEE AS A RESULT OF USING, MODIFYING - * OR DISTRIBUTING THE SOFTWARE OR ITS DERIVATIVES. IN NO EVENT WILL SUN OR ITS - * LICENSORS BE LIABLE FOR ANY LOST REVENUE, PROFIT OR DATA, OR FOR DIRECT, - * INDIRECT, SPECIAL, CONSEQUENTIAL, INCIDENTAL OR PUNITIVE DAMAGES, HOWEVER - * CAUSED AND REGARDLESS OF THE THEORY OF LIABILITY, ARISING OUT OF THE USE OF - * OR INABILITY TO USE SOFTWARE, EVEN IF SUN HAS BEEN ADVISED OF THE - * POSSIBILITY OF SUCH DAMAGES. - * - * This software is not designed or intended for use in on-line control of - * aircraft, air traffic, aircraft navigation or aircraft communications; or in - * the design, construction, operation or maintenance of any nuclear - * facility. Licensee represents and warrants that it will not use or - * redistribute the Software for such purposes. - */ -package processing.app; - -import java.io.*; - -/** - * StreamRedirectThread is a thread which copies it's input to - * it's output and terminates when it completes. - * - * @version @(#) StreamRedirectThread.java 1.4 03/01/23 23:33:38 - * @author Robert Field - */ -public class StreamRedirectThread extends Thread { - - private final Reader in; - private final Writer out; - - private static final int BUFFER_SIZE = 2048; - - - /** - * Set up for copy. - * @param name Name of the thread - * @param in Stream to copy from - * @param out Stream to copy to - */ - public StreamRedirectThread(String name, InputStream in, OutputStream out) { - super(name); - this.in = new InputStreamReader(in); - this.out = new OutputStreamWriter(out); - setPriority(Thread.MAX_PRIORITY-1); - } - - - public StreamRedirectThread(String name, Reader in, Writer out) { - super(name); - this.in = in; - this.out = out; - setPriority(Thread.MAX_PRIORITY-1); - } - - - /** - * Copy. - */ - public void run() { - try { - char[] cbuf = new char[BUFFER_SIZE]; - int count; - //System.out.println("opening streamredirectthread"); - while ((count = in.read(cbuf, 0, BUFFER_SIZE)) >= 0) { - out.write(cbuf, 0, count); - // had to add the flush() here.. maybe shouldn't be using writer? [fry] - out.flush(); - } - //System.out.println("exiting streamredirectthread"); - out.flush(); - } catch(IOException exc) { - System.err.println("Child I/O Transfer - " + exc); - } - } -} diff --git a/app/src/processing/app/debug/Compiler.java b/app/src/processing/app/debug/Compiler.java index 850d10a64..a30512a44 100644 --- a/app/src/processing/app/debug/Compiler.java +++ b/app/src/processing/app/debug/Compiler.java @@ -326,142 +326,42 @@ public class Compiler implements MessageConsumer { * and line number, which is then reported back to Editor. */ public void message(String s) { - // This receives messages as full lines, so a newline needs - // to be added as they're printed to the console. - //System.err.print(s); + int i; - // ignore cautions - if (s.indexOf("warning") != -1) return; - - // ignore this line; the real error is on the next one - if (s.indexOf("In file included from") != -1) return; - - // jikes always uses a forward slash character as its separator, - // so replace any platform-specific separator characters before - // attemping to compare - // - //String buildPathSubst = buildPath.replace(File.separatorChar, '/') + "/"; - String buildPathSubst = - buildPath.replace(File.separatorChar,File.separatorChar) + - File.separatorChar; - - String partialTempPath = null; - int partialStartIndex = -1; //s.indexOf(partialTempPath); - int fileIndex = -1; // use this to build a better exception - - // check the main sketch file first. - partialTempPath = buildPathSubst + primaryClassName; - partialStartIndex = s.indexOf(partialTempPath); - - if (partialStartIndex != -1) { - fileIndex = 0; - } else { - // wasn't there, check the other (non-pde) files in the sketch. - // iterate through the project files to see who's causing the trouble - for (int i = 0; i < sketch.getCodeCount(); i++) { - if (sketch.getCode(i).isExtension("pde")) continue; - - partialTempPath = buildPathSubst + sketch.getCode(i).getFileName(); - //System.out.println(partialTempPath); - partialStartIndex = s.indexOf(partialTempPath); - if (partialStartIndex != -1) { - fileIndex = i; - //System.out.println("fileIndex is " + fileIndex); - break; - } - } - //+ className + ".java"; - } - - // if the partial temp path appears in the error message... - // - //int partialStartIndex = s.indexOf(partialTempPath); - if (partialStartIndex != -1) { - - // skip past the path and parse the int after the first colon - // - String s1 = s.substring(partialStartIndex + - partialTempPath.length() + 1); - //System.out.println(s1); - int colon = s1.indexOf(':'); - - if (s1.indexOf("In function") != -1 || colon == -1) { - System.err.print(s1); - //firstErrorFound = true; - return; - } - - int lineNumber; - try { - lineNumber = Integer.parseInt(s1.substring(0, colon)); - } catch (NumberFormatException e) { - System.err.print(s1); - return; - } - - //System.out.println("pde / line number: " + lineNumber); - - if (fileIndex == 0) { // main class, figure out which tab - for (int i = 1; i < sketch.getCodeCount(); i++) { - if (sketch.getCode(i).isExtension("pde")) { - //System.out.println("preprocOffset "+ sketch.getCode(i).getPreprocOffset()); - if (sketch.getCode(i).getPreprocOffset() < lineNumber) { - fileIndex = i; - //System.out.println("i'm thinkin file " + i); - } - } - } - // XXX: DAM: if the lineNumber is less than sketch.getCode(0).getPreprocOffset() - // we shouldn't subtract anything from it, as the error is above the - // location where the function prototypes and #include "WProgram.h" - // were inserted. - lineNumber -= sketch.getCode(fileIndex).getPreprocOffset(); - } - - //String s2 = s1.substring(colon + 2); - int err = s1.indexOf(":"); - if (err != -1) { - - // if the first error has already been found, then this must be - // (at least) the second error found - if (firstErrorFound) { - secondErrorFound = true; - return; - } - - // if executing at this point, this is *at least* the first error - firstErrorFound = true; - - err += ":".length(); - String description = s1.substring(err); - description = description.trim(); - System.err.print(description); - - //System.out.println("description = " + description); - //System.out.println("creating exception " + exception); - exception = new RunnerException(description, fileIndex, lineNumber-1, -1, false); - - // NOTE!! major change here, this exception will be queued - // here to be thrown by the compile() function - //editor.error(exception); - - } else { - System.err.println("i suck: " + s); - } - - } else { - // this isn't the start of an error line, so don't attempt to parse - // a line number out of it. - - // if the second error hasn't been discovered yet, these lines - // are probably associated with the first error message, - // which is already in the status bar, and are likely to be - // of interest to the user, so spit them to the console. -// - if (!secondErrorFound) { - System.err.println(s); + // remove the build path so people only see the filename + // can't use replaceAll() because the path may have characters in it which + // have meaning in a regular expression. + if (!verbose) { + while ((i = s.indexOf(buildPath + File.separator)) != -1) { + s = s.substring(0, i) + s.substring(i + (buildPath + File.separator).length()); } } + + // look for error line, which contains file name, line number, + // and at least the first line of the error message + String errorFormat = "([\\w\\d_]+.\\w+):(\\d+):\\s*error:\\s*(.*)\\s*"; + String[] pieces = PApplet.match(s, errorFormat); + +// if (pieces != null && exception == null) { +// exception = sketch.placeException(pieces[3], pieces[1], PApplet.parseInt(pieces[2]) - 1); +// if (exception != null) exception.hideStackTrace(); +// } + + if (pieces != null) { + RunnerException e = sketch.placeException(pieces[3], pieces[1], PApplet.parseInt(pieces[2]) - 1); + + if (e != null) { + SketchCode code = sketch.getCode(e.getCodeIndex()); + String fileName = code.isExtension(sketch.getDefaultExtension()) ? code.getPrettyName() : code.getFileName(); + if (!verbose) s = fileName + ":" + e.getCodeLine() + ": error: " + e.getMessage(); + if (exception == null) { + exception = e; + exception.hideStackTrace(); + } + } + } + + System.err.print(s); } ///////////////////////////////////////////////////////////////////////////// diff --git a/app/src/processing/app/debug/StreamRedirectThread.java b/app/src/processing/app/debug/StreamRedirectThread.java deleted file mode 100644 index 795e8c199..000000000 --- a/app/src/processing/app/debug/StreamRedirectThread.java +++ /dev/null @@ -1,84 +0,0 @@ -/* - * @(#)StreamRedirectThread.java 1.4 03/01/23 - * - * Copyright 2003 Sun Microsystems, Inc. All rights reserved. - * SUN PROPRIETARY/CONFIDENTIAL. Use is subject to license terms. - */ -/* - * Copyright (c) 1997-2001 by Sun Microsystems, Inc. All Rights Reserved. - * - * Sun grants you ("Licensee") a non-exclusive, royalty free, license to use, - * modify and redistribute this software in source and binary code form, - * provided that i) this copyright notice and license appear on all copies of - * the software; and ii) Licensee does not utilize the software in a manner - * which is disparaging to Sun. - * - * This software is provided "AS IS," without a warranty of any kind. ALL - * EXPRESS OR IMPLIED CONDITIONS, REPRESENTATIONS AND WARRANTIES, INCLUDING ANY - * IMPLIED WARRANTY OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE OR - * NON-INFRINGEMENT, ARE HEREBY EXCLUDED. SUN AND ITS LICENSORS SHALL NOT BE - * LIABLE FOR ANY DAMAGES SUFFERED BY LICENSEE AS A RESULT OF USING, MODIFYING - * OR DISTRIBUTING THE SOFTWARE OR ITS DERIVATIVES. IN NO EVENT WILL SUN OR ITS - * LICENSORS BE LIABLE FOR ANY LOST REVENUE, PROFIT OR DATA, OR FOR DIRECT, - * INDIRECT, SPECIAL, CONSEQUENTIAL, INCIDENTAL OR PUNITIVE DAMAGES, HOWEVER - * CAUSED AND REGARDLESS OF THE THEORY OF LIABILITY, ARISING OUT OF THE USE OF - * OR INABILITY TO USE SOFTWARE, EVEN IF SUN HAS BEEN ADVISED OF THE - * POSSIBILITY OF SUCH DAMAGES. - * - * This software is not designed or intended for use in on-line control of - * aircraft, air traffic, aircraft navigation or aircraft communications; or in - * the design, construction, operation or maintenance of any nuclear - * facility. Licensee represents and warrants that it will not use or - * redistribute the Software for such purposes. - */ -package processing.app.debug; - -import java.io.*; - -/** - * StreamRedirectThread is a thread which copies it's input to - * it's output and terminates when it completes. - * - * @version @(#) StreamRedirectThread.java 1.4 03/01/23 23:33:38 - * @author Robert Field - */ -public class StreamRedirectThread extends Thread { - - private final Reader in; - private final Writer out; - - private static final int BUFFER_SIZE = 2048; - - /** - * Set up for copy. - * @param name Name of the thread - * @param in Stream to copy from - * @param out Stream to copy to - */ - public StreamRedirectThread(String name, InputStream in, OutputStream out) { - super(name); - this.in = new InputStreamReader(in); - this.out = new OutputStreamWriter(out); - setPriority(Thread.MAX_PRIORITY-1); - } - - /** - * Copy. - */ - public void run() { - try { - char[] cbuf = new char[BUFFER_SIZE]; - int count; - //System.out.println("opening streamredirectthread"); - while ((count = in.read(cbuf, 0, BUFFER_SIZE)) >= 0) { - out.write(cbuf, 0, count); - // had to add the flush() here.. maybe shouldn't be using writer? [fry] - out.flush(); - } - //System.out.println("exiting streamredirectthread"); - out.flush(); - } catch(IOException exc) { - System.err.println("Child I/O Transfer - " + exc); - } - } -} From 5d54fbf70b0003472535431e85819692367473cb Mon Sep 17 00:00:00 2001 From: "David A. Mellis" Date: Sat, 8 May 2010 20:37:54 +0000 Subject: [PATCH 04/11] Removing some Processing stuff that we don't need. Moving the Arduino Fio up in the boards menu. --- app/src/processing/app/Sketch.java | 121 +--- app/src/processing/app/debug/Compiler.java | 163 ----- .../app/debug/EventThread.java.disabled | 404 ----------- .../processing/app/debug/Runner.java.disabled | 659 ------------------ hardware/arduino/boards.txt | 41 +- 5 files changed, 21 insertions(+), 1367 deletions(-) delete mode 100644 app/src/processing/app/debug/EventThread.java.disabled delete mode 100644 app/src/processing/app/debug/Runner.java.disabled diff --git a/app/src/processing/app/Sketch.java b/app/src/processing/app/Sketch.java index 7f96c9dd3..ac82a3a12 100644 --- a/app/src/processing/app/Sketch.java +++ b/app/src/processing/app/Sketch.java @@ -1334,7 +1334,7 @@ public class Sketch { if (libFolder != null && !importedLibraries.contains(libFolder)) { importedLibraries.add(libFolder); - classPath += Compiler.contentsToClassPath(libFolder); + //classPath += Compiler.contentsToClassPath(libFolder); libraryPath += File.pathSeparator + libFolder.getAbsolutePath(); } } @@ -1565,7 +1565,6 @@ public class Sketch { // return false; // } - size(appletFolder.getPath(), foundName); upload(appletFolder.getPath(), foundName, verbose); return true; @@ -1680,124 +1679,6 @@ public class Sketch { } - protected void addManifest(ZipOutputStream zos) throws IOException { - ZipEntry entry = new ZipEntry("META-INF/MANIFEST.MF"); - zos.putNextEntry(entry); - - String contents = - "Manifest-Version: 1.0\n" + - "Created-By: Processing " + Base.VERSION_NAME + "\n" + - "Main-Class: " + name + "\n"; // TODO not package friendly - zos.write(contents.getBytes()); - zos.closeEntry(); - } - - - /** - * Slurps up .class files from a colon (or semicolon on windows) - * separated list of paths and adds them to a ZipOutputStream. - */ - protected void packClassPathIntoZipFile(String path, - ZipOutputStream zos, - HashMap zipFileContents) - throws IOException { - String[] pieces = PApplet.split(path, File.pathSeparatorChar); - - for (int i = 0; i < pieces.length; i++) { - if (pieces[i].length() == 0) continue; - - // is it a jar file or directory? - if (pieces[i].toLowerCase().endsWith(".jar") || - pieces[i].toLowerCase().endsWith(".zip")) { - try { - ZipFile file = new ZipFile(pieces[i]); - Enumeration entries = file.entries(); - while (entries.hasMoreElements()) { - ZipEntry entry = (ZipEntry) entries.nextElement(); - if (entry.isDirectory()) { - // actually 'continue's for all dir entries - - } else { - String entryName = entry.getName(); - // ignore contents of the META-INF folders - if (entryName.indexOf("META-INF") == 0) continue; - - // don't allow duplicate entries - if (zipFileContents.get(entryName) != null) continue; - zipFileContents.put(entryName, new Object()); - - ZipEntry entree = new ZipEntry(entryName); - - zos.putNextEntry(entree); - byte buffer[] = new byte[(int) entry.getSize()]; - InputStream is = file.getInputStream(entry); - - int offset = 0; - int remaining = buffer.length; - while (remaining > 0) { - int count = is.read(buffer, offset, remaining); - offset += count; - remaining -= count; - } - - zos.write(buffer); - zos.flush(); - zos.closeEntry(); - } - } - } catch (IOException e) { - System.err.println("Error in file " + pieces[i]); - e.printStackTrace(); - } - } else { // not a .jar or .zip, prolly a directory - File dir = new File(pieces[i]); - // but must be a dir, since it's one of several paths - // just need to check if it exists - if (dir.exists()) { - packClassPathIntoZipFileRecursive(dir, null, zos); - } - } - } - } - - - /** - * Continue the process of magical exporting. This function - * can be called recursively to walk through folders looking - * for more goodies that will be added to the ZipOutputStream. - */ - static protected void packClassPathIntoZipFileRecursive(File dir, - String sofar, - ZipOutputStream zos) - throws IOException { - String files[] = dir.list(); - for (int i = 0; i < files.length; i++) { - // ignore . .. and .DS_Store - if (files[i].charAt(0) == '.') continue; - - File sub = new File(dir, files[i]); - String nowfar = (sofar == null) ? - files[i] : (sofar + "/" + files[i]); - - if (sub.isDirectory()) { - packClassPathIntoZipFileRecursive(sub, nowfar, zos); - - } else { - // don't add .jar and .zip files, since they only work - // inside the root, and they're unpacked - if (!files[i].toLowerCase().endsWith(".jar") && - !files[i].toLowerCase().endsWith(".zip") && - files[i].charAt(0) != '.') { - ZipEntry entry = new ZipEntry(nowfar); - zos.putNextEntry(entry); - zos.write(Base.loadBytesRaw(sub)); - zos.closeEntry(); - } - } - } - } - - /** * Make sure the sketch hasn't been moved or deleted by some * nefarious user. If they did, try to re-create it and save. diff --git a/app/src/processing/app/debug/Compiler.java b/app/src/processing/app/debug/Compiler.java index a30512a44..d3ca66ea2 100644 --- a/app/src/processing/app/debug/Compiler.java +++ b/app/src/processing/app/debug/Compiler.java @@ -493,167 +493,4 @@ public class Compiler implements MessageConsumer { return files; } - - /** - * Given a folder, return a list of absolute paths to all jar or zip files - * inside that folder, separated by pathSeparatorChar. - * - * This will prepend a colon (or whatever the path separator is) - * so that it can be directly appended to another path string. - * - * As of 0136, this will no longer add the root folder as well. - * - * This function doesn't bother checking to see if there are any .class - * files in the folder or within a subfolder. - */ - static public String contentsToClassPath(File folder) { - if (folder == null) return ""; - - StringBuffer abuffer = new StringBuffer(); - String sep = System.getProperty("path.separator"); - - try { - String path = folder.getCanonicalPath(); - -// disabled as of 0136 - // add the folder itself in case any unzipped files -// abuffer.append(sep); -// abuffer.append(path); -// - // When getting the name of this folder, make sure it has a slash - // after it, so that the names of sub-items can be added. - if (!path.endsWith(File.separator)) { - path += File.separator; - } - - String list[] = folder.list(); - for (int i = 0; i < list.length; i++) { - // Skip . and ._ files. Prior to 0125p3, .jar files that had - // OS X AppleDouble files associated would cause trouble. - if (list[i].startsWith(".")) continue; - - if (list[i].toLowerCase().endsWith(".jar") || - list[i].toLowerCase().endsWith(".zip")) { - abuffer.append(sep); - abuffer.append(path); - abuffer.append(list[i]); - } - } - } catch (IOException e) { - e.printStackTrace(); // this would be odd - } - //System.out.println("included path is " + abuffer.toString()); - //packageListFromClassPath(abuffer.toString()); // WHY? - return abuffer.toString(); - } - - - /** - * A classpath, separated by the path separator, will contain - * a series of .jar/.zip files or directories containing .class - * files, or containing subdirectories that have .class files. - * - * @param path the input classpath - * @return array of possible package names - */ - static public String[] packageListFromClassPath(String path) { - Hashtable table = new Hashtable(); - String pieces[] = - PApplet.split(path, File.pathSeparatorChar); - - for (int i = 0; i < pieces.length; i++) { - //System.out.println("checking piece '" + pieces[i] + "'"); - if (pieces[i].length() == 0) continue; - - if (pieces[i].toLowerCase().endsWith(".jar") || - pieces[i].toLowerCase().endsWith(".zip")) { - //System.out.println("checking " + pieces[i]); - packageListFromZip(pieces[i], table); - - } else { // it's another type of file or directory - File dir = new File(pieces[i]); - if (dir.exists() && dir.isDirectory()) { - packageListFromFolder(dir, null, table); - //importCount = magicImportsRecursive(dir, null, - // table); - //imports, importCount); - } - } - } - int tableCount = table.size(); - String output[] = new String[tableCount]; - int index = 0; - Enumeration e = table.keys(); - while (e.hasMoreElements()) { - output[index++] = ((String) e.nextElement()).replace('/', '.'); - } - //System.arraycopy(imports, 0, output, 0, importCount); - //PApplet.printarr(output); - return output; - } - - - static private void packageListFromZip(String filename, Hashtable table) { - try { - ZipFile file = new ZipFile(filename); - Enumeration entries = file.entries(); - while (entries.hasMoreElements()) { - ZipEntry entry = (ZipEntry) entries.nextElement(); - - if (!entry.isDirectory()) { - String name = entry.getName(); - - if (name.endsWith(".class")) { - int slash = name.lastIndexOf('/'); - if (slash == -1) continue; - - String pname = name.substring(0, slash); - if (table.get(pname) == null) { - table.put(pname, new Object()); - } - } - } - } - } catch (IOException e) { - System.err.println("Ignoring " + filename + " (" + e.getMessage() + ")"); - //e.printStackTrace(); - } - } - - - /** - * Make list of package names by traversing a directory hierarchy. - * Each time a class is found in a folder, add its containing set - * of folders to the package list. If another folder is found, - * walk down into that folder and continue. - */ - static private void packageListFromFolder(File dir, String sofar, - Hashtable table) { - //String imports[], - //int importCount) { - //System.err.println("checking dir '" + dir + "'"); - boolean foundClass = false; - String files[] = dir.list(); - - for (int i = 0; i < files.length; i++) { - if (files[i].equals(".") || files[i].equals("..")) continue; - - File sub = new File(dir, files[i]); - if (sub.isDirectory()) { - String nowfar = - (sofar == null) ? files[i] : (sofar + "." + files[i]); - packageListFromFolder(sub, nowfar, table); - //System.out.println(nowfar); - //imports[importCount++] = nowfar; - //importCount = magicImportsRecursive(sub, nowfar, - // imports, importCount); - } else if (!foundClass) { // if no classes found in this folder yet - if (files[i].endsWith(".class")) { - //System.out.println("unique class: " + files[i] + " for " + sofar); - table.put(sofar, new Object()); - foundClass = true; - } - } - } - } } diff --git a/app/src/processing/app/debug/EventThread.java.disabled b/app/src/processing/app/debug/EventThread.java.disabled deleted file mode 100644 index 4c68eeb47..000000000 --- a/app/src/processing/app/debug/EventThread.java.disabled +++ /dev/null @@ -1,404 +0,0 @@ -/* - * @(#)EventThread.java 1.4 03/01/23 - * - * Copyright 2003 Sun Microsystems, Inc. All rights reserved. - * SUN PROPRIETARY/CONFIDENTIAL. Use is subject to license terms. - */ -/* - * Copyright (c) 1997-2001 by Sun Microsystems, Inc. All Rights Reserved. - * - * Sun grants you ("Licensee") a non-exclusive, royalty free, license to use, - * modify and redistribute this software in source and binary code form, - * provided that i) this copyright notice and license appear on all copies of - * the software; and ii) Licensee does not utilize the software in a manner - * which is disparaging to Sun. - * - * This software is provided "AS IS," without a warranty of any kind. ALL - * EXPRESS OR IMPLIED CONDITIONS, REPRESENTATIONS AND WARRANTIES, INCLUDING ANY - * IMPLIED WARRANTY OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE OR - * NON-INFRINGEMENT, ARE HEREBY EXCLUDED. SUN AND ITS LICENSORS SHALL NOT BE - * LIABLE FOR ANY DAMAGES SUFFERED BY LICENSEE AS A RESULT OF USING, MODIFYING - * OR DISTRIBUTING THE SOFTWARE OR ITS DERIVATIVES. IN NO EVENT WILL SUN OR ITS - * LICENSORS BE LIABLE FOR ANY LOST REVENUE, PROFIT OR DATA, OR FOR DIRECT, - * INDIRECT, SPECIAL, CONSEQUENTIAL, INCIDENTAL OR PUNITIVE DAMAGES, HOWEVER - * CAUSED AND REGARDLESS OF THE THEORY OF LIABILITY, ARISING OUT OF THE USE OF - * OR INABILITY TO USE SOFTWARE, EVEN IF SUN HAS BEEN ADVISED OF THE - * POSSIBILITY OF SUCH DAMAGES. - * - * This software is not designed or intended for use in on-line control of - * aircraft, air traffic, aircraft navigation or aircraft communications; or in - * the design, construction, operation or maintenance of any nuclear - * facility. Licensee represents and warrants that it will not use or - * redistribute the Software for such purposes. - */ - -package processing.app.debug; - -import java.io.PrintWriter; -import java.util.HashMap; -import java.util.Iterator; -import java.util.List; -import java.util.Map; - -import com.sun.jdi.*; -import com.sun.jdi.event.*; -import com.sun.jdi.request.*; - -/** - * This class processes incoming JDI events and displays them - * - * @version @(#) EventThread.java 1.4 03/01/23 23:33:38 - * @author Robert Field - */ -public class EventThread extends Thread { - - private final Runner parent; - private final VirtualMachine vm; // Running VM - private final String[] excludes; // Packages to exclude - private final PrintWriter writer; // Where output goes - - static String nextBaseIndent = ""; // Starting indent for next thread - - private boolean connected = true; // Connected to VM - private boolean vmDied = true; // VMDeath occurred - - // Maps ThreadReference to ThreadTrace instances - private Map traceMap = new HashMap(); - - - public EventThread(Runner parent, VirtualMachine vm, String[] excludes, PrintWriter writer) { - super("event-handler"); - this.parent = parent; - this.vm = vm; - this.excludes = excludes; - this.writer = writer; - } - - /** - * Run the event handling thread. - * As long as we are connected, get event sets off - * the queue and dispatch the events within them. - */ - public void run() { - EventQueue queue = vm.eventQueue(); - while (connected) { - try { - EventSet eventSet = queue.remove(); - EventIterator it = eventSet.eventIterator(); - while (it.hasNext()) { - handleEvent(it.nextEvent()); - } - eventSet.resume(); - } catch (InterruptedException exc) { - // Ignore - } catch (VMDisconnectedException discExc) { - handleDisconnectedException(); - break; - } - } - } - - /** - * Create the desired event requests, and enable - * them so that we will get events. - * @param excludes Class patterns for which we don't want events - * @param watchFields Do we want to watch assignments to fields - */ - public void setEventRequests(boolean watchFields) { - EventRequestManager mgr = vm.eventRequestManager(); - -// VMDeathRequest deathReq = mgr.createVMDeathRequest(); -// deathReq.setSuspendPolicy(EventRequest.SUSPEND_ALL); -// deathReq.enable(); - - // get only the uncaught exceptions - ExceptionRequest excReq = mgr.createExceptionRequest(null, false, true); - // this version reports all exceptions, caught or uncaught - //ExceptionRequest excReq = mgr.createExceptionRequest(null, true, true); - // suspend so we can step - excReq.setSuspendPolicy(EventRequest.SUSPEND_ALL); - excReq.enable(); - - /* - MethodEntryRequest menr = mgr.createMethodEntryRequest(); - for (int i=0; i 0) { - indent.append("| "); - } - - EventRequestManager mgr = vm.eventRequestManager(); - mgr.deleteEventRequest(event.request()); - } - - void threadDeathEvent(ThreadDeathEvent event) { - indent = new StringBuffer(baseIndent); - println("====== " + thread.name() + " end ======"); - } - } - - /** - * Returns the ThreadTrace instance for the specified thread, - * creating one if needed. - */ - ThreadTrace threadTrace(ThreadReference thread) { - ThreadTrace trace = (ThreadTrace)traceMap.get(thread); - if (trace == null) { - trace = new ThreadTrace(thread); - traceMap.put(thread, trace); - } - return trace; - } - - /** - * Dispatch incoming events - */ - private void handleEvent(Event event) { - if (event instanceof ExceptionEvent) { - exceptionEvent((ExceptionEvent)event); - } else if (event instanceof ModificationWatchpointEvent) { - fieldWatchEvent((ModificationWatchpointEvent)event); - } else if (event instanceof MethodEntryEvent) { - methodEntryEvent((MethodEntryEvent)event); - } else if (event instanceof MethodExitEvent) { - methodExitEvent((MethodExitEvent)event); - } else if (event instanceof StepEvent) { - stepEvent((StepEvent)event); - } else if (event instanceof ThreadDeathEvent) { - threadDeathEvent((ThreadDeathEvent)event); - } else if (event instanceof ClassPrepareEvent) { - classPrepareEvent((ClassPrepareEvent)event); - } else if (event instanceof VMStartEvent) { - vmStartEvent((VMStartEvent)event); - } else if (event instanceof VMDeathEvent) { - vmDeathEvent((VMDeathEvent)event); - } else if (event instanceof VMDisconnectEvent) { - vmDisconnectEvent((VMDisconnectEvent)event); - } else { - throw new Error("Unexpected event type"); - } - } - - /*** - * A VMDisconnectedException has happened while dealing with - * another event. We need to flush the event queue, dealing only - * with exit events (VMDeath, VMDisconnect) so that we terminate - * correctly. - */ - synchronized void handleDisconnectedException() { - EventQueue queue = vm.eventQueue(); - while (connected) { - try { - EventSet eventSet = queue.remove(); - EventIterator iter = eventSet.eventIterator(); - while (iter.hasNext()) { - Event event = iter.nextEvent(); - if (event instanceof VMDeathEvent) { - vmDeathEvent((VMDeathEvent)event); - } else if (event instanceof VMDisconnectEvent) { - vmDisconnectEvent((VMDisconnectEvent)event); - } - } - eventSet.resume(); // Resume the VM - } catch (InterruptedException exc) { - // ignore - } - } - } - - private void vmStartEvent(VMStartEvent event) { - if (writer != null) writer.println("-- VM Started --"); - } - - // Forward event for thread specific processing - private void methodEntryEvent(MethodEntryEvent event) { - threadTrace(event.thread()).methodEntryEvent(event); - } - - // Forward event for thread specific processing - private void methodExitEvent(MethodExitEvent event) { - threadTrace(event.thread()).methodExitEvent(event); - } - - // Forward event for thread specific processing - private void stepEvent(StepEvent event) { - threadTrace(event.thread()).stepEvent(event); - } - - // Forward event for thread specific processing - private void fieldWatchEvent(ModificationWatchpointEvent event) { - threadTrace(event.thread()).fieldWatchEvent(event); - } - - void threadDeathEvent(ThreadDeathEvent event) { - ThreadTrace trace = (ThreadTrace)traceMap.get(event.thread()); - if (trace != null) { // only want threads we care about - trace.threadDeathEvent(event); // Forward event - } - } - - /** - * A new class has been loaded. - * Set watchpoints on each of its fields - */ - private void classPrepareEvent(ClassPrepareEvent event) { -// System.out.println(event); -// List list = event.referenceType().methodsByName("stop"); -// Object o = list.get(0); -// System.out.println("stop methods = " + list); -// System.out.println(o.getClass()); - - EventRequestManager mgr = vm.eventRequestManager(); - List fields = event.referenceType().visibleFields(); - for (Iterator it = fields.iterator(); it.hasNext(); ) { - Field field = (Field)it.next(); - ModificationWatchpointRequest req = - mgr.createModificationWatchpointRequest(field); - for (int i=0; i params = new ArrayList(); - - //params.add("-Xint"); // interpreted mode - //params.add("-Xprof"); // profiler - //params.add("-Xaprof"); // allocation profiler - //params.add("-Xrunhprof:cpu=samples"); // old-style profiler - - // TODO change this to use run.args = true, run.args.0, run.args.1, etc. - // so that spaces can be included in the arg names - String options = Preferences.get("run.options"); - if (options.length() > 0) { - String pieces[] = PApplet.split(options, ' '); - for (int i = 0; i < pieces.length; i++) { - String p = pieces[i].trim(); - if (p.length() > 0) { - params.add(p); - } - } - } - -// params.add("-Djava.ext.dirs=nuffing"); - - if (Preferences.getBoolean("run.options.memory")) { - params.add("-Xms" + Preferences.get("run.options.memory.initial") + "m"); - params.add("-Xmx" + Preferences.get("run.options.memory.maximum") + "m"); - } - - if (Base.isMacOS()) { - params.add("-Xdock:name=" + appletClassName); -// params.add("-Dcom.apple.mrj.application.apple.menu.about.name=" + -// sketch.getMainClassName()); - } - // sketch.libraryPath might be "" - // librariesClassPath will always have sep char prepended - params.add("-Djava.library.path=" + - sketch.getLibraryPath() + - File.pathSeparator + - System.getProperty("java.library.path")); - - params.add("-cp"); - params.add(sketch.getClassPath()); -// params.add(sketch.getClassPath() + -// File.pathSeparator + -// Base.librariesClassPath); - - //PApplet.println(PApplet.split(sketch.classPath, ':')); - - String outgoing[] = new String[params.size()]; - params.toArray(outgoing); - - //PApplet.println(outgoing); -// PApplet.println(PApplet.split(outgoing[0], ":")); -// PApplet.println(); -// PApplet.println("class path"); -// PApplet.println(PApplet.split(outgoing[2], ":")); - - return outgoing; - //return (String[]) params.toArray(); - -// System.out.println("sketch class path"); -// PApplet.println(PApplet.split(sketch.classPath, ';')); -// System.out.println(); -// System.out.println("libraries class path"); -// PApplet.println(PApplet.split(Base.librariesClassPath, ';')); -// System.out.println(); - } - - - protected String[] getSketchParams() { - ArrayList params = new ArrayList(); - - // It's dangerous to add your own main() to your code, - // but if you've done it, we'll respect your right to hang yourself. - // http://dev.processing.org/bugs/show_bug.cgi?id=1446 - if (PdePreprocessor.foundMain) { - params.add(appletClassName); - - } else { - params.add("processing.core.PApplet"); - - // If there was a saved location (this guy has been run more than once) - // then the location will be set to the last position of the sketch window. - // This will be passed to the PApplet runner using something like - // --location=30,20 - // Otherwise, the editor location will be passed, and the applet will - // figure out where to place itself based on the editor location. - // --editor-location=150,20 - if (editor != null) { // if running processing-cmd, don't do placement - Point windowLocation = editor.getSketchLocation(); - if (windowLocation != null) { - params.add(PApplet.ARGS_LOCATION + "=" + - windowLocation.x + "," + windowLocation.y); - } else { - Point editorLocation = editor.getLocation(); - params.add(PApplet.ARGS_EDITOR_LOCATION + "=" + - editorLocation.x + "," + editorLocation.y); - } - params.add(PApplet.ARGS_EXTERNAL); - } - - params.add(PApplet.ARGS_DISPLAY + "=" + - Preferences.get("run.display")); - params.add(PApplet.ARGS_SKETCH_FOLDER + "=" + - sketch.getFolder().getAbsolutePath()); - - if (presenting) { - params.add(PApplet.ARGS_PRESENT); - if (Preferences.getBoolean("run.present.exclusive")) { - params.add(PApplet.ARGS_EXCLUSIVE); - } - params.add(PApplet.ARGS_STOP_COLOR + "=" + - Preferences.get("run.present.stop.color")); - params.add(PApplet.ARGS_BGCOLOR + "=" + - Preferences.get("run.present.bgcolor")); - } - - params.add(appletClassName); - } - -// String outgoing[] = new String[params.size()]; -// params.toArray(outgoing); -// return outgoing; - return (String[]) params.toArray(new String[0]); - } - - - protected VirtualMachine launchVirtualMachine(String[] vmParams, - String[] classParams) { - //vm = launchTarget(sb.toString()); - LaunchingConnector connector = (LaunchingConnector) - findConnector("com.sun.jdi.RawCommandLineLaunch"); - //PApplet.println(connector); // gets the defaults - - //Map arguments = connectorArguments(connector, mainArgs); - Map arguments = connector.defaultArguments(); - - Connector.Argument commandArg = - (Connector.Argument)arguments.get("command"); - // Using localhost instead of 127.0.0.1 sometimes causes a - // "Transport Error 202" error message when trying to run. - // http://dev.processing.org/bugs/show_bug.cgi?id=895 - String addr = "127.0.0.1:" + (8000 + (int) (Math.random() * 1000)); - //String addr = "localhost:" + (8000 + (int) (Math.random() * 1000)); - //String addr = "" + (8000 + (int) (Math.random() * 1000)); - - String commandArgs = - "java -Xrunjdwp:transport=dt_socket,address=" + addr + ",suspend=y "; - if (Base.isWindows()) { - commandArgs = - "java -Xrunjdwp:transport=dt_shmem,address=" + addr + ",suspend=y "; - } else if (Base.isMacOS()) { - if (System.getProperty("os.version").startsWith("10.4")) { - // -d32 not understood by 10.4 (and not needed) - commandArgs = - "java -Xrunjdwp:transport=dt_socket,address=" + addr + ",suspend=y "; - } else { - commandArgs = - "java -d32 -Xrunjdwp:transport=dt_socket,address=" + addr + ",suspend=y "; - } - } - - for (int i = 0; i < vmParams.length; i++) { - commandArgs = addArgument(commandArgs, vmParams[i], ' '); - } - if (classParams != null) { - for (int i = 0; i < classParams.length; i++) { - commandArgs = addArgument(commandArgs, classParams[i], ' '); - } - } - commandArg.setValue(commandArgs); - - Connector.Argument addressArg = - (Connector.Argument)arguments.get("address"); - addressArg.setValue(addr); - - //PApplet.println(connector); // prints the current - //com.sun.tools.jdi.AbstractLauncher al; - //com.sun.tools.jdi.RawCommandLineLauncher rcll; - - //System.out.println(PApplet.javaVersion); - // http://java.sun.com/j2se/1.5.0/docs/guide/jpda/conninv.html#sunlaunch - try { - return connector.launch(arguments); - } catch (IOException exc) { - throw new Error("Unable to launch target VM: " + exc); - } catch (IllegalConnectorArgumentsException exc) { - throw new Error("Internal error: " + exc); - } catch (VMStartException exc) { - Process p = exc.process(); - //System.out.println(p); - String[] errorStrings = PApplet.loadStrings(p.getErrorStream()); - /*String[] inputStrings =*/ PApplet.loadStrings(p.getInputStream()); - - if (errorStrings != null && errorStrings.length > 1) { - if (errorStrings[0].indexOf("Invalid maximum heap size") != -1) { - Base.showWarning("Way Too High", - "Please lower the value for \u201Cmaximum available memory\u201D in the\n" + - "Preferences window. For more information, read Help \u2192 Troubleshooting.", - exc); - } else { - PApplet.println(errorStrings); - System.err.println("Using startup command:"); - PApplet.println(arguments); - } - } else { - exc.printStackTrace(); - System.err.println("Could not run the sketch (Target VM failed to initialize)."); - if (Preferences.getBoolean("run.options.memory")) { - // Only mention this if they've even altered the memory setup - System.err.println("Make sure that you haven't set the maximum available memory too high."); - } - System.err.println("For more information, read revisions.txt and Help \u2192 Troubleshooting."); - } - // changing this to separate editor and listener [091124] - //if (editor != null) { - listener.statusError("Could not run the sketch."); - //} - return null; - } - } - - - private static boolean hasWhitespace(String string) { - int length = string.length(); - for (int i = 0; i < length; i++) { - if (Character.isWhitespace(string.charAt(i))) { - return true; - } - } - return false; - } - - - private static String addArgument(String string, String argument, char sep) { - if (hasWhitespace(argument) || argument.indexOf(',') != -1) { - // Quotes were stripped out for this argument, add 'em back. - StringBuffer buffer = new StringBuffer(string); - buffer.append('"'); - for (int i = 0; i < argument.length(); i++) { - char c = argument.charAt(i); - if (c == '"') { - buffer.append('\\'); - } - buffer.append(c); - } - buffer.append('\"'); - buffer.append(sep); - return buffer.toString(); - } else { - return string + argument + String.valueOf(sep); - } - } - - - /** - * Generate the trace. - * Enable events, start thread to display events, - * start threads to forward remote error and output streams, - * resume the remote VM, wait for the final event, and shutdown. - */ - protected void generateTrace(PrintWriter writer) { - vm.setDebugTraceMode(debugTraceMode); - - EventThread eventThread = null; - //if (writer != null) { - eventThread = new EventThread(this, vm, excludes, writer); - eventThread.setEventRequests(watchFields); - eventThread.start(); - //} - - //redirectOutput(); - - Process process = vm.process(); - -// processInput = new SystemOutSiphon(process.getInputStream()); -// processError = new MessageSiphon(process.getErrorStream(), this); - - // Copy target's output and error to our output and error. -// errThread = new StreamRedirectThread("error reader", -// process.getErrorStream(), -// System.err); - MessageSiphon ms = new MessageSiphon(process.getErrorStream(), this); - errThread = ms.getThread(); - - outThread = new StreamRedirectThread("output reader", - process.getInputStream(), - System.out); - - errThread.start(); - outThread.start(); - - vm.resume(); - //System.out.println("done with resume"); - - // Shutdown begins when event thread terminates - try { - if (eventThread != null) eventThread.join(); -// System.out.println("in here"); - // Bug #852 tracked to this next line in the code. - // http://dev.processing.org/bugs/show_bug.cgi?id=852 - errThread.join(); // Make sure output is forwarded -// System.out.println("and then"); - outThread.join(); // before we exit -// System.out.println("out of it"); - - // At this point, disable the run button. - // This happens when the sketch is exited by hitting ESC, - // or the user manually closes the sketch window. - // TODO this should be handled better, should it not? - if (editor != null) { - editor.internalRunnerClosed(); - } - } catch (InterruptedException exc) { - // we don't interrupt - } - //System.out.println("and leaving"); - if (writer != null) writer.close(); - } - - - protected Connector findConnector(String connectorName) { - List connectors = Bootstrap.virtualMachineManager().allConnectors(); - - // debug: code to list available connectors -// Iterator iter2 = connectors.iterator(); -// while (iter2.hasNext()) { -// Connector connector = (Connector)iter2.next(); -// System.out.println("connector name is " + connector.name()); -// } - - Iterator iter = connectors.iterator(); - while (iter.hasNext()) { - Connector connector = (Connector)iter.next(); - if (connector.name().equals(connectorName)) { - return connector; - } - } - throw new Error("No connector"); - } - - - public void exception(ExceptionEvent event) { -// System.out.println(event); - ObjectReference or = event.exception(); - ReferenceType rt = or.referenceType(); - String exceptionName = rt.name(); - //Field messageField = Throwable.class.getField("detailMessage"); - Field messageField = rt.fieldByName("detailMessage"); -// System.out.println("field " + messageField); - Value messageValue = or.getValue(messageField); -// System.out.println("mess val " + messageValue); - - int last = exceptionName.lastIndexOf('.'); - String message = exceptionName.substring(last + 1); - if (messageValue != null) { - String messageStr = messageValue.toString(); - if (messageStr.startsWith("\"")) { - messageStr = messageStr.substring(1, messageStr.length() - 1); - } - message += ": " + messageStr; - } -// System.out.println("mess type " + messageValue.type()); - //StringReference messageReference = (StringReference) messageValue.type(); - -// System.out.println(or.referenceType().fields()); -// if (name.startsWith("java.lang.")) { -// name = name.substring(10); - if (!handleCommonErrors(exceptionName, message, listener)) { - reportException(message, event.thread()); - } - if (editor != null) { - editor.internalRunnerClosed(); - } - } - - public static boolean handleCommonErrors(final String exceptionClass, final String message, final RunnerListener listener) - { - if (exceptionClass.equals("java.lang.OutOfMemoryError")) { - listener.statusError("OutOfMemoryError: You may need to increase the memory setting in Preferences."); - System.err.println("An OutOfMemoryError means that your code is either using up too much memory"); - System.err.println("because of a bug (e.g. creating an array that's too large, or unintentionally"); - System.err.println("loading thousands of images), or that your sketch may need more memory to run."); - System.err.println("If your sketch uses a lot of memory (for instance if it loads a lot of data files)"); - System.err.println("you can increase the memory available to your sketch using the Preferences window."); - - } else if (exceptionClass.equals("java.lang.StackOverflowError")) { - listener.statusError("StackOverflowError: This sketch is attempting too much recursion."); - System.err.println("A StackOverflowError means that you have a bug that's causing a function"); - System.err.println("to be called recursively (it's calling itself and going in circles),"); - System.err.println("or you're intentionally calling a recursive function too much,"); - System.err.println("and your code should be rewritten in a more efficient manner."); - - } else if (exceptionClass.equals("java.lang.UnsupportedClassVersionError")) { - listener.statusError("UnsupportedClassVersionError: A library is using code compiled with an unsupported version of Java."); - System.err.println("This version of Processing only supports libraries and JAR files compiled for Java 1.5."); - System.err.println("A library used by this sketch was compiled for Java 1.6 or later, "); - System.err.println("and needs to be recompiled to be compatible with Java 1.5."); - } else if (exceptionClass.equals("java.lang.NoSuchMethodError") || exceptionClass.equals("java.lang.NoSuchFieldError")) { - listener.statusError(exceptionClass.substring(10) + ": You're probably using a library that's incompatible with this version of Processing."); - } else if (message!=null && - message.equals("ClassNotFoundException: quicktime.std.StdQTException")) { - listener - .statusError("Could not find QuickTime, please reinstall QuickTime 7 or later."); - } else { - return false; - } - return true; - } - - // TODO: This may be called more than one time per error in the VM, - // presumably because exceptions might be wrapped inside others, - // and this will fire for both. - protected void reportException(String message, ThreadReference thread) { - listener.statusError(findException(message, thread)); - } - - - /** - * Move through a list of stack frames, searching for references to code - * found in the current sketch. Return with a RunnerException that contains - * the location of the error, or if nothing is found, just return with a - * RunnerException that wraps the error message itself. - */ - RunnerException findException(String message, ThreadReference thread) { - try { - // use to dump the stack for debugging -// for (StackFrame frame : thread.frames()) { -// System.out.println("frame: " + frame); -// } - - List frames = thread.frames(); - for (StackFrame frame : frames) { - try { - Location location = frame.location(); - String filename = null; - filename = location.sourceName(); - int lineNumber = location.lineNumber() - 1; - RunnerException rex = - sketch.placeException(message, filename, lineNumber); - if (rex != null) { - return rex; - } - } catch (AbsentInformationException e) { - // Any of the thread.blah() methods can throw an AbsentInformationEx - // if that bit of data is missing. If so, just write out the error - // message to the console. - //e.printStackTrace(); // not useful - exception = new RunnerException(message); - exception.hideStackTrace(); - listener.statusError(exception); - } - } - } catch (IncompatibleThreadStateException e) { - // This shouldn't happen, but if it does, print the exception in case - // it's something that needs to be debugged separately. - e.printStackTrace(); - } - // Give up, nothing found inside the pile of stack frames - RunnerException rex = new RunnerException(message); - // exception is being created /here/, so stack trace is not useful - rex.hideStackTrace(); - return rex; - } - - - public void close() { - // TODO make sure stop() has already been called to exit the sketch - - // TODO actually kill off the vm here - if (vm != null) { - try { - vm.exit(0); - - } catch (com.sun.jdi.VMDisconnectedException vmde) { - // if the vm has disconnected on its own, ignore message - //System.out.println("harmless disconnect " + vmde.getMessage()); - // TODO shouldn't need to do this, need to do more cleanup - } - vm = null; - } - } - - - // made synchronized for rev 87 - // attempted to remove synchronized for 0136 to fix bug #775 (no luck tho) - // http://dev.processing.org/bugs/show_bug.cgi?id=775 - synchronized public void message(String s) { - //System.out.println("M" + s.length() + ":" + s.trim()); // + "MMM" + s.length()); - - // this eats the CRLFs on the lines.. oops.. do it later - //if (s.trim().length() == 0) return; - - // this is PApplet sending a message (via System.out.println) - // that signals that the applet has been quit. - if (s.indexOf(PApplet.EXTERNAL_STOP) == 0) { - //System.out.println("external: quit"); - if (editor != null) { - //editor.internalCloseRunner(); // [091124] - editor.handleStop(); - } - return; - } - - // this is the PApplet sending us a message that the applet - // is being moved to a new window location - if (s.indexOf(PApplet.EXTERNAL_MOVE) == 0) { - String nums = s.substring(s.indexOf(' ') + 1).trim(); - int space = nums.indexOf(' '); - int left = Integer.parseInt(nums.substring(0, space)); - int top = Integer.parseInt(nums.substring(space + 1)); - // this is only fired when connected to an editor - editor.setSketchLocation(new Point(left, top)); - //System.out.println("external: move to " + left + " " + top); - return; - } - - // these are used for debugging, in case there are concerns - // that some errors aren't coming through properly -// if (s.length() > 2) { -// System.err.println(newMessage); -// System.err.println("message " + s.length() + ":" + s); -// } - - // always shove out the mesage, since it might not fall under - // the same setup as we're expecting - System.err.print(s); - //System.err.println("[" + s.length() + "] " + s); - System.err.flush(); - } - } diff --git a/hardware/arduino/boards.txt b/hardware/arduino/boards.txt index 171091d33..d300a47ab 100644 --- a/hardware/arduino/boards.txt +++ b/hardware/arduino/boards.txt @@ -101,6 +101,26 @@ bt.build.core=arduino ############################################################## +fio.name=Arduino Fio + +fio.upload.protocol=stk500 +fio.upload.maximum_size=30720 +fio.upload.speed=57600 + +fio.bootloader.low_fuses=0xFF +fio.bootloader.high_fuses=0xDA +fio.bootloader.extended_fuses=0x05 +fio.bootloader.path=arduino:atmega +fio.bootloader.file=ATmegaBOOT_168_atmega328_pro_8MHz.hex +fio.bootloader.unlock_bits=0x3F +fio.bootloader.lock_bits=0x0F + +fio.build.mcu=atmega328p +fio.build.f_cpu=8000000L +fio.build.core=arduino:arduino + +############################################################## + lilypad328.name=LilyPad Arduino w/ ATmega328 lilypad328.upload.protocol=stk500 @@ -179,27 +199,6 @@ pro.build.mcu=atmega168 pro.build.f_cpu=8000000L pro.build.core=arduino -############################################################## - -fio.name=Arduino Fio - -fio.upload.protocol=stk500 -fio.upload.maximum_size=30720 -fio.upload.speed=57600 - -fio.bootloader.low_fuses=0xFF -fio.bootloader.high_fuses=0xDA -fio.bootloader.extended_fuses=0x05 -fio.bootloader.path=arduino:atmega -fio.bootloader.file=ATmegaBOOT_168_atmega328_pro_8MHz.hex -fio.bootloader.unlock_bits=0x3F -fio.bootloader.lock_bits=0x0F - -fio.build.mcu=atmega328p -fio.build.f_cpu=8000000L -fio.build.core=arduino:arduino - - ############################################################## atmega168.name=Arduino NG or older w/ ATmega168 From c4760d8ae79559470e2cc494c0ad6dcc20112ded Mon Sep 17 00:00:00 2001 From: "David A. Mellis" Date: Sat, 8 May 2010 21:47:19 +0000 Subject: [PATCH 05/11] Moving to ant-based build system from Processing. Mac OS X seems to work (for the moment). --- app/build.xml | 52 + .../ExtendedCommonASTWithHiddenTokens.java | 132 -- .../TokenStreamCopyingHiddenTokenFilter.java | 221 -- app/src/antlr/java/java.g | 1277 ----------- app/src/antlr/java/java.g.java15 | 2002 ----------------- app/src/antlr/java/java.tree.g | 326 --- build/build.xml | 445 ++++ build/macosx/template.app/Contents/Info.plist | 103 + .../Contents/MacOS/JavaApplicationStub | Bin 0 -> 34128 bytes build/macosx/template.app/Contents/PkgInfo | 1 + .../Contents/Resources/Java/libquaqua.jnilib | Bin 0 -> 75396 bytes .../Resources/Java/libquaqua64.jnilib | Bin 0 -> 140944 bytes .../Resources/Java/librxtxSerial.jnilib | Bin 0 -> 271860 bytes .../Contents/Resources/Java/quaqua.jar | Bin 0 -> 1815082 bytes .../template.app/Contents/Resources/pde.icns | Bin 0 -> 42258 bytes .../Contents/Resources/processing.icns | Bin 0 -> 254523 bytes core/src/processing/core/PApplet.java | 1437 ++++++++++++ 17 files changed, 2038 insertions(+), 3958 deletions(-) create mode 100644 app/build.xml delete mode 100644 app/src/antlr/ExtendedCommonASTWithHiddenTokens.java delete mode 100644 app/src/antlr/TokenStreamCopyingHiddenTokenFilter.java delete mode 100644 app/src/antlr/java/java.g delete mode 100644 app/src/antlr/java/java.g.java15 delete mode 100644 app/src/antlr/java/java.tree.g create mode 100644 build/build.xml create mode 100755 build/macosx/template.app/Contents/Info.plist create mode 100755 build/macosx/template.app/Contents/MacOS/JavaApplicationStub create mode 100755 build/macosx/template.app/Contents/PkgInfo create mode 100755 build/macosx/template.app/Contents/Resources/Java/libquaqua.jnilib create mode 100755 build/macosx/template.app/Contents/Resources/Java/libquaqua64.jnilib create mode 100755 build/macosx/template.app/Contents/Resources/Java/librxtxSerial.jnilib create mode 100755 build/macosx/template.app/Contents/Resources/Java/quaqua.jar create mode 100644 build/macosx/template.app/Contents/Resources/pde.icns create mode 100755 build/macosx/template.app/Contents/Resources/processing.icns diff --git a/app/build.xml b/app/build.xml new file mode 100644 index 000000000..eb1c313bf --- /dev/null +++ b/app/build.xml @@ -0,0 +1,52 @@ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + diff --git a/app/src/antlr/ExtendedCommonASTWithHiddenTokens.java b/app/src/antlr/ExtendedCommonASTWithHiddenTokens.java deleted file mode 100644 index d997f0be8..000000000 --- a/app/src/antlr/ExtendedCommonASTWithHiddenTokens.java +++ /dev/null @@ -1,132 +0,0 @@ -package antlr; - -/* ANTLR Translator Generator - * Project led by Terence Parr at http://www.jGuru.com - * Software rights: http://www.antlr.org/RIGHTS.html - * - * $Id: ExtendedCommonASTWithHiddenTokens.java 3419 2007-07-16 14:02:05Z fry $ - */ - -import java.io.*; -//import antlr.*; -import antlr.collections.*; -//import antlr.collections.impl.*; - -/** A CommonAST whose initialization copies hidden token - * information from the Token used to create a node. - */ -public class ExtendedCommonASTWithHiddenTokens - extends CommonASTWithHiddenTokens { - - public ExtendedCommonASTWithHiddenTokens() { - super(); - } - - public ExtendedCommonASTWithHiddenTokens(Token tok) { - super(tok); - } - - public void initialize(AST ast) { - ExtendedCommonASTWithHiddenTokens a = - (ExtendedCommonASTWithHiddenTokens)ast; - super.initialize(a); - hiddenBefore = a.getHiddenBefore(); - hiddenAfter = a.getHiddenAfter(); - } - - public String getHiddenAfterString() { - - CommonHiddenStreamToken t; - StringBuffer hiddenAfterString = new StringBuffer(100); - - for ( t = hiddenAfter ; t != null ; t = t.getHiddenAfter() ) { - hiddenAfterString.append(t.getText()); - } - - return hiddenAfterString.toString(); - } - - public String getHiddenBeforeString() { - - antlr.CommonHiddenStreamToken - child = null, - parent = hiddenBefore; - - // if there aren't any hidden tokens here, quietly return - // - if (parent == null) { - return ""; - } - - // traverse back to the head of the list of tokens before this node - do { - child = parent; - parent = child.getHiddenBefore(); - } while (parent != null); - - // dump that list - - StringBuffer hiddenBeforeString = new StringBuffer(100); - - for ( CommonHiddenStreamToken t = child; t != null ; - t = t.getHiddenAfter() ) { - hiddenBeforeString.append(t.getText()); - } - - return hiddenBeforeString.toString(); - } - - public void xmlSerializeNode(Writer out) - throws IOException { - StringBuffer buf = new StringBuffer(100); - buf.append("<"); - buf.append(getClass().getName() + " "); - - buf.append("hiddenBeforeString=\"" + - encode(getHiddenBeforeString()) + - "\" text=\"" + encode(getText()) + "\" type=\"" + - getType() + "\" hiddenAfterString=\"" + - encode(getHiddenAfterString()) + "\"/>"); - out.write(buf.toString()); - } - - public void xmlSerializeRootOpen(Writer out) - throws IOException { - StringBuffer buf = new StringBuffer(100); - buf.append("<"); - buf.append(getClass().getName() + " "); - buf.append("hiddenBeforeString=\"" + - encode(getHiddenBeforeString()) + - "\" text=\"" + encode(getText()) + "\" type=\"" + - getType() + "\" hiddenAfterString=\"" + - encode(getHiddenAfterString()) + "\">\n"); - out.write(buf.toString()); - } - - public void xmlSerializeRootClose(Writer out) - throws IOException { - out.write("\n"); - } - - public void xmlSerialize(Writer out) throws IOException { - // print out this node and all siblings - for (AST node = this; - node != null; - node = node.getNextSibling()) { - if (node.getFirstChild() == null) { - // print guts (class name, attributes) - ((BaseAST)node).xmlSerializeNode(out); - } - else { - ((BaseAST)node).xmlSerializeRootOpen(out); - - // print children - ((BaseAST)node.getFirstChild()).xmlSerialize(out); - - // print end tag - ((BaseAST)node).xmlSerializeRootClose(out); - } - } - } - -} diff --git a/app/src/antlr/TokenStreamCopyingHiddenTokenFilter.java b/app/src/antlr/TokenStreamCopyingHiddenTokenFilter.java deleted file mode 100644 index cd3306aed..000000000 --- a/app/src/antlr/TokenStreamCopyingHiddenTokenFilter.java +++ /dev/null @@ -1,221 +0,0 @@ -/* -*- mode: java; c-basic-offset: 2; indent-tabs-mode: nil -*- */ - -package antlr; -//package processing.app.preproc; - - -//import antlr.*; -import antlr.collections.impl.BitSet; - -/** - * This class provides TokenStreamHiddenTokenFilters with the concept of - * tokens which can be copied so that they are seen by both the hidden token - * stream as well as the parser itself. This is useful when one wants to use - * an existing parser (like the Java parser included with ANTLR) that throws - * away some tokens to create a parse tree which can be used to spit out - * a copy of the code with only minor modifications. - * - * This code is partially derived from the public domain ANLTR TokenStream - */ -public class TokenStreamCopyingHiddenTokenFilter - extends TokenStreamHiddenTokenFilter - implements TokenStream { - - protected BitSet copyMask; - CommonHiddenStreamToken hiddenCopy = null; - - public TokenStreamCopyingHiddenTokenFilter(TokenStream input) { - super(input); - copyMask = new BitSet(); - } - - /** - * Indicate that all tokens of type tokenType should be copied. The copy - * is put in the stream of hidden tokens, and the original is returned in the - * stream of normal tokens. - * - * @param tokenType integer representing the token type to copied - */ - public void copy(int tokenType) { - copyMask.add(tokenType); - } - - /** - * Create a clone of the important parts of the given token. Note that this - * does NOT copy the hiddenBefore and hiddenAfter fields. - * - * @param t token to partially clone - * @return newly created partial clone - */ - public CommonHiddenStreamToken partialCloneToken(CommonHiddenStreamToken t) { - - CommonHiddenStreamToken u = new CommonHiddenStreamToken(t.getType(), - t.getText()); - u.setColumn(t.getColumn()); - u.setLine(t.getLine()); - u.setFilename(t.getFilename()); - - return u; - } - - public void linkAndCopyToken(CommonHiddenStreamToken prev, - CommonHiddenStreamToken monitored) { - // create a copy of the token in the lookahead for use as hidden token - hiddenCopy = partialCloneToken(LA(1)); - - // attach copy to the previous token, whether hidden or monitored - prev.setHiddenAfter(hiddenCopy); - - // if previous token was hidden, set the hiddenBefore pointer of the - // copy to point back to it - if (prev != monitored) { - hiddenCopy.setHiddenBefore(prev); - } - - // we don't want the non-hidden copy to link back to the hidden - // copy on the next pass through this function, so we leave - // lastHiddenToken alone - - //System.err.println("hidden copy: " + hiddenCopy.toString()); - - return; - } - - private void consumeFirst() throws TokenStreamException { - consume(); // get first token of input stream - - // Handle situation where hidden or discarded tokens - // appear first in input stream - CommonHiddenStreamToken p=null; - - // while hidden, copied, or discarded scarf tokens - while ( hideMask.member(LA(1).getType()) || - discardMask.member(LA(1).getType()) || - copyMask.member(LA(1).getType()) ) { - - // if we've hit one of the tokens that needs to be copied, we copy it - // and then break out of the loop, because the parser needs to see it - // too - // - if (copyMask.member(LA(1).getType())) { - - // copy the token in the lookahead - hiddenCopy = partialCloneToken(LA(1)); - - // if there's an existing token before this, link that and the - // copy together - if (p != null) { - p.setHiddenAfter(hiddenCopy); - hiddenCopy.setHiddenBefore(p); // double-link - } - - lastHiddenToken = hiddenCopy; - if (firstHidden == null) { - firstHidden = hiddenCopy; - } - - // we don't want to consume this token, because it also needs to - // be passed through to the parser, so break out of the while look - // entirely - // - break; - } else if (hideMask.member(LA(1).getType())) { - if (p != null) { - p.setHiddenAfter(LA(1)); - LA(1).setHiddenBefore(p); // double-link - } - p = LA(1); - - lastHiddenToken = p; - if (firstHidden == null) { - firstHidden = p; // record hidden token if first - } - } - consume(); - } - } - - /** Return the next monitored token. - * Test the token following the monitored token. - * If following is another monitored token, save it - * for the next invocation of nextToken (like a single - * lookahead token) and return it then. - * If following is unmonitored, nondiscarded (hidden) - * channel token, add it to the monitored token. - * - * Note: EOF must be a monitored Token. - */ - public Token nextToken() throws TokenStreamException { - // handle an initial condition; don't want to get lookahead - // token of this splitter until first call to nextToken - if (LA(1) == null) { - consumeFirst(); - } - - //System.err.println(); - - // we always consume hidden tokens after monitored, thus, - // upon entry LA(1) is a monitored token. - CommonHiddenStreamToken monitored = LA(1); - - // point to hidden tokens found during last invocation - monitored.setHiddenBefore(lastHiddenToken); - lastHiddenToken = null; - - // Look for hidden tokens, hook them into list emanating - // from the monitored tokens. - consume(); - CommonHiddenStreamToken prev = monitored; - - // deal with as many not-purely-monitored tokens as possible - while ( hideMask.member(LA(1).getType()) || - discardMask.member(LA(1).getType()) || - copyMask.member(LA(1).getType()) ) { - - if (copyMask.member(LA(1).getType())) { - - // copy the token and link it backwards - if (hiddenCopy != null) { - linkAndCopyToken(hiddenCopy, monitored); - } else { - linkAndCopyToken(prev, monitored); - } - - // we now need to parse it as a monitored token, so we return, which - // avoids the consume() call at the end of this loop. the next call - // will parse it as a monitored token. - //System.err.println("returned: " + monitored.toString()); - return monitored; - - } else if (hideMask.member(LA(1).getType())) { - - // attach the hidden token to the monitored in a chain - // link forwards - prev.setHiddenAfter(LA(1)); - - // link backwards - if (prev != monitored) { //hidden cannot point to monitored tokens - LA(1).setHiddenBefore(prev); - } else if (hiddenCopy != null) { - hiddenCopy.setHiddenAfter(LA(1)); - LA(1).setHiddenBefore(hiddenCopy); - hiddenCopy = null; - } - - //System.err.println("hidden: " + prev.getHiddenAfter().toString() + "\" after: " + prev.toString()); - prev = lastHiddenToken = LA(1); - } - - consume(); - } - - // remember the last hidden token for next time around - if (hiddenCopy != null) { - lastHiddenToken = hiddenCopy; - hiddenCopy = null; - } - - //System.err.println("returned: " + monitored.toString()); - return monitored; - } -} diff --git a/app/src/antlr/java/java.g b/app/src/antlr/java/java.g deleted file mode 100644 index ee948ccd0..000000000 --- a/app/src/antlr/java/java.g +++ /dev/null @@ -1,1277 +0,0 @@ -header { -package antlr.java; -} - -/** Java 1.3 Recognizer - * 
    - * Run 'java Main [-showtree] directory-full-of-java-files'
- *
- * [The -showtree option pops up a Swing frame that shows
- *  the AST constructed from the parser.]
- *
- * Run 'java Main '
- *
- * Contributing authors:
- *		John Mitchell		johnm@non.net
- *		Terence Parr		parrt@magelang.com
- *		John Lilley			jlilley@empathy.com
- *		Scott Stanchfield	thetick@magelang.com
- *		Markus Mohnen       mohnen@informatik.rwth-aachen.de
- *      Peter Williams      pete.williams@sun.com
- *      Allan Jacobs        Allan.Jacobs@eng.sun.com
- *      Steve Messick       messick@redhills.com
- *      John Pybus			john@pybus.org
- *
- * Version 1.00 December 9, 1997 -- initial release
- * Version 1.01 December 10, 1997
- *		fixed bug in octal def (0..7 not 0..8)
- * Version 1.10 August 1998 (parrt)
- *		added tree construction
- *		fixed definition of WS,comments for mac,pc,unix newlines
- *		added unary plus
- * Version 1.11 (Nov 20, 1998)
- *		Added "shutup" option to turn off last ambig warning.
- *		Fixed inner class def to allow named class defs as statements
- *		synchronized requires compound not simple statement
- *		add [] after builtInType DOT class in primaryExpression
- *		"const" is reserved but not valid..removed from modifiers
- * Version 1.12 (Feb 2, 1999)
- *		Changed LITERAL_xxx to xxx in tree grammar.
- *		Updated java.g to use tokens {...} now for 2.6.0 (new feature).
- *
- * Version 1.13 (Apr 23, 1999)
- *		Didn't have (stat)? for else clause in tree parser.
- *		Didn't gen ASTs for interface extends.  Updated tree parser too.
- *		Updated to 2.6.0.
- * Version 1.14 (Jun 20, 1999)
- *		Allowed final/abstract on local classes.
- *		Removed local interfaces from methods
- *		Put instanceof precedence where it belongs...in relationalExpr
- *			It also had expr not type as arg; fixed it.
- *		Missing ! on SEMI in classBlock
- *		fixed: (expr) + "string" was parsed incorrectly (+ as unary plus).
- *		fixed: didn't like Object[].class in parser or tree parser
- * Version 1.15 (Jun 26, 1999)
- *		Screwed up rule with instanceof in it. :(  Fixed.
- *		Tree parser didn't like (expr).something; fixed.
- *		Allowed multiple inheritance in tree grammar. oops.
- * Version 1.16 (August 22, 1999)
- *		Extending an interface built a wacky tree: had extra EXTENDS.
- *		Tree grammar didn't allow multiple superinterfaces.
- *		Tree grammar didn't allow empty var initializer: {}
- * Version 1.17 (October 12, 1999)
- *		ESC lexer rule allowed 399 max not 377 max.
- *		java.tree.g didn't handle the expression of synchronized
- *		statements.
- * Version 1.18 (August 12, 2001)
- *      	Terence updated to Java 2 Version 1.3 by
- *		observing/combining work of Allan Jacobs and Steve
- *		Messick.  Handles 1.3 src.  Summary:
- *		o  primary didn't include boolean.class kind of thing
- *      	o  constructor calls parsed explicitly now:
- * 		   see explicitConstructorInvocation
- *		o  add strictfp modifier
- *      	o  missing objBlock after new expression in tree grammar
- *		o  merged local class definition alternatives, moved after declaration
- *		o  fixed problem with ClassName.super.field
- *      	o  reordered some alternatives to make things more efficient
- *		o  long and double constants were not differentiated from int/float
- *		o  whitespace rule was inefficient: matched only one char
- *		o  add an examples directory with some nasty 1.3 cases
- *		o  made Main.java use buffered IO and a Reader for Unicode support
- *		o  supports UNICODE?
- *		   Using Unicode charVocabulay makes code file big, but only
- *		   in the bitsets at the end. I need to make ANTLR generate
- *		   unicode bitsets more efficiently.
- * Version 1.19 (April 25, 2002)
- *		Terence added in nice fixes by John Pybus concerning floating
- *		constants and problems with super() calls.  John did a nice
- *		reorg of the primary/postfix expression stuff to read better
- *		and makes f.g.super() parse properly (it was METHOD_CALL not
- *		a SUPER_CTOR_CALL).  Also:
- *
- *		o  "finally" clause was a root...made it a child of "try"
- *		o  Added stuff for asserts too for Java 1.4, but *commented out*
- *		   as it is not backward compatible.
- *
- * Version 1.20 (October 27, 2002)
- *
- *      Terence ended up reorging John Pybus' stuff to
- *      remove some nondeterminisms and some syntactic predicates.
- *      Note that the grammar is stricter now; e.g., this(...) must
- *	be the first statement.
- *
- *      Trinary ?: operator wasn't working as array name:
- *          (isBig ? bigDigits : digits)[i];
- *
- *      Checked parser/tree parser on source for
- *          Resin-2.0.5, jive-2.1.1, jdk 1.3.1, Lucene, antlr 2.7.2a4,
- *	    and the 110k-line jGuru server source.
- *
- * This grammar is in the PUBLIC DOMAIN
- *
    - */ -class JavaRecognizer extends Parser; -options { - k = 2; // two token lookahead - exportVocab=Java; // Call its vocabulary "Java" - codeGenMakeSwitchThreshold = 2; // Some optimizations - codeGenBitsetTestThreshold = 3; - defaultErrorHandler = false; // Don't generate parser error handlers - buildAST = true; -} - -tokens { - BLOCK; MODIFIERS; OBJBLOCK; SLIST; CTOR_DEF; METHOD_DEF; VARIABLE_DEF; - INSTANCE_INIT; STATIC_INIT; TYPE; CLASS_DEF; INTERFACE_DEF; - PACKAGE_DEF; ARRAY_DECLARATOR; EXTENDS_CLAUSE; IMPLEMENTS_CLAUSE; - PARAMETERS; PARAMETER_DEF; LABELED_STAT; TYPECAST; INDEX_OP; - POST_INC; POST_DEC; METHOD_CALL; EXPR; ARRAY_INIT; - IMPORT; UNARY_MINUS; UNARY_PLUS; CASE_GROUP; ELIST; FOR_INIT; FOR_CONDITION; - FOR_ITERATOR; EMPTY_STAT; FINAL="final"; ABSTRACT="abstract"; - STRICTFP="strictfp"; SUPER_CTOR_CALL; CTOR_CALL; -} - -// Compilation Unit: In Java, this is a single file. This is the start -// rule for this parser -compilationUnit - : // A compilation unit starts with an optional package definition - ( packageDefinition - | /* nothing */ - ) - - // Next we have a series of zero or more import statements - ( importDefinition )* - - // Wrapping things up with any number of class or interface - // definitions - ( typeDefinition )* - - EOF! - ; - - -// Package statement: "package" followed by an identifier. -packageDefinition - options {defaultErrorHandler = true;} // let ANTLR handle errors - : p:"package"^ {#p.setType(PACKAGE_DEF);} identifier SEMI! - ; - - -// Import statement: import followed by a package or class name -importDefinition - options {defaultErrorHandler = true;} - : i:"import"^ {#i.setType(IMPORT);} identifierStar SEMI! - ; - -// A type definition in a file is either a class or interface definition. -typeDefinition - options {defaultErrorHandler = true;} - : m:modifiers! - ( classDefinition[#m] - | interfaceDefinition[#m] - ) - | SEMI! - ; - -/** A declaration is the creation of a reference or primitive-type variable - * Create a separate Type/Var tree for each var in the var list. - */ -declaration! - : m:modifiers t:typeSpec[false] v:variableDefinitions[#m,#t] - {#declaration = #v;} - ; - -// A type specification is a type name with possible brackets afterwards -// (which would make it an array type). -typeSpec[boolean addImagNode] - : classTypeSpec[addImagNode] - | builtInTypeSpec[addImagNode] - ; - -// A class type specification is a class type with possible brackets afterwards -// (which would make it an array type). -classTypeSpec[boolean addImagNode] - : identifier (lb:LBRACK^ {#lb.setType(ARRAY_DECLARATOR);} RBRACK!)* - { - if ( addImagNode ) { - #classTypeSpec = #(#[TYPE,"TYPE"], #classTypeSpec); - } - } - ; - -// A builtin type specification is a builtin type with possible brackets -// afterwards (which would make it an array type). -builtInTypeSpec[boolean addImagNode] - : builtInType (lb:LBRACK^ {#lb.setType(ARRAY_DECLARATOR);} RBRACK!)* - { - if ( addImagNode ) { - #builtInTypeSpec = #(#[TYPE,"TYPE"], #builtInTypeSpec); - } - } - ; - -// A type name. which is either a (possibly qualified) class name or -// a primitive (builtin) type -type - : identifier - | builtInType - ; - -// The primitive types. -builtInType - : "void" - | "boolean" - | "byte" - | "char" - | "short" - | "int" - | "float" - | "long" - | "double" - ; - -// A (possibly-qualified) java identifier. We start with the first IDENT -// and expand its name by adding dots and following IDENTS -identifier - : IDENT ( DOT^ IDENT )* - ; - -identifierStar - : IDENT - ( DOT^ IDENT )* - ( DOT^ STAR )? - ; - -// A list of zero or more modifiers. We could have used (modifier)* in -// place of a call to modifiers, but I thought it was a good idea to keep -// this rule separate so they can easily be collected in a Vector if -// someone so desires -modifiers - : ( modifier )* - {#modifiers = #([MODIFIERS, "MODIFIERS"], #modifiers);} - ; - -// modifiers for Java classes, interfaces, class/instance vars and methods -modifier - : "private" - | "public" - | "protected" - | "static" - | "transient" - | "final" - | "abstract" - | "native" - | "threadsafe" - | "synchronized" -// | "const" // reserved word, but not valid - | "volatile" - | "strictfp" - ; - -// Definition of a Java class -classDefinition![AST modifiers] - : "class" IDENT - // it _might_ have a superclass... - sc:superClassClause - // it might implement some interfaces... - ic:implementsClause - // now parse the body of the class - cb:classBlock - {#classDefinition = #(#[CLASS_DEF,"CLASS_DEF"], - modifiers,IDENT,sc,ic,cb);} - ; - -superClassClause! - : ( "extends" id:identifier )? - {#superClassClause = #(#[EXTENDS_CLAUSE,"EXTENDS_CLAUSE"],id);} - ; - -// Definition of a Java Interface -interfaceDefinition![AST modifiers] - : "interface" IDENT - // it might extend some other interfaces - ie:interfaceExtends - // now parse the body of the interface (looks like a class...) - cb:classBlock - {#interfaceDefinition = #(#[INTERFACE_DEF,"INTERFACE_DEF"], - modifiers,IDENT,ie,cb);} - ; - - -// This is the body of a class. You can have fields and extra semicolons, -// That's about it (until you see what a field is...) -classBlock - : LCURLY! - ( field | SEMI! )* - RCURLY! - {#classBlock = #([OBJBLOCK, "OBJBLOCK"], #classBlock);} - ; - -// An interface can extend several other interfaces... -interfaceExtends - : ( - e:"extends"! - identifier ( COMMA! identifier )* - )? - {#interfaceExtends = #(#[EXTENDS_CLAUSE,"EXTENDS_CLAUSE"], - #interfaceExtends);} - ; - -// A class can implement several interfaces... -implementsClause - : ( - i:"implements"! identifier ( COMMA! identifier )* - )? - {#implementsClause = #(#[IMPLEMENTS_CLAUSE,"IMPLEMENTS_CLAUSE"], - #implementsClause);} - ; - -// Now the various things that can be defined inside a class or interface... -// Note that not all of these are really valid in an interface (constructors, -// for example), and if this grammar were used for a compiler there would -// need to be some semantic checks to make sure we're doing the right thing... -field! - : // method, constructor, or variable declaration - mods:modifiers - ( h:ctorHead s:constructorBody // constructor - {#field = #(#[CTOR_DEF,"CTOR_DEF"], mods, h, s);} - - | cd:classDefinition[#mods] // inner class - {#field = #cd;} - - | id:interfaceDefinition[#mods] // inner interface - {#field = #id;} - - | t:typeSpec[false] // method or variable declaration(s) - ( IDENT // the name of the method - - // parse the formal parameter declarations. - LPAREN! param:parameterDeclarationList RPAREN! - - rt:declaratorBrackets[#t] - - // get the list of exceptions that this method is - // declared to throw - (tc:throwsClause)? - - ( s2:compoundStatement | SEMI ) - {#field = #(#[METHOD_DEF,"METHOD_DEF"], - mods, - #(#[TYPE,"TYPE"],rt), - IDENT, - param, - tc, - s2);} - | v:variableDefinitions[#mods,#t] SEMI -// {#field = #(#[VARIABLE_DEF,"VARIABLE_DEF"], v);} - {#field = #v;} - ) - ) - - // "static { ... }" class initializer - | "static" s3:compoundStatement - {#field = #(#[STATIC_INIT,"STATIC_INIT"], s3);} - - // "{ ... }" instance initializer - | s4:compoundStatement - {#field = #(#[INSTANCE_INIT,"INSTANCE_INIT"], s4);} - ; - -constructorBody - : lc:LCURLY^ {#lc.setType(SLIST);} - ( options { greedy=true; } : explicitConstructorInvocation)? - (statement)* - RCURLY! - ; - -/** Catch obvious constructor calls, but not the expr.super(...) calls */ -explicitConstructorInvocation - : "this"! lp1:LPAREN^ argList RPAREN! SEMI! - {#lp1.setType(CTOR_CALL);} - | "super"! lp2:LPAREN^ argList RPAREN! SEMI! - {#lp2.setType(SUPER_CTOR_CALL);} - ; - -variableDefinitions[AST mods, AST t] - : variableDeclarator[getASTFactory().dupTree(mods), - getASTFactory().dupTree(t)] - ( COMMA! - variableDeclarator[getASTFactory().dupTree(mods), - getASTFactory().dupTree(t)] - )* - ; - -/** Declaration of a variable. This can be a class/instance variable, - * or a local variable in a method - * It can also include possible initialization. - */ -variableDeclarator![AST mods, AST t] - : id:IDENT d:declaratorBrackets[t] v:varInitializer - {#variableDeclarator = #(#[VARIABLE_DEF,"VARIABLE_DEF"], mods, #(#[TYPE,"TYPE"],d), id, v);} - ; - -declaratorBrackets[AST typ] - : {#declaratorBrackets=typ;} - (lb:LBRACK^ {#lb.setType(ARRAY_DECLARATOR);} RBRACK!)* - ; - -varInitializer - : ( ASSIGN^ initializer )? - ; - -// This is an initializer used to set up an array. -arrayInitializer - : lc:LCURLY^ {#lc.setType(ARRAY_INIT);} - ( initializer - ( - // CONFLICT: does a COMMA after an initializer start a new - // initializer or start the option ',' at end? - // ANTLR generates proper code by matching - // the comma as soon as possible. - options { - warnWhenFollowAmbig = false; - } - : - COMMA! initializer - )* - (COMMA!)? - )? - RCURLY! - ; - - -// The two "things" that can initialize an array element are an expression -// and another (nested) array initializer. -initializer - : expression - | arrayInitializer - ; - -// This is the header of a method. It includes the name and parameters -// for the method. -// This also watches for a list of exception classes in a "throws" clause. -ctorHead - : IDENT // the name of the method - - // parse the formal parameter declarations. - LPAREN! parameterDeclarationList RPAREN! - - // get the list of exceptions that this method is declared to throw - (throwsClause)? - ; - -// This is a list of exception classes that the method is declared to throw -throwsClause - : "throws"^ identifier ( COMMA! identifier )* - ; - - -// A list of formal parameters -parameterDeclarationList - : ( parameterDeclaration ( COMMA! parameterDeclaration )* )? - {#parameterDeclarationList = #(#[PARAMETERS,"PARAMETERS"], - #parameterDeclarationList);} - ; - -// A formal parameter. -parameterDeclaration! - : pm:parameterModifier t:typeSpec[false] id:IDENT - pd:declaratorBrackets[#t] - {#parameterDeclaration = #(#[PARAMETER_DEF,"PARAMETER_DEF"], - pm, #([TYPE,"TYPE"],pd), id);} - ; - -parameterModifier - : (f:"final")? - {#parameterModifier = #(#[MODIFIERS,"MODIFIERS"], f);} - ; - -// Compound statement. This is used in many contexts: -// Inside a class definition prefixed with "static": -// it is a class initializer -// Inside a class definition without "static": -// it is an instance initializer -// As the body of a method -// As a completely indepdent braced block of code inside a method -// it starts a new scope for variable definitions - -compoundStatement - : lc:LCURLY^ {#lc.setType(SLIST);} - // include the (possibly-empty) list of statements - (statement)* - RCURLY! - ; - - -statement - // A list of statements in curly braces -- start a new scope! - : compoundStatement - - // declarations are ambiguous with "ID DOT" relative to expression - // statements. Must backtrack to be sure. Could use a semantic - // predicate to test symbol table to see what the type was coming - // up, but that's pretty hard without a symbol table ;) - | (declaration)=> declaration SEMI! - - // An expression statement. This could be a method call, - // assignment statement, or any other expression evaluated for - // side-effects. - | expression SEMI! - - // class definition - | m:modifiers! classDefinition[#m] - - // Attach a label to the front of a statement - | IDENT c:COLON^ {#c.setType(LABELED_STAT);} statement - - // If-else statement - | "if"^ LPAREN! expression RPAREN! statement - ( - // CONFLICT: the old "dangling-else" problem... - // ANTLR generates proper code matching - // as soon as possible. Hush warning. - options { - warnWhenFollowAmbig = false; - } - : - "else"! statement - )? - - // For statement - | "for"^ - LPAREN! - forInit SEMI! // initializer - forCond SEMI! // condition test - forIter // updater - RPAREN! - statement // statement to loop over - - // While statement - | "while"^ LPAREN! expression RPAREN! statement - - // do-while statement - | "do"^ statement "while"! LPAREN! expression RPAREN! SEMI! - - // get out of a loop (or switch) - | "break"^ (IDENT)? SEMI! - - // do next iteration of a loop - | "continue"^ (IDENT)? SEMI! - - // Return an expression - | "return"^ (expression)? SEMI! - - // switch/case statement - | "switch"^ LPAREN! expression RPAREN! LCURLY! - ( casesGroup )* - RCURLY! - - // exception try-catch block - | tryBlock - - // throw an exception - | "throw"^ expression SEMI! - - // synchronize a statement - | "synchronized"^ LPAREN! expression RPAREN! compoundStatement - - // asserts (uncomment if you want 1.4 compatibility) - | "assert"^ expression ( COLON! expression )? SEMI! - - // empty statement - | s:SEMI {#s.setType(EMPTY_STAT);} - ; - -casesGroup - : ( // CONFLICT: to which case group do the statements bind? - // ANTLR generates proper code: it groups the - // many "case"/"default" labels together then - // follows them with the statements - options { - greedy = true; - } - : - aCase - )+ - caseSList - {#casesGroup = #([CASE_GROUP, "CASE_GROUP"], #casesGroup);} - ; - -aCase - : ("case"^ expression | "default") COLON! - ; - -caseSList - : (statement)* - {#caseSList = #(#[SLIST,"SLIST"],#caseSList);} - ; - -// The initializer for a for loop -forInit - // if it looks like a declaration, it is - : ( (declaration)=> declaration - // otherwise it could be an expression list... - | expressionList - )? - {#forInit = #(#[FOR_INIT,"FOR_INIT"],#forInit);} - ; - -forCond - : (expression)? - {#forCond = #(#[FOR_CONDITION,"FOR_CONDITION"],#forCond);} - ; - -forIter - : (expressionList)? - {#forIter = #(#[FOR_ITERATOR,"FOR_ITERATOR"],#forIter);} - ; - -// an exception handler try/catch block -tryBlock - : "try"^ compoundStatement - (handler)* - ( finallyClause )? - ; - -finallyClause - : "finally"^ compoundStatement - ; - -// an exception handler -handler - : "catch"^ LPAREN! parameterDeclaration RPAREN! compoundStatement - ; - - -// expressions -// Note that most of these expressions follow the pattern -// thisLevelExpression : -// nextHigherPrecedenceExpression -// (OPERATOR nextHigherPrecedenceExpression)* -// which is a standard recursive definition for a parsing an expression. -// The operators in java have the following precedences: -// lowest (13) = *= /= %= += -= <<= >>= >>>= &= ^= |= -// (12) ?: -// (11) || -// (10) && -// ( 9) | -// ( 8) ^ -// ( 7) & -// ( 6) == != -// ( 5) < <= > >= -// ( 4) << >> -// ( 3) +(binary) -(binary) -// ( 2) * / % -// ( 1) ++ -- +(unary) -(unary) ~ ! (type) -// [] () (method call) . (dot -- identifier qualification) -// new () (explicit parenthesis) -// -// the last two are not usually on a precedence chart; I put them in -// to point out that new has a higher precedence than '.', so you -// can validy use -// new Frame().show() -// -// Note that the above precedence levels map to the rules below... -// Once you have a precedence chart, writing the appropriate rules as below -// is usually very straightfoward - - - -// the mother of all expressions -expression - : assignmentExpression - {#expression = #(#[EXPR,"EXPR"],#expression);} - ; - - -// This is a list of expressions. -expressionList - : expression (COMMA! expression)* - {#expressionList = #(#[ELIST,"ELIST"], expressionList);} - ; - - -// assignment expression (level 13) -assignmentExpression - : conditionalExpression - ( ( ASSIGN^ - | PLUS_ASSIGN^ - | MINUS_ASSIGN^ - | STAR_ASSIGN^ - | DIV_ASSIGN^ - | MOD_ASSIGN^ - | SR_ASSIGN^ - | BSR_ASSIGN^ - | SL_ASSIGN^ - | BAND_ASSIGN^ - | BXOR_ASSIGN^ - | BOR_ASSIGN^ - ) - assignmentExpression - )? - ; - - -// conditional test (level 12) -conditionalExpression - : logicalOrExpression - ( QUESTION^ assignmentExpression COLON! conditionalExpression )? - ; - - -// logical or (||) (level 11) -logicalOrExpression - : logicalAndExpression (LOR^ logicalAndExpression)* - ; - - -// logical and (&&) (level 10) -logicalAndExpression - : inclusiveOrExpression (LAND^ inclusiveOrExpression)* - ; - - -// bitwise or non-short-circuiting or (|) (level 9) -inclusiveOrExpression - : exclusiveOrExpression (BOR^ exclusiveOrExpression)* - ; - - -// exclusive or (^) (level 8) -exclusiveOrExpression - : andExpression (BXOR^ andExpression)* - ; - - -// bitwise or non-short-circuiting and (&) (level 7) -andExpression - : equalityExpression (BAND^ equalityExpression)* - ; - - -// equality/inequality (==/!=) (level 6) -equalityExpression - : relationalExpression ((NOT_EQUAL^ | EQUAL^) relationalExpression)* - ; - - -// boolean relational expressions (level 5) -relationalExpression - : shiftExpression - ( ( ( LT^ - | GT^ - | LE^ - | GE^ - ) - shiftExpression - )* - | "instanceof"^ typeSpec[true] - ) - ; - - -// bit shift expressions (level 4) -shiftExpression - : additiveExpression ((SL^ | SR^ | BSR^) additiveExpression)* - ; - - -// binary addition/subtraction (level 3) -additiveExpression - : multiplicativeExpression ((PLUS^ | MINUS^) multiplicativeExpression)* - ; - - -// multiplication/division/modulo (level 2) -multiplicativeExpression - : unaryExpression ((STAR^ | DIV^ | MOD^ ) unaryExpression)* - ; - -unaryExpression - : INC^ unaryExpression - | DEC^ unaryExpression - | MINUS^ {#MINUS.setType(UNARY_MINUS);} unaryExpression - | PLUS^ {#PLUS.setType(UNARY_PLUS);} unaryExpression - | unaryExpressionNotPlusMinus - ; - -unaryExpressionNotPlusMinus - : BNOT^ unaryExpression - | LNOT^ unaryExpression - - | ( // subrule allows option to shut off warnings - options { - // "(int" ambig with postfixExpr due to lack of sequence - // info in linear approximate LL(k). It's ok. Shut up. - generateAmbigWarnings=false; - } - : // If typecast is built in type, must be numeric operand - // Also, no reason to backtrack if type keyword like int, float... - lpb:LPAREN^ {#lpb.setType(TYPECAST);} builtInTypeSpec[true] RPAREN! - unaryExpression - - // Have to backtrack to see if operator follows. If no operator - // follows, it's a typecast. No semantic checking needed to parse. - // if it _looks_ like a cast, it _is_ a cast; else it's a "(expr)" - | (LPAREN classTypeSpec[true] RPAREN unaryExpressionNotPlusMinus)=> - lp:LPAREN^ {#lp.setType(TYPECAST);} classTypeSpec[true] RPAREN! - unaryExpressionNotPlusMinus - - | postfixExpression - ) - ; - -// qualified names, array expressions, method invocation, post inc/dec -postfixExpression - : - /* - "this"! lp1:LPAREN^ argList RPAREN! - {#lp1.setType(CTOR_CALL);} - - | "super"! lp2:LPAREN^ argList RPAREN! - {#lp2.setType(SUPER_CTOR_CALL);} - | - */ - primaryExpression - - ( - /* - options { - // the use of postfixExpression in SUPER_CTOR_CALL adds DOT - // to the lookahead set, and gives loads of false non-det - // warnings. - // shut them off. - generateAmbigWarnings=false; - } - : */ - DOT^ IDENT - ( lp:LPAREN^ {#lp.setType(METHOD_CALL);} - argList - RPAREN! - )? - | DOT^ "this" - - | DOT^ "super" - ( // (new Outer()).super() (create enclosing instance) - lp3:LPAREN^ argList RPAREN! - {#lp3.setType(SUPER_CTOR_CALL);} - | DOT^ IDENT - ( lps:LPAREN^ {#lps.setType(METHOD_CALL);} - argList - RPAREN! - )? - ) - | DOT^ newExpression - | lb:LBRACK^ {#lb.setType(INDEX_OP);} expression RBRACK! - )* - - ( // possibly add on a post-increment or post-decrement. - // allows INC/DEC on too much, but semantics can check - in:INC^ {#in.setType(POST_INC);} - | de:DEC^ {#de.setType(POST_DEC);} - )? - ; - -// the basic element of an expression -primaryExpression - : identPrimary ( options {greedy=true;} : DOT^ "class" )? - | constant - | "true" - | "false" - | "null" - | newExpression - | "this" - | "super" - | LPAREN! assignmentExpression RPAREN! - // look for int.class and int[].class - | builtInType - ( lbt:LBRACK^ {#lbt.setType(ARRAY_DECLARATOR);} RBRACK! )* - DOT^ "class" - ; - -/** Match a, a.b.c refs, a.b.c(...) refs, a.b.c[], a.b.c[].class, - * and a.b.c.class refs. Also this(...) and super(...). Match - * this or super. - */ -identPrimary - : IDENT - ( - options { - // .ident could match here or in postfixExpression. - // We do want to match here. Turn off warning. - greedy=true; - } - : DOT^ IDENT - )* - ( - options { - // ARRAY_DECLARATOR here conflicts with INDEX_OP in - // postfixExpression on LBRACK RBRACK. - // We want to match [] here, so greedy. This overcomes - // limitation of linear approximate lookahead. - greedy=true; - } - : ( lp:LPAREN^ {#lp.setType(METHOD_CALL);} argList RPAREN! ) - | ( options {greedy=true;} : - lbc:LBRACK^ {#lbc.setType(ARRAY_DECLARATOR);} RBRACK! - )+ - )? - ; - -/** object instantiation. - * Trees are built as illustrated by the following input/tree pairs: - * - * new T() - * - * new - * | - * T -- ELIST - * | - * arg1 -- arg2 -- .. -- argn - * - * new int[] - * - * new - * | - * int -- ARRAY_DECLARATOR - * - * new int[] {1,2} - * - * new - * | - * int -- ARRAY_DECLARATOR -- ARRAY_INIT - * | - * EXPR -- EXPR - * | | - * 1 2 - * - * new int[3] - * new - * | - * int -- ARRAY_DECLARATOR - * | - * EXPR - * | - * 3 - * - * new int[1][2] - * - * new - * | - * int -- ARRAY_DECLARATOR - * | - * ARRAY_DECLARATOR -- EXPR - * | | - * EXPR 1 - * | - * 2 - * - */ -newExpression - : "new"^ type - ( LPAREN! argList RPAREN! (classBlock)? - - //java 1.1 - // Note: This will allow bad constructs like - // new int[4][][3] {exp,exp}. - // There needs to be a semantic check here... - // to make sure: - // a) [ expr ] and [ ] are not mixed - // b) [ expr ] and an init are not used together - - | newArrayDeclarator (arrayInitializer)? - ) - ; - -argList - : ( expressionList - | /*nothing*/ - {#argList = #[ELIST,"ELIST"];} - ) - ; - -newArrayDeclarator - : ( - // CONFLICT: - // newExpression is a primaryExpression which can be - // followed by an array index reference. This is ok, - // as the generated code will stay in this loop as - // long as it sees an LBRACK (proper behavior) - options { - warnWhenFollowAmbig = false; - } - : - lb:LBRACK^ {#lb.setType(ARRAY_DECLARATOR);} - (expression)? - RBRACK! - )+ - ; - -constant - : NUM_INT - | CHAR_LITERAL - | STRING_LITERAL - | NUM_FLOAT - | NUM_LONG - | NUM_DOUBLE - ; - - -//---------------------------------------------------------------------------- -// The Java scanner -//---------------------------------------------------------------------------- -class JavaLexer extends Lexer; - -options { - exportVocab=Java; // call the vocabulary "Java" - testLiterals=false; // don't automatically test for literals - k=4; // four characters of lookahead - charVocabulary='\u0003'..'\uFFFF'; - // without inlining some bitset tests, couldn't do unicode; - // I need to make ANTLR generate smaller bitsets; see - // bottom of JavaLexer.java - codeGenBitsetTestThreshold=20; -} - - - -// OPERATORS -QUESTION : '?' ; -LPAREN : '(' ; -RPAREN : ')' ; -LBRACK : '[' ; -RBRACK : ']' ; -LCURLY : '{' ; -RCURLY : '}' ; -COLON : ':' ; -COMMA : ',' ; -//DOT : '.' ; -ASSIGN : '=' ; -EQUAL : "==" ; -LNOT : '!' ; -BNOT : '~' ; -NOT_EQUAL : "!=" ; -DIV : '/' ; -DIV_ASSIGN : "/=" ; -PLUS : '+' ; -PLUS_ASSIGN : "+=" ; -INC : "++" ; -MINUS : '-' ; -MINUS_ASSIGN : "-=" ; -DEC : "--" ; -STAR : '*' ; -STAR_ASSIGN : "*=" ; -MOD : '%' ; -MOD_ASSIGN : "%=" ; -SR : ">>" ; -SR_ASSIGN : ">>=" ; -BSR : ">>>" ; -BSR_ASSIGN : ">>>=" ; -GE : ">=" ; -GT : ">" ; -SL : "<<" ; -SL_ASSIGN : "<<=" ; -LE : "<=" ; -LT : '<' ; -BXOR : '^' ; -BXOR_ASSIGN : "^=" ; -BOR : '|' ; -BOR_ASSIGN : "|=" ; -LOR : "||" ; -BAND : '&' ; -BAND_ASSIGN : "&=" ; -LAND : "&&" ; -SEMI : ';' ; - - -// Whitespace -- ignored -WS : ( ' ' - | '\t' - | '\f' - // handle newlines - | ( options {generateAmbigWarnings=false;} - : "\r\n" // Evil DOS - | '\r' // Macintosh - | '\n' // Unix (the right way) - ) - { newline(); } - )+ - { _ttype = Token.SKIP; } - ; - -// Single-line comments -SL_COMMENT - : "//" - (~('\n'|'\r'))* ('\n'|'\r'('\n')?) - {$setType(Token.SKIP); newline();} - ; - -// multiple-line comments -ML_COMMENT - : "/*" - ( /* '\r' '\n' can be matched in one alternative or by matching - '\r' in one iteration and '\n' in another. I am trying to - handle any flavor of newline that comes in, but the language - that allows both "\r\n" and "\r" and "\n" to all be valid - newline is ambiguous. Consequently, the resulting grammar - must be ambiguous. I'm shutting this warning off. - */ - options { - generateAmbigWarnings=false; - } - : - { LA(2)!='/' }? '*' - | '\r' '\n' {newline();} - | '\r' {newline();} - | '\n' {newline();} - | ~('*'|'\n'|'\r') - )* - "*/" - {$setType(Token.SKIP);} - ; - - -// character literals -CHAR_LITERAL - : '\'' ( ESC | ~'\'' ) '\'' - ; - -// string literals -STRING_LITERAL - : '"' (ESC|~('"'|'\\'))* '"' - ; - - -// escape sequence -- note that this is protected; it can only be called -// from another lexer rule -- it will not ever directly return a token to -// the parser -// There are various ambiguities hushed in this rule. The optional -// '0'...'9' digit matches should be matched here rather than letting -// them go back to STRING_LITERAL to be matched. ANTLR does the -// right thing by matching immediately; hence, it's ok to shut off -// the FOLLOW ambig warnings. -protected -ESC - : '\\' - ( 'n' - | 'r' - | 't' - | 'b' - | 'f' - | '"' - | '\'' - | '\\' - | ('u')+ HEX_DIGIT HEX_DIGIT HEX_DIGIT HEX_DIGIT - | '0'..'3' - ( - options { - warnWhenFollowAmbig = false; - } - : '0'..'7' - ( - options { - warnWhenFollowAmbig = false; - } - : '0'..'7' - )? - )? - | '4'..'7' - ( - options { - warnWhenFollowAmbig = false; - } - : '0'..'7' - )? - ) - ; - - -// hexadecimal digit (again, note it's protected!) -protected -HEX_DIGIT - : ('0'..'9'|'A'..'F'|'a'..'f') - ; - - -// a dummy rule to force vocabulary to be all characters (except special -// ones that ANTLR uses internally (0 to 2) -protected -VOCAB - : '\3'..'\377' - ; - - -// an identifier. Note that testLiterals is set to true! This means -// that after we match the rule, we look in the literals table to see -// if it's a literal or really an identifer -IDENT - options {testLiterals=true;} - : ('a'..'z'|'A'..'Z'|'_'|'$') ('a'..'z'|'A'..'Z'|'_'|'0'..'9'|'$')* - ; - - -// a numeric literal -NUM_INT - {boolean isDecimal=false; Token t=null;} - : '.' {_ttype = DOT;} - ( ('0'..'9')+ (EXPONENT)? (f1:FLOAT_SUFFIX {t=f1;})? - { - if (t != null && t.getText().toUpperCase().indexOf('F')>=0) { - _ttype = NUM_FLOAT; - } - else { - _ttype = NUM_DOUBLE; // assume double - } - } - )? - - | ( '0' {isDecimal = true;} // special case for just '0' - ( ('x'|'X') - ( // hex - // the 'e'|'E' and float suffix stuff look - // like hex digits, hence the (...)+ doesn't - // know when to stop: ambig. ANTLR resolves - // it correctly by matching immediately. It - // is therefor ok to hush warning. - options { - warnWhenFollowAmbig=false; - } - : HEX_DIGIT - )+ - | ('0'..'7')+ // octal - )? - | ('1'..'9') ('0'..'9')* {isDecimal=true;} // non-zero decimal - ) - ( ('l'|'L') { _ttype = NUM_LONG; } - - // only check to see if it's a float if looks like decimal so far - | {isDecimal}? - ( '.' ('0'..'9')* (EXPONENT)? (f2:FLOAT_SUFFIX {t=f2;})? - | EXPONENT (f3:FLOAT_SUFFIX {t=f3;})? - | f4:FLOAT_SUFFIX {t=f4;} - ) - { - if (t != null && t.getText().toUpperCase() .indexOf('F') >= 0) { - _ttype = NUM_FLOAT; - } - else { - _ttype = NUM_DOUBLE; // assume double - } - } - )? - ; - - -// a couple protected methods to assist in matching floating point numbers -protected -EXPONENT - : ('e'|'E') ('+'|'-')? ('0'..'9')+ - ; - - -protected -FLOAT_SUFFIX - : 'f'|'F'|'d'|'D' - ; - diff --git a/app/src/antlr/java/java.g.java15 b/app/src/antlr/java/java.g.java15 deleted file mode 100644 index b119cd35f..000000000 --- a/app/src/antlr/java/java.g.java15 +++ /dev/null @@ -1,2002 +0,0 @@ -header -{ -package de.hunsicker.jalopy.language.antlr; - -import de.hunsicker.jalopy.language.antlr.JavaNode; -import de.hunsicker.jalopy.language.JavaNodeHelper; -} - -/** Java 1.5 Recognizer - * - * Run 'java Main [-showtree] directory-full-of-java-files' - * - * [The -showtree option pops up a Swing frame that shows - * the JavaNode constructed from the parser.] - * - * Run 'java Main ' - * - * Contributing authors: - * John Mitchell johnm@non.net - * Terence Parr parrt@magelang.com - * John Lilley jlilley@empathy.com - * Scott Stanchfield thetick@magelang.com - * Markus Mohnen mohnen@informatik.rwth-aachen.de - * Peter Williams pete.williams@sun.com - * Allan Jacobs Allan.Jacobs@eng.sun.com - * Steve Messick messick@redhills.com - * John Pybus john@pybus.org - * - * Version 1.00 December 9, 1997 -- initial release - * Version 1.01 December 10, 1997 - * fixed bug in octal def (0..7 not 0..8) - * Version 1.10 August 1998 (parrt) - * added tree construction - * fixed definition of WS,comments for mac,pc,unix newlines - * added unary plus - * Version 1.11 (Nov 20, 1998) - * Added "shutup" option to turn off last ambig warning. - * Fixed inner class def to allow named class defs as statements - * synchronized requires compound not simple statement - * add [] after builtInType DOT class in primaryExpression - * "const" is reserved but not valid..removed from modifiers - * Version 1.12 (Feb 2, 1999) - * Changed LITERAL_xxx to xxx in tree grammar. - * Updated java.g to use tokens {...} now for 2.6.0 (new feature). - * - * Version 1.13 (Apr 23, 1999) - * Didn't have (stat)? for else clause in tree parser. - * Didn't gen ASTs for interface extends. Updated tree parser too. - * Updated to 2.6.0. - * Version 1.14 (Jun 20, 1999) - * Allowed final/abstract on local classes. - * Removed local interfaces from methods - * Put instanceof precedence where it belongs...in relationalExpr - * It also had expr not type as arg; fixed it. - * Missing ! on SEMI in classBlock - * fixed: (expr) + "string" was parsed incorrectly (+ as unary plus). - * fixed: didn't like Object[].class in parser or tree parser - * Version 1.15 (Jun 26, 1999) - * Screwed up rule with instanceof in it. :( Fixed. - * Tree parser didn't like (expr).something; fixed. - * Allowed multiple inheritance in tree grammar. oops. - * Version 1.16 (August 22, 1999) - * Extending an interface built a wacky tree: had extra EXTENDS. - * Tree grammar didn't allow multiple superinterfaces. - * Tree grammar didn't allow empty var initializer: {} - * Version 1.17 (October 12, 1999) - * ESC lexer rule allowed 399 max not 377 max. - * java.tree.g didn't handle the expression of synchronized - * statements. - * Version 1.18 (August 12, 2001) - * Terence updated to Java 2 Version 1.3 by - * observing/combining work of Allan Jacobs and Steve - * Messick. Handles 1.3 src. Summary: - * o primary didn't include boolean.class kind of thing - * o constructor calls parsed explicitly now: - * see explicitConstructorInvocation - * o add strictfp modifier - * o missing objBlock after new expression in tree grammar - * o merged local class definition alternatives, moved after declaration - * o fixed problem with ClassName.super.field - * o reordered some alternatives to make things more efficient - * o long and double constants were not differentiated from int/float - * o whitespace rule was inefficient: matched only one char - * o add an examples directory with some nasty 1.3 cases - * o made Main.java use buffered IO and a Reader for Unicode support - * o supports UNICODE? - * Using Unicode charVocabulay makes code file big, but only - * in the bitsets at the end. I need to make ANTLR generate - * unicode bitsets more efficiently. - * Version 1.19 (April 25, 2002) - * Terence added in nice fixes by John Pybus concerning floating - * constants and problems with super() calls. John did a nice - * reorg of the primary/postfix expression stuff to read better - * and makes f.g.super() parse properly (it was METHOD_CALL not - * a SUPER_CTOR_CALL). Also: - * - * o "finally" clause was a root...made it a child of "try" - * o Added stuff for asserts too for Java 1.4, but *commented out* - * as it is not backward compatible. - * - * Version 1.20 (October 27, 2002) - * - * Terence ended up reorging John Pybus' stuff to - * remove some nondeterminisms and some syntactic predicates. - * Note that the grammar is stricter now; e.g., this(...) must - * be the first statement. - * - * Trinary ?: operator wasn't working as array name: - * (isBig ? bigDigits : digits)[i]; - * - * Checked parser/tree parser on source for - * Resin-2.0.5, jive-2.1.1, jdk 1.3.1, Lucene, antlr 2.7.2a4, - * and the 110k-line jGuru server source. - * - * Version 1.21 (October 17, 2003) - * Fixed lots of problems including: - * Ray Waldin: add typeDefinition to interfaceBlock in java.tree.g - * He found a problem/fix with floating point that start with 0 - * Ray also fixed problem that (int.class) was not recognized. - * Thorsten van Ellen noticed that \n are allowed incorrectly in strings. - * TJP fixed CHAR_LITERAL analogously. - * - * Version 1.21.2 (March, 2003) - * Changes by Matt Quail to support generics (as per JDK1.5/JSR14) - * Notes: - * o We only allow the "extends" keyword and not the "implements" - * keyword, since thats what JSR14 seems to imply. - * o Thanks to Monty Zukowski for his help on the antlr-interest - * mail list. - * o Thanks to Alan Eliasen for testing the grammar over his - * Fink source base - * - * Version 1.22 (July, 2004) - * Changes by Michael Studman to support Java 1.5 language extensions - * Notes: - * o Added support for annotations types - * o Finished off Matt Quail's generics enhancements to support bound type arguments - * o Added support for new for statement syntax - * o Added support for static import syntax - * o Added support for enum types - * o Tested against JDK 1.5 source base and source base of jdigraph project - * o Thanks to Matt Quail for doing the hard part by doing most of the generics work - * - * Version 1.22.1 (July 28, 2004) - * Bug/omission fixes for Java 1.5 language support - * o Fixed tree structure bug with classOrInterface - thanks to Pieter Vangorpto for - * spotting this - * o Fixed bug where incorrect handling of SR and BSR tokens would cause type - * parameters to be recognised as type arguments. - * o Enabled type parameters on constructors, annotations on enum constants - * and package definitions - * o Fixed problems when parsing if ((char.class.equals(c))) {} - solution by Matt Quail at Cenqua - * - * Version 1.22.2 (July 28, 2004) - * Slight refactoring of Java 1.5 language support - * o Refactored for/"foreach" productions so that original literal "for" literal - * is still used but the for sub-clauses vary by token type - * o Fixed bug where type parameter was not included in generic constructor's branch of AST - * - * Version 1.22.3 (August 26, 2004) - * Bug fixes as identified by Michael Stahl; clean up of tabs/spaces - * and other refactorings - * o Fixed typeParameters omission in identPrimary and newStatement - * o Replaced GT reconcilliation code with simple semantic predicate - * o Adapted enum/assert keyword checking support from Michael Stahl's java15 grammar - * o Refactored typeDefinition production and field productions to reduce duplication - * - * Version 1.22.4 (October 21, 2004) - * Small bux fixes - * o Added typeArguments to explicitConstructorInvocation, e.g. new MyParameterised() - * o Added typeArguments to postfixExpression productions for anonymous inner class super - * constructor invocation, e.g. new Outer().super() - * o Fixed bug in array declarations identified by Geoff Roy - * - * This grammar is in the PUBLIC DOMAIN - */ - -class InternalJavaParser extends Parser; -options { - k = 2; // two token lookahead - exportVocab=Java; // Call its vocabulary "Java" - codeGenMakeSwitchThreshold = 2; // Some optimizations - codeGenBitsetTestThreshold = 3; - defaultErrorHandler = false; // Don't generate parser error handlers - buildAST = true; -// classHeaderSuffix = "Parser"; - importVocab = Common; - ASTLabelType = JavaNode; -// useTokenPrefix = true; - // This class is abstract - classHeaderPrefix = "public abstract"; - -} -tokens { - BLOCK; MODIFIERS; OBJBLOCK; SLIST; CTOR_DEF; METHOD_DEF; VARIABLE_DEF; - INSTANCE_INIT; STATIC_INIT; TYPE; CLASS_DEF; INTERFACE_DEF; - PACKAGE_DEF; ARRAY_DECLARATOR; EXTENDS_CLAUSE; IMPLEMENTS_CLAUSE; - PARAMETERS; PARAMETER_DEF; LABELED_STAT; TYPECAST; INDEX_OP; - POST_INC; POST_DEC; METHOD_CALL; EXPR; ARRAY_INIT; - IMPORT; UNARY_MINUS; UNARY_PLUS; CASE_GROUP; ELIST; FOR_INIT; FOR_CONDITION; - FOR_ITERATOR; EMPTY_STAT; FINAL="final"; ABSTRACT="abstract"; - STRICTFP="strictfp"; SUPER_CTOR_CALL; CTOR_CALL; VARIABLE_PARAMETER_DEF; - STATIC_IMPORT; ENUM_DEF; ENUM_CONSTANT_DEF; FOR_EACH_CLAUSE; ANNOTATION_DEF; ANNOTATIONS; - ANNOTATION; ANNOTATION_MEMBER_VALUE_PAIR; ANNOTATION_FIELD_DEF; ANNOTATION_ARRAY_INIT; - TYPE_ARGUMENTS; TYPE_ARGUMENT; TYPE_PARAMETERS; TYPE_PARAMETER; WILDCARD_TYPE; - TYPE_UPPER_BOUNDS; TYPE_LOWER_BOUNDS; - - ROOT;CASESLIST;SEPARATOR_COMMENT;BOF;SYNBLOCK;SPECIAL_COMMENT; - -} - -{ - /** - * Counts the number of LT seen in the typeArguments production. - * It is used in semantic predicates to ensure we have seen - * enough closing '>' characters; which actually may have been - * either GT, SR or BSR tokens. - */ - private int ltCounter = 0; - - protected abstract void attachStuff(JavaNode[] nodes) throws TokenStreamIOException; - -} - -// Compilation Unit: In Java, this is a single file. This is the start -// rule for this parser compilationUnit -parse - { - JavaNode root = (JavaNode) getASTFactory().create(); - root.setType(JavaTokenTypes.ROOT); - root.setText(getFilename()); - currentAST.root = root; - } - - : // A compilation unit starts with an optional package definition - ( (annotations "package")=> packageDefinition - | /* nothing */ - ) - - // Next we have a series of zero or more import statements - ( importDefinition )* - - // Wrapping things up with any number of class or interface - // definitions - ( typeDefinition )* - - EOF - ; - - -// Package statement: optional annotations followed by "package" then the package identifier. -packageDefinition - options {defaultErrorHandler = true;} // let ANTLR handle errors - : annotations p:"package"^ {#p.setType(PACKAGE_DEF);} identifier SEMI - ; - - -// Import statement: import followed by a package or class name -importDefinition - options {defaultErrorHandler = true;} - { boolean isStatic = false; } - : i:"import"^ {#i.setType(IMPORT);} ( "static"! {#i.setType(STATIC_IMPORT);} )? identifierStar SEMI - ; - -// A type definition is either a class, interface, enum or annotation with possible additional semis. -typeDefinition - options {defaultErrorHandler = true;} - : m:modifiers! - typeDefinitionInternal[#m] - | SEMI - ; - -// Protected type definitions production for reuse in other productions -protected typeDefinitionInternal[JavaNode mods] - : classDefinition[#mods] // inner class - | interfaceDefinition[#mods] // inner interface - | enumDefinition[#mods] // inner enum - | annotationDefinition[#mods] // inner annotation - ; - -// A declaration is the creation of a reference or primitive-type variable -// Create a separate Type/Var tree for each var in the var list. -declaration! - : m:modifiers t:typeSpec[false] v:variableDefinitions[#m,#t] - {#declaration = #v;} - ; - -// A type specification is a type name with possible brackets afterwards -// (which would make it an array type). -typeSpec[boolean addImagNode] - : classTypeSpec[addImagNode] - | builtInTypeSpec[addImagNode] - ; - -// A class type specification is a class type with either: -// - possible brackets afterwards -// (which would make it an array type). -// - generic type arguments after -classTypeSpec[boolean addImagNode] - : classOrInterfaceType[false] - (options{greedy=true;}: // match as many as possible - lb:LBRACK^ {#lb.setType(ARRAY_DECLARATOR);} RBRACK! - )* - { - if ( addImagNode ) { - #classTypeSpec = #(#[TYPE,"TYPE"], #classTypeSpec); - } - } - ; - -// A non-built in type name, with possible type parameters -classOrInterfaceType[boolean addImagNode] - : IDENT^ (typeArguments)? - (options{greedy=true;}: // match as many as possible - DOT^ - IDENT (typeArguments)? - )* - { - if ( addImagNode ) { - #classOrInterfaceType = #(#[TYPE,"TYPE"], #classOrInterfaceType); - } - } - ; - -// A specialised form of typeSpec where built in types must be arrays -typeArgumentSpec - : classTypeSpec[true] - | builtInTypeArraySpec[true] - ; - -// A generic type argument is a class type, a possibly bounded wildcard type or a built-in type array -typeArgument - : ( typeArgumentSpec - | wildcardType - ) - {#typeArgument = #(#[TYPE_ARGUMENT,"TYPE_ARGUMENT"], #typeArgument);} - ; - -// Wildcard type indicating all types (with possible constraint) -wildcardType - : q:QUESTION^ {#q.setType(WILDCARD_TYPE);} - (("extends" | "super")=> typeArgumentBounds)? - ; - -// Type arguments to a class or interface type -typeArguments -{int currentLtLevel = 0;} - : - {currentLtLevel = ltCounter;} - LT! {ltCounter++;} - typeArgument - (options{greedy=true;}: // match as many as possible - {inputState.guessing !=0 || ltCounter == currentLtLevel + 1}? - COMMA typeArgument - )* - - ( // turn warning off since Antlr generates the right code, - // plus we have our semantic predicate below - options{generateAmbigWarnings=false;}: - typeArgumentsOrParametersEnd - )? - - // make sure we have gobbled up enough '>' characters - // if we are at the "top level" of nested typeArgument productions - {(currentLtLevel != 0) || ltCounter == currentLtLevel}? - - {#typeArguments = #(#[TYPE_ARGUMENTS, "TYPE_ARGUMENTS"], #typeArguments);} - ; - -// this gobbles up *some* amount of '>' characters, and counts how many -// it gobbled. -protected typeArgumentsOrParametersEnd - : GT! {ltCounter-=1;} - | SR! {ltCounter-=2;} - | BSR! {ltCounter-=3;} - ; - -// Restriction on wildcard types based on super class or derrived class -typeArgumentBounds - {boolean isUpperBounds = false;} - : - ( "extends"! {isUpperBounds=true;} | "super"! ) classOrInterfaceType[false] - { - if (isUpperBounds) - { - #typeArgumentBounds = #(#[TYPE_UPPER_BOUNDS,"TYPE_UPPER_BOUNDS"], #typeArgumentBounds); - } - else - { - #typeArgumentBounds = #(#[TYPE_LOWER_BOUNDS,"TYPE_LOWER_BOUNDS"], #typeArgumentBounds); - } - } - ; - -// A builtin type array specification is a builtin type with brackets afterwards -builtInTypeArraySpec[boolean addImagNode] - : builtInType - (options{greedy=true;}: // match as many as possible - lb:LBRACK^ {#lb.setType(ARRAY_DECLARATOR);} RBRACK! - )+ - - { - if ( addImagNode ) { - #builtInTypeArraySpec = #(#[TYPE,"TYPE"], #builtInTypeArraySpec); - } - } - ; - -// A builtin type specification is a builtin type with possible brackets -// afterwards (which would make it an array type). -builtInTypeSpec[boolean addImagNode] - : builtInType - (options{greedy=true;}: // match as many as possible - lb:LBRACK^ {#lb.setType(ARRAY_DECLARATOR);} RBRACK! - )* - { - if ( addImagNode ) { - #builtInTypeSpec = #(#[TYPE,"TYPE"], #builtInTypeSpec); - } - } - ; - -// A type name. which is either a (possibly qualified and parameterized) -// class name or a primitive (builtin) type -type - : classOrInterfaceType[false] - | builtInType - ; - -// The primitive types. -builtInType - : "void" - | "boolean" - | "byte" - | "char" - | "short" - | "int" - | "float" - | "long" - | "double" - ; - -// A (possibly-qualified) java identifier. We start with the first IDENT -// and expand its name by adding dots and following IDENTS -identifier - : IDENT ( DOT^ IDENT )* - ; - -identifierStar - : IDENT - ( DOT^ IDENT )* - ( DOT^ STAR )? - ; - -// A list of zero or more modifiers. We could have used (modifier)* in -// place of a call to modifiers, but I thought it was a good idea to keep -// this rule separate so they can easily be collected in a Vector if -// someone so desires -modifiers - : - ( - //hush warnings since the semantic check for "@interface" solves the non-determinism - options{generateAmbigWarnings=false;}: - - modifier - | - //Semantic check that we aren't matching @interface as this is not an annotation - //A nicer way to do this would be nice - {LA(1)==AT && !LT(2).getText().equals("interface")}? annotation - )* - - {#modifiers = #([MODIFIERS, "MODIFIERS"], #modifiers);} - ; - -// modifiers for Java classes, interfaces, class/instance vars and methods -modifier - : "private" - | "public" - | "protected" - | "static" - | "transient" - | "final" - | "abstract" - | "native" - | "threadsafe" - | "synchronized" - | "volatile" - | "strictfp" - ; - -annotation! - : a:AT i:identifier ( lp:LPAREN ( args:annotationArguments )? rp:RPAREN )? - {#annotation = #(#[ANNOTATION,"ANNOTATION"],a, i, lp, args, rp);} - ; - -annotations - : (annotation)* - {#annotations = #([ANNOTATIONS, "ANNOTATIONS"], #annotations);} - ; - -annotationArguments - : annotationMemberValueInitializer | anntotationMemberValuePairs - ; - -anntotationMemberValuePairs - : annotationMemberValuePair ( COMMA annotationMemberValuePair )* - ; - -annotationMemberValuePair! - : i:IDENT ASSIGN! v:annotationMemberValueInitializer - {#annotationMemberValuePair = #(#[ANNOTATION_MEMBER_VALUE_PAIR,"ANNOTATION_MEMBER_VALUE_PAIR"], i, v);} - ; - -annotationMemberValueInitializer - : - conditionalExpression | annotation | annotationMemberArrayInitializer - ; - -// This is an initializer used to set up an annotation member array. -annotationMemberArrayInitializer - : lc:LCURLY^ {#lc.setType(ANNOTATION_ARRAY_INIT);} - ( annotationMemberArrayValueInitializer - ( - // CONFLICT: does a COMMA after an initializer start a new - // initializer or start the option ',' at end? - // ANTLR generates proper code by matching - // the comma as soon as possible. - options { - warnWhenFollowAmbig = false; - } - : - COMMA annotationMemberArrayValueInitializer - )* - (COMMA)? - )? - RCURLY - ; - -// The two things that can initialize an annotation array element are a conditional expression -// and an annotation (nested annotation array initialisers are not valid) -annotationMemberArrayValueInitializer - : conditionalExpression - | annotation - ; - -superClassClause! - : ( "extends" c:classOrInterfaceType[false] )? - {#superClassClause = #(#[EXTENDS_CLAUSE,"EXTENDS_CLAUSE"],c);} - ; - -// Definition of a Java class -classDefinition![JavaNode modifiers] - : c:"class" IDENT - // it _might_ have type paramaters - (tp:typeParameters)? - // it _might_ have a superclass... - sc:superClassClause - // it might implement some interfaces... - ic:implementsClause - // now parse the body of the class - cb:classBlock - {#classDefinition = #(#[CLASS_DEF,"CLASS_DEF"], - modifiers,IDENT,tp,sc,ic,cb); - attachStuff(new JavaNode[] {#classDefinition, modifiers, #c}); - } - ; - -// Definition of a Java Interface -interfaceDefinition![JavaNode modifiers] - : i:"interface" IDENT - // it _might_ have type paramaters - (tp:typeParameters)? - // it might extend some other interfaces - ie:interfaceExtends - // now parse the body of the interface (looks like a class...) - ib:interfaceBlock - {#interfaceDefinition = #(#[INTERFACE_DEF,"INTERFACE_DEF"], - modifiers,IDENT,tp,ie,ib); - attachStuff(new JavaNode[] {#interfaceDefinition, modifiers, #i}); - } - ; - -enumDefinition![JavaNode modifiers] - : e:"enum" IDENT - // it might implement some interfaces... - ic:implementsClause - // now parse the body of the enum - eb:enumBlock - {#enumDefinition = #(#[ENUM_DEF,"ENUM_DEF"], - modifiers,IDENT,ic,eb); - attachStuff(new JavaNode[] {#enumDefinition, modifiers, #e}); - } - ; - -annotationDefinition![JavaNode modifiers] - : a:AT "interface" IDENT - // now parse the body of the annotation - ab:annotationBlock - {#annotationDefinition = #(#[ANNOTATION_DEF,"ANNOTATION_DEF"], - modifiers,IDENT,ab); - attachStuff(new JavaNode[] {#annotationDefinition, modifiers, #a}); - } - ; - -typeParameters -{int currentLtLevel = 0;} - : - {currentLtLevel = ltCounter;} - LT {ltCounter++;} - typeParameter (COMMA typeParameter)* - (typeArgumentsOrParametersEnd)? - - // make sure we have gobbled up enough '>' characters - // if we are at the "top level" of nested typeArgument productions - {(currentLtLevel != 0) || ltCounter == currentLtLevel}? - - {#typeParameters = #(#[TYPE_PARAMETERS, "TYPE_PARAMETERS"], #typeParameters);} - ; - -typeParameter - : - // I'm pretty sure Antlr generates the right thing here: - (id:IDENT) ( options{generateAmbigWarnings=false;}: typeParameterBounds )? - {#typeParameter = #(#[TYPE_PARAMETER,"TYPE_PARAMETER"], #typeParameter);} - ; - -typeParameterBounds - : - "extends"! classOrInterfaceType[false] - (BAND classOrInterfaceType[false])* - {#typeParameterBounds = #(#[TYPE_UPPER_BOUNDS,"TYPE_UPPER_BOUNDS"], #typeParameterBounds);} - ; - -// This is the body of a class. You can have classFields and extra semicolons. -classBlock - : lc:LCURLY^ - ( classField | SEMI )* - RCURLY - { #lc.setType(OBJBLOCK);} - //{#classBlock = #([OBJBLOCK, "OBJBLOCK"], #classBlock);} - ; - -// This is the body of an interface. You can have interfaceField and extra semicolons. -interfaceBlock - : lc:LCURLY^ - ( interfaceField | SEMI )* - RCURLY - { #lc.setType(OBJBLOCK);} - //{#interfaceBlock = #([OBJBLOCK, "OBJBLOCK"], #interfaceBlock);} - ; - -// This is the body of an annotation. You can have annotation fields and extra semicolons, -// That's about it (until you see what an annoation field is...) -annotationBlock - : lc:LCURLY^ - ( annotationField | SEMI )* - RCURLY - { #lc.setType(OBJBLOCK);} -// {#annotationBlock = #([OBJBLOCK, "OBJBLOCK"], #annotationBlock);} - ; - -// This is the body of an enum. You can have zero or more enum constants -// followed by any number of fields like a regular class -enumBlock - : lc:LCURLY^ - ( enumConstant ( options{greedy=true;}: COMMA! enumConstant )* ( COMMA! )? )? - ( SEMI! ( classField | SEMI! )* )? - RCURLY - { #lc.setType(OBJBLOCK);} -// {#enumBlock = #([OBJBLOCK, "OBJBLOCK"], #enumBlock);} - ; - -// An annotation field -annotationField! - : mods:modifiers - ( td:typeDefinitionInternal[#mods] - {#annotationField = #td;} - | t:typeSpec[false] // annotation field - ( i:IDENT // the name of the field - - LPAREN RPAREN - - rt:declaratorBrackets[#t] - - ( "default" amvi:annotationMemberValueInitializer ) ? -// { if (#d!=null) #d = #(d,#(amvi)); } - - SEMI - - {#annotationField = - #(#[ANNOTATION_FIELD_DEF,"ANNOTATION_FIELD_DEF"], - mods, - #(#[TYPE,"TYPE"],rt), - i,LPAREN,RPAREN,amvi,SEMI - ); - attachStuff(new JavaNode[] {#annotationField, #mods, #t}); - } - | v:variableDefinitions[#mods,#t] // typeVariableDefinitions - { - #annotationField = #v; - } - ) - ) - ; - -//An enum constant may have optional parameters and may have a -//a class body -enumConstant! - : an:annotations - i:IDENT - ( lp:LPAREN - a:argList - rp:RPAREN - )? - ( b:enumConstantBlock )? - {#enumConstant = #([ENUM_CONSTANT_DEF, "ENUM_CONSTANT_DEF"], an, i, lp,a,rp, b);} - ; - -//The class-like body of an enum constant -enumConstantBlock - : LCURLY - ( enumConstantField | SEMI )* - RCURLY - {#enumConstantBlock = #([OBJBLOCK, "OBJBLOCK"], #enumConstantBlock);} - ; - -//An enum constant field is just like a class field but without -//the posibility of a constructor definition or a static initializer -enumConstantField! - : mods:modifiers - ( td:typeDefinitionInternal[#mods] - {#enumConstantField = #td;} - - | // A generic method has the typeParameters before the return type. - // This is not allowed for variable definitions, but this production - // allows it, a semantic check could be used if you wanted. - (tp:typeParameters)? t:typeSpec[false] // method or variable declaration(s) - ( IDENT // the name of the method - - // parse the formal parameter declarations. - LPAREN param:parameterDeclarationList RPAREN - - rt:declaratorBrackets[#t] - - // get the list of exceptions that this method is - // declared to throw - (tc:throwsClause)? - - ( s2:compoundStatement | semim:SEMI ) - {#enumConstantField = #(#[METHOD_DEF,"METHOD_DEF"], - mods, - tp, - #(#[TYPE,"TYPE"],rt), - IDENT, - param, - tc, - s2, - semim); - attachStuff(new JavaNode[] {#enumConstantField, #mods, #t}); - } - | v:variableDefinitions[#mods,#t] // typeVariableDefinitions - {#enumConstantField = #v; - } - ) - ) - - // "{ ... }" instance initializer - | s4:compoundStatement - {#enumConstantField = #(#[INSTANCE_INIT,"INSTANCE_INIT"], s4); - attachStuff(new JavaNode[] {#enumConstantField, #s4}); - } - ; - -// An interface can extend several other interfaces... -interfaceExtends - : ( - e:"extends"! - classOrInterfaceType[false] ( COMMA! classOrInterfaceType[false] )* - )? - {#interfaceExtends = #(#[EXTENDS_CLAUSE,"EXTENDS_CLAUSE"], - #interfaceExtends);} - ; - -// A class can implement several interfaces... -implementsClause - : ( - i:"implements"! classOrInterfaceType[false] ( COMMA! classOrInterfaceType[false] )* - )? - {#implementsClause = #(#[IMPLEMENTS_CLAUSE,"IMPLEMENTS_CLAUSE"], - #implementsClause);} - ; - -// Now the various things that can be defined inside a class -classField! - : // method, constructor, or variable declaration - mods:modifiers - ( td:typeDefinitionInternal[#mods] - {#classField = #td;} - - | (tp:typeParameters)? - ( - h:ctorHead s:constructorBody // constructor - {#classField = #(#[CTOR_DEF,"CTOR_DEF"], mods, tp, h, s); - attachStuff(new JavaNode[] {#classField, #mods, #h}); - } - - | // A generic method/ctor has the typeParameters before the return type. - // This is not allowed for variable definitions, but this production - // allows it, a semantic check could be used if you wanted. - t:typeSpec[false] // method or variable declaration(s) - ( IDENT // the name of the method - - // parse the formal parameter declarations. - LPAREN param:parameterDeclarationList RPAREN - - rt:declaratorBrackets[#t] - - // get the list of exceptions that this method is - // declared to throw - (tc:throwsClause)? - - ( s2:compoundStatement | semim:SEMI ) - {#classField = #(#[METHOD_DEF,"METHOD_DEF"], - mods, - tp, - #(#[TYPE,"TYPE"],rt), - IDENT, - LPAREN, - param, - RPAREN, - tc, - s2, - semim); - attachStuff(new JavaNode[] {#classField, #mods, #t}); - } - | v:variableDefinitions[#mods,#t] semi:SEMI!// typeVariableDefinitions - { - #classField = #v; - - #classField.addChild(#semi); - - AST next = #classField.getNextSibling(); - // HACK for multiple variable declaration in one statement - // e.g float x, y, z; - // the semicolon will only be added to the first statement so - // we have to add it manually to all others - if (next != null) - { - AST ssemi = JavaNodeHelper.getFirstChild(#classField, JavaTokenTypes.SEMI); - - for (AST var = next; var != null; var = var.getNextSibling()) - { - var.addChild(astFactory.create(ssemi)); - } - } - - - } - ) - ) - ) - - // "static { ... }" class initializer - | "static" s3:compoundStatement - {#classField = #(#[STATIC_INIT,"STATIC_INIT"], s3); - attachStuff(new JavaNode[] {#classField, #s3}); - } - - // "{ ... }" instance initializer - | s4:compoundStatement - {#classField = #(#[INSTANCE_INIT,"INSTANCE_INIT"], s4); - attachStuff(new JavaNode[] {#classField, #s4}); - } - ; - -// Now the various things that can be defined inside a interface -interfaceField! - : // method, constructor, or variable declaration - mods:modifiers - ( td:typeDefinitionInternal[#mods] - {#interfaceField = #td;} - - | (tp:typeParameters)? - // A generic method has the typeParameters before the return type. - // This is not allowed for variable definitions, but this production - // allows it, a semantic check could be used if you want a more strict - // grammar. - t:typeSpec[false] // method or variable declaration(s) - ( IDENT // the name of the method - - // parse the formal parameter declarations. - LPAREN param:parameterDeclarationList RPAREN - - rt:declaratorBrackets[#t] - - // get the list of exceptions that this method is - // declared to throw - (tc:throwsClause)? - - SEMI - - {#interfaceField = #(#[METHOD_DEF,"METHOD_DEF"], - mods, - tp, - #(#[TYPE,"TYPE"],rt), - IDENT, - LPAREN, - param, - RPAREN, - tc, - SEMI); - attachStuff(new JavaNode[] {#interfaceField, #mods, #t}); - } - | v:variableDefinitions[#mods,#t] semi:SEMI! - { - #interfaceField = #v; - - #interfaceField.addChild(#semi); - - AST next = #interfaceField.getNextSibling(); - // HACK for multiple variable declaration in one statement - // e.g float x, y, z; - // the semicolon will only be added to the first statement so - // we have to add it manually to all others - if (next != null) - { - AST ssemi = JavaNodeHelper.getFirstChild(#interfaceField, JavaTokenTypes.SEMI); - - for (AST var = next; var != null; var = var.getNextSibling()) - { - var.addChild(astFactory.create(ssemi)); - } - } - - - } - ) - ) - ; - -constructorBody - : lc:LCURLY^ {#lc.setType(SLIST);} - ( options { greedy=true; } : explicitConstructorInvocation)? - (statement)* - RCURLY - ; - -/** Catch obvious constructor calls, but not the expr.super(...) calls */ -explicitConstructorInvocation - : (typeArguments)? - ( "this" lp1:LPAREN^ argList RPAREN SEMI - {#lp1.setType(CTOR_CALL);} - | "super" lp2:LPAREN^ argList RPAREN SEMI - {#lp2.setType(SUPER_CTOR_CALL);} - ) - ; - -/** Catch variable definitions but add the semicolon ???*/ -typeVariableDefinitions[JavaNode mods, JavaNode t] - : v:variableDefinitions[mods,t] - (semi:SEMI - { - #v.addChild(#semi); - } - ) - ; - -variableDefinitions[JavaNode mods, JavaNode t] - : variableDeclarator[(JavaNode)getASTFactory().dupTree(mods), - (JavaNode)getASTFactory().dupTree(t)] - ( COMMA! - variableDeclarator[(JavaNode)getASTFactory().dupTree(mods), - (JavaNode)getASTFactory().dupTree(t)] - )* - - ; - -/** Declaration of a variable. This can be a class/instance variable, - * or a local variable in a method - * It can also include possible initialization. - */ -variableDeclarator![JavaNode mods, JavaNode t] - : id:IDENT d:declaratorBrackets[t] v:varInitializer - {#variableDeclarator = #(#[VARIABLE_DEF,"VARIABLE_DEF"], mods, #(#[TYPE,"TYPE"],d), id, v); - attachStuff(new JavaNode[] {#variableDeclarator,mods, t}); - } - ; - -declaratorBrackets[JavaNode typ] - : {#declaratorBrackets=typ;} - (lb:LBRACK^ {#lb.setType(ARRAY_DECLARATOR);} RBRACK!)* - ; - -varInitializer - : ( ASSIGN^ initializer )? - ; - -// This is an initializer used to set up an array. -arrayInitializer - : lc:LCURLY^ {#lc.setType(ARRAY_INIT);} - ( initializer - ( - // CONFLICT: does a COMMA after an initializer start a new - // initializer or start the option ',' at end? - // ANTLR generates proper code by matching - // the comma as soon as possible. - options { - warnWhenFollowAmbig = false; - } - : - COMMA initializer - )* - (COMMA)? - )? - RCURLY - ; - - -// The two "things" that can initialize an array element are an expression -// and another (nested) array initializer. -initializer - : expression - | arrayInitializer - ; - -// This is the header of a method. It includes the name and parameters -// for the method. -// This also watches for a list of exception classes in a "throws" clause. -ctorHead - : IDENT // the name of the method - - // parse the formal parameter declarations. - LPAREN parameterDeclarationList RPAREN - - // get the list of exceptions that this method is declared to throw - (throwsClause)? - ; - -// This is a list of exception classes that the method is declared to throw -throwsClause - : "throws"^ identifier ( COMMA identifier )* - ; - -// A list of formal parameters -// Zero or more parameters -// If a parameter is variable length (e.g. String... myArg) it is the right-most parameter -parameterDeclarationList - // The semantic check in ( .... )* block is flagged as superfluous, and seems superfluous but - // is the only way I could make this work. If my understanding is correct this is a known bug - : ( ( parameterDeclaration )=> parameterDeclaration - ( options {warnWhenFollowAmbig=false;} : ( COMMA parameterDeclaration ) => COMMA parameterDeclaration )* - ( COMMA variableLengthParameterDeclaration )? - | - variableLengthParameterDeclaration - )? - {#parameterDeclarationList = #(#[PARAMETERS,"PARAMETERS"], - #parameterDeclarationList);} - ; - -// A formal parameter. -parameterDeclaration! - : pm:parameterModifier t:typeSpec[false] id:IDENT - pd:declaratorBrackets[#t] - {#parameterDeclaration = #(#[PARAMETER_DEF,"PARAMETER_DEF"], - pm, #([TYPE,"TYPE"],pd), id);} - ; - -variableLengthParameterDeclaration! - : pm:parameterModifier t:typeSpec[false] TRIPLE_DOT id:IDENT - pd:declaratorBrackets[#t] - {#variableLengthParameterDeclaration = #(#[VARIABLE_PARAMETER_DEF,"VARIABLE_PARAMETER_DEF"], - pm, #([TYPE,"TYPE"],pd), id);} - ; - -parameterModifier - //final can appear amongst annotations in any order - greedily consume any preceding - //annotations to shut nond-eterminism warnings off - : (options{greedy=true;} : annotation)* (f:"final")? (annotation)* - {#parameterModifier = #(#[MODIFIERS,"MODIFIERS"], #parameterModifier);} - ; - -// Compound statement. This is used in many contexts: -// Inside a class definition prefixed with "static": -// it is a class initializer -// Inside a class definition without "static": -// it is an instance initializer -// As the body of a method -// As a completely indepdent braced block of code inside a method -// it starts a new scope for variable definitions - -compoundStatement - : lc:LCURLY^ {#lc.setType(SLIST);} - // include the (possibly-empty) list of statements - (statement)* - RCURLY - ; - - -statement - // A list of statements in curly braces -- start a new scope! - : compoundStatement - - // declarations are ambiguous with "ID DOT" relative to expression - // statements. Must backtrack to be sure. Could use a semantic - // predicate to test symbol table to see what the type was coming - // up, but that's pretty hard without a symbol table ;) - // (declaration)=> declaration SEMI - | (declaration)=> decl:declaration semi1:SEMI! - { - // add semicolon to the AST - #decl.addChild(#semi1); - - AST next = currentAST.root.getNextSibling(); - - // HACK for multiple variable declaration in one statement - // e.g float x, y, z; - // the semicolon will only be added to the first statement so - // we have to add it manually to all others - if (next != null) - { - AST semi = JavaNodeHelper.getFirstChild(currentAST.root, JavaTokenTypes.SEMI); - - for (AST var = next; var != null; var = var.getNextSibling()) - { - var.addChild(astFactory.create(semi)); - } - } - } - - // An expression statement. This could be a method call, - // assignment statement, or any other expression evaluated for - // side-effects. - | e:expression semi2:SEMI! - {#e.addChild(#semi2); - } - - //TODO: what abour interfaces, enums and annotations - // class definition - | m:modifiers! classDefinition[#m] - - // Attach a label to the front of a statement - | IDENT c:COLON^ {#c.setType(LABELED_STAT);} statement - - // If-else statement - | "if"^ LPAREN expression RPAREN statement - ( - // CONFLICT: the old "dangling-else" problem... - // ANTLR generates proper code matching - // as soon as possible. Hush warning. - options { - warnWhenFollowAmbig = false; - } - : - "else" statement - )? - - // For statement - | forStatement - - // While statement - | "while"^ LPAREN expression RPAREN statement - - // do-while statement - | "do"^ statement "while" LPAREN expression RPAREN SEMI - - // get out of a loop (or switch) - | "break"^ (IDENT)? SEMI - - // do next iteration of a loop - | "continue"^ (IDENT)? SEMI - - // Return an expression - | "return"^ (expression)? SEMI - - // switch/case statement - | "switch"^ LPAREN expression RPAREN LCURLY - ( casesGroup )* - RCURLY - - // exception try-catch block - | tryBlock - - // throw an exception - | "throw"^ expression SEMI - - // synchronize a statement - | synBlock:"synchronized"^ LPAREN expression RPAREN compoundStatement - { #synBlock.setType(SYNBLOCK);} - - // asserts (uncomment if you want 1.4 compatibility) - | "assert"^ expression ( COLON! expression )? SEMI - - // empty statement possibly ????? - | s:SEMI {#s.setType(EMPTY_STAT);} - ; - -forStatement - : f:"for"^ - LPAREN - ( (forInit SEMI)=>traditionalForClause - | forEachClause - ) - RPAREN - statement // statement to loop over - ; - -traditionalForClause - : - forInit SEMI // initializer - forCond SEMI // condition test - forIter // updater - ; - -forEachClause - : - p:parameterDeclaration COLON! expression - {#forEachClause = #(#[FOR_EACH_CLAUSE,"FOR_EACH_CLAUSE"], #forEachClause);} - ; - -casesGroup - : ( // CONFLICT: to which case group do the statements bind? - // ANTLR generates proper code: it groups the - // many "case"/"default" labels together then - // follows them with the statements - options { - greedy = true; - } - : - aCase - )+ - caseSList - {#casesGroup = #([CASE_GROUP, "CASE_GROUP"], #casesGroup);} - ; - -aCase - : ("case"^ expression | "default") COLON - ; - -caseSList - : (statement)* - {#caseSList = #(#[CASESLIST,"CASESLIST"],#caseSList);} - ; - -// The initializer for a for loop -forInit - // if it looks like a declaration, it is - : ((declaration)=> declaration - // otherwise it could be an expression list... - | expressionList - )? - {#forInit = #(#[FOR_INIT,"FOR_INIT"],#forInit);} - ; - -forCond - : (expression)? - {#forCond = #(#[FOR_CONDITION,"FOR_CONDITION"],#forCond);} - ; - -forIter - : (expressionList)? - {#forIter = #(#[FOR_ITERATOR,"FOR_ITERATOR"],#forIter);} - ; - -// an exception handler try/catch block -tryBlock - : "try"^ compoundStatement - (handler)* - ( finallyClause )? - ; - -finallyClause - : "finally"^ compoundStatement - ; - -// an exception handler -handler - : "catch"^ LPAREN parameterDeclaration RPAREN compoundStatement - ; - - -// expressions -// Note that most of these expressions follow the pattern -// thisLevelExpression : -// nextHigherPrecedenceExpression -// (OPERATOR nextHigherPrecedenceExpression)* -// which is a standard recursive definition for a parsing an expression. -// The operators in java have the following precedences: -// lowest (13) = *= /= %= += -= <<= >>= >>>= &= ^= |= -// (12) ?: -// (11) || -// (10) && -// ( 9) | -// ( 8) ^ -// ( 7) & -// ( 6) == != -// ( 5) < <= > >= -// ( 4) << >> -// ( 3) +(binary) -(binary) -// ( 2) * / % -// ( 1) ++ -- +(unary) -(unary) ~ ! (type) -// [] () (method call) . (dot -- identifier qualification) -// new () (explicit parenthesis) -// -// the last two are not usually on a precedence chart; I put them in -// to point out that new has a higher precedence than '.', so you -// can validy use -// new Frame().show() -// -// Note that the above precedence levels map to the rules below... -// Once you have a precedence chart, writing the appropriate rules as below -// is usually very straightfoward - - - -// the mother of all expressions -expression - : assignmentExpression - {#expression = #(#[EXPR,"EXPR"],#expression);} - ; - - -// This is a list of expressions. -expressionList - : expression (COMMA expression)* - {#expressionList = #(#[ELIST,"ELIST"], expressionList);} - ; - - -// assignment expression (level 13) -assignmentExpression - : conditionalExpression - ( ( ASSIGN^ - | PLUS_ASSIGN^ - | MINUS_ASSIGN^ - | STAR_ASSIGN^ - | DIV_ASSIGN^ - | MOD_ASSIGN^ - | SR_ASSIGN^ - | BSR_ASSIGN^ - | SL_ASSIGN^ - | BAND_ASSIGN^ - | BXOR_ASSIGN^ - | BOR_ASSIGN^ - ) - assignmentExpression - )? - ; - - -// conditional test (level 12) -conditionalExpression - : logicalOrExpression - ( QUESTION^ assignmentExpression COLON conditionalExpression )? - ; - - -// logical or (||) (level 11) -logicalOrExpression - : logicalAndExpression (LOR^ logicalAndExpression)* - ; - - -// logical and (&&) (level 10) -logicalAndExpression - : inclusiveOrExpression (LAND^ inclusiveOrExpression)* - ; - - -// bitwise or non-short-circuiting or (|) (level 9) -inclusiveOrExpression - : exclusiveOrExpression (BOR^ exclusiveOrExpression)* - ; - - -// exclusive or (^) (level 8) -exclusiveOrExpression - : andExpression (BXOR^ andExpression)* - ; - - -// bitwise or non-short-circuiting and (&) (level 7) -andExpression - : equalityExpression (BAND^ equalityExpression)* - ; - - -// equality/inequality (==/!=) (level 6) -equalityExpression - : relationalExpression ((NOT_EQUAL^ | EQUAL^) relationalExpression)* - ; - - -// boolean relational expressions (level 5) -relationalExpression - : shiftExpression - ( ( ( LT^ - | GT^ - | LE^ - | GE^ - ) - shiftExpression - )* - | "instanceof"^ typeSpec[true] - ) - ; - - -// bit shift expressions (level 4) -shiftExpression - : additiveExpression ((SL^ | SR^ | BSR^) additiveExpression)* - ; - - -// binary addition/subtraction (level 3) -additiveExpression - : multiplicativeExpression ((PLUS^ | MINUS^) multiplicativeExpression)* - ; - - -// multiplication/division/modulo (level 2) -multiplicativeExpression - : unaryExpression ((STAR^ | DIV^ | MOD^ ) unaryExpression)* - ; - -unaryExpression - : INC^ unaryExpression - | DEC^ unaryExpression - | MINUS^ {#MINUS.setType(UNARY_MINUS);} unaryExpression - | PLUS^ {#PLUS.setType(UNARY_PLUS);} unaryExpression - | unaryExpressionNotPlusMinus - ; - -unaryExpressionNotPlusMinus - : BNOT^ unaryExpression - | LNOT^ unaryExpression - | ( // subrule allows option to shut off warnings - options { - // "(int" ambig with postfixExpr due to lack of sequence - // info in linear approximate LL(k). It's ok. Shut up. - generateAmbigWarnings=false; - } - : // If typecast is built in type, must be numeric operand - // Have to backtrack to see if operator follows - (LPAREN builtInTypeSpec[true] RPAREN unaryExpression)=> - lpb:LPAREN^ {#lpb.setType(TYPECAST);} builtInTypeSpec[true] RPAREN! - unaryExpression - - // Have to backtrack to see if operator follows. If no operator - // follows, it's a typecast. No semantic checking needed to parse. - // if it _looks_ like a cast, it _is_ a cast; else it's a "(expr)" - | (LPAREN classTypeSpec[true] RPAREN unaryExpressionNotPlusMinus)=> - lp:LPAREN^ {#lp.setType(TYPECAST);} classTypeSpec[true] RPAREN! - unaryExpressionNotPlusMinus - - | postfixExpression - ) - ; - -// qualified names, array expressions, method invocation, post inc/dec -postfixExpression - : - primaryExpression - - ( - /* - options { - // the use of postfixExpression in SUPER_CTOR_CALL adds DOT - // to the lookahead set, and gives loads of false non-det - // warnings. - // shut them off. - generateAmbigWarnings=false; - } - : */ - //type arguments are only appropriate for a parameterized method/ctor invocations - //semantic check may be needed here to ensure that this is the case - DOT^ (typeArguments)? - ( IDENT - ( lp:LPAREN^ {#lp.setType(METHOD_CALL);} - argList - RPAREN - )? - | "super" - ( // (new Outer()).super() (create enclosing instance) - lp3:LPAREN^ argList RPAREN - {#lp3.setType(SUPER_CTOR_CALL);} - | DOT^ (typeArguments)? IDENT - ( lps:LPAREN^ {#lps.setType(METHOD_CALL);} - argList - RPAREN - )? - ) - ) - | DOT^ "this" - | DOT^ newExpression - | lb:LBRACK^ {#lb.setType(INDEX_OP);} expression RBRACK - )* - - ( // possibly add on a post-increment or post-decrement. - // allows INC/DEC on too much, but semantics can check - in:INC^ {#in.setType(POST_INC);} - | de:DEC^ {#de.setType(POST_DEC);} - )? - ; - -// the basic element of an expression -primaryExpression - : identPrimary ( options {greedy=true;} : DOT^ "class" )? - | constant - | "true" - | "false" - | "null" - | newExpression - | "this" - | "super" - | LPAREN assignmentExpression RPAREN - // look for int.class and int[].class - | builtInType - ( lbt:LBRACK^ {#lbt.setType(ARRAY_DECLARATOR);} RBRACK! )* - DOT^ "class" - ; - -/** Match a, a.b.c refs, a.b.c(...) refs, a.b.c[], a.b.c[].class, - * and a.b.c.class refs. Also this(...) and super(...). Match - * this or super. - */ -identPrimary - : (ta1:typeArguments!)? - IDENT - // Syntax for method invocation with type arguments is - // foo("blah") - ( - options { - // .ident could match here or in postfixExpression. - // We do want to match here. Turn off warning. - greedy=true; - // This turns the ambiguity warning of the second alternative - // off. See below. (The "false" predicate makes it non-issue) - warnWhenFollowAmbig=false; - } - // we have a new nondeterminism because of - // typeArguments... only a syntactic predicate will help... - // The problem is that this loop here conflicts with - // DOT typeArguments "super" in postfixExpression (k=2) - // A proper solution would require a lot of refactoring... -// Original way. -// : (DOT (typeArguments)? IDENT) => -// DOT^ (ta2:typeArguments!)? IDENT - : (DOT^ (typeArguments)? IDENT) - | {false}? // FIXME: this is very ugly but it seems to work... - // this will also produce an ANTLR warning! - // Unfortunately a syntactic predicate can only select one of - // multiple alternatives on the same level, not break out of - // an enclosing loop, which is why this ugly hack (a fake - // empty alternative with always-false semantic predicate) - // is necessary. - )* - ( - options { - // ARRAY_DECLARATOR here conflicts with INDEX_OP in - // postfixExpression on LBRACK RBRACK. - // We want to match [] here, so greedy. This overcomes - // limitation of linear approximate lookahead. - greedy=true; - } - : ( lp:LPAREN^ {#lp.setType(METHOD_CALL);} - // if the input is valid, only the last IDENT may - // have preceding typeArguments... rather hacky, this is... -// Not required because see above -// {if (#ta2 != null) astFactory.addASTChild(currentAST, #ta2);} -// {if (#ta2 == null) astFactory.addASTChild(currentAST, #ta1);} - argList RPAREN - ) - | ( options {greedy=true;} : - lbc:LBRACK^ {#lbc.setType(ARRAY_DECLARATOR);} RBRACK! - )+ - )? - ; - -/** object instantiation. - * Trees are built as illustrated by the following input/tree pairs: - * - * new T() - * - * new - * | - * T -- ELIST - * | - * arg1 -- arg2 -- .. -- argn - * - * new int[] - * - * new - * | - * int -- ARRAY_DECLARATOR - * - * new int[] {1,2} - * - * new - * | - * int -- ARRAY_DECLARATOR -- ARRAY_INIT - * | - * EXPR -- EXPR - * | | - * 1 2 - * - * new int[3] - * new - * | - * int -- ARRAY_DECLARATOR - * | - * EXPR - * | - * 3 - * - * new int[1][2] - * - * new - * | - * int -- ARRAY_DECLARATOR - * | - * ARRAY_DECLARATOR -- EXPR - * | | - * EXPR 1 - * | - * 2 - * - */ -newExpression - : "new"^ (typeArguments)? type - ( LPAREN argList RPAREN (classBlock)? - - //java 1.1 - // Note: This will allow bad constructs like - // new int[4][][3] {exp,exp}. - // There needs to be a semantic check here... - // to make sure: - // a) [ expr ] and [ ] are not mixed - // b) [ expr ] and an init are not used together - - | newArrayDeclarator (arrayInitializer)? - ) - ; - -argList - : ( expressionList - | /*nothing*/ - {#argList = #[ELIST,"ELIST"];} - ) - ; - -newArrayDeclarator - : ( - // CONFLICT: - // newExpression is a primaryExpression which can be - // followed by an array index reference. This is ok, - // as the generated code will stay in this loop as - // long as it sees an LBRACK (proper behavior) - options { - warnWhenFollowAmbig = false; - } - : - lb:LBRACK^ {#lb.setType(ARRAY_DECLARATOR);} - (expression)? - RBRACK! - )+ - ; - -constant - : NUM_INT - | CHAR_LITERAL - | STRING_LITERAL - | NUM_FLOAT - | NUM_LONG - | NUM_DOUBLE - ; - - -//---------------------------------------------------------------------------- -// The Java scanner -//---------------------------------------------------------------------------- -class InternalJavaLexer extends Lexer; - -options { - exportVocab=Java; // call the vocabulary "Java" - testLiterals=false; // don't automatically test for literals - k=4; // four characters of lookahead - charVocabulary='\u0003'..'\uFFFF'; - // without inlining some bitset tests, couldn't do unicode; - // I need to make ANTLR generate smaller bitsets; see - // bottom of JavaLexer.java - codeGenBitsetTestThreshold=20; - // This class is abstract - classHeaderPrefix = "public abstract"; -} - -{ - /** flag for enabling the "assert" keyword */ - private boolean assertEnabled = true; - /** flag for enabling the "enum" keyword */ - private boolean enumEnabled = true; - - /** Enable the "assert" keyword */ - public void enableAssert(boolean shouldEnable) { assertEnabled = shouldEnable; } - /** Query the "assert" keyword state */ - public boolean isAssertEnabled() { return assertEnabled; } - /** Enable the "enum" keyword */ - public void enableEnum(boolean shouldEnable) { enumEnabled = shouldEnable; } - /** Query the "enum" keyword state */ - public boolean isEnumEnabled() { return enumEnabled; } - - protected abstract Token makeJavaDoc(Token node, String text) throws TokenStreamIOException; - -} - -// OPERATORS -QUESTION : '?' ; -LPAREN : '(' ; -RPAREN : ')' ; -LBRACK : '[' ; -RBRACK : ']' ; -LCURLY : '{' ; -RCURLY : '}' ; -COLON : ':' ; -COMMA : ',' ; -//DOT : '.' ; -ASSIGN : '=' ; -EQUAL : "==" ; -LNOT : '!' ; -BNOT : '~' ; -NOT_EQUAL : "!=" ; -DIV : '/' ; -DIV_ASSIGN : "/=" ; -PLUS : '+' ; -PLUS_ASSIGN : "+=" ; -INC : "++" ; -MINUS : '-' ; -MINUS_ASSIGN : "-=" ; -DEC : "--" ; -STAR : '*' ; -STAR_ASSIGN : "*=" ; -MOD : '%' ; -MOD_ASSIGN : "%=" ; -SR : ">>" ; -SR_ASSIGN : ">>=" ; -BSR : ">>>" ; -BSR_ASSIGN : ">>>=" ; -GE : ">=" ; -GT : ">" ; -SL : "<<" ; -SL_ASSIGN : "<<=" ; -LE : "<=" ; -LT : '<' ; -BXOR : '^' ; -BXOR_ASSIGN : "^=" ; -BOR : '|' ; -BOR_ASSIGN : "|=" ; -LOR : "||" ; -BAND : '&' ; -BAND_ASSIGN : "&=" ; -LAND : "&&" ; -SEMI : ';' ; - - -// Whitespace -- ignored -WS : ( ' ' - | '\t' - | '\f' - // handle newlines - | ( options {generateAmbigWarnings=false;} - : "\r\n" // Evil DOS - | '\r' // Macintosh - | '\n' // Unix (the right way) - ) - { newline(); } - )+ - { // _ttype = Token.SKIP; - } - ; - -protected SEPARATOR_COMMENT -: "//~" (~('\n'|'\r') {if (LA(1) == EOF_CHAR) break;} )* - ( '\n'! | '\r'!('\n'!)? )? - {newline();} -; - -// Single-line comments -protected SL_COMMENT -: "//" (~('\n'|'\r') {if (LA(1) == EOF_CHAR) break;} )* - ( '\n'! | '\r'!('\n'!)? )? - {newline(); - - } -; -COMMENT -: - ( - options { - // ANTLR does it right by consuming input as soon as possible - generateAmbigWarnings=false; - // TODO spec:SPECIAL_COMMENT {$setToken(spec);} | - }: - - sep:SEPARATOR_COMMENT {$setToken(sep); } | - sl:SL_COMMENT {$setToken(sl); } - ) -; - -// multiple-line comments -ML_COMMENT - : "/*" - ( /* '\r' '\n' can be matched in one alternative or by matching - '\r' in one iteration and '\n' in another. I am trying to - handle any flavor of newline that comes in, but the language - that allows both "\r\n" and "\r" and "\n" to all be valid - newline is ambiguous. Consequently, the resulting grammar - must be ambiguous. I'm shutting this warning off. - */ - options { - generateAmbigWarnings=false; - } - : - { LA(2)!='/' }? '*' - | '\r' '\n' {newline();} - | '\r' {newline();} - | '\n' {newline();} - | ~('*'|'\n'|'\r') - )* - "*/" - { - // $setType(Token.SKIP); - Token n = makeJavaDoc(makeToken(_ttype), $getText); - $setToken(n); - $setType(n.getType()); - } - ; - - -// character literals -CHAR_LITERAL - : '\'' ( ESC | ~('\''|'\n'|'\r'|'\\') ) '\'' - ; - -// string literals -STRING_LITERAL - : '"' (ESC|~('"'|'\\'|'\n'|'\r'))* '"' - ; - - -// escape sequence -- note that this is protected; it can only be called -// from another lexer rule -- it will not ever directly return a token to -// the parser -// There are various ambiguities hushed in this rule. The optional -// '0'...'9' digit matches should be matched here rather than letting -// them go back to STRING_LITERAL to be matched. ANTLR does the -// right thing by matching immediately; hence, it's ok to shut off -// the FOLLOW ambig warnings. -protected -ESC - : '\\' - ( 'n' - | 'r' - | 't' - | 'b' - | 'f' - | '"' - | '\'' - | '\\' - | ('u')+ HEX_DIGIT HEX_DIGIT HEX_DIGIT HEX_DIGIT - | '0'..'3' - ( - options { - warnWhenFollowAmbig = false; - } - : '0'..'7' - ( - options { - warnWhenFollowAmbig = false; - } - : '0'..'7' - )? - )? - | '4'..'7' - ( - options { - warnWhenFollowAmbig = false; - } - : '0'..'7' - )? - ) - ; - - -// hexadecimal digit (again, note it's protected!) -protected -HEX_DIGIT - : ('0'..'9'|'A'..'F'|'a'..'f') - ; - - -// a dummy rule to force vocabulary to be all characters (except special -// ones that ANTLR uses internally (0 to 2) -protected -VOCAB - : '\3'..'\377' - ; - - -// an identifier. Note that testLiterals is set to true! This means -// that after we match the rule, we look in the literals table to see -// if it's a literal or really an identifer -IDENT - options {testLiterals=true;} - : ('a'..'z'|'A'..'Z'|'_'|'$') ('a'..'z'|'A'..'Z'|'_'|'0'..'9'|'$')* - { - // check if "assert" keyword is enabled - if (assertEnabled && "assert".equals($getText)) { - $setType(LITERAL_assert); // set token type for the rule in the parser - } - // check if "enum" keyword is enabled - if (enumEnabled && "enum".equals($getText)) { - $setType(LITERAL_enum); // set token type for the rule in the parser - } - } - ; - - -// a numeric literal -NUM_INT - {boolean isDecimal=false; Token t=null;} - : '.' {_ttype = DOT;} - ( - (('0'..'9')+ (EXPONENT)? (f1:FLOAT_SUFFIX {t=f1;})? - { - if (t != null && t.getText().toUpperCase().indexOf('F')>=0) { - _ttype = NUM_FLOAT; - } - else { - _ttype = NUM_DOUBLE; // assume double - } - }) - | - // JDK 1.5 token for variable length arguments - (".." {_ttype = TRIPLE_DOT;}) - )? - - | ( '0' {isDecimal = true;} // special case for just '0' - ( ('x'|'X') - ( // hex - // the 'e'|'E' and float suffix stuff look - // like hex digits, hence the (...)+ doesn't - // know when to stop: ambig. ANTLR resolves - // it correctly by matching immediately. It - // is therefor ok to hush warning. - options { - warnWhenFollowAmbig=false; - } - : HEX_DIGIT - )+ - - | //float or double with leading zero - (('0'..'9')+ ('.'|EXPONENT|FLOAT_SUFFIX)) => ('0'..'9')+ - - | ('0'..'7')+ // octal - )? - | ('1'..'9') ('0'..'9')* {isDecimal=true;} // non-zero decimal - ) - ( ('l'|'L') { _ttype = NUM_LONG; } - - // only check to see if it's a float if looks like decimal so far - | {isDecimal}? - ( '.' ('0'..'9')* (EXPONENT)? (f2:FLOAT_SUFFIX {t=f2;})? - | EXPONENT (f3:FLOAT_SUFFIX {t=f3;})? - | f4:FLOAT_SUFFIX {t=f4;} - ) - { - if (t != null && t.getText().toUpperCase() .indexOf('F') >= 0) { - _ttype = NUM_FLOAT; - } - else { - _ttype = NUM_DOUBLE; // assume double - } - } - )? - ; - -// JDK 1.5 token for annotations and their declarations -AT - : '@' - ; - -// a couple protected methods to assist in matching floating point numbers -protected -EXPONENT - : ('e'|'E') ('+'|'-')? ('0'..'9')+ - ; - - -protected -FLOAT_SUFFIX - : 'f'|'F'|'d'|'D' - ; - diff --git a/app/src/antlr/java/java.tree.g b/app/src/antlr/java/java.tree.g deleted file mode 100644 index e995ef49d..000000000 --- a/app/src/antlr/java/java.tree.g +++ /dev/null @@ -1,326 +0,0 @@ -package antlr; - - -/** Java 1.3 AST Recognizer Grammar - * - * Author: (see java.g preamble) - * - * This grammar is in the PUBLIC DOMAIN - */ -class JavaTreeParser extends TreeParser; - -options { - importVocab = Java; -} - -compilationUnit - : (packageDefinition)? - (importDefinition)* - (typeDefinition)* - ; - -packageDefinition - : #( PACKAGE_DEF identifier ) - ; - -importDefinition - : #( IMPORT identifierStar ) - ; - -typeDefinition - : #(CLASS_DEF modifiers IDENT extendsClause implementsClause objBlock ) - | #(INTERFACE_DEF modifiers IDENT extendsClause interfaceBlock ) - ; - -typeSpec - : #(TYPE typeSpecArray) - ; - -typeSpecArray - : #( ARRAY_DECLARATOR typeSpecArray ) - | type - ; - -type: identifier - | builtInType - ; - -builtInType - : "void" - | "boolean" - | "byte" - | "char" - | "short" - | "int" - | "float" - | "long" - | "double" - ; - -modifiers - : #( MODIFIERS (modifier)* ) - ; - -modifier - : "private" - | "public" - | "protected" - | "static" - | "transient" - | "final" - | "abstract" - | "native" - | "threadsafe" - | "synchronized" - | "const" - | "volatile" - | "strictfp" - ; - -extendsClause - : #(EXTENDS_CLAUSE (identifier)* ) - ; - -implementsClause - : #(IMPLEMENTS_CLAUSE (identifier)* ) - ; - - -interfaceBlock - : #( OBJBLOCK - ( methodDecl - | variableDef - )* - ) - ; - -objBlock - : #( OBJBLOCK - ( ctorDef - | methodDef - | variableDef - | typeDefinition - | #(STATIC_INIT slist) - | #(INSTANCE_INIT slist) - )* - ) - ; - -ctorDef - : #(CTOR_DEF modifiers methodHead (slist)?) - ; - -methodDecl - : #(METHOD_DEF modifiers typeSpec methodHead) - ; - -methodDef - : #(METHOD_DEF modifiers typeSpec methodHead (slist)?) - ; - -variableDef - : #(VARIABLE_DEF modifiers typeSpec variableDeclarator varInitializer) - ; - -parameterDef - : #(PARAMETER_DEF modifiers typeSpec IDENT ) - ; - -objectinitializer - : #(INSTANCE_INIT slist) - ; - -variableDeclarator - : IDENT - | LBRACK variableDeclarator - ; - -varInitializer - : #(ASSIGN initializer) - | - ; - -initializer - : expression - | arrayInitializer - ; - -arrayInitializer - : #(ARRAY_INIT (initializer)*) - ; - -methodHead - : IDENT #( PARAMETERS (parameterDef)* ) (throwsClause)? - ; - -throwsClause - : #( "throws" (identifier)* ) - ; - -identifier - : IDENT - | #( DOT identifier IDENT ) - ; - -identifierStar - : IDENT - | #( DOT identifier (STAR|IDENT) ) - ; - -slist - : #( SLIST (stat)* ) - ; - -stat: typeDefinition - | variableDef - | expression - | #(LABELED_STAT IDENT stat) - | #("if" expression stat (stat)? ) - | #( "for" - #(FOR_INIT (variableDef | elist)?) - #(FOR_CONDITION (expression)?) - #(FOR_ITERATOR (elist)?) - stat - ) - | #("while" expression stat) - | #("do" stat expression) - | #("break" (IDENT)? ) - | #("continue" (IDENT)? ) - | #("return" (expression)? ) - | #("switch" expression (caseGroup)*) - | #("throw" expression) - | #("synchronized" expression stat) - | tryBlock - | slist // nested SLIST - // uncomment to make assert JDK 1.4 stuff work - | #("assert" expression (expression)?) - | EMPTY_STAT - ; - -caseGroup - : #(CASE_GROUP (#("case" expression) | "default")+ slist) - ; - -tryBlock - : #( "try" slist (handler)* (#("finally" slist))? ) - ; - -handler - : #( "catch" parameterDef slist ) - ; - -elist - : #( ELIST (expression)* ) - ; - -expression - : #(EXPR expr) - ; - -expr: #(QUESTION expr expr expr) // trinary operator - | #(ASSIGN expr expr) // binary operators... - | #(PLUS_ASSIGN expr expr) - | #(MINUS_ASSIGN expr expr) - | #(STAR_ASSIGN expr expr) - | #(DIV_ASSIGN expr expr) - | #(MOD_ASSIGN expr expr) - | #(SR_ASSIGN expr expr) - | #(BSR_ASSIGN expr expr) - | #(SL_ASSIGN expr expr) - | #(BAND_ASSIGN expr expr) - | #(BXOR_ASSIGN expr expr) - | #(BOR_ASSIGN expr expr) - | #(LOR expr expr) - | #(LAND expr expr) - | #(BOR expr expr) - | #(BXOR expr expr) - | #(BAND expr expr) - | #(NOT_EQUAL expr expr) - | #(EQUAL expr expr) - | #(LT expr expr) - | #(GT expr expr) - | #(LE expr expr) - | #(GE expr expr) - | #(SL expr expr) - | #(SR expr expr) - | #(BSR expr expr) - | #(PLUS expr expr) - | #(MINUS expr expr) - | #(DIV expr expr) - | #(MOD expr expr) - | #(STAR expr expr) - | #(INC expr) - | #(DEC expr) - | #(POST_INC expr) - | #(POST_DEC expr) - | #(BNOT expr) - | #(LNOT expr) - | #("instanceof" expr expr) - | #(UNARY_MINUS expr) - | #(UNARY_PLUS expr) - | primaryExpression - ; - -primaryExpression - : IDENT - | #( DOT - ( expr - ( IDENT - | arrayIndex - | "this" - | "class" - | #( "new" IDENT elist ) - | "super" - ) - | #(ARRAY_DECLARATOR typeSpecArray) - | builtInType ("class")? - ) - ) - | arrayIndex - | #(METHOD_CALL primaryExpression elist) - | ctorCall - | #(TYPECAST typeSpec expr) - | newExpression - | constant - | "super" - | "true" - | "false" - | "this" - | "null" - | typeSpec // type name used with instanceof - ; - -ctorCall - : #( CTOR_CALL elist ) - | #( SUPER_CTOR_CALL - ( elist - | primaryExpression elist - ) - ) - ; - -arrayIndex - : #(INDEX_OP expr expression) - ; - -constant - : NUM_INT - | CHAR_LITERAL - | STRING_LITERAL - | NUM_FLOAT - | NUM_DOUBLE - | NUM_LONG - ; - -newExpression - : #( "new" type - ( newArrayDeclarator (arrayInitializer)? - | elist (objBlock)? - ) - ) - - ; - -newArrayDeclarator - : #( ARRAY_DECLARATOR (newArrayDeclarator)? (expression)? ) - ; diff --git a/build/build.xml b/build/build.xml new file mode 100644 index 000000000..d4b470617 --- /dev/null +++ b/build/build.xml @@ -0,0 +1,445 @@ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + ======================================================= + Arduino for Mac OS X can only be built on Mac OS X. + + Bye. + ======================================================= + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + ======================================================= + Arduino for Mac OS X was built. Grab the image from + + macosx/arduino-${version}.dmg + ======================================================= + + + + + + + + + + + + + + + ======================================================= + Arduino for Linux can only be built on on unix systems. + + Bye. + ======================================================= + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + ======================================================= + Arduino for Linux was built. Grab the archive from + + build/linux/arduino-${version}.tgz + ======================================================= + + + + + + + + + + + + + + + ======================================================= + Processing for Windows can only be built on windows. + + Bye. + ======================================================= + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + ======================================================= + Processing for Windows was built. Grab the archive from + + windows/processing-${version}.zip + windows/processing-${version}-expert.zip + ======================================================= + + + + + + + + + + + + diff --git a/build/macosx/template.app/Contents/Info.plist b/build/macosx/template.app/Contents/Info.plist new file mode 100755 index 000000000..9cabd308e --- /dev/null +++ b/build/macosx/template.app/Contents/Info.plist @@ -0,0 +1,103 @@ + + + + + CFBundleName + Arduino + + CFBundleAllowMixedLocalizations + true + CFBundleExecutable + JavaApplicationStub + CFBundleDevelopmentRegion + English + CFBundlePackageType + APPL + CFBundleSignature + Pde1 + CFBundleInfoDictionaryVersion + 6.0 + CFBundleIconFile + processing.icns + CFBundleIdentifier + cc.arduino.Arduino + CFBundleDocumentTypes + + + CFBundleTypeExtensions + + pde + java + + CFBundleTypeIconFile + pde.icns + CFBundleTypeName + Processing Source File + CFBundleTypeMIMETypes + + text/plain + + CFBundleTypeOSTypes + + TEXT + + CFBundleTypeRole + Editor + + + Java + + VMOptions + + -Xms128M + -Xmx256M + + + MainClass + processing.app.Base + + JVMVersion + 1.5* + + ClassPath + + $JAVAROOT/pde.jar:$JAVAROOT/core.jar:$JAVAROOT/antlr.jar:$JAVAROOT/ecj.jar:$JAVAROOT/registry.jar:$JAVAROOT/quaqua.jar:$JAVAROOT/oro.jar:$JAVAROOT/RXTXcomm.jar + + JVMArchs + + + i386 + ppc + + + + Properties + + + javaroot + $JAVAROOT + + + apple.laf.useScreenMenuBar + true + + apple.awt.showGrowBox + false + com.apple.smallTabs + true + apple.awt.Antialiasing + false + apple.awt.TextAntialiasing + true + com.apple.hwaccel + true + apple.awt.use-file-dialog-packages + false + apple.awt.graphics.UseQuartz + true + + + + diff --git a/build/macosx/template.app/Contents/MacOS/JavaApplicationStub b/build/macosx/template.app/Contents/MacOS/JavaApplicationStub new file mode 100755 index 0000000000000000000000000000000000000000..081f15fdaa9f6439d39c063caed620fd0cabd4c2 GIT binary patch literal 34128 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 literal 0 HcmV?d00001 diff --git a/build/macosx/template.app/Contents/Resources/Java/libquaqua64.jnilib b/build/macosx/template.app/Contents/Resources/Java/libquaqua64.jnilib new file mode 100755 index 0000000000000000000000000000000000000000..7e3a3cf38b2a279f60e629bcb18dcc62c31a2d55 GIT binary patch literal 140944 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 z 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 VqZo8=@*e7nW1#H_VLy!D|1av<0RR91 literal 0 HcmV?d00001 diff --git a/build/macosx/template.app/Contents/Resources/Java/librxtxSerial.jnilib b/build/macosx/template.app/Contents/Resources/Java/librxtxSerial.jnilib new file mode 100755 index 0000000000000000000000000000000000000000..b15dfa5e8772b7272e6fabd11b689a4939827924 GIT binary patch literal 271860 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∈goUx6EP4bU9Ep>_BUhwpcI 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

    3*q_-;WH?Eq(xe&`0-TK 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

    F`u!fEQV|Xx!w@+}_E3d`P2>=~T{i%vi6` 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 z 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±-c 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

    F2o=UotxUF&zUc`S;VSv~)x&rvu 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