Difference between revisions of "love.graphics.polygon"

m (Moved example image to a better place)
Line 26: Line 26:
 
== Examples ==
 
== Examples ==
 
=== Two ways of drawing the same triangle ===
 
=== Two ways of drawing the same triangle ===
 +
[[File:Polygon_triangle.png|400px|thumb|right|Triangle drawn using love.graphics.polygon]]
 
This example shows how to give the coordinates explicitly and how to pass a table argument.
 
This example shows how to give the coordinates explicitly and how to pass a table argument.
 
<source lang="lua">
 
<source lang="lua">
Line 38: Line 39:
 
love.graphics.polygon('fill', vertices)
 
love.graphics.polygon('fill', vertices)
 
</source>
 
</source>
 
[[File:Polygon_triangle.png|400px|thumb|none|Triangle drawn using love.graphics.polygon]]
 
  
 
== See Also ==
 
== See Also ==

Revision as of 20:51, 3 November 2016

Draw a polygon.

Following the mode argument, this function can accept multiple numeric arguments or a single table of numeric arguments. In either case the arguments are interpreted as alternating x and y coordinates of the polygon's vertices.

O.png When in fill mode, the polygon must be convex and simple or rendering artifacts may occur. love.math.triangulate and love.math.isConvex can be used in 0.9.0+.  


Function

Synopsis

love.graphics.polygon( mode, ... )

Arguments

DrawMode mode
How to draw the polygon.
number ...
The vertices of the polygon.

Returns

Nothing.

Function

Synopsis

love.graphics.polygon( mode, vertices )

Arguments

DrawMode mode
How to draw the polygon.
table vertices
The vertices of the polygon as a table.

Returns

Nothing.

Examples

Two ways of drawing the same triangle

Triangle drawn using love.graphics.polygon

This example shows how to give the coordinates explicitly and how to pass a table argument.

-- giving the coordinates directly
love.graphics.polygon('fill', 100, 100, 200, 100, 150, 200)

-- defining a table with the coordinates
-- this table could be built incrementally too
local vertices = {100, 100, 200, 100, 150, 200}

-- passing the table to the function as a second argument
love.graphics.polygon('fill', vertices)

See Also



Other Languages