love.graphics.newImage

Создаёт новый Image из пути к файлу, FileData, ImageData или CompressedImageData, а также необязательно генерирует или задаёт mip-мапы для изображения.

Версия 11.0 обновила love.graphics.newImage, чтобы рассматривать имена файлов, заканчивающиеся на «@2x», «@3x» и т.д., как коэффициент масштабирования плотности пикселей, если он не задан явно.

Эта функция может быть медленной, если вызывается многократно, например, из love.update или love.draw. Если вам нужно часто использовать определённый ресурс, создайте его один раз и сохраните где-нибудь для повторного использования!

Функция

Синопсис

image = love.graphics.newImage( filename )

Аргументы

string filename

Путь к файлу изображения.

Возвращаемые значения

Image image

Объект Image, который можно отрисовать на экране.

Функция

Синопсис

image = love.graphics.newImage( imageData )

Аргументы

ImageData imageData

Объект ImageData. Image будет использовать этот ImageData для перезагрузки при вызове love.window.setMode.

Возвращаемые значения

Image image

Объект Image, который можно отрисовать на экране.

Функция

Доступно начиная с LÖVE 0.9.0
Этот вариант не поддерживается в более ранних версиях.

Синопсис

image = love.graphics.newImage( compressedImageData )

Аргументы

CompressedImageData compressedImageData

Объект CompressedImageData. Image будет использовать этот CompressedImageData для перезагрузки при вызове love.window.setMode.

Возвращаемые значения

Image image

Объект Image, который можно отрисовать на экране.

Функция

Доступно начиная с LÖVE 0.10.0
Этот вариант не поддерживается в более ранних версиях.

Синопсис

image = love.graphics.newImage( filename, flags )

Аргументы

string filename

Путь к файлу изображения (или FileData, ImageData, CompressedImageData или ByteData).

table flags

Таблица, содержащая следующие поля:

boolean linear (false)

True, если пиксели изображения должны интерпретироваться как линейные RGB, а не как закодированные в sRGB, если включена гамма-корректировка рендеринга. В противном случае не оказывает никакого влияния.

boolean or table mipmaps (false)

Если true, mip-мапы для изображения будут автоматически сгенерированы (или взяты из файла изображения, если возможно, если изображение взято из CompressedImageData). Если это значение является таблицей, оно должно содержать список других имён файлов изображений того же формата, имеющих размер вполовину меньше, до тех пор, пока не будет достигнут размер 1x1. Эти изображения будут использоваться в качестве уровней mip-мап этого Image.

Возвращаемые значения

Image image

Новый объект Image, который можно отрисовать на экране.

Функция

Доступно начиная с LÖVE 0.9.1 и удалено в LÖVE 0.10.0
Этот вариант не поддерживается в более ранних или более поздних версиях.

Синопсис

image = love.graphics.newImage( filename, format )

Аргументы

string filename

Путь к файлу изображения (или FileData, ImageData или CompressedImageData).

TextureFormat format

Формат, в котором интерпретировать данные изображения.

Возвращаемые значения

Image image

Объект Image, который можно отрисовать на экране.

Примеры

Отрисовка кролика на экране

function love.load()
	bunny = love.graphics.newImage("MyBunny.png")
end
function love.draw()
	love.graphics.draw(bunny, 0, 0)
end

См. также

• love.graphics
• Image