B2.Body

Supported platforms: android, ios, mac, pc
Available since: Gideros 2011.6

Description

A rigid body. These are created via `b2.World:createBody`.

Examples

Creating Box2d body and moving Bitmap along the body

require "box2d"
local world = b2.World.new(0, 10, true)

--create ball bitmap object from ball graphic
local ball = Bitmap.new(Texture.new("ball.png"))
--reference center of the ball for positioning
ball:setAnchorPoint(0.5,0.5)
 
ball:setPosition(100,100)
 
--get radius
local radius = ball:getWidth()/2
 
--create box2d physical object
local body = world:createBody{type = b2.DYNAMIC_BODY}
local circle = b2.CircleShape.new(0, 0, radius)
local fixture = body:createFixture{shape = circle, density = 1.0, 
friction = 0.1, restitution = 0.2}
ball.body = body
 
--add to scene
stage:addChild(ball)

stage:addEventListener(Event.ENTER_FRAME, function()
	-- edit the step values if required. These are good defaults!
    world:step(1/60, 8, 3)
	ball:setPosition(ball.body:getPosition())
	ball:setRotation(math.rad(ball.body:getAngle()))
end)

Methods b2.Body:applyAngularImpulse - applies an angular impulse b2.Body:applyForce - applies a force at a world point b2.Body:applyLinearImpulse - applies an impulse at a point b2.Body:applyTorque - applies a torque b2.Body:createFixture - creates a fixture and attach it to this body b2.Body:destroyFixture - destroys a fixture b2.Body:getAngle - returns the current world rotation angle in radians b2.Body:getAngularDamping - returns the angular damping of the body b2.Body:getAngularVelocity - returns the angular velocity b2.Body:getGravityScale - returns the gravity scale of the body b2.Body:getInertia - returns the rotational inertia of the body about the local origin in kg-m^2 b2.Body:getLinearDamping - returns the linear damping of the body b2.Body:getLinearVelocity - returns the linear velocity of the center of mass b2.Body:getLocalCenter - returns the local position of the center of mass b2.Body:getLocalPoint - b2.Body:getLocalVector - b2.Body:getMass - returns the total mass of the body in kilograms (kg) b2.Body:getPosition - returns the world body origin position b2.Body:getWorldCenter - returns the world position of the center of mass b2.Body:getWorldPoint - b2.Body:getWorldVector - b2.Body:isActive - returns the active state of the body b2.Body:isAwake - returns the sleeping state of the body b2.Body:isBullet - b2.Body:isFixedRotation - b2.Body:isSleepingAllowed - b2.Body:setActive - sets the active state of the body b2.Body:setAngle - b2.Body:setAngularDamping - sets the angular damping of the body b2.Body:setAngularVelocity - sets the angular velocity b2.Body:setAwake - sets the sleep state of the body b2.Body:setBullet - b2.Body:setFixedRotation - b2.Body:setGravityScale - sets the gravity scale of the body b2.Body:setLinearDamping - sets the linear damping of the body b2.Body:setLinearVelocity - sets the linear velocity of the center of mass b2.Body:setPosition - sets the world body origin position b2.Body:setSleepingAllowed -

Events Constants