javax.media.j3d
Class VersionInfo

java.lang.Object
  extended by javax.media.j3d.VersionInfo

 class VersionInfo
extends java.lang.Object

The VersionInfo class contains strings that describe the implementation and specification version of the javax.media.j3d pacakge. These strings are made available as properties obtained from the VirtualUniverse class.

NOTE TO DEVELOPERS:

Developers are strongly encouraged to do the following whenever they modify the 3D graphics API for the Java platform:

  1. The VENDOR_DEVELOPER string should be modified to indicate the name of the individuals or organizations who have modified the source code.
  2. The VERSION_DEV_STRING may be modified to indicate additional information about the particular build, but this is not required.
  3. The strings denoted as being unmodifiable should not be modified.

The tags of the form @STRING@ are populated by ant when the project is built

See Also:
VirtualUniverse.getProperties()

Field Summary
private static java.lang.String BUILD_TYPE
          String identifying the type of build, one of: "daily", "stable", "beta", "fcs", or "patch".
private static java.lang.String BUILDTIME
          Date stamp This is only used for daily builds.
private static java.lang.String BUILDTIME_VERBOSE
          Verbose time and date stamp appended to the end of the version string.
(package private) static boolean isDebug
          Constant that indicates whether or not this is a debug build.
(package private) static boolean isDevPhase
          This static final variable is used to enable debugging and assertion checking during the development phase of a particular version of 3D graphics API for the Java platform.
private static boolean isExperimental
          Boolean flag indicating that the version of the 3D API is experimental.
(package private) static boolean isProduction
          This static final variable is used indicate a production (beta, release candidate, fcs, or patch) build.
private static java.lang.String SPECIFICATION_VENDOR
          Specification vendor.
private static java.lang.String SPECIFICATION_VERSION
          Specification version (major and minor version only).
private static boolean useVerboseBuildTime
          If this flag is set to true, the verbose buildtime string will be appended to the version string)
private static java.lang.String VENDOR
          The composite vendor string.
private static java.lang.String VENDOR_DEVELOPER
          Developer who has modified the 3D graphics API for the Java platform.
private static java.lang.String VENDOR_PRIMARY
          Primary implementation vendor.
private static java.lang.String VERSION
          The composite version string.
private static java.lang.String VERSION_BASE
          Base version number.
private static java.lang.String VERSION_BUILD
          String identifying the build number in the format "buildNN", where "NN" is the sequential build number, for example, build47.
private static java.lang.String VERSION_DEV_STRING
          An optional string appended to the end of the version string, after the time stamp.
private static java.lang.String VERSION_SUFFIX
          String identifying the particular build of the 3D API, for example, "-beta1", "-build47", "-rc1", "_01", etc.
 
Constructor Summary
VersionInfo()
           
 
Method Summary
(package private) static java.lang.String getSpecificationVendor()
          Returns the specification vendor string.
(package private) static java.lang.String getSpecificationVersion()
          Returns the specification version string.
(package private) static java.lang.String getVendor()
          Returns the implementation vendor string.
(package private) static java.lang.String getVersion()
          Returns the implementation version string.
private static boolean isNonEmpty(java.lang.String str)
           
 
Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait
 

Field Detail

VENDOR_DEVELOPER

private static final java.lang.String VENDOR_DEVELOPER
Developer who has modified the 3D graphics API for the Java platform. This string should be modified to indicate the name of the individual(s) or organization(s) who modified the code.


VERSION_DEV_STRING

private static final java.lang.String VERSION_DEV_STRING
An optional string appended to the end of the version string, after the time stamp. A space will be automatically prepended to this string. This string should be null if no dev string is desired.


isDebug

static final boolean isDebug
Constant that indicates whether or not this is a debug build.

See Also:
Constant Field Values

isDevPhase

static final boolean isDevPhase
This static final variable is used to enable debugging and assertion checking during the development phase of a particular version of 3D graphics API for the Java platform. It is disabled for "opt" production builds (beta, release candidate, fcs, and patch builds). It is enabled for all "debug" builds and for daily and stable "opt" builds.

