NAME
Box2D::b2LineJointDef - Line joint definition.
SYNOPSIS
my $joint_def = Box2D::b2LineJointDef->new();
$joint_def->Initialize( $body_a, $body_b, $anchor, $axis );
$joint_def->enableLimit( 1 );
$joint_def->lowerTranslation( $lower_translation );
$joint_def->upperTranslation( $upper_translation );
$joint_def->enableMotor( 1 );
$joint_def->motorSpeed( $speed );
$joint_def->maxMotorForce( $max_force );
my $joint = $world->CreateJoint( $joint_def );
DESCRIPTION
Line joint definition. This requires defining a line of motion using an axis and an anchor point. The definition uses local anchor points and a local axis so that the initial configuration can violate the constraint slightly. The joint translation is zero when the local anchor points coincide in world space. Using local anchors and a local axis helps when saving and loading a game.
METHODS
new()
Default constructor.
Returns a Box2D::b2LineJointDef
Initialize( $bodyA, $bodyB, $anchor, $axis )
Initialize the bodies, anchors, axis, and reference angle using the world anchor and world axis.
Parameters:
Box2D::b2Body
$bodyA
Box2D::b2Body
$bodyB
Box2D::b2Vec2
$anchor
Box2D::b2Vec2
$axis
enableLimit()
enableLimit( $enableLimit )
Enable/disable the joint limit.
Parameters:
bool
$enableLimit
(optional)
Returns a bool
enableMotor()
enableMotor( $enableMotor )
Enable/disable the joint motor.
Parameters:
bool
$enableMotor
(optional)
Returns a bool
localAnchorA()
localAnchorA( $localAnchorA )
The local anchor point relative to body1's origin.
Parameters:
Box2D::b2Vec2
$localAnchorA
(optional)
Returns a Box2D::b2Vec2
localAnchorB()
localAnchorB( $localAnchorB )
The local anchor point relative to body2's origin.
Parameters:
Box2D::b2Vec2
$localAnchorB
(optional)
Returns a Box2D::b2Vec2
localAxisA()
localAxisA( $localAxisA )
The local translation axis in body1.
Parameters:
Box2D::b2Vec2
$localAxisA
(optional)
Returns a Box2D::b2Vec2
lowerTranslation()
lowerTranslation( $lowerTranslation )
The lower translation limit, usually in meters.
Parameters:
float32
$lowerTranslation
(optional)
Returns a float32
maxMotorForce()
maxMotorForce( $maxMotorForce )
The maximum motor torque, usually in N-m.
Parameters:
float32
$maxMotorForce
(optional)
Returns a float32
motorSpeed()
motorSpeed( $motorSpeed )
The desired motor speed in radians per second.
Parameters:
float32
$motorSpeed
(optional)
Returns a float32
upperTranslation()
upperTranslation( $upperTranslation )
The upper translation limit, usually in meters.
Parameters:
float32
$upperTranslation
(optional)
Returns a float32
SEE ALSO
BUGS
See "BUGS" in Box2D