PROCESSING 3.0b4 (REV 0242) - 17 August 2015

Fixes for several long-standing bugs, plus some internal changes 
to make the code slightly more usable by contributors. 

For Tool and Mode developers, several functions have moved out of 
processing.app.Base and into the Messages and Platform classes.
For instance, Base.isWindows() has moved to Platform.isWindows()
(seems almost logical, right?) We're not keeping deprecated versions
of these functions around since we're breaking other things in 3.0.

Library/Mode/Tool authors, there's a section for you at the end of
this page: https://github.com/processing/processing/wiki/Changes-in-3.0
If there's anything that's not covered properly, please file an issue:
https://github.com/processing/processing/issues/new

Meanwhile, Jakub Valtar is holed up at Fathom in Boston, fixing all of
the bugs. See "your contributions are funding graphics fixes," below.


[ bug fixes ] 

+ Fix NullPointerException with some sketches that have no size() command
  https://github.com/processing/processing/issues/3585

+ Fix reports of invalid OS X code signature on some machines
  https://github.com/processing/processing/issues/3575

+ Canceling "create folder, move sketch, and continue?" will cause crash
  https://github.com/processing/processing/issues/3586

+ Move Platform into its own class, also Messages and others
  https://github.com/processing/processing/issues/2765

+ dataPath() not working when app is not run from app dir on Linux
  https://github.com/processing/processing/issues/2195

+ "Zero length string passed to TextLayout constructor" message
  https://github.com/processing/processing/issues/3487

+ improve speed of text(x, y, w, h) when using large strings with no spaces
  https://github.com/processing/processing/issues/211

+ filter(PShader) was broken in HDPI mode
  https://github.com/processing/processing/issues/3577

+ Ctrl+R (Cmd+R) not restarting sketch when debug is enabled.
  Hitting Run while a sketch is running should restart the sketch.
  https://github.com/processing/processing/issues/3623


[ api/implementation changes ] 

+ Several platform-oriented features have moved to Platform
  i.e. Platform.isWindows(), Platform.openURL(), Platform.getJavaPath()

+ Base.showXxxx() and Base.log() have moved to Messages.showXxxx()

+ Make fields and functions in PdeKeywords protected
  https://github.com/processing/processing/issues/2383

+ Added "EditorException", which is thrown when loading bad sketches

+ Pass command line arguments to sketches with processing-java
  https://github.com/processing/processing/issues/2552

+ Implement add(x, y) and sub(x, y) in PVector
  https://github.com/processing/processing/issues/3593

+ Add method to JavaMode for search path
  https://github.com/processing/processing/pull/3648


[ google summer of code ]

+ Second round of arm patches (v5)
  https://github.com/processing/processing/pull/3583

+ Third bunch of arm patches
  https://github.com/processing/processing/pull/3622

+ Contribution Manager GUI updates
  https://github.com/processing/processing/pull/3596

+ Sorting CM by the author name inplemented
  https://github.com/processing/processing/pull/3615

+ CM needs minimum window size enforced
  https://github.com/processing/processing/issues/3600
  https://github.com/processing/processing/pull/3607

+ Deactivate install button when incompatible
  https://github.com/processing/processing/issues/3603
  https://github.com/processing/processing/pull/3611

+ CM "Updates" badge appears even when there are no updates
  https://github.com/processing/processing/issues/3597
  https://github.com/processing/processing/pull/3625

+ Ignore accented characters when filtering in the CM
  https://github.com/processing/processing/issues/3627
  https://github.com/processing/processing/pull/3633

+ Enable arrow keys for navigating lists in the CM
  https://github.com/processing/processing/issues/3610
  https://github.com/processing/processing/pull/3631

+ CM filter input glitchy
  https://github.com/processing/processing/issues/3612
  https://github.com/processing/processing/pull/3630

+ Set font correctly in Contribution Manager dialog
  https://github.com/processing/processing/issues/3601
  https://github.com/processing/processing/pull/3626


[ fixed earlier, spring cleaning ]

+ Closing the color selector makes things freeze (only Linux and Windows?)
  https://github.com/processing/processing/issues/2381

+ Comment/Uncomment should ignore leading whitespace
  https://github.com/processing/processing/issues/1961

+ Export unsaved sketch > agree to save prompt > export doesn't finish
  https://github.com/processing/processing/issues/2724

+ Add disconnectEvent() to Server 
  https://github.com/processing/processing/issues/2133

+ False positive for mixing active/static mode in Tweak Mode 3.0 alpha 5
  https://github.com/processing/processing/issues/3140

+ Determine shortcut for Export vs Use Selection for Find
  https://github.com/processing/processing/issues/2985

+ PDE erroneously detects changes in non-sketch files
  https://github.com/processing/processing/issues/2759

+ Proper handling of sketchPath() for OS X in exported apps
  https://github.com/processing/processing/issues/2181

+ textWidth() incorrect with default (JAVA2D) renderer and default font
  https://github.com/processing/processing/issues/2175

+ Error on size() when using FX2D due to stage inset issues
  https://github.com/processing/processing/issues/3412


[ your contributions are funding graphics fixes ]

+ Remove alpha filler (hopefully no regression here)
  https://github.com/processing/processing/pull/3523

+ Huge Java2D blending patch
  https://github.com/processing/processing/pull/3592

+ Accuracy problems make alpha channel go to FE with image.copy()
  https://github.com/processing/processing/issues/258

+ Fix blue-channel bias on blend()
  https://github.com/processing/processing/issues/514

+ Improve blend() accuracy when using ADD
  https://github.com/processing/processing/issues/172

+ Upgrade OpenGL (remove support for fixed-function pipeline)
  https://github.com/processing/processing/issues/3505
  https://github.com/processing/processing/pull/3604
  https://github.com/processing/processing/pull/3605
  https://github.com/processing/processing/pull/3606
  https://github.com/processing/processing/pull/3628

