love.physics

Can simulate 2D rigid body physics in a realistic manner. This module is based on Box2D, and this API corresponds to the Box2D API as closely as possible.

O.png love.physics is not lightweight, and not even remotely simple to use. It's a ten-ton hammer designed for heavy-lifting (er...hammer...lifting?).

If you are just trying to make a character jump around on blocks or the likes, then move along, nothing to see here.

 

Types

Body Bodies are objects with velocity and position.
ChainShape A ChainShape consists of multiple line segments.
CircleShape Circle extends Shape and adds a radius and a local position.
Contact Contacts are objects created to manage collisions in worlds.
EdgeShape EdgeShape is a line segment.
Fixture Fixtures attach shapes to bodies.
Joint Attach multiple bodies together to interact in unique ways.
PolygonShape Polygon is a convex polygon with up to 8 sides.
Shape Shapes are objects used to control mass and collisions.
World A world is an object that contains all bodies and joints.

Functions

love.physics.getDistance Returns the two closest points between two fixtures and their distance.
love.physics.getMeter Returns the meter scale factor.
love.physics.newBody Creates a new body.
love.physics.newChainShape Creates a new ChainShape.
love.physics.newCircleShape Creates a circle shape.
love.physics.newDistanceJoint Creates a distance joint between two bodies.
love.physics.newEdgeShape Creates a new EdgeShape.
love.physics.newFixture Creates and attaches a fixture.
love.physics.newFrictionJoint A FrictionJoint applies friction to a body.
love.physics.newGearJoint Create a gear joint connecting two joints.
love.physics.newMouseJoint Create a joint between a body and the mouse.
love.physics.newPolygonShape Creates a new PolygonShape.
love.physics.newPrismaticJoint Creates a prismatic joints between two bodies.
love.physics.newPulleyJoint Creates a pulley joint to join two bodies to each other and the ground.
love.physics.newRectangleShape Shorthand for creating rectangluar PolygonShapes.
love.physics.newRevoluteJoint Creates a pivot joint between two bodies.
love.physics.newRopeJoint Creates a joint between two bodies that enforces a max distance between them.
love.physics.newWeldJoint A WeldJoint essentially glues two bodies together.
love.physics.newWheelJoint Creates a wheel joint.
love.physics.newWorld Creates a new World.
love.physics.setMeter Sets the meter scale factor.

Enums

BodyType The types of a Body.

See Also


Other Languages

Personal tools