Timer
Category: Core
Brief Description
A countdown timer.
Properties
bool | autostart |
bool | one_shot |
bool | paused |
TimerProcessMode | process_mode |
float | time_left |
float | wait_time |
Methods
bool | is_stopped ( ) const |
void | start ( float time_sec=-1 ) |
void | stop ( ) |
Signals
- timeout ( )
Emitted when the timer reaches 0.
Enumerations
enum TimerProcessMode:
- TIMER_PROCESS_PHYSICS = 0 — Update the timer during the physics step at each frame (fixed framerate processing).
- TIMER_PROCESS_IDLE = 1 — Update the timer during the idle time at each frame.
Description
Counts down a specified interval and emits a signal on reaching 0. Can be set to repeat or “one shot” mode.
Property Descriptions
- bool autostart
Setter | set_autostart(value) |
Getter | has_autostart() |
If true
, the timer will automatically start when entering the scene tree. Default value: false
.
- bool one_shot
Setter | set_one_shot(value) |
Getter | is_one_shot() |
If true
, the timer will stop when reaching 0. If false
, it will restart. Default value: false
.
- bool paused
Setter | set_paused(value) |
Getter | is_paused() |
If true
, the timer is paused and will not process until it is unpaused again, even if start is called.
- TimerProcessMode process_mode
Setter | set_timer_process_mode(value) |
Getter | get_timer_process_mode() |
Processing mode. See TimerProcessMode.
- float time_left
Getter | get_time_left() |
The timer’s remaining time in seconds. Returns 0 if the timer is inactive.
Note: You cannot set this value. To change the timer’s remaining time, use wait_time.
- float wait_time
Setter | set_wait_time(value) |
Getter | get_wait_time() |
Wait time in seconds.
Method Descriptions
- bool is_stopped ( ) const
Returns true
if the timer is stopped.
- void start ( float time_sec=-1 )
Starts the timer. Sets wait_time
to time_sec
if time_sec > 0
. This also resets the remaining time to wait_time
.
Note: this method will not resume a paused timer. See paused.
- void stop ( )
Stops the timer.