diff options
| author | Kevin Rushforth <[email protected]> | 2008-05-22 18:10:40 +0000 |
|---|---|---|
| committer | Kevin Rushforth <[email protected]> | 2008-05-22 18:10:40 +0000 |
| commit | 20c2b0e727fb696596335915cc63ef56dc9cb317 (patch) | |
| tree | c7c8f8203fd19277c1a3072e733a3414cce72c05 | |
| parent | fa79b5b8b0a8d2114aebfd7028330a17cb487d2d (diff) | |
1. Fixed issue 543 (see below)
2. Added release notes for 1.5.2-beta2 release
Issue number: 543
Obtained from: pepe
Submitted by: kcr
Reviewed by: kcr
Fixed issue 543: J3DClock does not adjust to clock skew
Use "-Dj3d.adjustClockSkew=true" to enable clock skew adjustment
git-svn-id: https://svn.java.net/svn/j3d-core~svn/trunk@899 ba19aa83-45c5-6ac9-afd3-db810772062c
| -rw-r--r-- | release-info/pre-release/README-download.html | 12 | ||||
| -rw-r--r-- | release-info/pre-release/README.html | 41 | ||||
| -rw-r--r-- | src/classes/share/javax/media/j3d/J3dClock.java | 28 | ||||
| -rw-r--r-- | src/classes/share/javax/media/j3d/MasterControl.java | 4 | ||||
| -rw-r--r-- | www/j3d1_5_2/RELEASE-NOTES-beta2.html | 348 |
5 files changed, 414 insertions, 19 deletions
diff --git a/release-info/pre-release/README-download.html b/release-info/pre-release/README-download.html index 7cfed64..a12840b 100644 --- a/release-info/pre-release/README-download.html +++ b/release-info/pre-release/README-download.html @@ -6,7 +6,7 @@ <title>3D Graphics API for the Java Platform 1.5.2: Installation Instructions</title> </head> <body> -<h2>3D Graphics API for the Java Platform 1.5.2-beta1 Pre-Release</h2> +<h2>3D Graphics API for the Java Platform 1.5.2-beta2 Pre-Release</h2> <p>This software is licensed by Sun, as specified in the <a href="LICENSE-GPLv2.txt">LICENSE-GPLv2.txt</a> file. You must only use this software in accordance with the terms under which the code is @@ -16,14 +16,14 @@ licensed. <p>The 1.5.2-build1 version of the j3d package runs on JDK version 1.5.0 and higher. It has been released for the Windows, Linux, Solaris, and Mac OS X operating environments. See the -<a href="http://j3d-core.dev.java.net/j3d1_5_2/RELEASE-NOTES-beta1.html">release +<a href="http://j3d-core.dev.java.net/j3d1_5_2/RELEASE-NOTES-beta2.html">release notes</a> for more information. </p> <h3>Preferred method</h3> <p>Developers who wish to develop an application using the j3d package -are encouraged to download the j3d-1_5_2-beta1-XXX-i586.zip file for +are encouraged to download the j3d-1_5_2-beta2-XXX-i586.zip file for their platform, and manually install the necessary files into a directory on their local disk. To do this, unzip the downloaded file, and follow the instructions in the unzipped README.txt file. @@ -39,7 +39,7 @@ native libraries directly into the JRE. <h4>Windows</h4> <p>To install the j3d package on Windows, download the binary installer and then execute it, by double-clicking on the -j3d-1_5_2-beta1-windows-i586.exe (or j3d-1_5_2-beta1-windows-amd64.exe) +j3d-1_5_2-beta2-windows-i586.exe (or j3d-1_5_2-beta2-windows-amd64.exe) icon. </p> @@ -50,7 +50,7 @@ execute it. For example, on a 32-bit Linux system: </p> <ul> cd /myhome/j3d<br> -sh /path-to-download-files/j3d-1_5_2-beta1-linux-i586.bin<br> +sh /path-to-download-files/j3d-1_5_2-beta2-linux-i586.bin<br> </ul> <p>After doing this, you will need to modify your CLASSPATH @@ -72,7 +72,7 @@ export LD_LIBRARY_PATH=/myhome/j3d/lib/i386 <h4>Mac OS X</h4> <p>No installer is available for the Mac OS X operating environment. -You will need to download the j3d-1_5_2-beta1-macosx.zip file, unzip it, +You will need to download the j3d-1_5_2-beta2-macosx.zip file, unzip it, and follow the instructions in the unzipped README.txt file. </p> </body> diff --git a/release-info/pre-release/README.html b/release-info/pre-release/README.html index 4cb509e..43e6579 100644 --- a/release-info/pre-release/README.html +++ b/release-info/pre-release/README.html @@ -6,19 +6,19 @@ <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-beta1 +<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-beta1. +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-beta1</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> @@ -28,7 +28,7 @@ x86</a>, <a href="#Linux">Linux</a>, <a href="#Windows">Windows</a>, <a installing this version.</span> </p> <h3><a name="System_Requirements"></a>System Requirements</h3> -<p>The 1.5.2-beta1 version of the Java 3D API has been released +<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 @@ -36,7 +36,7 @@ Mac OS X (both PPC and x86). </p> <h4><a name="Solaris_Sparc"></a>Solaris Sparc</h4> <p> -The 1.5.2-beta1 version of Java 3D for Solaris SPARC requires the +The 1.5.2-beta2 version of Java 3D for Solaris SPARC requires the following: </p> <ul> @@ -52,7 +52,7 @@ obtained at: <a href="http://www.sun.com/software/graphics/opengl/">http://www.s </ul> <h4><a name="Solaris_x86"></a>Solaris x86</h4> <p> -The 1.5.2-beta1 version of Java 3D for Solaris x86/amd64 requires +The 1.5.2-beta2 version of Java 3D for Solaris x86/amd64 requires the following: </p> @@ -64,7 +64,7 @@ following: </ul> <h4><a name="Linux"></a>Linux<br> </h4> -<p>The 1.5.2-beta1 version of Java 3D for Linux (x86 or amd64) +<p>The 1.5.2-beta2 version of Java 3D for Linux (x86 or amd64) requires the following:<br> @@ -79,7 +79,7 @@ extension: GLX </ul> <h4><a name="Windows"></a>Windows<br> </h4> -<p>The 1.5.2-beta1 version of Java 3D for Windows 2000, +<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> @@ -121,7 +121,7 @@ for example: ATI driver bugs). </ul> <h4><a name="MacOSX"></a>Mac OS X</h4> -<p>The 1.5.2-beta1 version of Java 3D for Mac OS X (PPC or x86) +<p>The 1.5.2-beta2 version of Java 3D for Mac OS X (PPC or x86) requires the following:<br> </p> <ul> @@ -139,6 +139,29 @@ Intel-based Apple systems)<br> <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> diff --git a/src/classes/share/javax/media/j3d/J3dClock.java b/src/classes/share/javax/media/j3d/J3dClock.java index fe74d83..e11c929 100644 --- a/src/classes/share/javax/media/j3d/J3dClock.java +++ b/src/classes/share/javax/media/j3d/J3dClock.java @@ -37,6 +37,10 @@ package javax.media.j3d; */ class J3dClock { + // Issue 543 - Flag to indicate whether clock skews are taken in account + // and corrected. false by default. Set by the "j3d.adjustClockSkew" property. + private static boolean skewAdjustedClock = false; + private static long deltaTime; private static final long nsecPerMsec = 1000000; @@ -45,7 +49,7 @@ class J3dClock { */ private J3dClock() { } - + /** * Returns the current time in milliseconds. This is a more * accurate version of System.currentTimeMillis and should be used in @@ -54,10 +58,30 @@ class J3dClock { * @return the current time in milliseconds. */ static long currentTimeMillis() { - return (System.nanoTime() / nsecPerMsec) + deltaTime; + if (!skewAdjustedClock) { + return (System.nanoTime() / nsecPerMsec) + deltaTime; + } else { + // Issue 543 - Adjust for possible clock skew + long time = (System.nanoTime() / nsecPerMsec) + deltaTime; + long sysTime = System.currentTimeMillis(); + if (Math.abs(time - sysTime) > 50) { + long baseTime, baseTimerValue; + synchronized (J3dClock.class) { + baseTime = System.currentTimeMillis(); + baseTimerValue = System.nanoTime(); + } + deltaTime = baseTime - (baseTimerValue / nsecPerMsec); + time = (System.nanoTime() / nsecPerMsec) + deltaTime; + } + return time; + } } static { + // Issue 543: get property for clock skew adjustment + skewAdjustedClock = MasterControl.getBooleanProperty("j3d.adjustClockSkew", + skewAdjustedClock, "clock skew adjustment"); + // Call time methods once without using their values to ensure that // the methods are "warmed up". We need to make sure that the actual // calls that we use take place as close together as possible in time. diff --git a/src/classes/share/javax/media/j3d/MasterControl.java b/src/classes/share/javax/media/j3d/MasterControl.java index 13b971b..3e44138 100644 --- a/src/classes/share/javax/media/j3d/MasterControl.java +++ b/src/classes/share/javax/media/j3d/MasterControl.java @@ -857,7 +857,7 @@ class MasterControl { }); } - private static boolean getBooleanProperty(String prop, + static boolean getBooleanProperty(String prop, boolean defaultValue, String trueMsg, String falseMsg) { @@ -871,7 +871,7 @@ class MasterControl { return value; } - private static boolean getBooleanProperty(String prop, + static boolean getBooleanProperty(String prop, boolean defaultValue, String msg) { return getBooleanProperty(prop, diff --git a/www/j3d1_5_2/RELEASE-NOTES-beta2.html b/www/j3d1_5_2/RELEASE-NOTES-beta2.html new file mode 100644 index 0000000..12ee3ac --- /dev/null +++ b/www/j3d1_5_2/RELEASE-NOTES-beta2.html @@ -0,0 +1,348 @@ +<!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><a + href="http://download.java.net/media/java3d/builds/stable/1_5_2-beta2/README-download.html">Click +here</a> for instructions +on +<a + href="http://download.java.net/media/java3d/builds/stable/1_5_2-beta2/README-download.html">how +to install</a> this release of +Java 3D +version 1.5.2-beta2.</p> +<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> |