LCOV - code coverage report
Current view: top level - components - game_time.go Coverage Total Hit
Test: coverage.lcov Lines: 100.0 % 32 32
Test Date: 2026-11-19 00:25:22 Functions: - 0 0

            Line data    Source code
       1              : package components
       2              : 
       3              : import (
       4              :         "github.com/kijimaD/ruins/internal/consts"
       5              : )
       6              : 
       7              : // TimeOfDay は時間帯を表す
       8              : type TimeOfDay int
       9              : 
      10              : // 時間帯定数。暦の1日は夜明けで始まるので、区切り順に夜明けから並べる。
      11              : // これで TotalTurns=0 が1日の始まりを無変換で指し、日数も季節もオフセットなしで導ける。
      12              : // かっこ内は1周目の経過ターン範囲で、以降は1日ごとに繰り返す
      13              : const (
      14              :         TimeDawn     TimeOfDay = iota // 夜明け 経過0-249
      15              :         TimeMorning                   // 朝 経過250-499
      16              :         TimeDay                       // 昼 経過500-749
      17              :         TimeEvening                   // 夕 経過750-999
      18              :         TimeNight                     // 夜 経過1000-1249
      19              :         TimeMidnight                  // 深夜 経過1250-1499
      20              : )
      21              : 
      22              : // TurnsPerDay は1日のターン数。バランス導出が生存日数を日単位で出せるよう公開する。
      23              : const TurnsPerDay consts.Turn = 1500
      24              : 
      25              : // turnsPerDay は当パッケージ内で使う別名。
      26              : const turnsPerDay = TurnsPerDay
      27              : 
      28              : // 時間帯ごとのターン数
      29              : const turnsPerTimeOfDay consts.Turn = turnsPerDay / 6 // 250ターン
      30              : 
      31              : // GameTime はゲーム内時間を管理する
      32              : type GameTime struct {
      33              :         TotalTurns consts.Turn // run 開始からの経過ターン数
      34              : }
      35              : 
      36              : // GetTimeOfDay は現在の時間帯を返す
      37              : func (gt *GameTime) GetTimeOfDay() TimeOfDay {
      38            1 :         return TimeOfDay(gt.TotalTurns % turnsPerDay / turnsPerTimeOfDay)
      39            1 : }
      40              : 
      41              : // NumTimeOfDay は時間帯の区分数。時間帯ごとの値の配列の長さに使う
      42              : const NumTimeOfDay = int(turnsPerDay / turnsPerTimeOfDay)
      43              : 
      44              : // GetDaylightLerp は日照や色味を連続に補間するための、前後のアンカー時間帯とその間の位置 0..1 を返す。
      45              : // 各時間帯を区間の中心にアンカーする。境界で段差にせず中心の代表値へなだらかに寄せるため。
      46              : // 値表は CalendarDefs が持ち、時間の割り出しだけをここに置く。時間帯の区切りに要る turnsPerDay と
      47              : // turnsPerTimeOfDay が components にあるため。補間そのものは呼び出し側が行う。
      48              : func (gt *GameTime) GetDaylightLerp() (from, to TimeOfDay, t float64) {
      49              :         // 中心へアンカーするため半区間ずらす。turnsPerTimeOfDay=250 は偶数で端数は出ない
      50            1 :         half := turnsPerTimeOfDay / 2
      51            1 :         // 中心より前は1つ前の区間へ回り込むので turnsPerDay を足して正へ寄せる
      52            1 :         rel := (gt.TotalTurns%turnsPerDay - half + turnsPerDay) % turnsPerDay
      53            1 :         idx := int(rel / turnsPerTimeOfDay)
      54            1 :         t = float64(rel%turnsPerTimeOfDay) / float64(turnsPerTimeOfDay)
      55            1 :         return TimeOfDay(idx), TimeOfDay((idx + 1) % NumTimeOfDay), t
      56            1 : }
      57              : 
      58              : // GetDayNumber は経過日数を返す(1日目から始まる)。turn 0 が1日目の夜明けなのでオフセットは要らない
      59              : func (gt *GameTime) GetDayNumber() int {
      60            1 :         return int(gt.TotalTurns/turnsPerDay) + 1
      61            1 : }
      62              : 
      63              : // daysPerYear は季節1周の日数
      64              : const daysPerYear = 32
      65              : 
      66              : // Season は季節を表す。1年を4等分し、春開始で巡る。
      67              : type Season int
      68              : 
      69              : // 季節定数。CalendarDefs.SeasonalTemperatureForDay の正弦波と位相を合わせる。
      70              : const (
      71              :         SeasonSpring Season = iota // 春
      72              :         SeasonSummer               // 夏
      73              :         SeasonAutumn               // 秋
      74              :         SeasonWinter               // 冬
      75              :         // NumSeason は季節の数。季節ごとの重みの配列の長さに使う
      76              :         NumSeason = iota
      77              : )
      78              : 
      79              : // GetSeason は経過日数から現在の季節を返す。
      80              : func (gt *GameTime) GetSeason() Season {
      81            1 :         const daysPerSeason = daysPerYear / 4
      82            1 :         dayOfYear := (gt.GetDayNumber() - 1) % daysPerYear
      83            1 :         return Season(dayOfYear / daysPerSeason)
      84            1 : }
      85              : 
      86              : // SeasonJustChanged は直前のターンから季節が変わったかを返す。Advance の直後に呼ぶ想定。
      87              : func (gt *GameTime) SeasonJustChanged() bool {
      88            1 :         if gt.TotalTurns == 0 {
      89            1 :                 return false
      90            1 :         }
      91            1 :         prev := GameTime{TotalTurns: gt.TotalTurns - 1}
      92            1 :         return gt.GetSeason() != prev.GetSeason()
      93              : }
      94              : 
      95              : // TimeOfDayJustChanged は現在の時間帯と、直前のターンから変わったかを返す。
      96              : // 呼び出し側が入った先で日の出入りを見分けられるよう時間帯も返す。
      97              : func (gt *GameTime) TimeOfDayJustChanged() (TimeOfDay, bool) {
      98            1 :         cur := gt.GetTimeOfDay()
      99            1 :         if gt.TotalTurns == 0 {
     100            1 :                 return cur, false
     101            1 :         }
     102            1 :         prev := GameTime{TotalTurns: gt.TotalTurns - 1}
     103            1 :         return cur, prev.GetTimeOfDay() != cur
     104              : }
     105              : 
     106              : // Advance はターンを進める
     107              : func (gt *GameTime) Advance() {
     108            1 :         gt.TotalTurns++
     109            1 : }
     110              : 
     111              : // AdvanceToNextTimeOfDay は次の時間帯の開始ターンまで進める。
     112              : // 現在のフェーズの残りターンを飛ばし、常にちょうど1つ次の時間帯にする。
     113              : // 深夜からは翌日の夜明けへ折り返す。
     114              : func (gt *GameTime) AdvanceToNextTimeOfDay() {
     115            1 :         gt.TotalTurns = (gt.TotalTurns/turnsPerTimeOfDay + 1) * turnsPerTimeOfDay
     116            1 : }
     117              : 
     118              : // turnsPerSeason は1季節ぶんのターン数
     119              : const turnsPerSeason consts.Turn = consts.Turn(daysPerYear/4) * turnsPerDay
     120              : 
     121              : // AdvanceToNextSeason は次の季節の開始まで進める。季節による世界温度を切り替える。
     122              : // 冬からは翌年の春へ折り返す。turn 0 が夜明け始まりなので、季節境界は turnsPerSeason の倍数に一致する
     123              : func (gt *GameTime) AdvanceToNextSeason() {
     124            1 :         gt.TotalTurns = (gt.TotalTurns/turnsPerSeason + 1) * turnsPerSeason
     125            1 : }
        

Generated by: LCOV version 2.0-1