ImageData:setPixel

Sets the color of a pixel at a specific position in the image.

Valid x and y values start at 0 and go up to image width and height minus 1.

In versions prior to 11.0, color component values were within the range of 0 to 255 instead of 0 to 1.

This function locks the ImageData until it is done, making it safe to use from multiple Threads, albeit without any performance gains.

Function

Synopsis

ImageData:setPixel( x, y, r, g, b, a )

Arguments

number x

The position of the pixel on the x-axis.

number y

The position of the pixel on the y-axis.

number r

The red component (0-1).

number g

The green component (0-1).

number b

The blue component (0-1).

number a

The alpha component (0-1).

Returns

Nothing.

Examples

Create a 32x1 pixel transparent-to-white gradient drawable image.

data = love.image.newImageData(32,1)
for i=0, 31 do   -- remember: start at 0
   data:setPixel(i, 0, 1, 1, 1, i / 31)
end
img = love.graphics.newImage(data)

See Also

• ImageData
• ImageData:getPixel
• ImageData:mapPixel

Other Languages

Dansk – Deutsch – English – Español – Français – Indonesia – Italiano – Lietuviškai – Magyar – Nederlands – Polski – Português – Română – Slovenský – Suomi – Svenska – Türkçe – Česky – Ελληνικά – Български – Русский – Српски – Українська – עברית – ไทย – 日本語 – 正體中文 – 简体中文 – Tiếng Việt – 한국어
More info