Module com.github.stephengold.joltjni

Package com.github.stephengold.joltjni

Class BodyLockMultiWrite

java.lang.Object

com.github.stephengold.joltjni.JoltPhysicsObject

com.github.stephengold.joltjni.NonCopyable

com.github.stephengold.joltjni.BodyLockMultiBase

com.github.stephengold.joltjni.BodyLockMultiWrite

All Implemented Interfaces:

ConstJoltPhysicsObject, AutoCloseable, Comparable<JoltPhysicsObject>

public class BodyLockMultiWrite
extends BodyLockMultiBase

Lock multiple bodies for read-write access.

Constructor Summary

Constructors

Constructor	Description
BodyLockMultiWrite(BodyLockInterface bli, int... bodyIds)	Acquire body locks using the specified interface and body IDs.

Method Summary

Modifier and Type	Method	Description
Body[]	getBodies()	Access all the bodies.
Body	getBody(int index)	Access a specific body.
int	getNumBodies()	Count the bodies that were locked.
void	releaseLocks()	Release all the locks.

Methods inherited from class com.github.stephengold.joltjni.JoltPhysicsObject

close, compareTo, equals, getContainingObject, hasAssignedNativeObject, hashCode, isCleanerStarted, ownsNativeObject, setVirtualAddress, setVirtualAddress, startCleaner, targetVa, toString, va

Methods inherited from class java.lang.Object

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

Constructor Details

BodyLockMultiWrite

public BodyLockMultiWrite(BodyLockInterface bli,
 int... bodyIds)

Acquire body locks using the specified interface and body IDs.

Parameters:

bli - the interface to use (not null, unaffected)

bodyIds - the IDs of the bodies to lock (not empty)

Method Details

getBodies

public Body[] getBodies()

Access all the bodies.

Specified by:

getBodies in class BodyLockMultiBase

Returns:

a new array

getBody

public Body getBody(int index)

Access a specific body.

Specified by:

getBody in class BodyLockMultiBase

Parameters:

index - into the array of body IDs (≥0)

Returns:

a new JVM object with the pre-existing native object assigned, or null if not available

getNumBodies

public int getNumBodies()

Count the bodies that were locked.

Specified by:

getNumBodies in class BodyLockMultiBase

Returns:

the number of bodies (≥0)

releaseLocks

public void releaseLocks()

Release all the locks.

Specified by:

releaseLocks in class BodyLockMultiBase