Difference between revisions of "love.filesystem.setIdentity"
(→Setting the game folder name) |
|||
(3 intermediate revisions by 2 users not shown) | |||
Line 1: | Line 1: | ||
− | Sets the write directory for your game. | + | Sets the write directory for your game. Equivalent to the identity/appendidentity pair for conf.lua. |
Note that you can only set the name of the folder to store your files in, not the location. | Note that you can only set the name of the folder to store your files in, not the location. | ||
== Function == | == Function == | ||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
=== Synopsis === | === Synopsis === | ||
<source lang="lua"> | <source lang="lua"> | ||
Line 18: | Line 8: | ||
=== Arguments === | === Arguments === | ||
{{param|string|name|The new identity that will be used as write directory.}} | {{param|string|name|The new identity that will be used as write directory.}} | ||
+ | {{New feature|0.9.0| | ||
{{param|boolean|appendToPath (false)|Whether the identity directory will be searched when reading a filepath before or after the game's source directory and any currently. | {{param|boolean|appendToPath (false)|Whether the identity directory will be searched when reading a filepath before or after the game's source directory and any currently. | ||
TRUE: results in searching source before searching save directory; | TRUE: results in searching source before searching save directory; | ||
− | FALSE: results in searching game save directory before searching source directory[[love.filesystem.mount|mounted]] archives.}} | + | FALSE: results in searching game save directory before searching source directory [[love.filesystem.mount|mounted]] archives.}} |
− | + | |090}} | |
=== Returns === | === Returns === | ||
Nothing. | Nothing. |
Latest revision as of 11:10, 12 March 2022
Sets the write directory for your game. Equivalent to the identity/appendidentity pair for conf.lua. Note that you can only set the name of the folder to store your files in, not the location.
Contents
Function
Synopsis
love.filesystem.setIdentity( name, appendToPath )
Arguments
string name
- The new identity that will be used as write directory.
Available since LÖVE 0.9.0
boolean appendToPath (false)
- Whether the identity directory will be searched when reading a filepath before or after the game's source directory and any currently.
TRUE: results in searching source before searching save directory; FALSE: results in searching game save directory before searching source directory mounted archives.
Returns
Nothing.
Examples
Setting the game folder name
-- Yes:
love.filesystem.setIdentity("monkey_doom_2")
-- No:
love.filesystem.setIdentity("c:/Users/bob/monkey_doom_2")
Setting which to search first
--Search Source, then the save directory
love.filesystem.setIdentity(love.filesystem.getIdentity(),true)
--Search Save directory, then the Source Directory
love.filesystem.setIdentity(love.filesystem.getIdentity(),false)
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