diff --git a/build/howto.txt b/build/howto.txt index f3577ba7a..7622499ff 100755 --- a/build/howto.txt +++ b/build/howto.txt @@ -7,17 +7,20 @@ http://processing.org/discourse/yabb_beta/YaBB.cgi?board=os_core_pde //////////////////////////////////////////////////////////////////// -Update 16 February 2010: +Update February/March 2010: + I'm in the midst of moving the build system over to ant, but haven't yet had time to update this document. For the most part, as long as you - have a JDK installed, and ANT installed as well, you should be able to + have a JDK installed, and Ant installed as well, you should be able to cd to the build folder and type 'ant' to build, and 'ant run' to run. + On Windows and Linux, install ant and add c:\apache-ant-xxx/bin directory to your path. On Mac OS X, you'll have ant as long as the dev tools are already installed. ++ On Windows and Linux, you'll need to set a JAVA_HOME environment variable + that points to the root of a full JDK (not JRE). + Troubleshooting: + An error message that reads "Unable to locate tools.jar. Expected to find @@ -25,7 +28,7 @@ Troubleshooting: JAVA_HOME to your JDK (not JRE) installation. + Build errors regarding a lot of missing classes for processing.app.debug - mean that JAVA_HOME is + mean that JAVA_HOME is not set properly. More to come... @@ -161,32 +164,3 @@ 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. - - -//////////////////////////////////////////////////////////////////// - -//// The Frequently Asked Question - -- What about Eclipse? What about Ant? Command line sucks. - -The command line stuff isn't as scary as it might initially -seem. Hopefully it's just a matter of following the instructions above -(and being patient). If not, let us know (via the discourse board) -where you have trouble so we can fix things. - -We're slowly moving development over to Eclipse, which will probably -include Ant because of cross-platform dependencies. As of release 0140, -major changes are being implemented to simplify the build process, -which should mean that we're pretty close. The environment and all -the libraries build properly with Eclipse, however we won't be -documenting it until the dust has settled. - -Some progress has been made by John Houck to get the scripts working -under ANT, progress can be tracked here: -http://dev.processing.org/bugs/show_bug.cgi?id=151 - - -//////////////////////////////////////////////////////////////////// - - -Ben Fry - Updated 10 June 2008 diff --git a/core/todo.txt b/core/todo.txt index aa49cd972..f978e29dc 100644 --- a/core/todo.txt +++ b/core/todo.txt @@ -3,7 +3,25 @@ X screenWidth/Height instead of screenW/H X open up the pdf library more (philho) X http://dev.processing.org/bugs/show_bug.cgi?id=1343 X cache font information for the PDF library to improve setup time +X when using createFont("xxxx.ttf"), should use textMode(SHAPE) with PDF +X because ttf files will not be installed on the system when opening pdf +X added error messages for users +X bring back old-style textAscent() +X needs to just quickly run characters d and p +X only takes a couple ms, so no problem +X pdf library +X throw an error with the black boxes +X throw an error if loading fonts from a file, and not using mode(SHAPE) +earlier +X if no draw() method, and renderer is not displayable, then exit +X static mode PDFs shouldn't just hang + + +_ implement default font +_ this can be done to replace the exception handler in PGraphics +_ however it needs to be a legit font, so that it works w/ pdf +_ or maybe pdf just has its own default? big ones _ ortho() behaving differently in P3D vs OPENGL @@ -128,8 +146,6 @@ _ what other methods should work with doubles? all math functions? _ seems like internal (mostly static) things, but not graphics api _ look into replacing nanoxml _ http://www.exampledepot.com/egs/javax.xml.parsers/pkg.html -_ if no draw() method, and renderer is not displayable, then exit -_ static mode PDFs shouldn't just hang [ known problems ] @@ -208,9 +224,6 @@ _ http://dev.processing.org/bugs/show_bug.cgi?id=866 _ text(char c) with char 0 and undefined should print nothing _ perhaps also DEL or other nonprintables? _ book example 25-03 -_ when using createFont("xxxx.ttf"), should use textMode(SHAPE) with PDF -_ because ttf files will not be installed on the system when opening pdf -_ maybe just add this to the reference so that people know _ text position is quantized in JAVA2D _ http://dev.processing.org/bugs/show_bug.cgi?id=806 _ accessors inside PFont need a lot of work @@ -257,7 +270,6 @@ _ also needs fix for last edge and the seam threading and exiting -_ pdf sketches exiting before writing has finished _ writing image file (missing a flush() call?) on exit() fails _ lots of zero length files _ saveFrame() at the end of a draw mode program is problematic @@ -660,6 +672,10 @@ LIBRARIES / PGraphicsPDF _ pdf not rendering unicode with beginRecord() _ http://dev.processing.org/bugs/show_bug.cgi?id=727 +_ pdf sketches exiting before writing has finished +_ people have to call exit() (so that dispose() is called in particular) +_ when using noLoop() and the PDF renderer, sketch should exit gracefully +_ because isDisplayable() returns false, there's no coming back from noLoop diff --git a/todo.txt b/todo.txt index 5de1701e8..ec612f9dd 100644 --- a/todo.txt +++ b/todo.txt @@ -7,14 +7,12 @@ X new examples.zip o Fixes for invoking Processing from arbitrary locations X already fixed with earlier code X http://dev.processing.org/bugs/show_bug.cgi?id=1214 -X bring back old-style textAscent() -X needs to just quickly run characters d and p -X only takes a couple ms, so no problem +X hide android tools if it's an actual release version -_ pdf library -_ throw an error with the black boxes -_ throw an error if loading fonts from a file, and not using mode(SHAPE) _ finish build instructions for 1.1 +_ update build/howto.txt (of course) because it says no ant +_ this would also mean requiring a java installation for building + _ simple prefs implementation to set key/value pairs using a JTable _ the .macosx, .linux, etc prefs should be stripped @@ -49,9 +47,6 @@ from user Batuff > export DISPLAY=localhost:2.0 > ./ -_ update build/howto.txt (of course) because it says no ant -_ this would also mean requiring a java installation for building - _ right-click on opengl.jar and select native lib location from the third prefs _ might be possible to do easier opengl setup for eclipse _ don't allow processing to run on snow leopard with 1.5