godot-docs/classes/class_timer.rst

.. Generated automatically by doc/tools/makerst.py in Godot's source tree.
.. DO NOT EDIT THIS FILE, but the doc/base/classes.xml source instead.

.. _class_Timer:

Timer
=====

**Inherits:** :ref:`Node<class_node>` **<** :ref:`Object<class_object>`

**Category:** Core

Brief Description
-----------------

A simple Timer node.

Member Functions
----------------

+----------------------------+------------------------------------------------------------------------------------------------------------+
| :ref:`float<class_float>`  | :ref:`get_time_left<class_Timer_get_time_left>`  **(** **)** const                                         |
+----------------------------+------------------------------------------------------------------------------------------------------------+
| :ref:`int<class_int>`      | :ref:`get_timer_process_mode<class_Timer_get_timer_process_mode>`  **(** **)** const                       |
+----------------------------+------------------------------------------------------------------------------------------------------------+
| :ref:`float<class_float>`  | :ref:`get_wait_time<class_Timer_get_wait_time>`  **(** **)** const                                         |
+----------------------------+------------------------------------------------------------------------------------------------------------+
| :ref:`bool<class_bool>`    | :ref:`has_autostart<class_Timer_has_autostart>`  **(** **)** const                                         |
+----------------------------+------------------------------------------------------------------------------------------------------------+
| :ref:`bool<class_bool>`    | :ref:`is_active<class_Timer_is_active>`  **(** **)** const                                                 |
+----------------------------+------------------------------------------------------------------------------------------------------------+
| :ref:`bool<class_bool>`    | :ref:`is_one_shot<class_Timer_is_one_shot>`  **(** **)** const                                             |
+----------------------------+------------------------------------------------------------------------------------------------------------+
| void                       | :ref:`set_active<class_Timer_set_active>`  **(** :ref:`bool<class_bool>` active  **)**                     |
+----------------------------+------------------------------------------------------------------------------------------------------------+
| void                       | :ref:`set_autostart<class_Timer_set_autostart>`  **(** :ref:`bool<class_bool>` enable  **)**               |
+----------------------------+------------------------------------------------------------------------------------------------------------+
| void                       | :ref:`set_one_shot<class_Timer_set_one_shot>`  **(** :ref:`bool<class_bool>` enable  **)**                 |
+----------------------------+------------------------------------------------------------------------------------------------------------+
| void                       | :ref:`set_timer_process_mode<class_Timer_set_timer_process_mode>`  **(** :ref:`int<class_int>` mode  **)** |
+----------------------------+------------------------------------------------------------------------------------------------------------+
| void                       | :ref:`set_wait_time<class_Timer_set_wait_time>`  **(** :ref:`float<class_float>` time_sec  **)**           |
+----------------------------+------------------------------------------------------------------------------------------------------------+
| void                       | :ref:`start<class_Timer_start>`  **(** **)**                                                               |
+----------------------------+------------------------------------------------------------------------------------------------------------+
| void                       | :ref:`stop<class_Timer_stop>`  **(** **)**                                                                 |
+----------------------------+------------------------------------------------------------------------------------------------------------+

Signals
-------

-  **timeout**  **(** **)**
Emitted when the time runs out.


Numeric Constants
-----------------

- **TIMER_PROCESS_FIXED** = **0** --- Update the timer at fixed intervals (framerate processing).
- **TIMER_PROCESS_IDLE** = **1** --- Update the timer during the idle time at each frame.

Description
-----------

Timer node. This is a simple node that will emit a timeout callback when the timer runs out. It can optionally be set to loop.

Member Function Description
---------------------------

.. _class_Timer_get_time_left:

- :ref:`float<class_float>`  **get_time_left**  **(** **)** const

Return the time left for timeout in seconds if the timer is active, 0 otherwise.

.. _class_Timer_get_timer_process_mode:

- :ref:`int<class_int>`  **get_timer_process_mode**  **(** **)** const

Return the timer's processing mode.

.. _class_Timer_get_wait_time:

- :ref:`float<class_float>`  **get_wait_time**  **(** **)** const

Return the wait time in seconds.

.. _class_Timer_has_autostart:

- :ref:`bool<class_bool>`  **has_autostart**  **(** **)** const

Return true if set to automatically start when entering the scene.

.. _class_Timer_is_active:

- :ref:`bool<class_bool>`  **is_active**  **(** **)** const

Return if the timer is active or not.

.. _class_Timer_is_one_shot:

- :ref:`bool<class_bool>`  **is_one_shot**  **(** **)** const

Return true if configured as one-shot.

.. _class_Timer_set_active:

- void  **set_active**  **(** :ref:`bool<class_bool>` active  **)**

Set whether the timer is active or not. An inactive timer will be paused until it is activated again.

.. _class_Timer_set_autostart:

- void  **set_autostart**  **(** :ref:`bool<class_bool>` enable  **)**

Set to automatically start when entering the scene.

.. _class_Timer_set_one_shot:

- void  **set_one_shot**  **(** :ref:`bool<class_bool>` enable  **)**

Set as one-shot. If enabled, the timer will stop after timeout, otherwise it will automatically restart.

.. _class_Timer_set_timer_process_mode:

- void  **set_timer_process_mode**  **(** :ref:`int<class_int>` mode  **)**

Set the timer's processing mode (fixed or idle, use TIMER_PROCESS\_\* constants as argument).

.. _class_Timer_set_wait_time:

- void  **set_wait_time**  **(** :ref:`float<class_float>` time_sec  **)**

Set wait time in seconds. When the time is over, it will emit the timeout signal.

.. _class_Timer_start:

- void  **start**  **(** **)**

Start the timer.

.. _class_Timer_stop:

- void  **stop**  **(** **)**

Stop (cancel) the timer.