Mathematical Visualization WS08 Technical University Berlin

Assignment 1

Theme: Getting started

Part 1. Installing jReality

In this part of the assignment, you'll find out how to load the latest jReality software into Eclipse.

To run eclipse on the institute computers, use /usr/bin/eclipse (currently Eclipse version 3.2). Before running eclipse the first time, create a directory in your home directory named workspace which you can use as your eclipse workspace (eclipse will ask you where your workspace is). To access the subversion plugin subclipse, you'll can use the plugins installed on the Institute computers. To do this, choose the menu item "Help->Software Updates->Manage Configuration" and then enter the following extension path:
/usr/site-local/share/eclipse_extensions/eclipse

On your home computer, you'll need to download eclipse, and then install the subclipse Eclipse plugin.

To check out the jreality subversion (svn) project:

  • In eclipse, open the SVN repository perspective by selecting the menu item "Window->Open perspective ...->SVN Respository Exploring"
  • If you don't see this perspective, then you haven't installed subclipse successfully.
  • In the SVN Respository browser, use right mouse click to get a menu; choose the item "New->Repository location..."
  • Enter the URL http://fs.math.tu-berlin.de:8000/svn/jreality
  • You have unique login for this repository: for example, if your linux login is mvws0803, your repository login is MathVisWS0803. The password is Physics!
    • If you don't have such a linux login, you'll still need to get a repository login from me.
  • Open the repository in the repository explorer and select the item trunk.
  • With right mouse click, select the menu item "Checkout..."
  • You should be able to use the default settings provided in the window. Click OK.
  • The project comes configured as a stand-alone Java Eclipse project.
  • Switch the Eclipse perspective back to the Java perspective.
  • To test whether the project has compiled correctly, navigate in the Package Explorer to "jreality->src-tutorial->de.jreality.tutorial.tform" and select the file TransformationFlat.java.
  • If everything is working properly, you should see a window with eight icosahedra in various states of completeness.

Part 2. Learning jReality

The rest of your assignment is to study the jReality developer tutorial in conjunction with the tutorial source files (one of which you just tested). Begin with the introductory tutorial (package de.jreality.tutorial.intro), then concentrate on the tutorials in the following packages:

  • de.jreality.tutorial.tform
  • de.jreality.tutorial.geometry
  • de.jreality.tutorial.app

The best way to learn, I think, is to make variations on the existing tutorials. For example, in TransformationFlat.java above, experiment with changing the geometry used (look in the de.jreality.geometry.Primitives class for other possibilities), the transformations which are used (here take a look at the MatrixBuilder class to see what other transformations you can create), and change the appearance properties which are set.

Next week I will set up another subversion repository just for this class, where you can check in the Java classes you develop in the course of the semester.

If there are urgent problems you can e-mail me (gunn@math.tu-berlin.de); otherwise please collect your comments and suggestions for improvement (German language is fine) and e-mail them to me at the conclusion of your study, but no later than October 29 (Uebung in two weeks). If everyone contributes their feedback I'm sure the tutorial will be much improved! Another helpful resource as you play with this material is the JavaDoc for jReality.