Java3DInstallation

Table of Contents

Installing Java3D for Mac OS X 10.4

1. Download Java3D for Mac OS X: To get the latest version compatible to Mac OS X, go to the pre-release builds site. (See the roadmap to inquire when a Java3D final release will be available for Mac OS X at the release builds site.)
2. Download the latest jogl at the jogl project site.
3. Place the jar files in /Library/Java/Extensions or ~/Library/Java/Extensions
4. unpack the jogl-natives-* jar in the same directory (the name of the jogl natives jar depends on which you have downloaded. The Intel-Mac or the PPC version.)

Autoinstall Java3D API and your program on Windows XP and Vista.

1. You have to create a your Launcherxxx.JNLP file and place it somewhere or your Internet server. Once done, you simply run your application by placing on a web page a url pointing this Launcherxxx.JNLP file. For exemple http://www.yoursite.com/exec/directory3DSoftwares/Launcherxxx.jnlp

1. The difficult part is to write this .jnlp file. JNLP tag are explains here at the the official page of "Java Web Start API" JWS official page . See Exemple-JNLP for one typical example.

1. There are some known problems and solutions: For Vista use DirectX^? rendering (and not OpenGl^? by defaut). Like this

 
<?xml version="1.0" encoding="utf-8"?>   
<jnlp spec="1.0+" codebase="http://www.papus.info/exec/adlib_lot0_21/" 
href="Launcherxxx.jnlp">
  <information>
    <title> My 3D Application on the Web Title </title>
    <vendor> www.myInternetWebsite.com </vendor>
    <homepage href="http://www.xxxx.com.com/"/>
    <description>  My 3D application with  bla bla bla </description>
    <description kind="short"> My 3D Software </description>
    <icon href="icon_xxx_128x128.gif"/>
    <icon kind="splash" href="splash_xxxxx_240x92.jpg"/>
    <offline-allowed/>
  </information>

<j2se version="1.5+" /> 
<security>
   <all-permissions/>
</security>    
    <application-desc main-class="apackage.MyStartingClass">
    <argument>One parameter for your 3D application</argument>
 </application-desc> 

  <resources os="Windows"> 
    <j2se version="1.5+"  initial-heap-size="150M" max-heap-size="150M" href="http://java.sun.com/products/autodl/j2se"  />
    <property name="Xms" value="150M"/>
    <property name="Xmx" value="250M"/>
    <property name="j3d.audiodevice" value="org.jdesktop.j3d.audioengines.joal.JOALMixer"/>
    <property name="j3d.rend" value="d3d"/>
    <!-- property name="j3d.rend" value="ogl"/-->

    <jar href="yourApplicationJarfile.jar" main="true" download="eager"/>

<extension href="http://download.java.net/media/java3d/webstart/release/java3d-latest-joal.jnlp"/>

    <property name="key" value="something"/>
  </resources>
</jnlp>

Running Java3D on Windows 64 Platforms

On Windows 64 OSes (Vista 64, Windows 7 64, XP Professional 64 bits, Windows 2003 Server 64bits Edition, etc) is possible run Java using the JRE 64 bits as well the JRE 32 bits, using the WoW^? layer . Windows on Window - is a feature which allows 32bits applications runs on 64bits OS in a transparent way.

To run Java3D in 64 bits in one of above platforms, user must install the Java3D AMD64 runtime for Windows platform in default folder for JRE 64bits:

C:\Program Files\Java

As user may have others JRE installed, is recommended that use full path to java.exe / javaw.exe.

Example :

"C:\Program Files\Java\jre2\bin\java.exe" -showversion -cp myJar.jar MyMainClass^?

The -showversion jvm flag is optional, and used to display the version of running JVM.

To launch the JVM 32 bits on Windows 64bits, user must note that the JVM 32 bits is placed at following folder:

C:\Program Files(x86)\Java To launch Java3D using JVM 32bits on Vista 64, user must install the Java3D runtime for i586 use the following example:

"C:\Program Files(x86)\Java\jre2\bin\java.exe" -showversion -cp myJar.jar MyMainClass^?

Java3D binary build for all platforms are available at :

https://java3d.dev.java.net/binary-builds.html

Please note that Java3D for AMD64 will run only on 64bits OS, as Vista 64, WIndows 7 64, Windows XP Professional 64, and WIndows 2003 Server 64 bits Edition. Those OSs runs using AMD 64 processor , AND all Intel processors with EMT64 extensions.