All Downloads are FREE. Search and download functionalities are using the official Maven repository.

com.github.stephengold.joltjni.BodyInterface Maven / Gradle / Ivy

There is a newer version: 0.9.3
Show newest version
/*
Copyright (c) 2024 Stephen Gold

Permission is hereby granted, free of charge, to any person obtaining a copy
of this software and associated documentation files (the "Software"), to deal
in the Software without restriction, including without limitation the rights
to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
copies of the Software, and to permit persons to whom the Software is
furnished to do so, subject to the following conditions:

The above copyright notice and this permission notice shall be included in all
copies or substantial portions of the Software.

THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
SOFTWARE.
 */
package com.github.stephengold.joltjni;

import com.github.stephengold.joltjni.enumerate.EActivation;
import com.github.stephengold.joltjni.enumerate.EBodyType;
import com.github.stephengold.joltjni.enumerate.EMotionType;
import com.github.stephengold.joltjni.readonly.ConstBodyCreationSettings;
import com.github.stephengold.joltjni.readonly.ConstBodyId;
import com.github.stephengold.joltjni.readonly.QuatArg;
import com.github.stephengold.joltjni.readonly.RVec3Arg;
import com.github.stephengold.joltjni.readonly.Vec3Arg;

/**
 * An interface to a {@code PhysicsSystem} that's used to create, add, modify,
 * query, remove, and delete bodies.
 *
 * @author Stephen Gold [email protected]
 */
public class BodyInterface extends NonCopyable {
    // *************************************************************************
    // fields

    /**
     * prevent premature garbage collection of the underlying
     * {@code PhysicsSystem}
     */
    final private PhysicsSystem system;
    // *************************************************************************
    // constructors

    /**
     * Instantiate with the specified native object assigned but not owned.
     *
     * @param system the underlying {@code PhysicsSystem} (not null)
     * @param bodyInterfaceVa the virtual address of the native object to assign
     * (not zero)
     */
    BodyInterface(PhysicsSystem system, long bodyInterfaceVa) {
        this.system = system;
        setVirtualAddress(bodyInterfaceVa, null);
    }
    // *************************************************************************
    // new methods exposed

    /**
     * Activate the specified body.
     *
     * @param bodyId the ID of the body to activate (not null, unaffected)
     */
    public void activateBody(ConstBodyId bodyId) {
        long bodyInterfaceVa = va();
        long bodyIdVa = bodyId.va();
        activateBody(bodyInterfaceVa, bodyIdVa);
    }

    /**
     * Add the specified body to the physics system.
     *
     * @param bodyId the ID of the body to add (not null, unaffected)
     * @param activation whether to activate the body (not null)
     */
    public void addBody(ConstBodyId bodyId, EActivation activation) {
        long bodyInterfaceVa = va();
        long bodyIdVa = bodyId.va();
        int activationOrdinal = activation.ordinal();
        addBody(bodyInterfaceVa, bodyIdVa, activationOrdinal);
    }

    /**
     * Apply the specified force to the specified body's center of mass.
     *
     * @param bodyId the ID of the body (not null, unaffected)
     * @param force the force vector (not null, unaffected)
     */
    public void addForce(ConstBodyId bodyId, Vec3Arg force) {
        long bodyInterfaceVa = va();
        long bodyIdVa = bodyId.va();
        float fx = force.getX();
        float fy = force.getY();
        float fz = force.getZ();
        addForce(bodyInterfaceVa, bodyIdVa, fx, fy, fz);
    }

    /**
     * Apply the specified force to the specified body at the specified
     * location.
     *
     * @param bodyId the ID of the body (not null, unaffected)
     * @param force the force vector (not null, unaffected)
     * @param location where to apply the force (not null, unaffected)
     */
    public void addForce(ConstBodyId bodyId, Vec3Arg force, RVec3Arg location) {
        long bodyInterfaceVa = va();
        long bodyIdVa = bodyId.va();
        float fx = force.getX();
        float fy = force.getY();
        float fz = force.getZ();
        double locX = location.xx();
        double locY = location.yy();
        double locZ = location.zz();
        addForce(bodyInterfaceVa, bodyIdVa, fx, fy, fz, locX, locY, locZ);
    }

