termfront 0.1.7 → 0.1.8

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: b6d91fa7b7758b2151fc31bb9f7862dbda3ad311edea638aa9b11ca50a8b9a8d
-  data.tar.gz: 3a8ce081de76ddd04c45949c490ba4b513f42eb94eb39fce37fef292abdbb004
+  metadata.gz: 7e7d185736b70057b93c85c4196ddc96b63693b3f31fd58f9cf9e83cb96e10fa
+  data.tar.gz: 4583088200b878c1d0b51ef44123b6bf49891501c67aecadb1c8af93fbd4b64e
 SHA512:
-  metadata.gz: a79ab596683eea6f8914c17cf88ad000d7a1b33453820526310f25fd43dbabb1f21e6f65f16a390fa92e491d6cd2da86e981c17bc971161316a6d4f7b431c98a
-  data.tar.gz: 556667b34ba430c7af848fca7d31f5937e24d328480a29a3191db88ca4286d579081b0f6e18c34622d87cb9ea401c20e19da6aaf0a6fbc2b892f15fdbb9f7b76
+  metadata.gz: 49eb38ea263659290eb41fe10b6719fd4d9201528ee583badc1d511239b7abd364b60109c849fad983d15636bfa8f9ae64152308a700d45587556dfaee5da3a6
+  data.tar.gz: 955636242f49453baf156dc44caf6c9815f836fcbab68d0825471dae0d7e86c9832b858c0a9e45920e07fca9d77e07293f8fd1c8ba96019e7900fa073c80593c

data/CHANGELOG.md

@@ -6,6 +6,16 @@ The format is based on Keep a Changelog, and this project follows Semantic Versi
 
 ## [Unreleased]
 
+## [0.1.8] - 2026-05-26
+
+### Fixed
+
+- Stop the `AudioManager` BGM and looping-SE threads from spinning at 100 % CPU when the audio player spawns but exits immediately (e.g. no usable audio device, codec missing, or backend not running). The non-looping playback loops now bail out if `spawn_player` returns `nil` or if the previous playback finished in under 500 ms, instead of relentlessly respawning a process that never plays anything. On a tester's CPU-bound host this was over 95 % of the process's CPU budget, making the renderer look heavy when the real culprit was the audio thread
+
+### Changed
+
+- Adapt the in-game render rate to the host's headroom: an `AdaptiveRenderRate` module tracks how often a frame exceeds 85 % of the 60 Hz budget and, after 30 consecutive over-budget frames, downshifts the singleplayer / Wavesfight render rate to 30 Hz; if the host catches back up for 60 consecutive frames it upshifts back to 60 Hz. Capable machines keep running at 60 Hz, while testers on lower-spec CPUs / TDP-throttled laptops fall back to a steady 30 Hz instead of a stuttering 60 Hz, and the rate resets on every new game loop entry so a freshly launched match starts at 60 Hz
+
 ## [0.1.7] - 2026-05-26
 
 ### Changed

data/lib/termfront/adaptive_render_rate.rb

@@ -0,0 +1,42 @@
+# frozen_string_literal: true
+
+module Termfront
+  module AdaptiveRenderRate
+    OVER_BUDGET_RATIO  = 0.85
+    UNDER_BUDGET_RATIO = 0.5
+    DOWNSHIFT_FRAMES   = 30
+    UPSHIFT_FRAMES     = 60
+
+    @current_dt = Config::RENDER_DT
+    @over_budget_count = 0
+    @under_budget_count = 0
+
+    class << self
+      def current_dt
+        @current_dt
+      end
+
+      def observe(spent)
+        if spent > Config::FRAME_DT * OVER_BUDGET_RATIO
+          @over_budget_count += 1
+          @under_budget_count = 0
+          if @over_budget_count >= DOWNSHIFT_FRAMES && @current_dt < Config::RENDER_DT_LOW
+            @current_dt = Config::RENDER_DT_LOW
+          end
+        elsif spent < Config::FRAME_DT * UNDER_BUDGET_RATIO
+          @under_budget_count += 1
+          @over_budget_count = 0
+          if @under_budget_count >= UPSHIFT_FRAMES && @current_dt > Config::RENDER_DT
+            @current_dt = Config::RENDER_DT
+          end
+        end
+      end
+
+      def reset!
+        @current_dt = Config::RENDER_DT
+        @over_budget_count = 0
+        @under_budget_count = 0
+      end
+    end
+  end
+end

data/lib/termfront/audio_manager.rb

@@ -41,9 +41,13 @@ module Termfront
             loop do
               break if channel_stopped?(:bgm)
 
+              start = Process.clock_gettime(Process::CLOCK_MONOTONIC)
               @bgm_pid = spawn_player(@bgm_player, path, loop_playback: false)
