PJA Toolkit

What is PJA Toolkit ?
Download PJA Toolkit

PJA Toolkit documentation
PJA Toolkit feedback
PJA Toolkit forum

PJA Toolkit features survey

What is PJA Toolkit ?

PJA (Pure Java AWT) Toolkit is a Java^TM library for drawing graphics developed by eTeks. It is 100% Pure Java and doesn't use any native graphics resource of the system on which the Java Virtual Machine runs.
java.awt.Graphics methods such as drawLine (), fillOval (), drawString (),... are implemented in the default JVM with native graphical functions (except in some cases for Java2D) : That means that drawLine () finally calls a GDI system function on Windows or X11 function on a X11/UNIX machine even if the drawing is done in an off-screen image using the class java.awt.Image. This ensures the best performance for drawing graphics with Java.
But in a few cases, this default behavior can cause problems that PJA Toolkit library improves :

When no X11 Display is available on a UNIX machine (also called headless environment) or when GDI resources are low on Windows, it is impossible to compute off-screen images with java.awt.Graphics methods under a JDK version < 1.4, even if your program doesn't need to display these images. Typically, this situation happens for servlets returning dynamically generated images like pies, charts or web counters.
With PJA Toolkit, you don't need to change your Java programs that you expected to run : setting java.awt system property to com.eteks.awt.PJAToolkit is the only required modification to your program with Java 1.1 (see PJA Toolkit FAQ and com.eteks.awt.PJAToolkit class documentation for more information).
It is also impossible to compute off-screen images when the Java security manager forbids access to any Toolkit or the AWT library. In that case you can although create an instance of com.eteks.awt.PJAImage class which extends java.awt.Image, and draw into it with graphics methods.
Drawing with native function doesn't give always the exact same results for each pixel on all platforms. For example, SansSerif font renders differently on MacOS, Windows and other systems : each letter of this font isn't drawn the same, and is different if font anti-aliasing is set or not on the system. On MacOS, circles aren't rendered as specified in Java documentation : fillArc () and drawArc () don't use the same base ellipse...
Finally, PJA Toolkit library available under GNU General Public License is supplied with its Java source files, and is a good exemple for studying :
How pixels are drawn by graphics functions on a computer (com.eteks.awt.PJAGraphics uses Bresenham algorithms to draw lines and circles).
How to use the Java paradigm for managing images specified by the ImageConsumer/ImageProducer/ImageObserver interfaces.
How Java Toolkit works and what it needs to work (which abstract classes and interfaces to implement).
Sources are supplied to allow developers to improve and optimize the graphic drawing methods.
com.eteks.awt package files are Java 1.0 compliant but needs JDK 1.2 or higher library to compile (for Java < 1.2 compilers, this can be done using any Java 2 rt.jar library instead of classes.zip in -classpath option at compile time).

PJA Toolkit library weighs 140 Ko at run-time.

Download PJA Toolkit

PJA Toolkit library is free under GNU General Public License. It is supplied with :

pja.jar and pjatools.jar JAR libraries

Java source files

Javadoc documentation

a FAQ list

versions history

PJANativeToolkitComparison a demo to compare at screen the rendering of the PJA Toolkit and the native toolkit of your system. A speed meter allows to see the average duration of drawing with PJA Toolkit compared to native toolkit.

PJAToolkitDemo a demo that creates GIF files using the PJA Toolkit.

NativeToolkitDemo a demo that creates GIF files using the native toolkit of your system.

PJADemo a demo that creates GIF files using PJA Toolkit and a restrictive SecurityManager that prevents the use of awt library.

PJAFontCapture a Font capture utility to generate font files (to avoid copyright problems on fonts, no font is provided). You can use any machine where AWT works to generate these portable files.

TeksSurveyPie an exemple of a servlet generating a survey pie as seen bellow.

Servlet host providers can use it for their customers, if they provide copyright information and a link to http://www.eteks.com on their web site and other documentation.

Survey : Are you interested by PJA Toolkit ?

Click on one of the following links to download PJA Toolkit :

Windows	pja_2.5.exe (576 Ko)
MacOS 9	pja_2.5.sea.bin (678 Ko)
MacOS X	pja_2.5.dmg (510 Ko)
Other platforms	pja_2.5.zip (507 Ko)

PJA Toolkit version 2.5
Last update : 05/25/2004

Your feedback will be greatly appreciated...