    /**
     * Apply the specified impulse to the specified body's center of mass.
     *
     * @param bodyId the ID of the body (not null, unaffected)
     * @param impulse the impulse vector (not null, unaffected)
     */
    public void addImpulse(ConstBodyId bodyId, Vec3Arg impulse) {
        long bodyInterfaceVa = va();
        long bodyIdVa = bodyId.va();
        float jx = impulse.getX();
        float jy = impulse.getY();
        float jz = impulse.getZ();
        addImpulse(bodyInterfaceVa, bodyIdVa, jx, jy, jz);
    }

    /**
     * Apply the specified impulse to the specified body at the specified
     * location.
     *
     * @param bodyId the ID of the body (not null, unaffected)
     * @param impulse the impulse vector (not null, unaffected)
     * @param location where to apply the impulse (not null, unaffected)
     */
    public void addImpulse(ConstBodyId bodyId, Vec3Arg impulse,
            RVec3Arg location) {
        long bodyInterfaceVa = va();
        long bodyIdVa = bodyId.va();
        float jx = impulse.getX();
        float jy = impulse.getY();
        float jz = impulse.getZ();
        double locX = location.xx();
        double locY = location.yy();
        double locZ = location.zz();
        addImpulse(bodyInterfaceVa, bodyIdVa, jx, jy, jz, locX, locY, locZ);
    }

    /**
     * Apply the specified torque to the specified body.
     *
     * @param bodyId the ID of the body (not null, unaffected)
     * @param torque the torque vector (not null, unaffected)
     */
    public void addTorque(ConstBodyId bodyId, Vec3Arg torque) {
        long bodyInterfaceVa = va();
        long bodyIdVa = bodyId.va();
        float x = torque.getX();
        float y = torque.getY();
        float z = torque.getZ();
        addTorque(bodyInterfaceVa, bodyIdVa, x, y, z);
    }

    /**
     * Create a body and add it to the physics system.
     *
     * @param settings the settings to use (not null, unaffected)
     * @param activationMode whether to activate the body (not null)
     * @return the ID of the created body, or an invalid ID when out of bodies
     */
    public ConstBodyId createAndAddBody(
            BodyCreationSettings settings, EActivation activationMode) {
        Body body = createBody(settings);
        ConstBodyId result = body.getId();
        addBody(result, activationMode);

        return result;
    }

    /**
     * Create a body using the specified settings.
     *
     * @param settings the settings to use (not null, unaffected)
     * @return the new body
     */
    public Body createBody(ConstBodyCreationSettings settings) {
        long bodyInterfaceVa = va();
        long settingsVa = settings.va();
        long bodyVa = createBody(bodyInterfaceVa, settingsVa);
        if (bodyVa == 0L) {
            throw new IllegalStateException("ran out of bodies");
        }
        Body result = new Body(bodyVa);

        return result;
    }

    /**
     * Deactivate the specified body.
     *
     * @param bodyId the ID of the body to deactivate (not null, unaffected)
     */
    public void deactivateBody(ConstBodyId bodyId) {
        long bodyInterfaceVa = va();
        long bodyIdVa = bodyId.va();
        deactivateBody(bodyInterfaceVa, bodyIdVa);
    }

    /**
     * Destroy the specified body.
     *
     * @param bodyId the ID of the body to destroy (not null)
     */
    public void destroyBody(ConstBodyId bodyId) {
        long bodyInterfaceVa = va();
        long bodyIdVa = bodyId.va();
        destroyBody(bodyInterfaceVa, bodyIdVa);
    }

    /**
     * Return the angular velocity of the specified body.
     *
     * @param bodyId the ID of the body (not null)
     * @return a new velocity vector (radians per second in physics-system
     * coordinates)
     */
    public Vec3 getAngularVelocity(ConstBodyId bodyId) {
        long bodyInterfaceVa = va();
        long bodyIdVa = bodyId.va();
        float x = getAngularVelocityX(bodyInterfaceVa, bodyIdVa);
        float y = getAngularVelocityY(bodyInterfaceVa, bodyIdVa);
        float z = getAngularVelocityZ(bodyInterfaceVa, bodyIdVa);
        Vec3 result = new Vec3(x, y, z);

        return result;
    }

