caution: the beverage you're about to enjoy is extremely hot. this
file is a list of changes between each release. this is not a general
reference of how to use processing, because the information for older
releases will be super crusty. 


. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 


ABOUT REV 0102 - 15 January 2005

Windows-only release to repair issues that prevent Processing from 
working properly when the PATH, CLASSPATH, and QTJAVA environment 
variables have spaces or quotes. 

references: 
http://dev.processing.org/bugs/show_bug.cgi?id=112
http://processing.org/discourse/yabb_beta/YaBB.cgi?board=SoftwareBugs;action=display;num=1114040731
http://processing.org/discourse/yabb_beta/YaBB.cgi?board=SoftwareBugs;action=display;num=1114153542


. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 


ABOUT REV 0101 - 14 January 2005

Something I said about quick releases to follow...

0101 fixes a bug in 0100 that prevented output from working properly 
when the size() command was used to specify PDF rendering.


. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 


ABOUT REV 0100 - 13 January 2005

This is a pre-release of the PDF generating code. There will be a couple 
other quick releases to follow in the coming days, and this shouldn't be
considered a "stable" release since it's not been tested heavily, but we
wanted to post it for the people who'd like to try it out.

To use it the pdf library, select Sketch -> Import Library -> pdf. 
And then choose one of the following methods:

+ to render everything out to a file:

  void setup() {
    size(400, 400, PDF, "filename.pdf");
  }

  void draw() {
    // draw something good here
  }

  void mousePressed() {
    exit();  // important!
  }

  this will create a sketch that draws only to a file. successive frames
  will be drawn on top of one another. when you're finished, call exit(), 
  for instance, inside mousePressed() or a keyPressed() event.
  this will still open a window of size 400x400 but not draw into it. 
  future releases won't open the window, since it doesn't work properly 
  with sizes larger than the screen size (as might often be the case when
  rendering to a file).

+ if you want to record just a single frame, use beginRecord() and
  endRecord() inside draw:

  void draw() {
    beginRecord(PDF, "frame-####.pdf");
    // your awesome drawing happens here. 
    endRecord();  // saves the file
  }

  this can also be triggered by a mouse press. the #### will cause a
  four digit "frame" number to be inserted into the filename.

+ if you want to record the entire thing to a file at the same time as 
  drawing to the screen (i.e. save out an interactive drawing), do this:

  void setup() {
    size(400, 400);
    // etc
    beginRecord(PDF, "everything.pdf");
  }

  void draw() {
    // do your worst
  }

  // this needn't be mousePressed, but you need to call this somewhere
  // when you're done, to ensure that the pdf file properly closes.
  void mousePressed() {
    endRecord();
  }

Caveats with PDF rendering: 

+ anything bitmapped works very poorly. so it's no good for images.

+ use createFont() with a truetype font (some opentype also work) to
  make fonts work properly. any font that shows up in PFont.list() 
  should work. if you don't use createFont(), they'll likely show up 
  bitmappy and gross like images. the shape of the characters may be 
  weird in some cases, there seems to be a java bug with cubic vs. 
  quadric splines. looking into a workaround if necessary. 

+ rendering from 3D isn't yet supported, but coming soon. 

+ exit() is really important when using PDF with size()


. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 


ABOUT REV 0099 - 18 December 2005

A general usability-oriented release. The most major thing is some
additional support for auto-indenting of blocks (things inside curly
braces) and being smarter about indents on new lines. Other than that, 
it's a lot of bug fixes. If there are errors in the auto-indenting, 
you might want to just move back to 0098.


+ better auto-indent code. it's not complete or perfect, but should
  make the editor a little less annoying for general use.

+ ctrl-up and ctrl-down move up or down to the next empty line
  (holding down shift will also select the area)

+ a /* without an ending */ was crashing with a NullPointerException 
  or OutOfMemoryError or just plain locking up.
  http://dev.processing.org/bugs/show_bug.cgi?id=16

+ let user know where offensively named sketches are located
  http://processing.org/discourse/yabb_beta/YaBB.cgi?board=SoftwareBugs;action=display;num=1134466565

+ make windows respond to ctrl/cmd-w and esc more consistently

+ make buttons in toolbar highlight as their actions are taking place
  (i.e. make the export button stay lit while the export is completing)
  http://dev.processing.org/bugs/show_bug.cgi?id=242

+ processing should no longer fill the temporary directory with extra
  folders. iron out other console and build related issues.

+ fix obscure bug with hidden files when using an external editor

+ fix an issue with autoformat showing up out of range
  http://processing.org/discourse/yabb_beta/YaBB.cgi?board=SoftwareBugs;action=display;num=1134720763

+ support for ComponentListener to handle calling size() when 
  a PApplet is resized by a layout manager or other means.
  http://dev.processing.org/bugs/show_bug.cgi?id=209
  this still doesn't work with opengl, however.

+ calling size() while app is running had some weirdness
  http://dev.processing.org/bugs/show_bug.cgi?id=243  


. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 


ABOUT REV 0098 - 1 December 2005

Not heavily tested, a release primarily for Casey to fix some issues
he was running into with while writing the book. A handful of bug
fixes I figured I'd post for the more adventurous, before adding
anything more complex to it.

Not as necesary a release as the others but has some useful fixes and
I'll need to know whether or not there are any regressions before the
next "big" release.


[ bug fixes ] 

+ fixes for linux shell script for "export to application" 
  http://dev.processing.org/bugs/show_bug.cgi?id=234
  thanks to x771771 at fixless.com for the report and fix.

+ more edits are now a compound edit, so hitting "Undo" after "Auto
  Format" will undo to the previous state, instead of first going to a
  blank screen and requiring a second "Undo." this is particularly
  noticeable when bugs in Auto Format cause code to be mangled, and
  hitting undo would "delete" the code entirely (a second undo would
  fix things, but not everyone figured that out). 
  http://dev.processing.org/bugs/show_bug.cgi?id=139

+ several fixes to "Auto Format", however many more bugs uncovered in
  the process. unfortunately the code was contributed and then
  abandoned by its original author, making it difficult to maintain.
  http://dev.processing.org/bugs/show_bug.cgi?id=109
  http://dev.processing.org/bugs/show_bug.cgi?id=110
  http://dev.processing.org/bugs/show_bug.cgi?id=235
  http://dev.processing.org/bugs/show_bug.cgi?id=236

+ better bug handling with auto format. if an exception occurs, 
  auto format should return without mangling your code.

+ once again fixed a bug where width and height were set to zero in
  static mode apps. hopefully fixed properly this time:
  http://dev.processing.org/bugs/show_bug.cgi?id=198

+ fixed a bug where play() wouldn't play a sound the second time
  unless stop() had been called on it.


[ changes ] 

+ updated to java 1.4.2_10 on windows and linux. the former version
  was 1.4.2_08, though _10 will be out of sync with macosx which is 
  currently at 1.4.2_09. 

+ updated notes in the javadoc about how the preprocessor works.

+ made auto format more verbal in reporting errors and differences to
  the editor. won't change anything unless actual changes occur, and
  if an misbalanced parenthesis situation occurs, it's reported as an
  error.


[ api changes ] 

+ recordShapes() and recordShapesRaw() will be record() and
  recordRaw(), though they remain mostly unimplemented.


. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 


ABOUT REV 0097 - 29 November 2005

"Export to Application" is here! See the FAQ for more details:
http://processing.org/faq/bugs.html#application


. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 


ABOUT REV 0096 - 26 November 2005

bug and api fix release. mostly minor things but useful to avoid
several quirks that showed up in rev 0095.


[ fixes ]

- fixed a bug that prevented movies from opening properly in 0095. 
  http://dev.processing.org/bugs/show_bug.cgi?id=216

- lots of tweaks to openStream(), and all the loadXxxx() functions. 
  + web server logs should no longer be spammed with quite so many 404s
    from p5 applets looking for files in their data folders.
  + the open and load functions now handle subfolders inside the data 
    folder. subfolders in the data folder are now included on export. 
    http://dev.processing.org/bugs/show_bug.cgi?id=218
    http://dev.processing.org/bugs/show_bug.cgi?id=65
  + instead of halting the applet, a missing file (i.e. with loadImage()
    or loadStrings()) will return null and print an error to the console. 
    this is better for people who know how to deal with null values, 
    but hopefully the others will actually read the console to see the
    error otherwise, because the end result will be a NullPointerException.

- deal with some issues where applets weren't running or were closing
  immediately in revision 0094/0095.
  http://dev.processing.org/bugs/show_bug.cgi?id=210
  http://dev.processing.org/bugs/show_bug.cgi?id=204

