love.image.newImageData

love.image.newImageData

Creates a new ImageData object.

This function can be slow if it is called repeatedly, such as from love.update or love.draw. If you need to use a specific resource often, create it once and store it somewhere it can be reused!

Function

Synopsis

imageData = love.image.newImageData( width, height )

Arguments

number width

The width of the ImageData.

number height

The height of the ImageData.

Returns

ImageData imageData

The new blank ImageData object. Each pixel's color values, (including the alpha values!) will be set to zero.

Function

Available since LÖVE 0.10.0
This variant is not supported in earlier versions.

Synopsis

imageData = love.image.newImageData( width, height, data )

Arguments

number width

The width of the ImageData.

number height

The height of the ImageData.

string data

The data to load into the ImageData (RGBA bytes, left to right and top to bottom).

Returns

ImageData imageData

The new ImageData object.

Function

Synopsis

imageData = love.image.newImageData( filename )

Arguments

string filename

The filename of the image file.

Returns

ImageData imageData

The new ImageData object.

Function

Synopsis

imageData = love.image.newImageData( filedata )

Arguments

FileData filedata

The encoded file data to decode into image data.

Returns

ImageData imageData

The new ImageData object.

See Also

• love.image
• ImageData