{{newin|[[11.0]]|110|type=function|text=This function replaces [[(Image):refresh|Image:refresh]]}}

Replace the contents of an Image.

== Function ==
=== Synopsis ===
<source lang="lua">
Image:replacePixels( data, slice, mipmap, x, y, reloadmipmaps )
</source>
=== Arguments ===
{{param|ImageData|data|The new [[ImageData]] to replace the contents with.}}
{{param|number|slice|Which [[TextureType|cubemap face, array index, or volume layer]] to replace, if applicable.}}
{{param|number|mipmap (1)|The mimap level to replace, if the Image has mipmaps.}}
{{param|number|x (0)|The x-offset in pixels from the top-left of the image to replace. The given ImageData's width plus this value must not be greater than the pixel width of the Image's specified mipmap level.}}
{{param|number|y (0)|The y-offset in pixels from the top-left of the image to replace. The given ImageData's height plus this value must not be greater than the pixel height of the Image's specified mipmap level.}}
{{param|boolean|reloadmipmaps|Whether to generate new mipmaps after replacing the Image's pixels. True by default if the Image was created with automatically generated mipmaps, false by default otherwise.}}
=== Returns ===
Nothing.

== Examples ==
<source lang="lua">
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:replacePixels(imagedata)
    end
end
</source>

== See Also ==
* [[parent::Image]]
[[Category:Functions]]
{{#set:Description=Replace the contents of an Image.}}
== Other Languages ==
{{i18n|(Image):replacePixels}}