Difference between revisions of "love.graphics.newImage"

m
Line 1: Line 1:
 +
Creates a new [[Image]] from a filepath or an opened [[File]] or an [[ImageData]].
 
{{notice|Images are susceptible to [http://love2d.org/wiki/PO2_Syndrome power of 2 syndrome] on many computers with lower end graphics.}}
 
{{notice|Images are susceptible to [http://love2d.org/wiki/PO2_Syndrome power of 2 syndrome] on many computers with lower end graphics.}}
Creates a new [[Image]] from a filepath or an opened [[File]] or an [[ImageData]].
+
{{newobjectnotice}}
 
== Function ==
 
== Function ==
 
=== Synopsis ===
 
=== Synopsis ===

Revision as of 18:28, 27 January 2012

Creates a new Image from a filepath or an opened File or an ImageData.

O.png Images are susceptible to power of 2 syndrome on many computers with lower end graphics.  


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

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


Other Languages