love.graphics.points

Available since LÖVE 0.10.0
It has replaced love.graphics.point.

Draws one or more points.

Function

Synopsis

love.graphics.points( x, y, ... )

Arguments

number x

The position of the first point on the x-axis.

number y

The position of the first point on the y-axis.

number ...

The x and y coordinates of additional points.

Returns

Nothing.

Function

Synopsis

love.graphics.points( points )

Arguments

table points

A table containing multiple point positions, in the form of {x, y, ...}.

number x

The position of the first point on the x-axis.

number y

The position of the first point on the y-axis.

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

love.graphics.points( points )

Arguments

table points

A table containing multiple individually colored points, in the form of {point, ...}.

table point

A table containing the position and color of the first point, in the form of {x, y, r, g, b, a}. The color components are optional.

table ...

Additional tables containing the position and color of more points, in the form of {x, y, r, g, b, a}. 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 size is always in pixels.

Examples

Render a starfield

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

See Also

• love.graphics
• love.graphics.setPointSize