class_engine.rst 8.1 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150
  1. .. Generated automatically by doc/tools/makerst.py in Godot's source tree.
  2. .. DO NOT EDIT THIS FILE, but the Engine.xml source instead.
  3. .. The source is found in doc/classes or modules/<name>/doc_classes.
  4. .. _class_Engine:
  5. Engine
  6. ======
  7. **Inherits:** :ref:`Object<class_object>`
  8. **Category:** Core
  9. Brief Description
  10. -----------------
  11. Access to basic engine properties.
  12. Member Functions
  13. ----------------
  14. +--------------------------------------+------------------------------------------------------------------------------------------------------------------------------------+
  15. | :ref:`int<class_int>` | :ref:`get_frames_drawn<class_Engine_get_frames_drawn>` **(** **)** |
  16. +--------------------------------------+------------------------------------------------------------------------------------------------------------------------------------+
  17. | :ref:`float<class_float>` | :ref:`get_frames_per_second<class_Engine_get_frames_per_second>` **(** **)** const |
  18. +--------------------------------------+------------------------------------------------------------------------------------------------------------------------------------+
  19. | :ref:`int<class_int>` | :ref:`get_iterations_per_second<class_Engine_get_iterations_per_second>` **(** **)** const |
  20. +--------------------------------------+------------------------------------------------------------------------------------------------------------------------------------+
  21. | :ref:`MainLoop<class_mainloop>` | :ref:`get_main_loop<class_Engine_get_main_loop>` **(** **)** const |
  22. +--------------------------------------+------------------------------------------------------------------------------------------------------------------------------------+
  23. | :ref:`float<class_float>` | :ref:`get_target_fps<class_Engine_get_target_fps>` **(** **)** const |
  24. +--------------------------------------+------------------------------------------------------------------------------------------------------------------------------------+
  25. | :ref:`float<class_float>` | :ref:`get_time_scale<class_Engine_get_time_scale>` **(** **)** |
  26. +--------------------------------------+------------------------------------------------------------------------------------------------------------------------------------+
  27. | :ref:`Dictionary<class_dictionary>` | :ref:`get_version_info<class_Engine_get_version_info>` **(** **)** const |
  28. +--------------------------------------+------------------------------------------------------------------------------------------------------------------------------------+
  29. | :ref:`bool<class_bool>` | :ref:`is_editor_hint<class_Engine_is_editor_hint>` **(** **)** const |
  30. +--------------------------------------+------------------------------------------------------------------------------------------------------------------------------------+
  31. | :ref:`bool<class_bool>` | :ref:`is_in_physics_frame<class_Engine_is_in_physics_frame>` **(** **)** const |
  32. +--------------------------------------+------------------------------------------------------------------------------------------------------------------------------------+
  33. | void | :ref:`set_editor_hint<class_Engine_set_editor_hint>` **(** :ref:`bool<class_bool>` enabled **)** |
  34. +--------------------------------------+------------------------------------------------------------------------------------------------------------------------------------+
  35. | void | :ref:`set_iterations_per_second<class_Engine_set_iterations_per_second>` **(** :ref:`int<class_int>` iterations_per_second **)** |
  36. +--------------------------------------+------------------------------------------------------------------------------------------------------------------------------------+
  37. | void | :ref:`set_target_fps<class_Engine_set_target_fps>` **(** :ref:`int<class_int>` target_fps **)** |
  38. +--------------------------------------+------------------------------------------------------------------------------------------------------------------------------------+
  39. | void | :ref:`set_time_scale<class_Engine_set_time_scale>` **(** :ref:`float<class_float>` time_scale **)** |
  40. +--------------------------------------+------------------------------------------------------------------------------------------------------------------------------------+
  41. Description
  42. -----------
  43. The :ref:`Engine<class_engine>` class allows you to query and modify the game's run-time parameters, such as frames per second, time scale, and others.
  44. Member Function Description
  45. ---------------------------
  46. .. _class_Engine_get_frames_drawn:
  47. - :ref:`int<class_int>` **get_frames_drawn** **(** **)**
  48. Returns the total number of frames drawn.
  49. .. _class_Engine_get_frames_per_second:
  50. - :ref:`float<class_float>` **get_frames_per_second** **(** **)** const
  51. Returns the frames per second of the running game.
  52. .. _class_Engine_get_iterations_per_second:
  53. - :ref:`int<class_int>` **get_iterations_per_second** **(** **)** const
  54. Returns the number of fixed iterations per second (for fixed process and physics).
  55. .. _class_Engine_get_main_loop:
  56. - :ref:`MainLoop<class_mainloop>` **get_main_loop** **(** **)** const
  57. Returns the main loop object (see :ref:`MainLoop<class_mainloop>` and :ref:`SceneTree<class_scenetree>`).
  58. .. _class_Engine_get_target_fps:
  59. - :ref:`float<class_float>` **get_target_fps** **(** **)** const
  60. Returns the desired frames per second. If the hardware cannot keep up, this setting may not be respected. It defaults to 0, which indicates no limit.
  61. .. _class_Engine_get_time_scale:
  62. - :ref:`float<class_float>` **get_time_scale** **(** **)**
  63. Returns how fast or slow the in-game clock ticks versus the real life one. It defaults to 1.0. A value of 2.0 means the game moves twice as fast as real life, whilst a value of 0.5 means the game moves at half the regular speed.
  64. .. _class_Engine_get_version_info:
  65. - :ref:`Dictionary<class_dictionary>` **get_version_info** **(** **)** const
  66. Returns the current engine version information in a Dictionary.
  67. "major" - Holds the major version number as a String
  68. "minor" - Holds the minor version number as a String
  69. "patch" - Holds the patch version number as a String
  70. "status" - Holds the status (e.g. "beta", "rc1", "rc2", ... "stable") as a String
  71. "revision" - Holds the revision (e.g. "custom-build") as a String
  72. "string" - major + minor + patch + status + revision in a single String
  73. .. _class_Engine_is_editor_hint:
  74. - :ref:`bool<class_bool>` **is_editor_hint** **(** **)** const
  75. Returns ``true`` if the editor is running.
  76. .. _class_Engine_is_in_physics_frame:
  77. - :ref:`bool<class_bool>` **is_in_physics_frame** **(** **)** const
  78. Returns ``true`` if the game is inside the fixed process and physics phase of the game loop.
  79. .. _class_Engine_set_editor_hint:
  80. - void **set_editor_hint** **(** :ref:`bool<class_bool>` enabled **)**
  81. Sets the running inside the editor hint if ``enabled`` is ``true``.
  82. .. _class_Engine_set_iterations_per_second:
  83. - void **set_iterations_per_second** **(** :ref:`int<class_int>` iterations_per_second **)**
  84. Sets the number of fixed iterations per second (for fixed process and physics).
  85. .. _class_Engine_set_target_fps:
  86. - void **set_target_fps** **(** :ref:`int<class_int>` target_fps **)**
  87. Sets the target frames per second.
  88. .. _class_Engine_set_time_scale:
  89. - void **set_time_scale** **(** :ref:`float<class_float>` time_scale **)**
  90. Sets the time scale.