Timer

Inherits: Node < Object

Category: Core

Brief Description

A simple Timer node.

Member Functions

float	get_time_left ( ) const
int	get_timer_process_mode ( ) const
float	get_wait_time ( ) const
bool	has_autostart ( ) const
bool	is_active ( ) const
bool	is_one_shot ( ) const
void	set_active ( bool active )
void	set_autostart ( bool enable )
void	set_one_shot ( bool enable )
void	set_timer_process_mode ( int mode )
void	set_wait_time ( float time_sec )
void	start ( )
void	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

float get_time_left ( ) const

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

int get_timer_process_mode ( ) const

Return the timer’s processing mode.

float get_wait_time ( ) const

Return the wait time in seconds.

bool has_autostart ( ) const

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

bool is_active ( ) const

Return if the timer is active or not.

bool is_one_shot ( ) const

Return true if configured as one-shot.

void set_active ( bool active )

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

void set_autostart ( bool enable )

Set to automatically start when entering the scene.

void set_one_shot ( bool enable )

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

void set_timer_process_mode ( int mode )

Set the timer’s processing mode (fixed or idle, use TIMER_PROCESS_* constants as argument).

void set_wait_time ( float time_sec )

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

void start ( )

Start the timer.

void stop ( )

Stop (cancel) the timer.