love.load

This function is called exactly once at the beginning of the game.

Function

Synopsis

love.load( arg, unfilteredArg )

Arguments

table arg

Command-line arguments given to the game.

Available since LÖVE 11.0

table unfilteredArg

Unfiltered command-line arguments given to the executable (see #Notes).

Returns

Nothing.

Notes

In LÖVE 11.0, the passed arguments excludes the game name and the fused command-line flag (if exist) when runs from non-fused LÖVE executable. Previous version pass the argument as-is without any filtering.

Examples

Establish some variables/resources on the game load, so that they can be used repeatedly in other functions (such as love.draw).

Run love with arguments to see them displayed: love . --hello.

local text, pos

function love.load(args)
   local msg = args[1] or 'no arguments'
   text = love.graphics.newText(love.graphics.getFont(), msg)
   pos = {
       x = 50,
       y = 50,
   }
end

function love.update(dt)
   if love.keyboard.isDown('right') then
      pos.x = pos.x + 1
   end
end

function love.draw()
   love.graphics.draw(text, pos.x, pos.y)
end

See Also

• love

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