This page is used to track the progress of the image package rewrite.

TO DO

done

Create the basic interfaces and classes: ImageManager, ImageImplRegistry, Image, ImageSource, ImagePreloader, ImageLoader, ImageConverter and ImageConverterPipeline.

done

Implement Dijkstra's shortest path algorithm to construct ImageConverterPipelines. This will automatically select the best way to acquire an image for a certain rendering situation.

done

Verify that the image conversion pipeline approach works.

done

Dynamic registration of all service provider interfaces (ImagePreloader, ImageLoader & ImageConverter)

done

Select a suitable way to represent the original image source (URI & data source). Decision: Use JAXP Source as base. ImageSource (extends Source) contains an ImageInputStream (from ImageIO). ImageInputStream provides the "push back" functionality I mentioned in the requirements, or rather it allows to seek back indefinitely caching the byte stream either in memory or in a temp file.

done

Distinguish between local file URLs and other URLs. File URLs are converted to File objects so ImageInputStreams can be created that operate directly on the file which makes caching unnecessary.

done

Reimplement Readers as ImagePreloaders for all supported formats. done: SVG, PNG, GIF, TIFF, WMF, EMF, EPS, BMP, JPEG

done

Fully implement intrinsic size determination (size plus resolution) in ImagePreloaders for PNG and TIFF. PNG using ImageIO which is now always available after switching to Java 1.4. TIFF using XML Graphics Commons' TIFF codec.

done

Reimplement the image loading code of the old Image implementations as ImageLoaders. done: ImageIO, Batik(SVG&WMF), raw formats (EPS, JPEG and CCITT), extension examples (Plan and MathML).

done

Implement all necessary ImageConverters. done: SVG->G2D, WMF->G2D, G2D->BufferedImage/RenderedImage, RenderedImage->G2D, RenderedImage->PNG.

done

Write unit test for as much of the functionality as possible/reasonable.

done

Write Javadocs

done

Verify that undecoded images (TIFF with CCITT G4, JPEG, PNG, EPS) are properly supported by the architecture in order to have minimal memory usage and maximum performance (no more passing around byte arrays). done: JPEG, EPS, CCITT. PNG didn't work.

done

Implement transparent support for GZIP encoded streams.

done

Allow SAXSource and DOMSource for XML-based images. Not implemented but generally supported by the architecture (JAXP Source)

done

Reimplement caching. Cache the various image flavors separately of each other. Identify uncacheable image flavors.

OPEN

Make sure all streams are properly closed.

OPEN

Support injection of manually built Image subclasses through the Source mechanism (meaning: act during URI resolution and build the final image (ex. as BufferedImage or Graphics2DImagePainter) instead of providing a stream to an encoded image).

done

Decide if the Graphics2DAdapter/Graphics2DImagePainter pair is still in the right place (in the render package) as it is heavily used now in the image package. --> Painter moved, Adapter is renderer-specific and stays

done

Integrate the new image package into the layout engine (ImageInfo/ImageSize), the renderers (Image/ImageFlavor) and the FOP extensions.

done

Reimplement support for baseline adjustment (for MathML)

done

Enhance the existing penalty mechanism to allow manual fine-tuning of the conversion decisions.

done

Create a branch and upload what's there already for early feedback.

done

Write some usage docs. done: basic usage and SPI.

OPEN

Write some design docs on the new design.

Open Questions

Resolved Questions

Observations with the new code while testing