+ Improve OpenGL extensions checks on OS X
  https://github.com/processing/processing/pull/3646

PROCESSING 3.0b3 (REV 0241) - 11 August 2015

You get a beta! YOU get a beta! *YOU* get a beta! Everybody gets a beta!


[ bug fixes & changes ] 

+ Prevent 'examples' from showing as a folder in the sketchbook window
  (instead only show it in the Examples window)

+ Don't show breakpoints when debugger is off
  https://github.com/processing/processing/issues/3093

+ No setting breakpoints when debugger is off
  https://github.com/processing/processing/issues/3306

+ Foundation library examples should appear under "Core" or "Foundation"
  https://github.com/processing/processing/issues/3524

+ Use ctrl-pageup/down on Linux for prev/next tab
  https://github.com/processing/processing/issues/3416

+ Library names not showing up correctly ("pdf" instead of "PDF Export")
  https://github.com/processing/processing/issues/3574

+ Contributed Examples were using their folder name, not the 'name' field 
  from their properties file when shown in the Examples window.

+ Include name of sketch when asking user "Save sketch before closing?"
  Did i18n changes for OS X and other platforms, though some languages
  will need additional updates to be compatible.
  https://github.com/processing/processing/issues/3418

+ Modify naming of contributed examples
  https://github.com/processing/processing/issues/3573

+ Show a warning when map() prints a bad value
  https://github.com/processing/processing/issues/3314

+ Implement a nf(float) function to support the changes in map()

+ Breakpoints don't 'jump' after hitting Enter on blank line
  https://github.com/processing/processing/issues/3552
  https://github.com/processing/processing/pull/3571

+ Implement focusGained(), focusLost(), and 'focused' variable in P2D/P3D
  https://github.com/processing/processing/issues/3564

+ IndexOutOfBoundsException with pixelDensity(2) and P2D
  https://github.com/processing/processing/issues/3568

+ Shaders output to bottom left corner rather than full window in 3.0b2
  https://github.com/processing/processing/issues/3572

PROCESSING 3.0b2 (REV 0240) - 9 August 2015

Several delicious bug fixes to repair things that cropped up in the first
beta release. Please keep the reports & code coming and help us get to 3.0.


[ bug fixes ]

+ "Add Library..." fails with "Could not write to temporary directory"
  https://github.com/processing/processing/issues/3548

+ Make size(displayWidth, displayHeight) still run in a window.
  Fixes "fullScreen() cannot be used here" message on startup.
  https://github.com/processing/processing/issues/3545
  In the past we were auto-detecting if it was the screen size, 
  and switching to full screen mode. But that's now removed because
  fullScreen() is so easy, and full screen may not be wanted.

+ Cannot find "processing.core" library. Line 12 in tab sketch_150704a"
  also happens with "import to com.jogamp.opengl.GL2"
  https://github.com/processing/processing/issues/3547
  Code still ran properly, but looked like errors in the editor.

+ Remove "pair is" debug messages from Welcome screen

+ Save Export to Application settings between uses

+ Fix NullPointerException in setVertex()
  https://github.com/processing/processing/pull/3553
  https://github.com/processing/processing/issues/3550

+ Toggling between noLights and PointLight in draw() behaving strangely
  https://github.com/processing/processing/issues/3546

+ NullPointerException in Planets demo
  https://github.com/processing/processing/issues/3551

+ Late breaking fix to repair Tweak mode
  https://github.com/processing/processing/issues/3562
  https://github.com/processing/processing/pull/3563


[ changes and improvements ]

+ Show contributed examples in the Examples window
  https://github.com/processing/processing/issues/3420

+ Initialize the Find dialog with the current selection
  https://github.com/processing/processing/issues/3457

+ Disable Export button when no platforms selected. In previous releases,
  it would report "done exporting!" but nothing had actually happened.

+ Prevent Export with examples and untitled/unsaved sketches

+ Links in error bar are not selectable nor clickable
  https://github.com/processing/processing/issues/3471


[ internal/development fixes ]

+ Building: make the download-jdk-macosx target work properly

+ Throw an error when using methods that require sketchPath outside setup()
  https://github.com/processing/processing/issues/3433

+ Cleaned up the advanced OpenGL wiki page

+ cursor(CROSS) breaks when using surface.setTitle()
  https://github.com/processing/processing/issues/3472


[ fixed earlier ]

+ blend() and copy() are not pixel accurate for copy/scale
  https://github.com/processing/processing/issues/324
  Fixed somewhere between 0179 and 0184

PROCSSING 3.0b1 (REV 0239) - 6 August 2015

This is the big one! The first beta, which will now be the default download
on the site. That means we think this is the best release of Processing that's
currently available, and that nearly everyone should be using it. It doesn't
mean we've worked out all the bugs just yet, but hey, who has?

A still-in-progress rundown of the changes in Processing 3 is here:
https://github.com/processing/processing/wiki/Changes-in-3.0

2.x Modes, Tools, and Libraries will need to be updated for 3.x, so if you're
an author of these, see the notes in the link above. We're also planning some
sort of online Q & A / office hours / talk to Ben about what's changed session
to help folks along. We want to help, we just need to find the time.

And for those into the nitty gritty, or who enjoy lame jokes about esoteric 
technical details, the detailed changes since 3.0 alpha 11 are below.


[ bug fixes ] 

+ The new Welcome screen! was... completely broken
  https://github.com/processing/processing/issues/3474

+ StringIndexOutOfBoundsException while preprocessing
  https://github.com/processing/processing/issues/3531

+ Run/Stop/Debug buttons do not fire if the mouse moves during the click
  https://github.com/processing/processing/issues/3529

+ Some contributions were listed multiple times
  https://github.com/processing/processing/issues/3353

+ Do not filter Ctrl+Alt+? out as menu mnemonics
  https://github.com/processing/processing/issues/3536
  https://github.com/processing/processing/pull/3537

