My pages	Projects	Communities	java.net

Get Involved

Project tools

How do I...

java3d
Project home

If you were registered and logged in, you could join this project.

Summary	Master project for Java 3D projects
Categories	None
License	Other
Owner(s)	jada, kcr, paulby

Description

The Java 3D(tm) API This is the parent project for all Java 3D^TM-related sub-projects on java.net. These sub-projects include: j3d-core (the core Java 3D API), vecmath (the 3D vector math package), and j3d-core-utils (the Java 3D core utilities), among others. See the complete list of sub-projects at the bottom of this page.

Note that there is no source code in this parent project; source code files for Java 3D-related sub-projects are in the sub-projects themselves.

Demo Programs

Click here to run Java 3D demos right in your browser with no setup required (via Java Web Start).

Documentation

Click on the desired link below to browse the API documentation for various releases.

Final releases:

1.4.0
1.3.2

Daily builds:

1.5.0

Wiki & FAQ

The Java 3D Wiki is a set of collaborative web pages to which members of the Java 3D community can contribute. It includes a list of Frequently Asked Questions (FAQ).

Downloads

Java 3D binary downloads are available on java.net. Three types of builds are provided: Release (or FCS) builds; Stable (experimental, early access) builds; and Daily builds. The latest release build of Java 3D v 1.3.2 is available. Stable and daily builds of Java 3D v 1.4.0 are now available.

Licenses

The source code for the j3d-core-utils and j3d-examples projects is licensed under the open source Berkeley Software Distribution (BSD) License.

The source code for the j3d-core and vecmath projects is licensed under the Java Research License (JRL) for non-commercial use. The JRL allows users to download, build, and modify the source code in the j3d-core and vecmath projects for research use, subject to the terms of the license.

The source for these two projects is also licensed for commercial use under a no-fee Java Distribution License (JDL). The JDL allows commercial use of Java 3D and vecmath with or without modification, as long as compatibility with the entire API Specification is maintained. This includes passing the Java 3D Technology Compatibility Kit (TCK).

Projects other than the four named above are licensed under terms defined by the particular sub-project.

How to Contribute

We invite developers to contribute to Java 3D. Please refer to the Contributing to Java 3D page to learn how to contribute to any of the Java 3D subprojects. See the JavaDesktop Community Governance Guidelines for general guidelines on participating in JavaDesktop community projects, such as Java 3D.

Reporting Issues

Please use the Issue Tracker in this project to track issues (bugs, feature requests, etc.) for Java 3D-related sub-projects. The following subcomponents exist in the java3d project's Issue Tracker:

docs: Issues in Java 3D documentation (e.g., javadoc)
j3d-core: Issues in javax.media.j3d package
j3d-core-utils: Issues in com.sun.j3d.* packages
j3d-examples: Issues in Java 3D program examples
vecmath: Issues in javax.vecmath
www: Issues with the web pages

Before filing a new issue, please check to see if your issue has already been reported: search the "summary" fields of open bugs in the Issue Tracker system. If you're new to Issue tracking, you might want to take a moment to browse these introductory docs:

FAQ: How do I file an issue? — a quick recipe for filing an issue
Guide to Issue Tracking on java.net
How to Write a Good Bug Report

Feedback and Discussion

We have created four Java 3D mailing lists in this project: interest 'at' java3d.dev.java.net, announce 'at' java3d.dev.java.net, issues 'at' java3d.dev.java.net, and cvs 'at' java3d.dev.java.net (replace 'at' with @). Click here to subscribe to any of these lists. The interest list is an open mailing list for discussing all aspects of Java 3D, the reference implementation for the Java 3D core, vecmath, utilities, example programs, etc. The annouce list is a low-volume moderated mailing list for announcing Java 3D-related news and information. The issues list is for automated issues tracking, and the cvs list is for automated CVS change messages (for changes to the parent java3d web pages only).

For those who prefer a forum to a discussion mailing list, we have created the Java 3D forum, hosted as part of the JavaDesktop Community. Messages posted on the forum are cross-posted to interest 'at' java3d.dev.java.net and vice-versa.

Finally, each sub-project has its own cvs mailing list. The cvs lists are for automated CVS change messages and discussion of those changes.

Project Highlights

Release project Source code

The Java 3D source code is available for download from the CVS repository of this project. The trunk of the CVS repository is a stable, release version of Java 3D 1.4.0. A Java 3D 1.5 development branch, dev-1_5, is also available in the CVS repository. For a description of the CVS tags used in this project, please refer to "Using CVS Tags in Java 3D Projects". Daily builds for 1.5.0 are available and are built from the CVS source trees.

Java 3D 1.3.2

The 1.3.2 version of Java 3D on java.net differs from the 1.3.1 release in the following ways:

The com.sun.j3d.* packages have been split out into their own project (j3d-core-utils).
Apache Ant is now used to build Java 3D
The Headspace AudioEngine has been removed. The JavaSound AudioEngine, which is not fully functional, is now the only available AudioDevice. It is disabled by default.
Many bug fixes have been incorporated

The reason the Headspace AudioEngine was removed is that we do not have the rights to ship the source code for the native Headspace sound mixer. Our plan going forward is to enourage the development community to implement an AudioEngine using JOAL.

Java 3D 1.4

The Java 3D 1.4 API is defined by JSR-926, a Maintenance Release under the Java Community Process (JCP). See the JSR page for a list of API changes. A brief description of the 1.4 release can be found on the Java 3D Wiki.

Java 3D 1.5, 1.6, ...

A description of the set of proposed changes for 1.5 (and beyond) is now available on the Java 3D Wiki. Our goal is to minimize large scale changes to the system in order to deliver 1.5 as quickly as possible. We encourage members of the development community to review this proposed set of changes and provide feedback. We also hope that community members will help us design and implement the 1.5 version of the Java 3D API.

Project Suggestions

The main areas in j3d-core for which we need help from the community are:

Bug fixes:

Testing and example programs for new features (especially programmable shaders)
Help defining and implementing the list of community features described in the Wiki

Examples

The j3d-examples project includes a set of simple example programs. The Java 3D Fly Through v 2.0 Beta sample application shows you how to take advantage of the capabilities of Java 3D technology. You can download the source code via http://java3d.netbeans.org.