Difference between revisions of "love.graphics.newImage"

m (ImageData clarification)
(Converted "power of 2 syndrome" to an article link.)
Line 1: Line 1:
 
Creates a new [[Image]] from a filepath or an opened [[File]] or an [[ImageData]].
 
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 [[PO2_Syndrome|power of 2 syndrome]] on many computers with lower end graphics.}}
 
{{newobjectnotice}}
 
{{newobjectnotice}}
 
== Function ==
 
== Function ==

Revision as of 08:05, 3 October 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. The Image uses a copy of this data, so later changes to the ImageData will not affect this Image.

Returns

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

See Also


Other Languages