    /**
     * Return the type of the specified body.
     *
     * @param bodyId the ID of the body to query (not null)
     * @return an enum value (not null)
     */
    public EBodyType getBodyType(ConstBodyId bodyId) {
        long bodyInterfaceVa = va();
        long bodyIdVa = bodyId.va();
        int ordinal = getBodyType(bodyInterfaceVa, bodyIdVa);
        EBodyType result = EBodyType.values()[ordinal];

        return result;
    }

    /**
     * Locate the center of mass of the specified body.
     *
     * @param bodyId the ID of the body to locate (not null)
     * @return a new location vector (in physics-system coordinates)
     */
    public RVec3 getCenterOfMassPosition(ConstBodyId bodyId) {
        long bodyInterfaceVa = va();
        long bodyIdVa = bodyId.va();
        double xx = getCenterOfMassPositionX(bodyInterfaceVa, bodyIdVa);
        double yy = getCenterOfMassPositionY(bodyInterfaceVa, bodyIdVa);
        double zz = getCenterOfMassPositionZ(bodyInterfaceVa, bodyIdVa);
        RVec3 result = new RVec3(xx, yy, zz);

        return result;
    }

    /**
     * Return the friction ratio of the specified body.
     *
     * @param bodyId the ID of the body (not null)
     * @return the ratio
     */
    public float getFriction(ConstBodyId bodyId) {
        long bodyInterfaceVa = va();
        long bodyIdVa = bodyId.va();
        float result = getFriction(bodyInterfaceVa, bodyIdVa);
        return result;
    }

    /**
     * Return the gravity factor of the specified body.
     *
     * @param bodyId the ID of the body (not null)
     * @return the factor
     */
    public float getGravityFactor(ConstBodyId bodyId) {
        long bodyInterfaceVa = va();
        long bodyIdVa = bodyId.va();
        float result = getGravityFactor(bodyInterfaceVa, bodyIdVa);

        return result;
    }

    /**
     * Return the linear velocity of the specified body.
     *
     * @param bodyId the ID of the body (not null)
     * @return a new velocity vector (meters per second in physics-system
     * coordinates)
     */
    public Vec3 getLinearVelocity(ConstBodyId bodyId) {
        long bodyInterfaceVa = va();
        long bodyIdVa = bodyId.va();
        float x = getLinearVelocityX(bodyInterfaceVa, bodyIdVa);
        float y = getLinearVelocityY(bodyInterfaceVa, bodyIdVa);
        float z = getLinearVelocityZ(bodyInterfaceVa, bodyIdVa);
        Vec3 result = new Vec3(x, y, z);

        return result;
    }

    /**
     * Return the motion type of the specified body.
     *
     * @param bodyId the ID of the body to query (not null, unaffected)
     * @return an enum value (not null)
     */
    public EMotionType getMotionType(ConstBodyId bodyId) {
        long bodyInterfaceVa = va();
        long bodyIdVa = bodyId.va();
        int ordinal = getMotionType(bodyInterfaceVa, bodyIdVa);
        EMotionType result = EMotionType.values()[ordinal];

        return result;
    }

    /**
     * Locate the specified body.
     *
     * @param bodyId the ID of the body to locate (not null, unaffected)
     * @return a new location vector (in physics-system coordinates)
     */
    public RVec3 getPosition(ConstBodyId bodyId) {
        long bodyInterfaceVa = va();
        long bodyIdVa = bodyId.va();
        double xx = getPositionX(bodyInterfaceVa, bodyIdVa);
        double yy = getPositionY(bodyInterfaceVa, bodyIdVa);
        double zz = getPositionZ(bodyInterfaceVa, bodyIdVa);
        RVec3 result = new RVec3(xx, yy, zz);

        return result;
    }

