Documentation

Contents

1 Installation and Setup
2 Scenejo Project and Subprojects
3 Scientific Publications
4 API

Installation and Setup

How to install Eclipse

Go to http://www.eclipse.org/downloads/ and download "Eclipse IDE for Java EE Developers". Unzip the downloaded file and launch the "eclipse.exe" from the eclipse folder.

How to install Java3D

Go to https://java3d.dev.java.net/ and click "Downloads". There you click on the "binary downloads" link. The current version of Scenejo works with the 1.5.2 release. Go to the "Installers", download the file "j3d-1_5_2-windows-i586.exe" if you use Windows and install it.

Attention: Currently the website is under redesign. During that time you can go to http://download.java.net/media/java3d/builds/release/1.5.2/ where you can find all accessible versions of Java3D.

How to install Subclipse

Go to http://subclipse.tigris.org/ and click "Download and Install". Under "Eclipse 3.2/Callisto, 3.3/Europa, 3.4/Ganymede, 3.5/Galileo +" you will find different releases for Subclipse. The current version of Eclipse/Scenejo works with the 1.4.x release. There go to "Eclipse update site URL:" and copy the link. In Eclipse go to "Help" in the main menu and click "Install New Software...". Then you can paste the copied link to "Work with:" and see different Subclipse alternatives. Choose the first one with the name "Subclipse" and check the box in front of it. Click "Next" and "Finish" after the installation is done.

How to use Subclipse (SVN - Subversion)

It is handy to use the "SVN Repository Exploring" to set up the paths and the "Team Synchronizing perspective" for the synchronization process. To activate these perspectives, choose "Window > Open Perspective > Other..." and select "SVN Repository Exploring" and "Team Synchronizing".

To set up the repository paths click the button "SVN Repository Exploring perspective". Then right click in the "SVN Repositories" window and choose "New > Repository Location...". There you enter "https://svn.origo.ethz.ch/scenejo/" and "https://svn.origo.ethz.ch/bot3d/". Click "Finish" after you entered each adress. Now you will see both adresses in the "SVN Repositories" window. For both you have to expand the main folder of the tree and select ALL subfolders, but NOT the main folder. Then right click and choose "Checkout...". In the next window you can choose the workspace.

For synchronization with the Scenejo project click the button "Team Synchronizing perspective".

In the upper left corner appears the "Synchronize" window. In the menu bar of that window click the left button named "Synchronize SVN". After downloading the information you will see all changes of the project if you right click the project name and "Expand all". Blue arrows from right to left show incoming changes. Grey arrows from left to right show outgoing changes. A normal arrow means that the file has changed, a "+" inside the arrow that the file was added and a "-" that it was deleted. You can filter these files by clicking the "Incoming Mode", "Outgoing Mode" or "Incoming/Outgoing Mode" buttons in the same menu bar.

To synchronize incoming and/or outgoing files right click the project name and choose one of the following options:

Update - to update your local files from the server
Commit - to commit your local changes to the server
Override and Update - to replace your local changes with the contents from the server

How to start Scenejo

In Eclipse click "Java perspective" and go to "Scenejo__Authoring > run.deploy > config" and copy the file "log4j.properties". Then go to "Scenejo__Authoring > run > config" and paste the file.

To start Scenejo click on the drop down button right of the run button in main menu bar and choose "Run Configurations...". In the left part of the window expand "Java Applications" and click "RUN Scenejo". With a click on "Run" you start Scenejo.

How to start the "Killerphrasen-Spiel"

In Scenejo click on "File > Open Project" and look for your Scenejo workspace folder. There you go to "Scenejo__Authoring > run > examples" and open the file "example.sce.v06.xml". After the game is loaded you can start it by clicking "Run" in the main menu bar.