## 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.

System Requirements (Solaris Sparc, Solaris x86, Linux, Windows, Mac OS X)
Improvements in 1.5.2-beta1
JOGL Rendering Pipeline
More Information

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:

- JDK 1.5.0 or later from Sun Microsystems: http://java.sun.com/j2se/
- Solaris 9 or later
- Frame Buffer with OpenGL 1.3 support or better (XVR-600, XVR-1200, Expert3D, etc.). A frame buffer with OpenGL 1.2 support will work, but with reduced texture mapping functionality.
- OpenGL 1.3 for Solaris or later. To find your current version, use: "`pkginfo -l SUNWglrt`". OpenGL for Solaris can be obtained at: http://www.sun.com/software/graphics/opengl/

#### Solaris x86

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

- JDK 1.5.0 or later from Sun Microsystems: http://java.sun.com/j2se/
- Solaris 10 or later
- NVIDIA Frame Buffer with OpenGL 1.3 or later

#### Linux

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

- JDK 1.5.0 or later from Sun Microsystems: http://java.sun.com/j2se/
- Graphics adapter with driver that supports the GLX extension: GLX 1.3 or later and OpenGL 1.3 or later. A graphics adapter with OpenGL 1.2 support will work, but with reduced texture mapping functionality.

#### Windows

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

- JDK 1.5.0 or later from Sun Microsystems: http://java.sun.com/j2se/
- Windows 2000, Windows XP, or Windows Vista
- Support for either OpenGL or DirectX as shown below.

OpenGL version

The (default) OpenGL renderer of Java 3D requires OpenGL 1.3 or later, available from your graphics card manufacturer.

DirectX version

The (optional) DirectX renderer of Java 3D requires DirectX 9.0 or later, which is available from Microsoft at: http://www.microsoft.com/windows/directx/ . The DirectX version of Java 3D is selected by setting the "`j3d.rend`" system property to "`d3d`", for example:

`java -Dj3d.rend=d3d ClassName`

NOTE: The DirectX version of Java 3D is used if a suitable version of OpenGL cannot be found. Note also that DirectX is chosen by default on Windows Vista systems with an ATI graphics card (due to ATI driver bugs).

#### Mac OS X

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

- JDK 1.5.0 or later from Apple: http://developer.apple.com/java/download/
- Java Binding for OpenGL (JOGL), available at: https://jogl.dev.java.net/
  you can click here for a direct link to the download folder
- Apple OS X 10.3 or later (10.4 or later is required for Intel-based Apple systems)
- Support for OpenGL 1.3 or later

### Improvements in 1.5.2-beta1

#### Enhancements

- Source code license changed to GPL v2 + CLASSPATH

#### 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:

`java -Dj3d.rend=jogl ClassName`

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.