btKinematicCharacterController is an object that supports a sliding motion in a world. More...

#include <btKinematicCharacterController.h>

Inheritance diagram for btKinematicCharacterController:

Collaboration diagram for btKinematicCharacterController:

Public Member Functions
	BT_DECLARE_ALIGNED_ALLOCATOR ()

	btKinematicCharacterController (btPairCachingGhostObject ghostObject, btConvexShape convexShape, btScalar stepHeight, int upAxis=1)

	~btKinematicCharacterController ()

virtual void	updateAction (btCollisionWorld *collisionWorld, btScalar deltaTime)
	btActionInterface interface More...

void	debugDraw (btIDebugDraw *debugDrawer)
	btActionInterface interface More...

void	setUpAxis (int axis)

virtual void	setWalkDirection (const btVector3 &walkDirection)
	This should probably be called setPositionIncrementPerSimulatorStep. More...

virtual void	setVelocityForTimeInterval (const btVector3 &velocity, btScalar timeInterval)
	Caller provides a velocity with which the character should move for the given time period. More...

void	reset (btCollisionWorld *collisionWorld)

void	warp (const btVector3 &origin)

void	preStep (btCollisionWorld *collisionWorld)

void	playerStep (btCollisionWorld *collisionWorld, btScalar dt)

void	setFallSpeed (btScalar fallSpeed)

void	setJumpSpeed (btScalar jumpSpeed)

void	setMaxJumpHeight (btScalar maxJumpHeight)

bool	canJump () const

void	jump ()

void	setGravity (btScalar gravity)

btScalar	getGravity () const

void	setMaxSlope (btScalar slopeRadians)
	The max slope determines the maximum angle that the controller can walk up. More...

btScalar	getMaxSlope () const

btPairCachingGhostObject *	getGhostObject ()

void	setUseGhostSweepTest (bool useGhostObjectSweepTest)

bool	onGround () const

void	setUpInterpolate (bool value)

Public Member Functions inherited from btCharacterControllerInterface
	btCharacterControllerInterface ()

virtual	~btCharacterControllerInterface ()

Public Member Functions inherited from btActionInterface
virtual	~btActionInterface ()

Protected Member Functions
btVector3	computeReflectionDirection (const btVector3 &direction, const btVector3 &normal)

btVector3	parallelComponent (const btVector3 &direction, const btVector3 &normal)

btVector3	perpindicularComponent (const btVector3 &direction, const btVector3 &normal)

bool	recoverFromPenetration (btCollisionWorld *collisionWorld)

void	stepUp (btCollisionWorld *collisionWorld)

void	updateTargetPositionBasedOnCollision (const btVector3 &hit_normal, btScalar tangentMag=btScalar(0.0), btScalar normalMag=btScalar(1.0))

void	stepForwardAndStrafe (btCollisionWorld *collisionWorld, const btVector3 &walkMove)

void	stepDown (btCollisionWorld *collisionWorld, btScalar dt)

Static Protected Member Functions
static btVector3 *	getUpAxisDirections ()

Static Protected Member Functions inherited from btActionInterface
static btRigidBody &	getFixedBody ()

Protected Attributes
btScalar	m_halfHeight

btPairCachingGhostObject *	m_ghostObject

btConvexShape *	m_convexShape

btScalar	m_verticalVelocity

btScalar	m_verticalOffset

btScalar	m_fallSpeed

btScalar	m_jumpSpeed

btScalar	m_maxJumpHeight

btScalar	m_maxSlopeRadians

btScalar	m_maxSlopeCosine

btScalar	m_gravity

btScalar	m_turnAngle

btScalar	m_stepHeight

btScalar	m_addedMargin

btVector3	m_walkDirection
	this is the desired walk direction, set by the user More...

btVector3	m_normalizedDirection

btVector3	m_currentPosition

btScalar	m_currentStepOffset

btVector3	m_targetPosition

btManifoldArray	m_manifoldArray
	keep track of the contact manifolds More...

bool	m_touchingContact

btVector3	m_touchingNormal

bool	m_wasOnGround

bool	m_wasJumping

bool	m_useGhostObjectSweepTest

bool	m_useWalkDirection

btScalar	m_velocityTimeInterval

int	m_upAxis

bool	m_interpolateUp

bool	full_drop

bool	bounce_fix

Detailed Description

btKinematicCharacterController is an object that supports a sliding motion in a world.

It uses a ghost object and convex sweep test to test for upcoming collisions. This is combined with discrete collision detection to recover from penetrations. Interaction between btKinematicCharacterController and dynamic rigid bodies needs to be explicity implemented by the user.

Definition at line 37 of file btKinematicCharacterController.h.

Constructor & Destructor Documentation

btKinematicCharacterController::btKinematicCharacterController	(	btPairCachingGhostObject *	ghostObject,
		btConvexShape *	convexShape,
		btScalar	stepHeight,
		int	upAxis = `1`
	)

Definition at line 134 of file btKinematicCharacterController.cpp.

btKinematicCharacterController::~btKinematicCharacterController ( )

Definition at line 160 of file btKinematicCharacterController.cpp.

Member Function Documentation

btKinematicCharacterController::BT_DECLARE_ALIGNED_ALLOCATOR ( )

bool btKinematicCharacterController::canJump ( ) const

virtual

Implements btCharacterControllerInterface.

Definition at line 705 of file btKinematicCharacterController.cpp.

btVector3 btKinematicCharacterController::computeReflectionDirection	(	const btVector3 &	direction,
		const btVector3 &	normal
	)

protected

Definition at line 112 of file btKinematicCharacterController.cpp.

