com.jme3.bullet.util

Class NativeLibrary

java.lang.Object

com.jme3.bullet.util.NativeLibrary

public final class NativeLibrary
extends java.lang.Object

Static interface to the Libbulletjme native library.

Field Summary

Fields

Modifier and Type	Field and Description
static java.lang.String	expectedVersion expected version string of the native library
static java.util.logging.Logger	logger message logger for this class

Method Summary

Modifier and Type	Method and Description
static int	countClampedCcdMotions() Count the cumulative number of clamped CCD motions (native variable: gNumClampedCcdMotions).
static int	countThreads() Count how many threads are available for task scheduling.
static void	crash() Crash the JVM with an EXCEPTION_ACCESS_VIOLATION or SIGILL.
static int	dumpMemoryLeaks() Dump all native-memory allocation/free events to standard output.
static int	dumpQuickprof() Dump all Quickprof data to standard output.
static void	fail() Execute btAssert(0).
static boolean	isDebug() Test whether the native library was built with debugging enabled.
static boolean	isDoublePrecision() Test whether the native library uses double-precision arithmetic.
static boolean	isInsideTriangle(Vector3f testPoint, float maxSeparation, Vector3f v0, Vector3f v1, Vector3f v2) Test whether the specified point and triangle are within the specified distance of each other.
static boolean	isQuickprof() Test whether the native library includes Quickprof profiling.
static boolean	isThreadSafe() Test whether the native library was built thread-safe.
static long	jniEnvId() Return the address of the current thread's JNIEnv.
static void	resetQuickprof() Reset Quickprof.
static void	setReinitializationCallbackEnabled(boolean callbackFlag) Alter whether the native library should invoke the reinitialization() callback.
static void	setStartupMessageEnabled(boolean printFlag) Alter whether the native library will print its startup message during initialization.
static java.lang.String	versionNumber() Determine the native library's version string.

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Field Detail

logger

public static final java.util.logging.Logger logger

message logger for this class

expectedVersion

public static final java.lang.String expectedVersion

expected version string of the native library

See Also:

Constant Field Values

Method Detail

countClampedCcdMotions

public static int countClampedCcdMotions()

Count the cumulative number of clamped CCD motions (native variable: gNumClampedCcdMotions).

For debugging. The value shouldn't grow too large.

Returns:

the count (≥0)

countThreads

public static int countThreads()

Count how many threads are available for task scheduling.

Returns:

the count (≥0)

crash

public static void crash()

Crash the JVM with an EXCEPTION_ACCESS_VIOLATION or SIGILL. Intended for testing only!

dumpMemoryLeaks

public static int dumpMemoryLeaks()

Dump all native-memory allocation/free events to standard output. This feature is enabled only in native libraries built with the BT_DEBUG_MEMORY_ALLOCATIONS macro defined.

Returns:

the number of bytes outstanding (≥0), or -1 if this feature is not enabled

dumpQuickprof

public static int dumpQuickprof()

Dump all Quickprof data to standard output. This feature is enabled only in native libraries built with the BT_ENABLE_PROFILE macro defined. Must be invoked on the designated physics thread.

Returns:

the number of frames profiled since the last reset (≥0), or -1 if this feature is not enabled

fail

public static void fail()

Execute btAssert(0). This has no effect on Release builds, but if the native library was built with debugging enabled, it should terminate the Java Virtual Machine. Intended for testing only!

isDebug

public static boolean isDebug()

Test whether the native library was built with debugging enabled.

Returns:

true if Debug buildType, false if Release buildType

isDoublePrecision

public static boolean isDoublePrecision()

Test whether the native library uses double-precision arithmetic.

Returns:

true if double-precision, false if single-precision

isInsideTriangle

public static boolean isInsideTriangle(Vector3f testPoint,
                                       float maxSeparation,
                                       Vector3f v0,
                                       Vector3f v1,
                                       Vector3f v2)

Test whether the specified point and triangle are within the specified distance of each other. Used for testing Bullet's btTriangleShape::isInside().

Parameters:

testPoint - the location of the test point (not null, unaffected)

maxSeparation - the maximum separation allowed

v0 - the first vertex of the triangle (not null, unaffected)

v1 - the 2nd vertex of the triangle (not null, unaffected)

v2 - the 3rd vertex of the triangle (not null, unaffected)

Returns:

true if within the specified distance, otherwise false

isQuickprof

public static boolean isQuickprof()

Test whether the native library includes Quickprof profiling.

Returns:

true if included, otherwise false

isThreadSafe

public static boolean isThreadSafe()

Test whether the native library was built thread-safe.

Returns:

true if thread-safe, otherwise false

jniEnvId

public static long jniEnvId()

Return the address of the current thread's JNIEnv. For debugging and testing.

Returns:

the virtual address of the (native) object (not zero)

resetQuickprof

public static void resetQuickprof()

Reset Quickprof. This feature is enabled only in native libraries built with the BT_ENABLE_PROFILE macro defined. Must be invoked on the designated physics thread.

setReinitializationCallbackEnabled

public static void setReinitializationCallbackEnabled(boolean callbackFlag)

Alter whether the native library should invoke the reinitialization() callback.

Parameters:

callbackFlag - true → invoke, false → don't invoke (default=false)

setStartupMessageEnabled

public static void setStartupMessageEnabled(boolean printFlag)

Alter whether the native library will print its startup message during initialization.

Parameters:

printFlag - true → print message, false → no message (default=true)

versionNumber

public static java.lang.String versionNumber()

Determine the native library's version string.

Returns:

the version string (typically of the form Major.Minor.Patch)