mirror of
https://github.com/godotengine/godot.git
synced 2024-11-27 09:16:35 +08:00
f392650be2
Initialized the PID to -2, which will be the value returns in blocking- mode where the PID is not available. (-1 was already taken to signify an execution failure). OS::execute will now properly return a non-OK error code when it fails to execute the target file. The documentation was rewritten to be very clear about the differences between blocking and non-blocking mode. Fixes #19056.
865 lines
31 KiB
XML
865 lines
31 KiB
XML
<?xml version="1.0" encoding="UTF-8" ?>
|
|
<class name="OS" inherits="Object" category="Core" version="3.1">
|
|
<brief_description>
|
|
Operating System functions.
|
|
</brief_description>
|
|
<description>
|
|
Operating System functions. OS Wraps the most common functionality to communicate with the host Operating System, such as: mouse grabbing, mouse cursors, clipboard, video mode, date and time, timers, environment variables, execution of binaries, command line, etc.
|
|
</description>
|
|
<tutorials>
|
|
</tutorials>
|
|
<demos>
|
|
</demos>
|
|
<methods>
|
|
<method name="alert">
|
|
<return type="void">
|
|
</return>
|
|
<argument index="0" name="text" type="String">
|
|
</argument>
|
|
<argument index="1" name="title" type="String" default=""Alert!"">
|
|
</argument>
|
|
<description>
|
|
Displays a modal dialog box utilizing the host OS.
|
|
</description>
|
|
</method>
|
|
<method name="can_draw" qualifiers="const">
|
|
<return type="bool">
|
|
</return>
|
|
<description>
|
|
Returns [code]true[/code] if the host OS allows drawing.
|
|
</description>
|
|
</method>
|
|
<method name="can_use_threads" qualifiers="const">
|
|
<return type="bool">
|
|
</return>
|
|
<description>
|
|
Returns [code]true[/code] if the current host platform is using multiple threads.
|
|
</description>
|
|
</method>
|
|
<method name="center_window">
|
|
<return type="void">
|
|
</return>
|
|
<description>
|
|
Centers the window on the screen if in windowed mode.
|
|
</description>
|
|
</method>
|
|
<method name="delay_msec" qualifiers="const">
|
|
<return type="void">
|
|
</return>
|
|
<argument index="0" name="msec" type="int">
|
|
</argument>
|
|
<description>
|
|
Delay execution of the current thread by given milliseconds.
|
|
</description>
|
|
</method>
|
|
<method name="delay_usec" qualifiers="const">
|
|
<return type="void">
|
|
</return>
|
|
<argument index="0" name="usec" type="int">
|
|
</argument>
|
|
<description>
|
|
Delay execution of the current thread by given microseconds.
|
|
</description>
|
|
</method>
|
|
<method name="dump_memory_to_file">
|
|
<return type="void">
|
|
</return>
|
|
<argument index="0" name="file" type="String">
|
|
</argument>
|
|
<description>
|
|
Dumps the memory allocation ringlist to a file (only works in debug).
|
|
Entry format per line: "Address - Size - Description".
|
|
</description>
|
|
</method>
|
|
<method name="dump_resources_to_file">
|
|
<return type="void">
|
|
</return>
|
|
<argument index="0" name="file" type="String">
|
|
</argument>
|
|
<description>
|
|
Dumps all used resources to file (only works in debug).
|
|
Entry format per line: "Resource Type : Resource Location".
|
|
At the end of the file is a statistic of all used Resource Types.
|
|
</description>
|
|
</method>
|
|
<method name="execute">
|
|
<return type="int">
|
|
</return>
|
|
<argument index="0" name="path" type="String">
|
|
</argument>
|
|
<argument index="1" name="arguments" type="PoolStringArray">
|
|
</argument>
|
|
<argument index="2" name="blocking" type="bool">
|
|
</argument>
|
|
<argument index="3" name="output" type="Array" default="[ ]">
|
|
</argument>
|
|
<description>
|
|
Execute the file at the given path with the arguments passed as an array of strings. Platform path resolution will take place. The resolved file must exist and be executable.
|
|
The arguments are used in the given order and separated by a space, so [code]OS.execute('ping', ['-c', '3', 'godotengine.org'])[/code] will resolve to [code]ping -c 3 godotengine.org[/code] in the system's shell.
|
|
This method has slightly different behaviour based on whether the [code]blocking[/code] mode is enabled.
|
|
When [code]blocking[/code] is enabled, the Godot thread will pause its execution while waiting for the process to terminate. The shell output of the process will be written to the [code]output[/code] array as a single string. When the process terminates, the Godot thread will resume execution.
|
|
When [code]blocking[/code] is disabled, the Godot thread will continue while the new process runs. It is not possible to retrieve the shell output in non-blocking mode, so [code]output[/code] will be empty.
|
|
The return value also depends on the blocking mode. When blocking, the method will return -2 (no process ID information is available in blocking mode). When non-blocking, the method returns a process ID, which you can use to monitor the process (and potentially terminate it with [method kill]). If the process forking (non-blocking) or opening (blocking) fails, the method will return -1.
|
|
Example of blocking mode and retrieving the shell output:
|
|
[codeblock]
|
|
var output = []
|
|
OS.execute('ls', ['-l', '/tmp'], true, output)
|
|
[/codeblock]
|
|
Example of non-blocking mode, running another instance of the project and storing its process ID:
|
|
[codeblock]
|
|
var pid = OS.execute(OS.get_executable_path(), [], false)
|
|
[/codeblock]
|
|
If you wish to access a shell built-in or perform a composite command, a platform-specific shell can be invoked. For example:
|
|
[codeblock]
|
|
OS.execute('CMD.exe', ['/C', 'cd %TEMP% && dir'], true, output)
|
|
[/codeblock]
|
|
</description>
|
|
</method>
|
|
<method name="find_scancode_from_string" qualifiers="const">
|
|
<return type="int">
|
|
</return>
|
|
<argument index="0" name="string" type="String">
|
|
</argument>
|
|
<description>
|
|
Returns the scancode of the given string (e.g. "Escape")
|
|
</description>
|
|
</method>
|
|
<method name="get_audio_driver_count" qualifiers="const">
|
|
<return type="int">
|
|
</return>
|
|
<description>
|
|
Returns the total number of available audio drivers.
|
|
</description>
|
|
</method>
|
|
<method name="get_audio_driver_name" qualifiers="const">
|
|
<return type="String">
|
|
</return>
|
|
<argument index="0" name="driver" type="int">
|
|
</argument>
|
|
<description>
|
|
Returns the audio driver name for the given index.
|
|
</description>
|
|
</method>
|
|
<method name="get_cmdline_args">
|
|
<return type="PoolStringArray">
|
|
</return>
|
|
<description>
|
|
Returns the command line arguments passed to the engine.
|
|
</description>
|
|
</method>
|
|
<method name="get_date" qualifiers="const">
|
|
<return type="Dictionary">
|
|
</return>
|
|
<argument index="0" name="utc" type="bool" default="false">
|
|
</argument>
|
|
<description>
|
|
Returns current date as a dictionary of keys: year, month, day, weekday, dst (daylight savings time).
|
|
</description>
|
|
</method>
|
|
<method name="get_datetime" qualifiers="const">
|
|
<return type="Dictionary">
|
|
</return>
|
|
<argument index="0" name="utc" type="bool" default="false">
|
|
</argument>
|
|
<description>
|
|
Returns current datetime as a dictionary of keys: year, month, day, weekday, dst (daylight savings time), hour, minute, second.
|
|
</description>
|
|
</method>
|
|
<method name="get_datetime_from_unix_time" qualifiers="const">
|
|
<return type="Dictionary">
|
|
</return>
|
|
<argument index="0" name="unix_time_val" type="int">
|
|
</argument>
|
|
<description>
|
|
Get a dictionary of time values when given epoch time.
|
|
Dictionary Time values will be a union of values from [method get_time] and [method get_date] dictionaries (with the exception of dst = day light standard time, as it cannot be determined from epoch).
|
|
</description>
|
|
</method>
|
|
<method name="get_dynamic_memory_usage" qualifiers="const">
|
|
<return type="int">
|
|
</return>
|
|
<description>
|
|
Returns the total amount of dynamic memory used (only works in debug).
|
|
</description>
|
|
</method>
|
|
<method name="get_environment" qualifiers="const">
|
|
<return type="String">
|
|
</return>
|
|
<argument index="0" name="environment" type="String">
|
|
</argument>
|
|
<description>
|
|
Returns an environment variable.
|
|
</description>
|
|
</method>
|
|
<method name="get_executable_path" qualifiers="const">
|
|
<return type="String">
|
|
</return>
|
|
<description>
|
|
Returns the path to the current engine executable.
|
|
</description>
|
|
</method>
|
|
<method name="get_latin_keyboard_variant" qualifiers="const">
|
|
<return type="String">
|
|
</return>
|
|
<description>
|
|
Returns the current latin keyboard variant as a String.
|
|
Possible return values are: "QWERTY", "AZERTY", "QZERTY", "DVORAK", "NEO", "COLEMAK" or "ERROR".
|
|
</description>
|
|
</method>
|
|
<method name="get_locale" qualifiers="const">
|
|
<return type="String">
|
|
</return>
|
|
<description>
|
|
Returns the host OS locale.
|
|
</description>
|
|
</method>
|
|
<method name="get_model_name" qualifiers="const">
|
|
<return type="String">
|
|
</return>
|
|
<description>
|
|
Returns the model name of the current device.
|
|
</description>
|
|
</method>
|
|
<method name="get_name" qualifiers="const">
|
|
<return type="String">
|
|
</return>
|
|
<description>
|
|
Returns the name of the host OS. Possible values are: "Android", "Haiku", "iOS", "HTML5", "OSX", "Server", "Windows", "UWP", "X11".
|
|
</description>
|
|
</method>
|
|
<method name="get_power_percent_left">
|
|
<return type="int">
|
|
</return>
|
|
<description>
|
|
Returns the amount of battery left in the device as a percentage.
|
|
</description>
|
|
</method>
|
|
<method name="get_power_seconds_left">
|
|
<return type="int">
|
|
</return>
|
|
<description>
|
|
Returns the time in seconds before the device runs out of battery.
|
|
</description>
|
|
</method>
|
|
<method name="get_power_state">
|
|
<return type="int" enum="OS.PowerState">
|
|
</return>
|
|
<description>
|
|
Returns the current state of the device regarding battery and power. See [code]POWERSTATE_*[/code] constants.
|
|
</description>
|
|
</method>
|
|
<method name="get_process_id" qualifiers="const">
|
|
<return type="int">
|
|
</return>
|
|
<description>
|
|
Returns the game process ID
|
|
</description>
|
|
</method>
|
|
<method name="get_processor_count" qualifiers="const">
|
|
<return type="int">
|
|
</return>
|
|
<description>
|
|
Returns the number of cores available in the host machine.
|
|
</description>
|
|
</method>
|
|
<method name="get_real_window_size" qualifiers="const">
|
|
<return type="Vector2">
|
|
</return>
|
|
<description>
|
|
Returns the window size including decorations like window borders.
|
|
</description>
|
|
</method>
|
|
<method name="get_scancode_string" qualifiers="const">
|
|
<return type="String">
|
|
</return>
|
|
<argument index="0" name="code" type="int">
|
|
</argument>
|
|
<description>
|
|
Returns the given scancode as a string (e.g. Return values: "Escape", "Shift+Escape").
|
|
</description>
|
|
</method>
|
|
<method name="get_screen_count" qualifiers="const">
|
|
<return type="int">
|
|
</return>
|
|
<description>
|
|
Returns the number of displays attached to the host machine.
|
|
</description>
|
|
</method>
|
|
<method name="get_screen_dpi" qualifiers="const">
|
|
<return type="int">
|
|
</return>
|
|
<argument index="0" name="screen" type="int" default="-1">
|
|
</argument>
|
|
<description>
|
|
Returns the dots per inch density of the specified screen.
|
|
|
|
On Android Devices, the actual screen densities are grouped into six generalized densities:
|
|
ldpi - 120 dpi
|
|
mdpi - 160 dpi
|
|
hdpi - 240 dpi
|
|
xhdpi - 320 dpi
|
|
xxhdpi - 480 dpi
|
|
xxxhdpi - 640 dpi
|
|
</description>
|
|
</method>
|
|
<method name="get_screen_position" qualifiers="const">
|
|
<return type="Vector2">
|
|
</return>
|
|
<argument index="0" name="screen" type="int" default="-1">
|
|
</argument>
|
|
<description>
|
|
Returns the position of the specified screen by index. If no screen index is provided, the current screen will be used.
|
|
</description>
|
|
</method>
|
|
<method name="get_screen_size" qualifiers="const">
|
|
<return type="Vector2">
|
|
</return>
|
|
<argument index="0" name="screen" type="int" default="-1">
|
|
</argument>
|
|
<description>
|
|
Returns the dimensions in pixels of the specified screen.
|
|
</description>
|
|
</method>
|
|
<method name="get_splash_tick_msec" qualifiers="const">
|
|
<return type="int">
|
|
</return>
|
|
<description>
|
|
</description>
|
|
</method>
|
|
<method name="get_static_memory_peak_usage" qualifiers="const">
|
|
<return type="int">
|
|
</return>
|
|
<description>
|
|
Returns the max amount of static memory used (only works in debug).
|
|
</description>
|
|
</method>
|
|
<method name="get_static_memory_usage" qualifiers="const">
|
|
<return type="int">
|
|
</return>
|
|
<description>
|
|
Returns the amount of static memory being used by the program in bytes.
|
|
</description>
|
|
</method>
|
|
<method name="get_system_dir" qualifiers="const">
|
|
<return type="String">
|
|
</return>
|
|
<argument index="0" name="dir" type="int" enum="OS.SystemDir">
|
|
</argument>
|
|
<description>
|
|
Returns the actual path to commonly used folders across different platforms. Available locations are specified in [OS.SystemDir].
|
|
</description>
|
|
</method>
|
|
<method name="get_system_time_secs" qualifiers="const">
|
|
<return type="int">
|
|
</return>
|
|
<description>
|
|
Returns the epoch time of the operating system in seconds.
|
|
</description>
|
|
</method>
|
|
<method name="get_ticks_msec" qualifiers="const">
|
|
<return type="int">
|
|
</return>
|
|
<description>
|
|
Returns the amount of time passed in milliseconds since the engine started.
|
|
</description>
|
|
</method>
|
|
<method name="get_time" qualifiers="const">
|
|
<return type="Dictionary">
|
|
</return>
|
|
<argument index="0" name="utc" type="bool" default="false">
|
|
</argument>
|
|
<description>
|
|
Returns current time as a dictionary of keys: hour, minute, second.
|
|
</description>
|
|
</method>
|
|
<method name="get_time_zone_info" qualifiers="const">
|
|
<return type="Dictionary">
|
|
</return>
|
|
<description>
|
|
Returns the current time zone as a dictionary with the keys: bias and name.
|
|
</description>
|
|
</method>
|
|
<method name="get_unique_id" qualifiers="const">
|
|
<return type="String">
|
|
</return>
|
|
<description>
|
|
Returns a string that is unique to the device.
|
|
Returns empty string on HTML5 and UWP which are not supported yet.
|
|
</description>
|
|
</method>
|
|
<method name="get_unix_time" qualifiers="const">
|
|
<return type="int">
|
|
</return>
|
|
<description>
|
|
Returns the current unix epoch timestamp.
|
|
</description>
|
|
</method>
|
|
<method name="get_unix_time_from_datetime" qualifiers="const">
|
|
<return type="int">
|
|
</return>
|
|
<argument index="0" name="datetime" type="Dictionary">
|
|
</argument>
|
|
<description>
|
|
Get an epoch time value from a dictionary of time values.
|
|
[code]datetime[/code] must be populated with the following keys: year, month, day, hour, minute, second.
|
|
You can pass the output from [method get_datetime_from_unix_time] directly into this function. Daylight savings time (dst), if present, is ignored.
|
|
</description>
|
|
</method>
|
|
<method name="get_user_data_dir" qualifiers="const">
|
|
<return type="String">
|
|
</return>
|
|
<description>
|
|
Returns the absolute directory path where user data is written ([code]user://[/code]).
|
|
On Linux, this is [code]~/.local/share/godot/app_userdata/[project_name][/code], or [code]~/.local/share/[custom_name][/code] if [code]use_custom_user_dir[/code] is set.
|
|
On macOS, this is [code]~/Library/Application Support/Godot/app_userdata/[project_name][/code], or [code]~/Library/Application Support/[custom_name][/code] if [code]use_custom_user_dir[/code] is set.
|
|
On Windows, this is [code]%APPDATA%/Godot/app_userdata/[project_name][/code], or [code]%APPDATA%/[custom_name][/code] if [code]use_custom_user_dir[/code] is set.
|
|
If the project name is empty, [code]user://[/code] falls back to [code]res://[/code].
|
|
</description>
|
|
</method>
|
|
<method name="get_video_driver_count" qualifiers="const">
|
|
<return type="int">
|
|
</return>
|
|
<description>
|
|
</description>
|
|
</method>
|
|
<method name="get_video_driver_name" qualifiers="const">
|
|
<return type="String">
|
|
</return>
|
|
<argument index="0" name="driver" type="int">
|
|
</argument>
|
|
<description>
|
|
</description>
|
|
</method>
|
|
<method name="get_virtual_keyboard_height">
|
|
<return type="int">
|
|
</return>
|
|
<description>
|
|
Returns the on-screen keyboard's height in pixels. Returns 0 if there is no keyboard or it is currently hidden.
|
|
</description>
|
|
</method>
|
|
<method name="get_window_safe_area" qualifiers="const">
|
|
<return type="Rect2">
|
|
</return>
|
|
<description>
|
|
</description>
|
|
</method>
|
|
<method name="has_environment" qualifiers="const">
|
|
<return type="bool">
|
|
</return>
|
|
<argument index="0" name="environment" type="String">
|
|
</argument>
|
|
<description>
|
|
Returns [code]true[/code] if an environment variable exists.
|
|
</description>
|
|
</method>
|
|
<method name="has_feature" qualifiers="const">
|
|
<return type="bool">
|
|
</return>
|
|
<argument index="0" name="tag_name" type="String">
|
|
</argument>
|
|
<description>
|
|
Returns [code]true[/code] if the feature for the given feature tag is supported in the currently running instance, depending on platform, build etc. Can be used to check whether you're currently running a debug build, on a certain platform or arch, etc. See feature tags documentation.
|
|
</description>
|
|
</method>
|
|
<method name="has_touchscreen_ui_hint" qualifiers="const">
|
|
<return type="bool">
|
|
</return>
|
|
<description>
|
|
Returns [code]true[/code] if the device has a touchscreen or emulates one.
|
|
</description>
|
|
</method>
|
|
<method name="has_virtual_keyboard" qualifiers="const">
|
|
<return type="bool">
|
|
</return>
|
|
<description>
|
|
Returns [code]true[/code] if the platform has a virtual keyboard, [code]false[/code] otherwise.
|
|
</description>
|
|
</method>
|
|
<method name="hide_virtual_keyboard">
|
|
<return type="void">
|
|
</return>
|
|
<description>
|
|
Hides the virtual keyboard if it is shown, does nothing otherwise.
|
|
</description>
|
|
</method>
|
|
<method name="is_debug_build" qualifiers="const">
|
|
<return type="bool">
|
|
</return>
|
|
<description>
|
|
Returns [code]true[/code] if the build is a debug build.
|
|
Returns [code]true[/code] when running in the editor.
|
|
Returns [code]false[/code] if the build is a release build.
|
|
</description>
|
|
</method>
|
|
<method name="is_ok_left_and_cancel_right" qualifiers="const">
|
|
<return type="bool">
|
|
</return>
|
|
<description>
|
|
Returns [code]true[/code] if the "Okay" button should appear on the left and "Cancel" on the right.
|
|
</description>
|
|
</method>
|
|
<method name="is_scancode_unicode" qualifiers="const">
|
|
<return type="bool">
|
|
</return>
|
|
<argument index="0" name="code" type="int">
|
|
</argument>
|
|
<description>
|
|
Returns [code]true[/code] if the input code has a unicode character.
|
|
</description>
|
|
</method>
|
|
<method name="is_stdout_verbose" qualifiers="const">
|
|
<return type="bool">
|
|
</return>
|
|
<description>
|
|
Returns [code]true[/code] if the engine was executed with -v (verbose stdout).
|
|
</description>
|
|
</method>
|
|
<method name="is_userfs_persistent" qualifiers="const">
|
|
<return type="bool">
|
|
</return>
|
|
<description>
|
|
If [code]true[/code], the [code]user://[/code] file system is persistent, so that its state is the same after a player quits and starts the game again. Relevant to the HTML5 platform, where this persistence may be unavailable.
|
|
</description>
|
|
</method>
|
|
<method name="is_window_always_on_top" qualifiers="const">
|
|
<return type="bool">
|
|
</return>
|
|
<description>
|
|
Returns [code]true[/code] if the window should always be on top of other windows.
|
|
</description>
|
|
</method>
|
|
<method name="kill">
|
|
<return type="int" enum="Error">
|
|
</return>
|
|
<argument index="0" name="pid" type="int">
|
|
</argument>
|
|
<description>
|
|
Kill (terminate) the process identified by the given process ID ([code]pid[/code]), e.g. the one returned by [method execute] in non-blocking mode.
|
|
Note that this method can also be used to kill processes that were not spawned by the game.
|
|
</description>
|
|
</method>
|
|
<method name="native_video_is_playing">
|
|
<return type="bool">
|
|
</return>
|
|
<description>
|
|
Returns [code]true[/code] if native video is playing.
|
|
</description>
|
|
</method>
|
|
<method name="native_video_pause">
|
|
<return type="void">
|
|
</return>
|
|
<description>
|
|
Pauses native video playback.
|
|
</description>
|
|
</method>
|
|
<method name="native_video_play">
|
|
<return type="int" enum="Error">
|
|
</return>
|
|
<argument index="0" name="path" type="String">
|
|
</argument>
|
|
<argument index="1" name="volume" type="float">
|
|
</argument>
|
|
<argument index="2" name="audio_track" type="String">
|
|
</argument>
|
|
<argument index="3" name="subtitle_track" type="String">
|
|
</argument>
|
|
<description>
|
|
Plays native video from the specified path, at the given volume and with audio and subtitle tracks.
|
|
</description>
|
|
</method>
|
|
<method name="native_video_stop">
|
|
<return type="void">
|
|
</return>
|
|
<description>
|
|
Stops native video playback.
|
|
</description>
|
|
</method>
|
|
<method name="native_video_unpause">
|
|
<return type="void">
|
|
</return>
|
|
<description>
|
|
Resumes native video playback.
|
|
</description>
|
|
</method>
|
|
<method name="print_all_resources">
|
|
<return type="void">
|
|
</return>
|
|
<argument index="0" name="tofile" type="String" default="""">
|
|
</argument>
|
|
<description>
|
|
Shows all resources in the game. Optionally the list can be written to a file.
|
|
</description>
|
|
</method>
|
|
<method name="print_all_textures_by_size">
|
|
<return type="void">
|
|
</return>
|
|
<description>
|
|
Shows the list of loaded textures sorted by size in memory.
|
|
</description>
|
|
</method>
|
|
<method name="print_resources_by_type">
|
|
<return type="void">
|
|
</return>
|
|
<argument index="0" name="types" type="PoolStringArray">
|
|
</argument>
|
|
<description>
|
|
Shows the number of resources loaded by the game of the given types.
|
|
</description>
|
|
</method>
|
|
<method name="print_resources_in_use">
|
|
<return type="void">
|
|
</return>
|
|
<argument index="0" name="short" type="bool" default="false">
|
|
</argument>
|
|
<description>
|
|
Shows all resources currently used by the game.
|
|
</description>
|
|
</method>
|
|
<method name="request_attention">
|
|
<return type="void">
|
|
</return>
|
|
<description>
|
|
Request the user attention to the window. It'll flash the taskbar button on Windows or bounce the dock icon on OSX.
|
|
</description>
|
|
</method>
|
|
<method name="set_icon">
|
|
<return type="void">
|
|
</return>
|
|
<argument index="0" name="icon" type="Image">
|
|
</argument>
|
|
<description>
|
|
Sets the game's icon.
|
|
</description>
|
|
</method>
|
|
<method name="set_ime_position">
|
|
<return type="void">
|
|
</return>
|
|
<argument index="0" name="position" type="Vector2">
|
|
</argument>
|
|
<description>
|
|
</description>
|
|
</method>
|
|
<method name="set_thread_name">
|
|
<return type="int" enum="Error">
|
|
</return>
|
|
<argument index="0" name="name" type="String">
|
|
</argument>
|
|
<description>
|
|
Sets the name of the current thread.
|
|
</description>
|
|
</method>
|
|
<method name="set_use_file_access_save_and_swap">
|
|
<return type="void">
|
|
</return>
|
|
<argument index="0" name="enabled" type="bool">
|
|
</argument>
|
|
<description>
|
|
Enables backup saves if [code]enabled[/code] is [code]true[/code].
|
|
</description>
|
|
</method>
|
|
<method name="set_window_always_on_top">
|
|
<return type="void">
|
|
</return>
|
|
<argument index="0" name="enabled" type="bool">
|
|
</argument>
|
|
<description>
|
|
Sets whether the window should always be on top.
|
|
</description>
|
|
</method>
|
|
<method name="set_window_title">
|
|
<return type="void">
|
|
</return>
|
|
<argument index="0" name="title" type="String">
|
|
</argument>
|
|
<description>
|
|
Sets the window title to the specified string.
|
|
</description>
|
|
</method>
|
|
<method name="shell_open">
|
|
<return type="int" enum="Error">
|
|
</return>
|
|
<argument index="0" name="uri" type="String">
|
|
</argument>
|
|
<description>
|
|
Requests the OS to open a resource with the most appropriate program. For example.
|
|
[code]OS.shell_open("C:\\Users\name\Downloads")[/code] on Windows opens the file explorer at the downloads folders of the user.
|
|
[code]OS.shell_open("http://godotengine.org")[/code] opens the default web browser on the official Godot website.
|
|
</description>
|
|
</method>
|
|
<method name="show_virtual_keyboard">
|
|
<return type="void">
|
|
</return>
|
|
<argument index="0" name="existing_text" type="String" default="""">
|
|
</argument>
|
|
<description>
|
|
Shows the virtual keyboard if the platform has one. The [i]existing_text[/i] parameter is useful for implementing your own LineEdit, as it tells the virtual keyboard what text has already been typed (the virtual keyboard uses it for auto-correct and predictions).
|
|
</description>
|
|
</method>
|
|
</methods>
|
|
<members>
|
|
<member name="clipboard" type="String" setter="set_clipboard" getter="get_clipboard">
|
|
The clipboard from the host OS. Might be unavailable on some platforms.
|
|
</member>
|
|
<member name="current_screen" type="int" setter="set_current_screen" getter="get_current_screen">
|
|
The current screen index (starting from 0).
|
|
</member>
|
|
<member name="exit_code" type="int" setter="set_exit_code" getter="get_exit_code">
|
|
The exit code passed to the OS when the main loop exits.
|
|
</member>
|
|
<member name="keep_screen_on" type="bool" setter="set_keep_screen_on" getter="is_keep_screen_on">
|
|
If [code]true[/code] the engine tries to keep the screen on while the game is running. Useful on mobile.
|
|
</member>
|
|
<member name="low_processor_usage_mode" type="bool" setter="set_low_processor_usage_mode" getter="is_in_low_processor_usage_mode">
|
|
If [code]true[/code] the engine optimizes for low processor usage by only refreshing the screen if needed. Can improve battery consumption on mobile.
|
|
</member>
|
|
<member name="screen_orientation" type="int" setter="set_screen_orientation" getter="get_screen_orientation" enum="_OS.ScreenOrientation">
|
|
The current screen orientation.
|
|
</member>
|
|
<member name="vsync_enabled" type="bool" setter="set_use_vsync" getter="is_vsync_enabled">
|
|
If [code]true[/code] vertical synchronization (Vsync) is enabled.
|
|
</member>
|
|
<member name="window_borderless" type="bool" setter="set_borderless_window" getter="get_borderless_window">
|
|
If [code]true[/code] removes the window frame.
|
|
</member>
|
|
<member name="window_fullscreen" type="bool" setter="set_window_fullscreen" getter="is_window_fullscreen">
|
|
If [code]true[/code] the window is fullscreen.
|
|
</member>
|
|
<member name="window_maximized" type="bool" setter="set_window_maximized" getter="is_window_maximized">
|
|
If [code]true[/code] the window is maximized.
|
|
</member>
|
|
<member name="window_minimized" type="bool" setter="set_window_minimized" getter="is_window_minimized">
|
|
If [code]true[/code] the window is minimized.
|
|
</member>
|
|
<member name="window_per_pixel_transparency_enabled" type="bool" setter="set_window_per_pixel_transparency_enabled" getter="get_window_per_pixel_transparency_enabled">
|
|
</member>
|
|
<member name="window_position" type="Vector2" setter="set_window_position" getter="get_window_position">
|
|
The window position relative to the screen, the origin is the top left corner, +Y axis goes to the bottom and +X axis goes to the right.
|
|
</member>
|
|
<member name="window_resizable" type="bool" setter="set_window_resizable" getter="is_window_resizable">
|
|
If [code]true[/code], the window is resizable by the user.
|
|
</member>
|
|
<member name="window_size" type="Vector2" setter="set_window_size" getter="get_window_size">
|
|
The size of the window (without counting window manager decorations).
|
|
</member>
|
|
</members>
|
|
<constants>
|
|
<constant name="DAY_SUNDAY" value="0" enum="Weekday">
|
|
Sunday.
|
|
</constant>
|
|
<constant name="DAY_MONDAY" value="1" enum="Weekday">
|
|
Monday.
|
|
</constant>
|
|
<constant name="DAY_TUESDAY" value="2" enum="Weekday">
|
|
Tuesday.
|
|
</constant>
|
|
<constant name="DAY_WEDNESDAY" value="3" enum="Weekday">
|
|
Wednesday.
|
|
</constant>
|
|
<constant name="DAY_THURSDAY" value="4" enum="Weekday">
|
|
Thursday.
|
|
</constant>
|
|
<constant name="DAY_FRIDAY" value="5" enum="Weekday">
|
|
Friday.
|
|
</constant>
|
|
<constant name="DAY_SATURDAY" value="6" enum="Weekday">
|
|
Saturday.
|
|
</constant>
|
|
<constant name="MONTH_JANUARY" value="1" enum="Month">
|
|
January.
|
|
</constant>
|
|
<constant name="MONTH_FEBRUARY" value="2" enum="Month">
|
|
February.
|
|
</constant>
|
|
<constant name="MONTH_MARCH" value="3" enum="Month">
|
|
March.
|
|
</constant>
|
|
<constant name="MONTH_APRIL" value="4" enum="Month">
|
|
April.
|
|
</constant>
|
|
<constant name="MONTH_MAY" value="5" enum="Month">
|
|
May.
|
|
</constant>
|
|
<constant name="MONTH_JUNE" value="6" enum="Month">
|
|
June.
|
|
</constant>
|
|
<constant name="MONTH_JULY" value="7" enum="Month">
|
|
July.
|
|
</constant>
|
|
<constant name="MONTH_AUGUST" value="8" enum="Month">
|
|
August.
|
|
</constant>
|
|
<constant name="MONTH_SEPTEMBER" value="9" enum="Month">
|
|
September.
|
|
</constant>
|
|
<constant name="MONTH_OCTOBER" value="10" enum="Month">
|
|
October.
|
|
</constant>
|
|
<constant name="MONTH_NOVEMBER" value="11" enum="Month">
|
|
November.
|
|
</constant>
|
|
<constant name="MONTH_DECEMBER" value="12" enum="Month">
|
|
December.
|
|
</constant>
|
|
<constant name="SCREEN_ORIENTATION_LANDSCAPE" value="0" enum="ScreenOrientation">
|
|
Landscape screen orientation.
|
|
</constant>
|
|
<constant name="SCREEN_ORIENTATION_PORTRAIT" value="1" enum="ScreenOrientation">
|
|
Portrait screen orientation.
|
|
</constant>
|
|
<constant name="SCREEN_ORIENTATION_REVERSE_LANDSCAPE" value="2" enum="ScreenOrientation">
|
|
Reverse landscape screen orientation.
|
|
</constant>
|
|
<constant name="SCREEN_ORIENTATION_REVERSE_PORTRAIT" value="3" enum="ScreenOrientation">
|
|
Reverse portrait screen orientation.
|
|
</constant>
|
|
<constant name="SCREEN_ORIENTATION_SENSOR_LANDSCAPE" value="4" enum="ScreenOrientation">
|
|
Uses landscape or reverse landscape based on the hardware sensor.
|
|
</constant>
|
|
<constant name="SCREEN_ORIENTATION_SENSOR_PORTRAIT" value="5" enum="ScreenOrientation">
|
|
Uses portrait or reverse portrait based on the hardware sensor.
|
|
</constant>
|
|
<constant name="SCREEN_ORIENTATION_SENSOR" value="6" enum="ScreenOrientation">
|
|
Uses most suitable orientation based on the hardware sensor.
|
|
</constant>
|
|
<constant name="SYSTEM_DIR_DESKTOP" value="0" enum="SystemDir">
|
|
Desktop directory path.
|
|
</constant>
|
|
<constant name="SYSTEM_DIR_DCIM" value="1" enum="SystemDir">
|
|
DCIM (Digital Camera Images) directory path.
|
|
</constant>
|
|
<constant name="SYSTEM_DIR_DOCUMENTS" value="2" enum="SystemDir">
|
|
Documents directory path.
|
|
</constant>
|
|
<constant name="SYSTEM_DIR_DOWNLOADS" value="3" enum="SystemDir">
|
|
Downloads directory path.
|
|
</constant>
|
|
<constant name="SYSTEM_DIR_MOVIES" value="4" enum="SystemDir">
|
|
Movies directory path.
|
|
</constant>
|
|
<constant name="SYSTEM_DIR_MUSIC" value="5" enum="SystemDir">
|
|
Music directory path.
|
|
</constant>
|
|
<constant name="SYSTEM_DIR_PICTURES" value="6" enum="SystemDir">
|
|
Pictures directory path.
|
|
</constant>
|
|
<constant name="SYSTEM_DIR_RINGTONES" value="7" enum="SystemDir">
|
|
Ringtones directory path.
|
|
</constant>
|
|
<constant name="POWERSTATE_UNKNOWN" value="0" enum="PowerState">
|
|
Unknown powerstate.
|
|
</constant>
|
|
<constant name="POWERSTATE_ON_BATTERY" value="1" enum="PowerState">
|
|
Unplugged, running on battery.
|
|
</constant>
|
|
<constant name="POWERSTATE_NO_BATTERY" value="2" enum="PowerState">
|
|
Plugged in, no battery available.
|
|
</constant>
|
|
<constant name="POWERSTATE_CHARGING" value="3" enum="PowerState">
|
|
Plugged in, battery charging.
|
|
</constant>
|
|
<constant name="POWERSTATE_CHARGED" value="4" enum="PowerState">
|
|
Plugged in, battery fully charged.
|
|
</constant>
|
|
</constants>
|
|
</class>
|