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 11.0
|
| This variant is not supported in earlier versions.
|
Synopsis
imageData = love.image.newImageData( width, height, format, rawdata )
Arguments
number width- The width of the ImageData.
number height- The height of the ImageData.
PixelFormat format ("rgba8")- The pixel format of the ImageData.
string or Data rawdata (nil)- Optional raw byte data to load into the ImageData, in the format specified by format.
Returns
ImageData imageData- The new ImageData object.
Function
| Available since LÖVE 0.10.0 and removed in LÖVE 11.0
|
| This variant is not supported in earlier or later versions.
|
Synopsis
imageData = love.image.newImageData( width, height, rawdata )
Arguments
number width- The width of the ImageData.
number height- The height of the ImageData.
string rawdata- 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.
Function
| Available since LÖVE 11.0
|
| This variant is not supported in earlier versions.
|
Synopsis
imageData = love.image.newImageData( encodeddata )
Arguments
Data encodeddata- The encoded data to load into the ImageData.
Returns
ImageData imageData- The new ImageData object.
See Also
Other Languages
