Difference between revisions of "love.physics.newPrismaticJoint"

m
(Moved 0.8.0 variant and added the second.)
Line 1: Line 1:
Create a prismatic joints between two bodies.
+
Creates a prismatic joints 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.
 
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.
  
 
== Function ==
 
== Function ==
 +
{{newin|[[0.8.0]]|type=variants|plural=yes}}
 
=== Synopsis ===
 
=== Synopsis ===
 
<source lang="lua">
 
<source lang="lua">
joint = love.physics.newPrismaticJoint( body1, body2, x, y, ax, ay )
+
joint = love.physics.newPrismaticJoint( body1, body2, x, y, ax, ay, collideConnected )
 
</source>
 
</source>
 
=== Arguments ===
 
=== Arguments ===
Line 15: Line 16:
 
{{param|number|ax|The x coordinate of the axis vector.}}
 
{{param|number|ax|The x coordinate of the axis vector.}}
 
{{param|number|ay|The y 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 ===
 
=== Returns ===
 
{{param|PrismaticJoint|joint|The new prismatic joint.}}
 
{{param|PrismaticJoint|joint|The new prismatic joint.}}
 +
 
== Function ==
 
== Function ==
{{newin|[[0.8.0]]|type=variant}}
 
 
=== Synopsis ===
 
=== Synopsis ===
 
<source lang="lua">
 
<source lang="lua">
joint = love.physics.newPrismaticJoint( body1, body2, x, y, ax, ay, collideConnected )
+
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|x1|The x coordinate of the second anchor point.}}
 +
{{param|number|y1|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 ==
 +
{{oldin|[[0.8.0]]|type=variant}}
 +
=== Synopsis ===
 +
<source lang="lua">
 +
joint = love.physics.newPrismaticJoint( body1, body2, x, y, ax, ay )
 
</source>
 
</source>
 
=== Arguments ===
 
=== Arguments ===
Line 28: Line 49:
 
{{param|number|x|The x coordinate of the anchor point.}}
 
{{param|number|x|The x coordinate of the anchor point.}}
 
{{param|number|y|The y 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|ax|The x coordinate of the axis unit vector.}}
{{param|number|ay|The y coordinate of the axis 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 ===
 
=== Returns ===
 
{{param|PrismaticJoint|joint|The new prismatic joint.}}
 
{{param|PrismaticJoint|joint|The new prismatic joint.}}
 +
  
 
== See Also ==
 
== See Also ==
Line 38: Line 59:
 
* [[Constructs::PrismaticJoint]]
 
* [[Constructs::PrismaticJoint]]
 
[[Category:Functions]]
 
[[Category:Functions]]
{{#set:Description=Create a prismatic joints between two bodies.}}
+
{{#set:Description=Creates a prismatic joints between two bodies.}}
 
{{#set:Since=000}}
 
{{#set:Since=000}}
 
== Other Languages ==
 
== Other Languages ==
 
{{i18n|love.physics.newPrismaticJoint}}
 
{{i18n|love.physics.newPrismaticJoint}}

Revision as of 22:14, 9 April 2012

Creates a prismatic joints 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 revolute joint, but with translation and force substituted for angle and torque.

Function

Available since LÖVE 0.8.0
These variants are not supported in earlier versions.

Synopsis

joint = love.physics.newPrismaticJoint( body1, body2, x, y, ax, ay, collideConnected )

Arguments

Body body1
The first body to connect with a prismatic joint.
Body body2
The second body to connect with a prismatic joint.
number x
The x coordinate of the anchor point.
number y
The y coordinate of the anchor point.
number ax
The x coordinate of the axis vector.
number ay
The y coordinate of the axis vector.
boolean collideConnected (false)
Specifies whether the two bodies should collide with each other.

Returns

PrismaticJoint joint
The new prismatic joint.

Function

Synopsis

joint = love.physics.newPrismaticJoint( body1, body2, x1, y1, x2, y2, ax, ay, collideConnected )

Arguments

Body body1
The first body to connect with a prismatic joint.
Body body2
The second body to connect with a prismatic joint.
number x1
The x coordinate of the first anchor point.
number y1
The y coordinate of the first anchor point.
number x1
The x coordinate of the second anchor point.
number y1
The y coordinate of the second anchor point.
number ax
The x coordinate of the axis unit vector.
number ay
The y coordinate of the axis unit vector.
boolean collideConnected (false)
Specifies whether the two bodies should collide with each other.

Returns

PrismaticJoint joint
The new prismatic joint.

Function

Removed in LÖVE 0.8.0
This variant is not supported in that and later versions.

Synopsis

joint = love.physics.newPrismaticJoint( body1, body2, x, y, ax, ay )

Arguments

Body body1
The first body to connect with a prismatic joint.
Body body2
The second body to connect with a prismatic joint.
number x
The x coordinate of the anchor point.
number y
The y coordinate of the anchor point.
number ax
The x coordinate of the axis unit vector.
number ay
The y coordinate of the axis unit vector.

Returns

PrismaticJoint joint
The new prismatic joint.


See Also


Other Languages