>
> Rob,
>
> Will the upcoming beta release target Direct3D as well ?
Yes, beginning with 1.2.1, the D3D release will be in sync
with the OpenGL release.
Rob
>
> Thanks,
>
> Isie Masri
>
> Xtivia Technologies
>
> At 11:47 AM 9/27/2000 -0700, Rob Posadas wrote:
> >Content-Type: TEXT/plain; charset=ISO-8859-1
> >Content-MD5: rAG3w4U16Dt9cTttaTCh6g==
> >
> >
> >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".
> >Content-Type: TEXT/plain; name="README.java3d.solaris.txt";
> >charset=us-ascii; x-unix-mode=0644
> >Content-Description: README.java3d.solaris.txt
> >Content-MD5: nufY2B6eqpwj3SJrXDXg8g==
> >
> >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
> >
> >Content-Type: TEXT/plain; name="README.java3d.win32d3d.txt";
> >charset=us-ascii; x-unix-mode=0644
> >Content-Description: README.java3d.win32d3d.txt
> >Content-MD5: Y2csDQ0UBhp0IucCILp/Gg==
> >
> >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.
> >
> >Content-Type: TEXT/plain; name="README.java3d.win32ogl.txt";
> >charset=us-ascii; x-unix-mode=0644
> >Content-Description: README.java3d.win32ogl.txt
> >Content-MD5: Qd/CamlTCZmpd/ys+oRzIQ==
> >
> >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".
