{{newin|[[0.8.0]]|080|type=function}}
Creates a new [[ChainShape]].
{{notice|Due to a limitation of the current collision algorithm, collision with chain shapes can react in a odd manner.  see [[https://code.google.com/p/box2d/issues/detail?id=286 here]]}}
{{notice|Making changes to a [[World]] is not allowed inside of the [[beginContact]], [[endContact]], [[preSolve]], and [[postSolve]] callback functions, as BOX2D locks the world during these callbacks.}}
== Function ==
=== Synopsis ===
<source lang="lua">
shape = love.physics.newChainShape( loop, x1, y1, x2, y2, ... )
</source>
=== Arguments ===
{{param|boolean|loop|If the chain should loop back to the first point.}}
{{param|number|x1|The x position of the first point.}}
{{param|number|y1|The y position of the first point.}}
{{param|number|x2|The x position of the second point.}}
{{param|number|y2|The y position of the second point.}}
{{param|number|...|Additional point positions.}}
=== Returns ===
{{param|ChainShape|shape|The new shape.}}

== Function ==
{{newin|[[0.9.2]]|092|type=variant}}
=== Synopsis ===
<source lang="lua">
shape = love.physics.newChainShape( loop, points )
</source>
=== Arguments ===
{{param|boolean|loop|If the chain should loop back to the first point.}}
{{param|table|points|A list of points to construct the ChainShape, in the form of <code>{x1, y1, x2, y2, ...}</code>.}}
=== Returns ===
{{param|ChainShape|shape|The new shape.}}

== See Also ==
* [[parent::love.physics]]
* [[Constructs::ChainShape]]
* [[Constructs::Shape]]
[[Category:Functions]]
{{#set:Description=Creates a new [[ChainShape]].}}
{{#set:Since=080}}
== Other Languages ==
{{i18n|love.physics.newChainShape}}