<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN"> <html> <head> <meta http-equiv="content-type" content="text/html; charset=ISO-8859-1"> <title>Java 3D 1.5.2 Pre-Release Notes</title> </head> <body> <h2>Java 3D<sup><font size="-2">TM</font></sup> 1.5.2-beta2 Release Notes</h2> <p>This file contains important release information for users of the Java 3D<sup><font size="-2">TM</font></sup> API, version 1.5.2-beta2. </p> <ul> <a href="#System_Requirements">System Requirements</a> (<a href="#Solaris_Sparc">Solaris Sparc</a>, <a href="#Solaris_x86">Solaris x86</a>, <a href="#Linux">Linux</a>, <a href="#Windows">Windows</a>, <a href="#MacOSX">Mac OS X</a>)<br> <a href="#Improvements_In_1_5_2">Improvements in 1.5.2-beta2</a><br> <a href="#JoglPipeline">JOGL Rendering Pipeline</a><br> <a href="#More_Information">More Information</a><br> </ul> <p><span style="font-style: italic;">NOTE: We recommend that you </span><span style="font-style: italic;">uninstall all </span><span style="font-style: italic;">previous versions of Java 3D before installing this version.</span> </p> <h3><a name="System_Requirements"></a>System Requirements</h3> <p>The 1.5.2-beta2 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). </p> <h4><a name="Solaris_Sparc"></a>Solaris Sparc</h4> <p> The 1.5.2-beta2 version of Java 3D for Solaris SPARC requires the following: </p> <ul> <li>JDK 1.5.0 or later from Sun Microsystems: <a href="http://java.sun.com/j2se/">http://java.sun.com/j2se/</a></li> <li>Solaris 9 or later</li> <li>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.</li> <li>OpenGL 1.3 for Solaris or later. To find your current version, use: "<code>pkginfo -l SUNWglrt</code>". OpenGL for Solaris can be obtained at: <a href="http://www.sun.com/software/graphics/opengl/">http://www.sun.com/software/graphics/opengl/</a></li> </ul> <h4><a name="Solaris_x86"></a>Solaris x86</h4> <p> The 1.5.2-beta2 version of Java 3D for Solaris x86/amd64 requires the following: </p> <ul> <li>JDK 1.5.0 or later from Sun Microsystems: <a href="http://java.sun.com/j2se/">http://java.sun.com/j2se/</a></li> <li>Solaris 10 or later</li> <li>NVIDIA Frame Buffer with OpenGL 1.3 or later</li> </ul> <h4><a name="Linux"></a>Linux<br> </h4> <p>The 1.5.2-beta2 version of Java 3D for Linux (x86 or amd64) requires the following:<br> </p> <ul> <li>JDK 1.5.0 or later from Sun Microsystems: <a href="http://java.sun.com/j2se/">http://java.sun.com/j2se/</a></li> <li>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. </li> </ul> <h4><a name="Windows"></a>Windows<br> </h4> <p>The 1.5.2-beta2 version of Java 3D for Windows 2000, Windows XP (x86 or amd64), or Windows Vista requires the following:<br> </p> <ul> <li>JDK 1.5.0 or later from Sun Microsystems: <a href="http://java.sun.com/j2se/">http://java.sun.com/j2se/</a></li> <li>Windows 2000, Windows XP, or Windows Vista</li> <li>Support for either OpenGL or DirectX as shown below.<br> </li> </ul> <ul> <span style="font-weight: bold;">OpenGL version</span><br> <ul> The (default) OpenGL renderer of Java 3D requires OpenGL 1.3 or later, available from your graphics card manufacturer. </ul> </ul> <ul> <span style="font-weight: bold;">DirectX version</span><br> <ul> The (optional) DirectX renderer of Java 3D requires DirectX 9.0 or later, which is available from Microsoft at: <a href="http://www.microsoft.com/windows/directx/">http://www.microsoft.com/windows/directx/</a> . The DirectX version of Java 3D is selected by setting the "<code>j3d.rend</code>" system property to "<code>d3d</code>", for example: <ul> <code>java -Dj3d.rend=d3d ClassName</code> </ul> </ul> <br> 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). </ul> <h4><a name="MacOSX"></a>Mac OS X</h4> <p>The 1.5.2-beta2 version of Java 3D for Mac OS X (PPC or x86) requires the following:<br> </p> <ul> <li>JDK 1.5.0 or later from Apple: <a href="http://developer.apple.com/java/download/">http://developer.apple.com/java/download/</a></li> <li>Java Binding for OpenGL (JOGL), available at: <a href="https://jogl.dev.java.net/">https://jogl.dev.java.net/</a><br> you can <a href="https://jogl.dev.java.net/servlets/ProjectDocumentList?folderID=5971&expandFolder=5971">click here</a> for a direct link to the download folder<br> </li> <li>Apple OS X 10.3 or later (10.4 or later is required for Intel-based Apple systems)<br> </li> <li>Support for OpenGL 1.3 or later<br> </li> </ul> <h3><a name="Improvements_In_1_5_2"></a>Improvements in 1.5.2-beta2</h3> <h4>Issues Fixed in 1.5.2-beta2</h4> <br> <table width="100%" style="text-align: left;" border="1" cellpadding="2" cellspacing="0"> <tbody> <tr> <th style="vertical-align: top; text-align: right;">Issue</th> <th style="vertical-align: top;"> </th> <th style="vertical-align: top;">Description</th> </tr> <tr> <td style="vertical-align: top; text-align: right;">543</td> <td style="vertical-align: top;"> </td> <td style="vertical-align: top;">J3DClock does not adjust to clock skew</td> </tr> <tr> <td style="vertical-align: top; text-align: right;">583</td> <td style="vertical-align: top;"> </td> <td style="vertical-align: top;">A disposed Graphics2D remains in Canvas3D after removal and addtion</td> </tr> </tbody> </table> <h3><a name="Improvements_In_1_5_2"></a>Improvements in 1.5.2-beta1</h3> <h4>Enhancements</h4> <ul> <li>Source code license changed to GPL v2 + CLASSPATH</li> </ul> <h4>Issues Fixed in 1.5.2-beta1<br> </h4> <br> <table width="100%" style="text-align: left;" border="1" cellpadding="2" cellspacing="0"> <tbody> <tr> <th style="vertical-align: top; text-align: right;">Issue</th> <th style="vertical-align: top;"> </th> <th style="vertical-align: top;">Description</th> </tr> <tr> <td style="vertical-align: top; text-align: right;">179</td> <td style="vertical-align: top;"> </td> <td style="vertical-align: top;">OrbitBehavior.setRotationCenter gives spurious view shift</td> </tr> <tr> <td style="vertical-align: top; text-align: right;">483</td> <td style="vertical-align: top;"> </td> <td style="vertical-align: top;">NullPointerException when writing Font3D using scenegraph.io</td> </tr> <tr> <td style="vertical-align: top; text-align: right;">506</td> <td style="vertical-align: top;"> </td> <td style="vertical-align: top;">NullPointerException: Calling getNominalSensorRotation in WandViewBehavior when internal nominalSensorRotation is null causes a NullPointerException.</td> </tr> <tr> <td style="vertical-align: top; text-align: right;">513</td> <td style="vertical-align: top;"> </td> <td style="vertical-align: top;">Down-rev D3D driver can cause JVM to crash</td> </tr> <tr> <td style="vertical-align: top; text-align: right;">514</td> <td style="vertical-align: top;"> </td> <td style="vertical-align: top;">NPE in Wonderland : triggered in cached bounds computation</td> </tr> <tr> <td style="vertical-align: top; text-align: right;">519</td> <td style="vertical-align: top;"> </td> <td style="vertical-align: top;">IntersectionInfo.getGeometry return null for IndexedArrayGeometry</td> </tr> <tr> <td style="vertical-align: top; text-align: right;">525</td> <td style="vertical-align: top;"> </td> <td style="vertical-align: top;">JOALMixer only playing one sample</td> </tr> <tr> <td style="vertical-align: top; text-align: right;">532</td> <td style="vertical-align: top;"> </td> <td style="vertical-align: top;">Background geometry BG isn't saved with SceneGraphFileWriter</td> </tr> <tr> <td style="vertical-align: top; text-align: right;">534</td> <td style="vertical-align: top;"> </td> <td style="vertical-align: top;">ClassNotFoundException when running applet if Java 3D installed into JRE</td> </tr> <tr> <td style="vertical-align: top; text-align: right;">538</td> <td style="vertical-align: top;"> </td> <td style="vertical-align: top;">Machine precision bug in AxisAngle4d and Quat4d</td> </tr> <tr> <td style="vertical-align: top; text-align: right;">540</td> <td style="vertical-align: top;"> </td> <td style="vertical-align: top;">ArrayIndexOutOfBoundsException when calling setPickable</td> </tr> <tr> <td style="vertical-align: top; text-align: right;">541</td> <td style="vertical-align: top;"> </td> <td style="vertical-align: top;">Bound.closest_point() method creates unused Matrix3d</td> </tr> <tr> <td style="vertical-align: top; text-align: right;">544</td> <td style="vertical-align: top;"> </td> <td style="vertical-align: top;">GroupRetained.getBounds() should return BoundingBox?</td> </tr> <tr> <td style="vertical-align: top; text-align: right;">545</td> <td style="vertical-align: top;"> </td> <td style="vertical-align: top;">Update docs to discourage installing Java 3D into JRE</td> </tr> <tr> <td style="vertical-align: top; text-align: right;">548</td> <td style="vertical-align: top;"> </td> <td style="vertical-align: top;">RFE - Disable getLock() / unLock() on non-alive GeometryArray</td> </tr> <tr> <td style="vertical-align: top; text-align: right;">555</td> <td style="vertical-align: top;"> </td> <td style="vertical-align: top;">Muting a PointSound causes a ClassCastException</td> </tr> <tr> <td style="vertical-align: top; text-align: right;">560</td> <td style="vertical-align: top;"> </td> <td style="vertical-align: top;">Use D3DCREATE_FPU_PRESERVE flag on D3D pipeline</td> </tr> <tr> <td style="vertical-align: top; text-align: right;">561</td> <td style="vertical-align: top;"> </td> <td style="vertical-align: top;">Decrease memory footprint of BoundingBox</td> </tr> <tr> <td style="vertical-align: top; text-align: right;">562</td> <td style="vertical-align: top;"> </td> <td style="vertical-align: top;">Error occurs when Canvas3D removed from View</td> </tr> <tr> <td style="vertical-align: top; text-align: right;">563</td> <td style="vertical-align: top;"> </td> <td style="vertical-align: top;">Background cloneNode() fails with Background geometry</td> </tr> <tr> <td style="vertical-align: top; text-align: right;">567</td> <td style="vertical-align: top;"> </td> <td style="vertical-align: top;">Update license to GPL v2 + CLASSPATH</td> </tr> <tr> <td style="vertical-align: top; text-align: right;">569</td> <td style="vertical-align: top;"> </td> <td style="vertical-align: top;">ImageComponent.ALLOW_IMAGE_READ is false</td> </tr> </tbody> </table> <br> <h3><a name="JoglPipeline"></a>JOGL Rendering Pipeline</h3> <p>A JOGL rendering pipeline, as described in <a href="https://java3d.dev.java.net/issues/show_bug.cgi?id=229">issue 229</a>, 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). <a href="https://j3d-webstart.dev.java.net/test">Click here</a> 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.<br> </p> <p>The JOGL renderer is the default on Mac OS X. You can select the JOGL renderer on other platforms by setting the "<code>j3d.rend</code>" system property to "<code>jogl</code>", for example: </p> <ul> <code>java -Dj3d.rend=jogl ClassName</code> </ul> <p>You will need to <a href="https://jogl.dev.java.net/">download JOGL</a> and include it in your PATH/CLASSPATH along with the Java 3D jar files.<br> </p> <p>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. </p> <h3><a name="More_Information"></a>More Information</h3> <p>For the latest information on Java 3D, see the <a href="https://java3d.dev.java.net/">main Java 3D project page</a> on java.net.<br> </p> <p>Click <a href="https://java3d.dev.java.net/issues/buglist.cgi?Submit+query=Submit+query&component=java3d&issue_status=NEW&issue_status=STARTED&issue_status=REOPENED">here</a> for a list of open issues.</p> </body> </html>