>
> I just d\'loaded and checked out the beta1 of the DirectX-Java3D!
> My first and most serious problem you may see below!
Be sure you are using DirectX 7.0 or later.
> YES! I AM SURE I HAVE THE RIGHT DLL!
> For I\'m sure someone at Sun already tested it, I will give that a second
chance on another machine and don\'t consider that to be a serious problem. I\'m
pretty sure I don\'t have the right DX version in here, but the error does not
point into that direction??
>
> Others:
> - The Readme is named README.Java3D-jdk.Direct3D.txt, but still has the OGL
content
You're right - the README in the InstallShield application is correct but
the README that is installed is worng - sorry about that. Attached is the
correct README for the DirectX release.
> - I ran the DX jars with the OGL J3D.dll and was surprised! Ok, some colors
have been wrong, but my movement seemed to be MUCH smoother!! How is that??
Hmmm, in general you will have problems with this technique - and there
is no reason you should get better performance.
Dan Petersen
Java 3D Team
Sun Microsystems
Java 3D(TM) 1.2-001
README file for Win32/OpenGL
===========================
IMPORTANT INSTALLATION NOTE
===========================
Java 3D 1.2-001 is a complete installation of Java 3D, not a patch to
be added to an existing Java 3D installation.
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 WindowsNT 4.0,
Windows 98, and Windows 2000 requires the following:
Java 2 (Runtime Environment 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. JPI version 1.2.2 or higher is required
to run Java 3D(TM) programs 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
============
Execute the Java 3D(TM) Installer program:
java3d1_2-001-win32-opengl-sdk.exe - to install the SDK
java3d1_2-001-win32-opengl-rt.exe - to install the runtime version
(used by Java Plug-In).
After installation, you may remove these files.
The Java 3D(TM) SDK includes several demo programs that can
verify correct installation. Assuming your Java 2 SDK is installed
at \jdk1.2.2, try the following:
cd \jdk1.2.2\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
You do not need to include the J3D jar files in your CLASSPATH,
nor do you need to include the J3D 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/
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/
===============
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).
Special HTML code is required to get Netscape to use the JPI
VM. Refer to the following URL for information on using
Java Plug-In 1.2.2 HTML Converter and running applets using
Java Plug-in:
http://java.sun.com/products/plugin/
All example programs that can be run as applets now have an html file with
"_plugin" in their name that has been converted to use Java Plug-In.
Use any of these programs to test your installation of Java 3D in your
browser.
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 the Start menu (in the Programs section) and in "Java
Run Time Parameters" put "mx64m" for 64M of heap memory.
====================================================
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
============
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
- Preliminary triangle stripifier
- Geometry compression utilities
- Spline-based path interpolators
- Preliminary Wavefront .obj loader
- Preliminary 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
==============
KNOWN PROBLEMS
==============
Documentation Bugs
------------------
4181456 make Sensor.setSensorReadCount MT-safe
4199091 Raster object uses the alpha value inside the image to perform
blend operation
4284971 Specify that wakeup criteria should not be shared
4284973 Billboard and OrientedShape3D must specify that +Z axis is illegal
4284976 Specify that getProjection is illegal in non-compatibility mode
4284977 Clarify effect of capability bits in retained mode
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 methods
4303058 Docs should indicate when boundary color is used
4303060 Docs should be more clear on interaction of old/new texture state
methods
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
4307552 Spec. need to be clearer on the issue of sync. between sg. update
and picking.
4259353 documentation for com.sun.j3d.utils.geometry.Box is confusing
Core Bugs (j3d and vecmath)
---------------------------
4181344 Java 3D cannot handle more than 64 lights
4181349 Need to add Transform to SceneGraphPath hashCode
4181417 Need to add an internal epsilonEquals method for bounds objects
4181456 make Sensor.setSensorReadCount MT-safe
4182781 Shape3D memory not freed when unassigned if associated
appearance object isalive
4182859 Back clip distance in Clip node not scaled correctly
4186182 sceneAntialiasing setting of PREFERRED is ignored
4186219 Geometry Collision does not implement points/surface, line/line, or
line/point
4187092 Filtering causes loud, sweeping resonance to be added to most sounds
4187093 Cross-talk cancellation for sound playback in not implemented
4189092 HEAD_PREDICTOR and HAND_PREDICTOR policies not implemented
4190692 Multiple sample channels are not always synchronized when started
4191172 Text3D rendering problems
4193466 GMatrix SVD does not work correctly for some cases.
4212805 ReadRaster test program has race condition
4246325 AWT Event once enable, will not disable when behavior remove
4250253 GeometryInfo leaks memory in some cases (with Appearance?)
4259345 Text3D does not correct convert geometry of Japanese-text
4259533 getTexture() throws NullPointerException when using proxies
4260818 java3d should support stereo graphics automatically
4269784 vecmath.GMatrix.LUD inefficient
4269923 LOD's slow
4269929 lighting bounds problem
4271363 CloneTree display garbled in AccelGalaxy card RealImage 2100
4299480 readRaster() and waitForOffScreenRendering() will not work if
threadLimit=1
4308591 Text3D objects bounding box not accurate enough
4308592 texture loader does not scale non-power-of-2 RGBA textures properly
4308599 transparent BufferedImages not working
4308601 using KeyEvents and Swing requires clicking on the window with
the mouse
4309037 setWorldURL in the Loader.java is setup wrong (fix included)
4309059 background geometry appears very close to the camera vs 1.1.3
4310109 share context not use when createContext() in GraphicsContext3D
4310958 wrong bounds may be used in region of influence operations
4312044 java Viewer reflects only Lightwave objects with depth
4313678 Java3D disables invalid lights
4315018 Garbage sound in TestFilter
4315058 VolRend display white cube when Axis Volume is 3D
4316844 Documentation of Java 3D colors should specify gamma assumptions
4319780 RFE: java3d scene graph objects are not serializable
4325851 Hardware MultiTexture not support even though
numActiveTexture <= supported num
4326571 Need URL method for Lightwave objects in applets
4327643 RFE: LW3Dloader needs to be able to load 'other' image file formats
4328532 Textures for the bottom of cones and cylinders are upside-down
4331434 adding object to itself does not generate an exception
4331646 rendering differences between WIN32 and Solaris platforms
4331669 setRectangleScaleFactor will not change text size unless setString
called
4331677 setWindowResizePolicy(View.VIRTUAL_WORLD) doesn't work1<
4332793 View transform & object transform not synchronized in a single behavior
4334767 examples/MoveAppBoundingLeaf sometimes produces no sound
4335205 WakeupOnCollision fail if arming Node is TransformGroup which
undergo transform
4335245 Raster type RASTER_COLOR_DEPTH did not work as expect
4336263 Automatic texture generation eye linear fail when switch back from
object linear
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
4344909 Material setDiffuseColor fail
4345331 Transform3D : almostEqual and setScale can be more optimize.
4346786 OutOfMemory error when generating 20,000 Box primitives
4348562 GMatrix SVD method throws ArrayIndexOutOfBoundsException
4348609 Poor rendering of textures on NT with 16 bit color
4348861 Geometry intersection fail to return collision in some orientation
Utility Bugs
------------
4217567 NormalsGenerator only checks the cosine for smoothing
4250253 GeometryInfo leaks memory in some cases (with Appearance?)
4252349 First viewport may jump when using KeyNavigatorBehavior
Windows-specific Bugs
---------------------
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
