love.graphics.newImage
Creates a new Image from a filepath, FileData, an ImageData, or a CompressedImageData, and optionally generates or specifies mipmaps for the image.
Version 11.0 updated love.graphics.newImage to treat file names ending with "@2x", "@3x", etc. as a pixel density scale factor if none is explicitly supplied.
|
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
image = love.graphics.newImage( filename, settings )
Arguments
string filename- The filepath to the image file (or a FileData or ImageData or CompressedImageData or ByteData object).
Available since LÖVE 0.10.0
table settings (nil)- Optional table of settings to configure the image, containing the following fields:
boolean 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).
boolean linear (false)- True to treat the image's pixels as linear instead of sRGB, when gamma correct rendering is enabled. Most images are authored as sRGB.
Available since LÖVE 11.0
Returns
Image image- A new Image object which can be drawn on screen.
Function
| Available since LÖVE 0.9.1 and removed in LÖVE 0.10.0 |
| This variant is not supported in earlier or later versions. |
Synopsis
image = love.graphics.newImage( filename, format )
Arguments
string filename- The filepath to the image file (or a FileData or ImageData or CompressedImageData object.)
TextureFormat format- The format to interpret the image's data as.
Returns
Image image- An Image object which can be drawn on screen.
Examples
Draw a bunny on the screen
function love.load()
bunny = love.graphics.newImage("MyBunny.png")
end
function love.draw()
love.graphics.draw(bunny, 0, 0)
end
Load image if it exists
function loadImage (path)
local info = love.filesystem.getInfo( path )
if info then
return love.graphics.newImage( path )
end
end
image = loadImage ("graphics/image-1.png")
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
