java-gnome(3) C Library Functions java-gnome(3)NAMEjava-gnome - Java bindings for Cairo 2D graphic library and GNOME
libraries.
SYNOPSIS
import org.freedesktop.cairo
import org.gnu.atk
import org.gnu.gconf
import org.gnu.gdk
import org.gnu.glade
import org.gnu.glib
import org.gnu.gnome
import org.gnu.gnome.event
import org.gnu.gtk
import org.gnu.gtk.event
import org.gnu.pango
import org.gnu.gnomevte
import org.gnu.gnomevte.event
DESCRIPTIONjava-gnome is a set of Java bindings for the Cairo 2D Freedesktop.org
graphics API and a subset of bindings for the GNOME 2.x Developer Plat‐
form Libraries namely glib, gtk, atk, gdk, pango, gnome, glade, gconf
and vte which allow GNOME and GTK+ applications to be written in Java.
As one of the Official Gnome Platform Bindings, Java-Gnome follows the
GNOME schedule, and GNOME Bindings rules which guarantee API stability
and time-based releases.
java-gnome bindings consist of the following jars and supporting jni
libraries: glib-java, cario-java, libgtk-java, libgnome-java, libglade-
java, libgconf-java and libvte-java. The first four provide the core
drawing, widget set, font, accessibility and application support for
Gnome Developers. libglade-java provides support to use Glade based XML
UI's in Java applications, created using the Gnome Glade UI designer.
libgconf-java provides an interface to the Gnome configuration database
for Java applications. libvte-java provides access to a gnome terminal
widget.
Java-gnome bindings come with additional documentation: API javadoc,
source code jars for each library and example Java Gtk, Gnome and Glade
applications.
┌───────────────────────┬─────────────────────┬──────────────────────────┐
│ Interface │ Stability │ Comment │
├───────────────────────┼─────────────────────┼──────────────────────────┤
│org.freedesktop.cairo │ Volatile │2D graphics library │
├───────────────────────┼─────────────────────┼──────────────────────────┤
│org.gnu.atk │ Volatile │Gnome Accessibility │
│ │ │ │
│ │ │Support │
├───────────────────────┼─────────────────────┼──────────────────────────┤
│org.gnu.gconf │ Volatile │Configuration Support │
├───────────────────────┼─────────────────────┼──────────────────────────┤
│org.gnu.gdk │ Volatile │Low level drawing support │
├───────────────────────┼─────────────────────┼──────────────────────────┤
│org.gnu.glade │ Volatile │Glade UI design support │
├───────────────────────┼─────────────────────┼──────────────────────────┤
│org.gnu.glib │ Volatile │Low level core API │
├───────────────────────┼─────────────────────┼──────────────────────────┤
│org.gnu.gnome │ Volatile │Gnome application support │
├───────────────────────┼─────────────────────┼──────────────────────────┤
│org.gnu.gnome.event │ Volatile │Gnome application │
│ │ │ │
│ │ │event support │
├───────────────────────┼─────────────────────┼──────────────────────────┤
│org.gnu.gtk │ Volatile │Gtk widget support │
├───────────────────────┼─────────────────────┼──────────────────────────┤
│org.gnu.gtk.event │ Volatile │Gtk widget event support │
├───────────────────────┼─────────────────────┼──────────────────────────┤
│org.gnu.pango │ Volatile │Gnome text │
│ │ │ │
│ │ │rendering support │
├───────────────────────┼─────────────────────┼──────────────────────────┤
│org.gnu.gnomevte │ Volatile │Gnome terminal │
│ │ │ │
│ │ │widget support │
├───────────────────────┼─────────────────────┼──────────────────────────┤
│org.gnu.gnomevte.event │ Volatile │Gnome terminal │
│ │ │ │
│ │ │widget event support │
└───────────────────────┴─────────────────────┴──────────────────────────┘
Note - The above interfaces have been marked as Volatile even though
they are marked as stable by the community [part of the Offi‐
cial Gnome Bindings and so must adhere to API Binding Rules].
The reason for this is that the community is planning an exten‐
sive redesign of the 2.x series of Java-Gnome that will be
released as a new 4.x series. Primary goals are to incorporate
some automation for interface generation and simplify the
exposed API, both of which will ease future maintenance of the
bindings.
This new redesign will break backwards compatibility. However,
as much as possible the community is going to keep the older
interfaces around for several releases after the redesign. As
the two interfaces will use different namespaces they will be
able to be installed on the same system so developers will be
able to plan a controlled deprecation of the 2.x API's they are
using.
FILES
Jar files and shared libraries:
┌─────────────────────────┬─────────────────────┬────────────────────┐
│Spec Files │ Delivers Jars to: │ Delivers libs to: │
│ │ │ │
│ │ /usr/share/lib/java │ /usr/lib │
├─────────────────────────┼─────────────────────┼────────────────────┤
│SUNWgnome-base-libs-java │ glib##.jar │ libglibjni-##.so │
│ │ cairo##.jar │ libcairojni-##.so │
│ │ gtk##.jar │ libgtkjni-##.so │
│ │ glade##.jar │ libgladejni-##.so │
│ │ gnome##.jar │ libgnomejni-##.so │
├─────────────────────────┼─────────────────────┼────────────────────┤
│SUNWgnome-config-java │ gconf##.jar │ libgconfjni-##.so │
├─────────────────────────┼─────────────────────┼────────────────────┤
│SUNWgnome-terminal-java │ libvte##.jar │ libvtejni-##.so │
└─────────────────────────┴─────────────────────┴────────────────────┘
Documentation files:
· API Javadoc for the Java-Gnome libraries
/usr/share/lib/java/javadoc/java-gnome/glib-java-##/api/index.html
/usr/share/lib/java/javadoc/java-gnome/cairo-java-##/api/index.html
/usr/share/lib/java/javadoc/java-gnome/libgtk-java-##/api/index.html
/usr/share/lib/java/javadoc/java-gnome/libgnome-java-##/api/index.html
/usr/share/lib/java/javadoc/java-gnome/libglade-java-##/api/index.html
/usr/share/lib/java/javadoc/java-gnome/libgconf-java-##/api/index.html
/usr/share/lib/java/javadoc/java-gnome/libvte-java-##/api/index.html
· Source jars for the Java-Gnome libraries
/usr/share/lib/java/src/java-gnome/glib##-src.jar
/usr/share/lib/java/src/java-gnome/cairo##-src.jar
/usr/share/lib/java/src/java-gnome/gtk##-src.jar
/usr/share/lib/java/src/java-gnome/gnome##-src.jar
/usr/share/lib/java/src/java-gnome/glade##-src.jar
/usr/share/lib/java/src/java-gnome/gconf##-src.jar
/usr/share/lib/java/src/java-gnome/vte##-src.jar
· Examples for the Java-Gnome libraries
/usr/share/lib/java/javadoc/java-gnome/libgtk-java-##/examples/*
/usr/share/lib/java/javadoc/java-gnome/libgnome-java-##/examples/*
/usr/share/lib/java/javadoc/java-gnome/libglade-java-##/examples/*
/usr/share/lib/java/javadoc/java-gnome/libgconf-java-##/examples/*
ATTRIBUTES
See attributes(5) for descriptions of the following attributes:
┌─────────────────────────────┬─────────────────────────────┐
│ATTRIBUTE TYPE │ATTRIBUTE VALUE │
├─────────────────────────────┼─────────────────────────────┤
│Availability │SUNWgnome-base-libs-java │
│ │SUNWgnome-config-java SUN‐ │
│ │Wgnome-terminal-java │
├─────────────────────────────┼─────────────────────────────┤
│Interface stability │Volatile │
└─────────────────────────────┴─────────────────────────────┘
EXAMPLES
Copy the examples to a directory you have read/write access to so you
can compile and run them. You can use the helper runExample.sh script
provided in the examples directory or compile and run them directly
adding the appropriate jars to the classpath.
1. Compile and run Gtk example:
$ cd ~/examples-gtk
./runExample.sh testgtk/TestGTK
2. Compile and run Gnome example:
$ cd ~/examples-gnome
./runExample.sh testgnome/TestGNOME
3. Compile and run glade example:
$ cd ~/examples-glade
$ javac -classpath /usr/share/lib/java/glib0.4.jar:\
/usr/share/lib/java/gtk2.10.jar:\
/usr/share/lib/java/glade2.12.jar \
glade/LibGladeTest.java
$ java -classpath .:/usr/share/lib/java/glib0.4.jar:\
/usr/share/lib/java/gtk2.10.jar:\
/usr/share/lib/java/glade2.12.jar \
glade/LibGladeTest glade/gtk.glade
SEE ALSO
Java-Gnome Community HomePage:
http://java-gnome.sourceforge.net
Java-Gnome Community Documentation:
http://java-gnome.sourceforge.net/cgi-bin/bin/view/Main/HintsAndTips
Gnome Language Bindings:
http://developer.gnome.org/arch/lang/
Gnome Platform Binding Rules:
http://cvs.gnome.org/viewcvs/web-devel-2/content/dotplan/bindings/rules.html?rev=1.5
Gnome Platform Bindings requirements:
http://live.gnome.org/ReleasePlanning/ModuleRequirements/PlaformBindings
Gtk Bindings:
http://www.gtk.org/bindings.html
NOTES
This man page was written by John Rice, Sun Microsystems Inc., 2006.
Updated by Michal Pryc, Sun Microsystems Inc., November 2006.
SunOS 5.11 2 Nov 2006 java-gnome(3)
