{{newin|[[0.10.0]]|100|type=function|text=It has replaced [[love.graphics.point]]}}
Draws one or more points.

== Function ==
=== Synopsis ===
<source lang="lua">
love.graphics.points( x, y, ... )
</source>
=== Arguments ===
{{param|number|x|The position of the first point on the x-axis.}}
{{param|number|y|The position of the first point on the y-axis.}}
{{param|number|...|The x and y coordinates of additional points.}}
=== Returns ===
Nothing.

== Function ==
=== Synopsis ===
<source lang="lua">
love.graphics.points( points )
</source>
=== Arguments ===
{{param|table|points|A table containing multiple point positions, in the form of <code>{x, y, ...}</code>.}}
{{subparam|number|x|The position of the first point on the x-axis.}}
{{subparam|number|y|The position of the first point on the y-axis.}}
{{subparam|number|...|The x and y coordinates of additional points.}}
=== Returns ===
Nothing.

== Function ==
Draws one or more individually colored points.

In versions prior to [[11.0]], color component values were within the range of 0 to 255 instead of 0 to 1.
=== Synopsis ===
<source lang="lua">
love.graphics.points( points )
</source>
=== Arguments ===
{{param|table|points|A table containing multiple individually colored points, in the form of <code>{point, ...}</code>.}}
{{subparam|table|point|A table containing the position and color of the first point, in the form of <code>{x, y, r, g, b, a}</code>. The color components are optional.}}
{{subparam|table|...|Additional tables containing the position and color of more points, in the form of <code>{x, y, r, g, b, a}</code>. The color components are optional.}}
=== Returns ===
Nothing.
=== Notes ===
The global color set by [[love.graphics.setColor]] is modulated (multiplied) with the per-point colors.

== Notes ==
The pixel grid is actually offset to the center of each pixel. So to get clean pixels drawn use 0.5 + integer increments.

Points are not affected by [[love.graphics.scale]] - their [[love.graphics.setPointSize|size]] is always in pixels.

== Examples ==
Render a starfield
<source lang="lua">
function love.load()
   local screen_width, screen_height = love.graphics.getDimensions()
   local max_stars = 100   -- how many stars we want

   stars = {}   -- table which will hold our stars

   for i=1, max_stars do   -- generate the coords of our stars
      local x = love.math.random(5, screen_width-5)   -- generate a "random" number for the x coord of this star
      local y = love.math.random(5, screen_height-5)   -- both coords are limited to the screen size, minus 5 pixels of padding
      stars[i] = {x, y}   -- stick the values into the table
   end
end

function love.draw()
   love.graphics.points(stars)  -- draw all stars as points
end
</source>

== See Also ==
* [[parent::love.graphics]]
* [[love.graphics.setPointSize]]
[[Category:Functions]]
[[Sub-Category::Drawing| ]]
{{#set:Description=Draws one or more points.}}
== Other Languages ==
{{i18n|love.graphics.points}}