Difference between revisions of "love.image.newImageData"
m (i'll stop here since i'm not sure if these "lower level" ones are used as often) |
m |
||
| (22 intermediate revisions by 9 users not shown) | |||
| Line 1: | Line 1: | ||
| − | + | Creates a new [[ImageData]] object. | |
{{newobjectnotice}} | {{newobjectnotice}} | ||
== Function == | == Function == | ||
=== Synopsis === | === Synopsis === | ||
<source lang="lua"> | <source lang="lua"> | ||
| − | imageData = love.image.newImageData( | + | imageData = love.image.newImageData( width, height, format, rawdata ) |
</source> | </source> | ||
=== Arguments === | === Arguments === | ||
| − | {{param|number| | + | {{param|number|width|The width of the ImageData.}} |
| − | {{param|number| | + | {{param|number|height|The height of the ImageData.}} |
| + | {{New feature|11.0| | ||
| + | {{param|PixelFormat|format ("rgba8")|The pixel format of the ImageData.}} | ||
| + | {{param|string or Data|rawdata (nil)|Optional raw byte data to load into the ImageData, in the format specified by ''format''.}} | ||
| + | |110}} | ||
=== Returns === | === Returns === | ||
| − | {{param|ImageData|imageData|The new ImageData object.}} | + | {{param|ImageData|imageData|The new ImageData object. If data isn't supplied, each pixel's color values (including the alpha values!) will be set to zero.}} |
| + | |||
== Function == | == Function == | ||
=== Synopsis === | === Synopsis === | ||
| Line 20: | Line 25: | ||
=== Returns === | === Returns === | ||
{{param|ImageData|imageData|The new ImageData object.}} | {{param|ImageData|imageData|The new ImageData object.}} | ||
| + | |||
| + | == Function == | ||
| + | === Synopsis === | ||
| + | <source lang="lua"> | ||
| + | imageData = love.image.newImageData( filedata ) | ||
| + | </source> | ||
| + | === Arguments === | ||
| + | {{param|FileData|filedata|The encoded file data to decode into image data.}} | ||
| + | === Returns === | ||
| + | {{param|ImageData|imageData|The new ImageData object.}} | ||
| + | |||
| + | == Function == | ||
| + | {{newin|[[11.0]]|110|type=variant}} | ||
| + | === Synopsis === | ||
| + | <source lang="lua"> | ||
| + | imageData = love.image.newImageData( encodeddata ) | ||
| + | </source> | ||
| + | === Arguments === | ||
| + | {{param|Data|encodeddata|The encoded data to load into the ImageData.}} | ||
| + | === Returns === | ||
| + | {{param|ImageData|imageData|The new ImageData object.}} | ||
| + | |||
== Function == | == Function == | ||
| + | {{newinoldin|[[0.10.0]]|100|[[11.0]]|110|type=variant}} | ||
=== Synopsis === | === Synopsis === | ||
<source lang="lua"> | <source lang="lua"> | ||
| − | imageData = love.image.newImageData( | + | imageData = love.image.newImageData( width, height, rawdata ) |
</source> | </source> | ||
=== Arguments === | === Arguments === | ||
| − | {{param| | + | {{param|number|width|The width of the ImageData.}} |
| + | {{param|number|height|The height of the ImageData.}} | ||
| + | {{param|string|rawdata|The data to load into the ImageData (RGBA bytes, left to right and top to bottom).}} | ||
=== Returns === | === Returns === | ||
{{param|ImageData|imageData|The new ImageData object.}} | {{param|ImageData|imageData|The new ImageData object.}} | ||
| + | |||
== See Also == | == See Also == | ||
* [[parent::love.image]] | * [[parent::love.image]] | ||
* [[Constructs::ImageData]] | * [[Constructs::ImageData]] | ||
| + | * [[love.graphics.newImage]] | ||
[[Category:Functions]] | [[Category:Functions]] | ||
| − | {{#set:Description= | + | {{#set:Description=Creates a new ImageData object.}} |
{{#set:Since=000}} | {{#set:Since=000}} | ||
| + | |||
== Other Languages == | == Other Languages == | ||
{{i18n|love.image.newImageData}} | {{i18n|love.image.newImageData}} | ||
Latest revision as of 16:20, 24 April 2022
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! |
Contents
Function
Synopsis
imageData = love.image.newImageData( width, height, format, rawdata )
Arguments
Available since LÖVE 11.0
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. If data isn't supplied, each pixel's color values (including the alpha values!) will be set to zero.
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.
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.
See Also
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
