diff --git a/tutorials/io/data_paths.rst b/tutorials/io/data_paths.rst index 4bd1a71eb..9219cd672 100644 --- a/tutorials/io/data_paths.rst +++ b/tutorials/io/data_paths.rst @@ -42,6 +42,19 @@ Linux, ``~/Library/Application Support/Godot/app_userdata/Name`` on macOS (since name defined in the Project Settings, but you can override it on a per-platform basis using :ref:`feature tags `. +Converting paths to absolute paths or "local" paths +--------------------------------------------------- + +You can use :ref:`ProjectSettings.globalize_path() ` +to convert a "local" path like ``res://path/to/file.txt`` to an absolute OS path. +For example, :ref:`ProjectSettings.globalize_path() ` +can be used to open "local" paths in the OS file manager +using :ref:`OS.shell_open() ` since it only accepts +native OS paths. + +To convert an absolute OS path to a "local" path starting with ``res://``, use +:ref:`ProjectSettings.localize_path() `. + Editor data paths -----------------