Creates a [[PrismaticJoint]] between two bodies.

A prismatic joint constrains two bodies to move relatively to each other on a specified axis. It does not allow for relative rotation. Its definition and operation are similar to a [[RevoluteJoint| revolute]] joint, but with translation and force substituted for angle and torque.

[[File:physicsJointPrismatic.png]]

== Function ==
{{newin|[[0.8.0]]|080|type=variant}}
=== Synopsis ===
<source lang="lua">
joint = love.physics.newPrismaticJoint( body1, body2, x, y, ax, ay, collideConnected )
</source>
=== Arguments ===
{{param|Body|body1|The first body to connect with a prismatic joint.}}
{{param|Body|body2|The second body to connect with a prismatic joint.}}
{{param|number|x|The x coordinate of the anchor point.}}
{{param|number|y|The y coordinate of the anchor point.}}
{{param|number|ax|The x coordinate of the axis vector.}}
{{param|number|ay|The y coordinate of the axis vector.}}
{{param|boolean|collideConnected (false)|Specifies whether the two bodies should collide with each other.}}
=== Returns ===
{{param|PrismaticJoint|joint|The new prismatic joint.}}

== Function ==
{{newin|[[0.8.0]]|080|type=variant}}
=== Synopsis ===
<source lang="lua">
joint = love.physics.newPrismaticJoint( body1, body2, x1, y1, x2, y2, ax, ay, collideConnected )
</source>
=== Arguments ===
{{param|Body|body1|The first body to connect with a prismatic joint.}}
{{param|Body|body2|The second body to connect with a prismatic joint.}}
{{param|number|x1|The x coordinate of the first anchor point.}}
{{param|number|y1|The y coordinate of the first anchor point.}}
{{param|number|x2|The x coordinate of the second anchor point.}}
{{param|number|y2|The y coordinate of the second anchor point.}}
{{param|number|ax|The x coordinate of the axis unit vector.}}
{{param|number|ay|The y coordinate of the axis unit vector.}}
{{param|boolean|collideConnected (false)|Specifies whether the two bodies should collide with each other.}}
=== Returns ===
{{param|PrismaticJoint|joint|The new prismatic joint.}}

== Function ==
{{newin|[[0.10.2]]|102|type=variant}}
=== Synopsis ===
<source lang="lua">
joint = love.physics.newPrismaticJoint( body1, body2, x1, y1, x2, y2, ax, ay, collideConnected, referenceAngle )
</source>
=== Arguments ===
{{param|Body|body1|The first body to connect with a prismatic joint.}}
{{param|Body|body2|The second body to connect with a prismatic joint.}}
{{param|number|x1|The x coordinate of the first anchor point.}}
{{param|number|y1|The y coordinate of the first anchor point.}}
{{param|number|x2|The x coordinate of the second anchor point.}}
{{param|number|y2|The y coordinate of the second anchor point.}}
{{param|number|ax|The x coordinate of the axis unit vector.}}
{{param|number|ay|The y coordinate of the axis unit vector.}}
{{param|boolean|collideConnected (false)|Specifies whether the two bodies should collide with each other.}}
{{param|number|referenceAngle (0)|The reference angle between body1 and body2, in radians.}}
=== Returns ===
{{param|PrismaticJoint|joint|The new prismatic joint.}}

== Function ==
{{oldin|[[0.8.0]]|080|type=variant}}
=== Synopsis ===
<source lang="lua">
joint = love.physics.newPrismaticJoint( body1, body2, x, y, ax, ay )
</source>
=== Arguments ===
{{param|Body|body1|The first body to connect with a prismatic joint.}}
{{param|Body|body2|The second body to connect with a prismatic joint.}}
{{param|number|x|The x coordinate of the anchor point.}}
{{param|number|y|The y coordinate of the anchor point.}}
{{param|number|ax|The x coordinate of the axis unit vector.}}
{{param|number|ay|The y coordinate of the axis unit vector.}}
=== Returns ===
{{param|PrismaticJoint|joint|The new prismatic joint.}}


== See Also ==
* [[parent::love.physics]]
* [[Constructs::PrismaticJoint]]
* [[Constructs::Joint]]
[[Category:Functions]]
{{#set:Description=Creates a [[PrismaticJoint]] between two bodies.}}
{{#set:Since=000}}
== Other Languages ==
{{i18n|love.physics.newPrismaticJoint}}