    /**
     * Copy the location and orientation of the specified body.
     *
     * @param bodyId the ID of the body to locate (not null, unaffected)
     * @param storeLocation storage for the location (not null, modified)
     * @param storeOrientation storage for the orientation (not null, modified)
     */
    public void getPositionAndRotation(
            ConstBodyId bodyId, RVec3 storeLocation, Quat storeOrientation) {
        long bodyInterfaceVa = va();
        long bodyIdVa = bodyId.va();

        double xx = getPositionX(bodyInterfaceVa, bodyIdVa);
        double yy = getPositionY(bodyInterfaceVa, bodyIdVa);
        double zz = getPositionZ(bodyInterfaceVa, bodyIdVa);
        storeLocation.set(xx, yy, zz);

        float qw = getRotationW(bodyInterfaceVa, bodyIdVa);
        float qx = getRotationX(bodyInterfaceVa, bodyIdVa);
        float qy = getRotationY(bodyInterfaceVa, bodyIdVa);
        float qz = getRotationZ(bodyInterfaceVa, bodyIdVa);
        storeOrientation.set(qx, qy, qz, qw);
    }

    /**
     * Return the restitution ratio of the specified body.
     *
     * @param bodyId the ID of the body to query (not null)
     * @return the value (typically ≥0 and ≤1)
     */
    public float getRestitution(ConstBodyId bodyId) {
        long bodyInterfaceVa = va();
        long bodyIdVa = bodyId.va();
        float result = getRestitution(bodyInterfaceVa, bodyIdVa);

        return result;
    }

    /**
     * Return the orientation of the specified body.
     *
     * @param bodyId the ID of the body (not null, unaffected)
     * @return a new rotation quaternion
     */
    public Quat getRotation(ConstBodyId bodyId) {
        long bodyInterfaceVa = va();
        long bodyIdVa = bodyId.va();

        float qw = getRotationW(bodyInterfaceVa, bodyIdVa);
        float qx = getRotationX(bodyInterfaceVa, bodyIdVa);
        float qy = getRotationY(bodyInterfaceVa, bodyIdVa);
        float qz = getRotationZ(bodyInterfaceVa, bodyIdVa);
        Quat result = new Quat(qx, qy, qz, qw);

        return result;
    }

    /**
     * Access the body's shape.
     *
     * @param bodyId the ID of the body (not null, unaffected)
     * @return a new reference
     */
    public ShapeRefC getShape(ConstBodyId bodyId) {
        long bodyInterfaceVa = va();
        long bodyIdVa = bodyId.va();
        long shapeRefVa = getShape(bodyInterfaceVa, bodyIdVa);
        ShapeRefC result = new ShapeRefC(shapeRefVa, true);

        return result;
    }

    /**
     * Access the underlying {@code PhysicsSystem}.
     *
     * @return the pre-existing instance
     */
    public PhysicsSystem getSystem() {
        return system;
    }

    /**
     * Test whether the specified body is active.
     *
     * @param bodyId the ID of the body to test (not null, unaffected)
     * @return true if active, otherwise false
     */
    public boolean isActive(ConstBodyId bodyId) {
        long bodyIdVa = bodyId.va();
        boolean result = isActive(va(), bodyIdVa);
        return result;
    }

    /**
     * Test whether the specified body is added to the system.
     *
     * @param bodyId the ID of the body to test (not null, unaffected)
     * @return true if added, otherwise false
     */
    public boolean isAdded(ConstBodyId bodyId) {
        long bodyInterfaceVa = va();
        long bodyIdVa = bodyId.va();
        boolean result = isAdded(bodyInterfaceVa, bodyIdVa);
        return result;
    }

    /**
     * Reposition the specified body, assuming it's kinematic.
     *
     * @param bodyId the ID of the body to reposition (not null, unaffected)
     * @param location the desired location (in physics-system coordinates, not
     * null, unaffected)
     * @param orientation the desired orientation (relative to the
     * physics-system axes, not null, unaffected)
     * @param deltaTime time until the desired position is reached (in seconds,
     * >0)
     */
    public void moveKinematic(ConstBodyId bodyId,
            RVec3Arg location, QuatArg orientation, float deltaTime) {
        long bodyInterfaceVa = va();
        long bodyIdVa = bodyId.va();
        double xx = location.xx();
        double yy = location.yy();
        double zz = location.zz();
        float qw = orientation.getW();
        float qx = orientation.getX();
        float qy = orientation.getY();
        float qz = orientation.getZ();
        moveKinematic(bodyInterfaceVa, bodyIdVa, xx, yy, zz,
                qx, qy, qz, qw, deltaTime);
    }

