(Image):refresh

Available since LÖVE 0.9.0 and removed in LÖVE 11.0
It has been replaced by Image:replacePixels.

Reloads the Image's contents from the ImageData or CompressedData used to create the image.

Function

Synopsis

Image:refresh( )

Arguments

None.

Returns

Nothing.

Function

Available since LÖVE 0.10.0 and removed in LÖVE 11.0
It has been replaced by Image:replacePixels.

Synopsis

Image:refresh( x, y, width, height )

Arguments

number x
The x-axis of the top-left corner of the area within the Image to reload.
number y
The y-axis of the top-left corner of the area within the Image to reload.
number width
The width of the area within the Image to reload.
number height
The height of the area within the Image to reload.

Returns

Nothing.

Examples

function love.load()
    imagedata = love.image.newImageData("pig.png")
    image = love.graphics.newImage(imagedata)
end
 
function love.draw()
    love.graphics.draw(image)
end
 
function love.keypressed(key)
    if key == "e" then
        -- Modify the original ImageData and apply the changes to the Image.
        imagedata:mapPixel(function(x, y, r, g, b, a) return r/2, g/2, b/2, a/2 end)
        image:refresh()
    end
end

See Also

© 2006–2020 LÖVE Development Team
Licensed under the GNU Free Documentation License, Version 1.3.
https://love2d.org/wiki/(Image):refresh