{{oldin|[[0.8.0]]|080|type=function}}
Checks whether a line segment intersects a shape.
This function will either return the "time" of impact and the surface normal at the point of collision, or nil if the line does not intersect the shape. The "time" is a value between 0.0 and 1.0 and can be used to calculate where the collision occured.
== Function ==
=== Synopsis ===
<source lang="lua">
t, xn, yn = Shape:testSegment( x1, y1, x2, y2 )
</source>
=== Arguments ===
{{param|number|x1|The x-component of the first endpoint.}}
{{param|number|y1|The y-component of the first endpoint.}}
{{param|number|x2|The x-component of the second endpoint.}}
{{param|number|y2|The y-component of the second endpoint.}}
=== Returns ===
{{param|number|t|The time of impact, or nil if no impact.}}
{{param|number|xn|The x-component of the surface normal.}}
{{param|number|yn|The y-component of the surface normal.}}
== See Also ==
* [[parent::Shape]]
[[Category:Functions]]
{{#set:Description=Checks whether a line segment intersects a shape.}}
{{#set:Since=000}}
== Other Languages ==
{{i18n|Shape:testSegment}}