- when loading a PNG image, set the image to ARGB if it has an alpha 
  channel. also fix a bug in the GIF image alpha channel checking.
  http://dev.processing.org/bugs/show_bug.cgi?id=217

- fixed a text block wrap problem when a manual break character (\n)
  was used: http://dev.processing.org/bugs/show_bug.cgi?id=188

- remove some unnecessary applet resizing that was happening whenever
  an applet was loaded. this would sometimes cause the wrong window
  size to be used by appletviewer, or cause applets to start at their
  correct size, then resize to 100x100, and then resize to their correct
  location once setup() was complete.


[ api ] 

- hint(DISABLE_DEPTH_TEST) will disable the zbuffer in P3D or OPENGL.
  re-enable with noHint(DISABLE_DEPTH_TEST);

- added methods for libraries to be able to get sketch folder paths.
  the variable 'folder', which was changed to 'path' for rev 0094 is
  now called 'sketchPath', and won't change again. see the javadoc 
  reference on dev.processing.org for more details on this and the
  additional functions:
  + sketchPath() returns the path to a file in the sketch folder.
  + dataPath() returns the path to a file inside the data folder.
  + createPath() will take any path and make sure that the 
    interstitial folders exist. this is used by saveFrame() and 
    savePath() to make sure that the parent folders exist. 
    for instance, saveFrame("image/blah.tif") will use createPath() 
    to ensure that the folder "image" exists inside the sketch folder.
  + savePath() is like sketchPath() but uses createPath() to make 
    sure that it's save to save there.
  this will probably break the libraries again, but hopefully with 
  this change, they should stop breaking going forward.

- changed unhint() to noHint() to match the rest of the api.
  i don't think anyone was using this so hopefully it won't affect 
  anything.


[ misc ] 

- macosx release is now packaged with as a .dmg instead of a .sitx
  http://dev.processing.org/bugs/show_bug.cgi?id=116

- added reference category to the bugs db so that reference issues
  can be handled there as well.

- added MAYSCRIPT="true" to default applet html (for javascript)
  http://dev.processing.org/bugs/show_bug.cgi?id=211


. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 


ABOUT REV 0095 - 2 November 2005

single tweak to undo a failed bug fix in 0094.


[ bug un-fixes ]

- width, height are set to zero in static mode apps. there was an
  attempt to fix this for rev 0094, but that backfired and broke more
  things than it fixed, so the change has been removed and i'm
  re-releasing as 0095. the bug has now been filed for a later release:
  http://dev.processing.org/bugs/show_bug.cgi?id=198


. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 


ABOUT REV 0094 - 31 October 2005


[ additions ] 

- drag and drop! you can now drag and drop a file to the editor 
  window to add it to the sketch. if you drag and drop a sketch file 
  (a .pde file whose parent folder is named the same thing), 
  that sketch will be opened.
  http://dev.processing.org/bugs/show_bug.cgi?id=21

- item added to the tools menu that allows building all sketches
  underneath a particular subfolder. this won't be part of the base
  tools once the tool api is done (meaning that it won't be in the 
  menu by default), but it's there for now. 
  http://dev.processing.org/bugs/show_bug.cgi?id=117


[ bug fixes ] 

- stdout.txt and stderr.txt are no longer written to the processing
  folder, which will prevent errors for lab users. 
  http://dev.processing.org/bugs/show_bug.cgi?id=177

- console text selection no longer immediately de-selects
  http://dev.processing.org/bugs/show_bug.cgi?id=180

- removing quotes from QTJAVA path if they exist (this may have fixed
  some issues?)

- fix bug that was causing font sizes not to be set on opengl
  http://dev.processing.org/bugs/show_bug.cgi?id=174

- apply fix from toxi to make targa file i/o less picky

- width/height now properly set in "static" mode apps

- g.smooth no longer always false in opengl
  http://dev.processing.org/bugs/show_bug.cgi?id=192


[ semi-obscure api tweaks ]

- in PApplet, "folder" has been renamed to "path" to match savePath().

- added dataPath(String filename) to return the full path to the
  give filename within the data folder

- new api is in the process of being added for shape recording.. 
  more on this in future releases.


. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 


ABOUT REV 0093 - 14 October 2005

First release in a while with lots of bug fixes for the video library
(QuickTime 7), OpenGL, and Jikes on Linux.


[ big fixes ] 

- david mellis contributed some code to help prevent the editor from 
  locking up when a lot of println() statements were used in a sketch.
  thank you! http://processing.org/bugs/show_bug.cgi?id=19

- sometimes saving sketches or launching processing was really slow
  when sketchbook folders grew large, or thousands of frames from 
  saveFrame() were in a sketch folder. this has been fixed. 
  http://dev.processing.org/bugs/show_bug.cgi?id=84

- some Java 1.4 code snuck into the core library, breaking applets
  whenever Java 1.3 was in use (Firefox or IE on the Mac, for
  instance). this is now fixed. 

- new version of jikes for linux which should prevent the library 
  issues: http://dev.processing.org/bugs/show_bug.cgi?id=47

- basic support for QuickTime 7 is now included, if you have problems,
  please report them to the bugs database:
  Mac OS X: http://dev.processing.org/bugs/show_bug.cgi?id=172
  Windows: http://dev.processing.org/bugs/show_bug.cgi?id=171

- applications that use OpenGL should run better due to an update of
  the JOGL library. 


[ other bits ] 

- lots of additions to the FAQ and updates to dev.processing.org

- lots of help from fjen on improving the bugs database

- added a link to the FAQ from the Help menu

- added menu shortcut for "show sketch folder" 

- faster blur code contributed by toxi, along with filter(ERODE) 
  and filter(DILATE). thanks toxi!

- initial support for textMode(SHAPE), which will render fonts as
  triangulated vectors that will eventually allow for exporting vector
  text from OpenGL applications.

- PGraphics.save() no longer inserts the prefix to the applet folder,
  allowing it to be used for absolute paths. (use saveFrame() or the
  savePath() function if you want to save frames to the sketch
  folder). 



. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 


ABOUT REV 0092 - 30 june 2005

release to support casey's workshop, but not announced publicly.

- thanks to toxi, RLE-compressed .tga images are now the default

- fix to make copy() a little faster in 2D

- native fonts are now used with JAVA2D if they're installed on the
  host machine. this means faster, higher quality rendering for fonts.
  will require running "Create Font" again, however.


[ api changes ]

- loadMatrix() now handles getting good matrix values into 
  g.m00, g.m01 etc across all renderers

- accessible variables from PGraphics3 can now be found in the main
  graphics object, so it's possible to use g.cameraX, etc.

- text now has an inherent position, so after drawing some text, a
  call to text("blah"); will draw the text "blah" right after the last
  text that was just drawn.


[ internal stuff ] 

- PApplet.main() is now Java 1.3 compliant

- move font placement back into PGraphics

- lots of changes to font control and font format updated once again



. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 


ABOUT REV 0091 - 6 june 2005


[ major bug fixes ] 

- european users rejoice: using processing from a user account with
  non-ascii characters in the user name no longer causes a problem on
  windows

- error messages should be improved a bit when libraries or a code
  folder are in use


[ minor bug fixes ] 

- keys in the editor now properly work while shift is down

- printing too many chars to the console (32,000 of them) no longer
  makes things choke

- linux first checks to see if jikes is properly installed and built
  for the current distro

- better error message when Capture.list() fails

- if sketchbook goes missing, default to a new location rather than
  dying completely

- improvements to running applets from the command line.. shouldn't
  require --present option anymore

- fixed a weird bug where curveVertex() had trouble with > 128 points

- hitting escape now quits present mode

- the runner stop button color wasn't being read from the preferences
  file properly

- "java 1.3 required" message when running in a 1.1 browser was broken


[ minor api change ] 

- createFont() functions cleared up a bit, they've changed from:
  createFont(name, size)
  createFont(name, size, charset)
  createFont(name, size, smooth)
  createFont(name, size, charset, smooth)
  in previous releases to now look like: 
  createFont(name, size)
  createFont(name, size, smooth)
  createFont(name, size, smooth, charset) 
  (docs may not yet be updated)


. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 


ABOUT REV 0090 - 9 may 2005

- fix for yet another undo bug fix that can cause code to be destroyed

- fix for the selection ugliness that was causing an ugly yellow gap, 
  contributed by david mellis - thanks david!

- some additional fixes for sketch renaming and updating the ui properly

- addition of an "arraycopy" function that mirrors System.arraycopy, 
  details will be in a version of the reference arriving soon.


. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 


ABOUT REV 0089 - 8 may 2005

fix for a late breaking undo bug that made things really nasty.
also removed the Thumbs.db files in the reference and examples.


. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 


ABOUT REV 0088 - 7 may 2005

