Creates a [[PulleyJoint]] to join two bodies to each other and the ground.

The pulley joint simulates a pulley with an optional block and tackle. If the ratio parameter has a value different from one, then the simulated rope extends faster on one side than the other. In a pulley joint the total length of the simulated rope is the constant <tt>length1 + ratio * length2</tt>, which is set when the pulley joint is created.

Pulley joints can behave unpredictably if one side is fully extended. It is recommended that the method [[PulleyJoint:setMaxLengths | setMaxLengths ]] be used to constrain the maximum lengths each side can attain.

[[File:physicsJointPulley.png]]

== Function ==
{{newin|[[0.8.0]]|080|type=variant}}
=== Synopsis ===
<source lang="lua">
joint = love.physics.newPulleyJoint( body1, body2, gx1, gy1, gx2, gy2, x1, y1, x2, y2, ratio, collideConnected )
</source>
=== Arguments ===
{{param|Body|body1|The first body to connect with a pulley joint.}}
{{param|Body|body2|The second body to connect with a pulley joint.}}
{{param|number|gx1|The x coordinate of the first body's ground anchor.}}
{{param|number|gy1|The y coordinate of the first body's ground anchor.}}
{{param|number|gx2|The x coordinate of the second body's ground anchor.}}
{{param|number|gy2|The y coordinate of the second body's ground anchor.}}
{{param|number|x1|The x coordinate of the pulley joint anchor in the first body.}}
{{param|number|y1|The y coordinate of the pulley joint anchor in the first body.}}
{{param|number|x2|The x coordinate of the pulley joint anchor in the second body.}}
{{param|number|y2|The y coordinate of the pulley joint anchor in the second body.}}
{{param|number|ratio (1)|The joint ratio.}}
{{param|boolean|collideConnected (true)|Specifies whether the two bodies should collide with each other.}}
=== Returns ===
{{param|PulleyJoint|joint|The new pulley joint.}}

== Function ==
{{oldin|[[0.8.0]]|080|type=variant}}
=== Synopsis ===
<source lang="lua">
joint = love.physics.newPulleyJoint( body1, body2, gx1, gy1, gx2, gy2, x1, y1, x2, y2, ratio )
</source>
=== Arguments ===
{{param|Body|body1|The first body to connect with a pulley joint.}}
{{param|Body|body2|The second body to connect with a pulley joint.}}
{{param|number|gx1|The x coordinate of the first body's ground anchor.}}
{{param|number|gy1|The y coordinate of the first body's ground anchor.}}
{{param|number|gx2|The x coordinate of the second body's ground anchor.}}
{{param|number|gy2|The y coordinate of the second body's ground anchor.}}
{{param|number|x1|The x coordinate of the pulley joint anchor in the first body.}}
{{param|number|y1|The y coordinate of the pulley joint anchor in the first body.}}
{{param|number|x2|The x coordinate of the pulley joint anchor in the second body.}}
{{param|number|y2|The y coordinate of the pulley joint anchor in the second body.}}
{{param|number|ratio (1)|The joint ratio.}}
=== Returns ===
{{param|PulleyJoint|joint|The new pulley joint.}}

== See Also ==
* [[parent::love.physics]]
* [[Constructs::PulleyJoint]]
* [[Constructs::Joint]]
[[Category:Functions]]
{{#set:Description=Creates a [[PulleyJoint]] to join two bodies to each other and the ground.}}
{{#set:Since=000}}
== Other Languages ==
{{i18n|love.physics.newPulleyJoint}}