+ Fix delete tab shortcut in toolbar popup
  https://github.com/processing/processing/pull/3535

+ Deleted tab still present in tab menu
  https://github.com/processing/processing/issues/3534
  https://github.com/processing/processing/pull/3542
  https://github.com/processing/processing/pull/3541

+ Make PFont.size protected again
  https://github.com/processing/processing/issues/3519

+ Tweak implementation of PVector.heading()
  https://github.com/processing/processing/issues/3511

+ Fix problem with JAR loading inside createInputRaw()
  https://github.com/processing/processing/pull/3514


[ changes, because not everything is a bug ] 

+ Add new console/errors icons to the tabs in the footer

+ Get images working in the Welcome screen
  https://github.com/processing/processing/issues/3494

+ Add getSurface() method ('surface' is protected in PApplet)

+ Remove 'contrib updates available' dialog box for now. A new version
  is coming soon that will be better-integrated with the editor.


[ internal changes you'll probably never notice ] 

+ Add message that says it's safe to ignore the tools.jar warning

+ Add "git pull" on processing-docs for "dist" target

+ Update to launch4j 3.8


[ contributions by our fine community ] 

+ Fix contribution compatibility check
  https://github.com/processing/processing/pull/3479

+ Update Spanish translation
  https://github.com/processing/processing/pull/3480

+ Fix bug with tab sorting when adding new tabs
  https://github.com/processing/processing/pull/3540
  https://github.com/processing/processing/issues/3099


[ this summer, Google's paying folks to stay indoors & work on Processing ]

+ CM updates dialog box doesn't open CM
  https://github.com/processing/processing/issues/3481
  https://github.com/processing/processing/pull/3489

+ Adding CM ellipses only when text is long
  https://github.com/processing/processing/pull/3470

+ Include mode imports when rewriting .properties file
  https://github.com/processing/processing/pull/3499
  https://github.com/processing/processing/issues/3492

+ Assortment of patches from gohai's arm-3.0 branch
  https://github.com/processing/processing/pull/3522


[ Jakub joins Andres in a battle of wits and test of wills against OpenGL ] 

+ Implement depth sorting! Use hint(ENABLE_DEPTH_SORT) and say goobye
  to your 3D transparency woes! 
  https://github.com/processing/processing/issues/90
  https://github.com/processing/processing/issues/2235
  https://github.com/processing/processing/pull/3507
  https://github.com/processing/processing/pull/3477
  https://github.com/processing/processing/pull/3410
  https://github.com/processing/processing/pull/3372

+ Remove size() from setup() when copying to settings()
  https://github.com/processing/processing/pull/3517

+ Remove mode parameters from createShape(), fixes parameter collision issues
  https://github.com/processing/processing/pull/3516

+ Radius for rect not working on PShape
  https://github.com/processing/processing/issues/2646

+ Bug in arc with createShape()
  https://github.com/processing/processing/issues/3018

+ OpenGL sketch flickers when draw() is missing or empty
  https://github.com/processing/processing/issues/3473
  https://github.com/processing/processing/pull/3521

+ size() errors
  https://github.com/processing/processing/issues/3483

+ rect() with stroke outline renders 1px wider and taller in P2D
  behavior is correct, explanation provided
  https://github.com/processing/processing/issues/2065
  https://github.com/processing/processing/issues/2065

+ setVertex() not working in P3D and P2D
  https://github.com/processing/processing/issues/3022
  https://github.com/processing/processing/pull/3528

+ Add hint(ENABLE_BUFFER_READING) to handle stencil/depth buffers
  https://github.com/processing/processing/pull/3527
  https://github.com/processing/processing/issues/2771

+ ArrayIndexOutOfBoundsException error when enabling depth sorting in P3D
  https://github.com/processing/processing/pull/3477
  https://github.com/processing/processing/issues/3476

+ Fix curves - properly this time
  https://github.com/processing/processing/pull/3501

+ Remove duplicate curve vertex
  https://github.com/processing/processing/pull/3496
  https://github.com/processing/processing/issues/2937

+ JOGL window size is now set properly
  https://github.com/processing/processing/pull/3493
  https://github.com/processing/processing/issues/3223

+ Device parsing on Linux is incorrect, causing "display 1 doesn't exist" msg
  https://github.com/processing/processing/issues/3532

+ Flush geometry when lighting changes, otherwise lights apply to entire scene
  https://github.com/processing/processing/issues/3533

PROCESSING 3.0a11 (REV 0238) - 16 July 2015

Hopefully the last release before we go to beta. 


[ new additions ]

+ You'll be greeted by a Welcome screen. We haven't finished the text for
  one of these yet, so you'll see some lorem ipsum (fake) text instead.
  We'll wrap that up before the beta release.
  https://github.com/processing/processing/issues/3358


[ breaking all of the things ]

+ For Tool and Mode authors, you'll need to make some (small) changes.
  These aren't structural, but will require a rebuild of your code.
  Our hope is that this will be the last round of changes for the 3.x
  series, and that it's now safe to update your Modes and Tools to be
  compatible with the final 3.x release. Changes in this release:

  - Several classes have been moved to a new processing.app.ui package.
    The processing.app package was much too unwieldy and made it difficult
    for people to hack on the PDE code.

  - Several functions have moved out of Base and into Util (or Toolkit).
    Most of these are file-related (removeDir() and others), but the
    Base class had simply grown to a ridiculous size. It remains enormous
    but is a little less ridiculous.

+ Removed the init() method from PApplet; it's no longer needed


[ fixing all of the things ]

+ Show warning when display spanning is turned off with fullScreen(SPAN)
  https://github.com/processing/processing/issues/3381

+ Add note about headless exceptions that points to Github

+ Resize children[] so that getChildren() returns a correctly-sized array
  https://github.com/processing/processing/issues/3347

+ clear() was broken (maybe related to #3317)
  https://github.com/processing/processing/issues/3378

+ PGraphic ignores PNG transparency (regression from 3.0a5, same as #3378)
  https://github.com/processing/processing/issues/3317

+ Move error messages out of PConstants

+ Remove launch(String) since it was calling itself, and anachronistic

+ Sketches with new fullScreen() method should grab focus by default
  https://github.com/processing/processing/issues/3380

+ Sketches not getting focus with Java2D
  https://github.com/processing/processing/issues/3389

+ draw() executes twice when noLoop() called in setup()
  https://github.com/processing/processing/issues/3310

+ displayDensity() not functioning properly
  https://github.com/processing/processing/issues/3436

+ surface.setXxx() handling
  https://github.com/processing/processing/issues/3388
  Methods for setResizable(), setVisible(), setTitle(), setIconImage()

+ Add the "don't use this" warning to the JFrame in PSurfaceAWT

+ ArithmeticException: / by zero when using fonts opened with loadFont()
  https://github.com/processing/processing/issues/3413

+ SVG briefly broken for Java2D
  https://github.com/processing/processing/issues/3417

+ Change how font metrics are pulled to fix text width issues

+ Check alpha when image extension is "unknown"
  https://github.com/processing/processing/issues/3442

+ Add support for more Image types (BGR) with PImage(java.awt.Image)

+ Move Java2D and JavaFX classes to their own packages


[ multithreading is hard ] 

+ Sketch not always showing with empty draw()
  https://github.com/processing/processing/issues/3363

+ Static mode broken with Java2D on Windows and Linux
  https://github.com/processing/processing/issues/3315

+ Sketch sometimes doesn't show with noLoop() on Linux
  https://github.com/processing/processing/issues/3316

+ Window never shows with exported application on 64-bit Linux
  https://github.com/processing/processing/issues/3303

+ Fix presentation mode

+ Re-enable the display menu in Preferences after display added
  Previously, the checkbox menu stayed disabled (though it updated the list)

+ sketch.isReadOnly returns false for examples coming from multiple modes
  https://github.com/processing/processing/issues/773

+ Drag and Drop & "Add File" broken for .pde files in 3.0a10
  https://github.com/processing/processing/issues/3383

+ Show "not compatible" error message in the manager
  https://github.com/processing/processing/issues/3386

+ Add more code for handling low-level errors on startup

+ Update the "Supported Platforms" wiki page with current status

+ displayDensity() not functioning properly
  https://github.com/processing/processing/issues/3436

+ Error message caused by curly bracket in a println string
  https://github.com/processing/processing/issues/3394

+ Tweak mode broken (re: new settings() function)
  https://github.com/processing/processing/issues/3435

+ Add build.xml prompt for OS X developers to download the JDK update


[ contribution manager ] 

+ Change the .properties file syntax a little bit:
  compatibleModesList -> modes
  authorList -> authors
  category -> categories

+ Send list of installed Libraries, Modes, Tools, and Examples on update
  https://github.com/processing/processing/issues/3365

+ Disable contrib manager updates when "check for updates" is turned off
  in Preferences. Also updated the FAQ to cover the changes.


[ pull requests, summer of code, and other community help ]

+ Use correct localized strings in JavaEditor.java
  https://github.com/processing/processing/pull/3376

+ Dim edit menus as appropriate during selection/no selection/etc
  https://github.com/processing/processing/issues/53
  https://github.com/processing/processing/pull/3419

+ Internationalize MovieMaker.java
  https://github.com/processing/processing/pull/3424

+ Auto-completion does not seem to be working
  https://github.com/processing/processing/issues/3111

+ Re-enable export to application with command line
  https://github.com/processing/processing/pull/3451
  https://github.com/processing/processing/issues/2760

+ Change undefined constructor error message for clarity
  https://github.com/processing/processing/issues/3434

+ Mode problems window wasn't doing line breaks
  https://github.com/processing/processing/issues/3369
  https://github.com/processing/processing/pull/3370

+ Add missing internationalization in app/Sketch.java
  https://github.com/processing/processing/pull/3392

+ Examples window shows contributed examples
  https://github.com/processing/processing/pull/3421
  https://github.com/processing/processing/pull/3421

+ Reworking the Contribution Manager according to Scott's redesign
  https://github.com/processing/processing/pull/3423

+ Finish adding 'examples' contribs
  https://github.com/processing/processing/issues/2953

+ Error during installation of any contribution
  https://github.com/processing/processing/issues/3429
  https://github.com/processing/processing/pull/3438

+ Significant work by Akarshit for Google Summer of Code
  https://github.com/processing/processing/pull/3432
  https://github.com/processing/processing/pull/3452
  https://github.com/processing/processing/pull/3444
  https://github.com/processing/processing/pull/3454
  https://github.com/processing/processing/pull/3465
  https://github.com/processing/processing/pull/3468
  https://github.com/processing/processing/issues/3443

+ Fix NullPointerException in DepthSorter
  https://github.com/processing/processing/pull/3410


[ retina/hidpi fixes ] 

+ Make g.pixelDensity public inside PApplet (so accessible by sketches)

+ Add pixelWidth/Height to PApplet

+ Text looks blurry in GL Retina
  https://github.com/processing/processing/issues/2739

+ Text not getting the correct font in Retina2D
  https://github.com/processing/processing/issues/2617

+ Text is half size in PGraphicsRetina2D
  https://github.com/processing/processing/issues/2738


[ andres loves opengl ] 

+ Add attrib() method
  https://github.com/processing/processing/issues/2963

+ The ortho() function seems broken
  https://github.com/processing/processing/issues/1278

+ Errors with loading SVGs in P3D/P2D
  https://github.com/processing/processing/issues/3379

+ Sketch window briefly appears on top left corner when using OpenGL
  https://github.com/processing/processing/issues/3308

+ beginShape(POINTS) don't show up in P2D
  https://github.com/processing/processing/issues/3029


[ fixed earlier ]

+ Sketch window is not placed at correct location when running a second time
  https://github.com/processing/processing/issues/3125

+ Full screen needs to ignore prev location setting for frame?
  https://github.com/processing/processing/issues/3305

+ save() and saveFrame() with 2X renderers fails
  https://github.com/processing/processing/issues/3255

+ NPE when using image() created with createGraphics(PGraphicsRetina2D)
  https://github.com/processing/processing/issues/2510

+ Closing OpenGL sketch from the PDE doesn't stop java.exe process
  https://github.com/processing/processing/issues/2335

PROCESSING 3.0a10 (REV 0237) - 9 June 2015

Huge release! Knocking on the door for beta, this includes many changes
and improvements for how displays of all kinds (single, multiple, retina, 
high dpi) are handled, plus smoothing, full screen, etc etc. 


[ breaking things for the future ] 

+ Added fullScreen() method to make it far easier to run sketches 
  using the full screen. Reference notes and explanation here:
  https://github.com/processing/processing-docs/issues/250
  https://github.com/processing/processing/issues/3296

+ smooth() and noSmooth() can only be used once per sketch, in setup().
  See the changes, the explanation, and the discussion here:
  https://github.com/processing/processing-docs/issues/251
  https://github.com/processing/processing/issues/3357

+ Re-opened the Gates of Hell by adding chaining operations to PVector
  https://github.com/processing/processing/issues/257

+ Changed exec() and open() to use varargs. Changed open() to launch()
  to prevent problems with Python Mode.

+ Replaced --full-screen command line option with --present to untangle
  full screen versus the "Present" command that places blanks the rest
  of the screen around a sketch.

+ ortho() function is being reworked to make it compliant
  https://github.com/processing/processing/issues/1278


[ other changes and additions ]

+ Added new application and export icons. Mmm!

+ Add retina/high-res display support to OpenGL
  https://github.com/processing/processing/issues/2573

+ Add pixelDensity(2) command to enable retina or high-dpi mode for
  your sketch. Make things look beautiful and crisp on expensive hardware!
  https://github.com/processing/processing/issues/3361

+ Added displayDensity() methods to get the pixel density for individual
  displays. displayDensity() returns the density (1 or 2) of the default
  (or currently selected) display, displayDensity(1) returns the density
  of display 1. Guess how you get the density of display 2?

+ Add useful constructors to the Int/Float/StringList classes


[ bug fixes ]

+ Fix monitor numbering problems
  https://github.com/processing/processing/issues/3309

+ Full screen doesn't work on second window w/o present mode
  https://github.com/processing/processing/issues/3271

+ Full screen on OS X 10.9 has incorrect placement
  https://github.com/processing/processing/issues/3305

+ "Run sketches on display" not working properly
  https://github.com/processing/processing/issues/3264

+ Comments influencing code (preproc issues in parsing)
  https://github.com/processing/processing/issues/3326

+ Sketch not appearing depending on arangement of external display on OS X
  https://github.com/processing/processing/issues/3118

+ Sketch launching on second display that's not currently in use
  https://github.com/processing/processing/issues/3082

+ strokeWeight() in setup() not working for default renderer
  https://github.com/processing/processing/issues/3331

+ Retain original java.awt.Frame when it's available from PSurfaceAWT

+ Set frame icon images for Java2D (dock and cmd-tab) 
  https://github.com/processing/processing/issues/257

+ Debug message showing up in 3.0a9 when dragging and dropping files

+ Rolled back to 3.0a5 version of appbundler due to crash on startup
  https://github.com/processing/processing/issues/3359
  https://github.com/processing/processing/issues/3360
  This re-introduces a few bugs related to the serial library and 
  scrolling and any other changes later than 16 November 2015
  https://github.com/processing/processing/commits/master/build/macosx/appbundler.jar
  https://github.com/processing/processing/commits/master/build/macosx/appbundler/native/main.m


[ andres vs opengl, episode eleventy three ]

+ set(0, 0, image) does not set alpha channel to opaque in P2D/P3D
  https://github.com/processing/processing/issues/2125

+ GROUP shapes are broken in 3.0a9
  https://github.com/processing/processing/issues/3336

+ Only a quarter of the sketch is appearing in 2x mode
  https://github.com/processing/processing/issues/3332
  https://github.com/processing/processing/issues/3327

+ Single transparent pixel at end of textures in OpenGL
  https://github.com/processing/processing/issues/115

+ Implement setImpl() instead of set() inside PGraphicsOpenGL
  https://github.com/processing/processing/issues/160
  https://github.com/processing/processing/issues/3012

+ Strange extra lines with PShape 3D
  https://github.com/processing/processing/issues/3006

+ BACKSPACE key is identified as DELETE in OpenGL renderers
  https://github.com/processing/processing/issues/3338

+ More key issues in OpenGL 
  https://github.com/processing/processing/issues/3352

+ Set icon for OpenGL windows
  https://github.com/processing/processing/issues/3348

+ save() and saveFrame() with OPENGL renderer fails
  https://github.com/processing/processing/issues/3334

+ Errors in glsl code are only caught when set() is used
  https://github.com/processing/processing/issues/2268

+ Strips when rendering spheres with lights and anti-aliasing
  https://github.com/processing/processing/issues/1185


[ valuable contributions from the community ]

+ Several Greek translation updates
  https://github.com/processing/processing/issues/3329
  https://github.com/processing/processing/pull/3330
  https://github.com/processing/processing/pull/3340
  https://github.com/processing/processing/pull/3354

+ Add i18n for Archiver Tool and missing text
  https://github.com/processing/processing/pull/3349

+ Fix case-related bugs in Toolkit.setMenuMnemonics()
  https://github.com/processing/processing/pull/3366

+ Contribution manager scroll bar only shows up when needed
  https://github.com/processing/processing/pull/3343

+ Progress bar added to Contribution Manager
  https://github.com/processing/processing/issues/3160
  https://github.com/processing/processing/pull/3319

PROCESSING 3.0a9 (REV 0236) - 19 May 2015

More work as we head toward beta. Mostly improvements to the GUI 
and fixes for many bugs. So close to beta I can practically smell it.


[ changes ] 

+ Implement more of the bottom half of the editor window GUI

+ Show screen dimensions in the Preferences window for display selector

+ Change how the variables/debug window works. Automatically 
  show the window when debugging, hide when not.
  https://github.com/processing/processing/issues/3298
  https://github.com/processing/processing/issues/3091

+ Enabling and disabling the debugger toggles the Step/Continue 
  buttons in the toolbar

+ Remove techie options from the Debug menu
  https://github.com/processing/processing/issues/3267

+ Add more visual states to the toolbar buttons

+ Lots of internal cleaning


[ bug fixes ] 

+ Implement Cmd-Q handler on Mac OS X to shut down sketches properly
  https://github.com/processing/processing/issues/3301

+ Changing "background color when Presenting" causes Exception
  https://github.com/processing/processing/issues/3299

+ displayWidth and displayHeight not set properly on startup
  https://github.com/processing/processing/issues/3295


[ andres vs. opengl, episode 7 ]

+ Offscreen rendering broken in OpenGL renderers
  https://github.com/processing/processing/issues/3292
  https://github.com/processing/processing/issues/3259

+ Initial location of OpenGL window hides the title bar
  https://github.com/processing/processing/issues/2981

+ OpenGL sketches do not terminate, have to be killed
  https://github.com/processing/processing/issues/2982

+ Quitting P3D sketch throws an error
  https://github.com/processing/processing/issues/3293


[ fixed in 3.0a8, confirmed later ] 

+ "Step" not working properly
  https://github.com/processing/processing/issues/3266

+ Cmd-click behavior on function/variable is firing when cmd-click not pressed
  https://github.com/processing/processing/issues/3242

+ Full screen window on second monitor without using present mode
  https://github.com/processing/processing/issues/3271

PROCESSING 3.0a8 (REV 0235) - 17 May 2015

Stabilizing the mess from 3.0a6 and 3.0a7. Read the release notes for
those versions (below) if you haven't already.

If you're using Eclipse or another IDE, be sure to read the "changes"
section below, for a change in how the size() command works.


[ fixes ]

+ size() sometimes erratic (i.e default size used) This was often 
  seen with large setup() functions, or on more esoteric platforms.
  https://github.com/processing/processing/issues/1672

+ Command line "processing-java" was broken
  https://github.com/processing/processing/issues/3224

+ Sketchbook window requires restart of Processing before updating
  after sketchbook location change.
  https://github.com/processing/processing/issues/3214

+ Replace & Find was reading "Find & Replace" 
  https://github.com/processing/processing/issues/3247

+ "One file added to sketch" message when two files added

+ pop() was not implemented correctly in String/Int/FloatList

+ Errors in file name case differences not correctly reported
  https://github.com/processing/processing/issues/3235

+ Single Frame (no screen display) PDF broken
  https://github.com/processing/processing/issues/3280

+ "Buffers have not been created" error for sketches w/o draw()
  https://github.com/processing/processing/issues/2469


[ changes ]

+ Behind the scenes, the size() method is now moved out of setup()
  and into a method named settings(). The settings() is called before
  setup() and is the only place where size() can be used. If using
  Processing without the PDE (i.e. with another IDE like Eclipse),
  remove the size() method from setup() and instead place it like so:

  public void settings() {
    size(400, 400, P3D);  // your size() command here
  }

  The rest of your code remains unchanged. The PDE does this 
  transparently, so 99% of people won't even notice this change.
  However, it allows us to fix (and avoid) a lot of really nasty
  complications that come from how Processing lets you switch
  between 2D drawing and OpenGL and even something like PDF with
  simple changes to the size() method.

  We're trying "settings()" as the method name, but that may change
  in a future alpha release. Once we hit beta, it will not change.

  For those familiar with them, the sketchWidth(), sketchHeight(),
  sketchRenderer(), etc methods should no longer be used. This new
  implementation of the settings() method is a simpler solution.

+ Added SVG Export library (works like PDF Export). This has not
  been tested heavily yet. 

+ Replace Tweak Mode ColorSelector with JComponent version
  https://github.com/processing/processing/issues/3209

+ Fairly major rewrite of createShape(), shouldn't affect anything,
  but keep an eye out for regressions.

+ Add new String/Int/FloatDict constructors that take an array for
  useful static/<init> initialization

+ Move svgz handling to PApplet, remove objz handling

+ Implement blendMode in FX2D
  https://github.com/processing/processing/issues/3275

+ Added StringList(Object...) constructor to handle a grab bag of objects

+ Added appendUnique() to Int/Float/StringList to only add unique items
  to a list. Replaces the following code, making "set" operations easier:
  if (!theList.hasValue(value)) {
    thiList.append(value);
  }

+ Inside main(), don't set 'args' to a zero-length array if no args 
  were passed in, instead leave 'args' null. 


[ debugger ]

+ Debugger "String is null" error when hitting breakpoint
  https://github.com/processing/processing/issues/3265

+ Change "method" to "function" in a few error messages
  https://github.com/processing/processing/issues/3225

+ Error message for incorrect function arguments is wonky
  https://github.com/processing/processing/issues/3268

+ String concatenation mistakes produce odd error messages
  https://github.com/processing/processing/issues/3253


[ contributed fixes ]

+ Window size not passing into Tweak Mode
  https://github.com/processing/processing/issues/3208
  https://github.com/processing/processing/pull/3227

+ Keep the tab menu at the right-hand side
  https://github.com/processing/processing/pull/3236

+ "Your sketch has been modified externally..." appears erroneously
  https://github.com/processing/processing/issues/3222

+ Prevent breakpoints from causing a reload prompt
  https://github.com/processing/processing/pull/3263

+ Added buffer to file detection time
  https://github.com/processing/processing/pull/3262


[ akarshit contributions ]

+ Preferences window fixes for Linux
  https://github.com/processing/processing/pull/3232
  https://github.com/processing/processing/issues/3231

+ Clear error message in Contribution Manager after retrying
  https://github.com/processing/processing/pull/3240
  https://github.com/processing/processing/issues/3239

+ Add SOCKS proxy support to the PDE
  https://github.com/processing/processing/issues/2643
  https://github.com/processing/processing/pull/3260

+ Use system proxy by default
  https://github.com/processing/processing/issues/1476
  https://github.com/processing/processing/pull/3251


[ opengl by andres ]

+ Moved back to JOGL instead of LWJGL for OpenGL
  https://github.com/processing/processing/blob/master/core/README.md

+ OpenGL sketches work only after running a sketch with default renderer
  https://github.com/processing/processing/issues/3218

+ static mode - no setup() / draw() - broken in OpenGL
  https://github.com/processing/processing/issues/3163

+ Deal with some performance issues
  https://github.com/processing/processing/issues/3210

+ Can't run sketches with offscreen PGraphics
  https://github.com/processing/processing/issues/3259

PROCESSING 3.0a7 (REV 0234) - 26 April 2015

Read the notes in 3.0a6 for major changes! This is only a minor bug fix
release to take care of a few things that were broken in 3.0a6.


[ fixes ] 

+ Fix bug that prevented the Preferences window from opening
  https://github.com/processing/processing/issues/3215

+ Install/remove buttons not working in the Library/Mode/Tool Managers
  https://github.com/processing/processing/issues/3172

+ Preferences window elements not sized correctly in 3.0a6
  https://github.com/processing/processing/issues/3212
  https://github.com/processing/processing/pull/3217
  https://github.com/processing/processing/pull/3220

+ Fixed Find/Replace layout regressions in 3.0a6
  https://github.com/processing/processing/issues/3213
  https://github.com/processing/processing/pull/3216

+ Avoid minor memory leak in StringList.pop()


[ known issues ] 

+ OpenGL sketches work on Windows (32- and 64-bit) only after running 
  a sketch that uses the default renderer
  https://github.com/processing/processing/issues/3218

+ Other issues that are our highest priority for the next release:
  https://github.com/processing/processing/labels/critical

+ Other high priority items to be fixed before 3.0:
  https://github.com/processing/processing/issues?q=is%3Aopen+label%3Ahigh+-label%3Aenhancement

PROCESSING 3.0a6 (REV 0233) - 25 April 2015

This is the big one! We've jettisoned PApplet as the base class so that
we can improve performance, reduce flicker, and have a better base from
which to build better, more modern graphics rendering. More of the 
gory details for the PApplet/PGraphics changes can be found here:
https://github.com/processing/processing/tree/master/core

Speaking of breaking things, we're on the road to a new GUI as well:
https://github.com/processing/processing/issues/3072
and that means all Modes and some Tools will need to be updated:
https://github.com/processing/processing/issues/3080

We've also made major changes to better integrate PDE X, Tweak Mode, 
and other nice features for the default "Java" Mode. These will be the
center of the changes for 3.x, which is focused on improving the editing 
and debugging experience in general. 

Suffice to say, this is truly an ALPHA quality release. We're pushing it
out so that we can get more people testing it. If you want something more
stable, we recommend 3.0a5 (not 2.2.1, that thing is old!) 

Library/Mode/Tool authors: Please help us get 3.0 ready by getting your
code ready for 3.0! Because 2.x and 3.x contributions are separate, you
can maintain separate versions if you like (or only support 3.x). You 
can also specify the earliest and latest revisions of Processing that 
your code supports, so that it's only installed with the correct version. 
If anything is unclear, please file an issue. I've not had time to write
up all the changes yet (and some are still in progress), but what you see
in this release is representative of where we're headed for 3.0.


[ known issues ] 

The full list is here: https://github.com/processing/processing/issues/
but a few that you might be likely to run across:

+ install/remove buttons not working in the managers
  https://github.com/processing/processing/issues/3172

+ static mode - no setup() / draw() - broken in OpenGL
  https://github.com/processing/processing/issues/3163

+ sketch window is not placed at correct location when running a second time
  https://github.com/processing/processing/issues/3125


[ general fixes and changes ] 

+ Merge experimental into the main Java mode, move Java Mode to its own area

+ Deal with ctrl-alt-n regression 
  https://github.com/processing/processing/issues/2979

+ Don't add a ^M to files when writing
  https://github.com/processing/processing/issues/3014

+ Add more bulletproofing to the save process
  https://github.com/processing/processing/issues/2923

+ Text improvements for retina displays on OS X

+ Menu mnemonics (alt-f, etc) getting typed into the editor
  https://github.com/processing/processing/issues/3057

+ Opening and closing preferences window prompts user to save unmodified sketch
  https://github.com/processing/processing/issues/3074

+ Internal fixes and cleanups to TweakMode
  https://github.com/processing/processing/issues/2799

+ Implement line numbers in the editor
  https://github.com/processing/processing/issues/3128

+ Run button w/ debugger shouldn't require "continue" before actually starting
  https://github.com/processing/processing/issues/3096

+ Change how platform-specific preferences are handled

+ Auto-insert after ANTLR @SuppressWarnings({ "unused", "unchecked", "cast" })

+ "Your sketch has been modified externally" appearing on OS X
  https://github.com/processing/processing/issues/2852

+ Make sure the JRE downloads correctly before renaming
  https://github.com/processing/processing/issues/2960

+ Update build scripts for Windows and Linux to use JRE downloader Ant Task
  https://github.com/processing/processing/issues/3059

+ Moved to Java 8 because Java 7 will be discontinued
  http://www.oracle.com/technetwork/java/javase/eol-135779.html
  Requires Vista SP2 (let's just say 7), OS X 10.8.3, and Ubuntu 12.04

+ Update ECJ for Java 8 change
  http://download.eclipse.org/eclipse/downloads/drops4/R-4.4.1-201409250400/

+ Update to launch4j 3.6
  http://sourceforge.net/projects/launch4j/files/launch4j-3/3.6/


[ fixed earlier, not mentioned in revisions.txt ]

+ Move import suggestion to errors console
  https://github.com/processing/processing/issues/2947

+ Server.stop() produces an error: java.net.SocketException: socket closed
  https://github.com/processing/processing/issues/74
  https://github.com/processing/processing/pull/2474

+ NPE when calling Client.ip() after the connection has been closed
  https://github.com/processing/processing/issues/2576
  https://github.com/processing/processing/pull/2922


[ who loves pull requests? I do. ] 

+ Splash screen for Linux
  https://github.com/processing/processing/pull/3005

+ Pressing PgDn in a code without scrollbar gives Exception
  https://github.com/processing/processing/issues/2990

+ Add mnemonics for menus (alt-f to open 'file')
  https://github.com/processing/processing/issues/51
  https://github.com/processing/processing/pull/2382

+ getCaretLocation() bug in syntax.im package
  https://github.com/processing/processing/issues/2934

+ Finish up debian package support
  https://github.com/processing/processing/issues/114
  https://github.com/processing/processing/pull/2972
  https://github.com/processing/processing/issues/2973
  https://github.com/processing/processing/pull/2974

+ Replace ColorChooser PApplets with custom Swing components
  https://github.com/processing/processing/pull/2975

+ Fix encodings, line endings, and mime types in the repo
  https://github.com/processing/processing/issues/2955
  https://github.com/processing/processing/pull/2978
  https://github.com/processing/processing/pull/2977

+ Add control for dependencies (i.e. svg needs xml), needed for export
  https://github.com/processing/processing/issues/109
  https://github.com/processing/processing/pull/3010

+ Lots of Auto Format fixes
  https://github.com/processing/processing/pull/3002
  https://github.com/processing/processing/issues/2540
  https://github.com/processing/processing/issues/1041

+ Update name of sketch in the "Recent" menu
  https://github.com/processing/processing/issues/2984
  https://github.com/processing/processing/pull/3046

+ File change detection rewrite
  https://github.com/processing/processing/pull/3048
  https://github.com/processing/processing/pull/3070

+ Broken Windows build due to launch4j .jar not updated
  https://github.com/processing/processing/issues/3062
  https://github.com/processing/processing/pull/3066

+ Exported Linux sketches must be run from the sketch folder
  https://github.com/processing/processing/issues/1046
  https://github.com/processing/processing/pull/3083

+ processing.net.Server only cleans up internal Clients when trying to write
  https://github.com/processing/processing/issues/3089
  https://github.com/processing/processing/pull/3097

+ Display download percentage when fetching contribution info
  https://github.com/processing/processing/pull/3161

+ Recreating Client instance will cause an out-of-memory error
  https://github.com/processing/processing/issues/1400
  https://github.com/processing/processing/pull/3088

+ Greek translation and new fonts
  https://github.com/processing/processing/pull/3025

+ Show tooltip when hovering over errors
  https://github.com/processing/processing/pull/3119

+ Fix multi-touch horizontal scrolling on OS X
  https://github.com/processing/processing/pull/3170
  https://github.com/processing/processing/issues/180

+ Refactor examples manager window
  https://github.com/processing/processing/issues/3133
  https://github.com/processing/processing/pull/3177

+ Fix ColorChooser cursor
  https://github.com/processing/processing/pull/3186

+ Improve Spanish localization 
  https://github.com/processing/processing/pull/3185

+ Internationalization of editor error messages and Greek translations
  https://github.com/processing/processing/pull/3189

+ Improve internationalization and localization in Greek
  https://github.com/processing/processing/pull/3197

+ Fix for "Probably a ++ should go here" messages
  https://github.com/processing/processing/issues/2956

+ Missing opening curly bracket error
  https://github.com/processing/processing/issues/3104

+ Missing parenthesis error message
  https://github.com/processing/processing/issues/3103


[ pulls from Joel ]

+ Add reference for installed tools and libraries to the Help menu
  https://github.com/processing/processing/issues/943
  https://github.com/processing/processing/pull/2804

+ examples.properties file missing prevents startup
  https://github.com/processing/processing/issues/3037
  https://github.com/processing/processing/pull/3047

+ Several new French translations
  https://github.com/processing/processing/pull/3061

+ contributions.txt now gets deleted and recreated instead of overwritten
  https://github.com/processing/processing/pull/3073
  https://github.com/processing/processing/issues/2994

+ Contrib Manager does not stop parsing contribs.txt if an error exists
  https://github.com/processing/processing/pull/3132

+ Offer to install libraries imported libraries that are not available
  https://github.com/processing/processing/pull/3155
  https://github.com/processing/processing/issues/2566

+ Make fatal errors terminate the pde
  https://github.com/processing/processing/issues/3068
  https://github.com/processing/processing/pull/3069

+ Java 8 method replace() used, removed
  https://github.com/processing/processing/issues/3168
  https://github.com/processing/processing/pull/3169

+ Closing a few unclosed BufferedReaders and InputStreams
  https://github.com/processing/processing/pull/2961


[ Akarshit pulls away from the pack ]

+ Rewrite preferences window to use proper layout
  https://github.com/processing/processing/issues/67
  https://github.com/processing/processing/issues/2708
  https://github.com/processing/processing/issues/2986

+ Find/Replace dialog changed to GroupLayout
  https://github.com/processing/processin...