Difference between revisions of "love.filesystem.setIdentity"
(→Arguments) |
|||
| (5 intermediate revisions by 3 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; | |
| − | + | FALSE: results in searching game save directory before searching source directory [[love.filesystem.mount|mounted]] archives.}} | |
| − | + | |090}} | |
=== Returns === | === Returns === | ||
Nothing. | Nothing. | ||
| Line 33: | Line 24: | ||
love.filesystem.setIdentity("c:/Users/bob/monkey_doom_2") | love.filesystem.setIdentity("c:/Users/bob/monkey_doom_2") | ||
</source> | </source> | ||
| + | === Setting which to search first === | ||
| + | <source lang="lua"> | ||
| + | --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) | ||
| + | </source> | ||
| + | |||
== See Also == | == See Also == | ||
* [[parent::love.filesystem]] | * [[parent::love.filesystem]] | ||
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
