Click here for the frame version!

with Java 3D by Markus Zehnder


 

User Documentation

 

Index

Introduction
Screen shots
Download
Installation
Requirements
Running the game
Keys
Tested platforms
Problems
Enhancements
Additional documents
History
Links
Copyright and credits

Introduction

As part of the Computer Graphic course in the third year it was our assignment to make a small program with Java 3D. My choice felt on Tron based on the old cool C64 game which came from the Walt Disney movie Tron from 1982.
The goal of the game is to survive a virtual bike race. The difficulty is that a wall will be built behind one - the longer the game the more complex the play field.

Don't expect too much from the game! It's more a framework and a Java 3D study than a working game itself. There's room for a lot of improvements...


Screen shots

Let's start with some screen shots to get a first impression of the project:

Single player mode

This mode is not very interesting because you play against yourself.
It's only usefull for testing.
 
The start is in the middle of the playfield. After pressing the Start button, the game begins.
Here we see on the left where we started.
After some time the playfield turns into a labyrinth.
Aren't these beautyful colors?
Groovy baby!

Dual player mode

This mode makes more sense. One is playing against another human player.
 
The top view is for the first and the bottom view for the second player.

Debug window

The debug window is very usefull for debugging.
 
This is the default top view. 
With the navigation keys the playfield can be further explored.
Click on the image to see it in a higher resolution.

Note: All windows can be resized (the real ones in the game, of course).


Download

Press Shift to download, otherwise Netscape tries to run smart update...

Installation

The installation is straightforward:

Either copy the downloaded jar file somewhere in your CLASSPATH or extract the jar file in your desired directory with: jar xvf Tron3D.jar

A special installation program doesn't exist. There was no time to make one or to look for an existing one to modify.


Requirements

The following libraries are required to run the game: A 3D hardware accelerated graphic card is highly recommanded. Then a Pentium 200 should be enough.
I've developed the game on a notebook with a mobile PII 333 without a 3D hardware accelerator and it runs quite smooth in a window, but not in full screen mode.


Running the game

  1. Change into the directory where you have downloaded or extracted the jar file. This is not necessary if one has put the file(s) in the CLASSPATH.
  2. At the prompt, just run Tron3D as any other java application:
  3. Extracted jar file Single jar file
    %java Tron3D %java -classpath Tron3D.jar Tron3D
    This will run the game in dual player mode
    Additional command line parameters:
     
    -? | -h prints all available command line arguments.
    -single causes the game to load in single player mode.
    -debugwindow displays a debug window with a top view of the play field.
    -debug prints a lot of debug information in the console window.
    -fullscreen runs the game in fullscreen mode.

    Keys

    Key Player 1 Player 2 Debug window
    Up arrow forward
    Left arrow left turn
    Right arrow right turn
    F left turn
    H right turn
    T forward
    A y rotation clock wise
    D y rotation counter clock wise
    W zoom in
    X zoom out
    Page up x rotation counter clock wise
    Page down x rotation clock wise
    Shift
    speed up
    Alt drag mode


Tested platforms

JDK 1.2 was installed on every platform.
 
Platform Java 3D API 
Win95, Win98 1.1.1 DirectX
WinNT 4.0  1.1.1 OpenGL
Windows 2000 Beta 3 2031 1.1.1 DirectX
Sun Solaris 2.6 1.1.1 OpenGL

See Problems for currently kown bugs and problems.

In general the game runs smoother with the OpenGL libraries.


Problems

There are some serious problems, mainly because a lot of functionality isn't yet implemented:

Enhancements

To make a real game out of it, a lot of enhancements have to be integrated:

Additional documents

 
Document Description
Project documentation The project documentation.
JavaDoc The generated JavaDoc documentation from the source files.


History

30.05.99 Initial release.
29.06.99 Source code available for download.
General enhancements and bug fixes.
06.07.99 Screenshots, source documentation and JavaDoc  added.
Changed alpha status to beta. (There won't be a final release this year :-(
07.07.99 Project due date.
Additional command line switches and documentation updated.


Links

Sun: Java site, Java 3D site

The Java 3D FAQ

Tron - the movie


Copyright and credits


Copyright © 1998,1999 Berner Fachhochschule, Markus Zehnder.

The Tron 3D game is written by Markus Zehnder.

This software is provided "as is" without express or implied warranty. Use it at your own risk!
The author accepts no liability for any damage/loss of business that this product may cause.


Back to Top
Last revised: July 07, 1999
Author: Markus Zehnder