Cult3D Java API Documentation

Compilation


Getting a Java compiler
The first thing you need to do is to install a Java compiler, you can find the defacto standard compilers at Sun's Java site, http://java.sun.com .

You can find Sun's Java compilers at the Java platform standard edition site http://java.sun.com/j2se/ .
When deciding which compiler to download and use, remember that most web browsers supports only Java 1.1.

There is also other than Sun that supplies Java compilers, for example IBM , GNU and WebGain

Installing
Follow the onscreen instructions to install the selected Java compiler.
Sun's Java compiler is a command-line program which must be invoked from a command prompt, "\bin\javac your-Java-code.java".

Writing Java code
You can use any text editor which can save your Java code in plain text (ASCII), such as Notepad or Emacs, just be sure to save with .java file-extension.
You can also use an IDE (Integrated Development Environment) to write the Java code, these IDE's offers various help as you write your code such as project management, syntax error highlights, etc.
There is a lot of IDE's out in the world, both commercial and non-commercial.
Here is a list of some them.

Unordered List of Java IDE's
OmniCore's CodeGuide , Written in Java, Syntax error highlights, Code completion, etc
Sun's Forte for Java, , Written in Java, Gui Builder, etc
WebGain's VisualCafe , Gui Builder, Code completion, etc
Borland's JBuilder Written in Java, Gui Builder, Syntax error highlights, etc

Compiling Java code
When you compile Java for Cult3D, you must supply the path to the Cult3DDevelop.jar file.
However you cannot enter this to your system class path when any web browser is running, you should supply the path when compiling your Java classes. Otherwise some web browsers will be very confused, and you will get (not so) funny error messages.

Example to compile with Sun's JDK 1.1
In this example lets assume you have installed the Cult3D Designer in its default path, C:\Program Files\Cycore\Cult3D Designer\, and your Java compiler in c:\jdk1.1

c:\jdk1.1\bin\javac -classpath ".;%CLASSPATH%;C:\Program Files\Cycore\Cult3D Designer\Cult3DDevelop.jar;" YourCode.java