godotengine/godot
1
0
Fork 0
mirror of https://github.com/godotengine/godot.git synced 2026-01-07 19:53:17 +00:00
Code Releases Wiki Activity

Merge pull request #43922 from Calinou/doc-projectsettings-globalize-path

Browse Source 
Improve the `ProjectSettings.globalize_path()` documentation
This commit is contained in:
Rémi Verschelde
2020-11-28 10:29:23 +01:00
committed by GitHub
parent 95572211bb f415db5b75
commit 53b23c6bdc
1 changed files with 16 additions and 2 deletions
Download Patch File Download Diff File Expand all files Collapse all files

18
doc/classes/ProjectSettings.xml
View File

@@ -96,7 +96,21 @@
<argument index="0" name="path" type="String">
</argument>
<description>
Converts a localized path ([code]res://[/code]) to a full native OS path.
Returns the absolute, native OS path corresponding to the localized [code]path[/code] (starting with [code]res://[/code] or [code]user://[/code]). The returned path will vary depending on the operating system and user preferences. See [url=https://docs.godotengine.org/en/latest/tutorials/io/data_paths.html]File paths in Godot projects[/url] to see what those paths convert to. See also [method localize_path].
[b]Note:[/b] [method globalize_path] with [code]res://[/code] will not work in an exported project. Instead, prepend the executable's base directory to the path when running from an exported project:
[codeblock]
var path = ""
if OS.has_feature("editor"):
# Running from an editor binary.
# `path` will contain the absolute path to `hello.txt` located in the project root.
path = ProjectSettings.globalize_path("res://hello.txt")
else:
# Running from an exported project.
# `path` will contain the absolute path to `hello.txt` next to the executable.
# This is *not* identical to using `ProjectSettings.globalize_path()` with a `res://` path,
# but is close enough in spirit.
path = OS.get_executable_path().get_base_dir().plus_file("hello.txt")
[/codeblock]
</description>
</method>
<method name="has_setting" qualifiers="const">
@@ -129,7 +143,7 @@
<argument index="0" name="path" type="String">
</argument>
<description>
Convert a path to a localized path ([code]res://[/code] path).
Returns the localized path (starting with [code]res://[/code]) corresponding to the absolute, native OS [code]path[/code]. See also [method globalize_path].
</description>
</method>
<method name="property_can_revert">