    /**
     * Notify all systems that the shape of the specified body has changed.
     *
     * @param bodyId the ID of the affected body (not null, unaffected)
     * @param prevCom center of mass prior to the change (not null, unaffected)
     * @param updateMassProperties true to recalculate mass and inertia
     * @param activation whether to activate the body (not null)
     */
    public void notifyShapeChanged(ConstBodyId bodyId, Vec3Arg prevCom,
            boolean updateMassProperties, EActivation activation) {
        long bodyInterfaceVa = va();
        long bodyIdVa = bodyId.va();
        int activationOrdinal = activation.ordinal();
        notifyShapeChanged(bodyInterfaceVa, bodyIdVa, prevCom.getX(),
                prevCom.getY(), prevCom.getZ(), updateMassProperties,
                activationOrdinal);
    }

    /**
     * Remove the specified body from the physics system.
     *
     * @param bodyId the ID of the body to remove (not null, unaffected)
     */
    public void removeBody(ConstBodyId bodyId) {
        long bodyIdVa = bodyId.va();
        removeBody(va(), bodyIdVa);
    }

    /**
     * Alter the linear velocity of the specified body.
     *
     * @param bodyId the ID of the body to modify (not null, unaffected)
     * @param omega the desired rates (not null, unaffected)
     */
    public void setAngularVelocity(ConstBodyId bodyId, Vec3Arg omega) {
        long bodyInterfaceVa = va();
        long bodyIdVa = bodyId.va();
        setAngularVelocity(bodyInterfaceVa, bodyIdVa,
                omega.getX(), omega.getY(), omega.getZ());
    }

    /**
     * Alter the friction ratio of the specified body.
     *
     * @param bodyId the ID of the body to modify (not null, unaffected)
     * @param friction the desired ratio (typically ≥0 and ≤1,
     * default=0.2)
     */
    public void setFriction(ConstBodyId bodyId, float friction) {
        long bodyInterfaceVa = va();
        long bodyIdVa = bodyId.va();
        setFriction(bodyInterfaceVa, bodyIdVa, friction);
    }

    /**
     * Alter the gravity factor of the specified body.
     *
     * @param bodyId the ID of the body to modify (not null, unaffected)
     * @param factor the desired factor (default=1)
     */
    public void setGravityFactor(ConstBodyId bodyId, float factor) {
        long bodyInterfaceVa = va();
        long bodyIdVa = bodyId.va();
        setGravityFactor(bodyInterfaceVa, bodyIdVa, factor);
    }

    /**
     * Alter the linear velocity of the specified body.
     *
     * @param bodyId the ID of the body to modify (not null, unaffected)
     * @param velocity the desired velocity (not null, unaffected)
     */
    public void setLinearVelocity(ConstBodyId bodyId, Vec3Arg velocity) {
        long bodyIdVa = bodyId.va();
        setLinearVelocity(va(), bodyIdVa,
                velocity.getX(), velocity.getY(), velocity.getZ());
    }

    /**
     * Alter the restitution ratio of the specified body.
     *
     * @param bodyId the ID of the body to modify (not null, unaffected)
     * @param restitution the desired ratio (typically ≥0 and ≤1,
     * default=0)
     */
    public void setRestitution(ConstBodyId bodyId, float restitution) {
        long bodyInterfaceVa = va();
        long bodyIdVa = bodyId.va();
        setRestitution(bodyInterfaceVa, bodyIdVa, restitution);
    }
    // *************************************************************************
    // native private methods

    native private static void activateBody(
            long bodyInterfaceVa, long bodyIdVa);

    native private static void addBody(
            long bodyInterfaceVa, long bodyIdVa, int activationOrdinal);

    native private static void addForce(
            long bodyInterfaceVa, long bodyIdVa, float fx, float fy, float fz);