lots of bug fixes in this release based on feedback on the discourse 
board, thanks to everyone who's been reporting things. 


[ tab madness ] 

- better at handling errors across multiple tabs 

- undo now works properly between tabs (undo used to be cleared 
  when changing a tab, or on each error)

- when using multiple tabs (but no .java files or code folder or libs)
  things will still run inside p5, meaning they'll start up more quickly

- renaming a .java file now includes the .java in the name, so that 
  you don't accidentally make the file a .pde file


[ tools ] 

- auto format has been replaced by code long since contributed by 
  martin gomez. thanks to martin, things should improve significantly. 
  better yet, if there are problems, we can yell at him about em!

- archive sketch saves before archiving, hopefully reducing confusion


[ export ] 

- new default html for exported applets

- shows a processing loading image instead of sun's awful starburst 
  java coffee cup. like applet.html, this can be customized by placing 
  a file inside your sketch folder called 'loading.gif'


[ core/api ] 

- ceil(), floor(), and round() now return ints instead of floats

- master gain error in PSound won't make the sound unusable, it'll just
  shut off the ability to control volume. (a java 1.5 problem?)

- fixed createFont() for built-in fonts


[ minor fixes ] 

- errors (exception stack traces, for the technical)  properly show up
  across multiple lines.. sometimes they used to get spammed onto a single 
  line, making them difficult to read.

- run-expert.bat was unintentionally a little too expert, and required
  editing before use.


[ platforms ] 

- windows and linux java have been updated for java 1.4.2_08

- windows java download includes the proper files for handling 
  non-european systems


. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 


ABOUT REV 0087 - 2 may 2005

not tested as thoroughly as rev 86, gonna wait 24-48 hours before 
setting this as the default download. 

+ the reason for this release: dragging the sketch window should no 
  longer make things lock up. also found several bugs that were 
  probably contributing to the problem.

+ more file creating and saving fixes:

  - new tab with a .java file was giving an error
    http://processing.org/discourse/yabb_beta/YaBB.cgi?board=SoftwareBugs;action=display;num=1115059069;start=0
  
  - "save as" with a read-only sketch wasn't letting you use the 
    same name as the old one.

  - other small tweaks to new tab/save as/rename error messages

+ check for updates happens only once daily, rather than nagging 
  you on each startup


. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 


ABOUT REV 0086 - 1 may 2005

fixes for a couple major bugs in the beta release. 


[ large ] 

- "Save As" bugs fixed, along with some others found in "Rename"

- fixed an error that caused applets to require Java 1.3

- camera should no longer be backwards


[ medium ] 

- fixed the smashed text in the preferences window 

- saveFrame() fixed once again

- color() wasn't properly changing with colorMode(HSB)

- Linux: serial and net libraries weren't included in the last release

- fix to make the environment run on Mac OS X 10.2

- caret and scroll position is now saved when switching tabs


[ small ] 

- fov on camera() changed to use radians

- lookat() has been removed, because its functionality is 
  duplicated by camera().

- no longer throws an error with beginShape/endShape calls
  that have no vertex() calls in-between

- added an error for people who try to use textMode(RIGHT)

- updated the Windows and Linux downloads to include Java 1.4.2_07

- removed requirement that fink be installed before building on the mac

- lots of changes to the faq 


. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 


ABOUT REV 0085 - 19 april 2005 - beta

- camera() was missing from PGraphics

- tweaks to openStream() for image loading

- basic triangle and line clipping in P3D from simon (!)

- finalized the faq listing


. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 


ABOUT REV 0084 - 19 april 2005

we're one release away from beta. reference and examples need another
update, and the faq page needs a rundown of all the changes yet, but
hopefully we're done with the code, barring any showstopper bugs.

changes for this release:

- added run.options to preferences that will allow you to set the
  amount of memory allocated to sketches run externally.

- stability improvements to processing.exe from simon. 

- additions to the faq pages (the readme and bugs files are gone,
  replaced with the 'faq' folder)

- all the dreaded "save as" bugs are now fixed

- "Create Font" works once again

- more lighting fixes from simon

- point() again works in 2D mode

- text with a z coordinate is working again


. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 


ABOUT REV 0083 - 17 april 2005

- new reference and examples in this release. please test!

- readme.txt and bugs.txt have been removed in favor of a single FAQ,
  which contains the appropriate information, and will be mirrored as
  the FAQ on processing.org as well.

- what he hope is the finalized lighting api for beta/1.0

  + because lights are in object space, they are considered more
    like a shape in this release. they are not retained and must
    be "drawn" each time you run through draw(). 

  + to enable a simple ambient and directional light, place inside draw:
    public void lights();  

  + ambientLight(float r, float g, float b) 
    adds an ambient light based on the current colorMode.

  + directionalLight(r, g, b, vx, vy, vz);
    sets up a direction light along vector vx, vy, vz

  + spotLight(r, g, b, x, y, z, vx, vy, vz, angle); 
    sets up a spotlight at a position, with a direction and an angle

  + lightFalloff(constant, linear, quadratic) 
    will change the falloff for any lights that follow. 
    default setting is lightFalloff(1, 0, 0)

  + lightSpecular(r, g, b) 
    sets the specular color for any lights that follow.

  + ambient(), emissive(), specular() set the material properties
    of shapes. they take the same form as fill() and stroke(). 

  + shininess(float shiney) takes a float from 0..1 to specify
    the level of shininess for the current material

- video camera api should now be finalized:

  + we're still debating on whether to rename Camera to something
    else. we just can't think of a good name.

  + that whole thing with passing null or "" to the camera constructor
    was really silly. now either one will just give you the default
    video input device. 

  + added settings() which will show the settings dialog

  + source() takes parameters TUNER, COMPOSITE, SVIDEO or COMPONENT
    to select the input source.

  + format() takes parameters NTSC, SECAM or PAL

  + crop(x, y, w, h) (uses the current imageMode from the parent
    applet) will crop the video before putting it into its PImage. 
    this is almost always used internally because qt likes to add
    black bars to the image, but you can now specify your own 
    settings to crop things further

  + noCrop() will remove any cropping, providing a speed increase.

  + there may be bugs.. things were sometimes hanging on my machine 
    when there were errors 

- link() now works when running as an application. also added
  open(String filename) which will attempt to launch an application 
  using the shell, or open(String args[]) which will do the same
  with several command line args.

- nfc() joins the nf() family to format integers and floats with commas.

- linux version returns, with several fixes, and now handles 
  (warns about) libstdc++ incompatabilities with jikes


The last remaining things before Beta:

- make sure there isn't any super badness in the current version

- fix the "save as" bugs

- "create font" is somewhat broken in this release


. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 


ABOUT REV 0082 - 6 april 2005

- casey has updated the examples, reference, and keywords.

- default lighting now works.. lights() and noLights() should properly
  make things look 3D and pretty... this is all thanks to simon. there 
  are a ton of features that come along with this, but we're testing
  them and finalizing the api first before announcing them.

- default window height is no longer insufficient (after prefs were
  deleted on windows, on the next run the window was smashed)

- "sto" is now "stop" while in present mode

- it looks as though the opengl libraries weren't properly added in
  the last release. no more.

- added an extra requestFocus() for opengl

- added ryan's grow box design for osx


known problems

- P2D still badly broken (no lines, etc)

- flicker still likely in java2d.. the applet and graphics threads
  aren't playing nicely with each other

- stop button still broken.. had it fixed for a minute but a bunch 
  of other problems reappeared. 

- dragging the applet window around will usually halt it (especially
  with opengl)

- println() is super slow

- moving the main p5 window to another screen just gets thrown out, 
  to prevent a case where a second display is unplugged. this will 
  change in a future release to properly record its previous position
  and what monitor it was on.


. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 


ABOUT REV 0081 - 4 april 2005

* major api changes in this release *

we're nearing the end of our general f-ing with the api, but we've
once again broken things. this time, we've moved around how renderers
work. 

