godotengine/godot-docs-l10n
1
0
Fork 0
mirror of https://github.com/godotengine/godot-docs-l10n.git synced 2026-01-04 10:09:56 +03:00
Code Issues Packages Projects Releases Wiki Activity
Files
4.x
godot-docs-l10n/classes/zh_Hant/class_@globalscope.rst
Rémi Verschelde c3f2364c10 Sync classref with 4.6 branch 
Lots of translations invalidated (fuzzied) as we just synced Weblate.
2025-12-19 16:39:51 +01:00

7656 lines
329 KiB
ReStructuredText
Raw Permalink Blame History

This file contains ambiguous Unicode characters

This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

:github_url: hide
.. _class_@GlobalScope:
@GlobalScope
============
全域範圍的常數和函式。
.. rst-class:: classref-introduction-group
說明
----
全域範圍的列舉常數與內建函式列表，包含所有存在於全域命名空間中的錯誤碼、按鍵碼、屬性提示等常數。
單例亦記載於此，因為它們可於任何位置存取。
若為僅能於 GDScript 腳本中存取的項目，請參閱 :ref:`@GDScript<class_@GDScript>`\ 。
.. note::
使用 C# 操作此 API 時有顯著差異，詳見 :ref:`doc_c_sharp_differences`。
.. rst-class:: classref-introduction-group
教學
----
- :doc:`亂數產生 <../tutorials/math/random_number_generation>`
.. rst-class:: classref-reftable-group
屬性
----
.. table::
:widths: auto
+-------------------------------------------------------------------+-----------------------------------------------------------------------------------------+
| :ref:`AudioServer<class_AudioServer>` | :ref:`AudioServer<class_@GlobalScope_property_AudioServer>` |
+-------------------------------------------------------------------+-----------------------------------------------------------------------------------------+
| :ref:`CameraServer<class_CameraServer>` | :ref:`CameraServer<class_@GlobalScope_property_CameraServer>` |
+-------------------------------------------------------------------+-----------------------------------------------------------------------------------------+
| :ref:`ClassDB<class_ClassDB>` | :ref:`ClassDB<class_@GlobalScope_property_ClassDB>` |
+-------------------------------------------------------------------+-----------------------------------------------------------------------------------------+
| :ref:`DisplayServer<class_DisplayServer>` | :ref:`DisplayServer<class_@GlobalScope_property_DisplayServer>` |
+-------------------------------------------------------------------+-----------------------------------------------------------------------------------------+
| :ref:`EditorInterface<class_EditorInterface>` | :ref:`EditorInterface<class_@GlobalScope_property_EditorInterface>` |
+-------------------------------------------------------------------+-----------------------------------------------------------------------------------------+
| :ref:`Engine<class_Engine>` | :ref:`Engine<class_@GlobalScope_property_Engine>` |
+-------------------------------------------------------------------+-----------------------------------------------------------------------------------------+
| :ref:`EngineDebugger<class_EngineDebugger>` | :ref:`EngineDebugger<class_@GlobalScope_property_EngineDebugger>` |
+-------------------------------------------------------------------+-----------------------------------------------------------------------------------------+
| :ref:`GDExtensionManager<class_GDExtensionManager>` | :ref:`GDExtensionManager<class_@GlobalScope_property_GDExtensionManager>` |
+-------------------------------------------------------------------+-----------------------------------------------------------------------------------------+
| :ref:`Geometry2D<class_Geometry2D>` | :ref:`Geometry2D<class_@GlobalScope_property_Geometry2D>` |
+-------------------------------------------------------------------+-----------------------------------------------------------------------------------------+
| :ref:`Geometry3D<class_Geometry3D>` | :ref:`Geometry3D<class_@GlobalScope_property_Geometry3D>` |
+-------------------------------------------------------------------+-----------------------------------------------------------------------------------------+
| :ref:`IP<class_IP>` | :ref:`IP<class_@GlobalScope_property_IP>` |
+-------------------------------------------------------------------+-----------------------------------------------------------------------------------------+
| :ref:`Input<class_Input>` | :ref:`Input<class_@GlobalScope_property_Input>` |
+-------------------------------------------------------------------+-----------------------------------------------------------------------------------------+
| :ref:`InputMap<class_InputMap>` | :ref:`InputMap<class_@GlobalScope_property_InputMap>` |
+-------------------------------------------------------------------+-----------------------------------------------------------------------------------------+
| :ref:`JavaClassWrapper<class_JavaClassWrapper>` | :ref:`JavaClassWrapper<class_@GlobalScope_property_JavaClassWrapper>` |
+-------------------------------------------------------------------+-----------------------------------------------------------------------------------------+
| :ref:`JavaScriptBridge<class_JavaScriptBridge>` | :ref:`JavaScriptBridge<class_@GlobalScope_property_JavaScriptBridge>` |
+-------------------------------------------------------------------+-----------------------------------------------------------------------------------------+
| :ref:`Marshalls<class_Marshalls>` | :ref:`Marshalls<class_@GlobalScope_property_Marshalls>` |
+-------------------------------------------------------------------+-----------------------------------------------------------------------------------------+
| :ref:`NativeMenu<class_NativeMenu>` | :ref:`NativeMenu<class_@GlobalScope_property_NativeMenu>` |
+-------------------------------------------------------------------+-----------------------------------------------------------------------------------------+
| :ref:`NavigationMeshGenerator<class_NavigationMeshGenerator>` | :ref:`NavigationMeshGenerator<class_@GlobalScope_property_NavigationMeshGenerator>` |
+-------------------------------------------------------------------+-----------------------------------------------------------------------------------------+
| :ref:`NavigationServer2D<class_NavigationServer2D>` | :ref:`NavigationServer2D<class_@GlobalScope_property_NavigationServer2D>` |
+-------------------------------------------------------------------+-----------------------------------------------------------------------------------------+
| :ref:`NavigationServer2DManager<class_NavigationServer2DManager>` | :ref:`NavigationServer2DManager<class_@GlobalScope_property_NavigationServer2DManager>` |
+-------------------------------------------------------------------+-----------------------------------------------------------------------------------------+
| :ref:`NavigationServer3D<class_NavigationServer3D>` | :ref:`NavigationServer3D<class_@GlobalScope_property_NavigationServer3D>` |
+-------------------------------------------------------------------+-----------------------------------------------------------------------------------------+
| :ref:`NavigationServer3DManager<class_NavigationServer3DManager>` | :ref:`NavigationServer3DManager<class_@GlobalScope_property_NavigationServer3DManager>` |
+-------------------------------------------------------------------+-----------------------------------------------------------------------------------------+
| :ref:`OS<class_OS>` | :ref:`OS<class_@GlobalScope_property_OS>` |
+-------------------------------------------------------------------+-----------------------------------------------------------------------------------------+
| :ref:`Performance<class_Performance>` | :ref:`Performance<class_@GlobalScope_property_Performance>` |
+-------------------------------------------------------------------+-----------------------------------------------------------------------------------------+
| :ref:`PhysicsServer2D<class_PhysicsServer2D>` | :ref:`PhysicsServer2D<class_@GlobalScope_property_PhysicsServer2D>` |
+-------------------------------------------------------------------+-----------------------------------------------------------------------------------------+
| :ref:`PhysicsServer2DManager<class_PhysicsServer2DManager>` | :ref:`PhysicsServer2DManager<class_@GlobalScope_property_PhysicsServer2DManager>` |
+-------------------------------------------------------------------+-----------------------------------------------------------------------------------------+
| :ref:`PhysicsServer3D<class_PhysicsServer3D>` | :ref:`PhysicsServer3D<class_@GlobalScope_property_PhysicsServer3D>` |
+-------------------------------------------------------------------+-----------------------------------------------------------------------------------------+
| :ref:`PhysicsServer3DManager<class_PhysicsServer3DManager>` | :ref:`PhysicsServer3DManager<class_@GlobalScope_property_PhysicsServer3DManager>` |
+-------------------------------------------------------------------+-----------------------------------------------------------------------------------------+
| :ref:`ProjectSettings<class_ProjectSettings>` | :ref:`ProjectSettings<class_@GlobalScope_property_ProjectSettings>` |
+-------------------------------------------------------------------+-----------------------------------------------------------------------------------------+
| :ref:`RenderingServer<class_RenderingServer>` | :ref:`RenderingServer<class_@GlobalScope_property_RenderingServer>` |
+-------------------------------------------------------------------+-----------------------------------------------------------------------------------------+
| :ref:`ResourceLoader<class_ResourceLoader>` | :ref:`ResourceLoader<class_@GlobalScope_property_ResourceLoader>` |
+-------------------------------------------------------------------+-----------------------------------------------------------------------------------------+
| :ref:`ResourceSaver<class_ResourceSaver>` | :ref:`ResourceSaver<class_@GlobalScope_property_ResourceSaver>` |
+-------------------------------------------------------------------+-----------------------------------------------------------------------------------------+
| :ref:`ResourceUID<class_ResourceUID>` | :ref:`ResourceUID<class_@GlobalScope_property_ResourceUID>` |
+-------------------------------------------------------------------+-----------------------------------------------------------------------------------------+
| :ref:`TextServerManager<class_TextServerManager>` | :ref:`TextServerManager<class_@GlobalScope_property_TextServerManager>` |
+-------------------------------------------------------------------+-----------------------------------------------------------------------------------------+
| :ref:`ThemeDB<class_ThemeDB>` | :ref:`ThemeDB<class_@GlobalScope_property_ThemeDB>` |
+-------------------------------------------------------------------+-----------------------------------------------------------------------------------------+
| :ref:`Time<class_Time>` | :ref:`Time<class_@GlobalScope_property_Time>` |
+-------------------------------------------------------------------+-----------------------------------------------------------------------------------------+
| :ref:`TranslationServer<class_TranslationServer>` | :ref:`TranslationServer<class_@GlobalScope_property_TranslationServer>` |
+-------------------------------------------------------------------+-----------------------------------------------------------------------------------------+
| :ref:`WorkerThreadPool<class_WorkerThreadPool>` | :ref:`WorkerThreadPool<class_@GlobalScope_property_WorkerThreadPool>` |
+-------------------------------------------------------------------+-----------------------------------------------------------------------------------------+
| :ref:`XRServer<class_XRServer>` | :ref:`XRServer<class_@GlobalScope_property_XRServer>` |
+-------------------------------------------------------------------+-----------------------------------------------------------------------------------------+
.. rst-class:: classref-reftable-group
方法
----
.. table::
:widths: auto
+-------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
| :ref:`Variant<class_Variant>` | :ref:`abs<class_@GlobalScope_method_abs>`\ (\ x\: :ref:`Variant<class_Variant>`\ ) |
+-------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
| :ref:`float<class_float>` | :ref:`absf<class_@GlobalScope_method_absf>`\ (\ x\: :ref:`float<class_float>`\ ) |
+-------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
| :ref:`int<class_int>` | :ref:`absi<class_@GlobalScope_method_absi>`\ (\ x\: :ref:`int<class_int>`\ ) |
+-------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
| :ref:`float<class_float>` | :ref:`acos<class_@GlobalScope_method_acos>`\ (\ x\: :ref:`float<class_float>`\ ) |
+-------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
| :ref:`float<class_float>` | :ref:`acosh<class_@GlobalScope_method_acosh>`\ (\ x\: :ref:`float<class_float>`\ ) |
+-------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
| :ref:`float<class_float>` | :ref:`angle_difference<class_@GlobalScope_method_angle_difference>`\ (\ from\: :ref:`float<class_float>`, to\: :ref:`float<class_float>`\ ) |
+-------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
| :ref:`float<class_float>` | :ref:`asin<class_@GlobalScope_method_asin>`\ (\ x\: :ref:`float<class_float>`\ ) |
+-------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
| :ref:`float<class_float>` | :ref:`asinh<class_@GlobalScope_method_asinh>`\ (\ x\: :ref:`float<class_float>`\ ) |
+-------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
| :ref:`float<class_float>` | :ref:`atan<class_@GlobalScope_method_atan>`\ (\ x\: :ref:`float<class_float>`\ ) |
+-------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
| :ref:`float<class_float>` | :ref:`atan2<class_@GlobalScope_method_atan2>`\ (\ y\: :ref:`float<class_float>`, x\: :ref:`float<class_float>`\ ) |
+-------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
| :ref:`float<class_float>` | :ref:`atanh<class_@GlobalScope_method_atanh>`\ (\ x\: :ref:`float<class_float>`\ ) |
+-------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
| :ref:`float<class_float>` | :ref:`bezier_derivative<class_@GlobalScope_method_bezier_derivative>`\ (\ start\: :ref:`float<class_float>`, control_1\: :ref:`float<class_float>`, control_2\: :ref:`float<class_float>`, end\: :ref:`float<class_float>`, t\: :ref:`float<class_float>`\ ) |
+-------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
| :ref:`float<class_float>` | :ref:`bezier_interpolate<class_@GlobalScope_method_bezier_interpolate>`\ (\ start\: :ref:`float<class_float>`, control_1\: :ref:`float<class_float>`, control_2\: :ref:`float<class_float>`, end\: :ref:`float<class_float>`, t\: :ref:`float<class_float>`\ ) |
+-------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
| :ref:`Variant<class_Variant>` | :ref:`bytes_to_var<class_@GlobalScope_method_bytes_to_var>`\ (\ bytes\: :ref:`PackedByteArray<class_PackedByteArray>`\ ) |
+-------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
| :ref:`Variant<class_Variant>` | :ref:`bytes_to_var_with_objects<class_@GlobalScope_method_bytes_to_var_with_objects>`\ (\ bytes\: :ref:`PackedByteArray<class_PackedByteArray>`\ ) |
+-------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
| :ref:`Variant<class_Variant>` | :ref:`ceil<class_@GlobalScope_method_ceil>`\ (\ x\: :ref:`Variant<class_Variant>`\ ) |
+-------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
| :ref:`float<class_float>` | :ref:`ceilf<class_@GlobalScope_method_ceilf>`\ (\ x\: :ref:`float<class_float>`\ ) |
+-------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
| :ref:`int<class_int>` | :ref:`ceili<class_@GlobalScope_method_ceili>`\ (\ x\: :ref:`float<class_float>`\ ) |
+-------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
| :ref:`Variant<class_Variant>` | :ref:`clamp<class_@GlobalScope_method_clamp>`\ (\ value\: :ref:`Variant<class_Variant>`, min\: :ref:`Variant<class_Variant>`, max\: :ref:`Variant<class_Variant>`\ ) |
+-------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
| :ref:`float<class_float>` | :ref:`clampf<class_@GlobalScope_method_clampf>`\ (\ value\: :ref:`float<class_float>`, min\: :ref:`float<class_float>`, max\: :ref:`float<class_float>`\ ) |
+-------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
| :ref:`int<class_int>` | :ref:`clampi<class_@GlobalScope_method_clampi>`\ (\ value\: :ref:`int<class_int>`, min\: :ref:`int<class_int>`, max\: :ref:`int<class_int>`\ ) |
+-------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
| :ref:`float<class_float>` | :ref:`cos<class_@GlobalScope_method_cos>`\ (\ angle_rad\: :ref:`float<class_float>`\ ) |
+-------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
| :ref:`float<class_float>` | :ref:`cosh<class_@GlobalScope_method_cosh>`\ (\ x\: :ref:`float<class_float>`\ ) |
+-------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
| :ref:`float<class_float>` | :ref:`cubic_interpolate<class_@GlobalScope_method_cubic_interpolate>`\ (\ from\: :ref:`float<class_float>`, to\: :ref:`float<class_float>`, pre\: :ref:`float<class_float>`, post\: :ref:`float<class_float>`, weight\: :ref:`float<class_float>`\ ) |
+-------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
| :ref:`float<class_float>` | :ref:`cubic_interpolate_angle<class_@GlobalScope_method_cubic_interpolate_angle>`\ (\ from\: :ref:`float<class_float>`, to\: :ref:`float<class_float>`, pre\: :ref:`float<class_float>`, post\: :ref:`float<class_float>`, weight\: :ref:`float<class_float>`\ ) |
+-------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
| :ref:`float<class_float>` | :ref:`cubic_interpolate_angle_in_time<class_@GlobalScope_method_cubic_interpolate_angle_in_time>`\ (\ from\: :ref:`float<class_float>`, to\: :ref:`float<class_float>`, pre\: :ref:`float<class_float>`, post\: :ref:`float<class_float>`, weight\: :ref:`float<class_float>`, to_t\: :ref:`float<class_float>`, pre_t\: :ref:`float<class_float>`, post_t\: :ref:`float<class_float>`\ ) |
+-------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
| :ref:`float<class_float>` | :ref:`cubic_interpolate_in_time<class_@GlobalScope_method_cubic_interpolate_in_time>`\ (\ from\: :ref:`float<class_float>`, to\: :ref:`float<class_float>`, pre\: :ref:`float<class_float>`, post\: :ref:`float<class_float>`, weight\: :ref:`float<class_float>`, to_t\: :ref:`float<class_float>`, pre_t\: :ref:`float<class_float>`, post_t\: :ref:`float<class_float>`\ ) |
+-------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
| :ref:`float<class_float>` | :ref:`db_to_linear<class_@GlobalScope_method_db_to_linear>`\ (\ db\: :ref:`float<class_float>`\ ) |
+-------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
| :ref:`float<class_float>` | :ref:`deg_to_rad<class_@GlobalScope_method_deg_to_rad>`\ (\ deg\: :ref:`float<class_float>`\ ) |
+-------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
| :ref:`float<class_float>` | :ref:`ease<class_@GlobalScope_method_ease>`\ (\ x\: :ref:`float<class_float>`, curve\: :ref:`float<class_float>`\ ) |
+-------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
| :ref:`String<class_String>` | :ref:`error_string<class_@GlobalScope_method_error_string>`\ (\ error\: :ref:`int<class_int>`\ ) |
+-------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
| :ref:`float<class_float>` | :ref:`exp<class_@GlobalScope_method_exp>`\ (\ x\: :ref:`float<class_float>`\ ) |
+-------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
| :ref:`Variant<class_Variant>` | :ref:`floor<class_@GlobalScope_method_floor>`\ (\ x\: :ref:`Variant<class_Variant>`\ ) |
+-------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
| :ref:`float<class_float>` | :ref:`floorf<class_@GlobalScope_method_floorf>`\ (\ x\: :ref:`float<class_float>`\ ) |
+-------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
| :ref:`int<class_int>` | :ref:`floori<class_@GlobalScope_method_floori>`\ (\ x\: :ref:`float<class_float>`\ ) |
+-------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
| :ref:`float<class_float>` | :ref:`fmod<class_@GlobalScope_method_fmod>`\ (\ x\: :ref:`float<class_float>`, y\: :ref:`float<class_float>`\ ) |
+-------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
| :ref:`float<class_float>` | :ref:`fposmod<class_@GlobalScope_method_fposmod>`\ (\ x\: :ref:`float<class_float>`, y\: :ref:`float<class_float>`\ ) |
+-------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
| :ref:`int<class_int>` | :ref:`hash<class_@GlobalScope_method_hash>`\ (\ variable\: :ref:`Variant<class_Variant>`\ ) |
+-------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
| :ref:`Object<class_Object>` | :ref:`instance_from_id<class_@GlobalScope_method_instance_from_id>`\ (\ instance_id\: :ref:`int<class_int>`\ ) |
+-------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
| :ref:`float<class_float>` | :ref:`inverse_lerp<class_@GlobalScope_method_inverse_lerp>`\ (\ from\: :ref:`float<class_float>`, to\: :ref:`float<class_float>`, weight\: :ref:`float<class_float>`\ ) |
+-------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
| :ref:`bool<class_bool>` | :ref:`is_equal_approx<class_@GlobalScope_method_is_equal_approx>`\ (\ a\: :ref:`float<class_float>`, b\: :ref:`float<class_float>`\ ) |
+-------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
| :ref:`bool<class_bool>` | :ref:`is_finite<class_@GlobalScope_method_is_finite>`\ (\ x\: :ref:`float<class_float>`\ ) |
+-------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
| :ref:`bool<class_bool>` | :ref:`is_inf<class_@GlobalScope_method_is_inf>`\ (\ x\: :ref:`float<class_float>`\ ) |
+-------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
| :ref:`bool<class_bool>` | :ref:`is_instance_id_valid<class_@GlobalScope_method_is_instance_id_valid>`\ (\ id\: :ref:`int<class_int>`\ ) |
+-------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
| :ref:`bool<class_bool>` | :ref:`is_instance_valid<class_@GlobalScope_method_is_instance_valid>`\ (\ instance\: :ref:`Variant<class_Variant>`\ ) |
+-------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
| :ref:`bool<class_bool>` | :ref:`is_nan<class_@GlobalScope_method_is_nan>`\ (\ x\: :ref:`float<class_float>`\ ) |
+-------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
| :ref:`bool<class_bool>` | :ref:`is_same<class_@GlobalScope_method_is_same>`\ (\ a\: :ref:`Variant<class_Variant>`, b\: :ref:`Variant<class_Variant>`\ ) |
+-------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
| :ref:`bool<class_bool>` | :ref:`is_zero_approx<class_@GlobalScope_method_is_zero_approx>`\ (\ x\: :ref:`float<class_float>`\ ) |
+-------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
| :ref:`Variant<class_Variant>` | :ref:`lerp<class_@GlobalScope_method_lerp>`\ (\ from\: :ref:`Variant<class_Variant>`, to\: :ref:`Variant<class_Variant>`, weight\: :ref:`Variant<class_Variant>`\ ) |
+-------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
| :ref:`float<class_float>` | :ref:`lerp_angle<class_@GlobalScope_method_lerp_angle>`\ (\ from\: :ref:`float<class_float>`, to\: :ref:`float<class_float>`, weight\: :ref:`float<class_float>`\ ) |
+-------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
| :ref:`float<class_float>` | :ref:`lerpf<class_@GlobalScope_method_lerpf>`\ (\ from\: :ref:`float<class_float>`, to\: :ref:`float<class_float>`, weight\: :ref:`float<class_float>`\ ) |
+-------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
| :ref:`float<class_float>` | :ref:`linear_to_db<class_@GlobalScope_method_linear_to_db>`\ (\ lin\: :ref:`float<class_float>`\ ) |
+-------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
| :ref:`float<class_float>` | :ref:`log<class_@GlobalScope_method_log>`\ (\ x\: :ref:`float<class_float>`\ ) |
+-------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
| :ref:`Variant<class_Variant>` | :ref:`max<class_@GlobalScope_method_max>`\ (\ ...\ ) |vararg| |
+-------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
| :ref:`float<class_float>` | :ref:`maxf<class_@GlobalScope_method_maxf>`\ (\ a\: :ref:`float<class_float>`, b\: :ref:`float<class_float>`\ ) |
+-------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
| :ref:`int<class_int>` | :ref:`maxi<class_@GlobalScope_method_maxi>`\ (\ a\: :ref:`int<class_int>`, b\: :ref:`int<class_int>`\ ) |
+-------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
| :ref:`Variant<class_Variant>` | :ref:`min<class_@GlobalScope_method_min>`\ (\ ...\ ) |vararg| |
+-------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
| :ref:`float<class_float>` | :ref:`minf<class_@GlobalScope_method_minf>`\ (\ a\: :ref:`float<class_float>`, b\: :ref:`float<class_float>`\ ) |
+-------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
| :ref:`int<class_int>` | :ref:`mini<class_@GlobalScope_method_mini>`\ (\ a\: :ref:`int<class_int>`, b\: :ref:`int<class_int>`\ ) |
+-------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
| :ref:`float<class_float>` | :ref:`move_toward<class_@GlobalScope_method_move_toward>`\ (\ from\: :ref:`float<class_float>`, to\: :ref:`float<class_float>`, delta\: :ref:`float<class_float>`\ ) |
+-------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
| :ref:`int<class_int>` | :ref:`nearest_po2<class_@GlobalScope_method_nearest_po2>`\ (\ value\: :ref:`int<class_int>`\ ) |
+-------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
| :ref:`float<class_float>` | :ref:`pingpong<class_@GlobalScope_method_pingpong>`\ (\ value\: :ref:`float<class_float>`, length\: :ref:`float<class_float>`\ ) |
+-------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
| :ref:`int<class_int>` | :ref:`posmod<class_@GlobalScope_method_posmod>`\ (\ x\: :ref:`int<class_int>`, y\: :ref:`int<class_int>`\ ) |
+-------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
| :ref:`float<class_float>` | :ref:`pow<class_@GlobalScope_method_pow>`\ (\ base\: :ref:`float<class_float>`, exp\: :ref:`float<class_float>`\ ) |
+-------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
| |void| | :ref:`print<class_@GlobalScope_method_print>`\ (\ ...\ ) |vararg| |
+-------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
| |void| | :ref:`print_rich<class_@GlobalScope_method_print_rich>`\ (\ ...\ ) |vararg| |
+-------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
| |void| | :ref:`print_verbose<class_@GlobalScope_method_print_verbose>`\ (\ ...\ ) |vararg| |
+-------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
| |void| | :ref:`printerr<class_@GlobalScope_method_printerr>`\ (\ ...\ ) |vararg| |
+-------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
| |void| | :ref:`printraw<class_@GlobalScope_method_printraw>`\ (\ ...\ ) |vararg| |
+-------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
| |void| | :ref:`prints<class_@GlobalScope_method_prints>`\ (\ ...\ ) |vararg| |
+-------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
| |void| | :ref:`printt<class_@GlobalScope_method_printt>`\ (\ ...\ ) |vararg| |
+-------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
| |void| | :ref:`push_error<class_@GlobalScope_method_push_error>`\ (\ ...\ ) |vararg| |
+-------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
| |void| | :ref:`push_warning<class_@GlobalScope_method_push_warning>`\ (\ ...\ ) |vararg| |
+-------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
| :ref:`float<class_float>` | :ref:`rad_to_deg<class_@GlobalScope_method_rad_to_deg>`\ (\ rad\: :ref:`float<class_float>`\ ) |
+-------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
| :ref:`PackedInt64Array<class_PackedInt64Array>` | :ref:`rand_from_seed<class_@GlobalScope_method_rand_from_seed>`\ (\ seed\: :ref:`int<class_int>`\ ) |
+-------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
| :ref:`float<class_float>` | :ref:`randf<class_@GlobalScope_method_randf>`\ (\ ) |
+-------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
| :ref:`float<class_float>` | :ref:`randf_range<class_@GlobalScope_method_randf_range>`\ (\ from\: :ref:`float<class_float>`, to\: :ref:`float<class_float>`\ ) |
+-------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
| :ref:`float<class_float>` | :ref:`randfn<class_@GlobalScope_method_randfn>`\ (\ mean\: :ref:`float<class_float>`, deviation\: :ref:`float<class_float>`\ ) |
+-------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
| :ref:`int<class_int>` | :ref:`randi<class_@GlobalScope_method_randi>`\ (\ ) |
+-------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
| :ref:`int<class_int>` | :ref:`randi_range<class_@GlobalScope_method_randi_range>`\ (\ from\: :ref:`int<class_int>`, to\: :ref:`int<class_int>`\ ) |
+-------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
| |void| | :ref:`randomize<class_@GlobalScope_method_randomize>`\ (\ ) |
+-------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
| :ref:`float<class_float>` | :ref:`remap<class_@GlobalScope_method_remap>`\ (\ value\: :ref:`float<class_float>`, istart\: :ref:`float<class_float>`, istop\: :ref:`float<class_float>`, ostart\: :ref:`float<class_float>`, ostop\: :ref:`float<class_float>`\ ) |
+-------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
| :ref:`int<class_int>` | :ref:`rid_allocate_id<class_@GlobalScope_method_rid_allocate_id>`\ (\ ) |
+-------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
| :ref:`RID<class_RID>` | :ref:`rid_from_int64<class_@GlobalScope_method_rid_from_int64>`\ (\ base\: :ref:`int<class_int>`\ ) |
+-------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
| :ref:`float<class_float>` | :ref:`rotate_toward<class_@GlobalScope_method_rotate_toward>`\ (\ from\: :ref:`float<class_float>`, to\: :ref:`float<class_float>`, delta\: :ref:`float<class_float>`\ ) |
+-------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
| :ref:`Variant<class_Variant>` | :ref:`round<class_@GlobalScope_method_round>`\ (\ x\: :ref:`Variant<class_Variant>`\ ) |
+-------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
| :ref:`float<class_float>` | :ref:`roundf<class_@GlobalScope_method_roundf>`\ (\ x\: :ref:`float<class_float>`\ ) |
+-------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
| :ref:`int<class_int>` | :ref:`roundi<class_@GlobalScope_method_roundi>`\ (\ x\: :ref:`float<class_float>`\ ) |
+-------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
| |void| | :ref:`seed<class_@GlobalScope_method_seed>`\ (\ base\: :ref:`int<class_int>`\ ) |
+-------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
| :ref:`Variant<class_Variant>` | :ref:`sign<class_@GlobalScope_method_sign>`\ (\ x\: :ref:`Variant<class_Variant>`\ ) |
+-------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
| :ref:`float<class_float>` | :ref:`signf<class_@GlobalScope_method_signf>`\ (\ x\: :ref:`float<class_float>`\ ) |
+-------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
| :ref:`int<class_int>` | :ref:`signi<class_@GlobalScope_method_signi>`\ (\ x\: :ref:`int<class_int>`\ ) |
+-------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
| :ref:`float<class_float>` | :ref:`sin<class_@GlobalScope_method_sin>`\ (\ angle_rad\: :ref:`float<class_float>`\ ) |
+-------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
| :ref:`float<class_float>` | :ref:`sinh<class_@GlobalScope_method_sinh>`\ (\ x\: :ref:`float<class_float>`\ ) |
+-------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
| :ref:`float<class_float>` | :ref:`smoothstep<class_@GlobalScope_method_smoothstep>`\ (\ from\: :ref:`float<class_float>`, to\: :ref:`float<class_float>`, x\: :ref:`float<class_float>`\ ) |
+-------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
| :ref:`Variant<class_Variant>` | :ref:`snapped<class_@GlobalScope_method_snapped>`\ (\ x\: :ref:`Variant<class_Variant>`, step\: :ref:`Variant<class_Variant>`\ ) |
+-------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
| :ref:`float<class_float>` | :ref:`snappedf<class_@GlobalScope_method_snappedf>`\ (\ x\: :ref:`float<class_float>`, step\: :ref:`float<class_float>`\ ) |
+-------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
| :ref:`int<class_int>` | :ref:`snappedi<class_@GlobalScope_method_snappedi>`\ (\ x\: :ref:`float<class_float>`, step\: :ref:`int<class_int>`\ ) |
+-------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
| :ref:`float<class_float>` | :ref:`sqrt<class_@GlobalScope_method_sqrt>`\ (\ x\: :ref:`float<class_float>`\ ) |
+-------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
| :ref:`int<class_int>` | :ref:`step_decimals<class_@GlobalScope_method_step_decimals>`\ (\ x\: :ref:`float<class_float>`\ ) |
+-------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
| :ref:`String<class_String>` | :ref:`str<class_@GlobalScope_method_str>`\ (\ ...\ ) |vararg| |
+-------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
| :ref:`Variant<class_Variant>` | :ref:`str_to_var<class_@GlobalScope_method_str_to_var>`\ (\ string\: :ref:`String<class_String>`\ ) |
+-------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
| :ref:`float<class_float>` | :ref:`tan<class_@GlobalScope_method_tan>`\ (\ angle_rad\: :ref:`float<class_float>`\ ) |
+-------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
| :ref:`float<class_float>` | :ref:`tanh<class_@GlobalScope_method_tanh>`\ (\ x\: :ref:`float<class_float>`\ ) |
+-------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
| :ref:`Variant<class_Variant>` | :ref:`type_convert<class_@GlobalScope_method_type_convert>`\ (\ variant\: :ref:`Variant<class_Variant>`, type\: :ref:`int<class_int>`\ ) |
+-------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
| :ref:`String<class_String>` | :ref:`type_string<class_@GlobalScope_method_type_string>`\ (\ type\: :ref:`int<class_int>`\ ) |
+-------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
| :ref:`int<class_int>` | :ref:`typeof<class_@GlobalScope_method_typeof>`\ (\ variable\: :ref:`Variant<class_Variant>`\ ) |
+-------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
| :ref:`PackedByteArray<class_PackedByteArray>` | :ref:`var_to_bytes<class_@GlobalScope_method_var_to_bytes>`\ (\ variable\: :ref:`Variant<class_Variant>`\ ) |
+-------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
| :ref:`PackedByteArray<class_PackedByteArray>` | :ref:`var_to_bytes_with_objects<class_@GlobalScope_method_var_to_bytes_with_objects>`\ (\ variable\: :ref:`Variant<class_Variant>`\ ) |
+-------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
| :ref:`String<class_String>` | :ref:`var_to_str<class_@GlobalScope_method_var_to_str>`\ (\ variable\: :ref:`Variant<class_Variant>`\ ) |
+-------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
| :ref:`Variant<class_Variant>` | :ref:`weakref<class_@GlobalScope_method_weakref>`\ (\ obj\: :ref:`Variant<class_Variant>`\ ) |
+-------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
| :ref:`Variant<class_Variant>` | :ref:`wrap<class_@GlobalScope_method_wrap>`\ (\ value\: :ref:`Variant<class_Variant>`, min\: :ref:`Variant<class_Variant>`, max\: :ref:`Variant<class_Variant>`\ ) |
+-------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
| :ref:`float<class_float>` | :ref:`wrapf<class_@GlobalScope_method_wrapf>`\ (\ value\: :ref:`float<class_float>`, min\: :ref:`float<class_float>`, max\: :ref:`float<class_float>`\ ) |
+-------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
| :ref:`int<class_int>` | :ref:`wrapi<class_@GlobalScope_method_wrapi>`\ (\ value\: :ref:`int<class_int>`, min\: :ref:`int<class_int>`, max\: :ref:`int<class_int>`\ ) |
+-------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
.. rst-class:: classref-section-separator
----
.. rst-class:: classref-descriptions-group
列舉
----
.. _enum_@GlobalScope_Side:
.. rst-class:: classref-enumeration
enum **Side**: :ref:`🔗<enum_@GlobalScope_Side>`
.. _class_@GlobalScope_constant_SIDE_LEFT:
.. rst-class:: classref-enumeration-constant
:ref:`Side<enum_@GlobalScope_Side>` **SIDE_LEFT** = ``0``
左邊，常用於 :ref:`Control<class_Control>` 或 :ref:`StyleBox<class_StyleBox>` 的衍生類。
.. _class_@GlobalScope_constant_SIDE_TOP:
.. rst-class:: classref-enumeration-constant
:ref:`Side<enum_@GlobalScope_Side>` **SIDE_TOP** = ``1``
頂邊，常用於 :ref:`Control<class_Control>` 或 :ref:`StyleBox<class_StyleBox>` 的衍生類。
.. _class_@GlobalScope_constant_SIDE_RIGHT:
.. rst-class:: classref-enumeration-constant
:ref:`Side<enum_@GlobalScope_Side>` **SIDE_RIGHT** = ``2``
右邊，常用於 :ref:`Control<class_Control>` 或 :ref:`StyleBox<class_StyleBox>` 的衍生類。
.. _class_@GlobalScope_constant_SIDE_BOTTOM:
.. rst-class:: classref-enumeration-constant
:ref:`Side<enum_@GlobalScope_Side>` **SIDE_BOTTOM** = ``3``
底邊，常用於 :ref:`Control<class_Control>` 或 :ref:`StyleBox<class_StyleBox>` 的衍生類。
.. rst-class:: classref-item-separator
----
.. _enum_@GlobalScope_Corner:
.. rst-class:: classref-enumeration
enum **Corner**: :ref:`🔗<enum_@GlobalScope_Corner>`
.. _class_@GlobalScope_constant_CORNER_TOP_LEFT:
.. rst-class:: classref-enumeration-constant
:ref:`Corner<enum_@GlobalScope_Corner>` **CORNER_TOP_LEFT** = ``0``
左上角。
.. _class_@GlobalScope_constant_CORNER_TOP_RIGHT:
.. rst-class:: classref-enumeration-constant
:ref:`Corner<enum_@GlobalScope_Corner>` **CORNER_TOP_RIGHT** = ``1``
右上角。
.. _class_@GlobalScope_constant_CORNER_BOTTOM_RIGHT:
.. rst-class:: classref-enumeration-constant
:ref:`Corner<enum_@GlobalScope_Corner>` **CORNER_BOTTOM_RIGHT** = ``2``
右下角。
.. _class_@GlobalScope_constant_CORNER_BOTTOM_LEFT:
.. rst-class:: classref-enumeration-constant
:ref:`Corner<enum_@GlobalScope_Corner>` **CORNER_BOTTOM_LEFT** = ``3``
左下角。
.. rst-class:: classref-item-separator
----
.. _enum_@GlobalScope_Orientation:
.. rst-class:: classref-enumeration
enum **Orientation**: :ref:`🔗<enum_@GlobalScope_Orientation>`
.. _class_@GlobalScope_constant_VERTICAL:
.. rst-class:: classref-enumeration-constant
:ref:`Orientation<enum_@GlobalScope_Orientation>` **VERTICAL** = ``1``
通用垂直對齊，常用於 :ref:`Separator<class_Separator>`\ 、\ :ref:`ScrollBar<class_ScrollBar>`\ 、\ :ref:`Slider<class_Slider>` 等。
.. _class_@GlobalScope_constant_HORIZONTAL:
.. rst-class:: classref-enumeration-constant
:ref:`Orientation<enum_@GlobalScope_Orientation>` **HORIZONTAL** = ``0``
通用水平對齊，常用於 :ref:`Separator<class_Separator>`\ 、\ :ref:`ScrollBar<class_ScrollBar>`\ 、\ :ref:`Slider<class_Slider>` 等。
.. rst-class:: classref-item-separator
----
.. _enum_@GlobalScope_ClockDirection:
.. rst-class:: classref-enumeration
enum **ClockDirection**: :ref:`🔗<enum_@GlobalScope_ClockDirection>`
.. _class_@GlobalScope_constant_CLOCKWISE:
.. rst-class:: classref-enumeration-constant
:ref:`ClockDirection<enum_@GlobalScope_ClockDirection>` **CLOCKWISE** = ``0``
順時針旋轉。被一些方法使用（例如 :ref:`Image.rotate_90()<class_Image_method_rotate_90>`\ ）。
.. _class_@GlobalScope_constant_COUNTERCLOCKWISE:
.. rst-class:: classref-enumeration-constant
:ref:`ClockDirection<enum_@GlobalScope_ClockDirection>` **COUNTERCLOCKWISE** = ``1``
逆時針旋轉。被一些方法使用（例如 :ref:`Image.rotate_90()<class_Image_method_rotate_90>`\ ）。
.. rst-class:: classref-item-separator
----
.. _enum_@GlobalScope_HorizontalAlignment:
.. rst-class:: classref-enumeration
enum **HorizontalAlignment**: :ref:`🔗<enum_@GlobalScope_HorizontalAlignment>`
.. _class_@GlobalScope_constant_HORIZONTAL_ALIGNMENT_LEFT:
.. rst-class:: classref-enumeration-constant
:ref:`HorizontalAlignment<enum_@GlobalScope_HorizontalAlignment>` **HORIZONTAL_ALIGNMENT_LEFT** = ``0``
水平左對齊，常用於文字衍生類。
.. _class_@GlobalScope_constant_HORIZONTAL_ALIGNMENT_CENTER:
.. rst-class:: classref-enumeration-constant
:ref:`HorizontalAlignment<enum_@GlobalScope_HorizontalAlignment>` **HORIZONTAL_ALIGNMENT_CENTER** = ``1``
水平居中對齊，常用於文字衍生類。
.. _class_@GlobalScope_constant_HORIZONTAL_ALIGNMENT_RIGHT:
.. rst-class:: classref-enumeration-constant
:ref:`HorizontalAlignment<enum_@GlobalScope_HorizontalAlignment>` **HORIZONTAL_ALIGNMENT_RIGHT** = ``2``
水平右對齊，常用於文字衍生類。
.. _class_@GlobalScope_constant_HORIZONTAL_ALIGNMENT_FILL:
.. rst-class:: classref-enumeration-constant
:ref:`HorizontalAlignment<enum_@GlobalScope_HorizontalAlignment>` **HORIZONTAL_ALIGNMENT_FILL** = ``3``
擴充行以適應寬度，常用於文字衍生類。
.. rst-class:: classref-item-separator
----
.. _enum_@GlobalScope_VerticalAlignment:
.. rst-class:: classref-enumeration
enum **VerticalAlignment**: :ref:`🔗<enum_@GlobalScope_VerticalAlignment>`
.. _class_@GlobalScope_constant_VERTICAL_ALIGNMENT_TOP:
.. rst-class:: classref-enumeration-constant
:ref:`VerticalAlignment<enum_@GlobalScope_VerticalAlignment>` **VERTICAL_ALIGNMENT_TOP** = ``0``
垂直上對齊，常用於文字衍生類。
.. _class_@GlobalScope_constant_VERTICAL_ALIGNMENT_CENTER:
.. rst-class:: classref-enumeration-constant
:ref:`VerticalAlignment<enum_@GlobalScope_VerticalAlignment>` **VERTICAL_ALIGNMENT_CENTER** = ``1``
垂直居中對齊，常用於文字衍生類。
.. _class_@GlobalScope_constant_VERTICAL_ALIGNMENT_BOTTOM:
.. rst-class:: classref-enumeration-constant
:ref:`VerticalAlignment<enum_@GlobalScope_VerticalAlignment>` **VERTICAL_ALIGNMENT_BOTTOM** = ``2``
垂直下對齊，常用於文字衍生類。
.. _class_@GlobalScope_constant_VERTICAL_ALIGNMENT_FILL:
.. rst-class:: classref-enumeration-constant
:ref:`VerticalAlignment<enum_@GlobalScope_VerticalAlignment>` **VERTICAL_ALIGNMENT_FILL** = ``3``
擴充行以適應高度，通常用於文字衍生類。
.. rst-class:: classref-item-separator
----
.. _enum_@GlobalScope_InlineAlignment:
.. rst-class:: classref-enumeration
enum **InlineAlignment**: :ref:`🔗<enum_@GlobalScope_InlineAlignment>`
.. _class_@GlobalScope_constant_INLINE_ALIGNMENT_TOP_TO:
.. rst-class:: classref-enumeration-constant
:ref:`InlineAlignment<enum_@GlobalScope_InlineAlignment>` **INLINE_ALIGNMENT_TOP_TO** = ``0``
將行內物件（例如圖像、表格）的頂部與 ``INLINE_ALIGNMENT_TO_*`` 常數指定的文字位置對齊。
.. _class_@GlobalScope_constant_INLINE_ALIGNMENT_CENTER_TO:
.. rst-class:: classref-enumeration-constant
:ref:`InlineAlignment<enum_@GlobalScope_InlineAlignment>` **INLINE_ALIGNMENT_CENTER_TO** = ``1``
將行內物件（例如圖像、表格）的中心與 ``INLINE_ALIGNMENT_TO_*`` 常數指定的文字位置對齊。
.. _class_@GlobalScope_constant_INLINE_ALIGNMENT_BASELINE_TO:
.. rst-class:: classref-enumeration-constant
:ref:`InlineAlignment<enum_@GlobalScope_InlineAlignment>` **INLINE_ALIGNMENT_BASELINE_TO** = ``3``
將行內物件（如圖像、表格）的基線（使用者定義）與\ ``INLINE_ALIGNMENT_TO_*`` 常數指定的文字位置對齊。
.. _class_@GlobalScope_constant_INLINE_ALIGNMENT_BOTTOM_TO:
.. rst-class:: classref-enumeration-constant
:ref:`InlineAlignment<enum_@GlobalScope_InlineAlignment>` **INLINE_ALIGNMENT_BOTTOM_TO** = ``2``
將行內物件（例如圖像、表格）的底部與 ``INLINE_ALIGNMENT_TO_*`` 常數指定的文字位置對齊。
.. _class_@GlobalScope_constant_INLINE_ALIGNMENT_TO_TOP:
.. rst-class:: classref-enumeration-constant
:ref:`InlineAlignment<enum_@GlobalScope_InlineAlignment>` **INLINE_ALIGNMENT_TO_TOP** = ``0``
將由 ``INLINE_ALIGNMENT_*_TO`` 常數指定的行內物件（例如圖像、表格）的位置與文字頂部對齊。
.. _class_@GlobalScope_constant_INLINE_ALIGNMENT_TO_CENTER:
.. rst-class:: classref-enumeration-constant
:ref:`InlineAlignment<enum_@GlobalScope_InlineAlignment>` **INLINE_ALIGNMENT_TO_CENTER** = ``4``
將由 ``INLINE_ALIGNMENT_*_TO`` 常數指定的行內物件（例如圖像、表格）的位置與文字中心對齊。
.. _class_@GlobalScope_constant_INLINE_ALIGNMENT_TO_BASELINE:
.. rst-class:: classref-enumeration-constant
:ref:`InlineAlignment<enum_@GlobalScope_InlineAlignment>` **INLINE_ALIGNMENT_TO_BASELINE** = ``8``
將由 ``INLINE_ALIGNMENT_*_TO`` 常數指定的行內物件（例如圖像、表格）的位置與文字基線對齊。
.. _class_@GlobalScope_constant_INLINE_ALIGNMENT_TO_BOTTOM:
.. rst-class:: classref-enumeration-constant
:ref:`InlineAlignment<enum_@GlobalScope_InlineAlignment>` **INLINE_ALIGNMENT_TO_BOTTOM** = ``12``
將行內物件（例如圖像、表格）與文字底部對齊。
.. _class_@GlobalScope_constant_INLINE_ALIGNMENT_TOP:
.. rst-class:: classref-enumeration-constant
:ref:`InlineAlignment<enum_@GlobalScope_InlineAlignment>` **INLINE_ALIGNMENT_TOP** = ``0``
將行內物件（例如圖像、表格）的頂部與文字的頂部對齊。等效於 ``INLINE_ALIGNMENT_TOP_TO | INLINE_ALIGNMENT_TO_TOP``\ 。
.. _class_@GlobalScope_constant_INLINE_ALIGNMENT_CENTER:
.. rst-class:: classref-enumeration-constant
:ref:`InlineAlignment<enum_@GlobalScope_InlineAlignment>` **INLINE_ALIGNMENT_CENTER** = ``5``
將行內物件（例如圖像、表格）的中心與文字的中心對齊。相當於 ``INLINE_ALIGNMENT_CENTER_TO | INLINE_ALIGNMENT_TO_CENTER``\ 。
.. _class_@GlobalScope_constant_INLINE_ALIGNMENT_BOTTOM:
.. rst-class:: classref-enumeration-constant
:ref:`InlineAlignment<enum_@GlobalScope_InlineAlignment>` **INLINE_ALIGNMENT_BOTTOM** = ``14``
將行內物件（例如圖像、表格）的底部與文字底部對齊。等效於 ``INLINE_ALIGNMENT_BOTTOM_TO | INLINE_ALIGNMENT_TO_BOTTOM``\ 。
.. _class_@GlobalScope_constant_INLINE_ALIGNMENT_IMAGE_MASK:
.. rst-class:: classref-enumeration-constant
:ref:`InlineAlignment<enum_@GlobalScope_InlineAlignment>` **INLINE_ALIGNMENT_IMAGE_MASK** = ``3``
用於 ``INLINE_ALIGNMENT_*_TO`` 對齊常數的位元遮罩。
.. _class_@GlobalScope_constant_INLINE_ALIGNMENT_TEXT_MASK:
.. rst-class:: classref-enumeration-constant
:ref:`InlineAlignment<enum_@GlobalScope_InlineAlignment>` **INLINE_ALIGNMENT_TEXT_MASK** = ``12``
用於 ``INLINE_ALIGNMENT_TO_*`` 對齊常數的位元遮罩。
.. rst-class:: classref-item-separator
----
.. _enum_@GlobalScope_EulerOrder:
.. rst-class:: classref-enumeration
enum **EulerOrder**: :ref:`🔗<enum_@GlobalScope_EulerOrder>`
.. _class_@GlobalScope_constant_EULER_ORDER_XYZ:
.. rst-class:: classref-enumeration-constant
:ref:`EulerOrder<enum_@GlobalScope_EulerOrder>` **EULER_ORDER_XYZ** = ``0``
指定歐拉角應按 XYZ 順序排列。組合時，順序為 X、Y、Z。分解時，順序相反，先 Z，再 Y，最後 X。
.. _class_@GlobalScope_constant_EULER_ORDER_XZY:
.. rst-class:: classref-enumeration-constant
:ref:`EulerOrder<enum_@GlobalScope_EulerOrder>` **EULER_ORDER_XZY** = ``1``
指定歐拉角應按 XZY 順序排列。組合時，順序為 X、Z、Y。分解時，順序相反，先 Y，再 Z，最後 X。
.. _class_@GlobalScope_constant_EULER_ORDER_YXZ:
.. rst-class:: classref-enumeration-constant
:ref:`EulerOrder<enum_@GlobalScope_EulerOrder>` **EULER_ORDER_YXZ** = ``2``
指定歐拉角應按 YXZ 順序排列。組合時，順序為 Y、X、Z。分解時，順序相反，先 Z，再 X，最後 Y。
.. _class_@GlobalScope_constant_EULER_ORDER_YZX:
.. rst-class:: classref-enumeration-constant
:ref:`EulerOrder<enum_@GlobalScope_EulerOrder>` **EULER_ORDER_YZX** = ``3``
指定歐拉角應按 YZX 順序排列。組合時，順序為 Y、Z、X。分解時，順序相反，先 X，再 Z，最後 Y。
.. _class_@GlobalScope_constant_EULER_ORDER_ZXY:
.. rst-class:: classref-enumeration-constant
:ref:`EulerOrder<enum_@GlobalScope_EulerOrder>` **EULER_ORDER_ZXY** = ``4``
指定歐拉角應按 ZXY 順序排列。組合時，順序為 Z、X、Y。分解時，順序相反，先 Y，再 X，最後 Z。
.. _class_@GlobalScope_constant_EULER_ORDER_ZYX:
.. rst-class:: classref-enumeration-constant
:ref:`EulerOrder<enum_@GlobalScope_EulerOrder>` **EULER_ORDER_ZYX** = ``5``
指定歐拉角應按 ZYX 順序排列。組合時，順序為 Z、Y、X。分解時，順序相反，先 X，再 Y，最後 Z。
.. rst-class:: classref-item-separator
----
.. _enum_@GlobalScope_Key:
.. rst-class:: classref-enumeration
enum **Key**: :ref:`🔗<enum_@GlobalScope_Key>`
.. _class_@GlobalScope_constant_KEY_NONE:
.. rst-class:: classref-enumeration-constant
:ref:`Key<enum_@GlobalScope_Key>` **KEY_NONE** = ``0``
與任何鍵都不對應的列舉值。這用於初始化具有通用狀態的 :ref:`Key<enum_@GlobalScope_Key>` 屬性。
.. _class_@GlobalScope_constant_KEY_SPECIAL:
.. rst-class:: classref-enumeration-constant
:ref:`Key<enum_@GlobalScope_Key>` **KEY_SPECIAL** = ``4194304``
套用此位的鍵碼不可列印。
.. _class_@GlobalScope_constant_KEY_ESCAPE:
.. rst-class:: classref-enumeration-constant
:ref:`Key<enum_@GlobalScope_Key>` **KEY_ESCAPE** = ``4194305``
ESC 鍵。
.. _class_@GlobalScope_constant_KEY_TAB:
.. rst-class:: classref-enumeration-constant
:ref:`Key<enum_@GlobalScope_Key>` **KEY_TAB** = ``4194306``
Tab 鍵。
.. _class_@GlobalScope_constant_KEY_BACKTAB:
.. rst-class:: classref-enumeration-constant
:ref:`Key<enum_@GlobalScope_Key>` **KEY_BACKTAB** = ``4194307``
Shift + Tab 鍵。
.. _class_@GlobalScope_constant_KEY_BACKSPACE:
.. rst-class:: classref-enumeration-constant
:ref:`Key<enum_@GlobalScope_Key>` **KEY_BACKSPACE** = ``4194308``
倒退鍵。
.. _class_@GlobalScope_constant_KEY_ENTER:
.. rst-class:: classref-enumeration-constant
:ref:`Key<enum_@GlobalScope_Key>` **KEY_ENTER** = ``4194309``
確認鍵（位於主鍵盤）。
.. _class_@GlobalScope_constant_KEY_KP_ENTER:
.. rst-class:: classref-enumeration-constant
:ref:`Key<enum_@GlobalScope_Key>` **KEY_KP_ENTER** = ``4194310``
小鍵盤區的確認鍵。
.. _class_@GlobalScope_constant_KEY_INSERT:
.. rst-class:: classref-enumeration-constant
:ref:`Key<enum_@GlobalScope_Key>` **KEY_INSERT** = ``4194311``
Insert 鍵。
.. _class_@GlobalScope_constant_KEY_DELETE:
.. rst-class:: classref-enumeration-constant
:ref:`Key<enum_@GlobalScope_Key>` **KEY_DELETE** = ``4194312``
Delete 鍵。
.. _class_@GlobalScope_constant_KEY_PAUSE:
.. rst-class:: classref-enumeration-constant
:ref:`Key<enum_@GlobalScope_Key>` **KEY_PAUSE** = ``4194313``
Pause 鍵。
.. _class_@GlobalScope_constant_KEY_PRINT:
.. rst-class:: classref-enumeration-constant
:ref:`Key<enum_@GlobalScope_Key>` **KEY_PRINT** = ``4194314``
Print Screen 鍵。
.. _class_@GlobalScope_constant_KEY_SYSREQ:
.. rst-class:: classref-enumeration-constant
:ref:`Key<enum_@GlobalScope_Key>` **KEY_SYSREQ** = ``4194315``
System Request 鍵。
.. _class_@GlobalScope_constant_KEY_CLEAR:
.. rst-class:: classref-enumeration-constant
:ref:`Key<enum_@GlobalScope_Key>` **KEY_CLEAR** = ``4194316``
Clear 鍵。
.. _class_@GlobalScope_constant_KEY_HOME:
.. rst-class:: classref-enumeration-constant
:ref:`Key<enum_@GlobalScope_Key>` **KEY_HOME** = ``4194317``
Home 鍵。
.. _class_@GlobalScope_constant_KEY_END:
.. rst-class:: classref-enumeration-constant
:ref:`Key<enum_@GlobalScope_Key>` **KEY_END** = ``4194318``
End 鍵。
.. _class_@GlobalScope_constant_KEY_LEFT:
.. rst-class:: classref-enumeration-constant
:ref:`Key<enum_@GlobalScope_Key>` **KEY_LEFT** = ``4194319``
左方向鍵。
.. _class_@GlobalScope_constant_KEY_UP:
.. rst-class:: classref-enumeration-constant
:ref:`Key<enum_@GlobalScope_Key>` **KEY_UP** = ``4194320``
上方向鍵。
.. _class_@GlobalScope_constant_KEY_RIGHT:
.. rst-class:: classref-enumeration-constant
:ref:`Key<enum_@GlobalScope_Key>` **KEY_RIGHT** = ``4194321``
右方向鍵。
.. _class_@GlobalScope_constant_KEY_DOWN:
.. rst-class:: classref-enumeration-constant
:ref:`Key<enum_@GlobalScope_Key>` **KEY_DOWN** = ``4194322``
下方向鍵。
.. _class_@GlobalScope_constant_KEY_PAGEUP:
.. rst-class:: classref-enumeration-constant
:ref:`Key<enum_@GlobalScope_Key>` **KEY_PAGEUP** = ``4194323``
Page Up 鍵。
.. _class_@GlobalScope_constant_KEY_PAGEDOWN:
.. rst-class:: classref-enumeration-constant
:ref:`Key<enum_@GlobalScope_Key>` **KEY_PAGEDOWN** = ``4194324``
Page Down 鍵。
.. _class_@GlobalScope_constant_KEY_SHIFT:
.. rst-class:: classref-enumeration-constant
:ref:`Key<enum_@GlobalScope_Key>` **KEY_SHIFT** = ``4194325``
Shift 鍵。
.. _class_@GlobalScope_constant_KEY_CTRL:
.. rst-class:: classref-enumeration-constant
:ref:`Key<enum_@GlobalScope_Key>` **KEY_CTRL** = ``4194326``
Control 鍵。
.. _class_@GlobalScope_constant_KEY_META:
.. rst-class:: classref-enumeration-constant
:ref:`Key<enum_@GlobalScope_Key>` **KEY_META** = ``4194327``
Meta 鍵。
.. _class_@GlobalScope_constant_KEY_ALT:
.. rst-class:: classref-enumeration-constant
:ref:`Key<enum_@GlobalScope_Key>` **KEY_ALT** = ``4194328``
Alt 鍵。
.. _class_@GlobalScope_constant_KEY_CAPSLOCK:
.. rst-class:: classref-enumeration-constant
:ref:`Key<enum_@GlobalScope_Key>` **KEY_CAPSLOCK** = ``4194329``
Caps Lock 鍵。
.. _class_@GlobalScope_constant_KEY_NUMLOCK:
.. rst-class:: classref-enumeration-constant
:ref:`Key<enum_@GlobalScope_Key>` **KEY_NUMLOCK** = ``4194330``
Num Lock 鍵。
.. _class_@GlobalScope_constant_KEY_SCROLLLOCK:
.. rst-class:: classref-enumeration-constant
:ref:`Key<enum_@GlobalScope_Key>` **KEY_SCROLLLOCK** = ``4194331``
Scroll Lock 鍵。
.. _class_@GlobalScope_constant_KEY_F1:
.. rst-class:: classref-enumeration-constant
:ref:`Key<enum_@GlobalScope_Key>` **KEY_F1** = ``4194332``
F1 鍵。
.. _class_@GlobalScope_constant_KEY_F2:
.. rst-class:: classref-enumeration-constant
:ref:`Key<enum_@GlobalScope_Key>` **KEY_F2** = ``4194333``
F2 鍵。
.. _class_@GlobalScope_constant_KEY_F3:
.. rst-class:: classref-enumeration-constant
:ref:`Key<enum_@GlobalScope_Key>` **KEY_F3** = ``4194334``
F3 鍵。
.. _class_@GlobalScope_constant_KEY_F4:
.. rst-class:: classref-enumeration-constant
:ref:`Key<enum_@GlobalScope_Key>` **KEY_F4** = ``4194335``
F4 鍵。
.. _class_@GlobalScope_constant_KEY_F5:
.. rst-class:: classref-enumeration-constant
:ref:`Key<enum_@GlobalScope_Key>` **KEY_F5** = ``4194336``
F5 鍵。
.. _class_@GlobalScope_constant_KEY_F6:
.. rst-class:: classref-enumeration-constant
:ref:`Key<enum_@GlobalScope_Key>` **KEY_F6** = ``4194337``
F6 鍵。
.. _class_@GlobalScope_constant_KEY_F7:
.. rst-class:: classref-enumeration-constant
:ref:`Key<enum_@GlobalScope_Key>` **KEY_F7** = ``4194338``
F7 鍵。
.. _class_@GlobalScope_constant_KEY_F8:
.. rst-class:: classref-enumeration-constant
:ref:`Key<enum_@GlobalScope_Key>` **KEY_F8** = ``4194339``
F8 鍵。
.. _class_@GlobalScope_constant_KEY_F9:
.. rst-class:: classref-enumeration-constant
:ref:`Key<enum_@GlobalScope_Key>` **KEY_F9** = ``4194340``
F9 鍵。
.. _class_@GlobalScope_constant_KEY_F10:
.. rst-class:: classref-enumeration-constant
:ref:`Key<enum_@GlobalScope_Key>` **KEY_F10** = ``4194341``
F10 鍵。
.. _class_@GlobalScope_constant_KEY_F11:
.. rst-class:: classref-enumeration-constant
:ref:`Key<enum_@GlobalScope_Key>` **KEY_F11** = ``4194342``
F11 鍵。
.. _class_@GlobalScope_constant_KEY_F12:
.. rst-class:: classref-enumeration-constant
:ref:`Key<enum_@GlobalScope_Key>` **KEY_F12** = ``4194343``
F12 鍵。
.. _class_@GlobalScope_constant_KEY_F13:
.. rst-class:: classref-enumeration-constant
:ref:`Key<enum_@GlobalScope_Key>` **KEY_F13** = ``4194344``
F13 鍵。
.. _class_@GlobalScope_constant_KEY_F14:
.. rst-class:: classref-enumeration-constant
:ref:`Key<enum_@GlobalScope_Key>` **KEY_F14** = ``4194345``
F14 鍵。
.. _class_@GlobalScope_constant_KEY_F15:
.. rst-class:: classref-enumeration-constant
:ref:`Key<enum_@GlobalScope_Key>` **KEY_F15** = ``4194346``
F15 鍵。
.. _class_@GlobalScope_constant_KEY_F16:
.. rst-class:: classref-enumeration-constant
:ref:`Key<enum_@GlobalScope_Key>` **KEY_F16** = ``4194347``
F16 鍵。
.. _class_@GlobalScope_constant_KEY_F17:
.. rst-class:: classref-enumeration-constant
:ref:`Key<enum_@GlobalScope_Key>` **KEY_F17** = ``4194348``
F17 鍵。
.. _class_@GlobalScope_constant_KEY_F18:
.. rst-class:: classref-enumeration-constant
:ref:`Key<enum_@GlobalScope_Key>` **KEY_F18** = ``4194349``
F18 鍵。
.. _class_@GlobalScope_constant_KEY_F19:
.. rst-class:: classref-enumeration-constant
:ref:`Key<enum_@GlobalScope_Key>` **KEY_F19** = ``4194350``
F19 鍵。
.. _class_@GlobalScope_constant_KEY_F20:
.. rst-class:: classref-enumeration-constant
:ref:`Key<enum_@GlobalScope_Key>` **KEY_F20** = ``4194351``
F20 鍵。
.. _class_@GlobalScope_constant_KEY_F21:
.. rst-class:: classref-enumeration-constant
:ref:`Key<enum_@GlobalScope_Key>` **KEY_F21** = ``4194352``
F21 鍵。
.. _class_@GlobalScope_constant_KEY_F22:
.. rst-class:: classref-enumeration-constant
:ref:`Key<enum_@GlobalScope_Key>` **KEY_F22** = ``4194353``
F22 鍵。
.. _class_@GlobalScope_constant_KEY_F23:
.. rst-class:: classref-enumeration-constant
:ref:`Key<enum_@GlobalScope_Key>` **KEY_F23** = ``4194354``
F23 鍵。
.. _class_@GlobalScope_constant_KEY_F24:
.. rst-class:: classref-enumeration-constant
:ref:`Key<enum_@GlobalScope_Key>` **KEY_F24** = ``4194355``
F24 鍵。
.. _class_@GlobalScope_constant_KEY_F25:
.. rst-class:: classref-enumeration-constant
:ref:`Key<enum_@GlobalScope_Key>` **KEY_F25** = ``4194356``
F25 鍵。由於 Windows 限制，僅支援 macOS 和 Linux。
.. _class_@GlobalScope_constant_KEY_F26:
.. rst-class:: classref-enumeration-constant
:ref:`Key<enum_@GlobalScope_Key>` **KEY_F26** = ``4194357``
F26 鍵。由於 Windows 限制，僅支援 macOS 和 Linux。
.. _class_@GlobalScope_constant_KEY_F27:
.. rst-class:: classref-enumeration-constant
:ref:`Key<enum_@GlobalScope_Key>` **KEY_F27** = ``4194358``
F27 鍵。由於 Windows 限制，僅支援 macOS 和 Linux。
.. _class_@GlobalScope_constant_KEY_F28:
.. rst-class:: classref-enumeration-constant
:ref:`Key<enum_@GlobalScope_Key>` **KEY_F28** = ``4194359``
F28 鍵。由於 Windows 限制，僅支援 macOS 和 Linux。
.. _class_@GlobalScope_constant_KEY_F29:
.. rst-class:: classref-enumeration-constant
:ref:`Key<enum_@GlobalScope_Key>` **KEY_F29** = ``4194360``
F29 鍵。由於 Windows 限制，僅支援 macOS 和 Linux。
.. _class_@GlobalScope_constant_KEY_F30:
.. rst-class:: classref-enumeration-constant
:ref:`Key<enum_@GlobalScope_Key>` **KEY_F30** = ``4194361``
F30 鍵。由於 Windows 限制，僅支援 macOS 和 Linux。
.. _class_@GlobalScope_constant_KEY_F31:
.. rst-class:: classref-enumeration-constant
:ref:`Key<enum_@GlobalScope_Key>` **KEY_F31** = ``4194362``
F31 鍵。由於 Windows 限制，僅支援 macOS 和 Linux。
.. _class_@GlobalScope_constant_KEY_F32:
.. rst-class:: classref-enumeration-constant
:ref:`Key<enum_@GlobalScope_Key>` **KEY_F32** = ``4194363``
F32 鍵。由於 Windows 限制，僅支援 macOS 和 Linux。
.. _class_@GlobalScope_constant_KEY_F33:
.. rst-class:: classref-enumeration-constant
:ref:`Key<enum_@GlobalScope_Key>` **KEY_F33** = ``4194364``
F33 鍵。由於 Windows 限制，僅支援 macOS 和 Linux。
.. _class_@GlobalScope_constant_KEY_F34:
.. rst-class:: classref-enumeration-constant
:ref:`Key<enum_@GlobalScope_Key>` **KEY_F34** = ``4194365``
F34 鍵。由於 Windows 限制，僅支援 macOS 和 Linux。
.. _class_@GlobalScope_constant_KEY_F35:
.. rst-class:: classref-enumeration-constant
:ref:`Key<enum_@GlobalScope_Key>` **KEY_F35** = ``4194366``
F35 鍵。由於 Windows 限制，僅支援 macOS 和 Linux。
.. _class_@GlobalScope_constant_KEY_KP_MULTIPLY:
.. rst-class:: classref-enumeration-constant
:ref:`Key<enum_@GlobalScope_Key>` **KEY_KP_MULTIPLY** = ``4194433``
小鍵盤的星鍵/乘以鍵（\*）。
.. _class_@GlobalScope_constant_KEY_KP_DIVIDE:
.. rst-class:: classref-enumeration-constant
:ref:`Key<enum_@GlobalScope_Key>` **KEY_KP_DIVIDE** = ``4194434``
小鍵盤的除以鍵（/）。
.. _class_@GlobalScope_constant_KEY_KP_SUBTRACT:
.. rst-class:: classref-enumeration-constant
:ref:`Key<enum_@GlobalScope_Key>` **KEY_KP_SUBTRACT** = ``4194435``
小鍵盤的減號鍵（-）。
.. _class_@GlobalScope_constant_KEY_KP_PERIOD:
.. rst-class:: classref-enumeration-constant
:ref:`Key<enum_@GlobalScope_Key>` **KEY_KP_PERIOD** = ``4194436``
小鍵盤的點鍵（.）。
.. _class_@GlobalScope_constant_KEY_KP_ADD:
.. rst-class:: classref-enumeration-constant
:ref:`Key<enum_@GlobalScope_Key>` **KEY_KP_ADD** = ``4194437``
小鍵盤的加號鍵（+）。
.. _class_@GlobalScope_constant_KEY_KP_0:
.. rst-class:: classref-enumeration-constant
:ref:`Key<enum_@GlobalScope_Key>` **KEY_KP_0** = ``4194438``
小鍵盤的數位 0。
.. _class_@GlobalScope_constant_KEY_KP_1:
.. rst-class:: classref-enumeration-constant
:ref:`Key<enum_@GlobalScope_Key>` **KEY_KP_1** = ``4194439``
小鍵盤的數位 1。
.. _class_@GlobalScope_constant_KEY_KP_2:
.. rst-class:: classref-enumeration-constant
:ref:`Key<enum_@GlobalScope_Key>` **KEY_KP_2** = ``4194440``
小鍵盤的數位 2。
.. _class_@GlobalScope_constant_KEY_KP_3:
.. rst-class:: classref-enumeration-constant
:ref:`Key<enum_@GlobalScope_Key>` **KEY_KP_3** = ``4194441``
小鍵盤的數位 3。
.. _class_@GlobalScope_constant_KEY_KP_4:
.. rst-class:: classref-enumeration-constant
:ref:`Key<enum_@GlobalScope_Key>` **KEY_KP_4** = ``4194442``
小鍵盤的數位 4。
.. _class_@GlobalScope_constant_KEY_KP_5:
.. rst-class:: classref-enumeration-constant
:ref:`Key<enum_@GlobalScope_Key>` **KEY_KP_5** = ``4194443``
小鍵盤的數位 5。
.. _class_@GlobalScope_constant_KEY_KP_6:
.. rst-class:: classref-enumeration-constant
:ref:`Key<enum_@GlobalScope_Key>` **KEY_KP_6** = ``4194444``
小鍵盤的數位 6。
.. _class_@GlobalScope_constant_KEY_KP_7:
.. rst-class:: classref-enumeration-constant
:ref:`Key<enum_@GlobalScope_Key>` **KEY_KP_7** = ``4194445``
小鍵盤的數位 7。
.. _class_@GlobalScope_constant_KEY_KP_8:
.. rst-class:: classref-enumeration-constant
:ref:`Key<enum_@GlobalScope_Key>` **KEY_KP_8** = ``4194446``
小鍵盤的數位 8。
.. _class_@GlobalScope_constant_KEY_KP_9:
.. rst-class:: classref-enumeration-constant
:ref:`Key<enum_@GlobalScope_Key>` **KEY_KP_9** = ``4194447``
小鍵盤的數位 9。
.. _class_@GlobalScope_constant_KEY_MENU:
.. rst-class:: classref-enumeration-constant
:ref:`Key<enum_@GlobalScope_Key>` **KEY_MENU** = ``4194370``
本文選單鍵。
.. _class_@GlobalScope_constant_KEY_HYPER:
.. rst-class:: classref-enumeration-constant
:ref:`Key<enum_@GlobalScope_Key>` **KEY_HYPER** = ``4194371``
超級鍵。（僅在 Linux/X11 上）。
.. _class_@GlobalScope_constant_KEY_HELP:
.. rst-class:: classref-enumeration-constant
:ref:`Key<enum_@GlobalScope_Key>` **KEY_HELP** = ``4194373``
Help 鍵。
.. _class_@GlobalScope_constant_KEY_BACK:
.. rst-class:: classref-enumeration-constant
:ref:`Key<enum_@GlobalScope_Key>` **KEY_BACK** = ``4194376``
返回鍵。
.. _class_@GlobalScope_constant_KEY_FORWARD:
.. rst-class:: classref-enumeration-constant
:ref:`Key<enum_@GlobalScope_Key>` **KEY_FORWARD** = ``4194377``
前進鍵。
.. _class_@GlobalScope_constant_KEY_STOP:
.. rst-class:: classref-enumeration-constant
:ref:`Key<enum_@GlobalScope_Key>` **KEY_STOP** = ``4194378``
媒體停止播放鍵。
.. _class_@GlobalScope_constant_KEY_REFRESH:
.. rst-class:: classref-enumeration-constant
:ref:`Key<enum_@GlobalScope_Key>` **KEY_REFRESH** = ``4194379``
重新整理鍵。
.. _class_@GlobalScope_constant_KEY_VOLUMEDOWN:
.. rst-class:: classref-enumeration-constant
:ref:`Key<enum_@GlobalScope_Key>` **KEY_VOLUMEDOWN** = ``4194380``
音量降低鍵。
.. _class_@GlobalScope_constant_KEY_VOLUMEMUTE:
.. rst-class:: classref-enumeration-constant
:ref:`Key<enum_@GlobalScope_Key>` **KEY_VOLUMEMUTE** = ``4194381``
靜音鍵。
.. _class_@GlobalScope_constant_KEY_VOLUMEUP:
.. rst-class:: classref-enumeration-constant
:ref:`Key<enum_@GlobalScope_Key>` **KEY_VOLUMEUP** = ``4194382``
音量升高鍵。
.. _class_@GlobalScope_constant_KEY_MEDIAPLAY:
.. rst-class:: classref-enumeration-constant
:ref:`Key<enum_@GlobalScope_Key>` **KEY_MEDIAPLAY** = ``4194388``
媒體播放鍵。
.. _class_@GlobalScope_constant_KEY_MEDIASTOP:
.. rst-class:: classref-enumeration-constant
:ref:`Key<enum_@GlobalScope_Key>` **KEY_MEDIASTOP** = ``4194389``
媒體停止播放鍵。
.. _class_@GlobalScope_constant_KEY_MEDIAPREVIOUS:
.. rst-class:: classref-enumeration-constant
:ref:`Key<enum_@GlobalScope_Key>` **KEY_MEDIAPREVIOUS** = ``4194390``
上一首歌鍵。
.. _class_@GlobalScope_constant_KEY_MEDIANEXT:
.. rst-class:: classref-enumeration-constant
:ref:`Key<enum_@GlobalScope_Key>` **KEY_MEDIANEXT** = ``4194391``
下一首歌鍵。
.. _class_@GlobalScope_constant_KEY_MEDIARECORD:
.. rst-class:: classref-enumeration-constant
:ref:`Key<enum_@GlobalScope_Key>` **KEY_MEDIARECORD** = ``4194392``
媒體錄製鍵。
.. _class_@GlobalScope_constant_KEY_HOMEPAGE:
.. rst-class:: classref-enumeration-constant
:ref:`Key<enum_@GlobalScope_Key>` **KEY_HOMEPAGE** = ``4194393``
主頁鍵。
.. _class_@GlobalScope_constant_KEY_FAVORITES:
.. rst-class:: classref-enumeration-constant
:ref:`Key<enum_@GlobalScope_Key>` **KEY_FAVORITES** = ``4194394``
收藏鍵。
.. _class_@GlobalScope_constant_KEY_SEARCH:
.. rst-class:: classref-enumeration-constant
:ref:`Key<enum_@GlobalScope_Key>` **KEY_SEARCH** = ``4194395``
搜索鍵。
.. _class_@GlobalScope_constant_KEY_STANDBY:
.. rst-class:: classref-enumeration-constant
:ref:`Key<enum_@GlobalScope_Key>` **KEY_STANDBY** = ``4194396``
Standby 鍵。
.. _class_@GlobalScope_constant_KEY_OPENURL:
.. rst-class:: classref-enumeration-constant
:ref:`Key<enum_@GlobalScope_Key>` **KEY_OPENURL** = ``4194397``
打開 URL / 啟動流覽器鍵。
.. _class_@GlobalScope_constant_KEY_LAUNCHMAIL:
.. rst-class:: classref-enumeration-constant
:ref:`Key<enum_@GlobalScope_Key>` **KEY_LAUNCHMAIL** = ``4194398``
啟動郵箱鍵。
.. _class_@GlobalScope_constant_KEY_LAUNCHMEDIA:
.. rst-class:: classref-enumeration-constant
:ref:`Key<enum_@GlobalScope_Key>` **KEY_LAUNCHMEDIA** = ``4194399``
啟動多媒體鍵。
.. _class_@GlobalScope_constant_KEY_LAUNCH0:
.. rst-class:: classref-enumeration-constant
:ref:`Key<enum_@GlobalScope_Key>` **KEY_LAUNCH0** = ``4194400``
快捷啟動鍵 0。
.. _class_@GlobalScope_constant_KEY_LAUNCH1:
.. rst-class:: classref-enumeration-constant
:ref:`Key<enum_@GlobalScope_Key>` **KEY_LAUNCH1** = ``4194401``
快捷啟動鍵 1。
.. _class_@GlobalScope_constant_KEY_LAUNCH2:
.. rst-class:: classref-enumeration-constant
:ref:`Key<enum_@GlobalScope_Key>` **KEY_LAUNCH2** = ``4194402``
快捷啟動鍵 2。
.. _class_@GlobalScope_constant_KEY_LAUNCH3:
.. rst-class:: classref-enumeration-constant
:ref:`Key<enum_@GlobalScope_Key>` **KEY_LAUNCH3** = ``4194403``
快捷啟動鍵 3。
.. _class_@GlobalScope_constant_KEY_LAUNCH4:
.. rst-class:: classref-enumeration-constant
:ref:`Key<enum_@GlobalScope_Key>` **KEY_LAUNCH4** = ``4194404``
快捷啟動鍵 4。
.. _class_@GlobalScope_constant_KEY_LAUNCH5:
.. rst-class:: classref-enumeration-constant
:ref:`Key<enum_@GlobalScope_Key>` **KEY_LAUNCH5** = ``4194405``
快捷啟動鍵 5。
.. _class_@GlobalScope_constant_KEY_LAUNCH6:
.. rst-class:: classref-enumeration-constant
:ref:`Key<enum_@GlobalScope_Key>` **KEY_LAUNCH6** = ``4194406``
快捷啟動鍵 6。
.. _class_@GlobalScope_constant_KEY_LAUNCH7:
.. rst-class:: classref-enumeration-constant
:ref:`Key<enum_@GlobalScope_Key>` **KEY_LAUNCH7** = ``4194407``
快捷啟動鍵 7。
.. _class_@GlobalScope_constant_KEY_LAUNCH8:
.. rst-class:: classref-enumeration-constant
:ref:`Key<enum_@GlobalScope_Key>` **KEY_LAUNCH8** = ``4194408``
快捷啟動鍵 8。
.. _class_@GlobalScope_constant_KEY_LAUNCH9:
.. rst-class:: classref-enumeration-constant
:ref:`Key<enum_@GlobalScope_Key>` **KEY_LAUNCH9** = ``4194409``
快捷啟動鍵 9。
.. _class_@GlobalScope_constant_KEY_LAUNCHA:
.. rst-class:: classref-enumeration-constant
:ref:`Key<enum_@GlobalScope_Key>` **KEY_LAUNCHA** = ``4194410``
快捷啟動鍵 A。
.. _class_@GlobalScope_constant_KEY_LAUNCHB:
.. rst-class:: classref-enumeration-constant
:ref:`Key<enum_@GlobalScope_Key>` **KEY_LAUNCHB** = ``4194411``
快捷啟動鍵 B。
.. _class_@GlobalScope_constant_KEY_LAUNCHC:
.. rst-class:: classref-enumeration-constant
:ref:`Key<enum_@GlobalScope_Key>` **KEY_LAUNCHC** = ``4194412``
快捷啟動鍵 C。
.. _class_@GlobalScope_constant_KEY_LAUNCHD:
.. rst-class:: classref-enumeration-constant
:ref:`Key<enum_@GlobalScope_Key>` **KEY_LAUNCHD** = ``4194413``
快捷啟動鍵 D。
.. _class_@GlobalScope_constant_KEY_LAUNCHE:
.. rst-class:: classref-enumeration-constant
:ref:`Key<enum_@GlobalScope_Key>` **KEY_LAUNCHE** = ``4194414``
快捷啟動鍵 E。
.. _class_@GlobalScope_constant_KEY_LAUNCHF:
.. rst-class:: classref-enumeration-constant
:ref:`Key<enum_@GlobalScope_Key>` **KEY_LAUNCHF** = ``4194415``
快捷啟動鍵 F。
.. _class_@GlobalScope_constant_KEY_GLOBE:
.. rst-class:: classref-enumeration-constant
:ref:`Key<enum_@GlobalScope_Key>` **KEY_GLOBE** = ``4194416``
Mac / iPad 鍵盤上的“地球”鍵。
.. _class_@GlobalScope_constant_KEY_KEYBOARD:
.. rst-class:: classref-enumeration-constant
:ref:`Key<enum_@GlobalScope_Key>` **KEY_KEYBOARD** = ``4194417``
iPad 鍵盤上的“螢幕鍵盤”鍵。
.. _class_@GlobalScope_constant_KEY_JIS_EISU:
.. rst-class:: classref-enumeration-constant
:ref:`Key<enum_@GlobalScope_Key>` **KEY_JIS_EISU** = ``4194418``
Mac 鍵盤上的英數鍵。
.. _class_@GlobalScope_constant_KEY_JIS_KANA:
.. rst-class:: classref-enumeration-constant
:ref:`Key<enum_@GlobalScope_Key>` **KEY_JIS_KANA** = ``4194419``
Mac 鍵盤上的“かな”鍵。
.. _class_@GlobalScope_constant_KEY_UNKNOWN:
.. rst-class:: classref-enumeration-constant
:ref:`Key<enum_@GlobalScope_Key>` **KEY_UNKNOWN** = ``8388607``
未知鍵。
.. _class_@GlobalScope_constant_KEY_SPACE:
.. rst-class:: classref-enumeration-constant
:ref:`Key<enum_@GlobalScope_Key>` **KEY_SPACE** = ``32``
空白鍵。
.. _class_@GlobalScope_constant_KEY_EXCLAM:
.. rst-class:: classref-enumeration-constant
:ref:`Key<enum_@GlobalScope_Key>` **KEY_EXCLAM** = ``33``
驚嘆號（\ ``!``\ ）鍵。
.. _class_@GlobalScope_constant_KEY_QUOTEDBL:
.. rst-class:: classref-enumeration-constant
:ref:`Key<enum_@GlobalScope_Key>` **KEY_QUOTEDBL** = ``34``
雙引號（\ ``"``\ ）鍵。
.. _class_@GlobalScope_constant_KEY_NUMBERSIGN:
.. rst-class:: classref-enumeration-constant
:ref:`Key<enum_@GlobalScope_Key>` **KEY_NUMBERSIGN** = ``35``
井號或 *hash*\ （\ ``#``\ ）鍵。
.. _class_@GlobalScope_constant_KEY_DOLLAR:
.. rst-class:: classref-enumeration-constant
:ref:`Key<enum_@GlobalScope_Key>` **KEY_DOLLAR** = ``36``
美元符號（\ ``$``\ ）鍵。
.. _class_@GlobalScope_constant_KEY_PERCENT:
.. rst-class:: classref-enumeration-constant
:ref:`Key<enum_@GlobalScope_Key>` **KEY_PERCENT** = ``37``
百分號（\ ``%``\ ）鍵。
.. _class_@GlobalScope_constant_KEY_AMPERSAND:
.. rst-class:: classref-enumeration-constant
:ref:`Key<enum_@GlobalScope_Key>` **KEY_AMPERSAND** = ``38``
和號（\ ``&``\ ）鍵。
.. _class_@GlobalScope_constant_KEY_APOSTROPHE:
.. rst-class:: classref-enumeration-constant
:ref:`Key<enum_@GlobalScope_Key>` **KEY_APOSTROPHE** = ``39``
撇號（\ ``'``\ ）鍵。
.. _class_@GlobalScope_constant_KEY_PARENLEFT:
.. rst-class:: classref-enumeration-constant
:ref:`Key<enum_@GlobalScope_Key>` **KEY_PARENLEFT** = ``40``
左括號（\ ``(``\ ）鍵。
.. _class_@GlobalScope_constant_KEY_PARENRIGHT:
.. rst-class:: classref-enumeration-constant
:ref:`Key<enum_@GlobalScope_Key>` **KEY_PARENRIGHT** = ``41``
右括號（\ ``)``\ ）鍵。
.. _class_@GlobalScope_constant_KEY_ASTERISK:
.. rst-class:: classref-enumeration-constant
:ref:`Key<enum_@GlobalScope_Key>` **KEY_ASTERISK** = ``42``
星號（\ ``*``\ ）鍵。
.. _class_@GlobalScope_constant_KEY_PLUS:
.. rst-class:: classref-enumeration-constant
:ref:`Key<enum_@GlobalScope_Key>` **KEY_PLUS** = ``43``
加號（\ ``+``\ ）鍵。
.. _class_@GlobalScope_constant_KEY_COMMA:
.. rst-class:: classref-enumeration-constant
:ref:`Key<enum_@GlobalScope_Key>` **KEY_COMMA** = ``44``
逗號（\ ``,``\ ）鍵。
.. _class_@GlobalScope_constant_KEY_MINUS:
.. rst-class:: classref-enumeration-constant
:ref:`Key<enum_@GlobalScope_Key>` **KEY_MINUS** = ``45``
減號（\ ``-``\ ）鍵。
.. _class_@GlobalScope_constant_KEY_PERIOD:
.. rst-class:: classref-enumeration-constant
:ref:`Key<enum_@GlobalScope_Key>` **KEY_PERIOD** = ``46``
句點（\ ``.``\ ）鍵。
.. _class_@GlobalScope_constant_KEY_SLASH:
.. rst-class:: classref-enumeration-constant
:ref:`Key<enum_@GlobalScope_Key>` **KEY_SLASH** = ``47``
斜線（\ ``/``\ ）鍵。
.. _class_@GlobalScope_constant_KEY_0:
.. rst-class:: classref-enumeration-constant
:ref:`Key<enum_@GlobalScope_Key>` **KEY_0** = ``48``
數字 0 鍵。
.. _class_@GlobalScope_constant_KEY_1:
.. rst-class:: classref-enumeration-constant
:ref:`Key<enum_@GlobalScope_Key>` **KEY_1** = ``49``
數字 1 鍵。
.. _class_@GlobalScope_constant_KEY_2:
.. rst-class:: classref-enumeration-constant
:ref:`Key<enum_@GlobalScope_Key>` **KEY_2** = ``50``
數字 2 鍵。
.. _class_@GlobalScope_constant_KEY_3:
.. rst-class:: classref-enumeration-constant
:ref:`Key<enum_@GlobalScope_Key>` **KEY_3** = ``51``
數字 3 鍵。
.. _class_@GlobalScope_constant_KEY_4:
.. rst-class:: classref-enumeration-constant
:ref:`Key<enum_@GlobalScope_Key>` **KEY_4** = ``52``
數字 4 鍵。
.. _class_@GlobalScope_constant_KEY_5:
.. rst-class:: classref-enumeration-constant
:ref:`Key<enum_@GlobalScope_Key>` **KEY_5** = ``53``
數字 5 鍵。
.. _class_@GlobalScope_constant_KEY_6:
.. rst-class:: classref-enumeration-constant
:ref:`Key<enum_@GlobalScope_Key>` **KEY_6** = ``54``
數字 6 鍵。
.. _class_@GlobalScope_constant_KEY_7:
.. rst-class:: classref-enumeration-constant
:ref:`Key<enum_@GlobalScope_Key>` **KEY_7** = ``55``
數字 7 鍵。
.. _class_@GlobalScope_constant_KEY_8:
.. rst-class:: classref-enumeration-constant
:ref:`Key<enum_@GlobalScope_Key>` **KEY_8** = ``56``
數字 8 鍵。
.. _class_@GlobalScope_constant_KEY_9:
.. rst-class:: classref-enumeration-constant
:ref:`Key<enum_@GlobalScope_Key>` **KEY_9** = ``57``
數字 9 鍵。
.. _class_@GlobalScope_constant_KEY_COLON:
.. rst-class:: classref-enumeration-constant
:ref:`Key<enum_@GlobalScope_Key>` **KEY_COLON** = ``58``
冒號（\ ``:``\ ）鍵。
.. _class_@GlobalScope_constant_KEY_SEMICOLON:
.. rst-class:: classref-enumeration-constant
:ref:`Key<enum_@GlobalScope_Key>` **KEY_SEMICOLON** = ``59``
分號（\ ``;``\ ）鍵。
.. _class_@GlobalScope_constant_KEY_LESS:
.. rst-class:: classref-enumeration-constant
:ref:`Key<enum_@GlobalScope_Key>` **KEY_LESS** = ``60``
小於號（\ ``<``\ ）鍵。
.. _class_@GlobalScope_constant_KEY_EQUAL:
.. rst-class:: classref-enumeration-constant
:ref:`Key<enum_@GlobalScope_Key>` **KEY_EQUAL** = ``61``
等號（\ ``=``\ ）鍵。
.. _class_@GlobalScope_constant_KEY_GREATER:
.. rst-class:: classref-enumeration-constant
:ref:`Key<enum_@GlobalScope_Key>` **KEY_GREATER** = ``62``
大於號（\ ``>``\ ）鍵。
.. _class_@GlobalScope_constant_KEY_QUESTION:
.. rst-class:: classref-enumeration-constant
:ref:`Key<enum_@GlobalScope_Key>` **KEY_QUESTION** = ``63``
問號（\ ``?``\ ）鍵。
.. _class_@GlobalScope_constant_KEY_AT:
.. rst-class:: classref-enumeration-constant
:ref:`Key<enum_@GlobalScope_Key>` **KEY_AT** = ``64``
at 符號（\ ``@``\ ）鍵。
.. _class_@GlobalScope_constant_KEY_A:
.. rst-class:: classref-enumeration-constant
:ref:`Key<enum_@GlobalScope_Key>` **KEY_A** = ``65``
A 鍵。
.. _class_@GlobalScope_constant_KEY_B:
.. rst-class:: classref-enumeration-constant
:ref:`Key<enum_@GlobalScope_Key>` **KEY_B** = ``66``
B 鍵。
.. _class_@GlobalScope_constant_KEY_C:
.. rst-class:: classref-enumeration-constant
:ref:`Key<enum_@GlobalScope_Key>` **KEY_C** = ``67``
C 鍵。
.. _class_@GlobalScope_constant_KEY_D:
.. rst-class:: classref-enumeration-constant
:ref:`Key<enum_@GlobalScope_Key>` **KEY_D** = ``68``
D 鍵。
.. _class_@GlobalScope_constant_KEY_E:
.. rst-class:: classref-enumeration-constant
:ref:`Key<enum_@GlobalScope_Key>` **KEY_E** = ``69``
E 鍵。
.. _class_@GlobalScope_constant_KEY_F:
.. rst-class:: classref-enumeration-constant
:ref:`Key<enum_@GlobalScope_Key>` **KEY_F** = ``70``
F 鍵。
.. _class_@GlobalScope_constant_KEY_G:
.. rst-class:: classref-enumeration-constant
:ref:`Key<enum_@GlobalScope_Key>` **KEY_G** = ``71``
G 鍵。
.. _class_@GlobalScope_constant_KEY_H:
.. rst-class:: classref-enumeration-constant
:ref:`Key<enum_@GlobalScope_Key>` **KEY_H** = ``72``
H 鍵。
.. _class_@GlobalScope_constant_KEY_I:
.. rst-class:: classref-enumeration-constant
:ref:`Key<enum_@GlobalScope_Key>` **KEY_I** = ``73``
I 鍵。
.. _class_@GlobalScope_constant_KEY_J:
.. rst-class:: classref-enumeration-constant
:ref:`Key<enum_@GlobalScope_Key>` **KEY_J** = ``74``
J 鍵。
.. _class_@GlobalScope_constant_KEY_K:
.. rst-class:: classref-enumeration-constant
:ref:`Key<enum_@GlobalScope_Key>` **KEY_K** = ``75``
K 鍵。
.. _class_@GlobalScope_constant_KEY_L:
.. rst-class:: classref-enumeration-constant
:ref:`Key<enum_@GlobalScope_Key>` **KEY_L** = ``76``
L 鍵。
.. _class_@GlobalScope_constant_KEY_M:
.. rst-class:: classref-enumeration-constant
:ref:`Key<enum_@GlobalScope_Key>` **KEY_M** = ``77``
M 鍵。
.. _class_@GlobalScope_constant_KEY_N:
.. rst-class:: classref-enumeration-constant
:ref:`Key<enum_@GlobalScope_Key>` **KEY_N** = ``78``
N 鍵。
.. _class_@GlobalScope_constant_KEY_O:
.. rst-class:: classref-enumeration-constant
:ref:`Key<enum_@GlobalScope_Key>` **KEY_O** = ``79``
O 鍵。
.. _class_@GlobalScope_constant_KEY_P:
.. rst-class:: classref-enumeration-constant
:ref:`Key<enum_@GlobalScope_Key>` **KEY_P** = ``80``
P 鍵。
.. _class_@GlobalScope_constant_KEY_Q:
.. rst-class:: classref-enumeration-constant
:ref:`Key<enum_@GlobalScope_Key>` **KEY_Q** = ``81``
Q 鍵。
.. _class_@GlobalScope_constant_KEY_R:
.. rst-class:: classref-enumeration-constant
:ref:`Key<enum_@GlobalScope_Key>` **KEY_R** = ``82``
R 鍵。
.. _class_@GlobalScope_constant_KEY_S:
.. rst-class:: classref-enumeration-constant
:ref:`Key<enum_@GlobalScope_Key>` **KEY_S** = ``83``
S 鍵。
.. _class_@GlobalScope_constant_KEY_T:
.. rst-class:: classref-enumeration-constant
:ref:`Key<enum_@GlobalScope_Key>` **KEY_T** = ``84``
T 鍵。
.. _class_@GlobalScope_constant_KEY_U:
.. rst-class:: classref-enumeration-constant
:ref:`Key<enum_@GlobalScope_Key>` **KEY_U** = ``85``
U 鍵。
.. _class_@GlobalScope_constant_KEY_V:
.. rst-class:: classref-enumeration-constant
:ref:`Key<enum_@GlobalScope_Key>` **KEY_V** = ``86``
V 鍵。
.. _class_@GlobalScope_constant_KEY_W:
.. rst-class:: classref-enumeration-constant
:ref:`Key<enum_@GlobalScope_Key>` **KEY_W** = ``87``
W 鍵。
.. _class_@GlobalScope_constant_KEY_X:
.. rst-class:: classref-enumeration-constant
:ref:`Key<enum_@GlobalScope_Key>` **KEY_X** = ``88``
X 鍵。
.. _class_@GlobalScope_constant_KEY_Y:
.. rst-class:: classref-enumeration-constant
:ref:`Key<enum_@GlobalScope_Key>` **KEY_Y** = ``89``
Y 鍵。
.. _class_@GlobalScope_constant_KEY_Z:
.. rst-class:: classref-enumeration-constant
:ref:`Key<enum_@GlobalScope_Key>` **KEY_Z** = ``90``
Z 鍵。
.. _class_@GlobalScope_constant_KEY_BRACKETLEFT:
.. rst-class:: classref-enumeration-constant
:ref:`Key<enum_@GlobalScope_Key>` **KEY_BRACKETLEFT** = ``91``
左中括號（\ ``[lb]``\ ）鍵。
.. _class_@GlobalScope_constant_KEY_BACKSLASH:
.. rst-class:: classref-enumeration-constant
:ref:`Key<enum_@GlobalScope_Key>` **KEY_BACKSLASH** = ``92``
反斜線（\ ``\``\ ）鍵。
.. _class_@GlobalScope_constant_KEY_BRACKETRIGHT:
.. rst-class:: classref-enumeration-constant
:ref:`Key<enum_@GlobalScope_Key>` **KEY_BRACKETRIGHT** = ``93``
右中括號（\ ``[rb]``\ ）鍵。
.. _class_@GlobalScope_constant_KEY_ASCIICIRCUM:
.. rst-class:: classref-enumeration-constant
:ref:`Key<enum_@GlobalScope_Key>` **KEY_ASCIICIRCUM** = ``94``
脫字符號（\ ``^``\ ）鍵。
.. _class_@GlobalScope_constant_KEY_UNDERSCORE:
.. rst-class:: classref-enumeration-constant
:ref:`Key<enum_@GlobalScope_Key>` **KEY_UNDERSCORE** = ``95``
底線（\ ``_``\ ）鍵。
.. _class_@GlobalScope_constant_KEY_QUOTELEFT:
.. rst-class:: classref-enumeration-constant
:ref:`Key<enum_@GlobalScope_Key>` **KEY_QUOTELEFT** = ``96``
反引號（\ `````\ ）鍵。
.. _class_@GlobalScope_constant_KEY_BRACELEFT:
.. rst-class:: classref-enumeration-constant
:ref:`Key<enum_@GlobalScope_Key>` **KEY_BRACELEFT** = ``123``
左大括號（\ ``{``\ ）鍵。
.. _class_@GlobalScope_constant_KEY_BAR:
.. rst-class:: classref-enumeration-constant
:ref:`Key<enum_@GlobalScope_Key>` **KEY_BAR** = ``124``
垂直線／管線符號（\ ``|``\ ）鍵。
.. _class_@GlobalScope_constant_KEY_BRACERIGHT:
.. rst-class:: classref-enumeration-constant
:ref:`Key<enum_@GlobalScope_Key>` **KEY_BRACERIGHT** = ``125``
右大括號（\ ``}``\ ）鍵。
.. _class_@GlobalScope_constant_KEY_ASCIITILDE:
.. rst-class:: classref-enumeration-constant
:ref:`Key<enum_@GlobalScope_Key>` **KEY_ASCIITILDE** = ``126``
波浪號（\ ``~``\ ）鍵。
.. _class_@GlobalScope_constant_KEY_YEN:
.. rst-class:: classref-enumeration-constant
:ref:`Key<enum_@GlobalScope_Key>` **KEY_YEN** = ``165``
日圓符號（\ ``¥``\ ）鍵。
.. _class_@GlobalScope_constant_KEY_SECTION:
.. rst-class:: classref-enumeration-constant
:ref:`Key<enum_@GlobalScope_Key>` **KEY_SECTION** = ``167``
節號符號（\ ``§``\ ）鍵。
.. rst-class:: classref-item-separator
----
.. _enum_@GlobalScope_KeyModifierMask:
.. rst-class:: classref-enumeration
flags **KeyModifierMask**: :ref:`🔗<enum_@GlobalScope_KeyModifierMask>`
.. _class_@GlobalScope_constant_KEY_CODE_MASK:
.. rst-class:: classref-enumeration-constant
:ref:`KeyModifierMask<enum_@GlobalScope_KeyModifierMask>` **KEY_CODE_MASK** = ``8388607``
鍵碼遮罩。
.. _class_@GlobalScope_constant_KEY_MODIFIER_MASK:
.. rst-class:: classref-enumeration-constant
:ref:`KeyModifierMask<enum_@GlobalScope_KeyModifierMask>` **KEY_MODIFIER_MASK** = ``2130706432``
修飾鍵遮罩。
.. _class_@GlobalScope_constant_KEY_MASK_CMD_OR_CTRL:
.. rst-class:: classref-enumeration-constant
:ref:`KeyModifierMask<enum_@GlobalScope_KeyModifierMask>` **KEY_MASK_CMD_OR_CTRL** = ``16777216``
自動重對應為 macOS 上的 :ref:`KEY_META<class_@GlobalScope_constant_KEY_META>` 和其他平臺上的 :ref:`KEY_CTRL<class_@GlobalScope_constant_KEY_CTRL>`\ ，此遮罩在實際事件中從不設定，應僅用於鍵對應。
.. _class_@GlobalScope_constant_KEY_MASK_SHIFT:
.. rst-class:: classref-enumeration-constant
:ref:`KeyModifierMask<enum_@GlobalScope_KeyModifierMask>` **KEY_MASK_SHIFT** = ``33554432``
Shift 鍵遮罩。
.. _class_@GlobalScope_constant_KEY_MASK_ALT:
.. rst-class:: classref-enumeration-constant
:ref:`KeyModifierMask<enum_@GlobalScope_KeyModifierMask>` **KEY_MASK_ALT** = ``67108864``
Alt 或 Option（在 macOS 上）鍵遮罩。
.. _class_@GlobalScope_constant_KEY_MASK_META:
.. rst-class:: classref-enumeration-constant
:ref:`KeyModifierMask<enum_@GlobalScope_KeyModifierMask>` **KEY_MASK_META** = ``134217728``
命令（在 macOS 上）或 Meta/Windows 鍵遮罩。
.. _class_@GlobalScope_constant_KEY_MASK_CTRL:
.. rst-class:: classref-enumeration-constant
:ref:`KeyModifierMask<enum_@GlobalScope_KeyModifierMask>` **KEY_MASK_CTRL** = ``268435456``
Ctrl 鍵遮罩。
.. _class_@GlobalScope_constant_KEY_MASK_KPAD:
.. rst-class:: classref-enumeration-constant
:ref:`KeyModifierMask<enum_@GlobalScope_KeyModifierMask>` **KEY_MASK_KPAD** = ``536870912``
Keypad 鍵遮罩。
.. _class_@GlobalScope_constant_KEY_MASK_GROUP_SWITCH:
.. rst-class:: classref-enumeration-constant
:ref:`KeyModifierMask<enum_@GlobalScope_KeyModifierMask>` **KEY_MASK_GROUP_SWITCH** = ``1073741824``
Group Switch 鍵遮罩。
.. rst-class:: classref-item-separator
----
.. _enum_@GlobalScope_KeyLocation:
.. rst-class:: classref-enumeration
enum **KeyLocation**: :ref:`🔗<enum_@GlobalScope_KeyLocation>`
.. _class_@GlobalScope_constant_KEY_LOCATION_UNSPECIFIED:
.. rst-class:: classref-enumeration-constant
:ref:`KeyLocation<enum_@GlobalScope_KeyLocation>` **KEY_LOCATION_UNSPECIFIED** = ``0``
用於只會出現一次的按鍵，或比較時無需區分 ``LEFT`` 與 ``RIGHT`` 版本的情況。
例如使用 :ref:`InputEvent.is_match()<class_InputEvent_method_is_match>` 時，若事件的按鍵位置為 :ref:`KEY_LOCATION_UNSPECIFIED<class_@GlobalScope_constant_KEY_LOCATION_UNSPECIFIED>`\ ，則可匹配傳入事件的任何 :ref:`KeyLocation<enum_@GlobalScope_KeyLocation>`\ 。
.. _class_@GlobalScope_constant_KEY_LOCATION_LEFT:
.. rst-class:: classref-enumeration-constant
:ref:`KeyLocation<enum_@GlobalScope_KeyLocation>` **KEY_LOCATION_LEFT** = ``1``
位於對應雙生鍵左側的按鍵。
.. _class_@GlobalScope_constant_KEY_LOCATION_RIGHT:
.. rst-class:: classref-enumeration-constant
:ref:`KeyLocation<enum_@GlobalScope_KeyLocation>` **KEY_LOCATION_RIGHT** = ``2``
位於對應雙生鍵右側的按鍵。
.. rst-class:: classref-item-separator
----
.. _enum_@GlobalScope_MouseButton:
.. rst-class:: classref-enumeration
enum **MouseButton**: :ref:`🔗<enum_@GlobalScope_MouseButton>`
.. _class_@GlobalScope_constant_MOUSE_BUTTON_NONE:
.. rst-class:: classref-enumeration-constant
:ref:`MouseButton<enum_@GlobalScope_MouseButton>` **MOUSE_BUTTON_NONE** = ``0``
與任何滑鼠按鈕都不對應的列舉值。這用於初始化具有通用狀態的 :ref:`MouseButton<enum_@GlobalScope_MouseButton>` 屬性。
.. _class_@GlobalScope_constant_MOUSE_BUTTON_LEFT:
.. rst-class:: classref-enumeration-constant
:ref:`MouseButton<enum_@GlobalScope_MouseButton>` **MOUSE_BUTTON_LEFT** = ``1``
滑鼠主鍵，通常分配給左鍵。
.. _class_@GlobalScope_constant_MOUSE_BUTTON_RIGHT:
.. rst-class:: classref-enumeration-constant
:ref:`MouseButton<enum_@GlobalScope_MouseButton>` **MOUSE_BUTTON_RIGHT** = ``2``
滑鼠次鍵，通常分配給右鍵。
.. _class_@GlobalScope_constant_MOUSE_BUTTON_MIDDLE:
.. rst-class:: classref-enumeration-constant
:ref:`MouseButton<enum_@GlobalScope_MouseButton>` **MOUSE_BUTTON_MIDDLE** = ``3``
滑鼠中鍵。
.. _class_@GlobalScope_constant_MOUSE_BUTTON_WHEEL_UP:
.. rst-class:: classref-enumeration-constant
:ref:`MouseButton<enum_@GlobalScope_MouseButton>` **MOUSE_BUTTON_WHEEL_UP** = ``4``
滑鼠滾輪向上滾動。
.. _class_@GlobalScope_constant_MOUSE_BUTTON_WHEEL_DOWN:
.. rst-class:: classref-enumeration-constant
:ref:`MouseButton<enum_@GlobalScope_MouseButton>` **MOUSE_BUTTON_WHEEL_DOWN** = ``5``
滑鼠滾輪向下滾動。
.. _class_@GlobalScope_constant_MOUSE_BUTTON_WHEEL_LEFT:
.. rst-class:: classref-enumeration-constant
:ref:`MouseButton<enum_@GlobalScope_MouseButton>` **MOUSE_BUTTON_WHEEL_LEFT** = ``6``
滑鼠滾輪左鍵（僅在某些滑鼠上有實作）。
.. _class_@GlobalScope_constant_MOUSE_BUTTON_WHEEL_RIGHT:
.. rst-class:: classref-enumeration-constant
:ref:`MouseButton<enum_@GlobalScope_MouseButton>` **MOUSE_BUTTON_WHEEL_RIGHT** = ``7``
滑鼠滾輪右鍵（僅在某些滑鼠上有實作）。
.. _class_@GlobalScope_constant_MOUSE_BUTTON_XBUTTON1:
.. rst-class:: classref-enumeration-constant
:ref:`MouseButton<enum_@GlobalScope_MouseButton>` **MOUSE_BUTTON_XBUTTON1** = ``8``
滑鼠額外鍵 1。有時會出現，通常位於滑鼠的兩側。
.. _class_@GlobalScope_constant_MOUSE_BUTTON_XBUTTON2:
.. rst-class:: classref-enumeration-constant
:ref:`MouseButton<enum_@GlobalScope_MouseButton>` **MOUSE_BUTTON_XBUTTON2** = ``9``
滑鼠額外鍵 2。有時會出現，通常位於滑鼠的兩側。
.. rst-class:: classref-item-separator
----
.. _enum_@GlobalScope_MouseButtonMask:
.. rst-class:: classref-enumeration
flags **MouseButtonMask**: :ref:`🔗<enum_@GlobalScope_MouseButtonMask>`
.. _class_@GlobalScope_constant_MOUSE_BUTTON_MASK_LEFT:
.. rst-class:: classref-enumeration-constant
:ref:`MouseButtonMask<enum_@GlobalScope_MouseButtonMask>` **MOUSE_BUTTON_MASK_LEFT** = ``1``
滑鼠主鍵遮罩，通常用於左鍵。
.. _class_@GlobalScope_constant_MOUSE_BUTTON_MASK_RIGHT:
.. rst-class:: classref-enumeration-constant
:ref:`MouseButtonMask<enum_@GlobalScope_MouseButtonMask>` **MOUSE_BUTTON_MASK_RIGHT** = ``2``
滑鼠次鍵遮罩，通常用於右鍵。
.. _class_@GlobalScope_constant_MOUSE_BUTTON_MASK_MIDDLE:
.. rst-class:: classref-enumeration-constant
:ref:`MouseButtonMask<enum_@GlobalScope_MouseButtonMask>` **MOUSE_BUTTON_MASK_MIDDLE** = ``4``
滑鼠中鍵遮罩。
.. _class_@GlobalScope_constant_MOUSE_BUTTON_MASK_MB_XBUTTON1:
.. rst-class:: classref-enumeration-constant
:ref:`MouseButtonMask<enum_@GlobalScope_MouseButtonMask>` **MOUSE_BUTTON_MASK_MB_XBUTTON1** = ``128``
滑鼠額外鍵 1 遮罩。
.. _class_@GlobalScope_constant_MOUSE_BUTTON_MASK_MB_XBUTTON2:
.. rst-class:: classref-enumeration-constant
:ref:`MouseButtonMask<enum_@GlobalScope_MouseButtonMask>` **MOUSE_BUTTON_MASK_MB_XBUTTON2** = ``256``
滑鼠額外鍵 2 遮罩。
.. rst-class:: classref-item-separator
----
.. _enum_@GlobalScope_JoyButton:
.. rst-class:: classref-enumeration
enum **JoyButton**: :ref:`🔗<enum_@GlobalScope_JoyButton>`
.. _class_@GlobalScope_constant_JOY_BUTTON_INVALID:
.. rst-class:: classref-enumeration-constant
:ref:`JoyButton<enum_@GlobalScope_JoyButton>` **JOY_BUTTON_INVALID** = ``-1``
無效的遊戲控制器按鈕。
.. _class_@GlobalScope_constant_JOY_BUTTON_A:
.. rst-class:: classref-enumeration-constant
:ref:`JoyButton<enum_@GlobalScope_JoyButton>` **JOY_BUTTON_A** = ``0``
遊戲控制器 SDL 按鍵 A。對應底部動作按鈕：Sony Cross、Xbox A、Nintendo B。
.. _class_@GlobalScope_constant_JOY_BUTTON_B:
.. rst-class:: classref-enumeration-constant
:ref:`JoyButton<enum_@GlobalScope_JoyButton>` **JOY_BUTTON_B** = ``1``
遊戲控制器 SDL 按鈕 B。對應右側動作按鈕：Sony Circle、Xbox B、Nintendo A。
.. _class_@GlobalScope_constant_JOY_BUTTON_X:
.. rst-class:: classref-enumeration-constant
:ref:`JoyButton<enum_@GlobalScope_JoyButton>` **JOY_BUTTON_X** = ``2``
遊戲控制器 SDL 按鈕 X。對應左側動作按鈕：Sony Square、Xbox X、Nintendo Y。
.. _class_@GlobalScope_constant_JOY_BUTTON_Y:
.. rst-class:: classref-enumeration-constant
:ref:`JoyButton<enum_@GlobalScope_JoyButton>` **JOY_BUTTON_Y** = ``3``
遊戲控制器 SDL 按鈕 Y。對應頂部動作按鈕：Sony Triangle、Xbox Y、Nintendo X。
.. _class_@GlobalScope_constant_JOY_BUTTON_BACK:
.. rst-class:: classref-enumeration-constant
:ref:`JoyButton<enum_@GlobalScope_JoyButton>` **JOY_BUTTON_BACK** = ``4``
遊戲控制器 SDL back按鈕。對應於 Sony Select、Xbox Back、Nintendo - 按鈕。
.. _class_@GlobalScope_constant_JOY_BUTTON_GUIDE:
.. rst-class:: classref-enumeration-constant
:ref:`JoyButton<enum_@GlobalScope_JoyButton>` **JOY_BUTTON_GUIDE** = ``5``
遊戲控制器 SDL guide 按鈕。對應於索尼 PS、Xbox 的 Home 鍵。
.. _class_@GlobalScope_constant_JOY_BUTTON_START:
.. rst-class:: classref-enumeration-constant
:ref:`JoyButton<enum_@GlobalScope_JoyButton>` **JOY_BUTTON_START** = ``6``
遊戲控制器 SDL 的 Start 按鈕；對應 Sony Options、Xbox Menu、Nintendo +。
.. _class_@GlobalScope_constant_JOY_BUTTON_LEFT_STICK:
.. rst-class:: classref-enumeration-constant
:ref:`JoyButton<enum_@GlobalScope_JoyButton>` **JOY_BUTTON_LEFT_STICK** = ``7``
遊戲控制器 SDL 左搖桿按鈕。對應於 Sony L3、Xbox L/LS 按鈕。
.. _class_@GlobalScope_constant_JOY_BUTTON_RIGHT_STICK:
.. rst-class:: classref-enumeration-constant
:ref:`JoyButton<enum_@GlobalScope_JoyButton>` **JOY_BUTTON_RIGHT_STICK** = ``8``
遊戲控制器 SDL 右搖桿按鈕。對應於 Sony R3、Xbox R/RS 按鈕。
.. _class_@GlobalScope_constant_JOY_BUTTON_LEFT_SHOULDER:
.. rst-class:: classref-enumeration-constant
:ref:`JoyButton<enum_@GlobalScope_JoyButton>` **JOY_BUTTON_LEFT_SHOULDER** = ``9``
遊戲控制器 SDL 左肩按鈕。對應於 Sony L1、Xbox LB 按鈕。
.. _class_@GlobalScope_constant_JOY_BUTTON_RIGHT_SHOULDER:
.. rst-class:: classref-enumeration-constant
:ref:`JoyButton<enum_@GlobalScope_JoyButton>` **JOY_BUTTON_RIGHT_SHOULDER** = ``10``
遊戲控制器 SDL 右肩按鈕。對應於 Sony R1、Xbox RB 按鈕。
.. _class_@GlobalScope_constant_JOY_BUTTON_DPAD_UP:
.. rst-class:: classref-enumeration-constant
:ref:`JoyButton<enum_@GlobalScope_JoyButton>` **JOY_BUTTON_DPAD_UP** = ``11``
遊戲控制器方向鍵向上按鈕。
.. _class_@GlobalScope_constant_JOY_BUTTON_DPAD_DOWN:
.. rst-class:: classref-enumeration-constant
:ref:`JoyButton<enum_@GlobalScope_JoyButton>` **JOY_BUTTON_DPAD_DOWN** = ``12``
遊戲控制器方向鍵向下按鈕。
.. _class_@GlobalScope_constant_JOY_BUTTON_DPAD_LEFT:
.. rst-class:: classref-enumeration-constant
:ref:`JoyButton<enum_@GlobalScope_JoyButton>` **JOY_BUTTON_DPAD_LEFT** = ``13``
遊戲控制器方向鍵向左鍵。
.. _class_@GlobalScope_constant_JOY_BUTTON_DPAD_RIGHT:
.. rst-class:: classref-enumeration-constant
:ref:`JoyButton<enum_@GlobalScope_JoyButton>` **JOY_BUTTON_DPAD_RIGHT** = ``14``
遊戲控制器方向鍵向右鍵。
.. _class_@GlobalScope_constant_JOY_BUTTON_MISC1:
.. rst-class:: classref-enumeration-constant
:ref:`JoyButton<enum_@GlobalScope_JoyButton>` **JOY_BUTTON_MISC1** = ``15``
遊戲控制器 SDL 雜項按鈕。對應 Xbox 分享鍵、PS5 麥克風鍵、Nintendo Switch 捕捉鍵。
.. _class_@GlobalScope_constant_JOY_BUTTON_PADDLE1:
.. rst-class:: classref-enumeration-constant
:ref:`JoyButton<enum_@GlobalScope_JoyButton>` **JOY_BUTTON_PADDLE1** = ``16``
遊戲控制器 SDL 撥片 1 按鈕。
.. _class_@GlobalScope_constant_JOY_BUTTON_PADDLE2:
.. rst-class:: classref-enumeration-constant
:ref:`JoyButton<enum_@GlobalScope_JoyButton>` **JOY_BUTTON_PADDLE2** = ``17``
遊戲控制器 SDL 撥片 2 按鈕。
.. _class_@GlobalScope_constant_JOY_BUTTON_PADDLE3:
.. rst-class:: classref-enumeration-constant
:ref:`JoyButton<enum_@GlobalScope_JoyButton>` **JOY_BUTTON_PADDLE3** = ``18``
遊戲控制器 SDL 撥片 3 按鈕。
.. _class_@GlobalScope_constant_JOY_BUTTON_PADDLE4:
.. rst-class:: classref-enumeration-constant
:ref:`JoyButton<enum_@GlobalScope_JoyButton>` **JOY_BUTTON_PADDLE4** = ``19``
遊戲控制器 SDL 撥片 4 按鈕。
.. _class_@GlobalScope_constant_JOY_BUTTON_TOUCHPAD:
.. rst-class:: classref-enumeration-constant
:ref:`JoyButton<enum_@GlobalScope_JoyButton>` **JOY_BUTTON_TOUCHPAD** = ``20``
遊戲控制器 SDL 觸控板按鈕。
.. _class_@GlobalScope_constant_JOY_BUTTON_SDL_MAX:
.. rst-class:: classref-enumeration-constant
:ref:`JoyButton<enum_@GlobalScope_JoyButton>` **JOY_BUTTON_SDL_MAX** = ``21``
SDL 遊戲控制器按鈕的數量。
.. _class_@GlobalScope_constant_JOY_BUTTON_MAX:
.. rst-class:: classref-enumeration-constant
:ref:`JoyButton<enum_@GlobalScope_JoyButton>` **JOY_BUTTON_MAX** = ``128``
引擎所支援的最大遊戲控制器按鈕數。特定平臺上的實際界限可能更低：
- **Android：**\ 最多 36 個按鈕。
- **Linux：**\ 最多 80 個按鈕。
- **Windows** 和 **macOS：**\ 最多 128 個按鈕。
.. rst-class:: classref-item-separator
----
.. _enum_@GlobalScope_JoyAxis:
.. rst-class:: classref-enumeration
enum **JoyAxis**: :ref:`🔗<enum_@GlobalScope_JoyAxis>`
.. _class_@GlobalScope_constant_JOY_AXIS_INVALID:
.. rst-class:: classref-enumeration-constant
:ref:`JoyAxis<enum_@GlobalScope_JoyAxis>` **JOY_AXIS_INVALID** = ``-1``
無效的遊戲控制器軸。
.. _class_@GlobalScope_constant_JOY_AXIS_LEFT_X:
.. rst-class:: classref-enumeration-constant
:ref:`JoyAxis<enum_@GlobalScope_JoyAxis>` **JOY_AXIS_LEFT_X** = ``0``
遊戲控制器左操縱桿 x 軸。
.. _class_@GlobalScope_constant_JOY_AXIS_LEFT_Y:
.. rst-class:: classref-enumeration-constant
:ref:`JoyAxis<enum_@GlobalScope_JoyAxis>` **JOY_AXIS_LEFT_Y** = ``1``
遊戲控制器左操縱桿 y 軸。
.. _class_@GlobalScope_constant_JOY_AXIS_RIGHT_X:
.. rst-class:: classref-enumeration-constant
:ref:`JoyAxis<enum_@GlobalScope_JoyAxis>` **JOY_AXIS_RIGHT_X** = ``2``
遊戲控制器右操縱桿 x 軸。
.. _class_@GlobalScope_constant_JOY_AXIS_RIGHT_Y:
.. rst-class:: classref-enumeration-constant
:ref:`JoyAxis<enum_@GlobalScope_JoyAxis>` **JOY_AXIS_RIGHT_Y** = ``3``
遊戲控制器右操縱桿 y 軸。
.. _class_@GlobalScope_constant_JOY_AXIS_TRIGGER_LEFT:
.. rst-class:: classref-enumeration-constant
:ref:`JoyAxis<enum_@GlobalScope_JoyAxis>` **JOY_AXIS_TRIGGER_LEFT** = ``4``
遊戲控制器左扳機軸。
.. _class_@GlobalScope_constant_JOY_AXIS_TRIGGER_RIGHT:
.. rst-class:: classref-enumeration-constant
:ref:`JoyAxis<enum_@GlobalScope_JoyAxis>` **JOY_AXIS_TRIGGER_RIGHT** = ``5``
遊戲控制器左扳機軸。
.. _class_@GlobalScope_constant_JOY_AXIS_SDL_MAX:
.. rst-class:: classref-enumeration-constant
:ref:`JoyAxis<enum_@GlobalScope_JoyAxis>` **JOY_AXIS_SDL_MAX** = ``6``
SDL 遊戲控制器軸的數量。
.. _class_@GlobalScope_constant_JOY_AXIS_MAX:
.. rst-class:: classref-enumeration-constant
:ref:`JoyAxis<enum_@GlobalScope_JoyAxis>` **JOY_AXIS_MAX** = ``10``
最大遊戲控制器軸數：OpenVR 最多支援 5 個操縱桿，總共 10 個軸。
.. rst-class:: classref-item-separator
----
.. _enum_@GlobalScope_MIDIMessage:
.. rst-class:: classref-enumeration
enum **MIDIMessage**: :ref:`🔗<enum_@GlobalScope_MIDIMessage>`
.. _class_@GlobalScope_constant_MIDI_MESSAGE_NONE:
.. rst-class:: classref-enumeration-constant
:ref:`MIDIMessage<enum_@GlobalScope_MIDIMessage>` **MIDI_MESSAGE_NONE** = ``0``
不對應任何 MIDI 訊息；為 :ref:`InputEventMIDI.message<class_InputEventMIDI_property_message>` 的預設值。
.. _class_@GlobalScope_constant_MIDI_MESSAGE_NOTE_OFF:
.. rst-class:: classref-enumeration-constant
:ref:`MIDIMessage<enum_@GlobalScope_MIDIMessage>` **MIDI_MESSAGE_NOTE_OFF** = ``8``
MIDI 音符釋放訊息。
\ **注意：** 並非所有 MIDI 裝置都傳送此訊息；有些會以 :ref:`MIDI_MESSAGE_NOTE_ON<class_@GlobalScope_constant_MIDI_MESSAGE_NOTE_ON>` 且 :ref:`InputEventMIDI.velocity<class_InputEventMIDI_property_velocity>` 為 ``0`` 表示。
.. _class_@GlobalScope_constant_MIDI_MESSAGE_NOTE_ON:
.. rst-class:: classref-enumeration-constant
:ref:`MIDIMessage<enum_@GlobalScope_MIDIMessage>` **MIDI_MESSAGE_NOTE_ON** = ``9``
按下音符時送出的 MIDI 訊息。
.. _class_@GlobalScope_constant_MIDI_MESSAGE_AFTERTOUCH:
.. rst-class:: classref-enumeration-constant
:ref:`MIDIMessage<enum_@GlobalScope_MIDIMessage>` **MIDI_MESSAGE_AFTERTOUCH** = ``10``
在按住音符期間，表示壓力變化（後觸）的 MIDI 訊息。
.. _class_@GlobalScope_constant_MIDI_MESSAGE_CONTROL_CHANGE:
.. rst-class:: classref-enumeration-constant
:ref:`MIDIMessage<enum_@GlobalScope_MIDIMessage>` **MIDI_MESSAGE_CONTROL_CHANGE** = ``11``
控制器數值變動時送出的 MIDI 訊息。控制器指裝置中不會發聲的輸入元件，如音量、平衡或聲像滑桿，以及各種按鍵與踏板。簡要列表可參考 `General MIDI 規格說明 <https://en.wikipedia.org/wiki/General_MIDI#Controller_events>`__\ 。
.. _class_@GlobalScope_constant_MIDI_MESSAGE_PROGRAM_CHANGE:
.. rst-class:: classref-enumeration-constant
:ref:`MIDIMessage<enum_@GlobalScope_MIDIMessage>` **MIDI_MESSAGE_PROGRAM_CHANGE** = ``12``
當 MIDI 裝置切換目前樂器（又稱 *Program* 或 *Preset*\ ）時送出的訊息。
.. _class_@GlobalScope_constant_MIDI_MESSAGE_CHANNEL_PRESSURE:
.. rst-class:: classref-enumeration-constant
:ref:`MIDIMessage<enum_@GlobalScope_MIDIMessage>` **MIDI_MESSAGE_CHANNEL_PRESSURE** = ``13``
表示整個通道壓力變化的 MIDI 訊息；部分裝置會用此取代 :ref:`MIDI_MESSAGE_AFTERTOUCH<class_@GlobalScope_constant_MIDI_MESSAGE_AFTERTOUCH>`\ 。
.. _class_@GlobalScope_constant_MIDI_MESSAGE_PITCH_BEND:
.. rst-class:: classref-enumeration-constant
:ref:`MIDIMessage<enum_@GlobalScope_MIDIMessage>` **MIDI_MESSAGE_PITCH_BEND** = ``14``
音高彎音輪變動時送出的 MIDI 訊息。
.. _class_@GlobalScope_constant_MIDI_MESSAGE_SYSTEM_EXCLUSIVE:
.. rst-class:: classref-enumeration-constant
:ref:`MIDIMessage<enum_@GlobalScope_MIDIMessage>` **MIDI_MESSAGE_SYSTEM_EXCLUSIVE** = ``240``
MIDI 系統專用（SysEx）訊息，格式未被統一，內容依各裝置自訂。
\ **注意：** 目前無法透過 :ref:`InputEventMIDI<class_InputEventMIDI>` 取得其資料。
.. _class_@GlobalScope_constant_MIDI_MESSAGE_QUARTER_FRAME:
.. rst-class:: classref-enumeration-constant
:ref:`MIDIMessage<enum_@GlobalScope_MIDIMessage>` **MIDI_MESSAGE_QUARTER_FRAME** = ``241``
每四分影格發送一次的 MIDI 同步訊息，與 :ref:`MIDI_MESSAGE_TIMING_CLOCK<class_@GlobalScope_constant_MIDI_MESSAGE_TIMING_CLOCK>` 相關。
\ **注意：** 目前無法透過 :ref:`InputEventMIDI<class_InputEventMIDI>` 取得其資料。
.. _class_@GlobalScope_constant_MIDI_MESSAGE_SONG_POSITION_POINTER:
.. rst-class:: classref-enumeration-constant
:ref:`MIDIMessage<enum_@GlobalScope_MIDIMessage>` **MIDI_MESSAGE_SONG_POSITION_POINTER** = ``242``
用於跳轉至當前樂曲或序列新位置的 MIDI 訊息。
\ **注意：** 目前無法透過 :ref:`InputEventMIDI<class_InputEventMIDI>` 取得其資料。
.. _class_@GlobalScope_constant_MIDI_MESSAGE_SONG_SELECT:
.. rst-class:: classref-enumeration-constant
:ref:`MIDIMessage<enum_@GlobalScope_MIDIMessage>` **MIDI_MESSAGE_SONG_SELECT** = ``243``
MIDI 曲目選擇訊息，用於指定要播放的序列或歌曲。
\ **注意：** 目前尚未實作從 :ref:`InputEventMIDI<class_InputEventMIDI>` 取得此訊息資料。
.. _class_@GlobalScope_constant_MIDI_MESSAGE_TUNE_REQUEST:
.. rst-class:: classref-enumeration-constant
:ref:`MIDIMessage<enum_@GlobalScope_MIDIMessage>` **MIDI_MESSAGE_TUNE_REQUEST** = ``246``
要求裝置進行調音校準的 MIDI 訊息，多用於類比合成器；現代裝置多半不需此訊息。
.. _class_@GlobalScope_constant_MIDI_MESSAGE_TIMING_CLOCK:
.. rst-class:: classref-enumeration-constant
:ref:`MIDIMessage<enum_@GlobalScope_MIDIMessage>` **MIDI_MESSAGE_TIMING_CLOCK** = ``248``
在 :ref:`MIDI_MESSAGE_QUARTER_FRAME<class_@GlobalScope_constant_MIDI_MESSAGE_QUARTER_FRAME>` 之後每 24 次發送一次的 MIDI 同步訊息，用以保持裝置同步。
.. _class_@GlobalScope_constant_MIDI_MESSAGE_START:
.. rst-class:: classref-enumeration-constant
:ref:`MIDIMessage<enum_@GlobalScope_MIDIMessage>` **MIDI_MESSAGE_START** = ``250``
從頭開始播放目前序列或樂曲的 MIDI 啟動訊息。
.. _class_@GlobalScope_constant_MIDI_MESSAGE_CONTINUE:
.. rst-class:: classref-enumeration-constant
:ref:`MIDIMessage<enum_@GlobalScope_MIDIMessage>` **MIDI_MESSAGE_CONTINUE** = ``251``
恢復播放已暫停序列或樂曲的 MIDI 繼續訊息。
.. _class_@GlobalScope_constant_MIDI_MESSAGE_STOP:
.. rst-class:: classref-enumeration-constant
:ref:`MIDIMessage<enum_@GlobalScope_MIDIMessage>` **MIDI_MESSAGE_STOP** = ``252``
暫停目前序列或樂曲的 MIDI 停止訊息。
.. _class_@GlobalScope_constant_MIDI_MESSAGE_ACTIVE_SENSING:
.. rst-class:: classref-enumeration-constant
:ref:`MIDIMessage<enum_@GlobalScope_MIDIMessage>` **MIDI_MESSAGE_ACTIVE_SENSING** = ``254``
裝置閒置時週期性送出的 MIDI 作用中保持訊息，用以告知接收端連線存活；多數裝置不會傳送此訊息。
.. _class_@GlobalScope_constant_MIDI_MESSAGE_SYSTEM_RESET:
.. rst-class:: classref-enumeration-constant
:ref:`MIDIMessage<enum_@GlobalScope_MIDIMessage>` **MIDI_MESSAGE_SYSTEM_RESET** = ``255``
將 MIDI 裝置重設為預設狀態的訊息，效果如同重新開機；啟動裝置時不應傳送。
.. rst-class:: classref-item-separator
----
.. _enum_@GlobalScope_Error:
.. rst-class:: classref-enumeration
enum **Error**: :ref:`🔗<enum_@GlobalScope_Error>`
.. _class_@GlobalScope_constant_OK:
.. rst-class:: classref-enumeration-constant
:ref:`Error<enum_@GlobalScope_Error>` **OK** = ``0``
回傳 :ref:`Error<enum_@GlobalScope_Error>` 的方法，若無錯誤時會回傳 :ref:`OK<class_@GlobalScope_constant_OK>`\ 。
由於 :ref:`OK<class_@GlobalScope_constant_OK>` 為 ``0``\ ，其他錯誤常數皆為正整數，因此可直接用於布林判斷。
::
var error = method_that_returns_error()
if error != OK:
printerr("Failure!")
# 或等效寫法：
if error:
printerr("Still failing!")
\ **注意：**\ 許多函式並不回傳錯誤碼，而是直接將錯誤訊息輸出到標準輸出。
.. _class_@GlobalScope_constant_FAILED:
.. rst-class:: classref-enumeration-constant
:ref:`Error<enum_@GlobalScope_Error>` **FAILED** = ``1``
一般性錯誤。
.. _class_@GlobalScope_constant_ERR_UNAVAILABLE:
.. rst-class:: classref-enumeration-constant
:ref:`Error<enum_@GlobalScope_Error>` **ERR_UNAVAILABLE** = ``2``
不可用的錯誤。
.. _class_@GlobalScope_constant_ERR_UNCONFIGURED:
.. rst-class:: classref-enumeration-constant
:ref:`Error<enum_@GlobalScope_Error>` **ERR_UNCONFIGURED** = ``3``
未配置的錯誤。
.. _class_@GlobalScope_constant_ERR_UNAUTHORIZED:
.. rst-class:: classref-enumeration-constant
:ref:`Error<enum_@GlobalScope_Error>` **ERR_UNAUTHORIZED** = ``4``
未經授權的錯誤。
.. _class_@GlobalScope_constant_ERR_PARAMETER_RANGE_ERROR:
.. rst-class:: classref-enumeration-constant
:ref:`Error<enum_@GlobalScope_Error>` **ERR_PARAMETER_RANGE_ERROR** = ``5``
參數範圍錯誤。
.. _class_@GlobalScope_constant_ERR_OUT_OF_MEMORY:
.. rst-class:: classref-enumeration-constant
:ref:`Error<enum_@GlobalScope_Error>` **ERR_OUT_OF_MEMORY** = ``6``
記憶體不足（OOM）錯誤。
.. _class_@GlobalScope_constant_ERR_FILE_NOT_FOUND:
.. rst-class:: classref-enumeration-constant
:ref:`Error<enum_@GlobalScope_Error>` **ERR_FILE_NOT_FOUND** = ``7``
檔案：未找到錯誤。
.. _class_@GlobalScope_constant_ERR_FILE_BAD_DRIVE:
.. rst-class:: classref-enumeration-constant
:ref:`Error<enum_@GlobalScope_Error>` **ERR_FILE_BAD_DRIVE** = ``8``
檔案：壞驅動器錯誤。
.. _class_@GlobalScope_constant_ERR_FILE_BAD_PATH:
.. rst-class:: classref-enumeration-constant
:ref:`Error<enum_@GlobalScope_Error>` **ERR_FILE_BAD_PATH** = ``9``
檔案：錯誤的路徑錯誤。
.. _class_@GlobalScope_constant_ERR_FILE_NO_PERMISSION:
.. rst-class:: classref-enumeration-constant
:ref:`Error<enum_@GlobalScope_Error>` **ERR_FILE_NO_PERMISSION** = ``10``
檔案：無許可權錯誤。
.. _class_@GlobalScope_constant_ERR_FILE_ALREADY_IN_USE:
.. rst-class:: classref-enumeration-constant
:ref:`Error<enum_@GlobalScope_Error>` **ERR_FILE_ALREADY_IN_USE** = ``11``
檔案：已在使用錯誤。
.. _class_@GlobalScope_constant_ERR_FILE_CANT_OPEN:
.. rst-class:: classref-enumeration-constant
:ref:`Error<enum_@GlobalScope_Error>` **ERR_FILE_CANT_OPEN** = ``12``
檔案：無法打開錯誤。
.. _class_@GlobalScope_constant_ERR_FILE_CANT_WRITE:
.. rst-class:: classref-enumeration-constant
:ref:`Error<enum_@GlobalScope_Error>` **ERR_FILE_CANT_WRITE** = ``13``
檔案：無法寫入錯誤。
.. _class_@GlobalScope_constant_ERR_FILE_CANT_READ:
.. rst-class:: classref-enumeration-constant
:ref:`Error<enum_@GlobalScope_Error>` **ERR_FILE_CANT_READ** = ``14``
檔案：無法讀取錯誤。
.. _class_@GlobalScope_constant_ERR_FILE_UNRECOGNIZED:
.. rst-class:: classref-enumeration-constant
:ref:`Error<enum_@GlobalScope_Error>` **ERR_FILE_UNRECOGNIZED** = ``15``
檔案：未識別的錯誤。
.. _class_@GlobalScope_constant_ERR_FILE_CORRUPT:
.. rst-class:: classref-enumeration-constant
:ref:`Error<enum_@GlobalScope_Error>` **ERR_FILE_CORRUPT** = ``16``
檔案：損壞錯誤。
.. _class_@GlobalScope_constant_ERR_FILE_MISSING_DEPENDENCIES:
.. rst-class:: classref-enumeration-constant
:ref:`Error<enum_@GlobalScope_Error>` **ERR_FILE_MISSING_DEPENDENCIES** = ``17``
檔案：缺少依賴項錯誤。
.. _class_@GlobalScope_constant_ERR_FILE_EOF:
.. rst-class:: classref-enumeration-constant
:ref:`Error<enum_@GlobalScope_Error>` **ERR_FILE_EOF** = ``18``
檔案：檔結束（EOF）錯誤。
.. _class_@GlobalScope_constant_ERR_CANT_OPEN:
.. rst-class:: classref-enumeration-constant
:ref:`Error<enum_@GlobalScope_Error>` **ERR_CANT_OPEN** = ``19``
無法打開錯誤。
.. _class_@GlobalScope_constant_ERR_CANT_CREATE:
.. rst-class:: classref-enumeration-constant
:ref:`Error<enum_@GlobalScope_Error>` **ERR_CANT_CREATE** = ``20``
無法建立錯誤。
.. _class_@GlobalScope_constant_ERR_QUERY_FAILED:
.. rst-class:: classref-enumeration-constant
:ref:`Error<enum_@GlobalScope_Error>` **ERR_QUERY_FAILED** = ``21``
查詢失敗錯誤。
.. _class_@GlobalScope_constant_ERR_ALREADY_IN_USE:
.. rst-class:: classref-enumeration-constant
:ref:`Error<enum_@GlobalScope_Error>` **ERR_ALREADY_IN_USE** = ``22``
已在使用中錯誤。
.. _class_@GlobalScope_constant_ERR_LOCKED:
.. rst-class:: classref-enumeration-constant
:ref:`Error<enum_@GlobalScope_Error>` **ERR_LOCKED** = ``23``
鎖定錯誤。
.. _class_@GlobalScope_constant_ERR_TIMEOUT:
.. rst-class:: classref-enumeration-constant
:ref:`Error<enum_@GlobalScope_Error>` **ERR_TIMEOUT** = ``24``
逾時錯誤。
.. _class_@GlobalScope_constant_ERR_CANT_CONNECT:
.. rst-class:: classref-enumeration-constant
:ref:`Error<enum_@GlobalScope_Error>` **ERR_CANT_CONNECT** = ``25``
無法連接錯誤。
.. _class_@GlobalScope_constant_ERR_CANT_RESOLVE:
.. rst-class:: classref-enumeration-constant
:ref:`Error<enum_@GlobalScope_Error>` **ERR_CANT_RESOLVE** = ``26``
無法解決錯誤。
.. _class_@GlobalScope_constant_ERR_CONNECTION_ERROR:
.. rst-class:: classref-enumeration-constant
:ref:`Error<enum_@GlobalScope_Error>` **ERR_CONNECTION_ERROR** = ``27``
連接錯誤。
.. _class_@GlobalScope_constant_ERR_CANT_ACQUIRE_RESOURCE:
.. rst-class:: classref-enumeration-constant
:ref:`Error<enum_@GlobalScope_Error>` **ERR_CANT_ACQUIRE_RESOURCE** = ``28``
無法獲取資源錯誤。
.. _class_@GlobalScope_constant_ERR_CANT_FORK:
.. rst-class:: classref-enumeration-constant
:ref:`Error<enum_@GlobalScope_Error>` **ERR_CANT_FORK** = ``29``
無法分叉程序錯誤。
.. _class_@GlobalScope_constant_ERR_INVALID_DATA:
.. rst-class:: classref-enumeration-constant
:ref:`Error<enum_@GlobalScope_Error>` **ERR_INVALID_DATA** = ``30``
無效資料錯誤。
.. _class_@GlobalScope_constant_ERR_INVALID_PARAMETER:
.. rst-class:: classref-enumeration-constant
:ref:`Error<enum_@GlobalScope_Error>` **ERR_INVALID_PARAMETER** = ``31``
無效參數錯誤。
.. _class_@GlobalScope_constant_ERR_ALREADY_EXISTS:
.. rst-class:: classref-enumeration-constant
:ref:`Error<enum_@GlobalScope_Error>` **ERR_ALREADY_EXISTS** = ``32``
已存在的錯誤。
.. _class_@GlobalScope_constant_ERR_DOES_NOT_EXIST:
.. rst-class:: classref-enumeration-constant
:ref:`Error<enum_@GlobalScope_Error>` **ERR_DOES_NOT_EXIST** = ``33``
不存在的錯誤。
.. _class_@GlobalScope_constant_ERR_DATABASE_CANT_READ:
.. rst-class:: classref-enumeration-constant
:ref:`Error<enum_@GlobalScope_Error>` **ERR_DATABASE_CANT_READ** = ``34``
資料庫：讀取錯誤。
.. _class_@GlobalScope_constant_ERR_DATABASE_CANT_WRITE:
.. rst-class:: classref-enumeration-constant
:ref:`Error<enum_@GlobalScope_Error>` **ERR_DATABASE_CANT_WRITE** = ``35``
資料庫：寫入錯誤。
.. _class_@GlobalScope_constant_ERR_COMPILATION_FAILED:
.. rst-class:: classref-enumeration-constant
:ref:`Error<enum_@GlobalScope_Error>` **ERR_COMPILATION_FAILED** = ``36``
編譯失敗錯誤。
.. _class_@GlobalScope_constant_ERR_METHOD_NOT_FOUND:
.. rst-class:: classref-enumeration-constant
:ref:`Error<enum_@GlobalScope_Error>` **ERR_METHOD_NOT_FOUND** = ``37``
方法未找到錯誤。
.. _class_@GlobalScope_constant_ERR_LINK_FAILED:
.. rst-class:: classref-enumeration-constant
:ref:`Error<enum_@GlobalScope_Error>` **ERR_LINK_FAILED** = ``38``
連結失敗錯誤。
.. _class_@GlobalScope_constant_ERR_SCRIPT_FAILED:
.. rst-class:: classref-enumeration-constant
:ref:`Error<enum_@GlobalScope_Error>` **ERR_SCRIPT_FAILED** = ``39``
腳本失敗錯誤。
.. _class_@GlobalScope_constant_ERR_CYCLIC_LINK:
.. rst-class:: classref-enumeration-constant
:ref:`Error<enum_@GlobalScope_Error>` **ERR_CYCLIC_LINK** = ``40``
迴圈連結（匯入迴圈）錯誤。
.. _class_@GlobalScope_constant_ERR_INVALID_DECLARATION:
.. rst-class:: classref-enumeration-constant
:ref:`Error<enum_@GlobalScope_Error>` **ERR_INVALID_DECLARATION** = ``41``
無效宣告錯誤。
.. _class_@GlobalScope_constant_ERR_DUPLICATE_SYMBOL:
.. rst-class:: classref-enumeration-constant
:ref:`Error<enum_@GlobalScope_Error>` **ERR_DUPLICATE_SYMBOL** = ``42``
符號重複錯誤。
.. _class_@GlobalScope_constant_ERR_PARSE_ERROR:
.. rst-class:: classref-enumeration-constant
:ref:`Error<enum_@GlobalScope_Error>` **ERR_PARSE_ERROR** = ``43``
解析錯誤。
.. _class_@GlobalScope_constant_ERR_BUSY:
.. rst-class:: classref-enumeration-constant
:ref:`Error<enum_@GlobalScope_Error>` **ERR_BUSY** = ``44``
忙碌錯誤。
.. _class_@GlobalScope_constant_ERR_SKIP:
.. rst-class:: classref-enumeration-constant
:ref:`Error<enum_@GlobalScope_Error>` **ERR_SKIP** = ``45``
跳過錯誤。
.. _class_@GlobalScope_constant_ERR_HELP:
.. rst-class:: classref-enumeration-constant
:ref:`Error<enum_@GlobalScope_Error>` **ERR_HELP** = ``46``
説明錯誤。內部使用，用於將 ``--version`` 或 ``--help`` 作為選項傳遞給可執行檔的情況。
.. _class_@GlobalScope_constant_ERR_BUG:
.. rst-class:: classref-enumeration-constant
:ref:`Error<enum_@GlobalScope_Error>` **ERR_BUG** = ``47``
Bug 錯誤，由方法中的實作問題引起。
\ **注意：**\ 如果內建方法返回此程式碼，請在 `GitHub 問題追蹤器 <https://github.com/godotengine/godot/issues>`__ 上開一個問題。
.. _class_@GlobalScope_constant_ERR_PRINTER_ON_FIRE:
.. rst-class:: classref-enumeration-constant
:ref:`Error<enum_@GlobalScope_Error>` **ERR_PRINTER_ON_FIRE** = ``48``
印表機起火錯誤（這是個彩蛋，引擎中沒有內建方法會返回此錯誤碼）。
.. rst-class:: classref-item-separator
----
.. _enum_@GlobalScope_PropertyHint:
.. rst-class:: classref-enumeration
enum **PropertyHint**: :ref:`🔗<enum_@GlobalScope_PropertyHint>`
.. _class_@GlobalScope_constant_PROPERTY_HINT_NONE:
.. rst-class:: classref-enumeration-constant
:ref:`PropertyHint<enum_@GlobalScope_PropertyHint>` **PROPERTY_HINT_NONE** = ``0``
該屬性沒有編輯器提示。
.. _class_@GlobalScope_constant_PROPERTY_HINT_RANGE:
.. rst-class:: classref-enumeration-constant
:ref:`PropertyHint<enum_@GlobalScope_PropertyHint>` **PROPERTY_HINT_RANGE** = ``1``
Hints that an :ref:`int<class_int>` or :ref:`float<class_float>` property should be within a range specified via the hint string ``"min,max"`` or ``"min,max,step"``. The hint string can optionally include ``"or_greater"`` and/or ``"or_less"`` to allow manual input going respectively above the max or below the min values.
\ **Example:** ``"-360,360,1,or_greater,or_less"``.
Additionally, other keywords can be included: ``"exp"`` for exponential range editing, ``"radians_as_degrees"`` for editing radian angles in degrees (the range values are also in degrees), ``"degrees"`` to hint at an angle, ``"prefer_slider"`` to show the slider for integers, ``"hide_control"`` to hide the slider or up-down arrows, and ``"suffix:px/s"`` to display a suffix indicating the value's unit (e.g. ``px/s`` for pixels per second).
.. _class_@GlobalScope_constant_PROPERTY_HINT_ENUM:
.. rst-class:: classref-enumeration-constant
:ref:`PropertyHint<enum_@GlobalScope_PropertyHint>` **PROPERTY_HINT_ENUM** = ``2``
Hints that an :ref:`int<class_int>`, :ref:`String<class_String>`, or :ref:`StringName<class_StringName>` property is an enumerated value to pick in a list specified via a hint string.
The hint string is a comma separated list of names such as ``"Hello,Something,Else"``. Whitespace is **not** removed from either end of a name. For integer properties, the first name in the list has value 0, the next 1, and so on. Explicit values can also be specified by appending ``:integer`` to the name, e.g. ``"Zero,One,Three:3,Four,Six:6"``.
.. _class_@GlobalScope_constant_PROPERTY_HINT_ENUM_SUGGESTION:
.. rst-class:: classref-enumeration-constant
:ref:`PropertyHint<enum_@GlobalScope_PropertyHint>` **PROPERTY_HINT_ENUM_SUGGESTION** = ``3``
Hints that a :ref:`String<class_String>` or :ref:`StringName<class_StringName>` property can be an enumerated value to pick in a list specified via a hint string such as ``"Hello,Something,Else"``. See :ref:`PROPERTY_HINT_ENUM<class_@GlobalScope_constant_PROPERTY_HINT_ENUM>` for details.
Unlike :ref:`PROPERTY_HINT_ENUM<class_@GlobalScope_constant_PROPERTY_HINT_ENUM>`, a property with this hint still accepts arbitrary values and can be empty. The list of values serves to suggest possible values.
.. _class_@GlobalScope_constant_PROPERTY_HINT_EXP_EASING:
.. rst-class:: classref-enumeration-constant
:ref:`PropertyHint<enum_@GlobalScope_PropertyHint>` **PROPERTY_HINT_EXP_EASING** = ``4``
提示應通過指數緩動函式編輯 :ref:`float<class_float>` 屬性。提示字串可以包括 ``"attenuation"`` 以水平翻轉曲線，和/或 ``"positive_only"`` 以排除 in/out 緩動並限制值大於或等於零。
.. _class_@GlobalScope_constant_PROPERTY_HINT_LINK:
.. rst-class:: classref-enumeration-constant
:ref:`PropertyHint<enum_@GlobalScope_PropertyHint>` **PROPERTY_HINT_LINK** = ``5``
提示向量屬性應該允許分量連結。例如，這能夠讓 :ref:`Vector2.x<class_Vector2_property_x>` 和 :ref:`Vector2.y<class_Vector2_property_y>` 被一起編輯。
.. _class_@GlobalScope_constant_PROPERTY_HINT_FLAGS:
.. rst-class:: classref-enumeration-constant
:ref:`PropertyHint<enum_@GlobalScope_PropertyHint>` **PROPERTY_HINT_FLAGS** = ``6``
Hints that an :ref:`int<class_int>` property is a bitmask with named bit flags.
The hint string is a comma separated list of names such as ``"Bit0,Bit1,Bit2,Bit3"``. Whitespace is **not** removed from either end of a name. The first name in the list has value 1, the next 2, then 4, 8, 16 and so on. Explicit values can also be specified by appending ``:integer`` to the name, e.g. ``"A:4,B:8,C:16"``. You can also combine several flags (``"A:4,B:8,AB:12,C:16"``).
\ **Note:** A flag value must be at least ``1`` and at most ``2 ** 32 - 1``.
\ **Note:** Unlike :ref:`PROPERTY_HINT_ENUM<class_@GlobalScope_constant_PROPERTY_HINT_ENUM>`, the previous explicit value is not taken into account. For the hint ``"A:16,B,C"``, A is 16, B is 2, C is 4.
.. _class_@GlobalScope_constant_PROPERTY_HINT_LAYERS_2D_RENDER:
.. rst-class:: classref-enumeration-constant
:ref:`PropertyHint<enum_@GlobalScope_PropertyHint>` **PROPERTY_HINT_LAYERS_2D_RENDER** = ``7``
提示 :ref:`int<class_int>` 屬性為位元遮罩，表示可命名的 2D 算繪層。
.. _class_@GlobalScope_constant_PROPERTY_HINT_LAYERS_2D_PHYSICS:
.. rst-class:: classref-enumeration-constant
:ref:`PropertyHint<enum_@GlobalScope_PropertyHint>` **PROPERTY_HINT_LAYERS_2D_PHYSICS** = ``8``
提示 :ref:`int<class_int>` 屬性為位元遮罩，表示可命名的 2D 實體層。
.. _class_@GlobalScope_constant_PROPERTY_HINT_LAYERS_2D_NAVIGATION:
.. rst-class:: classref-enumeration-constant
:ref:`PropertyHint<enum_@GlobalScope_PropertyHint>` **PROPERTY_HINT_LAYERS_2D_NAVIGATION** = ``9``
提示 :ref:`int<class_int>` 屬性為位元遮罩，表示可命名的 2D 導覽層。
.. _class_@GlobalScope_constant_PROPERTY_HINT_LAYERS_3D_RENDER:
.. rst-class:: classref-enumeration-constant
:ref:`PropertyHint<enum_@GlobalScope_PropertyHint>` **PROPERTY_HINT_LAYERS_3D_RENDER** = ``10``
提示 :ref:`int<class_int>` 屬性為位元遮罩，表示可命名的 3D 算繪層。
.. _class_@GlobalScope_constant_PROPERTY_HINT_LAYERS_3D_PHYSICS:
.. rst-class:: classref-enumeration-constant
:ref:`PropertyHint<enum_@GlobalScope_PropertyHint>` **PROPERTY_HINT_LAYERS_3D_PHYSICS** = ``11``
提示 :ref:`int<class_int>` 屬性為位元遮罩，表示可命名的 3D 實體層。
.. _class_@GlobalScope_constant_PROPERTY_HINT_LAYERS_3D_NAVIGATION:
.. rst-class:: classref-enumeration-constant
:ref:`PropertyHint<enum_@GlobalScope_PropertyHint>` **PROPERTY_HINT_LAYERS_3D_NAVIGATION** = ``12``
提示 :ref:`int<class_int>` 屬性為位元遮罩，表示可命名的 3D 導覽層。
.. _class_@GlobalScope_constant_PROPERTY_HINT_LAYERS_AVOIDANCE:
.. rst-class:: classref-enumeration-constant
:ref:`PropertyHint<enum_@GlobalScope_PropertyHint>` **PROPERTY_HINT_LAYERS_AVOIDANCE** = ``37``
提示整數屬性為位元遮罩，表示可命名的避障層。
.. _class_@GlobalScope_constant_PROPERTY_HINT_FILE:
.. rst-class:: classref-enumeration-constant
:ref:`PropertyHint<enum_@GlobalScope_PropertyHint>` **PROPERTY_HINT_FILE** = ``13``
Hints that a :ref:`String<class_String>` property is a path to a file. Editing it will show a file dialog for picking the path. The hint string can be a set of filters with wildcards like ``"*.png,*.jpg"``. By default the file will be stored as UID whenever available. You can use :ref:`ResourceUID<class_ResourceUID>` methods to convert it back to path. For storing a raw path, use :ref:`PROPERTY_HINT_FILE_PATH<class_@GlobalScope_constant_PROPERTY_HINT_FILE_PATH>`.
.. _class_@GlobalScope_constant_PROPERTY_HINT_DIR:
.. rst-class:: classref-enumeration-constant
:ref:`PropertyHint<enum_@GlobalScope_PropertyHint>` **PROPERTY_HINT_DIR** = ``14``
提示 :ref:`String<class_String>` 屬性為目錄的路徑。編輯時會彈出選取路徑的檔對話方塊。
.. _class_@GlobalScope_constant_PROPERTY_HINT_GLOBAL_FILE:
.. rst-class:: classref-enumeration-constant
:ref:`PropertyHint<enum_@GlobalScope_PropertyHint>` **PROPERTY_HINT_GLOBAL_FILE** = ``15``
提示 :ref:`String<class_String>` 屬性為檔的絕對路徑，位於專案檔案夾之外。編輯時會彈出選取路徑的檔案對話方塊。提示字串可以設為一組帶有萬用字元的篩選器，例如 ``"*.png,*.jpg"``\ 。
.. _class_@GlobalScope_constant_PROPERTY_HINT_GLOBAL_DIR:
.. rst-class:: classref-enumeration-constant
:ref:`PropertyHint<enum_@GlobalScope_PropertyHint>` **PROPERTY_HINT_GLOBAL_DIR** = ``16``
提示 :ref:`String<class_String>` 屬性為目錄的絕對路徑，位於專案檔案夾之外。編輯時會彈出選取路徑的檔案對話方塊。
.. _class_@GlobalScope_constant_PROPERTY_HINT_RESOURCE_TYPE:
.. rst-class:: classref-enumeration-constant
:ref:`PropertyHint<enum_@GlobalScope_PropertyHint>` **PROPERTY_HINT_RESOURCE_TYPE** = ``17``
提示屬性是 :ref:`Resource<class_Resource>` 衍生型別的實例，可通過提示字串指定（例如 ``"Texture2D"``\ ）。 編輯該屬性會顯示一個有效資源型別的彈出功能表用以產生實體。
.. _class_@GlobalScope_constant_PROPERTY_HINT_MULTILINE_TEXT:
.. rst-class:: classref-enumeration-constant
:ref:`PropertyHint<enum_@GlobalScope_PropertyHint>` **PROPERTY_HINT_MULTILINE_TEXT** = ``18``
Hints that a :ref:`String<class_String>` property is text with line breaks. Editing it will show a text input field where line breaks can be typed.
The hint string can be set to ``"monospace"`` to force the input field to use a monospaced font.
If the hint string ``"no_wrap"`` is set, the input field will not wrap lines at boundaries, instead resorting to making the area scrollable.
.. _class_@GlobalScope_constant_PROPERTY_HINT_EXPRESSION:
.. rst-class:: classref-enumeration-constant
:ref:`PropertyHint<enum_@GlobalScope_PropertyHint>` **PROPERTY_HINT_EXPRESSION** = ``19``
提示 :ref:`String<class_String>` 屬性為 :ref:`Expression<class_Expression>`\ 。
.. _class_@GlobalScope_constant_PROPERTY_HINT_PLACEHOLDER_TEXT:
.. rst-class:: classref-enumeration-constant
:ref:`PropertyHint<enum_@GlobalScope_PropertyHint>` **PROPERTY_HINT_PLACEHOLDER_TEXT** = ``20``
提示 :ref:`String<class_String>` 屬性在為空時應當顯示占位元文字。提示字串為所使用的占位元文字。
.. _class_@GlobalScope_constant_PROPERTY_HINT_COLOR_NO_ALPHA:
.. rst-class:: classref-enumeration-constant
:ref:`PropertyHint<enum_@GlobalScope_PropertyHint>` **PROPERTY_HINT_COLOR_NO_ALPHA** = ``21``
提示一個 :ref:`Color<class_Color>` 屬性在編輯時不能影響其透明度（\ :ref:`Color.a<class_Color_property_a>` 不可編輯）。
.. _class_@GlobalScope_constant_PROPERTY_HINT_OBJECT_ID:
.. rst-class:: classref-enumeration-constant
:ref:`PropertyHint<enum_@GlobalScope_PropertyHint>` **PROPERTY_HINT_OBJECT_ID** = ``22``
提示該屬性值為以物件 ID 編碼的物件，型別於 hint_string 指定；供除錯器使用。
.. _class_@GlobalScope_constant_PROPERTY_HINT_TYPE_STRING:
.. rst-class:: classref-enumeration-constant
:ref:`PropertyHint<enum_@GlobalScope_PropertyHint>` **PROPERTY_HINT_TYPE_STRING** = ``23``
若屬性為 :ref:`String<class_String>` ，表示該屬性用來指示特定型別（類別）。如此便能在「建立」對話框中選擇型別，屬性會以字串儲存所選型別。
若屬性為 :ref:`Array<class_Array>` ，此提示告知編輯器如何呈現元素。 ``hint_string`` 必須以 ``":"`` 與 ``"/"`` 編碼巢狀型別。
若屬性為 :ref:`Dictionary<class_Dictionary>` ，提示亦同，但 ``hint_string`` 需要以 ``";"`` 區隔鍵和值。
.. tabs::
.. code-tab:: gdscript
# elem_type 陣列。
hint_string = "%d:" % [elem_type]
hint_string = "%d/%d:%s" % [elem_type, elem_hint, elem_hint_string]
# elem_type 二維陣列（elem_type 的陣列陣列）。
hint_string = "%d:%d:" % [TYPE_ARRAY, elem_type]
hint_string = "%d:%d/%d:%s" % [TYPE_ARRAY, elem_type, elem_hint, elem_hint_string]
# elem_type 三維陣列（elem_type 的陣列 ×3）。
hint_string = "%d:%d:%d:" % [TYPE_ARRAY, TYPE_ARRAY, elem_type]
hint_string = "%d:%d:%d/%d:%s" % [TYPE_ARRAY, TYPE_ARRAY, elem_type, elem_hint, elem_hint_string]
.. code-tab:: csharp
// elemType 陣列。
hintString = $"{elemType:D}:";
hintString = $"{elemType:}/{elemHint:D}:{elemHintString}";
// elemType 二維陣列（elemType 的陣列陣列）。
hintString = $"{Variant.Type.Array:D}:{elemType:D}:";
hintString = $"{Variant.Type.Array:D}:{elemType:D}/{elemHint:D}:{elemHintString}";
// elemType 三維陣列（elemType 的陣列陣列陣列）。
hintString = $"{Variant.Type.Array:D}:{Variant.Type.Array:D}:{elemType:D}:";
hintString = $"{Variant.Type.Array:D}:{Variant.Type.Array:D}:{elemType:D}/{elemHint:D}:{elemHintString}";
\ **範例：**\
.. tabs::
.. code-tab:: gdscript
hint_string = "%d:" % [TYPE_INT] # 整數陣列。
hint_string = "%d/%d:1,10,1" % [TYPE_INT, PROPERTY_HINT_RANGE] # 整數陣列（1~10）。
hint_string = "%d/%d:Zero,One,Two" % [TYPE_INT, PROPERTY_HINT_ENUM] # 整數列舉陣列。
hint_string = "%d/%d:Zero,One,Three:3,Six:6" % [TYPE_INT, PROPERTY_HINT_ENUM] # 整數列舉陣列。
hint_string = "%d/%d:*.png" % [TYPE_STRING, PROPERTY_HINT_FILE] # 字串陣列（檔案路徑）。
hint_string = "%d/%d:Texture2D" % [TYPE_OBJECT, PROPERTY_HINT_RESOURCE_TYPE] # 紋理陣列。
hint_string = "%d:%d:" % [TYPE_ARRAY, TYPE_FLOAT] # 浮點數二維陣列。
hint_string = "%d:%d/%d:" % [TYPE_ARRAY, TYPE_STRING, PROPERTY_HINT_MULTILINE_TEXT] # 多行字串二維陣列。
hint_string = "%d:%d/%d:-1,1,0.1" % [TYPE_ARRAY, TYPE_FLOAT, PROPERTY_HINT_RANGE] # 浮點數二維陣列（-1~1）。
hint_string = "%d:%d/%d:Texture2D" % [TYPE_ARRAY, TYPE_OBJECT, PROPERTY_HINT_RESOURCE_TYPE] # 紋理二維陣列。
.. code-tab:: csharp
hintString = $"{Variant.Type.Int:D}/{PropertyHint.Range:D}:1,10,1"; // 整數陣列（1~10）。
hintString = $"{Variant.Type.Int:D}/{PropertyHint.Enum:D}:Zero,One,Two"; // 整數列舉陣列。
hintString = $"{Variant.Type.Int:D}/{PropertyHint.Enum:D}:Zero,One,Three:3,Six:6"; // 整數列舉陣列。
hintString = $"{Variant.Type.String:D}/{PropertyHint.File:D}:*.png"; // 字串陣列（檔案路徑）。
hintString = $"{Variant.Type.Object:D}/{PropertyHint.ResourceType:D}:Texture2D"; // 紋理陣列。
hintString = $"{Variant.Type.Array:D}:{Variant.Type.Float:D}:"; // 浮點數二維陣列。
hintString = $"{Variant.Type.Array:D}:{Variant.Type.String:D}/{PropertyHint.MultilineText:D}:"; // 多行字串二維陣列。
hintString = $"{Variant.Type.Array:D}:{Variant.Type.Float:D}/{PropertyHint.Range:D}:-1,1,0.1"; // 浮點數二維陣列（-1~1）。
hintString = $"{Variant.Type.Array:D}:{Variant.Type.Object:D}/{PropertyHint.ResourceType:D}:Texture2D"; // 紋理二維陣列。
\ **注意：** 結尾的冒號為必要，用於正確偵測內建型別。
.. _class_@GlobalScope_constant_PROPERTY_HINT_NODE_PATH_TO_EDITED_NODE:
.. rst-class:: classref-enumeration-constant
:ref:`PropertyHint<enum_@GlobalScope_PropertyHint>` **PROPERTY_HINT_NODE_PATH_TO_EDITED_NODE** = ``24``
**已棄用：** This hint is not used by the engine.
.. _class_@GlobalScope_constant_PROPERTY_HINT_OBJECT_TOO_BIG:
.. rst-class:: classref-enumeration-constant
:ref:`PropertyHint<enum_@GlobalScope_PropertyHint>` **PROPERTY_HINT_OBJECT_TOO_BIG** = ``25``
提示該物件過大，無法透過除錯器傳送。
.. _class_@GlobalScope_constant_PROPERTY_HINT_NODE_PATH_VALID_TYPES:
.. rst-class:: classref-enumeration-constant
:ref:`PropertyHint<enum_@GlobalScope_PropertyHint>` **PROPERTY_HINT_NODE_PATH_VALID_TYPES** = ``26``
提示 hint_string 指定了 :ref:`NodePath<class_NodePath>` 類型屬性可接受的節點型別。
.. _class_@GlobalScope_constant_PROPERTY_HINT_SAVE_FILE:
.. rst-class:: classref-enumeration-constant
:ref:`PropertyHint<enum_@GlobalScope_PropertyHint>` **PROPERTY_HINT_SAVE_FILE** = ``27``
提示 :ref:`String<class_String>` 屬性為檔案儲存路徑。編輯時會顯示檔案對話框並限制於專案目錄。hint_string 可包含萬用字元過濾器，如 ``"*.png,*.jpg"``\ 。另見 :ref:`FileDialog.filters<class_FileDialog_property_filters>`\ 。
.. _class_@GlobalScope_constant_PROPERTY_HINT_GLOBAL_SAVE_FILE:
.. rst-class:: classref-enumeration-constant
:ref:`PropertyHint<enum_@GlobalScope_PropertyHint>` **PROPERTY_HINT_GLOBAL_SAVE_FILE** = ``28``
提示 :ref:`String<class_String>` 屬性為檔案儲存路徑。編輯時會顯示檔案對話框，可存取整個檔案系統。hint_string 可包含萬用字元過濾器，如 ``"*.png,*.jpg"``\ 。另見 :ref:`FileDialog.filters<class_FileDialog_property_filters>`\ 。
.. _class_@GlobalScope_constant_PROPERTY_HINT_INT_IS_OBJECTID:
.. rst-class:: classref-enumeration-constant
:ref:`PropertyHint<enum_@GlobalScope_PropertyHint>` **PROPERTY_HINT_INT_IS_OBJECTID** = ``29``
**已棄用：** This hint is not used by the engine.
.. _class_@GlobalScope_constant_PROPERTY_HINT_INT_IS_POINTER:
.. rst-class:: classref-enumeration-constant
:ref:`PropertyHint<enum_@GlobalScope_PropertyHint>` **PROPERTY_HINT_INT_IS_POINTER** = ``30``
提示 :ref:`int<class_int>` 屬性為指標；供 GDExtension 使用。
.. _class_@GlobalScope_constant_PROPERTY_HINT_ARRAY_TYPE:
.. rst-class:: classref-enumeration-constant
:ref:`PropertyHint<enum_@GlobalScope_PropertyHint>` **PROPERTY_HINT_ARRAY_TYPE** = ``31``
提示該屬性為 :ref:`Array<class_Array>`\ ，其元素型別由 hint_string 指定（如 ``"String"``\ ）。
若需更進階控制，請使用 :ref:`PROPERTY_HINT_TYPE_STRING<class_@GlobalScope_constant_PROPERTY_HINT_TYPE_STRING>` 的格式。
.. _class_@GlobalScope_constant_PROPERTY_HINT_DICTIONARY_TYPE:
.. rst-class:: classref-enumeration-constant
:ref:`PropertyHint<enum_@GlobalScope_PropertyHint>` **PROPERTY_HINT_DICTIONARY_TYPE** = ``38``
提示該屬性為 :ref:`Dictionary<class_Dictionary>`\ ，其鍵與值型別由 hint_string 使用分號分隔指定，例如 ``"int;String"``\ 。
若需更進階控制，請使用 :ref:`PROPERTY_HINT_TYPE_STRING<class_@GlobalScope_constant_PROPERTY_HINT_TYPE_STRING>` 的格式。
.. _class_@GlobalScope_constant_PROPERTY_HINT_LOCALE_ID:
.. rst-class:: classref-enumeration-constant
:ref:`PropertyHint<enum_@GlobalScope_PropertyHint>` **PROPERTY_HINT_LOCALE_ID** = ``32``
提示一個字串屬性是一個區域設定程式碼。編輯它將顯示一個用於選擇語言和地區的區域設定對話方塊。
.. _class_@GlobalScope_constant_PROPERTY_HINT_LOCALIZABLE_STRING:
.. rst-class:: classref-enumeration-constant
:ref:`PropertyHint<enum_@GlobalScope_PropertyHint>` **PROPERTY_HINT_LOCALIZABLE_STRING** = ``33``
提示一個字典屬性是字串翻譯對應。字典的鍵是區域設定程式碼，值是翻譯後的字元串。
.. _class_@GlobalScope_constant_PROPERTY_HINT_NODE_TYPE:
.. rst-class:: classref-enumeration-constant
:ref:`PropertyHint<enum_@GlobalScope_PropertyHint>` **PROPERTY_HINT_NODE_TYPE** = ``34``
提示該屬性為 :ref:`Node<class_Node>` 派生型別的實例，可於 hint_string 中指定（如 ``"Node2D"``\ ）。編輯時將顯示選擇場景節點的對話框。
.. _class_@GlobalScope_constant_PROPERTY_HINT_HIDE_QUATERNION_EDIT:
.. rst-class:: classref-enumeration-constant
:ref:`PropertyHint<enum_@GlobalScope_PropertyHint>` **PROPERTY_HINT_HIDE_QUATERNION_EDIT** = ``35``
提示四元數屬性應當禁用臨時歐拉值編輯器。
.. _class_@GlobalScope_constant_PROPERTY_HINT_PASSWORD:
.. rst-class:: classref-enumeration-constant
:ref:`PropertyHint<enum_@GlobalScope_PropertyHint>` **PROPERTY_HINT_PASSWORD** = ``36``
提示字串屬性為密碼，每一個字元都會被替換為秘密字元。
.. _class_@GlobalScope_constant_PROPERTY_HINT_TOOL_BUTTON:
.. rst-class:: classref-enumeration-constant
:ref:`PropertyHint<enum_@GlobalScope_PropertyHint>` **PROPERTY_HINT_TOOL_BUTTON** = ``39``
提示 :ref:`Callable<class_Callable>` 屬性應顯示為可點擊按鈕。按下時會呼叫該 Callable。
hint_string 指定按鈕文字，並可選填 ``EditorIcons`` 主題中的圖示名稱。
::
"Click me!" - 顯示預設圖示的「Click me!」按鈕
"Click me!,ColorRect" - 顯示 ColorRect 圖示的「Click me!」按鈕
\ **注意：** :ref:`Callable<class_Callable>` 無法正確序列化儲存，建議使用 :ref:`PROPERTY_USAGE_EDITOR<class_@GlobalScope_constant_PROPERTY_USAGE_EDITOR>` 而非 :ref:`PROPERTY_USAGE_DEFAULT<class_@GlobalScope_constant_PROPERTY_USAGE_DEFAULT>`\ 。
.. _class_@GlobalScope_constant_PROPERTY_HINT_ONESHOT:
.. rst-class:: classref-enumeration-constant
:ref:`PropertyHint<enum_@GlobalScope_PropertyHint>` **PROPERTY_HINT_ONESHOT** = ``40``
提示該屬性在設定後會自行變動，例如 :ref:`AudioStreamPlayer.playing<class_AudioStreamPlayer_property_playing>` 或 :ref:`GPUParticles3D.emitting<class_GPUParticles3D_property_emitting>`\ 。
.. _class_@GlobalScope_constant_PROPERTY_HINT_GROUP_ENABLE:
.. rst-class:: classref-enumeration-constant
:ref:`PropertyHint<enum_@GlobalScope_PropertyHint>` **PROPERTY_HINT_GROUP_ENABLE** = ``42``
Hints that a boolean property will enable the feature associated with the group that it occurs in. The property will be displayed as a checkbox on the group header. Only works within a group or subgroup.
By default, disabling the property hides all properties in the group. Use the optional hint string ``"checkbox_only"`` to disable this behavior.
.. _class_@GlobalScope_constant_PROPERTY_HINT_INPUT_NAME:
.. rst-class:: classref-enumeration-constant
:ref:`PropertyHint<enum_@GlobalScope_PropertyHint>` **PROPERTY_HINT_INPUT_NAME** = ``43``
提示 :ref:`String<class_String>` 或 :ref:`StringName<class_StringName>` 屬性為輸入動作名稱，可從「專案設定 → 輸入對應」中選擇。
hint_string 可用逗號分隔以下選項：
- ``"show_builtin"``\ ：包含內建動作。
- ``"loose_mode"``\ ：允許輸入未於對應表中的任意動作名稱。
.. _class_@GlobalScope_constant_PROPERTY_HINT_FILE_PATH:
.. rst-class:: classref-enumeration-constant
:ref:`PropertyHint<enum_@GlobalScope_PropertyHint>` **PROPERTY_HINT_FILE_PATH** = ``44``
Like :ref:`PROPERTY_HINT_FILE<class_@GlobalScope_constant_PROPERTY_HINT_FILE>`, but the property is stored as a raw path, not UID. That means the reference will be broken if you move the file. Consider using :ref:`PROPERTY_HINT_FILE<class_@GlobalScope_constant_PROPERTY_HINT_FILE>` when possible.
.. _class_@GlobalScope_constant_PROPERTY_HINT_MAX:
.. rst-class:: classref-enumeration-constant
:ref:`PropertyHint<enum_@GlobalScope_PropertyHint>` **PROPERTY_HINT_MAX** = ``45``
代表 :ref:`PropertyHint<enum_@GlobalScope_PropertyHint>` 列舉的大小。
.. rst-class:: classref-item-separator
----
.. _enum_@GlobalScope_PropertyUsageFlags:
.. rst-class:: classref-enumeration
flags **PropertyUsageFlags**: :ref:`🔗<enum_@GlobalScope_PropertyUsageFlags>`
.. _class_@GlobalScope_constant_PROPERTY_USAGE_NONE:
.. rst-class:: classref-enumeration-constant
:ref:`PropertyUsageFlags<enum_@GlobalScope_PropertyUsageFlags>` **PROPERTY_USAGE_NONE** = ``0``
該屬性不被儲存，也不會顯示在編輯器中。這是非匯出屬性的預設值。
.. _class_@GlobalScope_constant_PROPERTY_USAGE_STORAGE:
.. rst-class:: classref-enumeration-constant
:ref:`PropertyUsageFlags<enum_@GlobalScope_PropertyUsageFlags>` **PROPERTY_USAGE_STORAGE** = ``2``
此屬性將被序列化並存入場景檔（匯出屬性之預設行為）。
.. _class_@GlobalScope_constant_PROPERTY_USAGE_EDITOR:
.. rst-class:: classref-enumeration-constant
:ref:`PropertyUsageFlags<enum_@GlobalScope_PropertyUsageFlags>` **PROPERTY_USAGE_EDITOR** = ``4``
此屬性將顯示於 :ref:`EditorInspector<class_EditorInspector>`\ （匯出屬性之預設行為）。
.. _class_@GlobalScope_constant_PROPERTY_USAGE_INTERNAL:
.. rst-class:: classref-enumeration-constant
:ref:`PropertyUsageFlags<enum_@GlobalScope_PropertyUsageFlags>` **PROPERTY_USAGE_INTERNAL** = ``8``
該屬性排除在類參考手冊之外。
.. _class_@GlobalScope_constant_PROPERTY_USAGE_CHECKABLE:
.. rst-class:: classref-enumeration-constant
:ref:`PropertyUsageFlags<enum_@GlobalScope_PropertyUsageFlags>` **PROPERTY_USAGE_CHECKABLE** = ``16``
該屬性可以在 :ref:`EditorInspector<class_EditorInspector>` 中被勾選。
.. _class_@GlobalScope_constant_PROPERTY_USAGE_CHECKED:
.. rst-class:: classref-enumeration-constant
:ref:`PropertyUsageFlags<enum_@GlobalScope_PropertyUsageFlags>` **PROPERTY_USAGE_CHECKED** = ``32``
該屬性在 :ref:`EditorInspector<class_EditorInspector>` 中已被勾選。
.. _class_@GlobalScope_constant_PROPERTY_USAGE_GROUP:
.. rst-class:: classref-enumeration-constant
:ref:`PropertyUsageFlags<enum_@GlobalScope_PropertyUsageFlags>` **PROPERTY_USAGE_GROUP** = ``64``
用於在編輯器中將屬性編組在一起。請參閱 :ref:`EditorInspector<class_EditorInspector>`\ 。
.. _class_@GlobalScope_constant_PROPERTY_USAGE_CATEGORY:
.. rst-class:: classref-enumeration-constant
:ref:`PropertyUsageFlags<enum_@GlobalScope_PropertyUsageFlags>` **PROPERTY_USAGE_CATEGORY** = ``128``
在編輯器中用於為屬性分類。
.. _class_@GlobalScope_constant_PROPERTY_USAGE_SUBGROUP:
.. rst-class:: classref-enumeration-constant
:ref:`PropertyUsageFlags<enum_@GlobalScope_PropertyUsageFlags>` **PROPERTY_USAGE_SUBGROUP** = ``256``
用於在子組（一個組下）中將編輯器中的屬性編組在一起。請參閱 :ref:`EditorInspector<class_EditorInspector>`\ 。
.. _class_@GlobalScope_constant_PROPERTY_USAGE_CLASS_IS_BITFIELD:
.. rst-class:: classref-enumeration-constant
:ref:`PropertyUsageFlags<enum_@GlobalScope_PropertyUsageFlags>` **PROPERTY_USAGE_CLASS_IS_BITFIELD** = ``512``
此屬性為位元欄位，包含多個以位元表示的旗標。
.. _class_@GlobalScope_constant_PROPERTY_USAGE_NO_INSTANCE_STATE:
.. rst-class:: classref-enumeration-constant
:ref:`PropertyUsageFlags<enum_@GlobalScope_PropertyUsageFlags>` **PROPERTY_USAGE_NO_INSTANCE_STATE** = ``1024``
該屬性不在 :ref:`PackedScene<class_PackedScene>` 中保存其狀態。
.. _class_@GlobalScope_constant_PROPERTY_USAGE_RESTART_IF_CHANGED:
.. rst-class:: classref-enumeration-constant
:ref:`PropertyUsageFlags<enum_@GlobalScope_PropertyUsageFlags>` **PROPERTY_USAGE_RESTART_IF_CHANGED** = ``2048``
編輯屬性會提示使用者重新開機編輯器。
.. _class_@GlobalScope_constant_PROPERTY_USAGE_SCRIPT_VARIABLE:
.. rst-class:: classref-enumeration-constant
:ref:`PropertyUsageFlags<enum_@GlobalScope_PropertyUsageFlags>` **PROPERTY_USAGE_SCRIPT_VARIABLE** = ``4096``
此屬性為腳本變數。\ :ref:`PROPERTY_USAGE_SCRIPT_VARIABLE<class_@GlobalScope_constant_PROPERTY_USAGE_SCRIPT_VARIABLE>` 可用來區分匯出的腳本變數與內建變數（後者沒有此旗標）。
預設情況下，若透過覆寫 :ref:`Object._get_property_list()<class_Object_private_method__get_property_list>` 動態建立變數，並不會自動套用此旗標。
.. _class_@GlobalScope_constant_PROPERTY_USAGE_STORE_IF_NULL:
.. rst-class:: classref-enumeration-constant
:ref:`PropertyUsageFlags<enum_@GlobalScope_PropertyUsageFlags>` **PROPERTY_USAGE_STORE_IF_NULL** = ``8192``
即便值為 ``null``\ ，\ :ref:`Object<class_Object>` 型別屬性仍會被儲存。
.. _class_@GlobalScope_constant_PROPERTY_USAGE_UPDATE_ALL_IF_MODIFIED:
.. rst-class:: classref-enumeration-constant
:ref:`PropertyUsageFlags<enum_@GlobalScope_PropertyUsageFlags>` **PROPERTY_USAGE_UPDATE_ALL_IF_MODIFIED** = ``16384``
修改此屬性時，檢查器中的所有欄位皆會重新整理。
.. _class_@GlobalScope_constant_PROPERTY_USAGE_SCRIPT_DEFAULT_VALUE:
.. rst-class:: classref-enumeration-constant
:ref:`PropertyUsageFlags<enum_@GlobalScope_PropertyUsageFlags>` **PROPERTY_USAGE_SCRIPT_DEFAULT_VALUE** = ``32768``
**已棄用：** This flag is not used by the engine.
.. _class_@GlobalScope_constant_PROPERTY_USAGE_CLASS_IS_ENUM:
.. rst-class:: classref-enumeration-constant
:ref:`PropertyUsageFlags<enum_@GlobalScope_PropertyUsageFlags>` **PROPERTY_USAGE_CLASS_IS_ENUM** = ``65536``
此屬性為列舉型別，只能取其列舉所定義的命名整數常數。
.. _class_@GlobalScope_constant_PROPERTY_USAGE_NIL_IS_VARIANT:
.. rst-class:: classref-enumeration-constant
:ref:`PropertyUsageFlags<enum_@GlobalScope_PropertyUsageFlags>` **PROPERTY_USAGE_NIL_IS_VARIANT** = ``131072``
若屬性的預設值為 ``nil``\ ，其型別將為 :ref:`Variant<class_Variant>`\ 。
.. _class_@GlobalScope_constant_PROPERTY_USAGE_ARRAY:
.. rst-class:: classref-enumeration-constant
:ref:`PropertyUsageFlags<enum_@GlobalScope_PropertyUsageFlags>` **PROPERTY_USAGE_ARRAY** = ``262144``
The property is the element count of a property array, i.e. a list of groups of related properties. Properties defined with this usage also need a specific ``class_name`` field in the form of ``label,prefix``. The field may also include additional comma-separated options:
- ``page_size=N``: Overrides :ref:`EditorSettings.interface/inspector/max_array_dictionary_items_per_page<class_EditorSettings_property_interface/inspector/max_array_dictionary_items_per_page>` for this array.
- ``add_button_text=text``: The text displayed by the "Add Element" button.
- ``static``: The elements can't be re-arranged.
- ``const``: New elements can't be added.
- ``numbered``: An index will appear next to each element.
- ``unfoldable``: The array can't be folded.
- ``swap_method=method_name``: The method that will be called when two elements switch places. The method should take 2 :ref:`int<class_int>` parameters, which will be indices of the elements being swapped.
Note that making a full-fledged property array requires boilerplate code involving :ref:`Object._get_property_list()<class_Object_private_method__get_property_list>`.
.. _class_@GlobalScope_constant_PROPERTY_USAGE_ALWAYS_DUPLICATE:
.. rst-class:: classref-enumeration-constant
:ref:`PropertyUsageFlags<enum_@GlobalScope_PropertyUsageFlags>` **PROPERTY_USAGE_ALWAYS_DUPLICATE** = ``524288``
當建立一個帶有 :ref:`Resource.duplicate()<class_Resource_method_duplicate>` 的 Resource，並且它的旗標是在一個 Resource 的屬性上設定的副本時候，無論 ``subresources`` 為多少，該屬性永遠都會被建立為副本。
.. _class_@GlobalScope_constant_PROPERTY_USAGE_NEVER_DUPLICATE:
.. rst-class:: classref-enumeration-constant
:ref:`PropertyUsageFlags<enum_@GlobalScope_PropertyUsageFlags>` **PROPERTY_USAGE_NEVER_DUPLICATE** = ``1048576``
使用 :ref:`Resource.duplicate()<class_Resource_method_duplicate>` 複製資源時，如果該資源的某個屬性上設有這個標志，則不會對該屬性進行複製，無視 ``subresources`` 布林型參數。
.. _class_@GlobalScope_constant_PROPERTY_USAGE_HIGH_END_GFX:
.. rst-class:: classref-enumeration-constant
:ref:`PropertyUsageFlags<enum_@GlobalScope_PropertyUsageFlags>` **PROPERTY_USAGE_HIGH_END_GFX** = ``2097152``
只有在支援現代算繪器（不包含 GLES3）的情況下該屬性才會在編輯器中顯示。
.. _class_@GlobalScope_constant_PROPERTY_USAGE_NODE_PATH_FROM_SCENE_ROOT:
.. rst-class:: classref-enumeration-constant
:ref:`PropertyUsageFlags<enum_@GlobalScope_PropertyUsageFlags>` **PROPERTY_USAGE_NODE_PATH_FROM_SCENE_ROOT** = ``4194304``
:ref:`NodePath<class_NodePath>` 屬性將永遠相對於場景根節點，對本地資源尤為實用。
.. _class_@GlobalScope_constant_PROPERTY_USAGE_RESOURCE_NOT_PERSISTENT:
.. rst-class:: classref-enumeration-constant
:ref:`PropertyUsageFlags<enum_@GlobalScope_PropertyUsageFlags>` **PROPERTY_USAGE_RESOURCE_NOT_PERSISTENT** = ``8388608``
當資源於存取時即時生成（getter 每次回傳不同實例）時使用，以便 :ref:`ResourceSaver<class_ResourceSaver>` 正確儲存。
.. _class_@GlobalScope_constant_PROPERTY_USAGE_KEYING_INCREMENTS:
.. rst-class:: classref-enumeration-constant
:ref:`PropertyUsageFlags<enum_@GlobalScope_PropertyUsageFlags>` **PROPERTY_USAGE_KEYING_INCREMENTS** = ``16777216``
為此屬性插入動畫關鍵影格時會自動遞增其值，可方便地連續設定多個影格。
.. _class_@GlobalScope_constant_PROPERTY_USAGE_DEFERRED_SET_RESOURCE:
.. rst-class:: classref-enumeration-constant
:ref:`PropertyUsageFlags<enum_@GlobalScope_PropertyUsageFlags>` **PROPERTY_USAGE_DEFERRED_SET_RESOURCE** = ``33554432``
**已棄用：** This flag is not used by the engine.
.. _class_@GlobalScope_constant_PROPERTY_USAGE_EDITOR_INSTANTIATE_OBJECT:
.. rst-class:: classref-enumeration-constant
:ref:`PropertyUsageFlags<enum_@GlobalScope_PropertyUsageFlags>` **PROPERTY_USAGE_EDITOR_INSTANTIATE_OBJECT** = ``67108864``
當此屬性為 :ref:`Resource<class_Resource>` 且基礎物件為 :ref:`Node<class_Node>` 時，在編輯器中建立節點將自動建立資源實例。
.. _class_@GlobalScope_constant_PROPERTY_USAGE_EDITOR_BASIC_SETTING:
.. rst-class:: classref-enumeration-constant
:ref:`PropertyUsageFlags<enum_@GlobalScope_PropertyUsageFlags>` **PROPERTY_USAGE_EDITOR_BASIC_SETTING** = ``134217728``
此屬性視為基本設定，即使在進階模式關閉時仍會顯示（用於專案設定）。
.. _class_@GlobalScope_constant_PROPERTY_USAGE_READ_ONLY:
.. rst-class:: classref-enumeration-constant
:ref:`PropertyUsageFlags<enum_@GlobalScope_PropertyUsageFlags>` **PROPERTY_USAGE_READ_ONLY** = ``268435456``
該屬性在 :ref:`EditorInspector<class_EditorInspector>` 中唯讀。
.. _class_@GlobalScope_constant_PROPERTY_USAGE_SECRET:
.. rst-class:: classref-enumeration-constant
:ref:`PropertyUsageFlags<enum_@GlobalScope_PropertyUsageFlags>` **PROPERTY_USAGE_SECRET** = ``536870912``
具有該旗標的匯出預設屬性包含機密資訊，並與匯出預設配置的其餘部分分開儲存。
.. _class_@GlobalScope_constant_PROPERTY_USAGE_DEFAULT:
.. rst-class:: classref-enumeration-constant
:ref:`PropertyUsageFlags<enum_@GlobalScope_PropertyUsageFlags>` **PROPERTY_USAGE_DEFAULT** = ``6``
預設用法（儲存和編輯器）。
.. _class_@GlobalScope_constant_PROPERTY_USAGE_NO_EDITOR:
.. rst-class:: classref-enumeration-constant
:ref:`PropertyUsageFlags<enum_@GlobalScope_PropertyUsageFlags>` **PROPERTY_USAGE_NO_EDITOR** = ``2``
預設用法，但不在編輯器中顯示屬性（儲存）。
.. rst-class:: classref-item-separator
----
.. _enum_@GlobalScope_MethodFlags:
.. rst-class:: classref-enumeration
flags **MethodFlags**: :ref:`🔗<enum_@GlobalScope_MethodFlags>`
.. _class_@GlobalScope_constant_METHOD_FLAG_NORMAL:
.. rst-class:: classref-enumeration-constant
:ref:`MethodFlags<enum_@GlobalScope_MethodFlags>` **METHOD_FLAG_NORMAL** = ``1``
普通方法的旗標。
.. _class_@GlobalScope_constant_METHOD_FLAG_EDITOR:
.. rst-class:: classref-enumeration-constant
:ref:`MethodFlags<enum_@GlobalScope_MethodFlags>` **METHOD_FLAG_EDITOR** = ``2``
編輯器方法的旗標。
.. _class_@GlobalScope_constant_METHOD_FLAG_CONST:
.. rst-class:: classref-enumeration-constant
:ref:`MethodFlags<enum_@GlobalScope_MethodFlags>` **METHOD_FLAG_CONST** = ``4``
常數方法的旗標。
.. _class_@GlobalScope_constant_METHOD_FLAG_VIRTUAL:
.. rst-class:: classref-enumeration-constant
:ref:`MethodFlags<enum_@GlobalScope_MethodFlags>` **METHOD_FLAG_VIRTUAL** = ``8``
虛方法的旗標。
.. _class_@GlobalScope_constant_METHOD_FLAG_VARARG:
.. rst-class:: classref-enumeration-constant
:ref:`MethodFlags<enum_@GlobalScope_MethodFlags>` **METHOD_FLAG_VARARG** = ``16``
具有可變數量參數的方法的旗標。
.. _class_@GlobalScope_constant_METHOD_FLAG_STATIC:
.. rst-class:: classref-enumeration-constant
:ref:`MethodFlags<enum_@GlobalScope_MethodFlags>` **METHOD_FLAG_STATIC** = ``32``
靜態方法的旗標。
.. _class_@GlobalScope_constant_METHOD_FLAG_OBJECT_CORE:
.. rst-class:: classref-enumeration-constant
:ref:`MethodFlags<enum_@GlobalScope_MethodFlags>` **METHOD_FLAG_OBJECT_CORE** = ``64``
內部使用。允許不將核心虛擬方法（例如 :ref:`Object._notification()<class_Object_private_method__notification>`\ ）轉儲到 JSON API。
.. _class_@GlobalScope_constant_METHOD_FLAG_VIRTUAL_REQUIRED:
.. rst-class:: classref-enumeration-constant
:ref:`MethodFlags<enum_@GlobalScope_MethodFlags>` **METHOD_FLAG_VIRTUAL_REQUIRED** = ``128``
Flag for a virtual method that is required. In GDScript, this flag is set for abstract functions.
.. _class_@GlobalScope_constant_METHOD_FLAGS_DEFAULT:
.. rst-class:: classref-enumeration-constant
:ref:`MethodFlags<enum_@GlobalScope_MethodFlags>` **METHOD_FLAGS_DEFAULT** = ``1``
預設方法旗標（正常）。
.. rst-class:: classref-item-separator
----
.. _enum_@GlobalScope_Variant.Type:
.. rst-class:: classref-enumeration
enum **Variant.Type**: :ref:`🔗<enum_@GlobalScope_Variant.Type>`
.. _class_@GlobalScope_constant_TYPE_NIL:
.. rst-class:: classref-enumeration-constant
:ref:`Variant.Type<enum_@GlobalScope_Variant.Type>` **TYPE_NIL** = ``0``
變數為 ``null``\ 。
.. _class_@GlobalScope_constant_TYPE_BOOL:
.. rst-class:: classref-enumeration-constant
:ref:`Variant.Type<enum_@GlobalScope_Variant.Type>` **TYPE_BOOL** = ``1``
變數型別為 :ref:`bool<class_bool>`\ 。
.. _class_@GlobalScope_constant_TYPE_INT:
.. rst-class:: classref-enumeration-constant
:ref:`Variant.Type<enum_@GlobalScope_Variant.Type>` **TYPE_INT** = ``2``
變數型別為 :ref:`int<class_int>`\ 。
.. _class_@GlobalScope_constant_TYPE_FLOAT:
.. rst-class:: classref-enumeration-constant
:ref:`Variant.Type<enum_@GlobalScope_Variant.Type>` **TYPE_FLOAT** = ``3``
變數的型別為 :ref:`float<class_float>`\ 。
.. _class_@GlobalScope_constant_TYPE_STRING:
.. rst-class:: classref-enumeration-constant
:ref:`Variant.Type<enum_@GlobalScope_Variant.Type>` **TYPE_STRING** = ``4``
變數型別為 :ref:`String<class_String>`\ 。
.. _class_@GlobalScope_constant_TYPE_VECTOR2:
.. rst-class:: classref-enumeration-constant
:ref:`Variant.Type<enum_@GlobalScope_Variant.Type>` **TYPE_VECTOR2** = ``5``
變數型別為 :ref:`Vector2<class_Vector2>`\ 。
.. _class_@GlobalScope_constant_TYPE_VECTOR2I:
.. rst-class:: classref-enumeration-constant
:ref:`Variant.Type<enum_@GlobalScope_Variant.Type>` **TYPE_VECTOR2I** = ``6``
變數型別為 :ref:`Vector2i<class_Vector2i>`\ 。
.. _class_@GlobalScope_constant_TYPE_RECT2:
.. rst-class:: classref-enumeration-constant
:ref:`Variant.Type<enum_@GlobalScope_Variant.Type>` **TYPE_RECT2** = ``7``
變數型別為 :ref:`Rect2<class_Rect2>`\ 。
.. _class_@GlobalScope_constant_TYPE_RECT2I:
.. rst-class:: classref-enumeration-constant
:ref:`Variant.Type<enum_@GlobalScope_Variant.Type>` **TYPE_RECT2I** = ``8``
變數型別為 :ref:`Rect2i<class_Rect2i>`\ 。
.. _class_@GlobalScope_constant_TYPE_VECTOR3:
.. rst-class:: classref-enumeration-constant
:ref:`Variant.Type<enum_@GlobalScope_Variant.Type>` **TYPE_VECTOR3** = ``9``
變數型別為 :ref:`Vector3<class_Vector3>`\ 。
.. _class_@GlobalScope_constant_TYPE_VECTOR3I:
.. rst-class:: classref-enumeration-constant
:ref:`Variant.Type<enum_@GlobalScope_Variant.Type>` **TYPE_VECTOR3I** = ``10``
變數型別為 :ref:`Vector3i<class_Vector3i>`\ 。
.. _class_@GlobalScope_constant_TYPE_TRANSFORM2D:
.. rst-class:: classref-enumeration-constant
:ref:`Variant.Type<enum_@GlobalScope_Variant.Type>` **TYPE_TRANSFORM2D** = ``11``
變數型別為 :ref:`Transform2D<class_Transform2D>`\ 。
.. _class_@GlobalScope_constant_TYPE_VECTOR4:
.. rst-class:: classref-enumeration-constant
:ref:`Variant.Type<enum_@GlobalScope_Variant.Type>` **TYPE_VECTOR4** = ``12``
變數型別為 :ref:`Vector4<class_Vector4>`\ 。
.. _class_@GlobalScope_constant_TYPE_VECTOR4I:
.. rst-class:: classref-enumeration-constant
:ref:`Variant.Type<enum_@GlobalScope_Variant.Type>` **TYPE_VECTOR4I** = ``13``
變數型別為 :ref:`Vector4i<class_Vector4i>`\ 。
.. _class_@GlobalScope_constant_TYPE_PLANE:
.. rst-class:: classref-enumeration-constant
:ref:`Variant.Type<enum_@GlobalScope_Variant.Type>` **TYPE_PLANE** = ``14``
變數型別為 :ref:`Plane<class_Plane>`\ 。
.. _class_@GlobalScope_constant_TYPE_QUATERNION:
.. rst-class:: classref-enumeration-constant
:ref:`Variant.Type<enum_@GlobalScope_Variant.Type>` **TYPE_QUATERNION** = ``15``
變數型別為 :ref:`Quaternion<class_Quaternion>`\ 。
.. _class_@GlobalScope_constant_TYPE_AABB:
.. rst-class:: classref-enumeration-constant
:ref:`Variant.Type<enum_@GlobalScope_Variant.Type>` **TYPE_AABB** = ``16``
變數型別為 :ref:`AABB<class_AABB>`\ 。
.. _class_@GlobalScope_constant_TYPE_BASIS:
.. rst-class:: classref-enumeration-constant
:ref:`Variant.Type<enum_@GlobalScope_Variant.Type>` **TYPE_BASIS** = ``17``
變數型別為 :ref:`Basis<class_Basis>`\ 。
.. _class_@GlobalScope_constant_TYPE_TRANSFORM3D:
.. rst-class:: classref-enumeration-constant
:ref:`Variant.Type<enum_@GlobalScope_Variant.Type>` **TYPE_TRANSFORM3D** = ``18``
變數型別為 :ref:`Transform3D<class_Transform3D>`\ 。
.. _class_@GlobalScope_constant_TYPE_PROJECTION:
.. rst-class:: classref-enumeration-constant
:ref:`Variant.Type<enum_@GlobalScope_Variant.Type>` **TYPE_PROJECTION** = ``19``
變數型別為 :ref:`Projection<class_Projection>`\ 。
.. _class_@GlobalScope_constant_TYPE_COLOR:
.. rst-class:: classref-enumeration-constant
:ref:`Variant.Type<enum_@GlobalScope_Variant.Type>` **TYPE_COLOR** = ``20``
變數型別為 :ref:`Color<class_Color>`\ 。
.. _class_@GlobalScope_constant_TYPE_STRING_NAME:
.. rst-class:: classref-enumeration-constant
:ref:`Variant.Type<enum_@GlobalScope_Variant.Type>` **TYPE_STRING_NAME** = ``21``
變數型別為 :ref:`StringName<class_StringName>`\ 。
.. _class_@GlobalScope_constant_TYPE_NODE_PATH:
.. rst-class:: classref-enumeration-constant
:ref:`Variant.Type<enum_@GlobalScope_Variant.Type>` **TYPE_NODE_PATH** = ``22``
變數型別為 :ref:`NodePath<class_NodePath>`\ 。
.. _class_@GlobalScope_constant_TYPE_RID:
.. rst-class:: classref-enumeration-constant
:ref:`Variant.Type<enum_@GlobalScope_Variant.Type>` **TYPE_RID** = ``23``
變數型別為 :ref:`RID<class_RID>`\ 。
.. _class_@GlobalScope_constant_TYPE_OBJECT:
.. rst-class:: classref-enumeration-constant
:ref:`Variant.Type<enum_@GlobalScope_Variant.Type>` **TYPE_OBJECT** = ``24``
變數型別為 :ref:`Object<class_Object>`\ 。
.. _class_@GlobalScope_constant_TYPE_CALLABLE:
.. rst-class:: classref-enumeration-constant
:ref:`Variant.Type<enum_@GlobalScope_Variant.Type>` **TYPE_CALLABLE** = ``25``
變數型別為 :ref:`Callable<class_Callable>`\ 。
.. _class_@GlobalScope_constant_TYPE_SIGNAL:
.. rst-class:: classref-enumeration-constant
:ref:`Variant.Type<enum_@GlobalScope_Variant.Type>` **TYPE_SIGNAL** = ``26``
變數型別為 :ref:`Signal<class_Signal>`\ 。
.. _class_@GlobalScope_constant_TYPE_DICTIONARY:
.. rst-class:: classref-enumeration-constant
:ref:`Variant.Type<enum_@GlobalScope_Variant.Type>` **TYPE_DICTIONARY** = ``27``
變數型別為 :ref:`Dictionary<class_Dictionary>`\ 。
.. _class_@GlobalScope_constant_TYPE_ARRAY:
.. rst-class:: classref-enumeration-constant
:ref:`Variant.Type<enum_@GlobalScope_Variant.Type>` **TYPE_ARRAY** = ``28``
變數型別為 :ref:`Array<class_Array>`\ 。
.. _class_@GlobalScope_constant_TYPE_PACKED_BYTE_ARRAY:
.. rst-class:: classref-enumeration-constant
:ref:`Variant.Type<enum_@GlobalScope_Variant.Type>` **TYPE_PACKED_BYTE_ARRAY** = ``29``
變數型別為 :ref:`PackedByteArray<class_PackedByteArray>`\ 。
.. _class_@GlobalScope_constant_TYPE_PACKED_INT32_ARRAY:
.. rst-class:: classref-enumeration-constant
:ref:`Variant.Type<enum_@GlobalScope_Variant.Type>` **TYPE_PACKED_INT32_ARRAY** = ``30``
變數型別為 :ref:`PackedInt32Array<class_PackedInt32Array>`\ 。
.. _class_@GlobalScope_constant_TYPE_PACKED_INT64_ARRAY:
.. rst-class:: classref-enumeration-constant
:ref:`Variant.Type<enum_@GlobalScope_Variant.Type>` **TYPE_PACKED_INT64_ARRAY** = ``31``
變數型別為 :ref:`PackedInt64Array<class_PackedInt64Array>`\ 。
.. _class_@GlobalScope_constant_TYPE_PACKED_FLOAT32_ARRAY:
.. rst-class:: classref-enumeration-constant
:ref:`Variant.Type<enum_@GlobalScope_Variant.Type>` **TYPE_PACKED_FLOAT32_ARRAY** = ``32``
變數型別為 :ref:`PackedFloat32Array<class_PackedFloat32Array>`\ 。
.. _class_@GlobalScope_constant_TYPE_PACKED_FLOAT64_ARRAY:
.. rst-class:: classref-enumeration-constant
:ref:`Variant.Type<enum_@GlobalScope_Variant.Type>` **TYPE_PACKED_FLOAT64_ARRAY** = ``33``
變數型別為 :ref:`PackedFloat64Array<class_PackedFloat64Array>`\ 。
.. _class_@GlobalScope_constant_TYPE_PACKED_STRING_ARRAY:
.. rst-class:: classref-enumeration-constant
:ref:`Variant.Type<enum_@GlobalScope_Variant.Type>` **TYPE_PACKED_STRING_ARRAY** = ``34``
變數型別為 :ref:`PackedStringArray<class_PackedStringArray>`\ 。
.. _class_@GlobalScope_constant_TYPE_PACKED_VECTOR2_ARRAY:
.. rst-class:: classref-enumeration-constant
:ref:`Variant.Type<enum_@GlobalScope_Variant.Type>` **TYPE_PACKED_VECTOR2_ARRAY** = ``35``
變數型別為 :ref:`PackedVector2Array<class_PackedVector2Array>`\ 。
.. _class_@GlobalScope_constant_TYPE_PACKED_VECTOR3_ARRAY:
.. rst-class:: classref-enumeration-constant
:ref:`Variant.Type<enum_@GlobalScope_Variant.Type>` **TYPE_PACKED_VECTOR3_ARRAY** = ``36``
變數型別為 :ref:`PackedVector3Array<class_PackedVector3Array>`\ 。
.. _class_@GlobalScope_constant_TYPE_PACKED_COLOR_ARRAY:
.. rst-class:: classref-enumeration-constant
:ref:`Variant.Type<enum_@GlobalScope_Variant.Type>` **TYPE_PACKED_COLOR_ARRAY** = ``37``
變數型別為 :ref:`PackedColorArray<class_PackedColorArray>`\ 。
.. _class_@GlobalScope_constant_TYPE_PACKED_VECTOR4_ARRAY:
.. rst-class:: classref-enumeration-constant
:ref:`Variant.Type<enum_@GlobalScope_Variant.Type>` **TYPE_PACKED_VECTOR4_ARRAY** = ``38``
變數型別為 :ref:`PackedVector4Array<class_PackedVector4Array>`\ 。
.. _class_@GlobalScope_constant_TYPE_MAX:
.. rst-class:: classref-enumeration-constant
:ref:`Variant.Type<enum_@GlobalScope_Variant.Type>` **TYPE_MAX** = ``39``
代表 :ref:`Variant.Type<enum_@GlobalScope_Variant.Type>` 列舉的大小。
.. rst-class:: classref-item-separator
----
.. _enum_@GlobalScope_Variant.Operator:
.. rst-class:: classref-enumeration
enum **Variant.Operator**: :ref:`🔗<enum_@GlobalScope_Variant.Operator>`
.. _class_@GlobalScope_constant_OP_EQUAL:
.. rst-class:: classref-enumeration-constant
:ref:`Variant.Operator<enum_@GlobalScope_Variant.Operator>` **OP_EQUAL** = ``0``
相等運算子（\ ``==``\ ）。
.. _class_@GlobalScope_constant_OP_NOT_EQUAL:
.. rst-class:: classref-enumeration-constant
:ref:`Variant.Operator<enum_@GlobalScope_Variant.Operator>` **OP_NOT_EQUAL** = ``1``
不等運算子（\ ``!=``\ ）。
.. _class_@GlobalScope_constant_OP_LESS:
.. rst-class:: classref-enumeration-constant
:ref:`Variant.Operator<enum_@GlobalScope_Variant.Operator>` **OP_LESS** = ``2``
小於運算子（\ ``<``\ ）。
.. _class_@GlobalScope_constant_OP_LESS_EQUAL:
.. rst-class:: classref-enumeration-constant
:ref:`Variant.Operator<enum_@GlobalScope_Variant.Operator>` **OP_LESS_EQUAL** = ``3``
小於等於運算子（\ ``<=``\ ）。
.. _class_@GlobalScope_constant_OP_GREATER:
.. rst-class:: classref-enumeration-constant
:ref:`Variant.Operator<enum_@GlobalScope_Variant.Operator>` **OP_GREATER** = ``4``
大於運算子（\ ``>``\ ）。
.. _class_@GlobalScope_constant_OP_GREATER_EQUAL:
.. rst-class:: classref-enumeration-constant
:ref:`Variant.Operator<enum_@GlobalScope_Variant.Operator>` **OP_GREATER_EQUAL** = ``5``
大於等於運算子（\ ``>=``\ ）。
.. _class_@GlobalScope_constant_OP_ADD:
.. rst-class:: classref-enumeration-constant
:ref:`Variant.Operator<enum_@GlobalScope_Variant.Operator>` **OP_ADD** = ``6``
加法運算子（\ ``+``\ ）。
.. _class_@GlobalScope_constant_OP_SUBTRACT:
.. rst-class:: classref-enumeration-constant
:ref:`Variant.Operator<enum_@GlobalScope_Variant.Operator>` **OP_SUBTRACT** = ``7``
減法運算子（\ ``-``\ ）。
.. _class_@GlobalScope_constant_OP_MULTIPLY:
.. rst-class:: classref-enumeration-constant
:ref:`Variant.Operator<enum_@GlobalScope_Variant.Operator>` **OP_MULTIPLY** = ``8``
乘法運算子（\ ``*``\ ）。
.. _class_@GlobalScope_constant_OP_DIVIDE:
.. rst-class:: classref-enumeration-constant
:ref:`Variant.Operator<enum_@GlobalScope_Variant.Operator>` **OP_DIVIDE** = ``9``
除法運算子（\ ``/``\ ）。
.. _class_@GlobalScope_constant_OP_NEGATE:
.. rst-class:: classref-enumeration-constant
:ref:`Variant.Operator<enum_@GlobalScope_Variant.Operator>` **OP_NEGATE** = ``10``
一元減號運算子（\ ``-``\ ）。
.. _class_@GlobalScope_constant_OP_POSITIVE:
.. rst-class:: classref-enumeration-constant
:ref:`Variant.Operator<enum_@GlobalScope_Variant.Operator>` **OP_POSITIVE** = ``11``
一元加號運算子（\ ``+``\ ）。
.. _class_@GlobalScope_constant_OP_MODULE:
.. rst-class:: classref-enumeration-constant
:ref:`Variant.Operator<enum_@GlobalScope_Variant.Operator>` **OP_MODULE** = ``12``
餘數/取模運算子（\ ``%``\ ）。
.. _class_@GlobalScope_constant_OP_POWER:
.. rst-class:: classref-enumeration-constant
:ref:`Variant.Operator<enum_@GlobalScope_Variant.Operator>` **OP_POWER** = ``13``
冪運算子（\ ``**``\ ）。
.. _class_@GlobalScope_constant_OP_SHIFT_LEFT:
.. rst-class:: classref-enumeration-constant
:ref:`Variant.Operator<enum_@GlobalScope_Variant.Operator>` **OP_SHIFT_LEFT** = ``14``
左移運算子（\ ``<<``\ ）。
.. _class_@GlobalScope_constant_OP_SHIFT_RIGHT:
.. rst-class:: classref-enumeration-constant
:ref:`Variant.Operator<enum_@GlobalScope_Variant.Operator>` **OP_SHIFT_RIGHT** = ``15``
右移運算子（\ ``>>``\ ）。
.. _class_@GlobalScope_constant_OP_BIT_AND:
.. rst-class:: classref-enumeration-constant
:ref:`Variant.Operator<enum_@GlobalScope_Variant.Operator>` **OP_BIT_AND** = ``16``
按位與運算子（\ ``&``\ ）。
.. _class_@GlobalScope_constant_OP_BIT_OR:
.. rst-class:: classref-enumeration-constant
:ref:`Variant.Operator<enum_@GlobalScope_Variant.Operator>` **OP_BIT_OR** = ``17``
按位或運算子（\ ``|``\ ）。
.. _class_@GlobalScope_constant_OP_BIT_XOR:
.. rst-class:: classref-enumeration-constant
:ref:`Variant.Operator<enum_@GlobalScope_Variant.Operator>` **OP_BIT_XOR** = ``18``
按位異或運算子（\ ``^``\ ）。
.. _class_@GlobalScope_constant_OP_BIT_NEGATE:
.. rst-class:: classref-enumeration-constant
:ref:`Variant.Operator<enum_@GlobalScope_Variant.Operator>` **OP_BIT_NEGATE** = ``19``
按位非運算子（\ ``~``\ ）。
.. _class_@GlobalScope_constant_OP_AND:
.. rst-class:: classref-enumeration-constant
:ref:`Variant.Operator<enum_@GlobalScope_Variant.Operator>` **OP_AND** = ``20``
邏輯與運算子（\ ``and`` 或 ``&&``\ ）。
.. _class_@GlobalScope_constant_OP_OR:
.. rst-class:: classref-enumeration-constant
:ref:`Variant.Operator<enum_@GlobalScope_Variant.Operator>` **OP_OR** = ``21``
邏輯或運算子（\ ``or`` 或 ``||``\ ）。
.. _class_@GlobalScope_constant_OP_XOR:
.. rst-class:: classref-enumeration-constant
:ref:`Variant.Operator<enum_@GlobalScope_Variant.Operator>` **OP_XOR** = ``22``
邏輯異或運算子（未在 GDScript 中實作）。
.. _class_@GlobalScope_constant_OP_NOT:
.. rst-class:: classref-enumeration-constant
:ref:`Variant.Operator<enum_@GlobalScope_Variant.Operator>` **OP_NOT** = ``23``
邏輯非運算子（\ ``not`` 或 ``!``\ ）。
.. _class_@GlobalScope_constant_OP_IN:
.. rst-class:: classref-enumeration-constant
:ref:`Variant.Operator<enum_@GlobalScope_Variant.Operator>` **OP_IN** = ``24``
邏輯 IN 運算子（\ ``in``\ ）。
.. _class_@GlobalScope_constant_OP_MAX:
.. rst-class:: classref-enumeration-constant
:ref:`Variant.Operator<enum_@GlobalScope_Variant.Operator>` **OP_MAX** = ``25``
代表 :ref:`Variant.Operator<enum_@GlobalScope_Variant.Operator>` 列舉的大小。
.. rst-class:: classref-section-separator
----
.. rst-class:: classref-descriptions-group
屬性說明
--------
.. _class_@GlobalScope_property_AudioServer:
.. rst-class:: classref-property
:ref:`AudioServer<class_AudioServer>` **AudioServer** :ref:`🔗<class_@GlobalScope_property_AudioServer>`
:ref:`AudioServer<class_AudioServer>` 單例。
.. rst-class:: classref-item-separator
----
.. _class_@GlobalScope_property_CameraServer:
.. rst-class:: classref-property
:ref:`CameraServer<class_CameraServer>` **CameraServer** :ref:`🔗<class_@GlobalScope_property_CameraServer>`
:ref:`CameraServer<class_CameraServer>` 單例。
.. rst-class:: classref-item-separator
----
.. _class_@GlobalScope_property_ClassDB:
.. rst-class:: classref-property
:ref:`ClassDB<class_ClassDB>` **ClassDB** :ref:`🔗<class_@GlobalScope_property_ClassDB>`
:ref:`ClassDB<class_ClassDB>` 單例。
.. rst-class:: classref-item-separator
----
.. _class_@GlobalScope_property_DisplayServer:
.. rst-class:: classref-property
:ref:`DisplayServer<class_DisplayServer>` **DisplayServer** :ref:`🔗<class_@GlobalScope_property_DisplayServer>`
:ref:`DisplayServer<class_DisplayServer>` 單例。
.. rst-class:: classref-item-separator
----
.. _class_@GlobalScope_property_EditorInterface:
.. rst-class:: classref-property
:ref:`EditorInterface<class_EditorInterface>` **EditorInterface** :ref:`🔗<class_@GlobalScope_property_EditorInterface>`
:ref:`JavaClassWrapper<class_JavaClassWrapper>` 單例。
\ **注意：**\ 僅在 Android 上實作。
.. rst-class:: classref-item-separator
----
.. _class_@GlobalScope_property_Engine:
.. rst-class:: classref-property
:ref:`Engine<class_Engine>` **Engine** :ref:`🔗<class_@GlobalScope_property_Engine>`
:ref:`Engine<class_Engine>` 單例。
.. rst-class:: classref-item-separator
----
.. _class_@GlobalScope_property_EngineDebugger:
.. rst-class:: classref-property
:ref:`EngineDebugger<class_EngineDebugger>` **EngineDebugger** :ref:`🔗<class_@GlobalScope_property_EngineDebugger>`
:ref:`EngineDebugger<class_EngineDebugger>` 單例。
.. rst-class:: classref-item-separator
----
.. _class_@GlobalScope_property_GDExtensionManager:
.. rst-class:: classref-property
:ref:`GDExtensionManager<class_GDExtensionManager>` **GDExtensionManager** :ref:`🔗<class_@GlobalScope_property_GDExtensionManager>`
:ref:`GDExtensionManager<class_GDExtensionManager>` 單例。
.. rst-class:: classref-item-separator
----
.. _class_@GlobalScope_property_Geometry2D:
.. rst-class:: classref-property
:ref:`Geometry2D<class_Geometry2D>` **Geometry2D** :ref:`🔗<class_@GlobalScope_property_Geometry2D>`
:ref:`Geometry2D<class_Geometry2D>` 單例。
.. rst-class:: classref-item-separator
----
.. _class_@GlobalScope_property_Geometry3D:
.. rst-class:: classref-property
:ref:`Geometry3D<class_Geometry3D>` **Geometry3D** :ref:`🔗<class_@GlobalScope_property_Geometry3D>`
:ref:`Geometry3D<class_Geometry3D>` 單例。
.. rst-class:: classref-item-separator
----
.. _class_@GlobalScope_property_IP:
.. rst-class:: classref-property
:ref:`IP<class_IP>` **IP** :ref:`🔗<class_@GlobalScope_property_IP>`
:ref:`IP<class_IP>` 單例。
.. rst-class:: classref-item-separator
----
.. _class_@GlobalScope_property_Input:
.. rst-class:: classref-property
:ref:`Input<class_Input>` **Input** :ref:`🔗<class_@GlobalScope_property_Input>`
:ref:`Input<class_Input>` 單例。
.. rst-class:: classref-item-separator
----
.. _class_@GlobalScope_property_InputMap:
.. rst-class:: classref-property
:ref:`InputMap<class_InputMap>` **InputMap** :ref:`🔗<class_@GlobalScope_property_InputMap>`
:ref:`InputMap<class_InputMap>` 單例。
.. rst-class:: classref-item-separator
----
.. _class_@GlobalScope_property_JavaClassWrapper:
.. rst-class:: classref-property
:ref:`JavaClassWrapper<class_JavaClassWrapper>` **JavaClassWrapper** :ref:`🔗<class_@GlobalScope_property_JavaClassWrapper>`
:ref:`JavaClassWrapper<class_JavaClassWrapper>` 單例。
\ **注意：**\ 僅在 Android 上實作。
.. rst-class:: classref-item-separator
----
.. _class_@GlobalScope_property_JavaScriptBridge:
.. rst-class:: classref-property
:ref:`JavaScriptBridge<class_JavaScriptBridge>` **JavaScriptBridge** :ref:`🔗<class_@GlobalScope_property_JavaScriptBridge>`
:ref:`JavaScriptBridge<class_JavaScriptBridge>` 單例。
\ **注意：**\ 僅在 Web 平臺上實作。
.. rst-class:: classref-item-separator
----
.. _class_@GlobalScope_property_Marshalls:
.. rst-class:: classref-property
:ref:`Marshalls<class_Marshalls>` **Marshalls** :ref:`🔗<class_@GlobalScope_property_Marshalls>`
:ref:`Marshalls<class_Marshalls>` 單例。
.. rst-class:: classref-item-separator
----
.. _class_@GlobalScope_property_NativeMenu:
.. rst-class:: classref-property
:ref:`NativeMenu<class_NativeMenu>` **NativeMenu** :ref:`🔗<class_@GlobalScope_property_NativeMenu>`
:ref:`NativeMenu<class_NativeMenu>` 單例。
\ **注意：** 僅於 macOS 提供實作。
.. rst-class:: classref-item-separator
----
.. _class_@GlobalScope_property_NavigationMeshGenerator:
.. rst-class:: classref-property
:ref:`NavigationMeshGenerator<class_NavigationMeshGenerator>` **NavigationMeshGenerator** :ref:`🔗<class_@GlobalScope_property_NavigationMeshGenerator>`
:ref:`NavigationMeshGenerator<class_NavigationMeshGenerator>` 單例。
.. rst-class:: classref-item-separator
----
.. _class_@GlobalScope_property_NavigationServer2D:
.. rst-class:: classref-property
:ref:`NavigationServer2D<class_NavigationServer2D>` **NavigationServer2D** :ref:`🔗<class_@GlobalScope_property_NavigationServer2D>`
:ref:`NavigationServer2D<class_NavigationServer2D>` 單例。
.. rst-class:: classref-item-separator
----
.. _class_@GlobalScope_property_NavigationServer2DManager:
.. rst-class:: classref-property
:ref:`NavigationServer2DManager<class_NavigationServer2DManager>` **NavigationServer2DManager** :ref:`🔗<class_@GlobalScope_property_NavigationServer2DManager>`
The :ref:`NavigationServer2DManager<class_NavigationServer2DManager>` singleton.
.. rst-class:: classref-item-separator
----
.. _class_@GlobalScope_property_NavigationServer3D:
.. rst-class:: classref-property
:ref:`NavigationServer3D<class_NavigationServer3D>` **NavigationServer3D** :ref:`🔗<class_@GlobalScope_property_NavigationServer3D>`
:ref:`NavigationServer3D<class_NavigationServer3D>` 單例。
.. rst-class:: classref-item-separator
----
.. _class_@GlobalScope_property_NavigationServer3DManager:
.. rst-class:: classref-property
:ref:`NavigationServer3DManager<class_NavigationServer3DManager>` **NavigationServer3DManager** :ref:`🔗<class_@GlobalScope_property_NavigationServer3DManager>`
The :ref:`NavigationServer3DManager<class_NavigationServer3DManager>` singleton.
.. rst-class:: classref-item-separator
----
.. _class_@GlobalScope_property_OS:
.. rst-class:: classref-property
:ref:`OS<class_OS>` **OS** :ref:`🔗<class_@GlobalScope_property_OS>`
:ref:`OS<class_OS>` 單例。
.. rst-class:: classref-item-separator
----
.. _class_@GlobalScope_property_Performance:
.. rst-class:: classref-property
:ref:`Performance<class_Performance>` **Performance** :ref:`🔗<class_@GlobalScope_property_Performance>`
:ref:`Performance<class_Performance>` 單例。
.. rst-class:: classref-item-separator
----
.. _class_@GlobalScope_property_PhysicsServer2D:
.. rst-class:: classref-property
:ref:`PhysicsServer2D<class_PhysicsServer2D>` **PhysicsServer2D** :ref:`🔗<class_@GlobalScope_property_PhysicsServer2D>`
:ref:`PhysicsServer2D<class_PhysicsServer2D>` 單例。
.. rst-class:: classref-item-separator
----
.. _class_@GlobalScope_property_PhysicsServer2DManager:
.. rst-class:: classref-property
:ref:`PhysicsServer2DManager<class_PhysicsServer2DManager>` **PhysicsServer2DManager** :ref:`🔗<class_@GlobalScope_property_PhysicsServer2DManager>`
:ref:`PhysicsServer2DManager<class_PhysicsServer2DManager>` 單例。
.. rst-class:: classref-item-separator
----
.. _class_@GlobalScope_property_PhysicsServer3D:
.. rst-class:: classref-property
:ref:`PhysicsServer3D<class_PhysicsServer3D>` **PhysicsServer3D** :ref:`🔗<class_@GlobalScope_property_PhysicsServer3D>`
:ref:`PhysicsServer3D<class_PhysicsServer3D>` 單例。
.. rst-class:: classref-item-separator
----
.. _class_@GlobalScope_property_PhysicsServer3DManager:
.. rst-class:: classref-property
:ref:`PhysicsServer3DManager<class_PhysicsServer3DManager>` **PhysicsServer3DManager** :ref:`🔗<class_@GlobalScope_property_PhysicsServer3DManager>`
:ref:`PhysicsServer3DManager<class_PhysicsServer3DManager>` 單例。
.. rst-class:: classref-item-separator
----
.. _class_@GlobalScope_property_ProjectSettings:
.. rst-class:: classref-property
:ref:`ProjectSettings<class_ProjectSettings>` **ProjectSettings** :ref:`🔗<class_@GlobalScope_property_ProjectSettings>`
:ref:`ProjectSettings<class_ProjectSettings>` 單例。
.. rst-class:: classref-item-separator
----
.. _class_@GlobalScope_property_RenderingServer:
.. rst-class:: classref-property
:ref:`RenderingServer<class_RenderingServer>` **RenderingServer** :ref:`🔗<class_@GlobalScope_property_RenderingServer>`
:ref:`RenderingServer<class_RenderingServer>` 單例。
.. rst-class:: classref-item-separator
----
.. _class_@GlobalScope_property_ResourceLoader:
.. rst-class:: classref-property
:ref:`ResourceLoader<class_ResourceLoader>` **ResourceLoader** :ref:`🔗<class_@GlobalScope_property_ResourceLoader>`
:ref:`ResourceLoader<class_ResourceLoader>` 單例。
.. rst-class:: classref-item-separator
----
.. _class_@GlobalScope_property_ResourceSaver:
.. rst-class:: classref-property
:ref:`ResourceSaver<class_ResourceSaver>` **ResourceSaver** :ref:`🔗<class_@GlobalScope_property_ResourceSaver>`
:ref:`ResourceSaver<class_ResourceSaver>` 單例。
.. rst-class:: classref-item-separator
----
.. _class_@GlobalScope_property_ResourceUID:
.. rst-class:: classref-property
:ref:`ResourceUID<class_ResourceUID>` **ResourceUID** :ref:`🔗<class_@GlobalScope_property_ResourceUID>`
:ref:`ResourceUID<class_ResourceUID>` 單例。
.. rst-class:: classref-item-separator
----
.. _class_@GlobalScope_property_TextServerManager:
.. rst-class:: classref-property
:ref:`TextServerManager<class_TextServerManager>` **TextServerManager** :ref:`🔗<class_@GlobalScope_property_TextServerManager>`
:ref:`TextServerManager<class_TextServerManager>` 單例。
.. rst-class:: classref-item-separator
----
.. _class_@GlobalScope_property_ThemeDB:
.. rst-class:: classref-property
:ref:`ThemeDB<class_ThemeDB>` **ThemeDB** :ref:`🔗<class_@GlobalScope_property_ThemeDB>`
:ref:`ThemeDB<class_ThemeDB>` 單例。
.. rst-class:: classref-item-separator
----
.. _class_@GlobalScope_property_Time:
.. rst-class:: classref-property
:ref:`Time<class_Time>` **Time** :ref:`🔗<class_@GlobalScope_property_Time>`
:ref:`Time<class_Time>` 單例。
.. rst-class:: classref-item-separator
----
.. _class_@GlobalScope_property_TranslationServer:
.. rst-class:: classref-property
:ref:`TranslationServer<class_TranslationServer>` **TranslationServer** :ref:`🔗<class_@GlobalScope_property_TranslationServer>`
:ref:`TranslationServer<class_TranslationServer>` 單例。
.. rst-class:: classref-item-separator
----
.. _class_@GlobalScope_property_WorkerThreadPool:
.. rst-class:: classref-property
:ref:`WorkerThreadPool<class_WorkerThreadPool>` **WorkerThreadPool** :ref:`🔗<class_@GlobalScope_property_WorkerThreadPool>`
:ref:`WorkerThreadPool<class_WorkerThreadPool>` 單例。
.. rst-class:: classref-item-separator
----
.. _class_@GlobalScope_property_XRServer:
.. rst-class:: classref-property
:ref:`XRServer<class_XRServer>` **XRServer** :ref:`🔗<class_@GlobalScope_property_XRServer>`
:ref:`XRServer<class_XRServer>` 單例。
.. rst-class:: classref-section-separator
----
.. rst-class:: classref-descriptions-group
方法說明
--------
.. _class_@GlobalScope_method_abs:
.. rst-class:: classref-method
:ref:`Variant<class_Variant>` **abs**\ (\ x\: :ref:`Variant<class_Variant>`\ ) :ref:`🔗<class_@GlobalScope_method_abs>`
返回一個 :ref:`Variant<class_Variant>` 型別參數 ``x`` 的絕對值（即非負值）。支援的型別：\ :ref:`int<class_int>`\ 、\ :ref:`float<class_float>`\ 、\ :ref:`Vector2<class_Vector2>`\ 、\ :ref:`Vector2i<class_Vector2i>`\ 、\ :ref:`Vector3<class_Vector3>`\ 、\ :ref:`Vector3i<class_Vector3i>`\ 、\ :ref:`Vector4<class_Vector4>`\ 、\ :ref:`Vector4i<class_Vector4i>` 。
::
var a = abs(-1)
# a=1
var b = abs(-1.2)
# b=1.2
var c = abs(Vector2(-3.5, -4))
# c=(3.5, 4)
var d = abs(Vector2i(-5, -6))
# d=(5, 6)
var e = abs(Vector3(-7, 8.5, -3.8))
# e=(7, 8.5, 3.8)
var f = abs(Vector3i(-7, -8, -9))
# f=(7, 8, 9)
\ **注意：**\ 為了更好的型別安全，請使用 :ref:`absf()<class_@GlobalScope_method_absf>`\ 、\ :ref:`absi()<class_@GlobalScope_method_absi>`\ 、\ :ref:`Vector2.abs()<class_Vector2_method_abs>`\ 、\ :ref:`Vector2i.abs()<class_Vector2i_method_abs>`\ 、\ :ref:`Vector3.abs()<class_Vector3_method_abs>`\ 、\ :ref:`Vector3i.abs()<class_Vector3i_method_abs>`\ 、\ :ref:`Vector4.abs()<class_Vector4_method_abs>` 或 :ref:`Vector4i.abs()<class_Vector4i_method_abs>`\ 。
.. rst-class:: classref-item-separator
----
.. _class_@GlobalScope_method_absf:
.. rst-class:: classref-method
:ref:`float<class_float>` **absf**\ (\ x\: :ref:`float<class_float>`\ ) :ref:`🔗<class_@GlobalScope_method_absf>`
返回浮點參數 ``x`` 的絕對值（即正值）。
::
# a=1.2
var a = absf(-1.2)
.. rst-class:: classref-item-separator
----
.. _class_@GlobalScope_method_absi:
.. rst-class:: classref-method
:ref:`int<class_int>` **absi**\ (\ x\: :ref:`int<class_int>`\ ) :ref:`🔗<class_@GlobalScope_method_absi>`
返回整數參數 ``x`` 的絕對值（即正值）。
::
# a=1
var a = absi(-1)
.. rst-class:: classref-item-separator
----
.. _class_@GlobalScope_method_acos:
.. rst-class:: classref-method
:ref:`float<class_float>` **acos**\ (\ x\: :ref:`float<class_float>`\ ) :ref:`🔗<class_@GlobalScope_method_acos>`
返回 ``x`` 的反餘弦，單位為弧度。用來獲取餘弦 ``x`` 的角度。\ ``x`` 會被鉗制在 ``-1.0`` 和 ``1.0``\ （包括）之間，因此 :ref:`acos()<class_@GlobalScope_method_acos>` 不會返回 :ref:`@GDScript.NAN<class_@GDScript_constant_NAN>`\ 。
::
# 如果用 rad_to_deg(c) 轉換，c為0.523599或30度
var c = acos(0.866025)
.. rst-class:: classref-item-separator
----
.. _class_@GlobalScope_method_acosh:
.. rst-class:: classref-method
:ref:`float<class_float>` **acosh**\ (\ x\: :ref:`float<class_float>`\ ) :ref:`🔗<class_@GlobalScope_method_acosh>`
返回參數 x 的雙曲弧（也稱為反餘弦），返回弧度值。使用它來獲取在雙曲空間中，如果參數 x 大於或等於 1 ，角的餘弦的角度。對於參數 x 小於 1 的值，將返回 0 ，以防止 :ref:`acosh()<class_@GlobalScope_method_acosh>` 返回 :ref:`@GDScript.NAN<class_@GDScript_constant_NAN>` 。
::
var a = acosh(2) # 返回 1.31695789692482
cosh(a) # 返回 2
var b = acosh(-1) # 返回 0
.. rst-class:: classref-item-separator
----
.. _class_@GlobalScope_method_angle_difference:
.. rst-class:: classref-method
:ref:`float<class_float>` **angle_difference**\ (\ from\: :ref:`float<class_float>`, to\: :ref:`float<class_float>`\ ) :ref:`🔗<class_@GlobalScope_method_angle_difference>`
回傳兩角度（弧度制）的差值，範圍為 ``[-PI, +PI]``\ 。
若 ``from`` 與 ``to`` 方向相反，且 ``from`` 小於 ``to`` 時回傳 ``-PI``\ ，否則回傳 ``PI``\ 。
.. rst-class:: classref-item-separator
----
.. _class_@GlobalScope_method_asin:
.. rst-class:: classref-method
:ref:`float<class_float>` **asin**\ (\ x\: :ref:`float<class_float>`\ ) :ref:`🔗<class_@GlobalScope_method_asin>`
返回 ``x`` 的反正弦值，單位為弧度。用來獲取正弦 ``x`` 的角度。\ ``x`` 會被鉗制在 ``-1.0`` 和 ``1.0``\ （包括）之間，因此 :ref:`asin()<class_@GlobalScope_method_asin>` 不會返回 :ref:`@GDScript.NAN<class_@GDScript_constant_NAN>`\ 。
::
# 如果用 rad_to_deg(s) 轉換，s為0.523599或30度
var s = asin(0.5)
.. rst-class:: classref-item-separator
----
.. _class_@GlobalScope_method_asinh:
.. rst-class:: classref-method
:ref:`float<class_float>` **asinh**\ (\ x\: :ref:`float<class_float>`\ ) :ref:`🔗<class_@GlobalScope_method_asinh>`
返回參數 x 的雙曲弧（也稱為反正弦），返回弧度值。使用它來獲取在雙曲空間中，角的正弦角度。
::
var a = asinh(0.9) # 返回 0.8088669356527824
sinh(a) # 返回 0.9
.. rst-class:: classref-item-separator
----
.. _class_@GlobalScope_method_atan:
.. rst-class:: classref-method
:ref:`float<class_float>` **atan**\ (\ x\: :ref:`float<class_float>`\ ) :ref:`🔗<class_@GlobalScope_method_atan>`
返回 ``x`` 的反正切值，單位為弧度。可用於由三角函數中的切線值取得角度。
此方法無法判斷角度應該落於哪一象限。如果你同時有 ``y`` 與 ``x``\ ，請參考 :ref:`atan2()<class_@GlobalScope_method_atan2>`\ 。
::
var a = atan(0.5) # a 是 0.463648
若 ``x`` 介於 ``-PI / 2`` 與 ``PI / 2``\ （含）之間，\ ``atan(tan(x))`` 等於 ``x``\ 。
.. rst-class:: classref-item-separator
----
.. _class_@GlobalScope_method_atan2:
.. rst-class:: classref-method
:ref:`float<class_float>` **atan2**\ (\ y\: :ref:`float<class_float>`, x\: :ref:`float<class_float>`\ ) :ref:`🔗<class_@GlobalScope_method_atan2>`
返回 ``y/x`` 的反正切值，單位為弧度。用來獲得正切值為 ``y/x`` 的角度。為了計算該值，該方法考慮了兩個參數的符號，以確定象限。
重要提示：按照慣例，Y 座標在前。
::
var a = atan2(0, -1) # a = 3.141593
.. rst-class:: classref-item-separator
----
.. _class_@GlobalScope_method_atanh:
.. rst-class:: classref-method
:ref:`float<class_float>` **atanh**\ (\ x\: :ref:`float<class_float>`\ ) :ref:`🔗<class_@GlobalScope_method_atanh>`
返回 ``x`` 的雙曲弧（也稱為反正切），以弧度為單位。如果 ``x`` 在 -1 和 1 之間（不包括 -1 和 1 ），則使用它從雙曲空間中的角度的正切值獲取角度。
在數學中，只有在實數集中，-1 < ``x`` < 1 的情況下，雙曲反正切才有意義。因此，為了預防 :ref:`atanh()<class_@GlobalScope_method_atanh>` 返回 :ref:`@GDScript.NAN<class_@GDScript_constant_NAN>` ，對於 ``x`` 等於或小於 -1 的值，返回負的 :ref:`@GDScript.NAN<class_@GDScript_constant_NAN>` ；對於\ ``x``\ 等於或大於 1 的值，返回正的 :ref:`@GDScript.INF<class_@GDScript_constant_INF>` 。
::
var a = atanh(0.9) # 返回 1.47221948958322
tanh(a) # 返回 0.9
var b = atanh(-2) # 返回 -inf
tanh(b) # 返回 -1
.. rst-class:: classref-item-separator
----
.. _class_@GlobalScope_method_bezier_derivative:
.. rst-class:: classref-method
:ref:`float<class_float>` **bezier_derivative**\ (\ start\: :ref:`float<class_float>`, control_1\: :ref:`float<class_float>`, control_2\: :ref:`float<class_float>`, end\: :ref:`float<class_float>`, t\: :ref:`float<class_float>`\ ) :ref:`🔗<class_@GlobalScope_method_bezier_derivative>`
返回由給定的 ``control_1``\ 、\ ``control_2`` 和 ``end`` 點定義的一維\ `貝茲曲線 <https://en.wikipedia.org/wiki/B%C3%A9zier_curve>`__\ 上 ``t`` 處的導數。
.. rst-class:: classref-item-separator
----
.. _class_@GlobalScope_method_bezier_interpolate:
.. rst-class:: classref-method
:ref:`float<class_float>` **bezier_interpolate**\ (\ start\: :ref:`float<class_float>`, control_1\: :ref:`float<class_float>`, control_2\: :ref:`float<class_float>`, end\: :ref:`float<class_float>`, t\: :ref:`float<class_float>`\ ) :ref:`🔗<class_@GlobalScope_method_bezier_interpolate>`
返回由給定的 ``control_1``\ 、\ ``control_2`` 和 ``end`` 點定義的一維\ `貝茲曲線 <https://en.wikipedia.org/wiki/B%C3%A9zier_curve>`__\ 上位於給定 ``t`` 的點。
.. rst-class:: classref-item-separator
----
.. _class_@GlobalScope_method_bytes_to_var:
.. rst-class:: classref-method
:ref:`Variant<class_Variant>` **bytes_to_var**\ (\ bytes\: :ref:`PackedByteArray<class_PackedByteArray>`\ ) :ref:`🔗<class_@GlobalScope_method_bytes_to_var>`
將位元組陣列解碼回 :ref:`Variant<class_Variant>` 值，無法解碼物件。
\ **注意：**\ 如果需要物件反序列化，請參見 :ref:`bytes_to_var_with_objects()<class_@GlobalScope_method_bytes_to_var_with_objects>`\ 。
.. rst-class:: classref-item-separator
----
.. _class_@GlobalScope_method_bytes_to_var_with_objects:
.. rst-class:: classref-method
:ref:`Variant<class_Variant>` **bytes_to_var_with_objects**\ (\ bytes\: :ref:`PackedByteArray<class_PackedByteArray>`\ ) :ref:`🔗<class_@GlobalScope_method_bytes_to_var_with_objects>`
將位元組陣列解碼回 :ref:`Variant<class_Variant>` 值。允許解碼物件。
\ **警告：**\ 反序列化的物件可能包含執行的程式碼。如果序列化物件的來源不受信任，則不要使用此選項，以避免潛在的安全威脅（遠端執行程式碼）。
.. rst-class:: classref-item-separator
----
.. _class_@GlobalScope_method_ceil:
.. rst-class:: classref-method
:ref:`Variant<class_Variant>` **ceil**\ (\ x\: :ref:`Variant<class_Variant>`\ ) :ref:`🔗<class_@GlobalScope_method_ceil>`
將 ``x`` 向上取整（朝正無窮大），回傳不小於 ``x`` 的最小整數。
支援型別： :ref:`int<class_int>`\ 、\ :ref:`float<class_float>`\ 、\ :ref:`Vector2<class_Vector2>`\ 、\ :ref:`Vector2i<class_Vector2i>`\ 、\ :ref:`Vector3<class_Vector3>`\ 、\ :ref:`Vector3i<class_Vector3i>`\ 、\ :ref:`Vector4<class_Vector4>`\ 、\ :ref:`Vector4i<class_Vector4i>`\ 。
::
var i = ceil(1.45) # i 為 2.0
i = ceil(1.001) # i 為 2.0
另見 :ref:`floor()<class_@GlobalScope_method_floor>`\ 、\ :ref:`round()<class_@GlobalScope_method_round>` 與 :ref:`snapped()<class_@GlobalScope_method_snapped>`\ 。
\ **注意：** 為獲得更佳的型別安全性，請使用 :ref:`ceilf()<class_@GlobalScope_method_ceilf>`\ 、\ :ref:`ceili()<class_@GlobalScope_method_ceili>`\ 、\ :ref:`Vector2.ceil()<class_Vector2_method_ceil>`\ 、\ :ref:`Vector3.ceil()<class_Vector3_method_ceil>` 或 :ref:`Vector4.ceil()<class_Vector4_method_ceil>`\ 。
.. rst-class:: classref-item-separator
----
.. _class_@GlobalScope_method_ceilf:
.. rst-class:: classref-method
:ref:`float<class_float>` **ceilf**\ (\ x\: :ref:`float<class_float>`\ ) :ref:`🔗<class_@GlobalScope_method_ceilf>`
向上四捨五入 ``x``\ （朝正無窮大），返回不小於 ``x`` 的最小整數。
\ :ref:`ceil()<class_@GlobalScope_method_ceil>` 的型別安全版本，返回一個 :ref:`float<class_float>`\ 。
.. rst-class:: classref-item-separator
----
.. _class_@GlobalScope_method_ceili:
.. rst-class:: classref-method
:ref:`int<class_int>` **ceili**\ (\ x\: :ref:`float<class_float>`\ ) :ref:`🔗<class_@GlobalScope_method_ceili>`
向上四捨五入 ``x``\ （朝正無窮大），返回不小於 ``x`` 的最小整數。
\ :ref:`ceil()<class_@GlobalScope_method_ceil>` 的型別安全版本，返回一個 :ref:`int<class_int>`\ 。
.. rst-class:: classref-item-separator
----
.. _class_@GlobalScope_method_clamp:
.. rst-class:: classref-method
:ref:`Variant<class_Variant>` **clamp**\ (\ value\: :ref:`Variant<class_Variant>`, min\: :ref:`Variant<class_Variant>`, max\: :ref:`Variant<class_Variant>`\ ) :ref:`🔗<class_@GlobalScope_method_clamp>`
將 ``value`` 限制在 ``min`` 與 ``max`` 之間，回傳不小於 ``min`` 且不大於 ``max`` 的 :ref:`Variant<class_Variant>`\ 。任何可用於大小比較的值都適用。
::
var a = clamp(-10, -1, 5)
# a 為 -1
var b = clamp(8.1, 0.9, 5.5)
# b 為 5.5
\ **注意：**\ 為提升型別安全性，請優先使用 :ref:`clampf()<class_@GlobalScope_method_clampf>`\ 、\ :ref:`clampi()<class_@GlobalScope_method_clampi>`\ 、\ :ref:`Vector2.clamp()<class_Vector2_method_clamp>`\ 、\ :ref:`Vector2i.clamp()<class_Vector2i_method_clamp>`\ 、\ :ref:`Vector3.clamp()<class_Vector3_method_clamp>`\ 、\ :ref:`Vector3i.clamp()<class_Vector3i_method_clamp>`\ 、\ :ref:`Vector4.clamp()<class_Vector4_method_clamp>`\ 、\ :ref:`Vector4i.clamp()<class_Vector4i_method_clamp>` 或 :ref:`Color.clamp()<class_Color_method_clamp>`\ （本函式目前尚不支援 Color）。
\ **注意：**\ 若對向量使用本函式時，將\ *不會*\ 進行分量逐一夾限，只會判斷整體值，若if ``value < min``\ 則回傳 ``min``\ ，\ ``value > max``\ 則回傳 ``max``\ 。若需分量夾限請用上述方法。
.. rst-class:: classref-item-separator
----
.. _class_@GlobalScope_method_clampf:
.. rst-class:: classref-method
:ref:`float<class_float>` **clampf**\ (\ value\: :ref:`float<class_float>`, min\: :ref:`float<class_float>`, max\: :ref:`float<class_float>`\ ) :ref:`🔗<class_@GlobalScope_method_clampf>`
鉗制 ``value``\ ，返回不小於 ``min`` 且不大於 ``max`` 的 :ref:`float<class_float>`\ 。
::
var speed = 42.1
var a = clampf(speed, 1.0, 20.5) # a 是 20.5
speed = -10.0
var b = clampf(speed, -1.0, 1.0) # b 是 -1.0
.. rst-class:: classref-item-separator
----
.. _class_@GlobalScope_method_clampi:
.. rst-class:: classref-method
:ref:`int<class_int>` **clampi**\ (\ value\: :ref:`int<class_int>`, min\: :ref:`int<class_int>`, max\: :ref:`int<class_int>`\ ) :ref:`🔗<class_@GlobalScope_method_clampi>`
鉗制 ``value``\ ，返回不小於 ``min`` 且不大於 ``max`` 的 :ref:`int<class_int>`\ 。
::
var speed = 42
var a = clampi(speed, 1, 20) # a 是 20
speed = -10
var b = clampi(speed, -1, 1) # b 是 -1
.. rst-class:: classref-item-separator
----
.. _class_@GlobalScope_method_cos:
.. rst-class:: classref-method
:ref:`float<class_float>` **cos**\ (\ angle_rad\: :ref:`float<class_float>`\ ) :ref:`🔗<class_@GlobalScope_method_cos>`
返回弧度角為 ``angle_rad`` 的餘弦值。
::
cos(PI * 2) # 返回 1.0
cos(PI) # 返回 -1.0
cos(deg_to_rad(90)) # 返回 0.0
.. rst-class:: classref-item-separator
----
.. _class_@GlobalScope_method_cosh:
.. rst-class:: classref-method
:ref:`float<class_float>` **cosh**\ (\ x\: :ref:`float<class_float>`\ ) :ref:`🔗<class_@GlobalScope_method_cosh>`
返回弧度角 ``x`` 的雙曲餘弦值。
::
print(cosh(1)) # 列印 1.543081
.. rst-class:: classref-item-separator
----
.. _class_@GlobalScope_method_cubic_interpolate:
.. rst-class:: classref-method
:ref:`float<class_float>` **cubic_interpolate**\ (\ from\: :ref:`float<class_float>`, to\: :ref:`float<class_float>`, pre\: :ref:`float<class_float>`, post\: :ref:`float<class_float>`, weight\: :ref:`float<class_float>`\ ) :ref:`🔗<class_@GlobalScope_method_cubic_interpolate>`
根據 ``weight`` 中定義的因數以及 ``pre`` 和 ``post`` 值，在兩個值之間進行三次插值。
.. rst-class:: classref-item-separator
----
.. _class_@GlobalScope_method_cubic_interpolate_angle:
.. rst-class:: classref-method
:ref:`float<class_float>` **cubic_interpolate_angle**\ (\ from\: :ref:`float<class_float>`, to\: :ref:`float<class_float>`, pre\: :ref:`float<class_float>`, post\: :ref:`float<class_float>`, weight\: :ref:`float<class_float>`\ ) :ref:`🔗<class_@GlobalScope_method_cubic_interpolate_angle>`
根據 ``weight`` 中定義的因數以及 ``pre`` 和 ``post`` 值，在具有最短路徑的兩個旋轉值之間三次插值 。另見 :ref:`lerp_angle()<class_@GlobalScope_method_lerp_angle>`\ 。
.. rst-class:: classref-item-separator
----
.. _class_@GlobalScope_method_cubic_interpolate_angle_in_time:
.. rst-class:: classref-method
:ref:`float<class_float>` **cubic_interpolate_angle_in_time**\ (\ from\: :ref:`float<class_float>`, to\: :ref:`float<class_float>`, pre\: :ref:`float<class_float>`, post\: :ref:`float<class_float>`, weight\: :ref:`float<class_float>`, to_t\: :ref:`float<class_float>`, pre_t\: :ref:`float<class_float>`, post_t\: :ref:`float<class_float>`\ ) :ref:`🔗<class_@GlobalScope_method_cubic_interpolate_angle_in_time>`
以三次曲線插值法，根據 ``weight``\ 、\ ``pre``\ 、\ ``post`` 於兩個旋轉值間進行最短路徑插值。詳見 :ref:`lerp_angle()<class_@GlobalScope_method_lerp_angle>`\ 。
此方法針對角度（旋轉）插值可提供比 :ref:`cubic_interpolate()<class_@GlobalScope_method_cubic_interpolate>` 更平滑的結果。
.. rst-class:: classref-item-separator
----
.. _class_@GlobalScope_method_cubic_interpolate_in_time:
.. rst-class:: classref-method
:ref:`float<class_float>` **cubic_interpolate_in_time**\ (\ from\: :ref:`float<class_float>`, to\: :ref:`float<class_float>`, pre\: :ref:`float<class_float>`, post\: :ref:`float<class_float>`, weight\: :ref:`float<class_float>`, to_t\: :ref:`float<class_float>`, pre_t\: :ref:`float<class_float>`, post_t\: :ref:`float<class_float>`\ ) :ref:`🔗<class_@GlobalScope_method_cubic_interpolate_in_time>`
根據 ``weight`` 中定義的因數以及 ``pre`` 和 ``post`` 值，在兩個值之間進行三次插值。
它可以根據時間值執行比 :ref:`cubic_interpolate()<class_@GlobalScope_method_cubic_interpolate>` 更平滑的插值。
.. rst-class:: classref-item-separator
----
.. _class_@GlobalScope_method_db_to_linear:
.. rst-class:: classref-method
:ref:`float<class_float>` **db_to_linear**\ (\ db\: :ref:`float<class_float>`\ ) :ref:`🔗<class_@GlobalScope_method_db_to_linear>`
從分貝轉換為線性能量（音訊）。
.. rst-class:: classref-item-separator
----
.. _class_@GlobalScope_method_deg_to_rad:
.. rst-class:: classref-method
:ref:`float<class_float>` **deg_to_rad**\ (\ deg\: :ref:`float<class_float>`\ ) :ref:`🔗<class_@GlobalScope_method_deg_to_rad>`
將角度值轉換為弧度值。
::
var r = deg_to_rad(180) # r 是 3.141593
.. rst-class:: classref-item-separator
----
.. _class_@GlobalScope_method_ease:
.. rst-class:: classref-method
:ref:`float<class_float>` **ease**\ (\ x\: :ref:`float<class_float>`, curve\: :ref:`float<class_float>`\ ) :ref:`🔗<class_@GlobalScope_method_ease>`
依 ``curve`` 指定的指數緩動函式，回傳 ``x`` 的「緩動值」。
\ ``curve`` 可為任意浮點數，對應行為如下：
::
- 小於 -1.0：緩入緩出
- -1.0：線性
- -1.0 ~ 0.0：緩出緩入
- 0.0：常數
- 0.0 ~ 1.0：緩出
- 1.0：線性
- 大於 1.0：緩入
\ `ease() 曲線速查表 <https://raw.githubusercontent.com/godotengine/godot-docs/4.1/img/ease_cheatsheet.png>`__\
另見 :ref:`smoothstep()<class_@GlobalScope_method_smoothstep>`\ 。若需更進階的轉場，請使用 :ref:`Tween.interpolate_value()<class_Tween_method_interpolate_value>`\ 。
.. rst-class:: classref-item-separator
----
.. _class_@GlobalScope_method_error_string:
.. rst-class:: classref-method
:ref:`String<class_String>` **error_string**\ (\ error\: :ref:`int<class_int>`\ ) :ref:`🔗<class_@GlobalScope_method_error_string>`
回傳指定 :ref:`Error<enum_@GlobalScope_Error>` 錯誤碼的可讀名稱。
::
print(OK) # 輸出 0
print(error_string(OK)) # 輸出 "OK"
print(error_string(ERR_BUSY)) # 輸出 "Busy"
print(error_string(ERR_OUT_OF_MEMORY)) # 輸出 "Out of memory"
.. rst-class:: classref-item-separator
----
.. _class_@GlobalScope_method_exp:
.. rst-class:: classref-method
:ref:`float<class_float>` **exp**\ (\ x\: :ref:`float<class_float>`\ ) :ref:`🔗<class_@GlobalScope_method_exp>`
自然指數函式。計算數學常數 *e* 的 ``x`` 次方並返回它。
\ *e* 的近似值為 2.71828，可以使用 ``exp(1)`` 獲得。
求其他底數的指數應使用 :ref:`pow()<class_@GlobalScope_method_pow>` 方法。
::
var a = exp(2) # 大約是 7.39
.. rst-class:: classref-item-separator
----
.. _class_@GlobalScope_method_floor:
.. rst-class:: classref-method
:ref:`Variant<class_Variant>` **floor**\ (\ x\: :ref:`Variant<class_Variant>`\ ) :ref:`🔗<class_@GlobalScope_method_floor>`
將 ``x`` 向下取整（朝負無窮大），回傳不大於 ``x`` 的最大整數。
支援型別： :ref:`int<class_int>`\ 、\ :ref:`float<class_float>`\ 、\ :ref:`Vector2<class_Vector2>`\ 、\ :ref:`Vector2i<class_Vector2i>`\ 、\ :ref:`Vector3<class_Vector3>`\ 、\ :ref:`Vector3i<class_Vector3i>`\ 、\ :ref:`Vector4<class_Vector4>`\ 、\ :ref:`Vector4i<class_Vector4i>`\ 。
::
var a = floor(2.99) # a 為 2.0
a = floor(-2.99) # a 為 -3.0
另見 :ref:`ceil()<class_@GlobalScope_method_ceil>`\ 、\ :ref:`round()<class_@GlobalScope_method_round>` 與 :ref:`snapped()<class_@GlobalScope_method_snapped>`\ 。
\ **注意：** 為獲得更佳的型別安全性，請使用 :ref:`floorf()<class_@GlobalScope_method_floorf>`\ 、\ :ref:`floori()<class_@GlobalScope_method_floori>`\ 、\ :ref:`Vector2.floor()<class_Vector2_method_floor>`\ 、\ :ref:`Vector3.floor()<class_Vector3_method_floor>` 或 :ref:`Vector4.floor()<class_Vector4_method_floor>`\ 。
.. rst-class:: classref-item-separator
----
.. _class_@GlobalScope_method_floorf:
.. rst-class:: classref-method
:ref:`float<class_float>` **floorf**\ (\ x\: :ref:`float<class_float>`\ ) :ref:`🔗<class_@GlobalScope_method_floorf>`
將 ``x`` 向下四捨五入（向負無窮大），返回不超過 ``x`` 的最大整數。
一個型別安全的 :ref:`floor()<class_@GlobalScope_method_floor>` 版本，返回一個 :ref:`float<class_float>`\ 。
.. rst-class:: classref-item-separator
----
.. _class_@GlobalScope_method_floori:
.. rst-class:: classref-method
:ref:`int<class_int>` **floori**\ (\ x\: :ref:`float<class_float>`\ ) :ref:`🔗<class_@GlobalScope_method_floori>`
將 ``x`` 向下四捨五入（向負無窮大），返回不超過 ``x`` 的最大整數。
是 :ref:`floor()<class_@GlobalScope_method_floor>` 的型別安全版本，返回一個 :ref:`int<class_int>`\ 。
\ **注意：**\ 這個函式與 ``int(x)`` *不* 一樣，後者是向 0 取整。
.. rst-class:: classref-item-separator
----
.. _class_@GlobalScope_method_fmod:
.. rst-class:: classref-method
:ref:`float<class_float>` **fmod**\ (\ x\: :ref:`float<class_float>`, y\: :ref:`float<class_float>`\ ) :ref:`🔗<class_@GlobalScope_method_fmod>`
返回 ``x`` 除以 ``y`` 的浮點型餘數，符號與 ``x``\ 一致。
::
var remainder = fmod(7, 5.5) # remainder 是 1.5
對於整數取餘運算，請使用 ``%`` 運算子。
.. rst-class:: classref-item-separator
----
.. _class_@GlobalScope_method_fposmod:
.. rst-class:: classref-method
:ref:`float<class_float>` **fposmod**\ (\ x\: :ref:`float<class_float>`, y\: :ref:`float<class_float>`\ ) :ref:`🔗<class_@GlobalScope_method_fposmod>`
回傳 ``x`` 除以 ``y`` 的浮點餘數，對正負軸均勻包覆。
::
print(" (x) (fmod(x, 1.5)) (fposmod(x, 1.5))")
for i in 7:
var x = i * 0.5 - 1.5
print("%4.1f %4.1f | %4.1f" % [x, fmod(x, 1.5), fposmod(x, 1.5)])
輸出：
::
(x) (fmod(x, 1.5)) (fposmod(x, 1.5))
-1.5 -0.0 | 0.0
-1.0 -1.0 | 0.5
-0.5 -0.5 | 1.0
0.0 0.0 | 0.0
0.5 0.5 | 0.5
1.0 1.0 | 1.0
1.5 0.0 | 0.0
.. rst-class:: classref-item-separator
----
.. _class_@GlobalScope_method_hash:
.. rst-class:: classref-method
:ref:`int<class_int>` **hash**\ (\ variable\: :ref:`Variant<class_Variant>`\ ) :ref:`🔗<class_@GlobalScope_method_hash>`
返回傳入的 ``variable`` 的整數雜湊值。
.. tabs::
.. code-tab:: gdscript
print(hash("a")) # 輸出 177670
.. code-tab:: csharp
GD.Print(GD.Hash("a")); // 輸出 177670
.. rst-class:: classref-item-separator
----
.. _class_@GlobalScope_method_instance_from_id:
.. rst-class:: classref-method
:ref:`Object<class_Object>` **instance_from_id**\ (\ instance_id\: :ref:`int<class_int>`\ ) :ref:`🔗<class_@GlobalScope_method_instance_from_id>`
Returns the :ref:`Object<class_Object>` that corresponds to ``instance_id``. All Objects have a unique instance ID. See also :ref:`Object.get_instance_id()<class_Object_method_get_instance_id>`.
.. tabs::
.. code-tab:: gdscript
var drink = "water"
func _ready():
var id = get_instance_id()
var instance = instance_from_id(id)
print(instance.drink) # Prints "water"
.. code-tab:: csharp
public partial class MyNode : Node
{
public string Drink { get; set; } = "water";
public override void _Ready()
{
ulong id = GetInstanceId();
var instance = (MyNode)InstanceFromId(Id);
GD.Print(instance.Drink); // Prints "water"
}
}
.. rst-class:: classref-item-separator
----
.. _class_@GlobalScope_method_inverse_lerp:
.. rst-class:: classref-method
:ref:`float<class_float>` **inverse_lerp**\ (\ from\: :ref:`float<class_float>`, to\: :ref:`float<class_float>`, weight\: :ref:`float<class_float>`\ ) :ref:`🔗<class_@GlobalScope_method_inverse_lerp>`
返回插值或外推的因數。範圍用 ``from`` 和 ``to``\ 指定，插值後的值由 ``weight`` 指定。如果 ``weight`` 在 ``from`` 和 ``to`` 之間（包含），那麼返回的值在 ``0.0`` 和 ``1.0`` 之間。如果 ``weight`` 在該範圍之外，則返回的是外推因數（返回值小於 ``0.0`` 或大於 ``1.0``\ ）。如果不希望這樣，請對 :ref:`inverse_lerp()<class_@GlobalScope_method_inverse_lerp>` 的結果使用 :ref:`clamp()<class_@GlobalScope_method_clamp>`\ 。
::
# 下面的 `lerp()` 呼叫時的插值比例是 0.75。
var middle = lerp(20, 30, 0.75)
# middle 現在是 27.5。
# 現在，我們假裝忘記了原來的比例，想要找到是多少。
var ratio = inverse_lerp(20, 30, 27.5)
# ratio 現在是 0.75。
另見 :ref:`lerp()<class_@GlobalScope_method_lerp>`\ ，它執行本操作的逆操作；以及 :ref:`remap()<class_@GlobalScope_method_remap>`\ ，將一系列連續的值對應到另一個值。
.. rst-class:: classref-item-separator
----
.. _class_@GlobalScope_method_is_equal_approx:
.. rst-class:: classref-method
:ref:`bool<class_bool>` **is_equal_approx**\ (\ a\: :ref:`float<class_float>`, b\: :ref:`float<class_float>`\ ) :ref:`🔗<class_@GlobalScope_method_is_equal_approx>`
如果 ``a`` 和 ``b`` 彼此近似相等，則返回 ``true``\ 。
這裡，“近似相等”意味著 ``a`` 和 ``b`` 在彼此的一個小的內部 epsilon 內，該 epsilon 與數位的大小成比例。
相同符號的無窮大值被認為是相等的。
.. rst-class:: classref-item-separator
----
.. _class_@GlobalScope_method_is_finite:
.. rst-class:: classref-method
:ref:`bool<class_bool>` **is_finite**\ (\ x\: :ref:`float<class_float>`\ ) :ref:`🔗<class_@GlobalScope_method_is_finite>`
判斷 ``x`` 是否為有限值，也就是既非 :ref:`@GDScript.NAN<class_@GDScript_constant_NAN>`\ 、亦非正或負無窮大。
另見 :ref:`is_inf()<class_@GlobalScope_method_is_inf>` 與 :ref:`is_nan()<class_@GlobalScope_method_is_nan>`\ 。
.. rst-class:: classref-item-separator
----
.. _class_@GlobalScope_method_is_inf:
.. rst-class:: classref-method
:ref:`bool<class_bool>` **is_inf**\ (\ x\: :ref:`float<class_float>`\ ) :ref:`🔗<class_@GlobalScope_method_is_inf>`
若 ``x`` 為正無窮大或負無窮大則回傳 ``true``\ 。
另見 :ref:`is_finite()<class_@GlobalScope_method_is_finite>` 與 :ref:`is_nan()<class_@GlobalScope_method_is_nan>`\ 。
.. rst-class:: classref-item-separator
----
.. _class_@GlobalScope_method_is_instance_id_valid:
.. rst-class:: classref-method
:ref:`bool<class_bool>` **is_instance_id_valid**\ (\ id\: :ref:`int<class_int>`\ ) :ref:`🔗<class_@GlobalScope_method_is_instance_id_valid>`
如果與 ``id`` 對應的 Object 是有效的物件（例如沒有從記憶體中刪除），則返回 ``true`` 。所有物件都有唯一的實例 ID。
.. rst-class:: classref-item-separator
----
.. _class_@GlobalScope_method_is_instance_valid:
.. rst-class:: classref-method
:ref:`bool<class_bool>` **is_instance_valid**\ (\ instance\: :ref:`Variant<class_Variant>`\ ) :ref:`🔗<class_@GlobalScope_method_is_instance_valid>`
如果 ``instance`` 是有效的 Object（例如，沒有從記憶體中刪除），則返回 ``true`` 。
.. rst-class:: classref-item-separator
----
.. _class_@GlobalScope_method_is_nan:
.. rst-class:: classref-method
:ref:`bool<class_bool>` **is_nan**\ (\ x\: :ref:`float<class_float>`\ ) :ref:`🔗<class_@GlobalScope_method_is_nan>`
若 ``x`` 為 NaN（「非數字」或無效值）則回傳 ``true``\ 。
由於 :ref:`@GDScript.NAN<class_@GDScript_constant_NAN>` 不等於自身，因此無法使用 ``x == NAN`` 來檢測 NaN，必須使用本方法。
.. rst-class:: classref-item-separator
----
.. _class_@GlobalScope_method_is_same:
.. rst-class:: classref-method
:ref:`bool<class_bool>` **is_same**\ (\ a\: :ref:`Variant<class_Variant>`, b\: :ref:`Variant<class_Variant>`\ ) :ref:`🔗<class_@GlobalScope_method_is_same>`
若為值型別，當 ``a`` 與 ``b`` 之值相同則回傳 ``true``\ ；
若為參考型別，當兩者引用為同一物件時回傳 ``true``\ 。
::
# Vector2 為值型別
var vec2_a = Vector2(0, 0)
var vec2_b = Vector2(0, 0)
var vec2_c = Vector2(1, 1)
is_same(vec2_a, vec2_a) # true
is_same(vec2_a, vec2_b) # true
is_same(vec2_a, vec2_c) # false
# Array 為參考型別
var arr_a = []
var arr_b = []
is_same(arr_a, arr_a) # true
is_same(arr_a, arr_b) # false
\ :ref:`Variant<class_Variant>` 值型別包含： ``null``\ 、\ :ref:`bool<class_bool>`\ 、\ :ref:`int<class_int>`\ 、\ :ref:`float<class_float>`\ 、\ :ref:`String<class_String>`\ 、\ :ref:`StringName<class_StringName>`\ 、\ :ref:`Vector2<class_Vector2>`\ 、\ :ref:`Vector2i<class_Vector2i>`\ 、\ :ref:`Vector3<class_Vector3>`\ 、\ :ref:`Vector3i<class_Vector3i>`\ 、\ :ref:`Vector4<class_Vector4>`\ 、\ :ref:`Vector4i<class_Vector4i>`\ 、\ :ref:`Rect2<class_Rect2>`\ 、\ :ref:`Rect2i<class_Rect2i>`\ 、\ :ref:`Transform2D<class_Transform2D>`\ 、\ :ref:`Transform3D<class_Transform3D>`\ 、\ :ref:`Plane<class_Plane>`\ 、\ :ref:`Quaternion<class_Quaternion>`\ 、\ :ref:`AABB<class_AABB>`\ 、\ :ref:`Basis<class_Basis>`\ 、\ :ref:`Projection<class_Projection>`\ 、\ :ref:`Color<class_Color>`\ 、\ :ref:`NodePath<class_NodePath>`\ 、\ :ref:`RID<class_RID>`\ 、\ :ref:`Callable<class_Callable>` 及 :ref:`Signal<class_Signal>`\ 。
\ :ref:`Variant<class_Variant>` 參考型別包含： :ref:`Object<class_Object>`\ 、\ :ref:`Dictionary<class_Dictionary>`\ 、\ :ref:`Array<class_Array>`\ 、\ :ref:`PackedByteArray<class_PackedByteArray>`\ 、\ :ref:`PackedInt32Array<class_PackedInt32Array>`\ 、\ :ref:`PackedInt64Array<class_PackedInt64Array>`\ 、\ :ref:`PackedFloat32Array<class_PackedFloat32Array>`\ 、\ :ref:`PackedFloat64Array<class_PackedFloat64Array>`\ 、\ :ref:`PackedStringArray<class_PackedStringArray>`\ 、\ :ref:`PackedVector2Array<class_PackedVector2Array>`\ 、\ :ref:`PackedVector3Array<class_PackedVector3Array>`\ 、\ :ref:`PackedVector4Array<class_PackedVector4Array>` 與 :ref:`PackedColorArray<class_PackedColorArray>`\ 。
.. rst-class:: classref-item-separator
----
.. _class_@GlobalScope_method_is_zero_approx:
.. rst-class:: classref-method
:ref:`bool<class_bool>` **is_zero_approx**\ (\ x\: :ref:`float<class_float>`\ ) :ref:`🔗<class_@GlobalScope_method_is_zero_approx>`
如果 ``x`` 為零或幾乎為零，則返回 ``true``\ 。比較是使用具有小內部 epsilon 的公差計算的。
該函式比使用一個值為零的 :ref:`is_equal_approx()<class_@GlobalScope_method_is_equal_approx>` 更快。
.. rst-class:: classref-item-separator
----
.. _class_@GlobalScope_method_lerp:
.. rst-class:: classref-method
:ref:`Variant<class_Variant>` **lerp**\ (\ from\: :ref:`Variant<class_Variant>`, to\: :ref:`Variant<class_Variant>`, weight\: :ref:`Variant<class_Variant>`\ ) :ref:`🔗<class_@GlobalScope_method_lerp>`
依 ``weight`` 線性插值 ``from`` 與 ``to``\ 。
\ ``weight`` 應介於 ``0.0``\ ～\ ``1.0``\ （含）之間；若超出則為 *外推*\ 。如不需外推，可先對 ``weight`` 使用 :ref:`clampf()<class_@GlobalScope_method_clampf>` 限制。
\ ``from`` 與 ``to`` 必須為相同型別。支援型別： :ref:`int<class_int>`\ 、\ :ref:`float<class_float>`\ 、\ :ref:`Vector2<class_Vector2>`\ 、\ :ref:`Vector3<class_Vector3>`\ 、\ :ref:`Vector4<class_Vector4>`\ 、\ :ref:`Color<class_Color>`\ 、\ :ref:`Quaternion<class_Quaternion>`\ 、\ :ref:`Basis<class_Basis>`\ 、\ :ref:`Transform2D<class_Transform2D>`\ 、\ :ref:`Transform3D<class_Transform3D>`\ 。
::
lerp(0, 4, 0.75) # 回傳 3.0
反向操作請參考 :ref:`inverse_lerp()<class_@GlobalScope_method_inverse_lerp>`\ 。
若要進行緩動插值，可將 :ref:`lerp()<class_@GlobalScope_method_lerp>` 與 :ref:`ease()<class_@GlobalScope_method_ease>` 或 :ref:`smoothstep()<class_@GlobalScope_method_smoothstep>` 結合使用。
若要映射連續值區間，請參考 :ref:`remap()<class_@GlobalScope_method_remap>`\ 。
\ **注意：** 為確保型別安全，可使用 :ref:`lerpf()<class_@GlobalScope_method_lerpf>`\ 、\ :ref:`Vector2.lerp()<class_Vector2_method_lerp>`\ 、\ :ref:`Vector3.lerp()<class_Vector3_method_lerp>`\ 、\ :ref:`Vector4.lerp()<class_Vector4_method_lerp>`\ 、\ :ref:`Color.lerp()<class_Color_method_lerp>`\ 、\ :ref:`Quaternion.slerp()<class_Quaternion_method_slerp>`\ 、\ :ref:`Basis.slerp()<class_Basis_method_slerp>`\ 、\ :ref:`Transform2D.interpolate_with()<class_Transform2D_method_interpolate_with>` 或 :ref:`Transform3D.interpolate_with()<class_Transform3D_method_interpolate_with>`\ 。
.. rst-class:: classref-item-separator
----
.. _class_@GlobalScope_method_lerp_angle:
.. rst-class:: classref-method
:ref:`float<class_float>` **lerp_angle**\ (\ from\: :ref:`float<class_float>`, to\: :ref:`float<class_float>`, weight\: :ref:`float<class_float>`\ ) :ref:`🔗<class_@GlobalScope_method_lerp_angle>`
通過 0.0 和 1.0 之間的 ``weight`` 值，在兩個角度（以弧度為單位）之間進行線性插值。
類似於 :ref:`lerp()<class_@GlobalScope_method_lerp>`\ ，但當角度環繞 :ref:`@GDScript.TAU<class_@GDScript_constant_TAU>` 時會正確插值。要使用 :ref:`lerp_angle()<class_@GlobalScope_method_lerp_angle>` 執行緩動插值，請將其與 :ref:`ease()<class_@GlobalScope_method_ease>` 或 :ref:`smoothstep()<class_@GlobalScope_method_smoothstep>` 結合使用。
::
extends Sprite
var elapsed = 0.0
func _process(delta):
var min_angle = deg_to_rad(0.0)
var max_angle = deg_to_rad(90.0)
rotation = lerp_angle(min_angle, max_angle, elapsed)
elapsed += delta
\ **注意：**\ 該函式通過 ``from`` 和 ``to`` 之間的最短路徑進行插值。然而，當這兩個角度相距大致 ``PI + k * TAU`` 其中 ``k`` 為任意整數時，由於浮點數精度誤差的緣故，要對插值的方向進行判斷是很難的。例如，\ ``lerp_angle(0, PI, weight)`` 會逆時針插值，而 ``lerp_angle(0, PI + 5 * TAU, weight)`` 則會順時針插值。
.. rst-class:: classref-item-separator
----
.. _class_@GlobalScope_method_lerpf:
.. rst-class:: classref-method
:ref:`float<class_float>` **lerpf**\ (\ from\: :ref:`float<class_float>`, to\: :ref:`float<class_float>`, weight\: :ref:`float<class_float>`\ ) :ref:`🔗<class_@GlobalScope_method_lerpf>`
通過 ``weight`` 中定義的因數在兩個值之間進行線性插值。要執行插值，\ ``weight`` 應介於 ``0.0`` 和 ``1.0`` 之間（包含）。但是，超出此範圍的值是允許的，並可用於執行 *外推*\ 。如果不需要，請對此函式的結果使用 :ref:`clampf()<class_@GlobalScope_method_clampf>`\ 。
::
lerpf(0, 4, 0.75) # 返回 3.0
另請參閱執行本操作的逆運算的 :ref:`inverse_lerp()<class_@GlobalScope_method_inverse_lerp>`\ 。要使用 :ref:`lerp()<class_@GlobalScope_method_lerp>` 執行緩動插值，請將其與 :ref:`ease()<class_@GlobalScope_method_ease>` 或 :ref:`smoothstep()<class_@GlobalScope_method_smoothstep>` 結合使用。
.. rst-class:: classref-item-separator
----
.. _class_@GlobalScope_method_linear_to_db:
.. rst-class:: classref-method
:ref:`float<class_float>` **linear_to_db**\ (\ lin\: :ref:`float<class_float>`\ ) :ref:`🔗<class_@GlobalScope_method_linear_to_db>`
將線性能量轉換為分貝（音訊）。由於音量通常不是線性的，可利用此函式實作預期的音量滑桿。
\ **範例：** 透過 :ref:`Slider<class_Slider>` 節點（取值範圍 ``0.0``\ ~\ ``1.0``\ ）調整主匯流排音量：
::
AudioServer.set_bus_volume_db(AudioServer.get_bus_index("Master"), linear_to_db($Slider.value))
.. rst-class:: classref-item-separator
----
.. _class_@GlobalScope_method_log:
.. rst-class:: classref-method
:ref:`float<class_float>` **log**\ (\ x\: :ref:`float<class_float>`\ ) :ref:`🔗<class_@GlobalScope_method_log>`
返回 ``x`` 的\ `自然對數 <https://zh.wikipedia.org/wiki/自然對數>`__\ （底數 `[i]e[/i] <https://zh.wikipedia.org/wiki/E_(mathematical_constant)>`__\ ，\ *e* 約為 2.71828）。這代表達到某成長程度所需的時間。
\ **注意：** 與多數計算機上的「log」不同，計算機預設底數為 10。若需以底數 10，請用 ``log(x) / log(10)``\ 。
::
log(10) # 返回 2.302585
\ **注意：** ``0`` 的對數會回傳 ``-inf``\ ，負值會回傳 ``-nan``\ 。
.. rst-class:: classref-item-separator
----
.. _class_@GlobalScope_method_max:
.. rst-class:: classref-method
:ref:`Variant<class_Variant>` **max**\ (\ ...\ ) |vararg| :ref:`🔗<class_@GlobalScope_method_max>`
返回給定數值中的最大值。此函數可以接受任意數量的參數。
::
max(1, 7, 3, -6, 5) # Returns 7
\ **注意：**\ 當對向量使用此函數時，它\ *不會*\ 執行分量級的最大值計算，而是使用 ``x < y`` 比較來選擇最大值。要執行分量級的最大值計算，請使用 :ref:`Vector2.max()<class_Vector2_method_max>`\ 、\ :ref:`Vector2i.max()<class_Vector2i_method_max>`\ 、\ :ref:`Vector3.max()<class_Vector3_method_max>`\ 、\ :ref:`Vector3i.max()<class_Vector3i_method_max>`\ 、\ :ref:`Vector4.max()<class_Vector4_method_max>` 和 :ref:`Vector4i.max()<class_Vector4i_method_max>`\ 。
.. rst-class:: classref-item-separator
----
.. _class_@GlobalScope_method_maxf:
.. rst-class:: classref-method
:ref:`float<class_float>` **maxf**\ (\ a\: :ref:`float<class_float>`, b\: :ref:`float<class_float>`\ ) :ref:`🔗<class_@GlobalScope_method_maxf>`
返回兩個 :ref:`float<class_float>` 值中的最大值。
::
maxf(3.6, 24) # 返回 24.0
maxf(-3.99, -4) # 返回 -3.99
.. rst-class:: classref-item-separator
----
.. _class_@GlobalScope_method_maxi:
.. rst-class:: classref-method
:ref:`int<class_int>` **maxi**\ (\ a\: :ref:`int<class_int>`, b\: :ref:`int<class_int>`\ ) :ref:`🔗<class_@GlobalScope_method_maxi>`
返回兩個 :ref:`int<class_int>` 值中的最大值。
::
maxi(1, 2) # 返回 2
maxi(-3, -4) # 返回 -3
.. rst-class:: classref-item-separator
----
.. _class_@GlobalScope_method_min:
.. rst-class:: classref-method
:ref:`Variant<class_Variant>` **min**\ (\ ...\ ) |vararg| :ref:`🔗<class_@GlobalScope_method_min>`
回傳所給多個數值中的最小值，參數個數不限。
::
min(1, 7, 3, -6, 5) # 回傳 -6
\ **注意：** 用於向量時並非逐分量比較，而是直接以 ``x < y`` 比較整體大小；若需逐分量最小值，請使用 :ref:`Vector2.min()<class_Vector2_method_min>`\ 、\ :ref:`Vector2i.min()<class_Vector2i_method_min>`\ 、\ :ref:`Vector3.min()<class_Vector3_method_min>`\ 、\ :ref:`Vector3i.min()<class_Vector3i_method_min>`\ 、\ :ref:`Vector4.min()<class_Vector4_method_min>` 或 :ref:`Vector4i.min()<class_Vector4i_method_min>`\ 。
.. rst-class:: classref-item-separator
----
.. _class_@GlobalScope_method_minf:
.. rst-class:: classref-method
:ref:`float<class_float>` **minf**\ (\ a\: :ref:`float<class_float>`, b\: :ref:`float<class_float>`\ ) :ref:`🔗<class_@GlobalScope_method_minf>`
返回兩個 :ref:`float<class_float>` 值中的最小值。
::
minf(3.6, 24) # 返回 3.6
minf(-3.99, -4) # 返回 -4.0
.. rst-class:: classref-item-separator
----
.. _class_@GlobalScope_method_mini:
.. rst-class:: classref-method
:ref:`int<class_int>` **mini**\ (\ a\: :ref:`int<class_int>`, b\: :ref:`int<class_int>`\ ) :ref:`🔗<class_@GlobalScope_method_mini>`
返回兩個 :ref:`int<class_int>` 值中的最小值。
::
mini(1, 2) # 返回 1
mini(-3, -4) # 返回 -4
.. rst-class:: classref-item-separator
----
.. _class_@GlobalScope_method_move_toward:
.. rst-class:: classref-method
:ref:`float<class_float>` **move_toward**\ (\ from\: :ref:`float<class_float>`, to\: :ref:`float<class_float>`, delta\: :ref:`float<class_float>`\ ) :ref:`🔗<class_@GlobalScope_method_move_toward>`
將 ``from`` 向 ``to`` 移動，移動的長度是 ``delta``\ 。不會超過 ``to``\ 。
使用負的 ``delta`` 值則向遠離的方向移動。
::
move_toward(5, 10, 4) # Returns 9
move_toward(10, 5, 4) # Returns 6
move_toward(5, 10, 9) # Returns 10
move_toward(10, 5, -1.5) # Returns 11.5
.. rst-class:: classref-item-separator
----
.. _class_@GlobalScope_method_nearest_po2:
.. rst-class:: classref-method
:ref:`int<class_int>` **nearest_po2**\ (\ value\: :ref:`int<class_int>`\ ) :ref:`🔗<class_@GlobalScope_method_nearest_po2>`
返回大於等於整數 ``value`` 的最小整數冪 2。
::
nearest_po2(3) # 返回 4
nearest_po2(4) # 返回 4
nearest_po2(5) # 返回 8
nearest_po2(0) # 返回 0（可能出乎意料）
nearest_po2(-1) # 返回 0（可能出乎意料）
\ **警告：**\ 由於其實現，此方法返回\ ``0``\ 而不是\ ``1``\ 對於小於或等於的值\ ``0``\ ，但 ``value`` 是最小的負 64 位整數除外 (``-9223372036854775808``\ ），在這種情況下，返回 ``value`` 不變。
.. rst-class:: classref-item-separator
----
.. _class_@GlobalScope_method_pingpong:
.. rst-class:: classref-method
:ref:`float<class_float>` **pingpong**\ (\ value\: :ref:`float<class_float>`, length\: :ref:`float<class_float>`\ ) :ref:`🔗<class_@GlobalScope_method_pingpong>`
將 ``value`` 包裹在 ``0`` 和 ``length`` 之間。如果達到限制，函式返回的下一個值將減少到 ``0`` 側或增加到 ``length`` 側（像三角波）。如果 ``length`` 小於零，則變為正數。
::
pingpong(-3.0, 3.0) # 返回 3.0
pingpong(-2.0, 3.0) # 返回 2.0
pingpong(-1.0, 3.0) # 返回 1.0
pingpong(0.0, 3.0) # 返回 0.0
pingpong(1.0, 3.0) # 返回 1.0
pingpong(2.0, 3.0) # 返回 2.0
pingpong(3.0, 3.0) # 返回 3.0
pingpong(4.0, 3.0) # 返回 2.0
pingpong(5.0, 3.0) # 返回 1.0
pingpong(6.0, 3.0) # 返回 0.0
.. rst-class:: classref-item-separator
----
.. _class_@GlobalScope_method_posmod:
.. rst-class:: classref-method
:ref:`int<class_int>` **posmod**\ (\ x\: :ref:`int<class_int>`, y\: :ref:`int<class_int>`\ ) :ref:`🔗<class_@GlobalScope_method_posmod>`
回傳 ``x`` ÷ ``y`` 的整數餘數，正負方向對稱包覆。
::
print("#(i) (i % 3) (posmod(i, 3))")
for i in range(-3, 4):
print("%2d %2d | %2d" % [i, i % 3, posmod(i, 3)])
輸出：
::
(i) (i % 3) (posmod(i, 3))
-3 0 | 0
-2 -2 | 1
-1 -1 | 2
0 0 | 0
1 1 | 1
2 2 | 2
3 0 | 0
.. rst-class:: classref-item-separator
----
.. _class_@GlobalScope_method_pow:
.. rst-class:: classref-method
:ref:`float<class_float>` **pow**\ (\ base\: :ref:`float<class_float>`, exp\: :ref:`float<class_float>`\ ) :ref:`🔗<class_@GlobalScope_method_pow>`
返回 ``base`` 的 ``exp`` 次冪的結果。
在 GDScript 中，這相當於 ``**`` 運算子。
::
pow(2, 5) # 返回 32.0
pow(4, 1.5) # 返回 8.0
.. rst-class:: classref-item-separator
----
.. _class_@GlobalScope_method_print:
.. rst-class:: classref-method
|void| **print**\ (\ ...\ ) |vararg| :ref:`🔗<class_@GlobalScope_method_print>`
將任意型別的參數最佳化轉為字串後輸出至主控台。
.. tabs::
.. code-tab:: gdscript
var a = [1, 2, 3]
print("a", "b", a) # 輸出 "ab[1, 2, 3]"
.. code-tab:: csharp
Godot.Collections.Array a = [1, 2, 3];
GD.Print("a", "b", a); // 輸出 "ab[1, 2, 3]"
\ **注意：** 建議使用 :ref:`push_error()<class_@GlobalScope_method_push_error>` 與 :ref:`push_warning()<class_@GlobalScope_method_push_warning>` 來輸出錯誤與警告訊息，以區分除錯列印，並在輸出時附帶堆疊追蹤。
另見 :ref:`Engine.print_to_stdout<class_Engine_property_print_to_stdout>` 與 :ref:`ProjectSettings.application/run/disable_stdout<class_ProjectSettings_property_application/run/disable_stdout>`\ 。
.. rst-class:: classref-item-separator
----
.. _class_@GlobalScope_method_print_rich:
.. rst-class:: classref-method
|void| **print_rich**\ (\ ...\ ) |vararg| :ref:`🔗<class_@GlobalScope_method_print_rich>`
將任意型別的參數最佳化轉為字串並以 BBCode 呈現後輸出至主控台。
支援的 BBCode 標籤： ``b``\ 、\ ``i``\ 、\ ``u``\ 、\ ``s``\ 、\ ``indent``\ 、\ ``code``\ 、\ ``url``\ 、\ ``center``\ 、\ ``right``\ 、\ ``color``\ 、\ ``bgcolor``\ 、\ ``fgcolor``\ 。
URL 標籤僅支援形如 ``[url]https://example.com[/url]`` 的格式。
輸出至標準輸出時，可支援的 BBCode 會轉為 ANSI 控制碼；實際效果依終端機模擬器而異（特別是斜體與刪除線）。\ ``code`` 會以淡色顯示但不改字型。
.. tabs::
.. code-tab:: gdscript
print_rich("[color=green][b]Hello world![/b][/color]") # 以綠色粗體輸出
.. code-tab:: csharp
GD.PrintRich("[color=green][b]Hello world![/b][/color]"); // 以綠色粗體輸出
\ **注意：** 建議使用 :ref:`push_error()<class_@GlobalScope_method_push_error>` 與 :ref:`push_warning()<class_@GlobalScope_method_push_warning>` 來輸出錯誤與警告訊息，以保留堆疊追蹤並區分除錯輸出。
\ **注意：** 編輯器輸出支援可點擊的 ``[url=網址]文字[/url]``\ ，點擊後會透過 :ref:`OS.shell_open()<class_OS_method_shell_open>` 開啟網址。
.. rst-class:: classref-item-separator
----
.. _class_@GlobalScope_method_print_verbose:
.. rst-class:: classref-method
|void| **print_verbose**\ (\ ...\ ) |vararg| :ref:`🔗<class_@GlobalScope_method_print_verbose>`
如果啟用了詳細模式（\ :ref:`OS.is_stdout_verbose()<class_OS_method_is_stdout_verbose>` 返回 ``true``\ ），則盡可能以最佳方式將一個或多個任意型別的參數轉換為字串，並將它們列印到控制台。
.. rst-class:: classref-item-separator
----
.. _class_@GlobalScope_method_printerr:
.. rst-class:: classref-method
|void| **printerr**\ (\ ...\ ) |vararg| :ref:`🔗<class_@GlobalScope_method_printerr>`
以盡可能最佳的方式將一個或多個參數作為字串輸出到標準錯誤行。
.. tabs::
.. code-tab:: gdscript
printerr("prints to stderr")
.. code-tab:: csharp
GD.PrintErr("prints to stderr");
.. rst-class:: classref-item-separator
----
.. _class_@GlobalScope_method_printraw:
.. rst-class:: classref-method
|void| **printraw**\ (\ ...\ ) |vararg| :ref:`🔗<class_@GlobalScope_method_printraw>`
將一個或多個參數以最佳方式轉為字串直接輸出到作業系統終端機。與 :ref:`print()<class_@GlobalScope_method_print>` 不同，結尾不會自動加換行符號。
\ **注意：**\ OS 終端機 *不是* 編輯器的輸出分頁，需從命令列啟動 Godot 才能看到，Windows 則需用 ``console.exe``\ 。
.. tabs::
.. code-tab:: gdscript
printraw("A")
printraw("B")
printraw("C")
# 輸出 "ABC" 至終端機
.. code-tab:: csharp
GD.PrintRaw("A");
GD.PrintRaw("B");
GD.PrintRaw("C");
// 輸出 "ABC" 至終端機
.. rst-class:: classref-item-separator
----
.. _class_@GlobalScope_method_prints:
.. rst-class:: classref-method
|void| **prints**\ (\ ...\ ) |vararg| :ref:`🔗<class_@GlobalScope_method_prints>`
將一個或多個參數輸出至主控台，參數間以空格分隔。
.. tabs::
.. code-tab:: gdscript
prints("A", "B", "C") # 輸出 "A B C"
.. code-tab:: csharp
GD.PrintS("A", "B", "C"); // 輸出 "A B C"
.. rst-class:: classref-item-separator
----
.. _class_@GlobalScope_method_printt:
.. rst-class:: classref-method
|void| **printt**\ (\ ...\ ) |vararg| :ref:`🔗<class_@GlobalScope_method_printt>`
將一個或多個參數輸出至主控台，參數間以定位字元（Tab）分隔。
.. tabs::
.. code-tab:: gdscript
printt("A", "B", "C") # 輸出 "A B C"
.. code-tab:: csharp
GD.PrintT("A", "B", "C"); // 輸出 "A B C"
.. rst-class:: classref-item-separator
----
.. _class_@GlobalScope_method_push_error:
.. rst-class:: classref-method
|void| **push_error**\ (\ ...\ ) |vararg| :ref:`🔗<class_@GlobalScope_method_push_error>`
將錯誤訊息推送至 Godot 內建除錯器並同時輸出至作業系統終端機。
.. tabs::
.. code-tab:: gdscript
push_error("test error") # 以錯誤形式輸出 "test error"
.. code-tab:: csharp
GD.PushError("test error"); // 以錯誤形式輸出 "test error"
\ **注意：** 此函式不會暫停專案執行。若需在除錯組建時同時停下執行，請改用 ``assert(false, "test error")``\ 。
.. rst-class:: classref-item-separator
----
.. _class_@GlobalScope_method_push_warning:
.. rst-class:: classref-method
|void| **push_warning**\ (\ ...\ ) |vararg| :ref:`🔗<class_@GlobalScope_method_push_warning>`
將警告訊息推送至 Godot 內建除錯器並同時輸出至作業系統終端機。
.. tabs::
.. code-tab:: gdscript
push_warning("test warning") # 以警告形式輸出 "test warning"
.. code-tab:: csharp
GD.PushWarning("test warning"); // 以警告形式輸出 "test warning"
.. rst-class:: classref-item-separator
----
.. _class_@GlobalScope_method_rad_to_deg:
.. rst-class:: classref-method
:ref:`float<class_float>` **rad_to_deg**\ (\ rad\: :ref:`float<class_float>`\ ) :ref:`🔗<class_@GlobalScope_method_rad_to_deg>`
將以弧度表示的角度轉換為度。
::
rad_to_deg(0.523599) # 返回 30
rad_to_deg(PI) # 返回 180
rad_to_deg(PI * 2) # 返回 360
.. rst-class:: classref-item-separator
----
.. _class_@GlobalScope_method_rand_from_seed:
.. rst-class:: classref-method
:ref:`PackedInt64Array<class_PackedInt64Array>` **rand_from_seed**\ (\ seed\: :ref:`int<class_int>`\ ) :ref:`🔗<class_@GlobalScope_method_rand_from_seed>`
給定 ``seed``\ ，回傳一個長度為 ``2`` 的 :ref:`PackedInt64Array<class_PackedInt64Array>`\ 。
第一個元素為隨機化後的 :ref:`int<class_int>` 值，第二個元素與傳入的 ``seed`` 相同。
相同的 ``seed`` 會穩定回傳相同陣列。
\ **注意：** 這裡的「種子」指偽亂數產生器的內部 64 位元整數狀態。
::
var a = rand_from_seed(4)
print(a[0]) # 輸出 2879024997
print(a[1]) # 輸出 4
.. rst-class:: classref-item-separator
----
.. _class_@GlobalScope_method_randf:
.. rst-class:: classref-method
:ref:`float<class_float>` **randf**\ (\ ) :ref:`🔗<class_@GlobalScope_method_randf>`
回傳一個介於 ``0.0`` 與 ``1.0``\ （含）之間的隨機浮點數。
.. tabs::
.. code-tab:: gdscript
randf() # 例如回傳 0.375671
.. code-tab:: csharp
GD.Randf(); // 例如回傳 0.375671
.. rst-class:: classref-item-separator
----
.. _class_@GlobalScope_method_randf_range:
.. rst-class:: classref-method
:ref:`float<class_float>` **randf_range**\ (\ from\: :ref:`float<class_float>`, to\: :ref:`float<class_float>`\ ) :ref:`🔗<class_@GlobalScope_method_randf_range>`
回傳位於 ``from`` 與 ``to``\ （含）之間的隨機浮點數。
.. tabs::
.. code-tab:: gdscript
randf_range(0, 20.5) # 例如回傳 7.45315
randf_range(-10, 10) # 例如回傳 -3.844535
.. code-tab:: csharp
GD.RandRange(0.0, 20.5); // 例如回傳 7.45315
GD.RandRange(-10.0, 10.0); // 例如回傳 -3.844535
.. rst-class:: classref-item-separator
----
.. _class_@GlobalScope_method_randfn:
.. rst-class:: classref-method
:ref:`float<class_float>` **randfn**\ (\ mean\: :ref:`float<class_float>`, deviation\: :ref:`float<class_float>`\ ) :ref:`🔗<class_@GlobalScope_method_randfn>`
從指定的 ``mean`` 與標準 ``deviation`` 產生一個\ `常態分布 <https://en.wikipedia.org/wiki/Normal_distribution>`__\ 、偽隨機的浮點數值。這也被稱為高斯分布。
\ **注意：** 此方法使用 `Box-Muller 轉換 <https://en.wikipedia.org/wiki/Box%E2%80%93Muller_transform>`__ 演算法。
.. rst-class:: classref-item-separator
----
.. _class_@GlobalScope_method_randi:
.. rst-class:: classref-method
:ref:`int<class_int>` **randi**\ (\ ) :ref:`🔗<class_@GlobalScope_method_randi>`
返回一個隨機的無符號 32 位元整數。使用餘數獲得區間 ``[0, N - 1]`` （其中 N 小於 2^32）的隨機值。
.. tabs::
.. code-tab:: gdscript
randi() # 返回介於 0 到 2^32 - 1 之間的隨機整數
randi() % 20 # 返回介於 0 到 19之間的隨機整數
randi() % 100 # 返回介於 0 到 99 之間的隨機整數
randi() % 100 + 1 # 返回介於 1 到 100 之間的隨機整數
.. code-tab:: csharp
GD.Randi(); // 返回介於 0 到 2^32 - 1 之間的隨機整數
GD.Randi() % 20; // 返回介於 0 到 19之間的隨機整數
GD.Randi() % 100; // 返回介於 0 到 99 之間的隨機整數
GD.Randi() % 100 + 1; // 返回介於 1 到 100 之間的隨機整數
.. rst-class:: classref-item-separator
----
.. _class_@GlobalScope_method_randi_range:
.. rst-class:: classref-method
:ref:`int<class_int>` **randi_range**\ (\ from\: :ref:`int<class_int>`, to\: :ref:`int<class_int>`\ ) :ref:`🔗<class_@GlobalScope_method_randi_range>`
返回介於 ``from`` 和 ``to``\ （包含）之間的一個隨機有符號 32 位元整數。如果 ``to`` 小於 ``from``\ ，則它們將被交換。
.. tabs::
.. code-tab:: gdscript
randi_range(0, 1) # 返回 0 或 1
randi_range(-10, 1000) # 返回介於 -10 和 1000 之間的隨機整數
.. code-tab:: csharp
GD.RandRange(0, 1); // 返回 0 或 1
GD.RandRange(-10, 1000); // 返回介於 -10 和 1000 之間的隨機整數
.. rst-class:: classref-item-separator
----
.. _class_@GlobalScope_method_randomize:
.. rst-class:: classref-method
|void| **randomize**\ (\ ) :ref:`🔗<class_@GlobalScope_method_randomize>`
隨機化亂數產生器的種子（或內部狀態）。目前的實作使用一個基於裝置時間的數字。
\ **注意：**\ 該函式在專案運作時自動被呼叫。如果需要修復種子以獲得一致、可重現的結果，請使用 :ref:`seed()<class_@GlobalScope_method_seed>` 來初始化亂數產生器。
.. rst-class:: classref-item-separator
----
.. _class_@GlobalScope_method_remap:
.. rst-class:: classref-method
:ref:`float<class_float>` **remap**\ (\ value\: :ref:`float<class_float>`, istart\: :ref:`float<class_float>`, istop\: :ref:`float<class_float>`, ostart\: :ref:`float<class_float>`, ostop\: :ref:`float<class_float>`\ ) :ref:`🔗<class_@GlobalScope_method_remap>`
將 ``value`` 從區間 ``[istart, istop]`` 映射到 ``[ostart, ostop]``\ 。另請參閱 :ref:`lerp()<class_@GlobalScope_method_lerp>` 與 :ref:`inverse_lerp()<class_@GlobalScope_method_inverse_lerp>`\ 。如果 ``value`` 超出 ``[istart, istop]``\ ，則結果也會超出 ``[ostart, ostop]``\ 。若不希望發生這種情況，請對此函式的結果使用 :ref:`clamp()<class_@GlobalScope_method_clamp>`\ 。
::
remap(75, 0, 100, -1, 1) # 回傳 0.5
若需多個區間的複雜應用，建議改用 :ref:`Curve<class_Curve>` 或 :ref:`Gradient<class_Gradient>`\ 。
\ **注意：** 若 ``istart == istop``\ ，回傳值會是未定義（很可能為 NaN、INF 或 -INF）。
.. rst-class:: classref-item-separator
----
.. _class_@GlobalScope_method_rid_allocate_id:
.. rst-class:: classref-method
:ref:`int<class_int>` **rid_allocate_id**\ (\ ) :ref:`🔗<class_@GlobalScope_method_rid_allocate_id>`
分配一個唯一 ID 以供實作端組成 RID；主要供原生擴充用於實作伺服器。
.. rst-class:: classref-item-separator
----
.. _class_@GlobalScope_method_rid_from_int64:
.. rst-class:: classref-method
:ref:`RID<class_RID>` **rid_from_int64**\ (\ base\: :ref:`int<class_int>`\ ) :ref:`🔗<class_@GlobalScope_method_rid_from_int64>`
依 ``base`` 建立 RID；主要供原生擴充用於建構伺服器。
.. rst-class:: classref-item-separator
----
.. _class_@GlobalScope_method_rotate_toward:
.. rst-class:: classref-method
:ref:`float<class_float>` **rotate_toward**\ (\ from\: :ref:`float<class_float>`, to\: :ref:`float<class_float>`, delta\: :ref:`float<class_float>`\ ) :ref:`🔗<class_@GlobalScope_method_rotate_toward>`
將 ``from`` 向 ``to`` 旋轉 ``delta`` 量。不會超過 ``to``\ 。
與 :ref:`move_toward()<class_@GlobalScope_method_move_toward>` 類似，但當角環繞 :ref:`@GDScript.TAU<class_@GDScript_constant_TAU>` 時正確內插。
如果 ``delta`` 為負數，則此函式將從 ``to`` 旋轉到相反的角度，並且不會超過相反的角度。
.. rst-class:: classref-item-separator
----
.. _class_@GlobalScope_method_round:
.. rst-class:: classref-method
:ref:`Variant<class_Variant>` **round**\ (\ x\: :ref:`Variant<class_Variant>`\ ) :ref:`🔗<class_@GlobalScope_method_round>`
將 ``x`` 四捨五入至最接近整數，0.5 以上朝遠離 0 方向取整。
支援型別： :ref:`int<class_int>`\ 、\ :ref:`float<class_float>`\ 、\ :ref:`Vector2<class_Vector2>`\ 、\ :ref:`Vector2i<class_Vector2i>`\ 、\ :ref:`Vector3<class_Vector3>`\ 、\ :ref:`Vector3i<class_Vector3i>`\ 、\ :ref:`Vector4<class_Vector4>`\ 、\ :ref:`Vector4i<class_Vector4i>`\ 。
::
round(2.4) # 回傳 2
round(2.5) # 回傳 3
round(2.6) # 回傳 3
另見 :ref:`floor()<class_@GlobalScope_method_floor>`\ 、\ :ref:`ceil()<class_@GlobalScope_method_ceil>` 與 :ref:`snapped()<class_@GlobalScope_method_snapped>`\ 。
\ **注意：** 為確保型別安全，請使用 :ref:`roundf()<class_@GlobalScope_method_roundf>`\ 、\ :ref:`roundi()<class_@GlobalScope_method_roundi>`\ 、\ :ref:`Vector2.round()<class_Vector2_method_round>`\ 、\ :ref:`Vector3.round()<class_Vector3_method_round>` 或 :ref:`Vector4.round()<class_Vector4_method_round>`\ 。
.. rst-class:: classref-item-separator
----
.. _class_@GlobalScope_method_roundf:
.. rst-class:: classref-method
:ref:`float<class_float>` **roundf**\ (\ x\: :ref:`float<class_float>`\ ) :ref:`🔗<class_@GlobalScope_method_roundf>`
將 ``x`` 四捨五入到最接近的整數，中間情況遠離 0 四捨五入。
\ :ref:`round()<class_@GlobalScope_method_round>` 的型別安全版本，返回一個 :ref:`float<class_float>`\ 。
.. rst-class:: classref-item-separator
----
.. _class_@GlobalScope_method_roundi:
.. rst-class:: classref-method
:ref:`int<class_int>` **roundi**\ (\ x\: :ref:`float<class_float>`\ ) :ref:`🔗<class_@GlobalScope_method_roundi>`
將 ``x`` 四捨五入到最接近的整數，中間情況遠離 0 四捨五入。
\ :ref:`round()<class_@GlobalScope_method_round>` 的型別安全版本，返回一個 :ref:`int<class_int>`\ 。
.. rst-class:: classref-item-separator
----
.. _class_@GlobalScope_method_seed:
.. rst-class:: classref-method
|void| **seed**\ (\ base\: :ref:`int<class_int>`\ ) :ref:`🔗<class_@GlobalScope_method_seed>`
將亂數產生器的種子設定為 ``base``\ 。手動設定種子可以確保大多數隨機函式的結果一致、可重複。
.. tabs::
.. code-tab:: gdscript
var my_seed = "Godot Rocks".hash()
seed(my_seed)
var a = randf() + randi()
seed(my_seed)
var b = randf() + randi()
# a 和 b 現在是一樣的
.. code-tab:: csharp
ulong mySeed = (ulong)GD.Hash("Godot Rocks");
GD.Seed(mySeed);
var a = GD.Randf() + GD.Randi();
GD.Seed(mySeed);
var b = GD.Randf() + GD.Randi();
// a 和 b 現在是一樣的
.. rst-class:: classref-item-separator
----
.. _class_@GlobalScope_method_sign:
.. rst-class:: classref-method
:ref:`Variant<class_Variant>` **sign**\ (\ x\: :ref:`Variant<class_Variant>`\ ) :ref:`🔗<class_@GlobalScope_method_sign>`
回傳與 ``x`` 相同型別的 :ref:`Variant<class_Variant>`\ ；負值為 ``-1``\ ，正值為 ``1``\ ，零為 ``0``\ ，遇 ``nan`` 則回傳 0。
支援型別：\ :ref:`int<class_int>`\ 、\ :ref:`float<class_float>`\ 、\ :ref:`Vector2<class_Vector2>`\ 、\ :ref:`Vector2i<class_Vector2i>`\ 、\ :ref:`Vector3<class_Vector3>`\ 、\ :ref:`Vector3i<class_Vector3i>`\ 、\ :ref:`Vector4<class_Vector4>`\ 、\ :ref:`Vector4i<class_Vector4i>`\ 。
::
sign(-6.0) # 返回 -1
sign(0.0) # 返回 0
sign(6.0) # 返回 1
sign(NAN) # 返回 0
sign(Vector3(-6.0, 0.0, 6.0)) # 返回 (-1, 0, 1)
\ **注意：**\ 為提升型別安全性，請使用 :ref:`signf()<class_@GlobalScope_method_signf>`\ 、\ :ref:`signi()<class_@GlobalScope_method_signi>`\ 、\ :ref:`Vector2.sign()<class_Vector2_method_sign>`\ 、\ :ref:`Vector2i.sign()<class_Vector2i_method_sign>`\ 、\ :ref:`Vector3.sign()<class_Vector3_method_sign>`\ 、\ :ref:`Vector3i.sign()<class_Vector3i_method_sign>`\ 、\ :ref:`Vector4.sign()<class_Vector4_method_sign>` 或 :ref:`Vector4i.sign()<class_Vector4i_method_sign>`\ 。
.. rst-class:: classref-item-separator
----
.. _class_@GlobalScope_method_signf:
.. rst-class:: classref-method
:ref:`float<class_float>` **signf**\ (\ x\: :ref:`float<class_float>`\ ) :ref:`🔗<class_@GlobalScope_method_signf>`
若 ``x`` 為負則回傳 ``-1.0``\ ，為正則回傳 ``1.0``\ ，為零則回傳 ``0.0``\ ，遇 ``nan`` 則回傳 0.0。
::
signf(-6.5) # 返回 -1.0
signf(0.0) # 返回 0.0
signf(6.5) # 返回 1.0
signf(NAN) # 返回 0.0
.. rst-class:: classref-item-separator
----
.. _class_@GlobalScope_method_signi:
.. rst-class:: classref-method
:ref:`int<class_int>` **signi**\ (\ x\: :ref:`int<class_int>`\ ) :ref:`🔗<class_@GlobalScope_method_signi>`
若 ``x`` 為負則回傳 ``-1``\ ；為正則回傳 ``1``\ ；為 0 則回傳 ``0``\ 。
::
signi(-6) # 回傳 -1
signi(0) # 回傳 0
signi(6) # 回傳 1
.. rst-class:: classref-item-separator
----
.. _class_@GlobalScope_method_sin:
.. rst-class:: classref-method
:ref:`float<class_float>` **sin**\ (\ angle_rad\: :ref:`float<class_float>`\ ) :ref:`🔗<class_@GlobalScope_method_sin>`
返回弧度角 ``angle_rad`` 的正弦值。
::
sin(0.523599) # 返回 0.5
sin(deg_to_rad(90)) # 返回 1.0
.. rst-class:: classref-item-separator
----
.. _class_@GlobalScope_method_sinh:
.. rst-class:: classref-method
:ref:`float<class_float>` **sinh**\ (\ x\: :ref:`float<class_float>`\ ) :ref:`🔗<class_@GlobalScope_method_sinh>`
返回 ``x`` 的雙曲正弦值。
::
var a = log(2.0) # 返回 0.693147
sinh(a) # 返回 0.75
.. rst-class:: classref-item-separator
----
.. _class_@GlobalScope_method_smoothstep:
.. rst-class:: classref-method
:ref:`float<class_float>` **smoothstep**\ (\ from\: :ref:`float<class_float>`, to\: :ref:`float<class_float>`, x\: :ref:`float<class_float>`\ ) :ref:`🔗<class_@GlobalScope_method_smoothstep>`
回傳 ``0`` 與 ``1`` 之間的平滑三次 Hermite 插值。
若為正向區間（\ ``from <= to``\ ），當 ``x <= from`` 時回傳 ``0``\ ，當 ``x >= to`` 時回傳 ``1``\ 。若 ``x`` 介於 ``from`` 與 ``to`` 之間，則回傳值會依 S 形曲線平滑地由 ``0`` 過渡至 ``1``\ 。
若為反向區間（\ ``from > to``\ ），則函式行為會鏡像：當 ``x <= to`` 時回傳 ``1``\ ，當 ``x >= from`` 時回傳 ``0``\ 。
這個 S 形曲線即為三次 Hermite 補間器，其公式為 ``f(y) = 3*y^2 - 2*y^3``\ ，其中 ``y = (x-from) / (to-from)``\ 。
::
smoothstep(0, 2, -5.0) # 回傳 0.0
smoothstep(0, 2, 0.5) # 回傳 0.15625
smoothstep(0, 2, 1.0) # 回傳 0.5
smoothstep(0, 2, 2.0) # 回傳 1.0
與 :ref:`ease()<class_@GlobalScope_method_ease>` 並給定曲線值 ``-1.6521`` 相比，\ :ref:`smoothstep()<class_@GlobalScope_method_smoothstep>` 回傳的曲線最為平順，且導數不會有突變。若需要更進階的過渡，請使用 :ref:`Tween<class_Tween>` 或 :ref:`AnimationPlayer<class_AnimationPlayer>`\ 。
\ `smoothstep() 與 ease(x, -1.6521) 回傳值比較 <https://raw.githubusercontent.com/godotengine/godot-docs/master/img/smoothstep_ease_comparison.png>`__\
\ `smoothstep() 在正、零、負區間的回傳值 <https://raw.githubusercontent.com/godotengine/godot-docs/master/img/smoothstep_range.webp>`__
.. rst-class:: classref-item-separator
----
.. _class_@GlobalScope_method_snapped:
.. rst-class:: classref-method
:ref:`Variant<class_Variant>` **snapped**\ (\ x\: :ref:`Variant<class_Variant>`, step\: :ref:`Variant<class_Variant>`\ ) :ref:`🔗<class_@GlobalScope_method_snapped>`
回傳最接近 ``x`` 的 ``step`` 倍數，可用於將浮點數取至任意小數位。
回傳值型別與 ``step`` 相同。支援型別： :ref:`int<class_int>`\ 、\ :ref:`float<class_float>`\ 、\ :ref:`Vector2<class_Vector2>`\ 、\ :ref:`Vector2i<class_Vector2i>`\ 、\ :ref:`Vector3<class_Vector3>`\ 、\ :ref:`Vector3i<class_Vector3i>`\ 、\ :ref:`Vector4<class_Vector4>`\ 、\ :ref:`Vector4i<class_Vector4i>`\ 。
::
snapped(100, 32) # 回傳 96
snapped(3.14159, 0.01) # 回傳 3.14
snapped(Vector2(34, 70), Vector2(8, 8)) # 回傳 (32, 72)
另見 :ref:`ceil()<class_@GlobalScope_method_ceil>`\ 、\ :ref:`floor()<class_@GlobalScope_method_floor>` 與 :ref:`round()<class_@GlobalScope_method_round>`\ 。
\ **注意：** 如需型別安全版本，請使用 :ref:`snappedf()<class_@GlobalScope_method_snappedf>`\ 、\ :ref:`snappedi()<class_@GlobalScope_method_snappedi>`\ 、\ :ref:`Vector2.snapped()<class_Vector2_method_snapped>`\ 、\ :ref:`Vector2i.snapped()<class_Vector2i_method_snapped>`\ 、\ :ref:`Vector3.snapped()<class_Vector3_method_snapped>`\ 、\ :ref:`Vector3i.snapped()<class_Vector3i_method_snapped>`\ 、\ :ref:`Vector4.snapped()<class_Vector4_method_snapped>` 或 :ref:`Vector4i.snapped()<class_Vector4i_method_snapped>`\ 。
.. rst-class:: classref-item-separator
----
.. _class_@GlobalScope_method_snappedf:
.. rst-class:: classref-method
:ref:`float<class_float>` **snappedf**\ (\ x\: :ref:`float<class_float>`, step\: :ref:`float<class_float>`\ ) :ref:`🔗<class_@GlobalScope_method_snappedf>`
回傳最接近 ``x`` 的 ``step`` 倍數，可用於將浮點數取至任意小數位。
此為型別安全版本，回傳 :ref:`float<class_float>`\ 。
::
snappedf(32.0, 2.5) # 回傳 32.5
snappedf(3.14159, 0.01) # 回傳 3.14
.. rst-class:: classref-item-separator
----
.. _class_@GlobalScope_method_snappedi:
.. rst-class:: classref-method
:ref:`int<class_int>` **snappedi**\ (\ x\: :ref:`float<class_float>`, step\: :ref:`int<class_int>`\ ) :ref:`🔗<class_@GlobalScope_method_snappedi>`
返回最接近 ``x`` 的 ``step`` 的倍數。
\ :ref:`snapped()<class_@GlobalScope_method_snapped>` 的型別安全版本，返回一個 :ref:`int<class_int>`\ 。
::
snappedi(53, 16) # 返回 48
snappedi(4096, 100) # 返回 4100
.. rst-class:: classref-item-separator
----
.. _class_@GlobalScope_method_sqrt:
.. rst-class:: classref-method
:ref:`float<class_float>` **sqrt**\ (\ x\: :ref:`float<class_float>`\ ) :ref:`🔗<class_@GlobalScope_method_sqrt>`
回傳 ``x`` 的平方根，其中 ``x`` 為非負數。
::
sqrt(9) # 回傳 3
sqrt(10.24) # 回傳 3.2
sqrt(-1) # 回傳 NaN
\ **注意：** 若 ``x`` 為負則回傳 NaN（非數字）。在 C# 中如需處理負值，請使用 ``System.Numerics.Complex``\ 。
.. rst-class:: classref-item-separator
----
.. _class_@GlobalScope_method_step_decimals:
.. rst-class:: classref-method
:ref:`int<class_int>` **step_decimals**\ (\ x\: :ref:`float<class_float>`\ ) :ref:`🔗<class_@GlobalScope_method_step_decimals>`
返回小數點後第一個非零數字的位置。注意最大返回值是 10，這是實作中的設計決定。
::
var n = step_decimals(5) # n 為 0
n = step_decimals(1.0005) # n 為 4
n = step_decimals(0.000000005) # n 為 9
.. rst-class:: classref-item-separator
----
.. _class_@GlobalScope_method_str:
.. rst-class:: classref-method
:ref:`String<class_String>` **str**\ (\ ...\ ) |vararg| :ref:`🔗<class_@GlobalScope_method_str>`
盡可能以最佳方式將一個或多個任何 :ref:`Variant<class_Variant>` 型別的參數轉換為一個 :ref:`String<class_String>`\ 。
::
var a = [10, 20, 30]
var b = str(a)
print(len(a)) # 輸出 3（陣列中元素的數量）。
print(len(b)) # 輸出 12（字串“[10, 20, 30]”的長度）。
.. rst-class:: classref-item-separator
----
.. _class_@GlobalScope_method_str_to_var:
.. rst-class:: classref-method
:ref:`Variant<class_Variant>` **str_to_var**\ (\ string\: :ref:`String<class_String>`\ ) :ref:`🔗<class_@GlobalScope_method_str_to_var>`
將 :ref:`var_to_str()<class_@GlobalScope_method_var_to_str>` 返回的已格式化的 ``string`` 轉換為原始 :ref:`Variant<class_Variant>`\ 。
.. tabs::
.. code-tab:: gdscript
var data = '{ "a": 1, "b": 2 }' # data 是一個 String
var dict = str_to_var(data) # dict 是一個 Dictionary
print(dict["a"]) # 輸出 1
.. code-tab:: csharp
string data = "{ \"a\": 1, \"b\": 2 }"; // data 是一個 string
var dict = GD.StrToVar(data).AsGodotDictionary(); // dict 是一個 Dictionary
GD.Print(dict["a"]); // 輸出 1
.. rst-class:: classref-item-separator
----
.. _class_@GlobalScope_method_tan:
.. rst-class:: classref-method
:ref:`float<class_float>` **tan**\ (\ angle_rad\: :ref:`float<class_float>`\ ) :ref:`🔗<class_@GlobalScope_method_tan>`
返回弧度角 ``angle_rad`` 的正切值。
::
tan(deg_to_rad(45)) # 返回 1
.. rst-class:: classref-item-separator
----
.. _class_@GlobalScope_method_tanh:
.. rst-class:: classref-method
:ref:`float<class_float>` **tanh**\ (\ x\: :ref:`float<class_float>`\ ) :ref:`🔗<class_@GlobalScope_method_tanh>`
返回 ``x`` 的雙曲正切值。
::
var a = log(2.0) # 返回 0.693147
tanh(a) # 返回 0.6
.. rst-class:: classref-item-separator
----
.. _class_@GlobalScope_method_type_convert:
.. rst-class:: classref-method
:ref:`Variant<class_Variant>` **type_convert**\ (\ variant\: :ref:`Variant<class_Variant>`, type\: :ref:`int<class_int>`\ ) :ref:`🔗<class_@GlobalScope_method_type_convert>`
將給定的 ``variant`` 以 :ref:`Variant.Type<enum_@GlobalScope_Variant.Type>` 轉為指定 ``type``\ 。本函式支援多型態自動轉換，如陣列型態間轉換、數字字串轉整數、多數型態轉字串等。
若無法轉型則回傳該型別預設值，例如 :ref:`Rect2<class_Rect2>` 轉 :ref:`Vector2<class_Vector2>` 永遠回傳 :ref:`Vector2.ZERO<class_Vector2_constant_ZERO>`\ 。只要 ``type`` 屬於有效 Variant 型態，不會產生錯誤訊息。
回傳值為 :ref:`Variant<class_Variant>`\ ，但內部資料型態等同你指定的目標型態。
::
type_convert("Hi!", TYPE_INT) # 返回 0
type_convert("123", TYPE_INT) # 返回 123
type_convert(123.4, TYPE_INT) # 返回 123
type_convert(5, TYPE_VECTOR2) # 返回 (0, 0)
type_convert("Hi!", TYPE_NIL) # 返回 null
.. rst-class:: classref-item-separator
----
.. _class_@GlobalScope_method_type_string:
.. rst-class:: classref-method
:ref:`String<class_String>` **type_string**\ (\ type\: :ref:`int<class_int>`\ ) :ref:`🔗<class_@GlobalScope_method_type_string>`
依 :ref:`Variant.Type<enum_@GlobalScope_Variant.Type>` 取得 ``type`` 的易讀名稱。
::
print(TYPE_INT) # 輸出 2
print(type_string(TYPE_INT)) # 輸出 "int"
print(type_string(TYPE_STRING)) # 輸出 "String"
另見 :ref:`typeof()<class_@GlobalScope_method_typeof>`\ 。
.. rst-class:: classref-item-separator
----
.. _class_@GlobalScope_method_typeof:
.. rst-class:: classref-method
:ref:`int<class_int>` **typeof**\ (\ variable\: :ref:`Variant<class_Variant>`\ ) :ref:`🔗<class_@GlobalScope_method_typeof>`
Returns the internal type of the given ``variable``, using the :ref:`Variant.Type<enum_@GlobalScope_Variant.Type>` values.
::
var json = JSON.new()
json.parse('["a", "b", "c"]')
var result = json.get_data()
if typeof(result) == TYPE_ARRAY:
print(result[0]) # Prints "a"
else:
print("Unexpected result!")
See also :ref:`type_string()<class_@GlobalScope_method_type_string>`.
.. rst-class:: classref-item-separator
----
.. _class_@GlobalScope_method_var_to_bytes:
.. rst-class:: classref-method
:ref:`PackedByteArray<class_PackedByteArray>` **var_to_bytes**\ (\ variable\: :ref:`Variant<class_Variant>`\ ) :ref:`🔗<class_@GlobalScope_method_var_to_bytes>`
將 :ref:`Variant<class_Variant>` 值編碼為位元組陣列，不包含物件。反序列化請用 :ref:`bytes_to_var()<class_@GlobalScope_method_bytes_to_var>`\ 。
\ **注意：**\ 如需物件序列化，請參見 :ref:`var_to_bytes_with_objects()<class_@GlobalScope_method_var_to_bytes_with_objects>`\ 。
\ **注意：**\ 不支援 :ref:`Callable<class_Callable>` 編碼，無論資料內容如何都會產生空值。
.. rst-class:: classref-item-separator
----
.. _class_@GlobalScope_method_var_to_bytes_with_objects:
.. rst-class:: classref-method
:ref:`PackedByteArray<class_PackedByteArray>` **var_to_bytes_with_objects**\ (\ variable\: :ref:`Variant<class_Variant>`\ ) :ref:`🔗<class_@GlobalScope_method_var_to_bytes_with_objects>`
將 :ref:`Variant<class_Variant>` 值編碼為位元組陣列，允許編碼物件（可能包含可執行程式碼）。反序列化請用 :ref:`bytes_to_var_with_objects()<class_@GlobalScope_method_bytes_to_var_with_objects>`\ 。
\ **注意：**\ 不支援 :ref:`Callable<class_Callable>` 編碼，無論資料內容如何都會產生空值。
.. rst-class:: classref-item-separator
----
.. _class_@GlobalScope_method_var_to_str:
.. rst-class:: classref-method
:ref:`String<class_String>` **var_to_str**\ (\ variable\: :ref:`Variant<class_Variant>`\ ) :ref:`🔗<class_@GlobalScope_method_var_to_str>`
將 :ref:`Variant<class_Variant>` 變數 ``variable`` 轉為可由 :ref:`str_to_var()<class_@GlobalScope_method_str_to_var>` 解析的格式化 :ref:`String<class_String>`\ 。
.. tabs::
.. code-tab:: gdscript
var a = { "a": 1, "b": 2 }
print(var_to_str(a))
.. code-tab:: csharp
var a = new Godot.Collections.Dictionary { ["a"] = 1, ["b"] = 2 };
GD.Print(GD.VarToStr(a));
輸出：
::
{
"a": 1,
"b": 2
}
\ **注意：** 不支援轉換 :ref:`Signal<class_Signal>` 與 :ref:`Callable<class_Callable>`\ ；此兩類型即使有資料也會被轉為空值。
.. rst-class:: classref-item-separator
----
.. _class_@GlobalScope_method_weakref:
.. rst-class:: classref-method
:ref:`Variant<class_Variant>` **weakref**\ (\ obj\: :ref:`Variant<class_Variant>`\ ) :ref:`🔗<class_@GlobalScope_method_weakref>`
回傳一個 :ref:`WeakRef<class_WeakRef>` 實例，持有對 ``obj`` 的弱參考。若 ``obj`` 為 ``null``\ ，則回傳空的 :ref:`WeakRef<class_WeakRef>` 實例。若 ``obj`` 既不是 :ref:`Object<class_Object>` 派生，也不是 ``null``\ ，則會列印錯誤並回傳 ``null``\ 。
弱參考無法確保物件存活：當只剩下弱參考時，垃圾回收器可以隨時銷毀該物件並釋放記憶體。然而，只要物件尚未被銷毀，即使已經沒有強參考，弱參考仍然可能取得該物件。
.. rst-class:: classref-item-separator
----
.. _class_@GlobalScope_method_wrap:
.. rst-class:: classref-method
:ref:`Variant<class_Variant>` **wrap**\ (\ value\: :ref:`Variant<class_Variant>`, min\: :ref:`Variant<class_Variant>`, max\: :ref:`Variant<class_Variant>`\ ) :ref:`🔗<class_@GlobalScope_method_wrap>`
Wraps the :ref:`Variant<class_Variant>` ``value`` between ``min`` and ``max``. ``min`` is *inclusive* while ``max`` is *exclusive*. This can be used for creating loop-like behavior or infinite surfaces.
Variant types :ref:`int<class_int>` and :ref:`float<class_float>` are supported. If any of the arguments is :ref:`float<class_float>`, this function returns a :ref:`float<class_float>`, otherwise it returns an :ref:`int<class_int>`.
::
var a = wrap(4, 5, 10)
# a is 9 (int)
var a = wrap(7, 5, 10)
# a is 7 (int)
var a = wrap(10.5, 5, 10)
# a is 5.5 (float)
.. rst-class:: classref-item-separator
----
.. _class_@GlobalScope_method_wrapf:
.. rst-class:: classref-method
:ref:`float<class_float>` **wrapf**\ (\ value\: :ref:`float<class_float>`, min\: :ref:`float<class_float>`, max\: :ref:`float<class_float>`\ ) :ref:`🔗<class_@GlobalScope_method_wrapf>`
Wraps the float ``value`` between ``min`` and ``max``. ``min`` is *inclusive* while ``max`` is *exclusive*. This can be used for creating loop-like behavior or infinite surfaces.
::
# Infinite loop between 5.0 and 9.9
value = wrapf(value + 0.1, 5.0, 10.0)
::
# Infinite rotation (in radians)
angle = wrapf(angle + 0.1, 0.0, TAU)
::
# Infinite rotation (in radians)
angle = wrapf(angle + 0.1, -PI, PI)
\ **Note:** If ``min`` is ``0``, this is equivalent to :ref:`fposmod()<class_@GlobalScope_method_fposmod>`, so prefer using that instead. :ref:`wrapf()<class_@GlobalScope_method_wrapf>` is more flexible than using the :ref:`fposmod()<class_@GlobalScope_method_fposmod>` approach by giving the user control over the minimum value.
.. rst-class:: classref-item-separator
----
.. _class_@GlobalScope_method_wrapi:
.. rst-class:: classref-method
:ref:`int<class_int>` **wrapi**\ (\ value\: :ref:`int<class_int>`, min\: :ref:`int<class_int>`, max\: :ref:`int<class_int>`\ ) :ref:`🔗<class_@GlobalScope_method_wrapi>`
Wraps the integer ``value`` between ``min`` and ``max``. ``min`` is *inclusive* while ``max`` is *exclusive*. This can be used for creating loop-like behavior or infinite surfaces.
::
# Infinite loop between 5 and 9
frame = wrapi(frame + 1, 5, 10)
::
# result is -2
var result = wrapi(-6, -5, -1)
.. |virtual| replace:: :abbr:`virtual (本方法通常需要使用者覆寫才能生效。)`
.. |required| replace:: :abbr:`required (This method is required to be overridden when extending its base class.)`
.. |const| replace:: :abbr:`const (本方法沒有副作用。不會修改該實例的任何成員變數。)`
.. |vararg| replace:: :abbr:`vararg (本方法除了這裡描述的參數外，還可以接受任意數量的參數。)`
.. |constructor| replace:: :abbr:`constructor (本方法用於建構一個型別。)`
.. |static| replace:: :abbr:`static (本方法無需實例即可呼叫，因此可以直接使用類別名稱呼叫。)`
.. |operator| replace:: :abbr:`operator (本方法描述將本型別作為左運算元時可用的有效運算子。)`
.. |bitfield| replace:: :abbr:`BitField (此值是由下列旗標組成的位元遮罩整數。)`
.. |void| replace:: :abbr:`void (無回傳值。)`
Reference in New Issue View Git Blame Copy Permalink