Dave,

The goal is to fix the bugs at the bottom of the README prior to the
FCS release of Java 3D 1.2.1.  We will also be putting out a Beta 2
for 1.2.1 once we have fixed a critical mass of bugs reported in 1.2.1.



Rob Posadas

Manager, 3d Graphics Software
Sun Microsystems
[EMAIL PROTECTED]
(650) 786-7873




>
> Thanks Rob!
>
> It is great to see a new release coming out.  It is also disconcerting to
> read the list of known problems at the bottom.  Any idea on a release
> schedule for 1.2.2?  Before year's end perhaps?  If this is 1.2.1 beta, does
> that mean the known list of issues will be fixed before 1.2.1 production?
>
> Dave Yazel
>
> ----- Original Message -----
> From: Rob Posadas <[EMAIL PROTECTED]>
> To: <[EMAIL PROTECTED]>
> Sent: Wednesday, September 27, 2000 2:47 PM
> Subject: Re: [JAVA3D] Release Data of 1.2.1 (Beta)
>
>
>
> We are about to begin the release process for Java 3D 1.2.1,
> and that has been taking about two weeks.  So the Beta version
> of 1.2.1 should be out by mid October.
>
> As far as changes, mainly bug fixes and performance enhancements.
>
> Attached are the README's for 1.2.1.
>
>
> Rob Posadas
>
> Manager, 3d Graphics Software
> Sun Microsystems
> [EMAIL PROTECTED]
> (650) 786-7873
>
>
>
>
> >
> > Hi all
> >
> > i only want to remind the sun team, that the below mail from Mark Ferneau
> > has not yet been answered( i did not found current informations to this
> > topic in the interest group). It would be great if anybody could give us
> > some information about the release Date and the most important changes
> over
> > 1.2!
> >
> > thanks a lot
> >
> > Alexander Wojnar
> >
> >
> >
> >
> > -----Ursprüngliche Nachricht-----
> > Von: Discussion list for Java 3D API
> > [mailto:[EMAIL PROTECTED]]Im Auftrag von Mark Ferneau
> > Gesendet: Monday, September 25, 2000 11:54 PM
> > An: [EMAIL PROTECTED]
> > Betreff: [JAVA3D] Release Data of 1.2.1 (Beta)
> >
> >
> > Can anyone from Sun provide an estimated release date for J3D 1.2.1,
> > Beta?  At Siggraph Michael Schulman indicated it would be out this summer
> > and, as of last week, we're in Autumn (at least in the US).
> >
> > --Mark
> >
> > Mark Ferneau                    240-462-6262 (cell)
> > Director of Adv. Technology             801-437-4608 (efax)
> > Xtivia Technologies, Inc.               732-469-5954 x629 (NJ office)
> > [EMAIL PROTECTED]                      301-279-5703 (home office)
> > http://www.xtivia.com/          [EMAIL PROTECTED] (wireless email)
> >
> >
> ===========================================================================
> > To unsubscribe, send email to [EMAIL PROTECTED] and include in the
> body
> > of the message "signoff JAVA3D-INTEREST".  For general help, send email to
> > [EMAIL PROTECTED] and include in the body of the message "help".
>
>
>
> ----------------------------------------------------------------------------
> ----
>
>
> Java 3D(TM) 1.2.1 Beta
>
> README file for Solaris/SPARC/OpenGL
>
> This file contains important information for users of Java 3D(TM).
> The first four sections (Requirements, Installation, Shared
> Contexts, and Running Java 3D(TM) in a Browser) are of interest
> to all Java 3D(TM) users.  The rest of this file applies only to
> developers of Java 3D(TM) applications.
>
> ** It is recommended that any previous version of Java 3D(TM) be
> ** uninstalled before installing this version.
>
> ============
> REQUIREMENTS
> ============
>
> This version of Java 3D(TM) for Solaris/SPARC requires the following:
>
>   Java 2 Runtime or SDK version 1.2.2 or later from Sun Microsystems.
>   It is recommended that you use the production release
>   (www.sun.com/solaris/java) but you may use the
>   reference implementation
>   (http://java.sun.com/products/jdk/1.2/download-solaris.html).
>   If you are using the reference implementation, you must use
>   native threads.  Green threads are not supported.
>
>   Frame Buffer with OpenGL support (Expert3D, Elite3D, Creator3D,
>   PGX).
>
>   Solaris 2.7 or later.
>
>   OpenGL 1.2.1 for Solaris or later.
>   To find your current version, use `pkginfo -l SUNWglrt`
>   OpenGL for Solaris can be obtained at
>   http://www.sun.com/solaris/opengl
>
>   PATCHES
>
>   There are no patches required for Solaris 8.
>
>   Solaris 7 requires the Kernel Update patch (106541-06 or later)
>   which fixes a bug on multi-processor systems that can lock up
>   the window system when running a Java 3D program with more than
>   one active window:
>
>   Use `showrev -p` to list installed patches.  Patches can be
>   downloaded for free from http://sunsolve.sun.com/.
>
> ============
> INSTALLATION
> ============
>
> You must have permission to write files in your Java(TM) Runtime
> Environment and/or SDK directories.  If you do not have this
> permission, the installer will run to completion but Java 3D(TM)
> will not be installed.  Make sure you are running Java(TM) from
> your local machine and that you are the same user who installed
> Java.
>
> To install Java 3D(TM), execute the Java 3D(TM) GUI Installer
> program from any directory:
>
>    Runtime only:      java3d1_2_1beta1-solsparc-rt-ia.bin
>    Runtime and SDK:   java3d1_2_1beta1-solsparc-sdk-ia.bin
>
> After accepting the license agreement and viewing this file,
> you will be asked to select which Java(TM) VM to upgrade
> with Java 3D(TM).  JVMs from your PATH will be listed, or
> you may choose a different one by selecting its 'java'
> executable.
>
> After installation, you may remove the executable GUI installer.
>
> The Java 3D(TM) SDK includes several demo programs that can
> verify correct installation.  Assuming your Java 2 SDK is installed
> at ~/j2sdk1.3.0_01, try the following:
>
>         cd ~/j2sdk1.3.0_01/demo/java3d/HelloUniverse
>         java HelloUniverse
>
>         Note: Many more demos are available under the demo/java3d/
>               directory.  Some of the demos require a maximum memory
>               pool larger than the default in java.  To increase the
>               maximum memory pool to 64 megabytes, add the following
>               command line options to java or appletviewer:
>                   java: -mx64m
>                   appletviewer: -J-mx64m
>
> Make sure you have the SUNWi1of package (optional fonts) installed by
> running `pkginfo SUNWi1of`.  If not present, you may see error messages
> like this:
>
>     Font specified in font.properties not found
>     [-b&h-lucida sans typewriter-bold-r-normal-sans-*-%d-*-*-m-*-iso8859-1]
>     ...
>
> Java 3D(TM) consists of four jar files and two shared libraries.
> You do not need to include the jar files in your CLASSPATH,
> nor do you need to include the shared libraries in your PATH.
> You should include "." in your CLASSPATH or ensure that CLASSPATH
> is not set.
>
> Java 3D documentation and tutorials are available from the Java 3D(TM)
> Home Page: http://java.sun.com/products/java-media/3D/
>
> ===============
> SHARED CONTEXTS
> ===============
>
> This version of Java 3D is able to use shared contexts in OpenGL for Display
> Lists and Texture Objects.  For single canvas applications, there will be no
> change in behavior.  For multiple canvas applications, memory requirements
> will decrease by using this property.  To enable the use of shared contexts
> set the j3d.sharedctx property to true, for example:
>
>     java -Dj3d.sharedctx=true MyProgram
>
>
> ================================
> RUNNING JAVA 3D(TM) IN A BROWSER
> ================================
>
> Java 3D programs can be run in Netscape Communicator on Solaris
> with the Java(TM) Plug-IN (JPI) installed:
>
>   Solaris 8 includes Netscape and the JPI.
>
>   For Solaris 7 users, Netscape Communicator may be downloaded
>   for free from http://www.sun.com/solaris/netscape.  Patches
>   may be required (see the website for details).
>
>   Netscape Communicator 6.0 automatically includes the JPI.
>
>   Java 1.3 also includes the JPI.  The Control Panel will
>   be at ~/j2sdk1.3.0_01/jre/ControlPanel.html.
>
>   If you are using Solaris 7, Java 1.2.2, and Netscape 4.51, 4.7,
>   or 4.74, you need to download and install the JPI from
>   http://www.sun.com/solaris/netscape/jpis.  NOTE: requires
>   membership to the JDC.  More patches may be required
>   (see the website for details).  If you install it in
>   the default location (/opt/NSCPcom) the control panel
>   will be at file:/opt/NSCPcom/j2pi/ControlPanel.html.
>
> You need to set the NPX_PLUGIN_PATH environment variable
> to the directory containing the JPI.  For example, you you
> are using the JPI from Java 1.3 installed in ~/j2sdk1.3.0_01,
> do 'setenv NPX_PLUGIN_PATH ~/j2sdk1.3.0_01/jre/plugin/sparc'
> before starting Netscape.  The default is /opt/NSCPcom.
>
> There is a bug in the Solaris JPI 1.2.2 that keeps it
> from finding Java extensions in the lib/ext/ directory
> where they are kept.  If you are not using JPI 1.3, you need to
> copy the four .jar files from the lib/ext/ directory to the
> lib/ directory as follows:
>
>     cd $SDKHOME/jre/lib/ext
>     cp j3daudio.jar ..
>     cp j3dcore.jar ..
>     cp j3dutils.jar ..
>     cp vecmath.jar ..
>
> To verify proper installation, point your browser to
> file:/home/myhome/j2sdk1.3.0_01/demo/java3d/index.html
>
> If it seems like Java 3D isn't installed, make sure the JPI
> is using the JVM you've upgraded with Java 3D(TM).  Run the
> JPI Control Panel and click on the "Advanced" tab to change
> the JVM associated with the JPI.  Under "Java Run Time
> Environment" choose "Other..." and Enter the path to your
> JVM in the 'Path:' box (for example,
> /home/myhome/j2sdk1.3.0_01/jre).  Press "Apply."  (Note:
> choose the directory above the 'bin' directory.)
>
> NOTE: Many Java 3D(TM) programs will require a larger heap size
> than the default 16M in the JPI.  In the Control Panel
> "Java Run Time Parameters" put "mx64m" for 64M of heap memory.
>
> To create a web page with Java 3D, you need to use special HTML
> code to force the browser to use the JPI VM.  Refer to the
> following URL for information on using Java Plug-In "HTML
> Converter" and running applets using Java Plug-in:
>
>         http://java.sun.com/products/plugin/
>
> ====================================================
> DISTRIBUTING Java 3D(TM) WITH YOUR JAVA(TM) PROGRAMS
> ====================================================
>
> Sun Microsystems allows vendors to distribute the Java 3D(TM) Runtime
> environment with their Java programs, provided they follow the terms
> of the Java 3D(TM) Evaluation License agreement.
>
> This document uses the term "vendors" to refer to licensees,
> developers, and independent software vendors (ISVs) who license and
> distribute Java 3D(TM) with their Java programs.
>
> REQUIRED vs. OPTIONAL FILES
> ---------------------------
> Vendors must follow the terms of the Java 3D(TM) Evaluation License
> agreement, which includes these terms:
>
>  - Don't arbitrarily subset Java 3D(TM). You may, however, omit those
>    files that have been designated below as "optional".
>
>  - Include in your product's license the provisions called out
>    in the Java 3D(TM) Evaluation License.
>
> BUNDLING Java 3D(TM)
> --------------------
> Java 3D(TM) comes with its own installer that makes it suitable for
> downloading by end users. Java(TM) application developers have the
> option of not bundling Java 3D(TM) with their software.  Instead,
> they can direct end-users to download and install the Java 3D(TM)
> software themselves.
>
> Required Files
> --------------
>
> When bundling Java 3D(TM) with your application, the following files
> must be included (Solaris):
>
>         <JREDIR>/lib/sparc/J3D.so
>         <JREDIR>/lib/sparc/j3daudio.so
>         <JREDIR>/lib/ext/vecmath.jar
>         <JREDIR>/lib/ext/j3dcore.jar
>         <JREDIR>/lib/ext/j3daudio.jar
>         <JREDIR>/lib/ext/j3dutils.jar
>
> Optional Files
> --------------
>
> An application developer may include these files and directories
> with their Java 3D(TM) application, but is not required to do so:
>
>         <JDKDIR>/j3d-utils-src.jar
>         <JDKDIR>/demo/java3d
>
>
> ========================
> CHANGES SINCE 1.2
> ========================
>
> ==========
> BUGS FIXED
> ==========
>
> Documentation
> -------------
> 4199091 Raster object uses the alpha value inside the image to perform
>         blend operation
> 4354497 Locale pickAll() param description incorrect
>
> Example Programs
> 4212805 ReadRaster test program has race condition
> 4367277 OffScreenTest example program does not work consistently
>
> Graphics
> --------
> 4186219 Geometry Collision does not implement points/surface, line/line, or
>         line/point
> 4250253 GeometryInfo leaks memory in some cases (with Appearance?)
> 4309059 background geometry appears very close to the camera vs 1.1.3
> 4315058 VolRend display white cube when Axis Volumne is 3D
> 4331434 adding object to itself does not generate an exception
> 4332530 Win32 Stereo: zbuffer not cleared when rendering right eye
> 4333846 JavaPresents intermittently throws IndexOutOfBoundsException
> 4335205 WakeupOnCollision fail if arming Node is TransformGroup which
> undergo
>         transform
> 4335969 Memory leak when Branch/View/Canvas3D remove
> 4335549 ImageComponent2D not live when under Background Node
> 4336263 Automatic texture generation eye linear fail when switch back
>         from object linear
> 4337095 Collision detection did not work sometimes when modify interactively
> 4337665 Geometry by reference using interleaved & color with alpha may crash
>         system
> 4337832 removeNotify throws NullPointerException when parent is null
> 4337953 GeometryByReference with Interleaved array don't support
> multi-texture
> 4337966 GeometryArray initialVertexIndex is ignore in non-interleaved array
> 4338168 Behavior Scheduler should stop when all behaviors are disabled
> 4339211 fail to enable multitexture 1st time textureUnitState is set after
> sg
>         setLive
> 4339293 JVM Segmentation fault if depth Component not set in Raster
>         under v1.2.2-001
> 4340879 TUS fails to update transform change on some geometries added live
>         BranchGroup.
> 4340882 WakeupOnElapsedTime can't enable again after disable
> 4340979 Device Context not release in NativeConfigTemplate3D
> 4341212 isGraphicsConfigSupported() not yet implemented
> 4341229 Mixed mode rendering causes scene graph to render continuously
> 4341273 geometry not rendered properly when multiple texCoordSet is
> specified
> 4341689 SimpleGeometry example throws UnsatisfiedLinkError
> 4343019 changing transparency attribute doesn't work
> 4343160 J3d resources not freed up properly causing memory leak
> 4344890 WakeupOnCollisionMovement should not triggered when collision
>         object not move
> 4344920 Picking fails the second time for objects under share group
> 4345204 memory leak in when repeating create/destroy canvas3d
> 4346877 Tetxure By Reference and Raster by Reference does not work in
>         PureImmediate mode
> 4347496 Offscreen and ReadRaster requires a getImage() when using byRef
>         imagecomponent
> 4348626 Clip node application bound not updated when transform is changed
> 4348861 Geometry intersection fail to return collision in some orientation
> 4351033 NullPointer exception in MasterControl when running scene graph
>         viewer
> 4351100 Two copies of objects appear when branch detach and reattach to
>         scene graph
> 4352652 ModelClip fail to clip correctly in the first frame
> 4352667 Adding/removing canvas from view/panel makes geometry disappear
> 4353135 Display list initialize two times for Geometry
> 4354150 examples/PickTest/IntersectTest renders nothing
> 4354529 In a Universe with Multiple Locales transformGroup changes
>         are not rendered
> 4354578 DisplayList ID may invoke to draw geometry before it is created
> 4354666 SharedAlternateTargetTest throws NullPointer exception when detach
>         share group
> 4354751 transform ignored
> 4355101 ManySphere_Pure bad flickering
> 4355357 TexGen w/ EYE_LINEAR doesn't work properly with multitextures
> 4355441 Text3D disappeared
> 4355443 switch children may be incorrectly merged after compilation
> 4355908 depth write enable mask not reset correctly after rendering
>         transparent objects
> 4356240 repeatedly reloading an applet causes browser to hang
> 4357625 java3d fail to resume rendering after window deiconify
> 4357935 Memory leak when branchgroup remove
> 4357974 Mouse behavior no longer work after replaceBranchGraph
> 4358710 directional light unexpectedly moved with the scene in immediate
> 4359757 Applet reload will throws InternalError after 32 times
> 4360546 Stereo separation different between 1.2 and 1.2.1
> 4360588 Reepated add and removal of BranchGraphs to locale causes exception
> 4360823 NullPointerException in LightRetained.clearLive
> 4360849 NullPointerException when using moveTo()
> 4361889 isGraphicsConfigSupported() return incorrect result under windows
>         opengl version
> 4361988 MultiLocale test throws ArrayIndexOutOfBoundsException
> 4362044 DrawingSurfaceAWT Lock did not free, cause memory leak when canvas
>         reloaded
> 4362302 When a BranchGroup containing a texture is detached the
>         ImageComponent is Live
> 4362355 Picking fails once SceneGraph is compiled
> 4362374 ManySpheres_Pure intermittently crashes the JVM when run w/ dual cpu
> 4362773 Mutiple Locales do not behave properly in Java3D
> 4362907 compile() breaks examples/PickTest/IntersectTest program
> 4363084 ArrayIndexOutOfBoundsException in NormalGenerator
> 4363148 NullPointerException with sharedGroup under switch during setLive
> 4363269 Applet hangs sometimes when repeating reload
> 4363279 J3D crash under AFB/FFB after reload 32 times
> 4363875 Interpolator loopCount no longer works
> 4364572 D3D: Texture transform for translation or combine with TexCoordGen
>         did not work
> 4365111 texture not rendered correctly in immediate mode
> 4365133 RenderBin throws ClassCastException when OriS3D shared Appearance
>         with another S3D
> 4365139 OriS3D's orientedtransform didn't get applied when OS3D shared
>         appearance w/a S3
> 4365170 OrientedShape3D throws NullPointerException on text with spacing in
> it
> 4366359 Objects incorrectly rendered when adding/deleting from the
> scenegraph
> 4366775 RenderBin sometimes throws NullPointerException when object insert
> to
>         scenegraph
> 4366915 Shape missing when branchgraph attach/detach if there are multiple
>         LightBin
> 4367085 MultiScreens example program only renders on screen 0
> 4367212 MultiScreen test sometimes throws NullPointerException when startup
> 4367563 Incorrect reference of Canvas3D in Renderer
> 4367616 incorrect vwcBounds for LOD switch objects
> 4367891 D3D: crash when vertexbuffer is used in some test case
> 4367949 Off-screen rendering sometimes returns old image
> 4368116 D3D: sometime crash when GeometryByReference non-interleaved array
>         use
> 4368117 D3D: crash when DecalGroup is used
> 4315021 Robot test fail to pick object under windows
>
> Sound
> -----
> 4334767 examples/MoveAppBoundingLeaf sometimes produces no sound
> 4347519 BackgroundSound did not check for scheduling Bounds
> 4360447 Sound nodes shared by 2 universes throws exception
> 4360448 MediaContainer.setURLString() sets url field
> 4360451 Sound.setSoundData() with a new MediaContainer is ignored
> 4360454 MediaContainer.setURL() with new URL is ignored
> 4360461 Filtering only performed on non-cached MediaContainer
> 4360462 setMediaContainer(InputStream) not loaded on audio device
> 4368186 Reattaching sound node restarts previously enabled sound
>
> Utilities
> ---------
> 4309080 investigate whether TextureLoader should use drawImage vs
> PixelGrabber
> 4328532 Textures for the bottom of cones and cylinders are upside-down
> 4336095 Picking using GEOMETRY_INTERECT_INFO fail on fan and
>         strip geometry
> 4336628 Simple Universe returns incorrect viewingPlatform
> 4345865 Incorrect callback argument in MouseZoon/MouseRotate
> 4347996 PickCanvas setTolerance has no effect if it call after
>         setShapeLocation
> 4358065 GeometryInfo methods scope too restrictive
> 4363154 Sphere sharing cause problem in compile mode
> 4363208 Picking util. can miss the closet geometry, when multiple S3Ds are
>         intersected
> 4364128 Non-uniform scale not implemented in
>         RotPosScaleTCBSplinePathInterpolator
>
>
> ============
> NEW FEATURES
> ============
>
> All example program now have example.html and example_plugin.html for
> use with the plugin feature available with most web browsers.  In addition,
> an html page, demo/java3d/index.html now contains links to all demo programs
> that can be run as applets.
>
> =======================
> Constructing a Canvas3D
> =======================
>
> Many Java 3D programs pass null to the Canvas3D constructor.  By doing
> this, Java 3D will select a default GraphicsConfiguration that is
> appropriate for Java 3D.  However, this is a bad practice, and can lead
> to errors when applications try to run in alternate environments, such as
> stereo viewing.  Java 3D will now print out a warning if the Canvas3D
> constructor is passed in a null argument for the GraphicsConfiguration.
>
> =========
> Utilities
> =========
>
> This release includes utilities for Java 3D.  These utilities are still
> being defined and under development.  Much of the source for these utilities
> is also provided.  The API for these utilities may change in future
> releases.
>
> The following utilities are provided in this release:
>
>         - Java Sound Audio Device
>         - Some predefined Mouse based behaviors
>         - Picking utilities including predefined picking behaviors
>         - Geometry creation classes for Box, Cone, Cylinder, and Sphere
>         - A Text2D utility
>         - A Universe Builder - SimpleUniverse
>         - An Image Loading utility
>         - A Normal Generator utility
>         - A Polygon Triangulator utility
>         - Triangle stripifier
>         - Geometry compression utilities
>         - Spline-based path interpolators
>         - Wavefront .obj loader
>         - Lightwave 3D File Loader
>
> ===================================
> Enabling Stereo with SimpleUniverse
> ===================================
>
> The SimpleUniverse utility does not, by default, request a
> GraphicsConfiguration that is capable of Stereo rendering.  To enable this,
> you need to set a property when running your application.  Here is an
> example.
>
> java -Dj3d.stereo=PREFERRED MyProgram
>
> Some framebuffers only have one Z buffer and share this between the left
> and right eyes.  If you are experiencing problems using stereo try the
> following property:
>
> java -Dj3d.stereo=PREFERRED -Dj3d.sharedstereozbuffer=true MyProgram
>
>
> ==============
> KNOWN PROBLEMS
> ==============
>
> Documentation Bugs
> ------------------
> 4161432 Transform3D transform definitions are imprecise with respect to
>         mirror transform
> 4181456 make Sensor.setSensorReadCount MT-safe
> 4259353 documentation for com.sun.j3d.utils.geometry.Box is confusing
> 4284971 Specify that wakeup criteria should not be shared
> 4284976 Specify that getProjection is illegal in non-compatibility mode
> 4297142 RotationPathInterpolator has problem if angle equal Math.PI
> 4303052 Quaternion documentation is inadequate
> 4303053 javadoc for DistanceLOD with multiple switch nodes needs improvement
> 4303054 Lighting equations should be updated to reflect color override
> 4303055 Docs should specify effect on clipped portion of ImageComponent
> 4303056 Docs should specify thread-safety behavior of Java 3D methodsc
> 4303062 Need to specify which attributes are passed by reference versus by
>         value
> 4307547 Need to doc. : scene graph needs to have at least a Canvas3D to keep
>         j3d working
> 4310958 Docs should specify wrong bounds may be used in region of influence
>         operations
> 4312421 Need to document texture by reference
> 4316844 Documentation of Java 3D colors should specify gamma assumptions
> 4348286 Shape3D intersect() should mention Geometry.ALLOW_INTERSECT need
>         to be set
> 4364767 Java3D's render loop doesn't run continuously
> 4366468 Background Geometry missing documentation
>
>
> Examples
> --------
> 4296091 Infinite loop in McadPickTestImm postSwap()
> 4312044 java Viewer reflects only Lightwave objects with depth
>
> Core Graphics & Vecmath
> -----------------------
> 4154445 PathInterpolator's setKnot method does not validate inputs
> 4160172 Access to some aggregate data is not MT-safe
> 4179923 ReadRaster does not clip to screen correctly
> 4181340 Updating the view cache could be a problem if other canvas running
>         on same view
> 4181344 Java 3D cannot handle more than 64 lights
> 4181349 Need to add Transform to SceneGrphPath hashCode
> 4181417 Need to add an internal epsilonEquals method for bounds objects
> 4186182 sceneAntialiasing setting of PREFERRED is ignored
> 4189092 HEAD_PREDICTOR and HAND_PREDICTOR policies not implemented
> 4191172 Text3D rendering problems
> 4193466 GMatrix SVD does not work correctly for some cases
> 4246325 AWT Event once enable, will not disable when behavior remove
> 4259345 Text3D does not correctly convert geometry of Japanese-text
> 4260818 java3d should support stereo graphics automatically
> 4269784 vecmath.GMatrix.LUD inefficient
> 4269923 LOD's slow
> 4299480 readRaster() and waitForOffScreenRendering() will not work if
>         threadLimit=1
> 4305676 Native method error messages not I18N ready
> 4308591 Text3D objects bounding box not accurate enough
> 4309925 JCK: BoundingPolytope / BoundingSphere does not return empty bound
>         as it should
> 4313678 Java3D disables invalid lights
> 4325851 Hardware MultiTexture not supported even though numActiveTexture
>         <= supported num
> 4331646 rendering differences between WIN32 and Solaris platforms
> 4331677 setWindowResizePolicy(View.VIRTUAL_WORLD) doesn't work
> 4335245 Raster type RASTER_COLOR_DEPTH did not work as expected
> 4340598 Morph did not work after setGeometryArrays() in behavior
> 4340607 Node and NodeComponent's set* methods not synchronized with
>         set/clearLive
> 4342430 Raster write do not clip image if raster offset/size defined
>         outside boundary
> 4342945 non-congruent transform exceptions: error correct or doc?
> 4343287 Blending not enabled for antialiased lines
> 4346786 OutOfMemory error when generating 20,000 Box primitives
> 4348562 GMatrix SVD method incorrect output and throws
>         ArrayIndexOutOfBoundsException
> 4348609 Poor rendering of textures on NT with 16 bit color
> 4350033 possible conflict between implementation and spec on
>         PolygonOffset
> 4351050 APIs issue : Shape3D and Morph's intersect method.
> 4351579 APIs issue : Shape3D intersect method -- multiple geometry support
> 4352922 JFTC: light InfluencingBounds (BoundingSphere) seems to be broken
>         on 1.2.1
> 4355041 JFTC: LOD failed to change level of detail after 1st frame
> graphics_si
> 4355332 Require Thread safe removeChild in BranchGroup
> 4357843 Picking doesn't handle OrientedShape3D's orientation when doing
>         intersect test
> 4358284 readRaster() ignore StereoMode context
> 4358700 Geometry intermitantly disappears from scene
> 4359600 Transform3D returning NaNi
> 4359609 MediaContainer does not report errors
> 4359764 Java3D does not support > 32 canvas
> 4360688 Geometric primitives need to be optimized
> 4361036 texture mapped quad using geometry by reference doesn't work
> 4363761 getImagePlateToVworld not synchronized with View
> 4363884 Alpha that is no longer running still takes up CPU time
> 4363899 APIs issue : OrientedShape3D's intersect method needs view info
> 4363990 Texture image and TransformGroup  not update synchronously
> 4364343 shared objects no longer pickable after re-attaching to scene graph
> 4364493 Mirror transforms are not always classified correctly
> 4365165 JVM crashed when similar text is used on both OrientedShape3D
>         and Shape3D
> 4365207 OriS3D's vwcBound computation needs to consider OriS3D's
>         orientedtransform
> 4366060 ObjectFile.load() throws IndexOutOfBoundsException
> 4366473 Background geometry does not animate
> 4366494 RenderBin throws exception, possibly related to OrderedGroup under
>         Background
> 4366511 Full screen antialiasing slow under OpenGL
> 4366528 Text2D rendered out-of-order in OrderedGroup
> 4368120 D3D: Color attributes change not working if vertex buffer is used
> 4368396 Geometry flashes
>
> Sound
> -----
> 4138605 using any non-javasound java sound causes severe performance hit
> 4164181 Sound performance on native threads is bad
> 4187092 Filtering causes loud, sweeping resonance to be added to most sounds
> 4187093 Cross-talk cancellation for sound playback in not implemented
> 4315018 Garbage sound in TestFilter
> 4348236 No background sound sometimes when startup
> 4348247 stopView() fail to stop background sound
> 4360456 PointSound.setPosition() not update unless parent transform modified
> 4360463 Doppler calculated results in less than expected frequency variation
> 4367333 programs/other/SoundExamples/ImmediateMode doesn't work correctly
>
> Utility Bugs
> ------------
> 4158783 lw3d loader loses textures after pressing the reload button on
>         Netscape
> 4173647 Cannot share Sphere objects of same size between immediate and
>         retained mode
> 4217567 NormalsGenerator only checks the cosine for smoothing
> 4252349 First viewport may jump when using KeyNavigatorBehavior
> 4259533 getTexture() throws NullPointerException when using proxies
> 4308592 texture loader does not scale non-power-of-2 RGBA textures properly
> 4331669 setRectangleScaleFactor will not change text size unless setString
>         called
> 4336679 In examples/PickTest program, a pick miss can happen on morph object
> 4343427 Loader interface has no facility to monitor progress of Load
> Operation
> 4347998 PickTool pickGeomAllSorted did not compute closest distance for
>         PickConeRay
> 4367699 Lightwave Loader throws NullPointerException when loading data from
>         a Stream
>
>
> Solaris-specific Bugs
> ---------------------
> none
>
>
>
>
> ----------------------------------------------------------------------------
> ----
>
>
> Java 3D(TM) 1.2.1 Beta
>
> README file for Win32/DirectX
>
> This file contains important information for users of Java 3D(TM).
> The first three sections (Requirements, Installation, and Running
> Java 3D(TM) in a Browser) are of interest to all Java 3D(TM) users.
> The rest of this file applies only to developers of Java 3D(TM)
> applications.
>
> ** It is recommended that any previous version of Java 3D(TM) be
> ** uninstalled before installing this version.
>
> ============
> REQUIREMENTS
> ============
>
> This version of Java 3D(TM) for Windows 98 and Windows 2000
> requires the following:
>
>         Java 2 (Runtime or SDK) version 1.2.2 or later from Sun
>         Microsystems (http://java.sun.com/jdk/).  This includes
>         the Java Plug-In (JPI) to update Java(TM) in your browser.
>
>         DirectX 7.0 or later, available from Microsoft
>         (http://www.microsoft.com/directx/default.asp).
>
> ============
> INSTALLATION
> ============
>
> You must have permission to write files in your Java(TM) Runtime
> Environment and/or SDK directories.  If you do not have this
> permission, the installer will run to completion but Java 3D(TM)
> will not be installed.  Make sure you are running Java(TM) from
> your local machine and that you are the same user who installed
> Java.
>
> To install Java 3D(TM), execute the Java 3D(TM) GUI Installer
> program from any directory:
>
>    Runtime only:      java3d1_2_1beta1-win32-directx-rt-ia.bin
>    Runtime and SDK:   java3d1_2_1beta1-win32-directx-sdk-ia.bin
>
> The installers will upgrade your most recently installed Java
> Runtime Environment and SDK.
>
> After installation, you may remove the executable GUI installer.
>
> The Java 3D(TM) SDK includes several demo programs that can
> verify correct installation.  Assuming your Java 2 SDK is installed
> at \jdk1.3, try the following:
>
>         cd \jdk1.3\demo\java3d\HelloUniverse
>         java HelloUniverse
>
>         Note: Many more demos are available under the demo\java3d\
>               directory.  Some of the demos require a maximum memory
>               pool larger than the default in java.  To increase the
>               maximum memory pool to 64 meg, add the following command
>               line options to java or appletviewer:
>                   java: -mx64m
>                   appletviewer: -J-mx64m
>
>
> Java 3D(TM) consists of four jar files and two shared libraries.
> You do not need to include the jar files in your CLASSPATH,
> nor do you need to include the shared libraries in your PATH.
> You should include "." in your CLASSPATH or ensure that CLASSPATH
> is not set.
>
> Java 3D documentation and tutorials are available from the Java 3D(TM)
> Home Page: http://java.sun.com/products/java-media/3D/
>
>
> ================================
> RUNNING JAVA 3D(TM) IN A BROWSER
> ================================
>
> You can run Java 3D(TM) programs in your browser.  Java 2(TM)
> from Sun includes the Java Plug-In (JPI) to upgrade the Java(TM)
> in the browser to Java 2(TM).  To verify proper installation,
> point your browser to file:/jdk1.3/demo/java3d/index.html
>
> NOTE: Many Java 3D(TM) programs will require a larger heap size
> than the default 16M in the JPI.  Run the Java Plug-In Control
> Panel from Start/Programs (JPI 1.2.2) or Start/Settings/Control
> Panel (JPI 1.3) and in "Java Run Time Parameters" put "mx64m"
> for 64M of heap memory.
>
> To create a web page with Java 3D, you need to use special HTML
> code to force the browser to use the JPI VM.  Refer to the
> following URL for information on using Java Plug-In "HTML
> Converter" and running applets using Java Plug-in:
>
>         http://java.sun.com/products/plugin/
>
> ====================================================
> DISTRIBUTING Java 3D(TM) WITH YOUR JAVA(TM) PROGRAMS
> ====================================================
>
> Sun Microsystems allows vendors to distribute the Java 3D(TM) Runtime
> environment with their Java programs, provided they follow the terms
> of the Java 3D(TM) Evaluation License agreement.
>
> This document uses the term "vendors" to refer to licensees,
> developers, and independent software vendors (ISVs) who license and
> distribute Java 3D(TM) with their Java programs.
>
> REQUIRED vs. OPTIONAL FILES
> ---------------------------
> Vendors must follow the terms of the Java 3D(TM) Evaluation License
> agreement, which includes these terms:
>
>  - Don't arbitrarily subset Java 3D(TM). You may, however, omit those
>    files that have been designated below as "optional".
>
>  - Include in your product's license the provisions called out
>    in the Java 3D(TM) Evaluation License.
>
> BUNDLING Java 3D(TM)
> --------------------
> Java 3D(TM) comes with its own installer that makes it suitable for
> downloading by end users. Java(TM) application developers have the
> option of not bundling Java 3D(TM) with their software.  Instead,
> they can direct end-users to download and install the Java 3D(TM)
> software themselves.
>
> Required Files
> --------------
>
>         <JREDIR>\bin\J3D.dll
>         <JREDIR>\bin\j3daudio.dll
>         <JREDIR>\lib\ext\vecmath.jar
>         <JREDIR>\lib\ext\j3dcore.jar
>         <JREDIR>\lib\ext\j3daudio.jar
>         <JREDIR>\lib\ext\j3dutils.jar
>
> Optional Files
> --------------
>
> An application developer may include these files and directories
> with their Java 3D(TM) application, but is not required to do so:
>
>         <JDKDIR>\j3d-utils-src.jar
>         <JDKDIR>\demo\java3d
>
>
> ========================
> CHANGES SINCE 1.2
> ========================
>
> ==========
> BUGS FIXED
> ==========
>
> Documentation
> -------------
> 4199091 Raster object uses the alpha value inside the image to perform
>         blend operation
> 4354497 Locale pickAll() param description incorrect
>
> Example Programs
> 4212805 ReadRaster test program has race condition
> 4367277 OffScreenTest example program does not work consistently
>
> Graphics
> --------
> 4186219 Geometry Collision does not implement points/surface, line/line, or
>         line/point
> 4250253 GeometryInfo leaks memory in some cases (with Appearance?)
> 4309059 background geometry appears very close to the camera vs 1.1.3
> 4315058 VolRend display white cube when Axis Volumne is 3D
> 4331434 adding object to itself does not generate an exception
> 4332530 Win32 Stereo: zbuffer not cleared when rendering right eye
> 4333846 JavaPresents intermittently throws IndexOutOfBoundsException
> 4335205 WakeupOnCollision fail if arming Node is TransformGroup which
> undergo
>         transform
> 4335969 Memory leak when Branch/View/Canvas3D remove
> 4335549 ImageComponent2D not live when under Background Node
> 4336263 Automatic texture generation eye linear fail when switch back
>         from object linear
> 4337095 Collision detection did not work sometimes when modify interactively
> 4337665 Geometry by reference using interleaved & color with alpha may crash
>         system
> 4337832 removeNotify throws NullPointerException when parent is null
> 4337953 GeometryByReference with Interleaved array don't support
> multi-texture
> 4337966 GeometryArray initialVertexIndex is ignore in non-interleaved array
> 4338168 Behavior Scheduler should stop when all behaviors are disabled
> 4339211 fail to enable multitexture 1st time textureUnitState is set after
> sg
>         setLive
> 4339293 JVM Segmentation fault if depth Component not set in Raster
>         under v1.2.2-001
> 4340879 TUS fails to update transform change on some geometries added live
>         BranchGroup.
> 4340882 WakeupOnElapsedTime can't enable again after disable
> 4340979 Device Context not release in NativeConfigTemplate3D
> 4341212 isGraphicsConfigSupported() not yet implemented
> 4341229 Mixed mode rendering causes scene graph to render continuously
> 4341273 geometry not rendered properly when multiple texCoordSet is
> specified
> 4341689 SimpleGeometry example throws UnsatisfiedLinkError
> 4343019 changing transparency attribute doesn't work
> 4343160 J3d resources not freed up properly causing memory leak
> 4344890 WakeupOnCollisionMovement should not triggered when collision
>         object not move
> 4344920 Picking fails the second time for objects under share group
> 4345204 memory leak in when repeating create/destroy canvas3d
> 4346877 Tetxure By Reference and Raster by Reference does not work in
>         PureImmediate mode
> 4347496 Offscreen and ReadRaster requires a getImage() when using byRef
>         imagecomponent
> 4348626 Clip node application bound not updated when transform is changed
> 4348861 Geometry intersection fail to return collision in some orientation
> 4351033 NullPointer exception in MasterControl when running scene graph
>         viewer
> 4351100 Two copies of objects appear when branch detach and reattach to
>         scene graph
> 4352652 ModelClip fail to clip correctly in the first frame
> 4352667 Adding/removing canvas from view/panel makes geometry disappear
> 4353135 Display list initialize two times for Geometry
> 4354150 examples/PickTest/IntersectTest renders nothing
> 4354529 In a Universe with Multiple Locales transformGroup changes
>         are not rendered
> 4354578 DisplayList ID may invoke to draw geometry before it is created
> 4354666 SharedAlternateTargetTest throws NullPointer exception when detach
>         share group
> 4354751 transform ignored
> 4355101 ManySphere_Pure bad flickering
> 4355357 TexGen w/ EYE_LINEAR doesn't work properly with multitextures
> 4355441 Text3D disappeared
> 4355443 switch children may be incorrectly merged after compilation
> 4355908 depth write enable mask not reset correctly after rendering
>         transparent objects
> 4356240 repeatedly reloading an applet causes browser to hang
> 4357625 java3d fail to resume rendering after window deiconify
> 4357935 Memory leak when branchgroup remove
> 4357974 Mouse behavior no longer work after replaceBranchGraph
> 4358710 directional light unexpectedly moved with the scene in immediate
> 4359757 Applet reload will throws InternalError after 32 times
> 4360546 Stereo separation different between 1.2 and 1.2.1
> 4360588 Reepated add and removal of BranchGraphs to locale causes exception
> 4360823 NullPointerException in LightRetained.clearLive
> 4360849 NullPointerException when using moveTo()
> 4361889 isGraphicsConfigSupported() return incorrect result under windows
>         opengl version
> 4361988 MultiLocale test throws ArrayIndexOutOfBoundsException
> 4362044 DrawingSurfaceAWT Lock did not free, cause memory leak when canvas
>         reloaded
> 4362302 When a BranchGroup containing a texture is detached the
>         ImageComponent is Live
> 4362355 Picking fails once SceneGraph is compiled
> 4362374 ManySpheres_Pure intermittently crashes the JVM when run w/ dual cpu
> 4362773 Mutiple Locales do not behave properly in Java3D
> 4362907 compile() breaks examples/PickTest/IntersectTest program
> 4363084 ArrayIndexOutOfBoundsException in NormalGenerator
> 4363148 NullPointerException with sharedGroup under switch during setLive
> 4363269 Applet hangs sometimes when repeating reload
> 4363279 J3D crash under AFB/FFB after reload 32 times
> 4363875 Interpolator loopCount no longer works
> 4364572 D3D: Texture transform for translation or combine with TexCoordGen
>         did not work
> 4365111 texture not rendered correctly in immediate mode
> 4365133 RenderBin throws ClassCastException when OriS3D shared Appearance
>         with another S3D
> 4365139 OriS3D's orientedtransform didn't get applied when OS3D shared
>         appearance w/a S3
> 4365170 OrientedShape3D throws NullPointerException on text with spacing in
> it
> 4366359 Objects incorrectly rendered when adding/deleting from the
> scenegraph
> 4366775 RenderBin sometimes throws NullPointerException when object insert
> to
>         scenegraph
> 4366915 Shape missing when branchgraph attach/detach if there are multiple
>         LightBin
> 4367085 MultiScreens example program only renders on screen 0
> 4367212 MultiScreen test sometimes throws NullPointerException when startup
> 4367563 Incorrect reference of Canvas3D in Renderer
> 4367616 incorrect vwcBounds for LOD switch objects
> 4367891 D3D: crash when vertexbuffer is used in some test case
> 4367949 Off-screen rendering sometimes returns old image
> 4368116 D3D: sometime crash when GeometryByReference non-interleaved array
>         use
> 4368117 D3D: crash when DecalGroup is used
> 4315021 Robot test fail to pick object under windows
>
> Sound
> -----
> 4334767 examples/MoveAppBoundingLeaf sometimes produces no sound
> 4347519 BackgroundSound did not check for scheduling Bounds
> 4360447 Sound nodes shared by 2 universes throws exception
> 4360448 MediaContainer.setURLString() sets url field
> 4360451 Sound.setSoundData() with a new MediaContainer is ignored
> 4360454 MediaContainer.setURL() with new URL is ignored
> 4360461 Filtering only performed on non-cached MediaContainer
> 4360462 setMediaContainer(InputStream) not loaded on audio device
> 4368186 Reattaching sound node restarts previously enabled sound
>
> Utilities
> ---------
> 4309080 investigate whether TextureLoader should use drawImage vs
> PixelGrabber
> 4328532 Textures for the bottom of cones and cylinders are upside-down
> 4336095 Picking using GEOMETRY_INTERECT_INFO fail on fan and
>         strip geometry
> 4336628 Simple Universe returns incorrect viewingPlatform
> 4345865 Incorrect callback argument in MouseZoon/MouseRotate
> 4347996 PickCanvas setTolerance has no effect if it call after
>         setShapeLocation
> 4358065 GeometryInfo methods scope too restrictive
> 4363154 Sphere sharing cause problem in compile mode
> 4363208 Picking util. can miss the closet geometry, when multiple S3Ds are
>         intersected
> 4364128 Non-uniform scale not implemented in
>         RotPosScaleTCBSplinePathInterpolator
>
>
> ============
> NEW FEATURES
> ============
>
> All example program now have example.html and example_plugin.html for
> use with the plugin feature available with most web browsers.  In addition,
> an html page, demo/java3d/index.html now contains links to all demo programs
> that can be run as applets.
>
> =======================
> Constructing a Canvas3D
> =======================
>
> Many Java 3D programs pass null to the Canvas3D constructor.  By doing
> this, Java 3D will select a default GraphicsConfiguration that is
> appropriate for Java 3D.  However, this is a bad practice, and can lead
> to errors when applications try to run in alternate environments, such as
> stereo viewing.  Java 3D will now print out a warning if the Canvas3D
> constructor is passed in a null argument for the GraphicsConfiguration.
>
> =========
> Utilities
> =========
>
> This release includes utilities for Java 3D.  These utilities are still
> being defined and under development.  Much of the source for these utilities
> is also provided.  The API for these utilities may change in future
> releases.
>
> The following utilities are provided in this release:
>
>         - Java Sound Audio Device
>         - Some predefined Mouse based behaviors
>         - Picking utilities including predefined picking behaviors
>         - Geometry creation classes for Box, Cone, Cylinder, and Sphere
>         - A Text2D utility
>         - A Universe Builder - SimpleUniverse
>         - An Image Loading utility
>         - A Normal Generator utility
>         - A Polygon Triangulator utility
>         - Triangle stripifier
>         - Geometry compression utilities
>         - Spline-based path interpolators
>         - Wavefront .obj loader
>         - Lightwave 3D File Loader
>
> ===================================
> Enabling Stereo with SimpleUniverse
> ===================================
>
> The SimpleUniverse utility does not, by default, request a
> GraphicsConfiguration that is capable of Stereo rendering.  To enable this,
> you need to set a property when running your application.  Here is an
> example.
>
> java -Dj3d.stereo=PREFERRED MyProgram
>
> Some framebuffers only have one Z buffer and share this between the left
> and right eyes.  If you are experiencing problems using stereo try the
> following property:
>
> java -Dj3d.stereo=PREFERRED -Dj3d.sharedstereozbuffer=true MyProgram
>
>
> =====================================================
> Information on the Direct3D Implementation of Java 3D
> =====================================================
>
>   Unsupported Features
>   --------------------
>   The following features are currently unsupported in the Direct3D
>   implementation of Java 3D:
>     Line width
>     Line antialiasing
>     Point size
>     Point antialiasing
>     RenderingAttributes ROP_XOR
>     PolygonAttributes Back face normal flip
>     3D Texture
>     Texture color table
>
>   Limited Support
>   ---------------
>   FullScreen antialiasing is supported only if the device returns
>   D3DPRASTERCAPS_ANTIALIASSORTINDEPENDENT in its raster capabilities
>   list.  (OpenGL supports fullscreen antialiasing if an accumulation
>   buffer exists.)
>
>   TransparencyAttributes.TransparencyMode values FASTEST, NICEST and
>   SCREEN_DOOR are the same as BLENDED under D3D.
>
>   Texture coordinates outside the range [0,1] when boundaryModeS
>   and boundaryModeT are set to CLAMP will not use the Texture Boundary'
>   color unless BASE_LEVEL_LINEAR filtering is turned on.
>
>   Only negative polygon offsets are supported.  The limit of this offset
>   corresponds to the depth of the z-buffer.
>
>   The vertex count is limited to 65535 vertices per primitive.
>
>   Fullscreen Support
>   ------------------------
>   The Direct3D implementation of Java 3D can be run in fullscreen mode.
>   To start an application in fullscreen mode, use the property
> j3d.fullscreen.
>   The values for j3d.fullscreen are:
>     REQUIRED  -   A fullscreen canvas is required. If not available, do not
>                   start up the application.
>     PREFERRED -   A fullscreen canvas is desired for this invocation of the
>                   Java 3D application.  If a fullscreen canvas cannot be
>                   created, a windowed canvas is acceptable.
>     UNNECESSARY - States that a fullscreen canvas is not necessary for this
>                   application.  Create a windowed application (this is the
>                   same behavior as not setting this property).
>
>   Example:
>     java -Dj3d.fullscreen=REQUIRED HelloUniverse
>
>   Further, an application can be toggled between fullscreen and windowed
> mode
>   by use of the <Alt><Enter> keyboard combination.
>
>   Stereo Support
>   --------------
>   Java 3D can render in stereo mode on graphics cards that support stereo
>   through Direct3D.  To enable stereo for a Java 3D application, use
>   the Java 3D property: j3d.stereo.
>
>   For example:
>     java -Dj3d.stereo=REQUIRED
>   The valid values for the j3d.stereo property are the same as those for the
>   j3d.fullscreen property given above.
>
>   Some framebuffers only have one Z buffer and share this between the left
>   and right eyes.  If you are experiencing problems using stereo try the
>   following property:
>
>   java -Dj3d.stereo=PREFERRED -Dj3d.sharedstereozbuffer=true MyProgram
>
>   NOTE: Direct3D only supports stereo mode for a fullscreen canvas.
>
>
>   Direct3D Device Selection
>   -------------------------
>   In order to aid in development and debugging, Java 3D has added a property
>   to allow the D3DDevice to use for rendering to be selected.  The property,
>   j3d.d3ddevice can have the following values:
>     tnlhardware - select a device that supports transform and lighting in
>                   hardware, if present.  If no such device is present,
>                   a dialog box is displayed to alert the user and the
>                   application will exit.
>     hardware    - select a Direct3D device that performs hardware
>                   rasterization, if present.  If no such device is present,
>                   a dialog box is displayed to alert the user and the
>                   application will exit.
>     emulation   - use Direct3D software emulation.
>     reference   - use the Direct3D reference pipeline (only available if
>                   the Direct3D SDK is installed).
>
>   By default Java 3D first tries to select a TnLhardaware device, if that
> fails
>   a Hardware device, if that also fails then finally Java 3D selects an
>   Emulation device.
>
>   Vertex Buffer optimization
>   ---------------------------
>
>   By default, DirectX vertex buffer features are used to increase
>   performance whenever the OpenGL display list feature would be
>   used.  If there is a problem with your driver's implementation
>   of vertex buffers, turn off this optimization:
>
>   -Dj3d.vertexbuffer=false
>
>   Ignored Java 3D Properties
>   --------------------------
>   The following Java 3D properties are ignored by the Direct3D
> implementation:
>     j3d.sharedctx
>     j3d.g2ddrawpixel
>
> ==============
> KNOWN PROBLEMS
> ==============
>
> Documentation Bugs
> ------------------
> 4161432 Transform3D transform definitions are imprecise with respect to
>         mirror transform
> 4181456 make Sensor.setSensorReadCount MT-safe
> 4259353 documentation for com.sun.j3d.utils.geometry.Box is confusing
> 4284971 Specify that wakeup criteria should not be shared
> 4284976 Specify that getProjection is illegal in non-compatibility mode
> 4297142 RotationPathInterpolator has problem if angle equal Math.PI
> 4303052 Quaternion documentation is inadequate
> 4303053 javadoc for DistanceLOD with multiple switch nodes needs improvement
> 4303054 Lighting equations should be updated to reflect color override
> 4303055 Docs should specify effect on clipped portion of ImageComponent
> 4303056 Docs should specify thread-safety behavior of Java 3D methodsc
> 4303062 Need to specify which attributes are passed by reference versus by
>         value
> 4307547 Need to doc. : scene graph needs to have at least a Canvas3D to keep
>         j3d working
> 4310958 Docs should specify wrong bounds may be used in region of influence
>         operations
> 4312421 Need to document texture by reference
> 4316844 Documentation of Java 3D colors should specify gamma assumptions
> 4348286 Shape3D intersect() should mention Geometry.ALLOW_INTERSECT need
>         to be set
> 4364767 Java3D's render loop doesn't run continuously
> 4366468 Background Geometry missing documentation
>
>
> Examples
> --------
> 4296091 Infinite loop in McadPickTestImm postSwap()
> 4312044 java Viewer reflects only Lightwave objects with depth
>
> Core Graphics & Vecmath
> -----------------------
> 4154445 PathInterpolator's setKnot method does not validate inputs
> 4160172 Access to some aggregate data is not MT-safe
> 4179923 ReadRaster does not clip to screen correctly
> 4181340 Updating the view cache could be a problem if other canvas running
>         on same view
> 4181344 Java 3D cannot handle more than 64 lights
> 4181349 Need to add Transform to SceneGrphPath hashCode
> 4181417 Need to add an internal epsilonEquals method for bounds objects
> 4186182 sceneAntialiasing setting of PREFERRED is ignored
> 4189092 HEAD_PREDICTOR and HAND_PREDICTOR policies not implemented
> 4191172 Text3D rendering problems
> 4193466 GMatrix SVD does not work correctly for some cases
> 4246325 AWT Event once enable, will not disable when behavior remove
> 4259345 Text3D does not correctly convert geometry of Japanese-text
> 4260818 java3d should support stereo graphics automatically
> 4269784 vecmath.GMatrix.LUD inefficient
> 4269923 LOD's slow
> 4299480 readRaster() and waitForOffScreenRendering() will not work if
>         threadLimit=1
> 4305676 Native method error messages not I18N ready
> 4308591 Text3D objects bounding box not accurate enough
> 4309925 JCK: BoundingPolytope / BoundingSphere does not return empty bound
>         as it should
> 4313678 Java3D disables invalid lights
> 4325851 Hardware MultiTexture not supported even though numActiveTexture
>         <= supported num
> 4331646 rendering differences between WIN32 and Solaris platforms
> 4331677 setWindowResizePolicy(View.VIRTUAL_WORLD) doesn't work
> 4335245 Raster type RASTER_COLOR_DEPTH did not work as expected
> 4340598 Morph did not work after setGeometryArrays() in behavior
> 4340607 Node and NodeComponent's set* methods not synchronized with
>         set/clearLive
> 4342430 Raster write do not clip image if raster offset/size defined
>         outside boundary
> 4342945 non-congruent transform exceptions: error correct or doc?
> 4343287 Blending not enabled for antialiased lines
> 4346786 OutOfMemory error when generating 20,000 Box primitives
> 4348562 GMatrix SVD method incorrect output and throws
>         ArrayIndexOutOfBoundsException
> 4348609 Poor rendering of textures on NT with 16 bit color
> 4350033 possible conflict between implementation and spec on
>         PolygonOffset
> 4351050 APIs issue : Shape3D and Morph's intersect method.
> 4351579 APIs issue : Shape3D intersect method -- multiple geometry support
> 4352922 JFTC: light InfluencingBounds (BoundingSphere) seems to be broken
>         on 1.2.1
> 4355041 JFTC: LOD failed to change level of detail after 1st frame
> graphics_si
> 4355332 Require Thread safe removeChild in BranchGroup
> 4357843 Picking doesn't handle OrientedShape3D's orientation when doing
>         intersect test
> 4358284 readRaster() ignore StereoMode context
> 4358700 Geometry intermitantly disappears from scene
> 4359600 Transform3D returning NaNi
> 4359609 MediaContainer does not report errors
> 4359764 Java3D does not support > 32 canvas
> 4360688 Geometric primitives need to be optimized
> 4361036 texture mapped quad using geometry by reference doesn't work
> 4363761 getImagePlateToVworld not synchronized with View
> 4363884 Alpha that is no longer running still takes up CPU time
> 4363899 APIs issue : OrientedShape3D's intersect method needs view info
> 4363990 Texture image and TransformGroup  not update synchronously
> 4364343 shared objects no longer pickable after re-attaching to scene graph
> 4364493 Mirror transforms are not always classified correctly
> 4365165 JVM crashed when similar text is used on both OrientedShape3D
>         and Shape3D
> 4365207 OriS3D's vwcBound computation needs to consider OriS3D's
>         orientedtransform
> 4366060 ObjectFile.load() throws IndexOutOfBoundsException
> 4366473 Background geometry does not animate
> 4366494 RenderBin throws exception, possibly related to OrderedGroup under
>         Background
> 4366511 Full screen antialiasing slow under OpenGL
> 4366528 Text2D rendered out-of-order in OrderedGroup
> 4368120 D3D: Color attributes change not working if vertex buffer is used
> 4368396 Geometry flashes
>
> Sound
> -----
> 4138605 using any non-javasound java sound causes severe performance hit
> 4164181 Sound performance on native threads is bad
> 4187092 Filtering causes loud, sweeping resonance to be added to most sounds
> 4187093 Cross-talk cancellation for sound playback in not implemented
> 4315018 Garbage sound in TestFilter
> 4348236 No background sound sometimes when startup
> 4348247 stopView() fail to stop background sound
> 4360456 PointSound.setPosition() not update unless parent transform modified
> 4360463 Doppler calculated results in less than expected frequency variation
> 4367333 programs/other/SoundExamples/ImmediateMode doesn't work correctly
>
> Utility Bugs
> ------------
> 4158783 lw3d loader loses textures after pressing the reload button on
>         Netscape
> 4173647 Cannot share Sphere objects of same size between immediate and
>         retained mode
> 4217567 NormalsGenerator only checks the cosine for smoothing
> 4252349 First viewport may jump when using KeyNavigatorBehavior
> 4259533 getTexture() throws NullPointerException when using proxies
> 4308592 texture loader does not scale non-power-of-2 RGBA textures properly
> 4331669 setRectangleScaleFactor will not change text size unless setString
>         called
> 4336679 In examples/PickTest program, a pick miss can happen on morph object
> 4343427 Loader interface has no facility to monitor progress of Load
> Operation
> 4347998 PickTool pickGeomAllSorted did not compute closest distance for
>         PickConeRay
> 4367699 Lightwave Loader throws NullPointerException when loading data from
>         a Stream
>
>
> Direct3D specific Bugs
> ----------------------
>   Bugs in the NVidia GForce
>   --------------------------
>   Make sure you have the latest driver, called "Detonator 3":
>     http://www.nvidia.com/products.nsf/htmlmedia/detonator3.html
>
>   Line patterns do not work.  A solid line is shown.
>   To workaround, use -Dj3d.d3dDevice=Emulation / Reference
>
>   Texture Border color mode does not work.
>   To workaround, use -Dj3d.d3dDevice=Emulation / Reference
>
>   The TextureMode "CLAMP" does not work.
>
>
>
>
> ----------------------------------------------------------------------------
> ----
>
>
> Java 3D(TM) 1.2.1 Beta
>
> README file for Win32/OpenGL
>
> This file contains important information for users of Java 3D(TM).
> The first four sections (Requirements, Installation, Shared
> Contexts, and Running Java 3D(TM) in a Browser) are of interest
> to all Java 3D(TM) users.  The rest of this file applies only to
> developers of Java 3D(TM) applications.
>
> ** It is recommended that any previous version of Java 3D(TM) be
> ** uninstalled before installing this version.
>
> ============
> REQUIREMENTS
> ============
>
> This version of Java 3D(TM) for WindowsNT 4.0,
> Windows 98, and Windows 2000 requires the following:
>
>         Java 2 (Runtime or SDK) version 1.2.2 or later from Sun
>         Microsystems (http://java.sun.com/jdk/).  This includes
>         the Java Plug-In (JPI) to update Java(TM) in your browser.
>
>         OpenGL 1.1 or later, available from Microsoft or from
>         your graphics card manufacturer (see below).
>
>         NT 4.0 only: Service Pack 3 or later.
>
> ============
> INSTALLATION
> ============
>
> You must have permission to write files in your Java(TM) Runtime
> Environment and/or SDK directories.  If you do not have this
> permission, the installer will run to completion but Java 3D(TM)
> will not be installed.  Make sure you are running Java(TM) from
> your local machine and that you are the same user who installed
> Java.
>
> To install Java 3D(TM), execute the Java 3D(TM) GUI Installer
> program from any directory:
>
>    Runtime only:      java3d1_2_1beta1-win32-opengl-rt-ia.bin
>    Runtime and SDK:   java3d1_2_1beta1-win32-opengl-sdk-ia.bin
>
> The installers upgrade your most recently installed Java Runtime
> Environment and SDK.
>
> After installation, you may remove the executable GUI installer.
>
> The Java 3D(TM) SDK includes several demo programs that can
> verify correct installation.  Assuming your Java 2 SDK is installed
> at \jdk1.3, try the following:
>
>         cd \jdk1.3\demo\java3d\HelloUniverse
>         java HelloUniverse
>
>         Note: Many more demos are available under the demo\java3d\
>               directory.  Some of the demos require a maximum memory
>               pool larger than the default in java.  To increase the
>               maximum memory pool to 64 meg, add the following command
>               line options to java or appletviewer:
>                   java: -mx64m
>                   appletviewer: -J-mx64m
>
> If, after installation, you get the following error message while
> running a Java 3D program:
>
>   java.lang.UnsatisfiedLinkError: no J3D in shared library path
>
> it is most likely because OpenGL and/or the OpenGL GLU utilities are
> not installed on the machine.
>
> For information on OpenGL and how to get it, see the OpenGL web page at
> http://www.opengl.org/
>
> Java 3D(TM) consists of four jar files and two shared libraries.
> You do not need to include the jar files in your CLASSPATH,
> nor do you need to include the shared libraries in your PATH.
> You should include "." in your CLASSPATH or ensure that CLASSPATH
> is not set.
>
> Java 3D documentation and tutorials are available from the Java 3D(TM)
> Home Page: http://java.sun.com/products/java-media/3D/
>
> ===============
> SHARED CONTEXTS
> ===============
>
> This version of Java 3D is able to use shared contexts in OpenGL for Display
> Lists and Texture Objects.  For single canvas applications, there will be no
> change in behavior.  For multiple canvas applications, memory requirements
> will decrease by using this property.  To enable the use of shared contexts
> set the j3d.sharedctx property to true, for example:
>
>     java -Dj3d.sharedctx=true MyProgram
>
>
> Some video cards, such as the Riva TNT & TNT2, have problems using shared
> contexts.  If you are experiencing no rendering, crashes, or no textures
> being displayed when shared contexts are enabled, this is the most likely
> problem.
>
> ================================
> RUNNING JAVA 3D(TM) IN A BROWSER
> ================================
>
> You can run Java 3D(TM) programs in your browser.  Java 2(TM)
> from Sun includes the Java Plug-In (JPI) to upgrade the Java(TM)
> in the browser to Java 2(TM).  To verify proper installation,
> point your browser to file:/jdk1.3/demo/java3d/index.html
>
> NOTE: Many Java 3D(TM) programs will require a larger heap size
> than the default 16M in the JPI.  Run the Java Plug-In Control
> Panel from Start/Programs (JPI 1.2.2) or Start/Settings/Control
> Panel (JPI 1.3) and in "Java Run Time Parameters" put "mx64m"
> for 64M of heap memory.
>
> To create a web page with Java 3D, you need to use special HTML
> code to force the browser to use the JPI VM.  Refer to the
> following URL for information on using Java Plug-In "HTML
> Converter" and running applets using Java Plug-in:
>
>         http://java.sun.com/products/plugin/
>
> ====================================================
> DISTRIBUTING Java 3D(TM) WITH YOUR JAVA(TM) PROGRAMS
> ====================================================
>
> Sun Microsystems allows vendors to distribute the Java 3D(TM) Runtime
> environment with their Java programs, provided they follow the terms
> of the Java 3D(TM) Evaluation License agreement.
>
> This document uses the term "vendors" to refer to licensees,
> developers, and independent software vendors (ISVs) who license and
> distribute Java 3D(TM) with their Java programs.
>
> REQUIRED vs. OPTIONAL FILES
> ---------------------------
> Vendors must follow the terms of the Java 3D(TM) Evaluation License
> agreement, which includes these terms:
>
>  - Don't arbitrarily subset Java 3D(TM). You may, however, omit those
>    files that have been designated below as "optional".
>
>  - Include in your product's license the provisions called out
>    in the Java 3D(TM) Evaluation License.
>
> BUNDLING Java 3D(TM)
> --------------------
> Java 3D(TM) comes with its own installer that makes it suitable for
> downloading by end users. Java(TM) application developers have the
> option of not bundling Java 3D(TM) with their software.  Instead,
> they can direct end-users to download and install the Java 3D(TM)
> software themselves.
>
> Required Files
> --------------
>
>         <JREDIR>\bin\J3D.dll
>         <JREDIR>\bin\j3daudio.dll
>         <JREDIR>\lib\ext\vecmath.jar
>         <JREDIR>\lib\ext\j3dcore.jar
>         <JREDIR>\lib\ext\j3daudio.jar
>         <JREDIR>\lib\ext\j3dutils.jar
>
> Optional Files
> --------------
>
> An application developer may include these files and directories
> with their Java 3D(TM) application, but is not required to do so:
>
>         <JDKDIR>\j3d-utils-src.jar
>         <JDKDIR>\demo\java3d
>
>
> ========================
> CHANGES SINCE 1.2
> ========================
>
> ==========
> BUGS FIXED
> ==========
>
> Documentation
> -------------
> 4199091 Raster object uses the alpha value inside the image to perform
>         blend operation
> 4354497 Locale pickAll() param description incorrect
>
> Example Programs
> 4212805 ReadRaster test program has race condition
> 4367277 OffScreenTest example program does not work consistently
>
> Graphics
> --------
> 4186219 Geometry Collision does not implement points/surface, line/line, or
>         line/point
> 4250253 GeometryInfo leaks memory in some cases (with Appearance?)
> 4309059 background geometry appears very close to the camera vs 1.1.3
> 4315058 VolRend display white cube when Axis Volumne is 3D
> 4331434 adding object to itself does not generate an exception
> 4332530 Win32 Stereo: zbuffer not cleared when rendering right eye
> 4333846 JavaPresents intermittently throws IndexOutOfBoundsException
> 4335205 WakeupOnCollision fail if arming Node is TransformGroup which
> undergo
>         transform
> 4335969 Memory leak when Branch/View/Canvas3D remove
> 4335549 ImageComponent2D not live when under Background Node
> 4336263 Automatic texture generation eye linear fail when switch back
>         from object linear
> 4337095 Collision detection did not work sometimes when modify interactively
> 4337665 Geometry by reference using interleaved & color with alpha may crash
>         system
> 4337832 removeNotify throws NullPointerException when parent is null
> 4337953 GeometryByReference with Interleaved array don't support
> multi-texture
> 4337966 GeometryArray initialVertexIndex is ignore in non-interleaved array
> 4338168 Behavior Scheduler should stop when all behaviors are disabled
> 4339211 fail to enable multitexture 1st time textureUnitState is set after
> sg
>         setLive
> 4339293 JVM Segmentation fault if depth Component not set in Raster
>         under v1.2.2-001
> 4340879 TUS fails to update transform change on some geometries added live
>         BranchGroup.
> 4340882 WakeupOnElapsedTime can't enable again after disable
> 4340979 Device Context not release in NativeConfigTemplate3D
> 4341212 isGraphicsConfigSupported() not yet implemented
> 4341229 Mixed mode rendering causes scene graph to render continuously
> 4341273 geometry not rendered properly when multiple texCoordSet is
> specified
> 4341689 SimpleGeometry example throws UnsatisfiedLinkError
> 4343019 changing transparency attribute doesn't work
> 4343160 J3d resources not freed up properly causing memory leak
> 4344890 WakeupOnCollisionMovement should not triggered when collision
>         object not move
> 4344920 Picking fails the second time for objects under share group
> 4345204 memory leak in when repeating create/destroy canvas3d
> 4346877 Tetxure By Reference and Raster by Reference does not work in
>         PureImmediate mode
> 4347496 Offscreen and ReadRaster requires a getImage() when using byRef
>         imagecomponent
> 4348626 Clip node application bound not updated when transform is changed
> 4348861 Geometry intersection fail to return collision in some orientation
> 4351033 NullPointer exception in MasterControl when running scene graph
>         viewer
> 4351100 Two copies of objects appear when branch detach and reattach to
>         scene graph
> 4352652 ModelClip fail to clip correctly in the first frame
> 4352667 Adding/removing canvas from view/panel makes geometry disappear
> 4353135 Display list initialize two times for Geometry
> 4354150 examples/PickTest/IntersectTest renders nothing
> 4354529 In a Universe with Multiple Locales transformGroup changes
>         are not rendered
> 4354578 DisplayList ID may invoke to draw geometry before it is created
> 4354666 SharedAlternateTargetTest throws NullPointer exception when detach
>         share group
> 4354751 transform ignored
> 4355101 ManySphere_Pure bad flickering
> 4355357 TexGen w/ EYE_LINEAR doesn't work properly with multitextures
> 4355441 Text3D disappeared
> 4355443 switch children may be incorrectly merged after compilation
> 4355908 depth write enable mask not reset correctly after rendering
>         transparent objects
> 4356240 repeatedly reloading an applet causes browser to hang
> 4357625 java3d fail to resume rendering after window deiconify
> 4357935 Memory leak when branchgroup remove
> 4357974 Mouse behavior no longer work after replaceBranchGraph
> 4358710 directional light unexpectedly moved with the scene in immediate
> 4359757 Applet reload will throws InternalError after 32 times
> 4360546 Stereo separation different between 1.2 and 1.2.1
> 4360588 Reepated add and removal of BranchGraphs to locale causes exception
> 4360823 NullPointerException in LightRetained.clearLive
> 4360849 NullPointerException when using moveTo()
> 4361889 isGraphicsConfigSupported() return incorrect result under windows
>         opengl version
> 4361988 MultiLocale test throws ArrayIndexOutOfBoundsException
> 4362044 DrawingSurfaceAWT Lock did not free, cause memory leak when canvas
>         reloaded
> 4362302 When a BranchGroup containing a texture is detached the
>         ImageComponent is Live
> 4362355 Picking fails once SceneGraph is compiled
> 4362374 ManySpheres_Pure intermittently crashes the JVM when run w/ dual cpu
> 4362773 Mutiple Locales do not behave properly in Java3D
> 4362907 compile() breaks examples/PickTest/IntersectTest program
> 4363084 ArrayIndexOutOfBoundsException in NormalGenerator
> 4363148 NullPointerException with sharedGroup under switch during setLive
> 4363269 Applet hangs sometimes when repeating reload
> 4363279 J3D crash under AFB/FFB after reload 32 times
> 4363875 Interpolator loopCount no longer works
> 4364572 D3D: Texture transform for translation or combine with TexCoordGen
>         did not work
> 4365111 texture not rendered correctly in immediate mode
> 4365133 RenderBin throws ClassCastException when OriS3D shared Appearance
>         with another S3D
> 4365139 OriS3D's orientedtransform didn't get applied when OS3D shared
>         appearance w/a S3
> 4365170 OrientedShape3D throws NullPointerException on text with spacing in
> it
> 4366359 Objects incorrectly rendered when adding/deleting from the
> scenegraph
> 4366775 RenderBin sometimes throws NullPointerException when object insert
> to
>         scenegraph
> 4366915 Shape missing when branchgraph attach/detach if there are multiple
>         LightBin
> 4367085 MultiScreens example program only renders on screen 0
> 4367212 MultiScreen test sometimes throws NullPointerException when startup
> 4367563 Incorrect reference of Canvas3D in Renderer
> 4367616 incorrect vwcBounds for LOD switch objects
> 4367891 D3D: crash when vertexbuffer is used in some test case
> 4367949 Off-screen rendering sometimes returns old image
> 4368116 D3D: sometime crash when GeometryByReference non-interleaved array
>         use
> 4368117 D3D: crash when DecalGroup is used
> 4315021 Robot test fail to pick object under windows
>
> Sound
> -----
> 4334767 examples/MoveAppBoundingLeaf sometimes produces no sound
> 4347519 BackgroundSound did not check for scheduling Bounds
> 4360447 Sound nodes shared by 2 universes throws exception
> 4360448 MediaContainer.setURLString() sets url field
> 4360451 Sound.setSoundData() with a new MediaContainer is ignored
> 4360454 MediaContainer.setURL() with new URL is ignored
> 4360461 Filtering only performed on non-cached MediaContainer
> 4360462 setMediaContainer(InputStream) not loaded on audio device
> 4368186 Reattaching sound node restarts previously enabled sound
>
> Utilities
> ---------
> 4309080 investigate whether TextureLoader should use drawImage vs
> PixelGrabber
> 4328532 Textures for the bottom of cones and cylinders are upside-down
> 4336095 Picking using GEOMETRY_INTERECT_INFO fail on fan and
>         strip geometry
> 4336628 Simple Universe returns incorrect viewingPlatform
> 4345865 Incorrect callback argument in MouseZoon/MouseRotate
> 4347996 PickCanvas setTolerance has no effect if it call after
>         setShapeLocation
> 4358065 GeometryInfo methods scope too restrictive
> 4363154 Sphere sharing cause problem in compile mode
> 4363208 Picking util. can miss the closet geometry, when multiple S3Ds are
>         intersected
> 4364128 Non-uniform scale not implemented in
>         RotPosScaleTCBSplinePathInterpolator
>
>
> ============
> NEW FEATURES
> ============
>
> All example program now have example.html and example_plugin.html for
> use with the plugin feature available with most web browsers.  In addition,
> an html page, demo/java3d/index.html now contains links to all demo programs
> that can be run as applets.
>
> =======================
> Constructing a Canvas3D
> =======================
>
> Many Java 3D programs pass null to the Canvas3D constructor.  By doing
> this, Java 3D will select a default GraphicsConfiguration that is
> appropriate for Java 3D.  However, this is a bad practice, and can lead
> to errors when applications try to run in alternate environments, such as
> stereo viewing.  Java 3D will now print out a warning if the Canvas3D
> constructor is passed in a null argument for the GraphicsConfiguration.
>
> =========
> Utilities
> =========
>
> This release includes utilities for Java 3D.  These utilities are still
> being defined and under development.  Much of the source for these utilities
> is also provided.  The API for these utilities may change in future
> releases.
>
> The following utilities are provided in this release:
>
>         - Java Sound Audio Device
>         - Some predefined Mouse based behaviors
>         - Picking utilities including predefined picking behaviors
>         - Geometry creation classes for Box, Cone, Cylinder, and Sphere
>         - A Text2D utility
>         - A Universe Builder - SimpleUniverse
>         - An Image Loading utility
>         - A Normal Generator utility
>         - A Polygon Triangulator utility
>         - Triangle stripifier
>         - Geometry compression utilities
>         - Spline-based path interpolators
>         - Wavefront .obj loader
>         - Lightwave 3D File Loader
>
> ===================================
> Enabling Stereo with SimpleUniverse
> ===================================
>
> The SimpleUniverse utility does not, by default, request a
> GraphicsConfiguration that is capable of Stereo rendering.  To enable this,
> you need to set a property when running your application.  Here is an
> example.
>
> java -Dj3d.stereo=PREFERRED MyProgram
>
> Some framebuffers only have one Z buffer and share this between the left
> and right eyes.  If you are experiencing problems using stereo try the
> following property:
>
> java -Dj3d.stereo=PREFERRED -Dj3d.sharedstereozbuffer=true MyProgram
>
>
> ==============
> KNOWN PROBLEMS
> ==============
>
> Documentation Bugs
> ------------------
> 4161432 Transform3D transform definitions are imprecise with respect to
>         mirror transform
> 4181456 make Sensor.setSensorReadCount MT-safe
> 4259353 documentation for com.sun.j3d.utils.geometry.Box is confusing
> 4284971 Specify that wakeup criteria should not be shared
> 4284976 Specify that getProjection is illegal in non-compatibility mode
> 4297142 RotationPathInterpolator has problem if angle equal Math.PI
> 4303052 Quaternion documentation is inadequate
> 4303053 javadoc for DistanceLOD with multiple switch nodes needs improvement
> 4303054 Lighting equations should be updated to reflect color override
> 4303055 Docs should specify effect on clipped portion of ImageComponent
> 4303056 Docs should specify thread-safety behavior of Java 3D methodsc
> 4303062 Need to specify which attributes are passed by reference versus by
>         value
> 4307547 Need to doc. : scene graph needs to have at least a Canvas3D to keep
>         j3d working
> 4310958 Docs should specify wrong bounds may be used in region of influence
>         operations
> 4312421 Need to document texture by reference
> 4316844 Documentation of Java 3D colors should specify gamma assumptions
> 4348286 Shape3D intersect() should mention Geometry.ALLOW_INTERSECT need
>         to be set
> 4364767 Java3D's render loop doesn't run continuously
> 4366468 Background Geometry missing documentation
>
>
> Examples
> --------
> 4296091 Infinite loop in McadPickTestImm postSwap()
> 4312044 java Viewer reflects only Lightwave objects with depth
>
> Core Graphics & Vecmath
> -----------------------
> 4154445 PathInterpolator's setKnot method does not validate inputs
> 4160172 Access to some aggregate data is not MT-safe
> 4179923 ReadRaster does not clip to screen correctly
> 4181340 Updating the view cache could be a problem if other canvas running
>         on same view
> 4181344 Java 3D cannot handle more than 64 lights
> 4181349 Need to add Transform to SceneGrphPath hashCode
> 4181417 Need to add an internal epsilonEquals method for bounds objects
> 4186182 sceneAntialiasing setting of PREFERRED is ignored
> 4189092 HEAD_PREDICTOR and HAND_PREDICTOR policies not implemented
> 4191172 Text3D rendering problems
> 4193466 GMatrix SVD does not work correctly for some cases
> 4246325 AWT Event once enable, will not disable when behavior remove
> 4259345 Text3D does not correctly convert geometry of Japanese-text
> 4260818 java3d should support stereo graphics automatically
> 4269784 vecmath.GMatrix.LUD inefficient
> 4269923 LOD's slow
> 4299480 readRaster() and waitForOffScreenRendering() will not work if
>         threadLimit=1
> 4305676 Native method error messages not I18N ready
> 4308591 Text3D objects bounding box not accurate enough
> 4309925 JCK: BoundingPolytope / BoundingSphere does not return empty bound
>         as it should
> 4313678 Java3D disables invalid lights
> 4325851 Hardware MultiTexture not supported even though numActiveTexture
>         <= supported num
> 4331646 rendering differences between WIN32 and Solaris platforms
> 4331677 setWindowResizePolicy(View.VIRTUAL_WORLD) doesn't work
> 4335245 Raster type RASTER_COLOR_DEPTH did not work as expected
> 4340598 Morph did not work after setGeometryArrays() in behavior
> 4340607 Node and NodeComponent's set* methods not synchronized with
>         set/clearLive
> 4342430 Raster write do not clip image if raster offset/size defined
>         outside boundary
> 4342945 non-congruent transform exceptions: error correct or doc?
> 4343287 Blending not enabled for antialiased lines
> 4346786 OutOfMemory error when generating 20,000 Box primitives
> 4348562 GMatrix SVD method incorrect output and throws
>         ArrayIndexOutOfBoundsException
> 4348609 Poor rendering of textures on NT with 16 bit color
> 4350033 possible conflict between implementation and spec on
>         PolygonOffset
> 4351050 APIs issue : Shape3D and Morph's intersect method.
> 4351579 APIs issue : Shape3D intersect method -- multiple geometry support
> 4352922 JFTC: light InfluencingBounds (BoundingSphere) seems to be broken
>         on 1.2.1
> 4355041 JFTC: LOD failed to change level of detail after 1st frame
> graphics_si
> 4355332 Require Thread safe removeChild in BranchGroup
> 4357843 Picking doesn't handle OrientedShape3D's orientation when doing
>         intersect test
> 4358284 readRaster() ignore StereoMode context
> 4358700 Geometry intermitantly disappears from scene
> 4359600 Transform3D returning NaNi
> 4359609 MediaContainer does not report errors
> 4359764 Java3D does not support > 32 canvas
> 4360688 Geometric primitives need to be optimized
> 4361036 texture mapped quad using geometry by reference doesn't work
> 4363761 getImagePlateToVworld not synchronized with View
> 4363884 Alpha that is no longer running still takes up CPU time
> 4363899 APIs issue : OrientedShape3D's intersect method needs view info
> 4363990 Texture image and TransformGroup  not update synchronously
> 4364343 shared objects no longer pickable after re-attaching to scene graph
> 4364493 Mirror transforms are not always classified correctly
> 4365165 JVM crashed when similar text is used on both OrientedShape3D
>         and Shape3D
> 4365207 OriS3D's vwcBound computation needs to consider OriS3D's
>         orientedtransform
> 4366060 ObjectFile.load() throws IndexOutOfBoundsException
> 4366473 Background geometry does not animate
> 4366494 RenderBin throws exception, possibly related to OrderedGroup under
>         Background
> 4366511 Full screen antialiasing slow under OpenGL
> 4366528 Text2D rendered out-of-order in OrderedGroup
> 4368120 D3D: Color attributes change not working if vertex buffer is used
> 4368396 Geometry flashes
>
> Sound
> -----
> 4138605 using any non-javasound java sound causes severe performance hit
> 4164181 Sound performance on native threads is bad
> 4187092 Filtering causes loud, sweeping resonance to be added to most sounds
> 4187093 Cross-talk cancellation for sound playback in not implemented
> 4315018 Garbage sound in TestFilter
> 4348236 No background sound sometimes when startup
> 4348247 stopView() fail to stop background sound
> 4360456 PointSound.setPosition() not update unless parent transform modified
> 4360463 Doppler calculated results in less than expected frequency variation
> 4367333 programs/other/SoundExamples/ImmediateMode doesn't work correctly
>
> Utility Bugs
> ------------
> 4158783 lw3d loader loses textures after pressing the reload button on
>         Netscape
> 4173647 Cannot share Sphere objects of same size between immediate and
>         retained mode
> 4217567 NormalsGenerator only checks the cosine for smoothing
> 4252349 First viewport may jump when using KeyNavigatorBehavior
> 4259533 getTexture() throws NullPointerException when using proxies
> 4308592 texture loader does not scale non-power-of-2 RGBA textures properly
> 4331669 setRectangleScaleFactor will not change text size unless setString
>         called
> 4336679 In examples/PickTest program, a pick miss can happen on morph object
> 4343427 Loader interface has no facility to monitor progress of Load
> Operation
> 4347998 PickTool pickGeomAllSorted did not compute closest distance for
>         PickConeRay
> 4367699 Lightwave Loader throws NullPointerException when loading data from
>         a Stream
>
>
> Windows/OGL-specific Bugs
> ---------------------
> On Windows 2000 in 32-bit color mode with the new NVidia
> "Detonator 3" driver, nothing is rendered and this error
> will show up:
>
>   wg1CreateContextFailed: The operation completed successfully.
>   extentionStr == null
>
> To work around the problem, switch to 16-bit color mode.
>
> 4296733 Canvas fail to resize under window for some configs
> 4332528 debug statement left in Win32 NativeConfigTemplate3D.c
> 4332530 Win32 Stereo: zbuffer not cleared when rendering right eye
>
> ===========================================================================
> To unsubscribe, send email to [EMAIL PROTECTED] and include in the body
> of the message "signoff JAVA3D-INTEREST".  For general help, send email to
> [EMAIL PROTECTED] and include in the body of the message "help".

===========================================================================
To unsubscribe, send email to [EMAIL PROTECTED] and include in the body
of the message "signoff JAVA3D-INTEREST".  For general help, send email to
[EMAIL PROTECTED] and include in the body of the message "help".

Reply via email to