Magnum::BulletIntegration::MotionState class

#include <Magnum/BulletIntegration/MotionState.h>

Usage

Common usage is to either create a btRigidBody to share transformation with a SceneGraph::Object by passing the motion state in its constructor:

btDynamicsWorld* btWorld = …;
SceneGraph::Object<SceneGraph::MatrixTransformation3D> object;

auto motionState = new BulletIntegration::MotionState{object};
auto collisionShape = new btBoxShape{{0.5f, 0.5f, 0.5f}};
auto rigidBody = new btRigidBody{20.0f, &motionState->btMotionState(), collisionShape};
btWorld->addRigidBody(rigidBody);

This way, the scene graph will be affected automatically by the Bullet simulation. It's also possible to attach the motion state afterwards:

rigidBody->setMotionState(&motionState->btMotionState());

Note that in the other direction, the transform is propagated from the scene graph to the rigid body only during the initial creation of the btRigidBody or when you explicitly set the body as kinematic (which however makes it mostly a passive collision object):

rigidBody->setCollisionFlags(rigidBody->getCollisionFlags()|
    btCollisionObject::CF_KINEMATIC_OBJECT);

In order to update the transformation of a non-kinematic body, set the transform directly on the btRigidBody:

rigidBody->setWorldTransform(btTransform(object.transformationMatrix()));

Keep in mind that changes to a rigid body using btRigidBody::setWorldTransform() may only update the motion state of non-static objects and while btDynamicsWorld::stepSimulation() is called.

Base classes

template<UnsignedInt dimensions, class T>

class Magnum::SceneGraph::AbstractFeature<btScalar>

Base for object features.

Constructors, destructors, conversion operators

template<class T>

MotionState(T& object)

Constructor.

Public functions

auto btMotionState() -> btMotionState&

Motion state.

Protected functions

void getWorldTransform(btTransform& worldTrans) const override

Get world transformation.

void setWorldTransform(const btTransform& worldTrans) override

Set world transformation.

Function documentation