notes, bugs, todos, info about svn stuff, additions to faq

build/howto.txt

@@ -17,21 +17,21 @@ http://processing.org/discourse/yabb_beta/YaBB.cgi?board=os_core_pde
 
 ** of the packages, begin with the defaults, and add:
 
-+ cvs - used for version control
++ subversion - used for version control
 
 + make, gcc-mingw, and g++ - used to build processing.exe
   (this will also pull in gcc-core)
 
-+ perl - use this version, activestate or other distros have trouble
++ perl - use this version from cygwin, activestate or other windows 
+         perl distributions have trouble
 
 + unzip, zip - for dealing with archives
 
-+ included in the defaults, but make sure:
-  coreutils (or textutils), gzip, tar
++ included in the defaults, but make sure: coreutils, gzip, tar
 
 + not required but useful: 
   openssh - command line ssh client
-  nano - handy/simple text editor
+  nano - handy/simple text editor (gnu pico ripoff)
 
 ** and be sure to leave the option selected for 'unix line endings' 
 
@@ -46,34 +46,27 @@ installer every few months to keep things fresh.
     everything from the December 2002 Tools for Jaguar on OS X 10.2, 
     up through the more recent Xcode stuff. 
 
+    You'll also need subversion: http://subversion.tigris.org/
+    Which can be downloaded through Fink, or as a package from:
+    http://metissian.com/projects/macosx/subversion/
+
 
 1c. On Linux, you're pretty much on your own.. You need a pretty 
-    standard development setup.
+    standard development setup along with Subversion.
 
 
 2. GRAB THE CODE FROM DEV.PROCESSING.ORG
 
-We use CVS for version control because it's what we know. There's a
-CVS repository at dev.processing.org that you can use to get the code.
+As of August 12, 2005, we're no longer using CVS and have moved on to
+the brave new world of Subversion. This is scary but hopefully will
+alleviate some of the CVS annoyances. 
 
-To get the code, first type this from a prompt:
-
-cvs -d:pserver:anonymous@dev.processing.org:/var/cvs login
-
-The password, just like the user name, is just "anonymous" (no
-quotes). After that, type the following to actually get the code:
-
-cvs -z3 -d:pserver:anonymous@dev.processing.org:/var/cvs co processing
+To get the code, type this from a prompt:
+svn co svn://processing.org/trunk/processing
 
 That part may take a while, especially for people outside the US or
 who have a slow internet connection.
 
-After that's complete, clean out the empty folders or old detritus:
-
-cd processing
-cvs update -P
-cd ..
-
 
 3. INSTALL QUICKTIME FOR JAVA (Windows users only)
 
@@ -122,33 +115,28 @@ cd /path/to/processing/build/macosx
 5a. Each time you want to update to latest version from cvs:
 
 cd /path/to/processing
-cvs -z3 update
-# -z3 means make it snappy (using compression)
+svn update
 
 
-5b. If new folders have been added, or you're gettin odd errors, use:
+5b. If you're getting strange errors when you try to build, especially
+    if new folders have been added to the Processing repository, remove
+    your 'work' folder and rebuild.
 
 # get to the processing folder
 cd /path/to/processing
 
 # remove the work directory
+cd build/yourplatform
 rm -rf work
 
-# -d grabs new directories and -P cleans out old (empty) ones
-# cvs is a little brain dead about this stuff
-cvs -z3 update -d -P
+# and try again
+./make.sh
 
 Unfortunately there isn't a way to know (?) if new folders have
 since been added. but if you're getting "class not found" errors
 while building, then that's a good indicator that something is
 missing from a subfolder.
 
-If there have been significant changes, or you get weird build
-errors, try deleting your 'work' folder. This will create a 
-fresh build. This includes any changes to the reference, 
-the examples, the libraries, jikes, or just about any time you
-have to use -d -P with the update.
-
 
 ////////////////////////////////////////////////////////////////////
 
@@ -173,4 +161,4 @@ of critical mass.
 ////////////////////////////////////////////////////////////////////
 
 
-Ben Fry - 16 July 2005
+Ben Fry - 13 August 2005

core/PGraphics3.java