    native private static void addForce(
            long bodyInterfaceVa, long bodyIdVa, float fx, float fy, float fz,
            double locX, double locY, double locZ);

    native private static void addImpulse(
            long bodyInterfaceVa, long bodyIdVa, float jx, float jy, float jz);

    native private static void addImpulse(
            long bodyInterfaceVa, long bodyIdVa, float jx, float jy, float jz,
            double locX, double locY, double locZ);

    native private static void addTorque(
            long bodyInterfaceVa, long bodyIdVa, float x, float y, float z);

    native private static long createBody(
            long bodyInterfaceVa, long settingsVa);

    native private static void deactivateBody(
            long bodyInterfaceVa, long bodyIdVa);

    native private static void destroyBody(
            long bodyInterfaceVa, long bodyIdVa);

    native private static float getAngularVelocityX(
            long bodyInterfaceVa, long bodyIdVa);

    native private static float getAngularVelocityY(
            long bodyInterfaceVa, long bodyIdVa);

    native private static float getAngularVelocityZ(
            long bodyInterfaceVa, long bodyIdVa);

    native private static int getBodyType(long bodyInterfaceVa, long bodyIdVa);

    native private static double getCenterOfMassPositionX(
            long bodyInterfaceVa, long bodyIdVa);

    native private static double getCenterOfMassPositionY(
            long bodyInterfaceVa, long bodyIdVa);

    native private static double getCenterOfMassPositionZ(
            long bodyInterfaceVa, long bodyIdVa);

    native private static float getFriction(
            long bodyInterfaceVa, long bodyIdVa);

    native private static float getGravityFactor(
            long bodyInterfaceVa, long bodyIdVa);

    native private static float getLinearVelocityX(
            long bodyInterfaceVa, long bodyIdVa);

    native private static float getLinearVelocityY(
            long bodyInterfaceVa, long bodyIdVa);

    native private static float getLinearVelocityZ(
            long bodyInterfaceVa, long bodyIdVa);

    native private static int getMotionType(
            long bodyInterfaceVa, long bodyIdVa);

    native private static double getPositionX(
            long bodyInterfaceVa, long bodyIdVa);

    native private static double getPositionY(
            long bodyInterfaceVa, long bodyIdVa);

    native private static double getPositionZ(
            long bodyInterfaceVa, long bodyIdVa);

    native private static float getRestitution(
            long bodyInterfaceVa, long bodyIdVa);

    native private static float getRotationW(
            long bodyInterfaceVa, long bodyIdVa);

    native private static float getRotationX(
            long bodyInterfaceVa, long bodyIdVa);

    native private static float getRotationY(
            long bodyInterfaceVa, long bodyIdVa);

    native private static float getRotationZ(
            long bodyInterfaceVa, long bodyIdVa);

    native private static long getShape(
            long bodyInterfaceVa, long bodyIdVa);

    native private static boolean isActive(long bodyInterfaceVa, long bodyIdVa);

    native private static boolean isAdded(long bodyInterfaceVa, long bodyIdVa);

    native private static void moveKinematic(long bodyInterfaceVa,
            long bodyIdVa, double xx, double yy, double zz,
            float qx, float qy, float qz, float qw, float deltaTime);

    native private static void notifyShapeChanged(long bodyInterfaceVa,
            long bodyIdVa, float prevX, float prevY, float prevZ,
            boolean updateMassProperties, int activationOrdinal);

    native private static void removeBody(
            long bodyInterfaceVa, long bodyIdVa);

    native private static void setAngularVelocity(
            long bodyInterfaceVa, long bodyIdVa, float wx, float wy, float wz);

    native private static void setFriction(
            long bodyInterfaceVa, long bodyIdVa, float friction);

    native private static void setGravityFactor(
            long bodyInterfaceVa, long bodyIdVa, float factor);

    native private static void setLinearVelocity(
            long bodyInterfaceVa, long bodyIdVa, float vx, float vy, float vz);

    native private static void setRestitution(
            long bodyInterfaceVa, long bodyIdVa, float restitution);
}




© 2015 - 2024 Weber Informatics LLC | Privacy Policy