documentation, bug notations, and todos

build/shared/revisions.txt

@@ -4,6 +4,42 @@ reference of how to use processing, because the information for older
 releases will be super crusty. 
 
 
+
+. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 
+
+
+ABOUT REV 0115 - 10 May 2006
+
++ When using Java 1.4 and later, you can now write to several formats 
+  other than tga and tiff. If Java 1.4 is installed and the extension 
+  used is supported (usually png, jpg, jpeg, bmp), then those methods 
+  will be used to write the image. 
+  http://dev.processing.org/bugs/show_bug.cgi?id=165
+  More detailed information is available in the save() section 
+  of the developer's reference:
+  http://dev.processing.org/reference/core/javadoc/processing/core/PImage.html#save(java.lang.String)
+
++ loadImage() also supports image loading in the same manner, which 
+  though it's not recommended for projects that export to the web. 
+  Again, more detailed information is in the developer's reference:
+  http://dev.processing.org/reference/core/javadoc/processing/core/PApplet.html#loadImage(java.lang.String)
+
++ The image loading and saving issues were covered by Bug #165.
+  http://dev.processing.org/bugs/show_bug.cgi?id=165
+
++ loadImage() now works with TIFF images created by Processing. 
+  It will not support TIFF images from other programs. 
+
+
+[ issues ]
+
++ You cannot set the level of compression when writing JPEG:
+  http://dev.processing.org/bugs/show_bug.cgi?id=342
+
++ TIFF writing does not support images that are ARGB or ALPHA format.
+  http://dev.processing.org/bugs/show_bug.cgi?id=343
+
+
 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 
 
 

core/PApplet.java

@@ -3020,15 +3020,27 @@ public class PApplet extends Applet
   /**
    * Load an image from the data folder or a local directory.
    * Supports .gif (including transparency), .tga, and .jpg images.
-   * In Java 1.3 or later, .png images are also supported.
-   * http://java.sun.com/j2se/1.3/docs/guide/2d/new_features.html
+   * In Java 1.3 or later, .png images are
+   * <A HREF="http://java.sun.com/j2se/1.3/docs/guide/2d/new_features.html">
+   * also supported</A>.
    * <P>
    * Generally this should only be used during setup, re-loading
    * images inside draw() is likely to cause a significant delay
    * while memory is allocated and the thread blocks while waiting
    * for the image to load because loading is not asynchronous.
    * <P>
-   * As of 0096, returns null if no image of that name is found.
+   * As of 0096, returns null if no image of that name is found,
+   * rather than an error.
+   * <P>
+   * Release 0115 also provides support for reading TIFF images
+   * that are created by Processing.
+   * <P>
+   * Also in release 0115, more image formats (BMP and others) can
+   * be read when using Java 1.4 and later. Because many people still
+   * use Java 1.1 and 1.3, these formats are not recommended for
+   * work that will be posted on the web. To get a list of possible
+   * image formats for use with Java 1.4 and later, use the following:
+   * <TT>println(javax.imageio.ImageIO.getReaderFormatNames())</TT>
    */
   public PImage loadImage(String filename) {
     if (PApplet.javaVersion >= 1.4f) {

core/todo.txt

@@ -16,17 +16,19 @@ _   java.lang.IllegalArgumentException: Width (-1) and height (-1) cannot be <=
 _   for instance, trying to load a tiff image with the jpg loader
 
 _ test support for reading and writing images that have alpha and imageio
-_ get tiff exporter for p5 to support argb
 
-_ more image file i/o in java 1.4
+_ get tiff exporter for p5 to support argb and gray
+_   http://dev.processing.org/bugs/show_bug.cgi?id=343
+
+X more image file i/o in java 1.4
 X   add dynamic loading of the jpeg, png, and gif(?) encoder classes
-_   http://dev.processing.org/bugs/show_bug.cgi?id=165
-_   http://java.sun.com/products/java-media/jai/index.jsp
-_   http://processing.org/discourse/yabb_beta/YaBB.cgi?board=Programs;action=display;num=1120174647
+X   http://dev.processing.org/bugs/show_bug.cgi?id=165
+X   http://java.sun.com/products/java-media/jai/index.jsp
+X   http://processing.org/discourse/yabb_beta/YaBB.cgi?board=Programs;action=display;num=1120174647
 _ P5 cannot read files generated by saveFrame()
 _   need to update docs re: tga
-_   and add support for reading its own uncompressed TIFs
-_   http://dev.processing.org/bugs/show_bug.cgi?id=271
+X   and add support for reading its own uncompressed TIFs
+_   http://dev.processing.org/bugs/show_bug.cgi?id=260
 
 _ this produces a dark blue background: 
 colorMode(RGB, 100);
@@ -673,6 +675,8 @@ CORE / PImage
 _ don't grab pixels of java2d images unless asked
 _   this is the difference between a lot of loadPixels() and not
 _   so important to have it in before beta if that's the change
+_ add ability to control jpeg compression level with save() and saveFrame()
+_   http://dev.processing.org/bugs/show_bug.cgi?id=342
 _ also when drawing an image, sense whether drawn rotated
 _   specifically, if drawn rotated 90 in either direction, or 180
 _   if just rotate/translate, then can use SCREEN_SPACE for fonts