Notice: this Wiki will be going read only early in 2024 and edits will no longer be possible. Please see: https://gitlab.eclipse.org/eclipsefdn/helpdesk/-/wikis/Wiki-shutdown-plan for the plan.
GEF3D Installation
Contents
Requirements
GEF3D requires Eclipse Platform 3.3 or later, GEF and an OpenGL graphics card.
Installing GEF3D
There is no official version available yet, see GEF3D project plan. Currently you have to checkout the sources from the GEF3D code repository (a Subversion repository) and install a render engine separately.
Check Out Sources
You can check out GEF3D's sources from
svn://dev.eclipse.org/svnroot/technology/org.eclipse.gef3d
In order to test GEF3D, you'll need the following projects (please add org.eclipse to the name):
- draw3d
- draw3d.geometry
- draw3d.graphics3d
- gef3d
- gef3d.ext
- gef3d.gmf
- gef3d.examples.graph
Optionally you can check out the test and documentation projects, however there are currently not much tests and documentation available (but you can use the ant script in doc in order to generate the JavaDoc).
Install a Renderer
Draw3D, the 3D version of Draw2D, needs a renderer module in order to produce any output. The renderer uses the extension point defined in org.eclipse.draw3d.graphics3d. Currently, only LWJGL is supported, that is you have to checkout
- org.eclipse.draw3d.lwjgl
from the repository. This module only contains the Draw3D specific code, additionally you will need the LWJGL libraries. These libraries are available as an Eclipse plugin via the LWJGL update site at http://lwjgl.org/update. A description can be found at the FernUni Hagen GEF3D project site.
Test GEF3D
The GEF3D example is running, but there is a known bug. We are working on that already... Actually there are more bugs known, we will add them to Bugzilla as soon as possible ;-) After checking out all these projects, the example editor can be activated by simply creating a file with appropriate extension:
- ".graphSample" for the 3D editor,
- ".graphSampleDia" for a 2.5D editor (i.e. 2D figures projected on 3D planes), and
- ".multiGraphSample" for a multi plane editor.