@@ -3219,6 +3219,26 @@ public class PGraphics3 extends PGraphics {
 
 
 
+  //////////////////////////////////////////////////////////////
+
+
+  // strokeWeight() doesn't really work properly either,
+  // but that will be dealt with in some other way.
+
+
+  public void strokeJoin(int join) {
+    String msg = "strokeJoin() not available with P3D";
+    throw new RuntimeException(msg);
+  }
+
+
+  public void strokeCap(int cap) {
+    String msg = "strokeCap() not available with P3D";
+    throw new RuntimeException(msg);
+  }
+
+
+
   //////////////////////////////////////////////////////////////
 
 

core/todo.txt

@@ -9,6 +9,7 @@ o   more like textLeading() etc
 X   nope, because it requires grabbing the font metrics and other calculations
 X bezierDetail, curveDetail made public
 X added textMode(SHAPE) for OPENGL
+X error message saying that strokeCap and strokeJoin don't work in P3D
 
 nixed or fixed in previous releases
 X textMode(SCREEN) having issues on Mac OS X
@@ -23,6 +24,11 @@ _ prevent PGraphics.save() from inserting a file prefix
 _   so that people can use absolute paths
 _   or add a version that takes a file object
 
+_ make vertexCount etc properly accessible in PGraphics3
+_   so that people can do things like the dxf renderer
+_ also have a simple way to hook in triangle leeches to PGraphics3
+_   this exists, but needs to be documented, or have accessors
+
 _ recordFrame() and beginFile()/endFile()
 _   finalize api with more work on multi-page pdf
 _   how to deal with triangles/lines and triangleCount and lineCount
@@ -103,7 +109,6 @@ _ allow save(), saveFrame() et al to properly pass in absolute paths
 _   (so that it doesn't always save to the applet folder)
 _   could require that save() takes an absolute path?
 _ size() inside draw is missing a new call to cameraMode, etc
-_ framerate(30) is still flickery and jumpy..
 _ fix param() to use a sketch.properties file when run as an app
 _   make this also be used in generating the html file
 _ fix link() to handle relative URLs
@@ -141,6 +146,7 @@ _ should image i/o and sound i/o be moved into PImage and PSound?
 _   how to load external encoders/decoders
 _ placement of 100x100 items is odd
 _   happens with P3D and maybe also P2D?
+_   http://dev.processing.org/bugs/show_bug.cgi?id=128
 _ scripts: how to make a long setup() sleep so that things don't lock way up
 _ fileInput() and fileOutput() may not agree with draw()
 _   not yet verified
@@ -227,6 +233,8 @@ _   and then does 5 step sizes for each curveto
 
 CORE / PGraphics
 
+_ finish implementation so 1.1 support can return
+_   http://dev.processing.org/bugs/show_bug.cgi?id=125
 _ alter bezier and curve matrices to use PMatrix
 _   float array stuff is redundant with code that's in PMatrix
 _   and PMatrix has to be included even w/o P3D so...
@@ -341,6 +349,8 @@ _   x, y not setting with processing
 _ don't let users on < 1.3 load JAVA2D
 _ set upper bound on framerate so as not to completely hose things?
 _ fix the flicker in java2d mode
+_   http://dev.processing.org/bugs/show_bug.cgi?id=122
+_   framerate(30) is still flickery and jumpy..
 _   not clear what's happening here
 _   appears to be much worse (unfinished drawing) on macosx
 _     try turning off hw accel on the mac to see if that's the problem
@@ -394,15 +404,11 @@ _   maybe not setting fill color when drawing textures
 _   guessing it's an implementation issue in sami's renderer
 _   check with the a_Displaying example and tint(255, 0, 0, 100);
 _   http://dev.processing.org/bugs/show_bug.cgi?id=90
-_ apply tint() to textures as well
-_   otherwise no good way to color textures
+_ is fill() not coloring textures properly?
+_   don't need to apply tint() to textures, supposed to use fill color
 _ Stroking a rect() leaves off the upper right pixel
-_ make vertexCount etc properly accessible in PGraphics3
-_   so that people can do things like the dxf renderer
-_ error message saying that strokeCap and strokeJoin don't work
 _ PPolygon no longer in use and PLine is a mess
-_ also have a simple way to hook in triangle leeches to PGraphics3
-_   this exists, but needs to be documented, or have accessors
+_   make a version of PGraphics3 that uses it for more accurate rendering?
 _ add option to sort triangles back to front so alpha works
 _   http://processing.org/discourse/yabb/YaBB.cgi?board=Proce55ing_software_bugs;action=display;num=1076660476
 _ texture mapping
@@ -517,6 +523,13 @@ _   or is it a java 1.4 versus java 1.3 problem?
 _   http://processing.org/discourse/yabb/YaBB.cgi?board=Proce55ing_software_bugs;action=display;num=1081645955
 
 
+CORE / General 
+
+_ remove some of the bloat, how can we make things more compact?
+_   i.e. if not using 3D, can leave out PGraphics3, PTriangle, PLine
+_   PPolygon isn't currently used for anything, should remove it
+_   http://dev.processing.org/bugs/show_bug.cgi?id=127
+
 
 ////////////////////////////////////////////////////////////////////
 ////////////////////////////////////////////////////////////////////
@@ -574,6 +587,7 @@ _ need to write an error if people try to use opengl with 1.3 (i.e. on export)
 _   http://processing.org/discourse/yabb_beta/YaBB.cgi?board=Contribution_3DOpenGL;action=display;num=1114368123;start=3
 _ grabbing sun.cpu.endian throws a security exception with gl applets
 _   http://processing.org/discourse/yabb_beta/YaBB.cgi?board=Contribution_3DOpenGL;action=display;num=1114368123;start=3
+_ strokeWeight() doesn't work in opengl or p3d
 
 
 PGraphicsAI

todo.txt

@@ -487,6 +487,7 @@ TOOLS / General
 _ how to handle command keys
 _   http://processing.org/discourse/yabb_beta/YaBB.cgi?board=Suggestions;action=display;num=1114885272
 _ make dynamically loaded plugins and "tools" menu
+_   http://dev.processing.org/bugs/show_bug.cgi?id=124
 _   break out beautify as its own plugin
 _ color picker or other things written by folks
 _   add all .jar files in lib/plugins on startup