Getting the source and building the HyperFun Applet

The HyperFun Applet source is maintained using CVS at
http://sourceforge.net/projects/hyperfun

Currently the source of the unofficial beta-version is available. 
To download the source tree of the HyperFun applet from sourceforge.net using 
a CVS client, the following two commands can be used:

cvs -d:pserver:anonymous@cvs.sourceforge.net:/cvsroot/hyperfun login
cvs -z3 -d:pserver:anonymous@cvs.sourceforge.net:/cvsroot/hyperfun co -P hfa

The applet depends on BCEL (Byte Code Engineering Library), JLex (a scanner generator for Java), 
CUP (a parser generator for Java), and Java 3D API.  The Jar files of BCEL, JLex, and CUP are
included to the source tree, so only Java 3D API required to be downloaded and installed.

* How to build the applet

To build the applet, Apache Ant is required.  Apache Ant is a build tool like 
a "make" utility mainly for Java.  Apache Ant is available at http://ant.apache.org/.  

The following instructions build the applet.

1. Move to top level directory (folder) of the source tree, i.e. hfa.
2. Run Ant with no argument.

The following is an example session on GNU/Linux:

  % cvs -d:pserver:anonymous@cvs.sourceforge.net:/cvsroot/hyperfun login

    The password is empty, just press the Enter key.

  % cvs -z3 -d:pserver:anonymous@cvs.sourceforge.net:/cvsroot/hyperfun co -P hfa
  % cd hfa
  % ant
  % cd build
  % java -jar hyperfun_applet.jar

After building the applet, a jar file "hyperfun_applet.jar" can be found under the "build" directory.

* How to run the applet

As a standalone Java application, use one of the following commands:

  java -jar hyperfun_applet.jar

    or

  java -classpath hyperfun_applet.jar org.hyperfun.gui.HFMain

As a Java Applet, the jar file should be signed using keytool and jarsigner included in J2sdk, 
to relax security constraints on a Java Applet:

1) Generate key: keytool -genkey -keyalg rsa -alias myKey
2) Export key: keytool -export -alias myKey -file myCert.crt
3) Sign the applet: jarsigner hyperfun_applet.jar myKey

With questions and inquiries, send e-mail to
goto at iti.kanazawa-it.ac.jp
p.fayolle at free.fr