B2.PulleyJoint

From GiderosMobile
This page contains changes which are not marked for translation.


Supported platforms: Platform android.pngPlatform ios.pngPlatform mac.pngPlatform pc.pngPlatform html5.pngPlatform winrt.pngPlatform win32.png
Available since: Gideros 2011.6
Inherits from: b2.Joint

Description

The pulley joint is connected to two bodies and two fixed ground points. The pulley supports a ratio such that: length1 ratio * length2 <= constant Yes, the force transmitted is scaled by the ratio. The pulley also enforces a maximum length limit on both sides. This is useful to prevent one side of the pulley hitting the top.

Examples

Pulley joint

--create empty box2d body for joint
local ground = world:createBody({})

local jointDef = b2.createPulleyJointDef(body1, body2, 
	200, 100, --coordinates where "imaginary string" is attached in the air for body 1
	350, 100, --coordinates where "imaginary string" is attached in the air for body 2
	200, 300, --coordinates where "imaginary string" is attached to the body 1
	350, 300, --coordinates where "imaginary string" is attached in the body 2
	1) -- ratio (if < 1 -> makes body 2 heavier, > 1 makes body 1 heavier, =1 makes them equal
local pulleyJoint = world:createJoint(jointDef)

Methods

b2.PulleyJoint:getGroundAnchorA returns the x and y coordinates of the first ground anchor
b2.PulleyJoint:getGroundAnchorB returns the x and y coordinates of the second ground anchor
b2.PulleyJoint:getLengthA returns the current length of the segment attached to bodyA
b2.PulleyJoint:getLengthB returns the current length of the segment attached to bodyB
b2.PulleyJoint:getRatio returns the joint ratio

Events

Constants