Logo - Fakultät für Mathematik und InformatikIllustration

LWJGL Plugin

LWJGL Plugin

This page provides information on the LWJGL Eclipse Plugin. The LWJGL project can be found at http://www.lwjgl.org

The latest stable release of LWJGL is 1.4.
The latest release of LWJGL is 2.0beta1. This release is called "1.9.1" here (since a plugin's version number must be numeric).

The Lightweight Java Game Library (LWJGL) is a Java library wrapping OpenGL and OpenAL. It comes with some JAR and native libraries. We provide an LWJGL plugin which can easily be installed using our update site. LWJGL documentation and source is included and automatically linked, so you don't have to bother about all that stuff.

  • LWJGL project website
  • LWJGL plugin update site (cannot be viewed with Safari, use Firefox), use the following settings in your Eclipse workspace (may change in the future):
    Name: GEF3D Update Site
    URL: http://www.fernuni-hagen.de/se/personen/pilgrim/gef3d/update

Rate this plugin @ Eclipse Plugin Central

Purpose

This plugin only installes the LWJGL jars and native libraries, so that it is easy to develop plugins using LWJGL. It does not provide any support for developing standalone LWJGL based Java applications (e.g. no LWJGL launch configuration is provided). If you develop an Eclipse plugin using LWJGL, you only have to add the LWJGL plugin to the list of required plugins, i.e. you don't have to care about native library paths anymore.

Install

Requirements

LWJGL comes with native libraries for Mac OS X, Windows and Linux. By accident this are the same platform Eclipse supports. So, you only have to take care that your Eclipse version is new enough, 3.2 or newer should work. Elder Eclipse versions (shipped with SWT 3.1) do not support OpenGL. There is a experimental plugin available for SWT 3.1, but we didn't tested that one (at least the test view is not working without changes since the plugin must be imported explicitly).

The plugin was developed and tested with the following settings:

  • Eclipse 3.3, Windows XP
  • Eclipse 3.2.2, Windows XP
  • Eclipse 3.2, Mac OS X 10.4
  • Eclipse 3.3, Mac OS X 10.5 -- there is a bug in Eclipse 3.x (x<=3) for Mac OS X 10.5, hence the test view is not working (as every plugin using LWJGL). The test view and other plugins using LWJGL are still working when they are activated in a runtime instance. This bug is fixed in the latest Eclipse nightly build and will be fixed with Eclipse 3.4. For details see LWJGL Forum.

For more information on using OpenGL in SWT applications, see http://www.eclipse.org/swt/opengl/.

Installation using Eclpise's Update Mechansim

This is the preferred way to install the plugin! The feature's version number is simply LWJGL's version number.

The plugin comes with LWJGL 1.1.4 (elder version are available, too), the latest stable release of LWJGL. The plugin can easily be installed using Eclipse's update feature:

Help / Software Updates / Find and Install...
Search for new features to install
New Remote Site

Provide data as above and install feature.

In order to test whether everything worked fine, simply open

Windows / Show Views / Others...
Other / LWJGL Test View

Actually version 1.9.1 is LWJGL 2.0beta1. With LWJGL 2.0, the optional packages (devil and fmod) were removed.

Install Manually

If you have to install the plugin manually, simply download the archives (JAR files) from http://www.fernuni-hagen.de/se/personen/pilgrim/gef3d/update/plugins/. You need at last org.lwjgl, the test view is found in org.lwjgl.test and the documentation and source in org.lwjgl.doc and org.lwjgl.source. The other plugins are optional. Download these files and extract them into folders with the name of the archive without the extension, e.g. extract org.lwjgl.1.1.4.jar into a folder named org.lwjgl.1.1.4. Then move these folders to your Eclipse plugin folder.

Background

The LWJGL plugin is used by and was developed for GEF3D, an Eclipse plugin for enabling 3D diagram editors, based on Eclipse GEF. This is why the update site is called GEF3D update site.

Contact

Informations about the LWJGL plugin will be announced at the LWJGL forum and the GEF3D mailing list.

Letzte Änderung: 2008-04-24 (jvp)
FernUni-Logo FernUniversität in Hagen, Lehrgebiet Software Engineering, D-58084 Hagen, Telefon: +49 (2331) 987-2964