LÖVE Documentation 0.4.0

Module

love.physics

The physics module is capable of deteting collisions between objects, and simulate a realistic responses.

The module is currently based on Box2D. The original naming scheme is kept, and most of the functionality avaliable in Box2D is avaliable in LÖVE, so you can also take a look at the Box2D User Manual for detailed documentation.

Some limitations to keep in mind:

Only convex shapes are supported.
The max vertex count for on a single polygon is 8.
There are 16 shape categories.

Types

World	Contains all Bodies and joints.
Contact	Represents a contact point between two shapes.
Body	A Body is a physical entity with position and orientation.

CircleShape	A simple circle which can be attatched to Bodies.
PolygonShape	Convex polygon which can be attatched to Bodies.

DistanceJoint	Maintains a certain distance between Bodies.
RevoluteJoint	Allow two Bodies to revolve around a shared point.
PrismaticJoint	Restricts relative motion between Bodies to one shared axis.
MouseJoint	For controlling objects with the mouse.

Functions

newWorld( w, h )	Creates a new World.
newWorld( lx, ly, ux, uy, gx, gy, sleep )	Creates a new World.

newBody( world )	Creates a new Body.
newBody( world, x, y )	Creates a new Body with some position.
newBody( world, x, y, m )	Creates a new Body with some position and mass.

newCircleShape( body, radius )	Creates a new CircleShape.
newCircleShape( body, x, y, radius )	Creates a new CircleShape with an offset.

newRectangleShape( body, w, h )	Creates a rectangle.
newRectangleShape( body, x, x, w, h )	Creates a new rectangle with an offset.
newRectangleShape( body, x, x, w, h, angle )	Creates a new rectangle with offset and orientation.

newPolygonShape( body, ... )	Creates a new PolygonShape.

newDistanceJoint( body1, body2, x1, y1, x2, y2 )	Creates a new DistanceJoint.
newRevoluteJoint( body1, body2, x, y )	Creates a new RevoluteJoint.
newPrismaticJoint( body1, body2, x, y, ax, ay )	Creates a new PrismaticJoint.
newMouseJoint( body, x, y )	Creates a new MouseJoint

Examples

Example 100: Filler

angle = 0

function load()
    image = love.graphics.newImage("images/love-ball.png", love.image_optimize)
end

function update(dt)
    angle = angle + dt
    x, y = 400 + math.cos(angle)*100, 300 + math.sin(angle)*100
end

function draw()
    local rot = angle*180/math.pi
    local sx = math.cos(angle)*3
    local sy = math.sin(angle)*2
    love.graphics.draw(image, x, y, rot, sx, sy)
end

Visit homepage - Help improve the manual