Difference between revisions of "love.graphics.newImage"

m (1 revision: Importing from potato (again).)
m (revise argument name to avoid confusion between the decoded 'imageData' w/ encoded 'data'. Revise description, add more details (may be a bit too long).)
Line 1: Line 1:
 
+
Creates a new [[Image]] from a filepath or an opened [[File]] or an [[ImageData]]. (Note that currently the x and y pixel dimensions of the image must be a power of 2, e.g. 8x8, 128x512, or some graphics cards will not display it because of the [http://www.opengl.org/wiki/NPOT_Texture requirement set in earlier hardware]).
Creates a new Image from a file path. Note that the x and y dimensions of the image must (currently) be a power of 2, or some graphics cards will not display it.
 
 
== Function ==
 
== Function ==
 
=== Synopsis ===
 
=== Synopsis ===
Line 22: Line 21:
 
=== Synopsis ===
 
=== Synopsis ===
 
<source lang="lua">
 
<source lang="lua">
image = love.graphics.newImage( data )
+
image = love.graphics.newImage( imageData )
 
</source>
 
</source>
 
=== Arguments ===
 
=== Arguments ===
{{param|ImageData|data|An ImageData object.}}
+
{{param|ImageData|imageData|An ImageData object.}}
 
=== Returns ===
 
=== Returns ===
 
{{param|Image|image|An Image object which can be drawn on screen.}}
 
{{param|Image|image|An Image object which can be drawn on screen.}}

Revision as of 04:21, 18 August 2010

Creates a new Image from a filepath or an opened File or an ImageData. (Note that currently the x and y pixel dimensions of the image must be a power of 2, e.g. 8x8, 128x512, or some graphics cards will not display it because of the requirement set in earlier hardware).

Function

Synopsis

image = love.graphics.newImage( filename )

Arguments

string filename
The filepath to the image file.

Returns

Image image
An Image object which can be drawn on screen.

Function

Synopsis

image = love.graphics.newImage( file )

Arguments

File file
A File pointing to an image.

Returns

Image image
An Image object which can be drawn on screen.

Function

Synopsis

image = love.graphics.newImage( imageData )

Arguments

ImageData imageData
An ImageData object.

Returns

Image image
An Image object which can be drawn on screen.

See Also