class Termisu::Event::Source::Timer

• Termisu::Event::Source::Timer
• Termisu::Event::Source
• Reference
• Object

Overview

Periodic timer event source.

Generates Event::Tick events at a configurable interval for animations, game loops, and other time-based operations.

Usage

timer = Termisu::Event::Source::Timer.new(interval: 16.milliseconds)
loop = Termisu::Event::Loop.new
loop.add_source(timer)
loop.start

while event = loop.output.receive?
  case event
  when Termisu::Event::Tick
    position += velocity * event.delta.total_seconds
    puts "Frame #{event.frame}, elapsed: #{event.elapsed}"
  end
end

Timing Behavior

• Uses Time.monotonic for accurate, non-jumping timing
• elapsed - Total time since timer started
• delta - Time since previous tick (for frame-rate independent updates)
• frame - Counter starting at 0, increments each tick

Thread Safety

Uses Atomic(Bool) for the running state. Safe to call #start/#stop from different fibers. The #interval= setter is thread-safe.

Defined in:

termisu/event/source/timer.cr

Constant Summary

DEFAULT_INTERVAL = 16.milliseconds

Default tick interval (~60 FPS).

Log = Termisu::Logs::Event

Constructors

• .new(interval : Time::Span = DEFAULT_INTERVAL)

  Creates a new timer with the specified interval.

Instance Method Summary

• #interval : Time::Span

  Returns the current interval between ticks.

• #interval=(value : Time::Span)

  Sets the interval between ticks.

• #name : String

  Returns the source name for identification.

• #running? : Bool

  Returns true if the timer is currently running.

• #start(output : Channel(Event::Any)) : Nil

  Starts generating tick events to the output channel.

• #stop : Nil

  Stops generating tick events.

Constructor Detail

Instance Method Detail