##### Views

- Page
- Discussion
- View source
- History

# (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

## 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

Retrieved from "https://www.love2d.org/wiki/(Image):getData"
Categories: Templates | Functions

##### Personal tools

- Log in

##### Search

##### Toolbox

- What links here
- Related changes
- Special pages
- Printable version
- Permanent link
- Browse properties