com.jme3.bullet

Class NativePhysicsObject

java.lang.Object

com.jme3.bullet.NativePhysicsObject

All Implemented Interfaces:

java.lang.Comparable<NativePhysicsObject>

Direct Known Subclasses:

BoundingValueHierarchy, CharacterController, CollisionConfiguration, CollisionShape, CollisionSpace, CompoundMesh, IndexedMesh, MultiBody, MultiBodyLink, PhysicsCollisionEvent, PhysicsCollisionObject, PhysicsJoint, RigidBodyMotionState, RotationalLimitMotor, RotationMotor, SoftBodyMaterial, SoftBodyWorldInfo, SolverInfo, TranslationalLimitMotor, TranslationMotor, VehicleController, VehicleTuning, Vhacd4Parameters, VHACDParameters

public abstract class NativePhysicsObject
extends java.lang.Object
implements java.lang.Comparable<NativePhysicsObject>

An abstract class to represent a native (Bullet) physics object.

Field Summary

Fields

Modifier and Type	Field and Description
static java.util.logging.Logger	loggerN message logger for this class

Constructor Summary

Constructors

Modifier	Constructor and Description
protected	NativePhysicsObject() Instantiate with no tracker and no assigned native object.

Method Summary

Modifier and Type	Method and Description
int	compareTo(NativePhysicsObject other) Compare (by ID) with another native object.
static int	countTrackers() Count how many native objects are being tracked.
static void	dumpTrackers() Dump all native-object trackers to System.out.
boolean	equals(java.lang.Object otherObject) Test for ID equality with another object.
static void	freeUnusedObjects() Free any assigned native objects that are known to be unused.
boolean	hasAssignedNativeObject() Test whether a native object is assigned to this instance.
int	hashCode() Return the hash code for this instance.
long	nativeId() Return the ID of the assigned native object, assuming that one is assigned.
protected void	reassignNativeId(long nativeId) Assign a tracked native object to this instance, unassigning (but not freeing) any previously assigned one.
protected void	setNativeId(long nativeId) Assign a tracked native object to this instance, assuming that no native object is assigned.
protected void	setNativeIdNotTracked(long nativeId) Assign an untracked native object to this instance, assuming that no native object is assigned.
java.lang.String	toString() Represent this instance as a String.
protected void	unassignNativeObject() Unassign (but don't free) the assigned native object, assuming that one is assigned.

Methods inherited from class java.lang.Object

clone, finalize, getClass, notify, notifyAll, wait, wait, wait

Field Detail

loggerN

public static final java.util.logging.Logger loggerN

message logger for this class

Constructor Detail

NativePhysicsObject

protected NativePhysicsObject()

Instantiate with no tracker and no assigned native object.

This no-arg constructor was made explicit to avoid javadoc warnings from JDK 18+.

Method Detail

countTrackers

public static final int countTrackers()

Count how many native objects are being tracked. This method is intended for debugging.

Returns:

the count (≥0)

dumpTrackers

public static final void dumpTrackers()

Dump all native-object trackers to System.out. This method is intended for debugging.

freeUnusedObjects

public static final void freeUnusedObjects()

Free any assigned native objects that are known to be unused.

hasAssignedNativeObject

public final boolean hasAssignedNativeObject()

Test whether a native object is assigned to this instance.

Returns:

true if one is assigned, otherwise false

nativeId

public long nativeId()

Return the ID of the assigned native object, assuming that one is assigned.

Returns:

the native identifier (not zero)

reassignNativeId

protected final void reassignNativeId(long nativeId)

Assign a tracked native object to this instance, unassigning (but not freeing) any previously assigned one.

Parameters:

nativeId - the identifier of the native object to assign (not zero)

setNativeId

protected void setNativeId(long nativeId)

Assign a tracked native object to this instance, assuming that no native object is assigned.

Parameters:

nativeId - the identifier of the native object to assign (not zero)

setNativeIdNotTracked

protected final void setNativeIdNotTracked(long nativeId)

Assign an untracked native object to this instance, assuming that no native object is assigned.

Parameters:

nativeId - the identifier of the native object to assign (not zero)

unassignNativeObject

protected final void unassignNativeObject()

Unassign (but don't free) the assigned native object, assuming that one is assigned.

compareTo

public int compareTo(NativePhysicsObject other)

Compare (by ID) with another native object.

Specified by:

compareTo in interface java.lang.Comparable<NativePhysicsObject>

Parameters:

other - (not null, unaffected)

Returns:

0 if the objects have the same native ID; negative if this comes before other; positive if this comes after other

equals

public boolean equals(java.lang.Object otherObject)

Test for ID equality with another object.

Overrides:

equals in class java.lang.Object

Parameters:

otherObject - the object to compare (may be null, unaffected)

Returns:

true if this and otherObject have the same ID, otherwise false

hashCode

public int hashCode()

Return the hash code for this instance.

Note: operations that alter the native ID are likely to affect the hash code as well!

Overrides:

hashCode in class java.lang.Object

Returns:

a 32-bit value for use in hashing

toString

public java.lang.String toString()

Represent this instance as a String.

Overrides:

toString in class java.lang.Object

Returns:

a descriptive string of text (not null, not empty)