Creates a new [[Image]] from a filepath, [[FileData]], an [[ImageData]], or a [[CompressedImageData]], and optionally generates or specifies mipmaps for the image.
{{newobjectnotice}}
== Function ==
=== Synopsis ===
<source lang="lua">
image = love.graphics.newImage( filename )
</source>
=== Arguments ===
{{param|string|filename|The filepath to the image file.}}
=== Returns ===
{{param|Image|image|An Image object which can be drawn on screen.}}

== Function ==
=== Synopsis ===
<source lang="lua">
image = love.graphics.newImage( imageData )
</source>
=== Arguments ===
{{param|ImageData|imageData|An ImageData object. The Image will use this ImageData to reload itself when [[love.window.setMode]] is called.}}
=== Returns ===
{{param|Image|image|An Image object which can be drawn on screen.}}

== Function ==
{{newin|[[0.9.0]]|090|type=variant}}
=== Synopsis ===
<source lang="lua">
image = love.graphics.newImage( compressedImageData )
</source>
=== Arguments ===
{{param|CompressedImageData|compressedImageData|A CompressedImageData object. The Image will use this CompressedImageData to reload itself when [[love.window.setMode]] is called.}}
=== Returns ===
{{param|Image|image|An Image object which can be drawn on screen.}}

== Function ==
{{newin|[[0.10.0]]|100|type=variant}}
=== Synopsis ===
<source lang="lua">
image = love.graphics.newImage( filename, flags )
</source>
=== Arguments ===
{{param|string|filename|The filepath to the image file (or a [[FileData]] or [[ImageData]] or [[CompressedImageData]] or [[ByteData]] object).}}
{{param|table|flags|A table containing the following fields:}}
{{subparam|boolean|linear (false)|True if the image's pixels should be interpreted as being linear RGB rather than sRGB-encoded, if [[love.graphics.isGammaCorrect|gamma-correct rendering]] is enabled. Has no effect otherwise.}}
{{subparam|boolean or table|mipmaps (false)|If true, mipmaps for the image will be automatically generated (or taken from the images's file if possible, if the image originated from a [[CompressedImageData]]). If this value is a table, it should contain a list of other filenames of images of the same format that have progressively half-sized dimensions, all the way down to 1x1. Those images will be used as this Image's mipmap levels.}}

=== Returns ===
{{param|Image|image|A new Image object which can be drawn on screen.}}

== Function ==
{{newinoldin|[[0.9.1]]|091|[[0.10.0]]|100|type=variant}}
=== Synopsis ===
<source lang="lua">
image = love.graphics.newImage( filename, format )
</source>
=== Arguments ===
{{param|string|filename|The filepath to the image file (or a [[FileData]] or [[ImageData]] or [[CompressedImageData]] object.)}}
{{param|TextureFormat|format|The format to interpret the image's data as.}}
=== Returns ===
{{param|Image|image|An Image object which can be drawn on screen.}}

== See Also ==
* [[parent::love.graphics]]
* [[Constructs::Image]]
[[Category:Functions]]
[[Sub-Category::Object Creation| ]]
{{#set:Description=Creates a new [[Image]].}}
{{#set:Since=000}}
== Other Languages ==
{{i18n|love.graphics.newImage}}