JavaGD - Java Graphics Device
RForge.net

JavaGD

About JavaGD
SVN access
Download/Files
News
Check results
Package R docs

About JavaGD
What is JavaGD?
        

JavaGD is a package for R (see www.r-project.org) providing a Java Graphics Device, that is a device delegating all painting functions of R to a Java class. The default implementation provides an object of the class Canvas, which can be used in any Java application. Currently the main use of JavaGD is in the JGR project, but it doesn't depend on it.

What's new?
2008/03/14 Release of JavaGD 0.5-0 (added support for R >=2.7.0, R Java configuration and improved symbol handling)
2007/04/24 Release of JavaGD 0.4-2 This release is a critical update recommended to everyone! Previous 0.4-versions crashed JVM garbage collector.
2007/05/01 Release of JavaGD 0.4-1 (minor fixes)
2007/04/24 Release of JavaGD 0.4-0 (add support for devies loaded via rJava; minor bug fixes and cleanups)
2007/03/06 Release of JavaGD 0.3-6 (added support for Symbol font used to display math symbols)
2006/09/15 Release of JavaGD 0.3-5. Java sources are now included in the distribution tar ball.
2005/05/02 Release of JavaGD 0.3-3 on CRAN. Please note that future versions will not necessarily announced here - please see CRAN for the most recent version of JavaGD.
2004/10/14 Release of JavaGD 0.2-0
2004/10/02 Release of JavaGD 0.1-7 which works for both R 2.0.0 and 1.9.1.
2004/05/12 First public release of JavaGD 0.1-3
2004/02/02 All RoSuDA packages are now available via install.packages with contriburl="http://www.rosuda.org/R" parameter.
Download and Release notes
The JavaGD package can be installed from CRAN (including binaries for Windows and Mac), e.g. using:
install.packages("JavaGD")
Releases and development snapshots are available in the files section.

Other downloads:
Java class sources: JavaGDjsrc_0.2-0.tar.gz
(Those are deprecated. Please note that the current sources are included in the JavaGD release in the src/java directory)

The package requires R 1.9.0 or later, because major changes have been made in the graphics device interface between R 1.8.1 and 1.9.0. The package itself is considered beta and is more likely to be useful for developers than end users. It is, however, successfully user in JGR.

Documentation
The only available documentation at the moment is the help page in R and the commented sources in the package (including JavaDocs in the Java sources). Once installed and loaded with library(JavaGD) a new window can be created by the JavaGD() command. For now the initialiation is automatic only in JGR. Stand-alone instructions should follow later...

Beside the usual CLASSPATH environment variable JavaGD honors the JAVAGD_CLASS_NAME environment variable which can be set to specify custom Java class which will be used to fire up a new window. The class must implement all gdXXX methods and constructors of org.rosuda.JavaGD.JavaGD and the class name must be in fully-qualified JNI notation, so the default is "org/rosuda/JavaGD/JavaGD".

JavaGD was developed by Simon Urbanek, but anyone interested is welcome to contribute since the package is released under GPL.