The README file that is installed with the DirectX version of Java 3D is
the wrong README! Somehow the README for the OpenGL version was bundled
in - the README that comes up from within InstallShield is the correct
version.
To answer your question Java 3D for DirectX is support and Win98 and
Win2000 only.
I have attached the correct README hear as well.
Sorry for the confusion.
Dan Petersen
Java 3D Team
Sun Microsystems
> MIME-Version: 1.0
> Date: Tue, 11 Jul 2000 08:12:55 -0400
> From: "J. Lee Dixon" <[EMAIL PROTECTED]>
> Subject: Re: [JAVA3D] DirectX Beta1
> To: [EMAIL PROTECTED]
>
> Am I the only one that sees a disconnect about running this beta release
> on an NT machine? The readme says it will run on NT4.0, but the INSTALL
> NOTES on-line say this Beta is for Win98 or Win2000.
>
> Okay, so I guess I just want to verify it... this version is not
> suitable for running on NT4.0. The Microsoft DirectX site was VERY
> annoying... they have links for downloading DX7.0a for Win98, but then
> say for NT4 to get service pack six which includes DX3. In other words,
> if you're on NT, you can't have DX7. Oy.
>
>
> J. Lee Dixon
> Software Engineer
> SAIC - Celebration, FL
> [EMAIL PROTECTED]
>
> ===========================================================================
> To unsubscribe, send email to [EMAIL PROTECTED] and include in the body
> of the message "signoff JAVA3D-INTEREST". For general help, send email to
> [EMAIL PROTECTED] and include in the body of the message "help".
Java 3D(TM) 1.2-Beta
README file for Win32/DirectX
===========================
IMPORTANT INSTALLATION NOTE
===========================
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 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.
DirectX 7.0 or later, available from Microsoft
(http://www.microsoft.com/directx/default.asp).
============
INSTALLATION
============
Execute the Java 3D(TM) Installer program:
java3d1_2-001-win32-d3d-sdk.exe - to install the SDK
java3d1_2-001-win32-d3d-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/
================================
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
==============================================
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 FATEST, 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.
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.
Ignored Java 3D Properties
--------------------------
The following Java 3D properties are ignored by the Direct3D implementation:
j3d.sharedctx
j3d.g2ddrawpixel
==============
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
Direct3D specific Bugs
----------------------
Bugs in the NVidia GForce Detonator 1.x Driver
----------------------------------------------
Some TNT cards can't switch to fullscreen mode when using 32-bit colors.
Switch to 16 bit colors to work around this problem.
For a static scene, the first image displayed may not be correct
(until you move the viewport). This also affects offscreen rendering
when an image is captured.
To workaround, use -Dj3d.d3dDevice=Emulation / Reference
(This problem is fixed using Detonator 2.0)
Line patterns (dot line etc.) do not work, only a solid line
shown.
To workaround, use -Dj3d.d3dDevice=Emulation / Reference
For applications with > 2 Canvas3D's in the same window,
when the application closes, the window will crash
in the NVidia driver. After this, all Direct3D programs
will crash when started up. There is no workaround
except to reboot the machine.
(This problem does not occur under Windows 2000 using Detonator 2.0)
Texture Border color mode does not work.
To workaround, use -Dj3d.d3dDevice=Emulation / Reference
Changing automatic texture coordinate generation
from none to eye linear / sphere map does not work.
Cannot toggle to fullscreen mode using appletviewer except
under Windows 2000 with JDK 1.3.
