Java 3DTM 1.5.2-beta1 Release Notes

This file contains important release information for users of the Java 3DTM API, version 1.5.2-beta1.

Click here for instructions on how to install this release of Java 3D version 1.5.2-beta1.

NOTE: We recommend that you uninstall all previous versions of Java 3D before installing this version.

System Requirements

The 1.5.2-beta1 version of the Java 3D API has been released for Solaris (both sparc and x86/amd64), Linux (both x86 and amd64), Windows (both x86 and amd64), and Mac OS X (both PPC and x86).

Solaris Sparc

The 1.5.2-beta1 version of Java 3D for Solaris SPARC requires the following:

Solaris x86

The 1.5.2-beta1 version of Java 3D for Solaris x86/amd64 requires the following:

Linux

The 1.5.2-beta1 version of Java 3D for Linux (x86 or amd64) requires the following:

Windows

The 1.5.2-beta1 version of Java 3D for Windows 2000, Windows XP (x86 or amd64), or Windows Vista requires the following:

Mac OS X

The 1.5.2-beta1 version of Java 3D for Mac OS X (PPC or x86) requires the following:

Improvements in 1.5.2-beta1

Enhancements

Issues Fixed in 1.5.2-beta1


Issue   Description
179   OrbitBehavior.setRotationCenter gives spurious view shift
483   NullPointerException when writing Font3D using scenegraph.io
506   NullPointerException: Calling getNominalSensorRotation in WandViewBehavior when internal nominalSensorRotation is null causes a NullPointerException.
513   Down-rev D3D driver can cause JVM to crash
514   NPE in Wonderland : triggered in cached bounds computation
519   IntersectionInfo.getGeometry return null for IndexedArrayGeometry
525   JOALMixer only playing one sample
532   Background geometry BG isn't saved with SceneGraphFileWriter
534   ClassNotFoundException when running applet if Java 3D installed into JRE
538   Machine precision bug in AxisAngle4d and Quat4d
540   ArrayIndexOutOfBoundsException when calling setPickable
541   Bound.closest_point() method creates unused Matrix3d
544   GroupRetained.getBounds() should return BoundingBox?
545   Update docs to discourage installing Java 3D into JRE
548   RFE - Disable getLock() / unLock() on non-alive GeometryArray
555   Muting a PointSound causes a ClassCastException
560   Use D3DCREATE_FPU_PRESERVE flag on D3D pipeline
561   Decrease memory footprint of BoundingBox
562   Error occurs when Canvas3D removed from View
563   Background cloneNode() fails with Background geometry
567   Update license to GPL v2 + CLASSPATH
569   ImageComponent.ALLOW_IMAGE_READ is false

JOGL Rendering Pipeline

A JOGL rendering pipeline, as described in issue 229, is now available on all supported platforms, including Apple Mac OS X (x86 or PPC). The easiest way to run Java 3D applications using the JOGL pipeline is via Java Webstart from your browser (with no setup required). Click here to run a Java 3D example program from your browser via the JOGL pipeline. These examples will use JOGL on Mac OS X and the native OpenGL pipeline on all other platforms.

The JOGL renderer is the default on Mac OS X. You can select the JOGL renderer on other platforms by setting the "j3d.rend" system property to "jogl", for example:

You will need to download JOGL and include it in your PATH/CLASSPATH along with the Java 3D jar files.

NOTE: Installing the j3d or jogl jars and native libs into the "ext" directory of the JRE is strongly discouraged. Doing so can cause conflicts with third-party applications launched via Java Web Start, and causes confusion later when upgrading the distribution.

More Information

For the latest information on Java 3D, see the main Java 3D project page on java.net.

Click here for a list of open issues.