Java 3D API Specification

THIS document describes the Java 3D API and presents some details on the implementation of the API. This specification is not intended as a programmer's guide. The programmer's guide will be written after the specification has been finalized.

This specification is written for 3D graphics application programmers. We assume that the reader has at least a rudimentary understanding of computer graphics. This includes familiarity with the essentials of computer graphics algorithms as well as familiarity with basic graphics hardware and associated terminology.

Related Documentation

This specification is intended to be used in conjunction with the Java 3D reference guide, an online, browser-accessible, javadoc-generated API reference.

Style Conventions

The following style conventions are used in this specification:

• Lucida type is used to represent computer code and the names of files and directories.

• Bold Lucida type is used for Java 3D API declarations.

• Bold type is used to represent variables.

• Italic type is used for emphasis and for equations.

Programming Conventions

Java 3D uses the following programming conventions:

• The default coordinate system is right-handed, with +Y being up, +X horizontal to the right, and +Z directed toward the viewer.

• All angles or rotational representations are in radians.

• All distances are expressed in units or fractions of meters.

Acknowledgments

We gratefully acknowledge Warren Dale for writing the Sound API portion of this specification, Daniel Petersen for writing the scene graph sharing portion of the specification, and Bruce Bartlett for his assistance with the editing, formatting, and indexing of the specification.

We thank the Java 3D partners for their help in defining the Java 3D API. The Java 3D partner companies include Silicon Graphics, Inc., Intel Corporation, Apple Computer, Inc., and Sun Microsystems, Inc.

We also thank the many individuals and companies for their comments and suggestions on the successive drafts of this specification.

Henry Sowizral
Kevin Rushforth
Michael Deering
Sun Microsystems
November 1997

---

Java 3D API Specification

Copyright © 1998, Sun Microsystems, Inc. All rights reserved.