mirror of
https://github.com/godotengine/godot-docs.git
synced 2026-01-03 05:48:42 +03:00
689 lines
61 KiB
ReStructuredText
689 lines
61 KiB
ReStructuredText
.. _class_OS:
|
|
|
|
OS
|
|
==
|
|
|
|
**Inherits:** :ref:`Object<class_object>`
|
|
|
|
**Category:** Core
|
|
|
|
Brief Description
|
|
-----------------
|
|
|
|
Operating System functions.
|
|
|
|
Member Functions
|
|
----------------
|
|
|
|
+----------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
|
|
| void | :ref:`set_clipboard<class_OS_set_clipboard>` **(** :ref:`String<class_string>` clipboard **)** |
|
|
+----------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
|
|
| :ref:`String<class_string>` | :ref:`get_clipboard<class_OS_get_clipboard>` **(** **)** const |
|
|
+----------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
|
|
| void | :ref:`set_video_mode<class_OS_set_video_mode>` **(** :ref:`Vector2<class_vector2>` size, :ref:`bool<class_bool>` fullscreen, :ref:`bool<class_bool>` resizable, :ref:`int<class_int>` screen=0 **)** |
|
|
+----------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
|
|
| :ref:`Vector2<class_vector2>` | :ref:`get_video_mode_size<class_OS_get_video_mode_size>` **(** :ref:`int<class_int>` screen=0 **)** const |
|
|
+----------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
|
|
| :ref:`bool<class_bool>` | :ref:`is_video_mode_fullscreen<class_OS_is_video_mode_fullscreen>` **(** :ref:`int<class_int>` screen=0 **)** const |
|
|
+----------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
|
|
| :ref:`bool<class_bool>` | :ref:`is_video_mode_resizable<class_OS_is_video_mode_resizable>` **(** :ref:`int<class_int>` screen=0 **)** const |
|
|
+----------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
|
|
| :ref:`Array<class_array>` | :ref:`get_fullscreen_mode_list<class_OS_get_fullscreen_mode_list>` **(** :ref:`int<class_int>` screen=0 **)** const |
|
|
+----------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
|
|
| :ref:`int<class_int>` | :ref:`get_screen_count<class_OS_get_screen_count>` **(** **)** const |
|
|
+----------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
|
|
| :ref:`int<class_int>` | :ref:`get_current_screen<class_OS_get_current_screen>` **(** **)** const |
|
|
+----------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
|
|
| void | :ref:`set_current_screen<class_OS_set_current_screen>` **(** :ref:`int<class_int>` screen **)** |
|
|
+----------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
|
|
| :ref:`Vector2<class_vector2>` | :ref:`get_screen_position<class_OS_get_screen_position>` **(** :ref:`int<class_int>` screen=0 **)** const |
|
|
+----------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
|
|
| :ref:`Vector2<class_vector2>` | :ref:`get_screen_size<class_OS_get_screen_size>` **(** :ref:`int<class_int>` screen=0 **)** const |
|
|
+----------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
|
|
| :ref:`Vector2<class_vector2>` | :ref:`get_window_position<class_OS_get_window_position>` **(** **)** const |
|
|
+----------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
|
|
| void | :ref:`set_window_position<class_OS_set_window_position>` **(** :ref:`Vector2<class_vector2>` position **)** |
|
|
+----------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
|
|
| :ref:`Vector2<class_vector2>` | :ref:`get_window_size<class_OS_get_window_size>` **(** **)** const |
|
|
+----------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
|
|
| void | :ref:`set_window_size<class_OS_set_window_size>` **(** :ref:`Vector2<class_vector2>` size **)** |
|
|
+----------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
|
|
| void | :ref:`set_window_fullscreen<class_OS_set_window_fullscreen>` **(** :ref:`bool<class_bool>` enabled **)** |
|
|
+----------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
|
|
| :ref:`bool<class_bool>` | :ref:`is_window_fullscreen<class_OS_is_window_fullscreen>` **(** **)** const |
|
|
+----------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
|
|
| void | :ref:`set_window_resizable<class_OS_set_window_resizable>` **(** :ref:`bool<class_bool>` enabled **)** |
|
|
+----------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
|
|
| :ref:`bool<class_bool>` | :ref:`is_window_resizable<class_OS_is_window_resizable>` **(** **)** const |
|
|
+----------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
|
|
| void | :ref:`set_window_minimized<class_OS_set_window_minimized>` **(** :ref:`bool<class_bool>` enabled **)** |
|
|
+----------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
|
|
| :ref:`bool<class_bool>` | :ref:`is_window_minimized<class_OS_is_window_minimized>` **(** **)** const |
|
|
+----------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
|
|
| void | :ref:`set_window_maximized<class_OS_set_window_maximized>` **(** :ref:`bool<class_bool>` enabled **)** |
|
|
+----------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
|
|
| :ref:`bool<class_bool>` | :ref:`is_window_maximized<class_OS_is_window_maximized>` **(** **)** const |
|
|
+----------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
|
|
| void | :ref:`set_screen_orientation<class_OS_set_screen_orientation>` **(** :ref:`int<class_int>` orientation **)** |
|
|
+----------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
|
|
| :ref:`int<class_int>` | :ref:`get_screen_orientation<class_OS_get_screen_orientation>` **(** **)** const |
|
|
+----------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
|
|
| void | :ref:`set_keep_screen_on<class_OS_set_keep_screen_on>` **(** :ref:`bool<class_bool>` enabled **)** |
|
|
+----------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
|
|
| :ref:`bool<class_bool>` | :ref:`is_keep_screen_on<class_OS_is_keep_screen_on>` **(** **)** const |
|
|
+----------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
|
|
| void | :ref:`set_iterations_per_second<class_OS_set_iterations_per_second>` **(** :ref:`int<class_int>` iterations_per_second **)** |
|
|
+----------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
|
|
| :ref:`int<class_int>` | :ref:`get_iterations_per_second<class_OS_get_iterations_per_second>` **(** **)** const |
|
|
+----------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
|
|
| void | :ref:`set_target_fps<class_OS_set_target_fps>` **(** :ref:`int<class_int>` target_fps **)** |
|
|
+----------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
|
|
| :ref:`float<class_float>` | :ref:`get_target_fps<class_OS_get_target_fps>` **(** **)** const |
|
|
+----------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
|
|
| void | :ref:`set_time_scale<class_OS_set_time_scale>` **(** :ref:`float<class_float>` time_scale **)** |
|
|
+----------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
|
|
| :ref:`float<class_float>` | :ref:`get_time_scale<class_OS_get_time_scale>` **(** **)** |
|
|
+----------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
|
|
| :ref:`bool<class_bool>` | :ref:`has_touchscreen_ui_hint<class_OS_has_touchscreen_ui_hint>` **(** **)** const |
|
|
+----------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
|
|
| void | :ref:`set_window_title<class_OS_set_window_title>` **(** :ref:`String<class_string>` title **)** |
|
|
+----------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
|
|
| void | :ref:`set_low_processor_usage_mode<class_OS_set_low_processor_usage_mode>` **(** :ref:`bool<class_bool>` enable **)** |
|
|
+----------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
|
|
| :ref:`bool<class_bool>` | :ref:`is_in_low_processor_usage_mode<class_OS_is_in_low_processor_usage_mode>` **(** **)** const |
|
|
+----------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
|
|
| :ref:`int<class_int>` | :ref:`get_processor_count<class_OS_get_processor_count>` **(** **)** const |
|
|
+----------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
|
|
| :ref:`String<class_string>` | :ref:`get_executable_path<class_OS_get_executable_path>` **(** **)** const |
|
|
+----------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
|
|
| :ref:`int<class_int>` | :ref:`execute<class_OS_execute>` **(** :ref:`String<class_string>` path, :ref:`StringArray<class_stringarray>` arguments, :ref:`bool<class_bool>` blocking, :ref:`Array<class_array>` output=Array() **)** |
|
|
+----------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
|
|
| :ref:`int<class_int>` | :ref:`kill<class_OS_kill>` **(** :ref:`int<class_int>` pid **)** |
|
|
+----------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
|
|
| :ref:`int<class_int>` | :ref:`shell_open<class_OS_shell_open>` **(** :ref:`String<class_string>` uri **)** |
|
|
+----------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
|
|
| :ref:`int<class_int>` | :ref:`get_process_ID<class_OS_get_process_ID>` **(** **)** const |
|
|
+----------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
|
|
| :ref:`String<class_string>` | :ref:`get_environment<class_OS_get_environment>` **(** :ref:`String<class_string>` environment **)** const |
|
|
+----------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
|
|
| :ref:`bool<class_bool>` | :ref:`has_environment<class_OS_has_environment>` **(** :ref:`String<class_string>` environment **)** const |
|
|
+----------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
|
|
| :ref:`String<class_string>` | :ref:`get_name<class_OS_get_name>` **(** **)** const |
|
|
+----------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
|
|
| :ref:`StringArray<class_stringarray>` | :ref:`get_cmdline_args<class_OS_get_cmdline_args>` **(** **)** |
|
|
+----------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
|
|
| :ref:`Object<class_object>` | :ref:`get_main_loop<class_OS_get_main_loop>` **(** **)** const |
|
|
+----------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
|
|
| :ref:`Dictionary<class_dictionary>` | :ref:`get_date<class_OS_get_date>` **(** :ref:`bool<class_bool>` utc=false **)** const |
|
|
+----------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
|
|
| :ref:`Dictionary<class_dictionary>` | :ref:`get_time<class_OS_get_time>` **(** :ref:`bool<class_bool>` utc=false **)** const |
|
|
+----------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
|
|
| :ref:`Dictionary<class_dictionary>` | :ref:`get_time_zone_info<class_OS_get_time_zone_info>` **(** **)** const |
|
|
+----------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
|
|
| :ref:`int<class_int>` | :ref:`get_unix_time<class_OS_get_unix_time>` **(** **)** const |
|
|
+----------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
|
|
| :ref:`int<class_int>` | :ref:`get_system_time_secs<class_OS_get_system_time_secs>` **(** **)** const |
|
|
+----------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
|
|
| void | :ref:`set_icon<class_OS_set_icon>` **(** :ref:`Image<class_image>` icon **)** |
|
|
+----------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
|
|
| void | :ref:`delay_usec<class_OS_delay_usec>` **(** :ref:`int<class_int>` usec **)** const |
|
|
+----------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
|
|
| void | :ref:`delay_msec<class_OS_delay_msec>` **(** :ref:`int<class_int>` msec **)** const |
|
|
+----------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
|
|
| :ref:`int<class_int>` | :ref:`get_ticks_msec<class_OS_get_ticks_msec>` **(** **)** const |
|
|
+----------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
|
|
| :ref:`int<class_int>` | :ref:`get_splash_tick_msec<class_OS_get_splash_tick_msec>` **(** **)** const |
|
|
+----------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
|
|
| :ref:`String<class_string>` | :ref:`get_locale<class_OS_get_locale>` **(** **)** const |
|
|
+----------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
|
|
| :ref:`String<class_string>` | :ref:`get_model_name<class_OS_get_model_name>` **(** **)** const |
|
|
+----------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
|
|
| :ref:`String<class_string>` | :ref:`get_custom_level<class_OS_get_custom_level>` **(** **)** const |
|
|
+----------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
|
|
| :ref:`bool<class_bool>` | :ref:`can_draw<class_OS_can_draw>` **(** **)** const |
|
|
+----------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
|
|
| :ref:`int<class_int>` | :ref:`get_frames_drawn<class_OS_get_frames_drawn>` **(** **)** |
|
|
+----------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
|
|
| :ref:`bool<class_bool>` | :ref:`is_stdout_verbose<class_OS_is_stdout_verbose>` **(** **)** const |
|
|
+----------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
|
|
| :ref:`bool<class_bool>` | :ref:`can_use_threads<class_OS_can_use_threads>` **(** **)** const |
|
|
+----------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
|
|
| :ref:`bool<class_bool>` | :ref:`is_debug_build<class_OS_is_debug_build>` **(** **)** const |
|
|
+----------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
|
|
| void | :ref:`dump_memory_to_file<class_OS_dump_memory_to_file>` **(** :ref:`String<class_string>` file **)** |
|
|
+----------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
|
|
| void | :ref:`dump_resources_to_file<class_OS_dump_resources_to_file>` **(** :ref:`String<class_string>` file **)** |
|
|
+----------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
|
|
| void | :ref:`print_resources_in_use<class_OS_print_resources_in_use>` **(** :ref:`bool<class_bool>` short=false **)** |
|
|
+----------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
|
|
| void | :ref:`print_all_resources<class_OS_print_all_resources>` **(** :ref:`String<class_string>` tofile="" **)** |
|
|
+----------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
|
|
| :ref:`int<class_int>` | :ref:`get_static_memory_usage<class_OS_get_static_memory_usage>` **(** **)** const |
|
|
+----------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
|
|
| :ref:`int<class_int>` | :ref:`get_static_memory_peak_usage<class_OS_get_static_memory_peak_usage>` **(** **)** const |
|
|
+----------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
|
|
| :ref:`int<class_int>` | :ref:`get_dynamic_memory_usage<class_OS_get_dynamic_memory_usage>` **(** **)** const |
|
|
+----------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
|
|
| :ref:`String<class_string>` | :ref:`get_data_dir<class_OS_get_data_dir>` **(** **)** const |
|
|
+----------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
|
|
| :ref:`String<class_string>` | :ref:`get_system_dir<class_OS_get_system_dir>` **(** :ref:`int<class_int>` dir **)** const |
|
|
+----------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
|
|
| :ref:`String<class_string>` | :ref:`get_unique_ID<class_OS_get_unique_ID>` **(** **)** const |
|
|
+----------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
|
|
| :ref:`bool<class_bool>` | :ref:`is_ok_left_and_cancel_right<class_OS_is_ok_left_and_cancel_right>` **(** **)** const |
|
|
+----------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
|
|
| :ref:`float<class_float>` | :ref:`get_frames_per_second<class_OS_get_frames_per_second>` **(** **)** const |
|
|
+----------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
|
|
| void | :ref:`print_all_textures_by_size<class_OS_print_all_textures_by_size>` **(** **)** |
|
|
+----------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
|
|
| void | :ref:`print_resources_by_type<class_OS_print_resources_by_type>` **(** :ref:`StringArray<class_stringarray>` types **)** |
|
|
+----------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
|
|
| :ref:`int<class_int>` | :ref:`native_video_play<class_OS_native_video_play>` **(** :ref:`String<class_string>` path, :ref:`float<class_float>` volume, :ref:`String<class_string>` audio_track, :ref:`String<class_string>` subtitle_track **)** |
|
|
+----------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
|
|
| :ref:`bool<class_bool>` | :ref:`native_video_is_playing<class_OS_native_video_is_playing>` **(** **)** |
|
|
+----------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
|
|
| void | :ref:`native_video_stop<class_OS_native_video_stop>` **(** **)** |
|
|
+----------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
|
|
| void | :ref:`native_video_pause<class_OS_native_video_pause>` **(** **)** |
|
|
+----------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
|
|
| :ref:`String<class_string>` | :ref:`get_scancode_string<class_OS_get_scancode_string>` **(** :ref:`int<class_int>` code **)** const |
|
|
+----------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
|
|
| :ref:`bool<class_bool>` | :ref:`is_scancode_unicode<class_OS_is_scancode_unicode>` **(** :ref:`int<class_int>` code **)** const |
|
|
+----------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
|
|
| :ref:`int<class_int>` | :ref:`find_scancode_from_string<class_OS_find_scancode_from_string>` **(** :ref:`String<class_string>` string **)** const |
|
|
+----------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
|
|
| void | :ref:`set_use_file_access_save_and_swap<class_OS_set_use_file_access_save_and_swap>` **(** :ref:`bool<class_bool>` enabled **)** |
|
|
+----------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
|
|
| void | :ref:`alert<class_OS_alert>` **(** :ref:`String<class_string>` text, :ref:`String<class_string>` title="Alert!" **)** |
|
|
+----------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
|
|
| :ref:`int<class_int>` | :ref:`set_thread_name<class_OS_set_thread_name>` **(** :ref:`String<class_string>` name **)** |
|
|
+----------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
|
|
|
|
Numeric Constants
|
|
-----------------
|
|
|
|
- **DAY_SUNDAY** = **0**
|
|
- **DAY_MONDAY** = **1**
|
|
- **DAY_TUESDAY** = **2**
|
|
- **DAY_WEDNESDAY** = **3**
|
|
- **DAY_THURSDAY** = **4**
|
|
- **DAY_FRIDAY** = **5**
|
|
- **DAY_SATURDAY** = **6**
|
|
- **MONTH_JANUARY** = **0**
|
|
- **MONTH_FEBRUARY** = **1**
|
|
- **MONTH_MARCH** = **2**
|
|
- **MONTH_APRIL** = **3**
|
|
- **MONTH_MAY** = **4**
|
|
- **MONTH_JUNE** = **5**
|
|
- **MONTH_JULY** = **6**
|
|
- **MONTH_AUGUST** = **7**
|
|
- **MONTH_SEPTEMBER** = **8**
|
|
- **MONTH_OCTOBER** = **9**
|
|
- **MONTH_NOVEMBER** = **10**
|
|
- **MONTH_DECEMBER** = **11**
|
|
- **SCREEN_ORIENTATION_LANDSCAPE** = **0**
|
|
- **SCREEN_ORIENTATION_PORTRAIT** = **1**
|
|
- **SCREEN_ORIENTATION_REVERSE_LANDSCAPE** = **2**
|
|
- **SCREEN_ORIENTATION_REVERSE_PORTRAIT** = **3**
|
|
- **SCREEN_ORIENTATION_SENSOR_LANDSCAPE** = **4**
|
|
- **SCREEN_ORIENTATION_SENSOR_PORTRAIT** = **5**
|
|
- **SCREEN_ORIENTATION_SENSOR** = **6**
|
|
- **SYSTEM_DIR_DESKTOP** = **0**
|
|
- **SYSTEM_DIR_DCIM** = **1**
|
|
- **SYSTEM_DIR_DOCUMENTS** = **2**
|
|
- **SYSTEM_DIR_DOWNLOADS** = **3**
|
|
- **SYSTEM_DIR_MOVIES** = **4**
|
|
- **SYSTEM_DIR_MUSIC** = **5**
|
|
- **SYSTEM_DIR_PICTURES** = **6**
|
|
- **SYSTEM_DIR_RINGTONES** = **7**
|
|
|
|
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 " Time
|
|
|
|
-Timers
|
|
|
|
-Environment Variables
|
|
|
|
-Execution of Binaries
|
|
|
|
-Command Line
|
|
|
|
Member Function Description
|
|
---------------------------
|
|
|
|
.. _class_OS_set_clipboard:
|
|
|
|
- void **set_clipboard** **(** :ref:`String<class_string>` clipboard **)**
|
|
|
|
Set clipboard to the OS.
|
|
|
|
.. _class_OS_get_clipboard:
|
|
|
|
- :ref:`String<class_string>` **get_clipboard** **(** **)** const
|
|
|
|
Get clipboard from the host OS.
|
|
|
|
.. _class_OS_set_video_mode:
|
|
|
|
- void **set_video_mode** **(** :ref:`Vector2<class_vector2>` size, :ref:`bool<class_bool>` fullscreen, :ref:`bool<class_bool>` resizable, :ref:`int<class_int>` screen=0 **)**
|
|
|
|
Change the video mode.
|
|
|
|
.. _class_OS_get_video_mode_size:
|
|
|
|
- :ref:`Vector2<class_vector2>` **get_video_mode_size** **(** :ref:`int<class_int>` screen=0 **)** const
|
|
|
|
Return the current video mode size.
|
|
|
|
.. _class_OS_is_video_mode_fullscreen:
|
|
|
|
- :ref:`bool<class_bool>` **is_video_mode_fullscreen** **(** :ref:`int<class_int>` screen=0 **)** const
|
|
|
|
Return true if the current video mode is fullscreen.
|
|
|
|
.. _class_OS_is_video_mode_resizable:
|
|
|
|
- :ref:`bool<class_bool>` **is_video_mode_resizable** **(** :ref:`int<class_int>` screen=0 **)** const
|
|
|
|
Return true if the window is resizable.
|
|
|
|
.. _class_OS_get_fullscreen_mode_list:
|
|
|
|
- :ref:`Array<class_array>` **get_fullscreen_mode_list** **(** :ref:`int<class_int>` screen=0 **)** const
|
|
|
|
Return the list of fullscreen modes.
|
|
|
|
.. _class_OS_get_screen_count:
|
|
|
|
- :ref:`int<class_int>` **get_screen_count** **(** **)** const
|
|
|
|
.. _class_OS_get_current_screen:
|
|
|
|
- :ref:`int<class_int>` **get_current_screen** **(** **)** const
|
|
|
|
.. _class_OS_set_current_screen:
|
|
|
|
- void **set_current_screen** **(** :ref:`int<class_int>` screen **)**
|
|
|
|
.. _class_OS_get_screen_position:
|
|
|
|
- :ref:`Vector2<class_vector2>` **get_screen_position** **(** :ref:`int<class_int>` screen=0 **)** const
|
|
|
|
.. _class_OS_get_screen_size:
|
|
|
|
- :ref:`Vector2<class_vector2>` **get_screen_size** **(** :ref:`int<class_int>` screen=0 **)** const
|
|
|
|
.. _class_OS_get_window_position:
|
|
|
|
- :ref:`Vector2<class_vector2>` **get_window_position** **(** **)** const
|
|
|
|
.. _class_OS_set_window_position:
|
|
|
|
- void **set_window_position** **(** :ref:`Vector2<class_vector2>` position **)**
|
|
|
|
.. _class_OS_get_window_size:
|
|
|
|
- :ref:`Vector2<class_vector2>` **get_window_size** **(** **)** const
|
|
|
|
.. _class_OS_set_window_size:
|
|
|
|
- void **set_window_size** **(** :ref:`Vector2<class_vector2>` size **)**
|
|
|
|
.. _class_OS_set_window_fullscreen:
|
|
|
|
- void **set_window_fullscreen** **(** :ref:`bool<class_bool>` enabled **)**
|
|
|
|
.. _class_OS_is_window_fullscreen:
|
|
|
|
- :ref:`bool<class_bool>` **is_window_fullscreen** **(** **)** const
|
|
|
|
.. _class_OS_set_window_resizable:
|
|
|
|
- void **set_window_resizable** **(** :ref:`bool<class_bool>` enabled **)**
|
|
|
|
.. _class_OS_is_window_resizable:
|
|
|
|
- :ref:`bool<class_bool>` **is_window_resizable** **(** **)** const
|
|
|
|
.. _class_OS_set_window_minimized:
|
|
|
|
- void **set_window_minimized** **(** :ref:`bool<class_bool>` enabled **)**
|
|
|
|
.. _class_OS_is_window_minimized:
|
|
|
|
- :ref:`bool<class_bool>` **is_window_minimized** **(** **)** const
|
|
|
|
.. _class_OS_set_window_maximized:
|
|
|
|
- void **set_window_maximized** **(** :ref:`bool<class_bool>` enabled **)**
|
|
|
|
.. _class_OS_is_window_maximized:
|
|
|
|
- :ref:`bool<class_bool>` **is_window_maximized** **(** **)** const
|
|
|
|
.. _class_OS_set_screen_orientation:
|
|
|
|
- void **set_screen_orientation** **(** :ref:`int<class_int>` orientation **)**
|
|
|
|
.. _class_OS_get_screen_orientation:
|
|
|
|
- :ref:`int<class_int>` **get_screen_orientation** **(** **)** const
|
|
|
|
.. _class_OS_set_keep_screen_on:
|
|
|
|
- void **set_keep_screen_on** **(** :ref:`bool<class_bool>` enabled **)**
|
|
|
|
Set keep screen on if true, or goes to sleep by device setting if false. (for Android/iOS)
|
|
|
|
.. _class_OS_is_keep_screen_on:
|
|
|
|
- :ref:`bool<class_bool>` **is_keep_screen_on** **(** **)** const
|
|
|
|
.. _class_OS_set_iterations_per_second:
|
|
|
|
- void **set_iterations_per_second** **(** :ref:`int<class_int>` iterations_per_second **)**
|
|
|
|
Set the amount of fixed iterations per second (for fixed process and physics).
|
|
|
|
.. _class_OS_get_iterations_per_second:
|
|
|
|
- :ref:`int<class_int>` **get_iterations_per_second** **(** **)** const
|
|
|
|
Return the amount of fixed iterations per second (for fixed process and physics).
|
|
|
|
.. _class_OS_set_target_fps:
|
|
|
|
- void **set_target_fps** **(** :ref:`int<class_int>` target_fps **)**
|
|
|
|
.. _class_OS_get_target_fps:
|
|
|
|
- :ref:`float<class_float>` **get_target_fps** **(** **)** const
|
|
|
|
.. _class_OS_set_time_scale:
|
|
|
|
- void **set_time_scale** **(** :ref:`float<class_float>` time_scale **)**
|
|
|
|
.. _class_OS_get_time_scale:
|
|
|
|
- :ref:`float<class_float>` **get_time_scale** **(** **)**
|
|
|
|
.. _class_OS_has_touchscreen_ui_hint:
|
|
|
|
- :ref:`bool<class_bool>` **has_touchscreen_ui_hint** **(** **)** const
|
|
|
|
.. _class_OS_set_window_title:
|
|
|
|
- void **set_window_title** **(** :ref:`String<class_string>` title **)**
|
|
|
|
.. _class_OS_set_low_processor_usage_mode:
|
|
|
|
- void **set_low_processor_usage_mode** **(** :ref:`bool<class_bool>` enable **)**
|
|
|
|
Set to true to enable the low cpu usage mode. In this mode, the screen only redraws when there are changes, and a considerable sleep time is inserted between frames. This way, editors using the engine UI only use very little cpu.
|
|
|
|
.. _class_OS_is_in_low_processor_usage_mode:
|
|
|
|
- :ref:`bool<class_bool>` **is_in_low_processor_usage_mode** **(** **)** const
|
|
|
|
Return true if low cpu usage mode is enabled.
|
|
|
|
.. _class_OS_get_processor_count:
|
|
|
|
- :ref:`int<class_int>` **get_processor_count** **(** **)** const
|
|
|
|
.. _class_OS_get_executable_path:
|
|
|
|
- :ref:`String<class_string>` **get_executable_path** **(** **)** const
|
|
|
|
Return the path to the current engine executable.
|
|
|
|
.. _class_OS_execute:
|
|
|
|
- :ref:`int<class_int>` **execute** **(** :ref:`String<class_string>` path, :ref:`StringArray<class_stringarray>` arguments, :ref:`bool<class_bool>` blocking, :ref:`Array<class_array>` output=Array() **)**
|
|
|
|
Execute the binary file in given path, optionally blocking until it returns. A process ID is returned.
|
|
|
|
.. _class_OS_kill:
|
|
|
|
- :ref:`int<class_int>` **kill** **(** :ref:`int<class_int>` pid **)**
|
|
|
|
Kill a process ID.
|
|
|
|
.. _class_OS_shell_open:
|
|
|
|
- :ref:`int<class_int>` **shell_open** **(** :ref:`String<class_string>` uri **)**
|
|
|
|
.. _class_OS_get_process_ID:
|
|
|
|
- :ref:`int<class_int>` **get_process_ID** **(** **)** const
|
|
|
|
.. _class_OS_get_environment:
|
|
|
|
- :ref:`String<class_string>` **get_environment** **(** :ref:`String<class_string>` environment **)** const
|
|
|
|
Return an environment variable.
|
|
|
|
.. _class_OS_has_environment:
|
|
|
|
- :ref:`bool<class_bool>` **has_environment** **(** :ref:`String<class_string>` environment **)** const
|
|
|
|
Return true if an envieronment variable exists.
|
|
|
|
.. _class_OS_get_name:
|
|
|
|
- :ref:`String<class_string>` **get_name** **(** **)** const
|
|
|
|
Return the name of the host OS.
|
|
|
|
.. _class_OS_get_cmdline_args:
|
|
|
|
- :ref:`StringArray<class_stringarray>` **get_cmdline_args** **(** **)**
|
|
|
|
Return the commandline passed to the engine.
|
|
|
|
.. _class_OS_get_main_loop:
|
|
|
|
- :ref:`Object<class_object>` **get_main_loop** **(** **)** const
|
|
|
|
Return the main loop object (see :ref:`MainLoop<class_mainloop>`).
|
|
|
|
.. _class_OS_get_date:
|
|
|
|
- :ref:`Dictionary<class_dictionary>` **get_date** **(** :ref:`bool<class_bool>` utc=false **)** const
|
|
|
|
.. _class_OS_get_time:
|
|
|
|
- :ref:`Dictionary<class_dictionary>` **get_time** **(** :ref:`bool<class_bool>` utc=false **)** const
|
|
|
|
.. _class_OS_get_time_zone_info:
|
|
|
|
- :ref:`Dictionary<class_dictionary>` **get_time_zone_info** **(** **)** const
|
|
|
|
.. _class_OS_get_unix_time:
|
|
|
|
- :ref:`int<class_int>` **get_unix_time** **(** **)** const
|
|
|
|
.. _class_OS_get_system_time_secs:
|
|
|
|
- :ref:`int<class_int>` **get_system_time_secs** **(** **)** const
|
|
|
|
.. _class_OS_set_icon:
|
|
|
|
- void **set_icon** **(** :ref:`Image<class_image>` icon **)**
|
|
|
|
.. _class_OS_delay_usec:
|
|
|
|
- void **delay_usec** **(** :ref:`int<class_int>` usec **)** const
|
|
|
|
Delay executing of the current thread by given microseconds.
|
|
|
|
.. _class_OS_delay_msec:
|
|
|
|
- void **delay_msec** **(** :ref:`int<class_int>` msec **)** const
|
|
|
|
Delay executing of the current thread by given milliseconds.
|
|
|
|
.. _class_OS_get_ticks_msec:
|
|
|
|
- :ref:`int<class_int>` **get_ticks_msec** **(** **)** const
|
|
|
|
Return the amount of time passed in milliseconds since the engine started.
|
|
|
|
.. _class_OS_get_splash_tick_msec:
|
|
|
|
- :ref:`int<class_int>` **get_splash_tick_msec** **(** **)** const
|
|
|
|
.. _class_OS_get_locale:
|
|
|
|
- :ref:`String<class_string>` **get_locale** **(** **)** const
|
|
|
|
Return the host OS locale.
|
|
|
|
.. _class_OS_get_model_name:
|
|
|
|
- :ref:`String<class_string>` **get_model_name** **(** **)** const
|
|
|
|
.. _class_OS_get_custom_level:
|
|
|
|
- :ref:`String<class_string>` **get_custom_level** **(** **)** const
|
|
|
|
.. _class_OS_can_draw:
|
|
|
|
- :ref:`bool<class_bool>` **can_draw** **(** **)** const
|
|
|
|
Return true if the host OS allows drawing.
|
|
|
|
.. _class_OS_get_frames_drawn:
|
|
|
|
- :ref:`int<class_int>` **get_frames_drawn** **(** **)**
|
|
|
|
Return the total amount of frames drawn.
|
|
|
|
.. _class_OS_is_stdout_verbose:
|
|
|
|
- :ref:`bool<class_bool>` **is_stdout_verbose** **(** **)** const
|
|
|
|
Return true if the engine was executed with -v (verbose stdout).
|
|
|
|
.. _class_OS_can_use_threads:
|
|
|
|
- :ref:`bool<class_bool>` **can_use_threads** **(** **)** const
|
|
|
|
.. _class_OS_is_debug_build:
|
|
|
|
- :ref:`bool<class_bool>` **is_debug_build** **(** **)** const
|
|
|
|
.. _class_OS_dump_memory_to_file:
|
|
|
|
- void **dump_memory_to_file** **(** :ref:`String<class_string>` file **)**
|
|
|
|
.. _class_OS_dump_resources_to_file:
|
|
|
|
- void **dump_resources_to_file** **(** :ref:`String<class_string>` file **)**
|
|
|
|
.. _class_OS_print_resources_in_use:
|
|
|
|
- void **print_resources_in_use** **(** :ref:`bool<class_bool>` short=false **)**
|
|
|
|
.. _class_OS_print_all_resources:
|
|
|
|
- void **print_all_resources** **(** :ref:`String<class_string>` tofile="" **)**
|
|
|
|
.. _class_OS_get_static_memory_usage:
|
|
|
|
- :ref:`int<class_int>` **get_static_memory_usage** **(** **)** const
|
|
|
|
.. _class_OS_get_static_memory_peak_usage:
|
|
|
|
- :ref:`int<class_int>` **get_static_memory_peak_usage** **(** **)** const
|
|
|
|
Return the max amount of static memory used (only works in debug).
|
|
|
|
.. _class_OS_get_dynamic_memory_usage:
|
|
|
|
- :ref:`int<class_int>` **get_dynamic_memory_usage** **(** **)** const
|
|
|
|
Return the total amount of dynamic memory used (only works in debug).
|
|
|
|
.. _class_OS_get_data_dir:
|
|
|
|
- :ref:`String<class_string>` **get_data_dir** **(** **)** const
|
|
|
|
.. _class_OS_get_system_dir:
|
|
|
|
- :ref:`String<class_string>` **get_system_dir** **(** :ref:`int<class_int>` dir **)** const
|
|
|
|
.. _class_OS_get_unique_ID:
|
|
|
|
- :ref:`String<class_string>` **get_unique_ID** **(** **)** const
|
|
|
|
.. _class_OS_is_ok_left_and_cancel_right:
|
|
|
|
- :ref:`bool<class_bool>` **is_ok_left_and_cancel_right** **(** **)** const
|
|
|
|
.. _class_OS_get_frames_per_second:
|
|
|
|
- :ref:`float<class_float>` **get_frames_per_second** **(** **)** const
|
|
|
|
.. _class_OS_print_all_textures_by_size:
|
|
|
|
- void **print_all_textures_by_size** **(** **)**
|
|
|
|
.. _class_OS_print_resources_by_type:
|
|
|
|
- void **print_resources_by_type** **(** :ref:`StringArray<class_stringarray>` types **)**
|
|
|
|
.. _class_OS_native_video_play:
|
|
|
|
- :ref:`int<class_int>` **native_video_play** **(** :ref:`String<class_string>` path, :ref:`float<class_float>` volume, :ref:`String<class_string>` audio_track, :ref:`String<class_string>` subtitle_track **)**
|
|
|
|
.. _class_OS_native_video_is_playing:
|
|
|
|
- :ref:`bool<class_bool>` **native_video_is_playing** **(** **)**
|
|
|
|
.. _class_OS_native_video_stop:
|
|
|
|
- void **native_video_stop** **(** **)**
|
|
|
|
.. _class_OS_native_video_pause:
|
|
|
|
- void **native_video_pause** **(** **)**
|
|
|
|
.. _class_OS_get_scancode_string:
|
|
|
|
- :ref:`String<class_string>` **get_scancode_string** **(** :ref:`int<class_int>` code **)** const
|
|
|
|
.. _class_OS_is_scancode_unicode:
|
|
|
|
- :ref:`bool<class_bool>` **is_scancode_unicode** **(** :ref:`int<class_int>` code **)** const
|
|
|
|
.. _class_OS_find_scancode_from_string:
|
|
|
|
- :ref:`int<class_int>` **find_scancode_from_string** **(** :ref:`String<class_string>` string **)** const
|
|
|
|
.. _class_OS_set_use_file_access_save_and_swap:
|
|
|
|
- void **set_use_file_access_save_and_swap** **(** :ref:`bool<class_bool>` enabled **)**
|
|
|
|
.. _class_OS_alert:
|
|
|
|
- void **alert** **(** :ref:`String<class_string>` text, :ref:`String<class_string>` title="Alert!" **)**
|
|
|
|
.. _class_OS_set_thread_name:
|
|
|
|
- :ref:`int<class_int>` **set_thread_name** **(** :ref:`String<class_string>` name **)**
|
|
|
|
|