Difference between revisions of "love.image.newImageData"

(It took me way too long to figure this out so hopefully this will help someone.)
(add optional string argument containing raw pixel data to the width/height variant of love.image.newImageData.)
Line 11: Line 11:
 
=== Returns ===
 
=== Returns ===
 
{{param|ImageData|imageData|The new blank ImageData object. Each pixel's color values, (including the alpha values!) will be set to zero.}}
 
{{param|ImageData|imageData|The new blank ImageData object. Each pixel's color values, (including the alpha values!) will be set to zero.}}
 +
== Function ==
 +
{{newin|[[0.10.0]]|100|type=variant}}
 +
=== Synopsis ===
 +
<source lang="lua">
 +
imageData = love.image.newImageData( width, height, data )
 +
</source>
 +
=== Arguments ===
 +
{{param|number|width|The width of the ImageData.}}
 +
{{param|number|height|The height of the ImageData.}}
 +
{{param|string|data|The data to load into the ImageData.}}
 +
=== Returns ===
 +
{{param|ImageData|imageData|The new ImageData object.}}
 
== Function ==
 
== Function ==
 
=== Synopsis ===
 
=== Synopsis ===

Revision as of 00:24, 4 January 2016

Creates a new ImageData object.

O.png 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.

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


Other Languages