This parameter is controlled by ant via the build.xml file. The default value is true.

See Also:
Constant Field Values

isProduction

static final boolean isProduction
This static final variable is used indicate a production (beta, release candidate, fcs, or patch) build.

This parameter is controlled by ant via the build.xml file. The default value is false.

See Also:
Constant Field Values

useVerboseBuildTime

private static final boolean useVerboseBuildTime
If this flag is set to true, the verbose buildtime string will be appended to the version string)

This parameter is controlled by ant via the build.xml file. The default value is true.

See Also:
Constant Field Values

BUILD_TYPE

private static final java.lang.String BUILD_TYPE
String identifying the type of build, one of: "daily", "stable", "beta", "fcs", or "patch". The default value is "daily".

See Also:
Constant Field Values

VERSION_BUILD

private static final java.lang.String VERSION_BUILD
String identifying the build number in the format "buildNN", where "NN" is the sequential build number, for example, build47. This string contain only letters and numbers, It must not contain any other characters or spaces. For production builds, this string appears parenthetically, after the first space.

See Also:
Constant Field Values

VERSION_SUFFIX

private static final java.lang.String VERSION_SUFFIX
String identifying the particular build of the 3D API, for example, "-beta1", "-build47", "-rc1", "_01", etc. Note that this includes the leading dash or underscore. It will typically be empty for FCS builds. This string may only contain letters, numbers, periods, dashes, or underscores. It must not contain any other characters or spaces. This us used as part of the j3d.version that appears before the optional first space.

See Also:
Constant Field Values

BUILDTIME

private static final java.lang.String BUILDTIME
Date stamp This is only used for daily builds.

See Also:
Constant Field Values

SPECIFICATION_VERSION

private static final java.lang.String SPECIFICATION_VERSION
Specification version (major and minor version only). This string must not be modified by developers.

See Also:
Constant Field Values

SPECIFICATION_VENDOR

private static final java.lang.String SPECIFICATION_VENDOR
Specification vendor.

See Also:
Constant Field Values

VENDOR_PRIMARY

private static final java.lang.String VENDOR_PRIMARY
Primary implementation vendor.

See Also:
Constant Field Values

VERSION_BASE

private static final java.lang.String VERSION_BASE
Base version number. This is the major.minor.subminor version number. Version qualifiers are specified separately. The major and minor version must be the same as the specification version.

See Also:
Constant Field Values

isExperimental

private static final boolean isExperimental
Boolean flag indicating that the version of the 3D API is experimental. This must not be modified by developers. All non-official builds must contain the string "experimental" as part of the release name that appears before the optional first space.

See Also:
Constant Field Values

VERSION

private static final java.lang.String VERSION
The composite version string. This is composed in the static initializer for this class.


VENDOR

private static final java.lang.String VENDOR
The composite vendor string. This is composed in the static initializer for this class.


BUILDTIME_VERBOSE

private static final java.lang.String BUILDTIME_VERBOSE
Verbose time and date stamp appended to the end of the version string. This is appended to the version string after the build identifier (and after the first space, which will automatically be added) and before the optional dev string. This string is only used for non-fcs builds.

See Also:
Constant Field Values
Constructor Detail

VersionInfo

VersionInfo()
Method Detail

isNonEmpty

private static boolean isNonEmpty(java.lang.String str)

getSpecificationVersion

static java.lang.String getSpecificationVersion()
Returns the specification version string.

Returns:
the specification version string

getSpecificationVendor

static java.lang.String getSpecificationVendor()
Returns the specification vendor string.

Returns:
the specification vendor string

getVersion

static java.lang.String getVersion()
Returns the implementation version string.

Returns:
the implementation version string

getVendor

static java.lang.String getVendor()
Returns the implementation vendor string.

Returns:
the implementation vendor string


Copyright 1996-2008 Sun Microsystems, Inc. All Rights Reserved. Use is subject to license terms.