# (Image):getData

Available since LÖVE 0.9.0
This function is not supported in earlier versions.

Gets the original ImageData or CompressedData used to create the Image.

All Images keep a reference to the Data that was used to create the Image. The Data is used to refresh the Image when love.window.setMode or Image:refresh is called.

## Function

### Synopsis

    data = Image:getData( )

### Arguments

None.

### Returns

`ImageData data`
  The original ImageData used to create the Image, if the image is not compressed.

## Function

### Synopsis

    data = Image:getData( )

### Arguments

None.

### Returns

`CompressedData data`
  The original CompressedData used to create the Image, if the image is compressed.

## Examples

Edit the Image's ImageData and refresh the Image using the edited ImageData.

    function love.load()
        image = love.graphics.newImage("pig.png")
    end

    function love.draw()
        love.graphics.draw(image)
    end

    function love.keypressed(key)
        -- If the image is compressed, it will return CompressedData which doesn't have a mapPixel method.
        -- Currently only dds files can become compressed images.
        if key == "e" and not image:isCompressed() then
            local data = image:getData()
            data:mapPixel(function(x, y, r, g, b, a) return r/2, g/2, b/2, a/2 end)
            image:refresh()
        end
    end

## See Also

- Image
- Image:refresh
- Image:isCompressed

##

Category:

- Functions