- depth() is gone, and so is the renderer menu, in its place, we
  have a new method for specifying how you want to render. 

  so now, size(200, 200) this allocates a 2D buffer to draw into, 
  using the Java2D engine or the original 1.1-compliant engine depending 
  on whether or not you're using Java 1.3 or higher.

  or this gets the original processing 2D renderer:
  (which is often better for pixel operations, though is currently quite
  borked.. lines and whatnot don't work properly)
  size(200, 200, P2D);

  this provides the original processing 3D renderer:
  size(200, 200, P3D);

  and this loads (drum roll) opengl:
  size(200, 200, OPENGL);

- gl.glXxxxXxx no longer works, because the base applet is just a 
  regular PApplet, not a PAppletGL. this is a bummer but a small
  price to pay for all the goodness that comes with the way that
  the new size() function works. in order to get the gl object to 
  draw to, use the following ugly piece of code. 
  GL gl = ((PGraphicsGL) g).gl;
  you may also want/need to add the following import statement 
  (did you know we support imports? not sure if this was mentioned
  back around 70 or whenever they were implemented)
  import net.java.games.jogl.GL;

- the applet placement, sizing, and window issues should now be sorted
  out completely. no more windows showing up in weird places or applets
  being offset strangely within them.

- present mode has been rewritten to use java's proper full screen api.
  no more ghetto full screen with menubar on osx. should be more stable
  than it was in the past. also note that things running in presentation
  mode will run using an external java vm, rather than inside the 
  environment itself.

- processing itself requires java 1.4. it's sort of required it for a 
  little while, but this is now made explicit in the code. if you're lucky
  a new erorr dialog will pop up and tell you to install a newer version 
  if you try running under 1.3 or whatever.

- background(PImage) should now be working in opengl

- saveFrame() path bug fixed

- preferences madness
  + preferences panel is now a modal dialog, and doesn't hide the 
    editor window in the weird way it used to. 
  + you can also click the link to the preferences .txt file and it'll 
    open in whatever your default text editor is on your machine.
  + editor font size is now a preference that can be set from the 
    prefs window.
  + fixed a bug where prefs were applied even if you hit cancel.

- lots more internal fixes and tweaking that we'll be documenting 
  soon (i.e. the new renderer setup means pluggable renderers, or 
  PApplet has lots of fancy command line options like --present)


* other bits to note *

- it should also be noted again that java 1.1 stuff is almost 
  completely unusable in this release. the PApplet class temporarily
  contains some 1.4-specific code (which will be removed) and the
  graphics engine still doesn't work. so this version isn't useful
  for exporting things to the web.

- there are a bunch of bugs with save & save as... quirky things 
  about folders not winding up in the right place and whatnot. 
  looking to fix these this week

- release 82 (or 83?) will be all about getting proper 3D lighting,
  camera, and geometry working. simon's done some amazing work.

- if anyone's looking at the cvs, you'll need to do a 
  "cvs update -d -P" because the folder structure has moved around
  for this release.


. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 


ABOUT REV 0080 - 2 April 2005

bug fix and api tweaking release... um yeah.


- examples have finally been updated in this release, please test!

- keywords have also been updated

- when exporting an applet, you can now include a description in the
  applet text. the format is a javadoc comment, where the first line
  should contain /** and the final line */ so the following would work:
  /**
   * You can't rock Processing like I can rock Processing.
   */
  and that text would automatically be embedded in the exported html 
  page. like a javadoc comment, the text can (and should) be any valid
  html since it's just gonna get embedded right in the page.


graphics

- fixed opengl bug that was causing some color components to flip on the mac

- removed mask(PImage someImage, PImage theMask)
  just use someImage.mask(theMask) instead

- filter(BLUR) and filter(BLUR, float radius) rock
  donated code from quasimondo that does a gaussian blur on an image

- set(x, y, argb) and set(x, y, PImage) now work inside opengl

- copy(PImage, x, y) has become set(x, y, PImage)

- blend(), copy(), and filter() now work for opengl

- textureMode(NORMAL_SPACE) -> textureMode(NORMALIZED)
  textureMode(IMAGE_SPACE) -> textureMode(IMAGE)

- goodbye sphere(x, y, z, r), you're inconsistent with the api


text changes

- textMode(ALIGN_LEFT) -> textAlign(LEFT)
  textMode(ALIGN_RIGHT) -> textAlign(RIGHT)
  textMode(ALIGN_CENTER) -> textAlign(CENTER)

- textSpace(SCREEN_SPACE) -> textMode(SCREEN)
  textSpace(OBJECT_SPACE) -> textMode(OBJECT)

- text() in a box is now fixed again (sometimes a word would hang
  outside the box)

- textFont(font) now sets the font to its "natural" size by default
  (the size used for "Create Font")

- font.size is an int that contains the original size of the font


forgot to mention for previous releases:

- point() should be working in opengl again

- to make a copy of an image, just use get(), which is the same as
  get(0, 0, image.width, image.height)

- copy(PImage, x, y) has been replaced by set(x, y, PImage) for better
  parity with the get() methods.

- macosx users can once again scroll downwards in the console, 
  thanks to the little bar with the line numbers

- arc() was made to behave more properly


. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 


ABOUT REV 0079 - 31 March 2005

* horizontal toolbar! new colors! current line number indicator! *

cosmetic fixes only in today's release. we lost our internet connection
last night before i could post rev 78 for windows, so if casey returns
from his meeting soon enough, we'll also post a rev 79 for windows (and 
just skip 78 since we didn't get to it).

- you must delete your preferences.txt file for this release, 
  otherwise things are gonna look super ugly.
  on macosx: ~/Library/Processing/preferences.txt
  on windows: Documents and Settings/username/
              Application Data/Processing/preferences.txt

- the ui is now blonde... casey decided that it was time to go horizontal 
  with the toolbar buttons. drunk with power, he wound up re-coloring
  everything while he was at it. as a result your prefs need to be nuked
  the first time you run with this release.

- added a status bar at the bottom of the screen that displays the 
  current line number (or range). this is an interim solution until
  we can put in real line numbers, but hopefully this does the trick
  for a while, since the text editor component we use doesn't support
  line numbers. 

- ctrl-O added for the "Open" menu item. don't get too wild.


. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 


ABOUT REV 0078 - 30 March 2005

this release includes a large number of fixes for the 2D graphics engine. 
nothing has changed in the processing 3D engine (what you get when you 
call depth()), however the OpenGL renderer now supports loadPixels(), 
updatePixels(), saveFrame(), get(), and pmouseX/Y.

around the corner are big fixes to 3D when simon finishes the new 
lighting model. he's moving through it pretty quickly so we hope to have
it in a release shortly.


major things still not solved since last release:

- still lots of threading/flickering strangeness

- applet not being placed properly inside its window

- things sometims not starting up (gives a cryptic error in the console)

- text inside a rect is slightly broken

- you can't do per-vertex coloring of lines in 2D

- everything else not covered here that was broken in 77...


api changes:

- fun things: some of the filter() stuff in PImage now works:
  + filter(GRAY) will convert a PImage to grayscale. 
  + filter(INVERT) will invert an image
  + filter(POSTERIZE, int levels) will posterize to that many levels
  + filter(THRESHOLD) or filter(THRESHOLD, float midpoint)
    will give you a black and white image, with optionally settable
    midpoint (a value from 0 to 1)
  + coming soon is filter(BLUR) and filter(BLUR, float radius)...

- strokeCap/strokeJoin constants for MITERED is now MITER, BEVELED is BEVEL, 
  and PROJECTED is now PROJECT.

- as of 0077, font.width() works differently. it returns the width of
  a one point font, not the font at its current size. the font api
  built into PGraphics/PApplet now consists of:

  public void textFont(PFont which);
  public void textFont(PFont which, float size);
  public void textSize(float size);
  public void textLeading(float leading);
  public void textMode(int mode);
  public void textSpace(int space);
  public float textAscent();
  public float textDescent();
  public float textWidth(char c);
  public float textWidth(String s);

  instead of using PFont.width() or PFont.ascent() to get the size of
  text, you should use textWidth() or textAscent() in PGraphics/PApplet
  which will return values based on what was set in textSize().

- bezierVertex has changed. instead of four calls to bezierVertex, 
  you should instead use:
  vertex(x1, y1);
  bezierVertex(x2, y2, x3, y3, x4, y4);
  this helps iron out some inconsistencies that you get with the wrong
  number of bezierVertex coords. it also prevents you from having to 
  double up the final coordinate to draw the next segment.

- got rid of CONCAVE_POLYGON and CONVEX_POLYGON since they never really
  came into full use.


bug fixes: 

- curveVertex works again.

- lines of text were getting mashed together both horizontally and
  vertically. the font stuff was moved around a lot in 0077 and so
  this made a mess of things.

- backwards rectangles and ellipses are now drawn properly. (i.e. 
  rectangles where (x2 < x1) or (y2 < y1), or ellipses with a 
  negative width or height).

- same thing for backwards images, note that an image drawn backwards
  won't actually flip the image or anything nutty like that.

- the file open dialog on macosx now lets you open files ending 
  with all caps .PDE instead of .pde

- imageMode() was broken

- loadPixels, updatePixels, save, and saveFrame were totally broken 
  and now they work in both the Java2D and OpenGL renderers.

- patched in the latest version of jogl to hopefully fix some of the
  overly chatty error messages.

- SCREEN_SPACE text is working again

- tint() is now working properly, except that it ignores colors (but
  accepts alpha) with PGraphics3 (processing renderer with depth())

- arc was broken and inconsistent, now fixed.

- several bug fixes inside Camera and Movie.

- PImage.get() had a bug where it wouldn't properly read data as
  you neared or crossed any of the edges of the image.

- bug in the gl renderer that had images drawing the wrong size/shape.

- default strokeCap and strokeJoin now set.


. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 


ABOUT REV 0077 - 1 March 2005

* PLEASE READ THIS INFORMATION BEFORE POSTING TO THE BETA LIST *

this is another release where processing has undergone massive
changes. hopefully it is hopefully more stable than 75 and 76, 
and i'm ready to take bug reports again.


changes/important notes:

- whenever you use 3D in this release, you must use the depth() command
  inside of setup (preferably just before or after size()). having
  tried to keep the 2D rendering together, it's just become too messy
  and error prone to continue. 

- after editing the pixels[] of an image, you must use the new method
  updatePixels(). this became necessary because of the Java 2D
  renderer as well as OpenGL. it's unfortunate, but it's all we can
  do. so after messing with pixels[] for the main surface, or doing
  the same with an image, call updatePixels() to mark the entire image
  as modified, or call updatePixels(x, y, w, h) to update just a
  portion (this is currently no faster, but later will represent an
  optimization). 

- you'll also need to use loadPixels() on any PGraphics object 
  before reading its pixels and messing with its pixels[] buffer.

- using size() with actual numbers, as opposed to variables, is
  strongly recommended. there's no reason to use size(WIDTH, HEIGHT)
  because the variables width & height can be used for the same
  purpose after size() has been called. this helps the "export"
  command and also becomes very important with opengl.

- rendering... this release represents a significant change to how
  rendering is handled. all of the graphics has been split into
  multiple classes, which are: 

  PGraphics     2D rendering with Java 1.1 
                this is the old renderer, but it has been semi-disabled
                in the current release. this means that things won't 
                draw properly (or at all) in 2D in most web browsers 
                (where the java plugin is not installed). this renderer
                will no longer support smooth() and noSmooth().

  PGraphics2    2D rendering for systems using Java 1.3+ 
                this is used dynamically whenever the applet detects
                that it is running on a Java 1.3+ system. 
                it is an entirely new, and *complete* renderer based
                on Java2D. this was a shortcut to get a renderer that
                worked properly on the vast majority of machines in
                our target audience (courses, beginners, developers) 
                until i have time to complete the 1.1 renderer (so
                that exporting to the web works again). basically, 
                i've sold out, in hope of ever reaching 1.0.

  PGraphics3    3D rendering in Java 1.1
                this is loaded when the depth() command is executed
                inside of setup(). any applet requiring 3D must now
                explicitly state depth() inside setup(). the renderer
                is composed of the 3D components from the old
                renderer, although it's using sumea sami's newer
                triangle rendering, meaning that things are much
                faster than before (although textures are a little
                fuggly). there are no plans to support smooth() in 
                this mode. for smoothing, use the OpenGL renderer.
                stroke caps/joins will also probably not work in this 
                mode (lines are 2D objects, how do you put a stroke
                on a 3D object?), but that hasn't yet been fully
                determined.

  PGraphicsGL   OpenGL renderer for use in Java 1.3+ 
                jogl requires java 1.3, and this rendering option can
                just be selected from a menu. this handles both 2D
                and 3D and will actually ignore the depth() command
                (though you should still use it with opengl apps for
                good practice). 

  PMethods      an interface for plug-in file-based renderers.
                for instance, to write a postscript renderer, one
                need only implement the "PMethods" interface with
                your class. then, at the beginning of draw(), use:
                recordFrame(psRenderer);
                which will echo all rendering calls to that
                class until the end of the frame. this handles
                writing to files, we won't be supporting plug-in
                visual renderers in Processing 1.0 (unless you want
                to use this to open up a separate window or something
                weird like that)

  if you're curious, or filing a bug report, you can always check what
  the current rendering engine is by using: println(g.getClass());

- very exciting: strokeWeight(), strokeCap(), strokeJoin() et al 
  now work when using 2D and using Java 1.3 or higher. these will 
  eventually work in Java 1.1 for 2D as well. 

- the new renderers may change the speed of some things significantly. 
  for instance, using text on java 1.3 when depth() hasn't been called
  (PGraphics2) may be far slower than before. or using images in the same
  situation may require much more RAM. on the other hand, smoothed shapes
  and general drawing in the same situation might be much faster.

- i'm trying to think of a means to switch between the java 1.3 version 
  of the 2D api and the 1.1 version in case people want to force use of
  the old one (once it's working again). we'll see.

- presumably the separation of the rendering engines also means that
  one could post a web applet that doesn't include the 3D rendering
  code if your applet is only 2D (or vice versa).

- pmouseX and pmouseY have returned and are better than ever.

- firstMouse boolean variable added, which is set 'true' when the
  mouse gets its first legitimate mouse coordinate. naming for this
  var will likely change in a future release.

- arc() command has been added. it's just like ellipse:
  arc(x, y, w, h, start, stop); 
  and uses ellipseMode() for its placement.

- circle() has been removed. it was a dumb duplication with ellipse().
  it's not as though we have a square() function to go with rect().

- because of the separation of the 2D and 3D renderers, it should be
  possible to create much larger PGraphics objects and for them to use
  far less memory than before. 

- light() commands work, though things seem to look super ugly by
  default. they're more correct when using OpenGL, and perhaps if
  placed more explicitly, you may get better results.

- the alpha() command that sets the alpha mask is now called
  mask(). this is to avoid the name clash with the red(), green(), 
  blue(), alpha() functions. 

- imageMode(CORNER) and CORNERS are the only valid image modes. 
  imageMode affects get(), copy(), blend(), etc so it was just too
  weird to have the CENTER functions operating in that mode. results
  would have been very strange and unexpected.

- box() and sphere() should be working again with opengl

- die() is a newish internal function that's used whenever exceptions 
  or internal errors occur. you can make your own error handler by
  overriding die(String s) and die(String s, Exception e) if you'd
  like your applet to do something smarter than just halting. we're
  moving to where exceptions and errors are handled in a more
  consistent way, and that no p5 methods will require try and catch
  style exception handling (for advanced users who want it, they can
  use the java equivalents of the various PApplet methods). 


ide fun

- forgot to mention in rev 75 that double-clicking a .pde file on the
  mac will now launch processing with that sketch. someday windows will
  do this too. someday...

- i've replaced the cvs version of jikes that we'd been using with
  jikes 1.22, a real release, and the very latest. it's only 2 or 3MB
  (instead of 8 or 9MB) and crashes much less. yay! the reason we can
  make the switch is that 1.22 supports -target 1.1 again (it had
  disappeared in some of the previous releases, and it's absolutely
  essential for p5).


serial library

- serialEvents are now fired after each byte has been received. 

- added buffer(int count) method to Serial to set the number of
  bytes to receive before firing a serialEvent.

- added bufferUntil(int whatByte) method to Serial that will buffer 
  until that byte has been received and then call serialEvent().

- these changes were simple code but haven't been tested, so they
  may be prone to errors. let me know.

- just one function (prompt() which will bring up a list of serial 
  ports in a nice window) remains to finish the Serial library, 
  everything else is considered complete (barring a revolt by the 
  itp physical computing guys). 


known bugs

- the examples have not been updated. they're getting pretty crufty, 
  but i've been making such a mess of the api that i've made casey
  hold off until things settle down a bit before updating.

- curveVertex() is temporarily broken in this release.

- export to web is temporarily broken in this release for machines
  that don't have the java plug-in installed. this includes 60% of
  Windows users on the web, and anyone using Mac OS 8 or 9. the applet
  will export, but will turn up mostly blank on machines with Java 1.1.
  to publish things to the web, you might want to use an earlier
  release, or force people to upgrade their java vm somehow.

- windows coming up at the wrong size or with the wrong placement:
  make sure you're using size(nnn, nnn) where nnn are actual
  numbers. if you're doing that and still seeing trouble, please
  report how to reproduce.

- on macosx (maybe windows too?) applets sometimes come up with their
  top 20 pixels or so missing. working on a fix.

- when using opengl, the "Using ATI workaround..." error message isn't 
  really an error, it's just something that jogl spits out. fret not.
  same with that "can't get focus" error that often shows up on the
  mac. i don't think there's anything i can do about either.

- lighting is fuggly. i have a feeling that normals aren't being set
  up properly, partly because that code has gotten no love for a long
  time and everything around it has changed.

- several reported ide bugs with "save as", "hide" and others remain. 
  i hope to fix these in the next release.

- tint() does not work properly in depth() mode and using the 
  processing renderer (PGraphics3).


. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 


ABOUT REV 0076

this was a quick release that fixed launcher issues on both mac os x
and windows. it meant being distracted uploading a new build during
part of the third quarter of the super bowl, but you guys are just
that important. luckily the patriots still won.


. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 


ABOUT REV 0075

* DON'T USE THIS RELEASE IF YOU'RE ON ANY SORT OF MEDICATION *
this is truly an alpha release, or more like a "nightly build."

i'm posting this release early so that people can play with
opengl. if you aren't one of those just *dying* to get started with
gl, wait until a few days or so when i can get 0076 out that irons out
some of the nastier bugs. you needn't post bug reports on things that
are broken, since i know many many things are horked. a massive number
of changes have happened in this release and i wanted to get it posted
because i was starting to lose track of them all.


things that i know or suspect are broken: 

- the examples have not been updated

- windows sometimes pop up at the wrong sizes.

- opengl doesn't behave properly in static/draw mode (things aren't
  sized properly).

- the processing renderer has taken some steps backwards, and things
  like ellipses might be broken.

- lots of random tidbits in rendering not quite working. 

- drawing images in opengl whose pixel buffer has been edited won't
  work quite right.

- text may pop up sized incorrectly.

- noLoop(), framerate(n), redraw() are not yet supported for opengl

- and much much more!


general 

- you now need to use the command depth() to enable 3D. noDepth()
  shuts it off and moves back to 2D-only (with optimizations). support
  for this is incomplete. 

- hanging bug should now be completely eliminated.

- under sketch, a "renderer" menu that lets you select OpenGL or the
  processing renderer. 

- preprocessor makes all methods "public" that aren't specified
  private or protected. this makes things easier for library events
  (see libraries section below) and things like setup/draw.


core

- added focusGained() and focusLost() events

- added beginShape(TRIANGLE_FAN)

- removed pmouseX and pmouseY because they can't be used 


libraries

- very simple sound api has returned. command is "loadSound". 1.3+ only
  for rev 75, will work in 1.1 as well in 76+.

- serial.last() and serial.lastChar() get last byte in buffer

- library events have returned, if (public) void serialEvent(PSerial)
  is defined in the host applet, it will receive events each time
  something happens on serial. same for:
  cameraEvent(Camera c), movieEvent(Movie m), clientEvent(Client c), 
  serverEvent(Server s, Client c), soundEvent(PSound s)

- PMovie.length() is now PMovie.duration()


ide goodness

- NOTE! your prefs will be lost in this release, unless you move them
  by hand. preferences now live in a "proper" location: 
  ~/Library/Processing on macosx and 
  Documents and Settings/username/Application Data/Processing on winxp
  this will get rid of the localization issues on non-US versions of
  these operation systems. 
  the info is read from the os (on mac) and registry keys (on
  windows), and is also used to place the Processing sketchbook inside
  ~/Documents on mac or ~/My Documents (or whatever it's called in the
  current language) on the pc.

- rename & delete have returned.. when renaming/deleting on the
  first tab, it renames or deletes the entire sketch.

- saving a read-only sketch now defaults to the sketchbook
  (rather than the same read-only location it was coming from)

- build fixes.. preproc gets built properly, and dmg for osx

- cosmetic (single pixel layout issues) fixed on osx

- no more resize box annoyance in the editor on osx

- fixes to the horizontal scrollbar in the editor 
  (became ever-present a release or two ago)

- find/replace cleaned up/tweaked up a bit


. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 


ABOUT REV 0074

- fixed an issue with text and shapes fixing in a bad way (paul
  fishwick's 'clock' bug)

- removed a zbuffer precision hack that was drawing lines above
  everything else

- includes new icons designed by florian


. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 


ABOUT REV 0073

fixes to several nastier bugs (hopefully) 

- the hanging bug may be fixed in this release

- loadImage() should no longer re-download the entire jar file

- libraries are built as 1.1 code like everything else, so things with
  particles can be exported again

- fixed a minor bug that prevented non-smoothed fonts from being 
  created in the font builder on macosx due to apple's creativity 
  with the java spec


. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 


ABOUT REV 0072

bug fix release, most major being that the code folder should now be
working again, and error messages from libraries may have an easier
time of propogating upwards.

BUGS

- code folder works again.

- the code folder hanging bug *may* have been fixed.. either by a fix
  from francis li, or by the error message changes by me. keep your
  fingers crossed.. 

- loadImage() is broken on some machines.. a small hack has been
  introduced to get around this, hopefully it doesn't break for
  everyone else. as a result of the hack, the 'cache' setting on
  images is temporarily ignored.

- hint()/unhint() settings were static variables, meaning that they'd
  stick around per processing session, which is too long. 


API & STUFF

- g.m00, g.m01 etc are now public

- error message shows up when a library isn't available


. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 


ABOUT REV 0071 

bug fix release, clears up several things with text and other tidbits 
found by all y'all beta testers. if this is your first release 
since 68 or 69, you should read about the changes made in rev 70.


BUG FIXES

- suppress "bad file descriptor" error on mac os x

- properly alphabetize the sketch menu (ignore upper/lower case)

- fixed export on macosx

- multiple tabs no longer causes things to run in another java vm.
  (unless the other tabs are for .java files)

- dim 'rename' on the first tab, since it cannot be renamed.

- "save as" now properly updates the tabs

- don't let people "save as" a sketch inside itself.

- removed the resize box for applets (since they can't be resized anyway)

- cursor() functions are now usable (public) again

- pre, post & draw now work with libraries


CHANGES

- the 'key' variable has been made into a char, so that things like 
  println(key) makes more sense (and in keeping with java's getKeyChar)

- added a little gap to the left of the editor frame
  http://processing.org/discourse/yabb/YaBB.cgi?board=BugFixes;action=display;num=1097363967;start=0

- changed "new file" to "new tab" for clarity

- "add file" of a .pde or .java file already inside the sketch folder
  no longer produces an error, it just updates the tabs.

- "save as" defaults to the current sketch location and name

- text(x, y, w, h) now uses the current rectMode() for placement. 

- align left, center, and right are now properly implemented for text().

- PFont2 has been merged back into PFont. java 1.2+ specific features 
  that had been sequestered to PFont2 are now handled through reflection.


CHANGES I FORGOT TO MENTION FOR REV 70

- 'online' is now a boolean instead of a function that returns a
  boolean. this was actually in 0070 but i forgot to mention it

- also from 70, people who used triangle_count, it's now called
  triangleCount.


. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 


ABOUT REV 0070 - MEGABUCKET - 29 September 2004

YOUR CODE WILL ALMOST CERTAINLY BREAK IN THIS RELEASE, READ THE
"MAJOR CHANGES" SECTION BELOW TO SEE HOW TO FIX IT. this is one of the
most major releases to date in terms of things that have been changed,
fixed, or revised. unfortunately, there will still be api changes
before beta. if you don't want to deal with your code breaking, then
wait until the beta. 

as of this release, we're also returning to more truly "alpha" status
for releases. from 70 until beta, releases will happen more frequently
(hopefully) and increment more quickly. however, we won't be
announcing a new release to the greater public until beta, at which
time we'll be done breaking everyone's code. more details here:
http://processing.org/discourse/yabb/YaBB.cgi?board=Collaboration;action=display;num=1096489132


major changes: (things that break your code) 

- if you have a program that uses "void draw()" to draw a static
  image, you need to add the line "noLoop()" to setup or to the first
  line of the draw method itself.

- for any programs that use "void loop()" you need to change its name
  to "void draw()". 

- BImage, BFont, BGraphics, etc are all PImage, PFont, PGraphics.
  you'll need to rename them in your program.

- libraries will almost certainly need to be rewritten for this
  release. we're working with amit on an update to sonia and several
  other libraries will be included in future releases.

- mouse and key events are now properly queued, meaning that functions
  like mousePressed() and keyPressed() will be called at the *end* of
  your draw() method. this means that you can "draw" inside of those
  methods, just note that it'll happen after all other drawing.
  http://processing.org/discourse/yabb/YaBB.cgi?board=Syntax;action=display;num=1079555200;start=0

- CENTER_DIAMETER has become CENTER

- replicate() in PImage is now called copy(). other changes in PImage
  as well, see the ref: http://processing.org/reference/PImage.html

- curveSegments and bezierSegments are now called curveDetail and 
  bezierDetail.

- net, serial, and video are completely different. see the libraries
  reference: http://processing.org/reference/libraries/index.html
  their examples have also been updated.

- quicktime is no longer required to be installed on windows

- the 'fonts' folder has been removed. these were old (had no special
  characters like umlauts and whatnot) and of questionable copyright
  status, so we took them out. you can create fonts to your heart's
  content using the "Create Font" option.

- history has been (temporarily?) removed. in the meantime under the
  "Tools" menu is an option named "Archive Sketch" which will zip up
  the contents of the current sketch folder into a numbered archive.
  the numbers will automatically increment yoursketch-001.zip,
  yoursketch-002.zip etc.

- key events for things like arrow and whatnot should use 'keyCode'
  instead of 'key'. so 
  http://processing.org/discourse/yabb/YaBB.cgi?board=BugFixes;action=display;num=1096304533;start=0
  http://processing.org/discourse/yabb/YaBB.cgi?board=BugFixes;action=display;num=1096304779;start=0

- the sizing/spacing of text() has changed! a combination of small
  bugs inside text() and the "Create Font" tool meant that text was
  not sized properly. it's now been tweaked to more closely resemble
  the sizing used by the platform. for  instance, 48 point type of a
  font in illustrator looks like 48 point type of the same font in
  processing. 


additions: 

- hex(), binary(), unhex(), and unbinary() functions to make your
  geeky debugging sessions that much happier. 
  color c = #ffcc00;
  println(hex(c));

- support for text in a box: text(String text, x, y, width, height);
  this is like the text box in adobe illustrator or programs like 
  that, note that the x, y where it starts will be the top of the
  line of text, not the baseline of the text as is the case for
  the other text() functions.

- operators for int(), string(), char(), and other basic types.
  String s = "10.2";
  float f = float(s);
  making it simpler to do conversions between types.

- these operators also work on arrays:
  String s[] = { "10.2", "3.2" };
  float f[] = float(s);

- looping can be turned on/off via loop() and noLoop(). the default is
  that loop() is in use. there's also a redraw() function that you can
  use in noLoop() mode which lets you redraw the screen once (i.e. if
  you want to update after a mouse event)

- multiple files! you can create new tabs that store separate classes
  and pieces of code. how happy. however, the tabs are only separators
  for your code.. the code is all still added to the main class (the
  first tab) the same way as if the code had appeared all jammed into
  that first file. 

- for advanced users, additional tabs can be java files, which, unlike
  the tabs described above, will *not* be embedded into the main
  applet class. to create  a java file, include ".java" at the end of
  the new file's name when creating the new tab. also note, however,
  that the java files will not go through the preprocessor, meaning
  that 0.1 will have to be 0.1f if it's a float, and some other
  tidbits like that.

- the "examples" folder for sketches is read-only. "save as" of an
  example won't save it inside the examples folder.
  http://processing.org/discourse/yabb/YaBB.cgi?board=BugFixes;action=display;num=1096295037;start=0

- read-only sketches (i.e. from a CDROM) are now handled properly.

- you can save sketches anywhere you want. and there's a preferences
  dialog that lets you set the location of your sketchbook. that
  annoying "sketchbook/default" thing is no more. in preferences, 
  you can also set whether processing should ask your for the file
  location & name for each new sketch, or if you just want the old
  behavior (automatically created sketch named sketch_yymmdd).
  http://processing.org/discourse/yabb/YaBB.cgi?board=BugFixes;action=display;num=1096295141;start=0

- holding down 'shift' and hitting the 'new' button will do the
  opposite behavior for "new sketch" (i.e. if "prompt for sketch name"
  is selected in preferences, it won't prompt, and vice versa).

- preferences and sketchbook are now stored in: 
  macosx: /Users / yourusername / Documents / Processing
  windows: Documents and Settings / yourusername / My Documents / Processing
  linux: home directory -> .processing 
  you can change the sketchbook location, but this folder will
  continue to be used to store preferences.txt and other files that
  may be needed in the future.

- a default template can be used for exporting applets. copy
  applet.html from processing's "lib" folder to your sketch's folder,
  and modify it to your heart's content. each time you re-export, your
  html file will be used instead of the standard one.
  http://processing.org/discourse/yabb/YaBB.cgi?board=BugFixes;action=display;num=1096297644;start=0
  http://processing.org/discourse/yabb/YaBB.cgi?board=BugFixes;action=display;num=1096297669;start=0
  http://processing.org/discourse/yabb/YaBB.cgi?board=BugFixes;action=display;num=1096297787;start=0

- javascript support is now handled by saying
  "Import Library -> javascript"

- for advanced users, what was formerly called 'bagel' is now in
  package processing.core. we'll refer to this as "core", and the
  files can be found in lib/core.jar of the processing folder. no more
  pde.jar and separate extraction methods for 1.1 code and 1.3 code to
  be used with other IDEs.


minor additions:

- tweaked up the menus. the "Tools" menu will be user-expandable in a
  future release. 

- added some better error messages for common compiler errors.

- sketches with a large 'data' folder will run better
  http://processing.org/discourse/yabb/YaBB.cgi?board=BugFixes;action=display;num=1096300630;start=0

- added a preference for auto-cleaning the sketchbook.

- the console is emptied each time a new sketch is opened.

- PImage.filter(GRAYSCALE) will make an image grayscale. 
  PImage.filter(BLACK_WHITE) does something else fascinating.

- hint(NO_DEPTH_TEST) will disable the zbuffer (unhint will re-enable)
  http://processing.org/discourse/yabb/YaBB.cgi?board=BugFixes;action=display;num=1096303102;start=0

- printarr() works like println() for arrays.. it just prints out a
  long list of the array contents.

- added a lerp() function
  http://processing.org/discourse/yabb/YaBB.cgi?board=Programs;action=display;num=1083289030;start=0

- added angleMode(DEGREES) and angleMode(RADIANS)
  http://processing.org/discourse/yabb/YaBB.cgi?board=BugFixes;action=display;num=1096303599;start=0

- noiseSeed and randomSeed help make random() less random.
  http://processing.org/discourse/yabb/YaBB.cgi?board=BugFixes;action=display;num=1096304206;start=0

- added a boolean variable called 'focused' that is set to true when
  your applet has focus. use this to tell the user "click inside the
  applet" or whatever.

- saveFrame no longer dies when it includes folder names. it also
  saves to the sketch folder.
  http://processing.org/discourse/yabb/YaBB.cgi?board=BugFixes;action=display;num=1096303714;start=0

- inputFile() returns a File object after prompting the
  user. outputFile does the same after asking "save as..."

- for those dismayed by things flying into the camera.. we regret that
  this release still does not properly implement clipping planes. in
  the meantime, an option has been added to avoid some of the mess. 
  it's incomplete and doesn't always work, but adding
  hint(NO_FLYING_POO) to your code might improve the situation. 

- savePath(String filename) returns the full path name for a file to
  be saved relative to the sketch directory. createPath(File dir) will
  create all necessary subfolders in a long path. 


bug fixes:

- PGraphics will now properly draw as an image
  http://processing.org/discourse/yabb/YaBB.cgi?board=BugFixes;action=display;num=1096304847;start=0
  http://processing.org/discourse/yabb/YaBB.cgi?board=Syntax;action=display;num=1080671926;start=0

- tab key should be working again
  http://processing.org/discourse/yabb/YaBB.cgi?board=BugFixes;action=display;num=1096304457;start=0

- fixed several bugs with things like color(), red(), etc. color() now
  works outside functions, but assumes that you mean rgb/255. 
  http://processing.org/discourse/yabb/YaBB.cgi?board=BugFixes;action=display;num=1096303467;start=0
  http://processing.org/discourse/yabb/YaBB.cgi?board=BugFixes;action=display;num=1096303540;start=0
  http://processing.org/discourse/yabb/YaBB.cgi?board=BugFixes;action=display;num=1096303568;start=0

- fixed some oddness with lines fading out
  http://processing.org/discourse/yabb/YaBB.cgi?board=BugFixes;action=display;num=1096303365;start=0
  http://processing.org/discourse/yabb/YaBB.cgi?board=BugFixes;action=display;num=1096303406;start=0

- net is completely rewritten and now works properly.

- fixed bug in polygon filling
  http://processing.org/discourse/yabb/YaBB.cgi?board=BugFixes;action=display;num=1096303189;start=0

- tweaks to make video less of a headache
  http://processing.org/discourse/yabb/YaBB.cgi?board=BugFixes;action=display;num=1096302179;start=0
  http://processing.org/discourse/yabb/YaBB.cgi?board=BugFixes;action=display;num=1096302509;start=0
  http://processing.org/discourse/yabb/YaBB.cgi?board=BugFixes;action=display;num=1096302580;start=0

- lots of fixes to "Create Font".. plus better multi-language support 
  for non-ascii characters (i.e. Japanese) 
  http://processing.org/discourse/yabb/YaBB.cgi?board=BugFixes;action=display;num=1096303772;start=0

- fixes to random()
  http://processing.org/discourse/yabb/YaBB.cgi?board=BugFixes;action=display;num=1096302935;start=0

- fixed some nasty find/replace bugs
  http://processing.org/discourse/yabb/YaBB.cgi?board=BugFixes;action=display;num=1096297457;start=0
  http://processing.org/discourse/yabb/YaBB.cgi?board=BugFixes;action=display;num=1096297524;start=0
  http://processing.org/discourse/yabb/YaBB.cgi?board=BugFixes;action=display;num=1096297575;start=0

- sketchbook is now sorted properly
  http://processing.org/discourse/yabb/YaBB.cgi?board=BugFixes;action=display;num=1096297115;start=0

- beautify now pays attention to your tab settings
  http://processing.org/discourse/yabb/YaBB.cgi?board=BugFixes;action=display;num=1096294561;start=0

- re-adding a file to the data file no longer destroys it
  http://processing.org/discourse/yabb/YaBB.cgi?board=BugFixes;action=display;num=1096294854;start=0

- fixed a goofy compiler OutOfMemoryError when no return on the last line
  http://processing.org/discourse/yabb/YaBB.cgi?board=BugFixes;action=display;num=1096297246;start=0

- fixed compiler error messages to not get jammed onto a single line


. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 


ABOUT REV 0069 - 28 march 2004

this is yet another bug fix release, which repairs several things, 
mostly things that i've run into over the past few as i've been doing
a lot of coding with processing, and some things that were really
causing trouble for folks on the board. basically i was bummed out to
see bug reports on things that i had fixed, or could fix semi-easily.

i'm not releasing linux for this one for lack of time. it will also
not be listed (at least not initially) as the default download on the
page, since it hasn't been tested heavily: this release might not be
particularly stable, i threw it together because i've been working
with p5 a lot lately and had several fixes, but didn't have the time
to do the usual "vetting" process with the testers. if you have any
weird problems, just use 0068.

it's likely that a handful of the examples are also broken because of
the api changes.. my apologies.. 

there will likely be a couple more releases before the "big" 
release that i still need a better name for than "the big release".
suggestions are welcome.


[ ide fixes / changes ] 

- fixed the ever-annoying problem of using video with a 'code' folder.
  http://processing.org/discourse/yabb/YaBB.cgi?board=Proce55ing_software_bugs;action=display;num=1077900024
  http://processing.org/discourse/yabb/YaBB.cgi?board=Proce55ing_software_bugs;action=display;num=1069724180;start=0
  http://processing.org/discourse/yabb/YaBB.cgi?board=Proce55ing_software_bugs;action=display;num=1073523928;start=0
  http://processing.org/discourse/yabb/YaBB.cgi?board=Proce55ing_software_bugs;action=display;num=1076679293;start=0
  http://processing.org/discourse/yabb/YaBB.cgi?board=Proce55ing_software_bugs;action=display;num=1076649501;start=0

- added an option to pde.properties so that users can set the amount
  of memory to for java mode applications. currently it's set to:
  run.external.memory=128
  http://processing.org/discourse/yabb/YaBB.cgi?board=Proce55ing_software_bugs;action=display;num=1078699341;start=0

- wheel mouse should now be working when using java 1.4 on the mac.
  thanks to jonathan feinberg for the fix!

- lots of fixes to the font builder. remembers previous settings,
  doesn't die on small fonts

- added CFBundleIdentifier to mac version so that it's more osx savvy.
  http://processing.org/discourse/yabb/YaBB.cgi?board=Proce55ing_software_bugs;action=display;num=1078739015

- *temporarily* disabled "replace all" because it's doing more harm
  than good as of now. it will be back in the next release, i just
  didn't have time to repair it for this one, and since it's
  destructive, that's bad.
  http://processing.org/discourse/yabb/YaBB.cgi?board=Proce55ing_software_bugs;action=display;num=1076740626
  http://processing.org/discourse/yabb/YaBB.cgi?board=Proce55ing_software_bugs;action=display;num=1080213711


[ bug fixes ] 

- macosx was flickering several times on startup, no more. this was
  also the cause of some other threading weirdness across other
  platforms. this probably still needs a little work, but it's better.
  http://processing.org/discourse/yabb/YaBB.cgi?board=Proce55ing_software_bugs;action=display;num=1073111031

- some internal fixes to how camera modes worked.. screenX was
  slightly broken for some circumstances

- min() and max() with three variables were broken. no longer.
  http://processing.org/discourse/yabb/YaBB.cgi?board=Proce55ing_software_bugs;action=display;num=1076804172

- the constant for CONTROL wasn't set properly 
  http://processing.org/discourse/yabb/YaBB.cgi?board=Proce55ing_software_bugs;action=display;num=1077058788

- fixed a bug when using non-ascii chars with fonts
  http://processing.org/discourse/yabb/YaBB.cgi?board=Proce55ing_software_bugs;action=display;num=1077475307;start=0

- fixed a bug where split() would throw an Exception on an empty string
  http://processing.org/discourse/yabb/YaBB.cgi?board=Proce55ing_software_bugs;action=display;num=1077664736

- fix bug where single pixel points were ignoring their alpha values


[ api changes & additions ] 

- loadStream() has become openStream(), for better consistency. 

- toInt(), toFloat(), to String() functions.. 
  ** the naming of these are subject to change..     **
  ** we haven't decided on a proper naming for them! **

- splitStrings() becomes just split().. splitInts() goes away. 
  splitInts becomes -> toInt(split(someString, ','));

- split() now handles multiple chars, i.e. 
  split(someString, ", ") will split on any number of comma or space
  chars in between (sort of a regexp but not really).
  to split on commas and any amount of whitespace between, use:
  split(someString, "," + WHITESPACE);

- WHITESPACE is a String constant that includes the normal whitespace
  chars (space, tab, linefeed, carriage return, etc) plus the unicode
  "non breaking space" char.

- chop() function that also handles the unicode non-breaking space
  character (found commonly on the mac)

- text(x, y, z) instead of just text(x, y)

- printMatrix() and printCamera() print the current (object space)
  transformation matrix and the camera (perspective) matrix. 

- nf() and nfs() now work on whole arrays of numbers

- nfp() is like nfs() but shows a plus sign instead of a space

- code from toxi to support .tga files in loadImage()
  http://processing.org/discourse/yabb/YaBB.cgi?board=Programs;action=display;num=1078459847;start=0

- bagel code is getting less 1.1 vs. 1.3 specific, thanks to additions
  from jonathan feinberg.


. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 


ABOUT REV 0068 - 2 february 2004

this is a bug fix release, not the planned version of 68 that supports 
multiple files and all sorts of amazing magic. it will be the last release 
for the next two months while ben finishes his dissertation. 


[ bug fixes ]

- concave/convex polygons are now handled properly. just don't make
  the last point of the polygon be the same as the first, otherwise
  you'll confuse the tesselator. however! there is a bug (that showed
  up during the release process.. ugh) that when smoothing is enabled,
  sometimes thin lines will be visible within a concave polygon. this
  will just have to be fixed in a future release. however, as long as 
  stroke() is enabled on the polygon, the lines should not be visible.

- fixed a bug that made the p5 environment freeze when an applet crashed

- fixed problem with the environment locking up when the console got
  too full. the console now has a maximum number of lines, set to 500 
  by default. the console is also cleared on each run, so that doesn't 
  cause trouble anymore. you can change both settings in pde.properties.
  http://processing.org/discourse/yabb/YaBB.cgi?board=BugFixes;action=display;num=1075759355

- fixed a find/replace bug that made the thing lock up when changing
  case on a search. oops.
  http://processing.org/discourse/yabb/YaBB.cgi?board=BugFixes;action=display;num=1075416670
  http://processing.org/discourse/yabb/YaBB.cgi?board=BugFixes;action=display;num=1075416741

- fix to the noise() function by toxi (thanks toxi!)

- fix to the sphere() function by toxi (yay toxi!)

- font builder should update when the size for the font is changed
  (so long as the size itself is valid)

- font builder bug, was cutting off parts of letters

- better loadStream support when bagel is used by itself


[ features ] 

- added support for non-ascii characters in the font builder
  http://processing.org/discourse/yabb/YaBB.cgi?board=Programs;action=display;num=1067596427

- added an option to disable smoothing on font creator

- better support for international characters inside the development
  environment. 

- toxi added sphereDetail(), to set the level of accuracy on spheres


. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 


in spite of their historical feel good campiness, i've removed the
notes from earlier releases because this file was getting out of hand. 
