* Developers are required to do the following whenever they modify * Java 3D: * *
* The tags of the form @STRING@ are populated by ant when the project is built * *
* Additionally, developers are required to comply with the terms
* of the Java 3D API specification, which prohibits releasing an
* implementation of the Java 3D API without first licensing and
* passing the TCK tests.
*
* @see VirtualUniverse#getProperties
*/
class VersionInfo extends Object {
/**
* Developer who has modified Java 3D.
* This string must be modified to indicate the name of the
* individual(s) or organization(s) who modified the code.
*/
private static final String VENDOR_DEVELOPER = null;
/**
* 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.
*/
private static final String VERSION_DEV_STRING = null;
// -------------------------------------------------------------------
// -------------------------------------------------------------------
// END OF DEVELOPER-MODIFIABLE PARAMETERS
// -------------------------------------------------------------------
// -------------------------------------------------------------------
// -------------------------------------------------------------------
// The following set of constants must not be modified by developers.
//
// Only qualified licensees of the Java 3D API specification and
// TCK tests, who are releasing their own implementation of Java 3D
// are permitted to change these constants.
// -------------------------------------------------------------------
/**
* Constant that indicates whether or not this is
* a debug build.
*/
static final boolean isDebug = @IS_DEBUG@;
/**
* This static final variable is used to turn on/off debugging,
* checking, and initializing codes that may be preferred in
* development phase but not necessarily required in the
* production release.
*
* Beside for debugging, use this variable to do initialization,
* checking objects existence, and other checks that may help in
* uncovering potential bugs during code development. This
* variable should be turned off during production release as it
* may cause performance hit.
*/
static final boolean devPhase = @DEV_PHASE@;
/**
* This flag is set to true for daily builds and false for stable builds.
*/
private static final boolean dailyBuild = @DAILY_BUILD@;
/**
* String identifying the particular build of Java 3D, for
* example, beta1, build47, rc1, etc. This string may only
* contain letters, numbers, periods, dashes, or underscores. It
* must not contain any other characters or spaces.
*
* This will typically by null for final, released builds, but
* should be non-null for all other builds.
*/
private static final String VERSION_BUILD = "@VERSION_BUILD@";
/**
* Date stamp
*
* This is only used for daily builds.
*/
private static final String BUILDTIME = "@BUILDTIME@";
/**
* Specification version (major and minor version only). This
* string must not be modified by developers.
*/
private static final String SPECIFICATION_VERSION = "1.3";
/**
* Specification vendor. This should never change and must not
* be modified by developers.
*/
private static final String SPECIFICATION_VENDOR = "Sun Microsystems, Inc.";
/**
* Primary implementation vendor. This should only be changed by a
* platform vendor who has licensed the TCK tests and who is
* releasing their own implementation of Java 3D.
*/
private static final String VENDOR_PRIMARY = "Sun Microsystems, Inc.";
/**
* 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.
*/
private static final String VERSION_BASE = "@VERSION_BASE@";
/**
* Qualifier indicating that the version of Java 3D is
* experimental. This must not be modified by deverlopers.
* All non-official builds must contain the string
* "experimental" as part of the release name that
* appears before the optional first space.
*/
private static final String VERSION_SUFFIX = "experimental";
/**
* The composite version string. This is composed in the static
* initializer for this class.
*/
private static final String VERSION;
/**
* The composite vendor string. This is composed in the static
* initializer for this class.
*/
private static final String VENDOR;
/**
* 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 (non-production) builds.
*/
private static final String BUILDTIME_VERBOSE = "@BUILDTIME_VERBOSE@";
private static boolean isNonEmpty(String str) {
if ((str == null) || (str.length() == 0)) {
return false;
}
else {
return true;
}
}
// The static initializer composes the version and vendor strings
static {
// Assign the vendor by concatenating primary and developer
// vendor strings
String tmpVendor = VENDOR_PRIMARY;
if (isNonEmpty(VENDOR_DEVELOPER)) {
tmpVendor += " & " + VENDOR_DEVELOPER;
}
String tmpVersion = VERSION_BASE;
if (devPhase && isNonEmpty(VERSION_BUILD)) {
tmpVersion += "-" + VERSION_BUILD;
}
if (dailyBuild && isNonEmpty(BUILDTIME)) {
tmpVersion += "-" + BUILDTIME;
}
if (isNonEmpty(VERSION_SUFFIX)) {
tmpVersion += "-" + VERSION_SUFFIX;
}
if (devPhase && isNonEmpty(BUILDTIME_VERBOSE)) {
tmpVersion += " " + BUILDTIME_VERBOSE;
}
if (isNonEmpty(VERSION_DEV_STRING)) {
tmpVersion += " " + VERSION_DEV_STRING;
}
VERSION = tmpVersion;
VENDOR = tmpVendor;
}
/**
* Returns the specification version string.
* @return the specification version string
*/
static String getSpecificationVersion() {
return SPECIFICATION_VERSION;
}
/**
* Returns the specification vendor string.
* @return the specification vendor string
*/
static String getSpecificationVendor() {
return SPECIFICATION_VENDOR;
}
/**
* Returns the implementation version string.
* @return the implementation version string
*/
static String getVersion() {
return VERSION;
}
/**
* Returns the implementation vendor string.
* @return the implementation vendor string
*/
static String getVendor() {
return VENDOR;
}
}