Java QuickDraw

Apple has donated the source code of Macpaint and the original Quickdraw libraries to the computer museum. If you are interested in Quickdraw, you can download the original Quickdraw 68K assembly code there.

A long time ago, before starting my PhD, I wrote a java library to render Quickdraw files (aka Macintosh PICT files), at the time, the goal was to have an applet to display PICT files inside web-pages. At the time, there was no vector format, so embedding PICT files into web pages ideas seemed like a cool idea.

If you are looking for Java code to parse Quickdraw file, there is a framework called twelvemonkeys imageio under the BSD license which handles most of the features of Quickdraw files and is much more modern than mine, so I recommend you check it out. The maintainer, Harald Kuhr contacted me to reuse portions of my code in his framework, and if you see missing features, I encourage to help him back-porting Java Quickdraw into his framework.

The original code was written for Java 1.0, I refactored once the code during my PhD to use Java 1.1 facilities, and I am currently in the process of cleaning up the code. My goal would be to write a newer rendering back-end based on Graphics2 facilities. The current code uses hacks to go around the limitations of the original graphics class.

Currently, the code supports the following opcodes (both Quickdraw 1 and 2 format):

  • Lines, Rectangles, Rounded Rectangles, Polygons, Circles. The draw and fill operations are fully supported, there are hacks for the highlight and invert operations, but they don’t work well.
  • Color operations. The library supports color selection using both the very old quickdraw 1 color operators and the quickdraw 2 operations. Patterns are currently converted into colors.
  • Basic text-rendering with very limited font selection (basically times and helvetica). The library associates the text and the rectangles, so you can ask the library for the text at a given point.
  • Pixmaps, the library supports 1,2,4,8,16 and 24 bit bitmaps both in uncompressed and RLE compressed format.
  • Embedded Quicktime Media. The library supports images encoded using the photo/jpeg codec.
  • There is preliminary code for region operations. It does not work yet. But even Apple seems to have trouble with those, Mac OS X’s preview seems unable to handle them correctly.
  • Polygon start and end comments are used to speed up polygon rendering by avoiding the recalculations of colors between lines.
  • Text begin and end comments are used to build the strings associated with rectangles. This avoids that a word or sentence broken up in multiple drawText operations is understood as being multiple text bits.

Here are the things I would like to do, time permitting.

  • Implement a more modern GraphPort implementation that uses the Graphics2 operations.
  • Render patterns as patterns.
  • Render the invert mode correctly.
  • Implement a more modern Applet with double buffering and some basic swing interface.
  • Improve the text handling, in particular, extra-spacing in text.
  • More robust QuickTime opcode handling.
  • Handle more codecs, TIFF, BMP and such seem doable.

You can download the JavaQuickdraw.jar file. It also contains a basic PICT viewer, you can launch it with the following command: java -cp JavaQuickdraw.jar ch.epfl.lse.jqd.awt.QDFrame . The current version dumps all the opcodes to the standard output. If you are interested in the source code, please contact me. If you have wierd PICT files, please send them to me, so I can test them.

Java Quickdraw screen capture

The picture is a complex map of a city I did for some roleplaying supplement a long time ago.

One thought on “Java QuickDraw

Leave a Reply