Difference between revisions of "love.load"

(Adds arg argument)
m (2nd param for `love.load` is unfiltered arg of 1st param.)
(4 intermediate revisions by 3 users not shown)
Line 3: Line 3:
 
=== Synopsis ===
 
=== Synopsis ===
 
<source lang="lua">
 
<source lang="lua">
love.load( arg )
+
love.load( arg, unfilteredArg )
 
</source>
 
</source>
 
=== Arguments ===
 
=== Arguments ===
{{param|table|arg|Command line arguments given to the game.}}
+
{{param|table|arg|Command-line arguments given to the game.}}
 +
{{New feature|11.0|
 +
{{param|table|unfilteredArg|Unfiltered command-line arguments given to the executable (see [[#Notes]]).}}
 +
|110}}
 
=== Returns ===
 
=== Returns ===
 
Nothing.
 
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]]).
 +
<source lang="lua">
 +
function love.load()
 +
  hamster = love.graphics.newImage("hamster.png")
 +
  x = 50
 +
  y = 50
 +
end
 +
 +
function love.draw()
 +
  love.graphics.draw(hamster, x, y)
 +
end
 +
</source>
 +
 
== See Also ==
 
== See Also ==
 
* [[parent::love]]
 
* [[parent::love]]
 
[[Category:Callbacks]]
 
[[Category:Callbacks]]
 
{{#set:Description=This function is called exactly once at the beginning of the game.}}
 
{{#set:Description=This function is called exactly once at the beginning of the game.}}
 +
{{#set:Subcategory=General}}
 
{{#set:Since=000}}
 
{{#set:Since=000}}
 
== Other Languages ==
 
== Other Languages ==
 
{{i18n|love.load}}
 
{{i18n|love.load}}

Revision as of 12:27, 24 September 2018

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).

function love.load()
   hamster = love.graphics.newImage("hamster.png")
   x = 50
   y = 50
end

function love.draw()
   love.graphics.draw(hamster, x, y)
end

See Also


Other Languages