+              break unless @bgm_pid
+
               wait_for_channel(:bgm)
               break if channel_stopped?(:bgm)
+              break if Process.clock_gettime(Process::CLOCK_MONOTONIC) - start < 0.5
             end
           end
         rescue StandardError
@@ -101,9 +105,13 @@ module Termfront
             loop do
               break if channel_stopped?(:loop_se)
 
+              start = Process.clock_gettime(Process::CLOCK_MONOTONIC)
               @loop_se_pid = spawn_player(@loop_se_player, path, loop_playback: false)
+              break unless @loop_se_pid
+
               wait_for_channel(:loop_se)
               break if channel_stopped?(:loop_se)
+              break if Process.clock_gettime(Process::CLOCK_MONOTONIC) - start < 0.5
             end
           end
         rescue StandardError

data/lib/termfront/config.rb

@@ -4,6 +4,7 @@ module Termfront
   module Config
     FRAME_DT      = 1.0 / 60.0
     RENDER_DT     = 1.0 / 60.0
+    RENDER_DT_LOW = 1.0 / 30.0
     MAX_DT        = 1.0 / 20.0
     FOV           = 66.0 * Math::PI / 180.0
     PLAYER_RADIUS = 0.2

data/lib/termfront/game.rb

@@ -130,9 +130,10 @@ module Termfront
     end
 
     def run_game_loop(show_complete_banner: true)
+      AdaptiveRenderRate.reset!
       STDIN.raw do |stdin|
         last_time = clock
-        last_render = last_time - Config::RENDER_DT
+        last_render = last_time - AdaptiveRenderRate.current_dt
 
         loop do
           now = clock
@@ -149,7 +150,7 @@ module Termfront
           end
 
           update(dt)
-          if now - last_render >= Config::RENDER_DT
+          if now - last_render >= AdaptiveRenderRate.current_dt
             @renderer.render(
               player: @player, map: @map,
               enemies: @enemies, projectiles: @projectiles,
@@ -180,9 +181,10 @@ module Termfront
     end
 
     def run_wavesfight_loop
+      AdaptiveRenderRate.reset!
       STDIN.raw do |stdin|
         last_time = clock
-        last_render = last_time - Config::RENDER_DT
+        last_render = last_time - AdaptiveRenderRate.current_dt
 
         loop do
           now = clock
@@ -199,7 +201,7 @@ module Termfront
           end
 
           update(dt)
-          if now - last_render >= Config::RENDER_DT
+          if now - last_render >= AdaptiveRenderRate.current_dt
             @renderer.render(
               player: @player, map: @map,
               enemies: @enemies, projectiles: @projectiles,
@@ -220,7 +222,7 @@ module Termfront
             show_wave_clear
             start_wavesfight_wave
             last_time = clock
-            last_render = clock - Config::RENDER_DT
+            last_render = clock - AdaptiveRenderRate.current_dt
           end
 
           cap_frame(now)
@@ -659,6 +661,7 @@ module Termfront
 
     def cap_frame(frame_start)
       spent = clock - frame_start
+      AdaptiveRenderRate.observe(spent)
       remain = Config::FRAME_DT - spent
       sleep(remain) if remain > 0
     end

data/lib/termfront/network/client.rb

@@ -907,6 +907,7 @@ module Termfront
 
       def cap_frame(frame_start)
         spent = clock - frame_start
+        AdaptiveRenderRate.observe(spent)
         remain = Config::FRAME_DT - spent
         sleep(remain) if remain > 0
       end

data/lib/termfront/network/wavesfight_client.rb

@@ -406,6 +406,7 @@ module Termfront
 
       def cap_frame(frame_start)
         spent = clock - frame_start
+        AdaptiveRenderRate.observe(spent)
         remain = Config::FRAME_DT - spent
         sleep(remain) if remain > 0
       end

data/lib/termfront/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module Termfront
-  VERSION = "0.1.7"
+  VERSION = "0.1.8"
 end

data/lib/termfront.rb

@@ -4,6 +4,7 @@ require "io/console"
 
 require_relative "termfront/version"
 require_relative "termfront/config"
+require_relative "termfront/adaptive_render_rate"
 require_relative "termfront/color"
 require_relative "termfront/map"
 require_relative "termfront/weapon/base"

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: termfront
 version: !ruby/object:Gem::Version
-  version: 0.1.7
+  version: 0.1.8
 platform: ruby
 authors:
 - S-H-GAMELINKS
@@ -51,6 +51,7 @@ files:
 - exe/termfront
 - exe/termfront-server
 - lib/termfront.rb
+- lib/termfront/adaptive_render_rate.rb
 - lib/termfront/async_writer.rb
 - lib/termfront/audio_manager.rb
 - lib/termfront/color.rb