NAME
Box2D::b2Fixture - Used to attach a shape to a body for collision detection.
SYNOPSIS
my $fixture = $body->CreateFixture( $shape, $density );
DESCRIPTION
A fixture is used to attach a shape to a body for collision detection. A fixture inherits its transform from its parent. Fixtures hold additional non-geometric data such as friction, collision filters, etc. Fixtures are created via Box2D::b2Body::CreateFixture
.
Warning: you cannot reuse fixtures.
METHODS
GetBody()
Get the parent body of this fixture. This is NULL if the fixture is not attached.
Returns a Box2D::b2Body
- the parent body.
GetDensity()
Get the density of this fixture.
Returns a float32
GetFriction()
Get the coefficient of friction.
Returns a float32
GetNext()
Get the next fixture in the parent body's fixture list.
Returns a Box2D::b2Fixture
- the next shape.
GetRestitution()
Get the coefficient of restitution.
Returns a float32
GetShape()
Get the child shape. You can modify the child shape, however you should not change the number of vertices because this will crash some collision caching mechanisms. Manipulating the shape may lead to non-physical behavior.
Returns a Box2D::b2Shape
GetUserData()
Get the user data that was assigned in the fixture definition. Use this to store your application specific data.
Returns a scalar
IsSensor()
Is this fixture a sensor (non-solid)?
Returns a bool
- the true if the shape is a sensor.
SetDensity( $density )
Set the density of this fixture. This will _not_ automatically adjust the mass of the body. You must call Box2D::b2Body::ResetMassData
to update the body's mass.
Parameters:
float32
$density
SetFriction( $friction )
Set the coefficient of friction.
Parameters:
float32
$friction
SetRestitution( $restitution )
Set the coefficient of restitution.
Parameters:
float32
$restitution
SetSensor( $sensor )
Set if this fixture is a sensor.
Parameters:
bool
$sensor
SetUserData( $data )
Set the user data. Use this to store your application specific data.
Parameters:
scalar
$data
TestPoint( $p )
Test a point for containment in this fixture.
Parameters:
Box2D::b2Vec2
$p
- a point in world coordinates.
Returns a bool
SEE ALSO
BUGS
See "BUGS" in Box2D