void btKinematicCharacterController::debugDraw ( btIDebugDraw * debugDrawer )

virtual

btActionInterface interface

Implements btActionInterface.

Definition at line 763 of file btKinematicCharacterController.cpp.

btPairCachingGhostObject * btKinematicCharacterController::getGhostObject ( )

Definition at line 164 of file btKinematicCharacterController.cpp.

btScalar btKinematicCharacterController::getGravity ( ) const

Definition at line 734 of file btKinematicCharacterController.cpp.

btScalar btKinematicCharacterController::getMaxSlope ( ) const

Definition at line 745 of file btKinematicCharacterController.cpp.

btVector3 * btKinematicCharacterController::getUpAxisDirections ( )

staticprotected

Definition at line 756 of file btKinematicCharacterController.cpp.

void btKinematicCharacterController::jump ( )

virtual

Implements btCharacterControllerInterface.

Definition at line 710 of file btKinematicCharacterController.cpp.

bool btKinematicCharacterController::onGround ( ) const

virtual

Implements btCharacterControllerInterface.

Definition at line 750 of file btKinematicCharacterController.cpp.

btVector3 btKinematicCharacterController::parallelComponent	(	const btVector3 &	direction,
		const btVector3 &	normal
	)

protected

Definition at line 120 of file btKinematicCharacterController.cpp.

btVector3 btKinematicCharacterController::perpindicularComponent	(	const btVector3 &	direction,
		const btVector3 &	normal
	)

protected

Definition at line 129 of file btKinematicCharacterController.cpp.

void btKinematicCharacterController::playerStep	(	btCollisionWorld *	collisionWorld,
		btScalar	dt
	)

virtual

Implements btCharacterControllerInterface.

Definition at line 632 of file btKinematicCharacterController.cpp.

void btKinematicCharacterController::preStep ( btCollisionWorld * collisionWorld )

virtual

Implements btCharacterControllerInterface.

Definition at line 607 of file btKinematicCharacterController.cpp.

bool btKinematicCharacterController::recoverFromPenetration ( btCollisionWorld * collisionWorld )

protected

Definition at line 169 of file btKinematicCharacterController.cpp.

void btKinematicCharacterController::reset ( btCollisionWorld * collisionWorld )

virtual

Implements btCharacterControllerInterface.

Definition at line 581 of file btKinematicCharacterController.cpp.

void btKinematicCharacterController::setFallSpeed ( btScalar fallSpeed )

Definition at line 690 of file btKinematicCharacterController.cpp.

void btKinematicCharacterController::setGravity ( btScalar gravity )

Definition at line 729 of file btKinematicCharacterController.cpp.

void btKinematicCharacterController::setJumpSpeed ( btScalar jumpSpeed )

Definition at line 695 of file btKinematicCharacterController.cpp.

void btKinematicCharacterController::setMaxJumpHeight ( btScalar maxJumpHeight )

Definition at line 700 of file btKinematicCharacterController.cpp.

void btKinematicCharacterController::setMaxSlope ( btScalar slopeRadians )

The max slope determines the maximum angle that the controller can walk up.

The slope angle is measured in radians.

Definition at line 739 of file btKinematicCharacterController.cpp.

void btKinematicCharacterController::setUpAxis ( int axis )

inline

Definition at line 115 of file btKinematicCharacterController.h.

void btKinematicCharacterController::setUpInterpolate ( bool value )

virtual

Implements btCharacterControllerInterface.

Definition at line 767 of file btKinematicCharacterController.cpp.

void btKinematicCharacterController::setUseGhostSweepTest ( bool useGhostObjectSweepTest )

inline

Definition at line 161 of file btKinematicCharacterController.h.

void btKinematicCharacterController::setVelocityForTimeInterval	(	const btVector3 &	velocity,
		btScalar	timeInterval
	)

virtual

Caller provides a velocity with which the character should move for the given time period.

After the time period, velocity is reset to zero. This call will reset any walk direction set by setWalkDirection(). Negative time intervals will result in no motion.

Implements btCharacterControllerInterface.

Definition at line 565 of file btKinematicCharacterController.cpp.

void btKinematicCharacterController::setWalkDirection ( const btVector3 & walkDirection )

virtual

This should probably be called setPositionIncrementPerSimulatorStep.

This is neither a direction nor a velocity, but the amount to increment the position each simulation iteration, regardless of dt. This call will reset any velocity set by setVelocityForTimeInterval().

Implements btCharacterControllerInterface.

Definition at line 553 of file btKinematicCharacterController.cpp.

void btKinematicCharacterController::stepDown	(	btCollisionWorld *	collisionWorld,
		btScalar	dt
	)

protected

Definition at line 416 of file btKinematicCharacterController.cpp.

void btKinematicCharacterController::stepForwardAndStrafe	(	btCollisionWorld *	collisionWorld,
		const btVector3 &	walkMove
	)

protected

Definition at line 326 of file btKinematicCharacterController.cpp.

void btKinematicCharacterController::stepUp ( btCollisionWorld * collisionWorld )

protected

Definition at line 244 of file btKinematicCharacterController.cpp.

virtual void btKinematicCharacterController::updateAction	(	btCollisionWorld *	collisionWorld,
		btScalar	deltaTime
	)

inlinevirtual

btActionInterface interface

Implements btActionInterface.

Definition at line 106 of file btKinematicCharacterController.h.

void btKinematicCharacterController::updateTargetPositionBasedOnCollision	(	const btVector3 &	hit_normal,
		btScalar	tangentMag = `btScalar(0.0)`,
		btScalar	normalMag = `btScalar(1.0)`
	)