LCOV - code coverage report
Current view: top level - consts - coord.go Coverage Total Hit
Test: coverage.lcov Lines: 95.5 % 22 21
Test Date: 2026-11-19 00:25:22 Functions: - 0 0

            Line data    Source code
       1              : package consts
       2              : 
       3              : import "fmt"
       4              : 
       5              : // Numeric は int または float64 を基底型とする数値型を表す汎用制約
       6              : type Numeric interface {
       7              :         ~int | ~float64
       8              : }
       9              : 
      10              : // Coord は2次元座標を表すジェネリック型
      11              : type Coord[T Numeric] struct {
      12              :         X T
      13              :         Y T
      14              : }
      15              : 
      16              : // String は (x,y) 形式の文字列を返す。ログや座標表示の整形を一箇所に集約する。
      17              : func (c Coord[T]) String() string {
      18            1 :         return fmt.Sprintf("(%v,%v)", c.X, c.Y)
      19            1 : }
      20              : 
      21              : // Add は2つの座標を成分ごとに加算した座標を返す。
      22              : func (c Coord[T]) Add(o Coord[T]) Coord[T] {
      23            1 :         return Coord[T]{X: c.X + o.X, Y: c.Y + o.Y}
      24            1 : }
      25              : 
      26              : // Sub は成分ごとに減算した座標を返す。
      27              : func (c Coord[T]) Sub(o Coord[T]) Coord[T] {
      28            1 :         return Coord[T]{X: c.X - o.X, Y: c.Y - o.Y}
      29            1 : }
      30              : 
      31              : // TileCenterToWorld はタイル座標を、そのタイル中心のワールドピクセル座標へ変換する。
      32              : // スプライトはタイル中心に合わせて配置するため中心へ半タイルぶんずらす。
      33              : func TileCenterToWorld(grid Coord[Tile]) Coord[WorldPixel] {
      34            1 :         half := TileSize / 2
      35            1 :         return Coord[WorldPixel]{X: WorldPixel(grid.X)*TileSize + half, Y: WorldPixel(grid.Y)*TileSize + half}
      36            1 : }
      37              : 
      38              : // AbsTileY は南北の絶対タイル Y 座標。
      39              : //
      40              : // 北が上すなわち -Y で、奥へ進むほど負へ無限に伸びる絶対軸。帯ローカルの GridElement.Y とは別物で、
      41              : // GridElement.Y は常に 0..rows*chunkH の有界。絶対と局所の取り違えを Go の型で弾くための別名型。
      42              : // 帯原点はこの絶対軸で扱う。東西はストリーミングせず幅固定なので、絶対軸は Y のみで足りる。
      43              : //
      44              : // worldstream の帯ドライバも components の永続状態 SeamlessBand も同じ絶対軸を扱うため、
      45              : // 双方から import できる leaf の consts に置く。これで境界のキャストを無くせる。
      46              : type AbsTileY int
      47              : 
      48              : // BandOriginY は北進チャンク数 northIndex と帯高 chunkH から帯の絶対原点 Y を返す。
      49              : // 帯ローカル Y=0 すなわち北端が絶対軸で指す位置。北は -Y なので northIndex ぶん負へ伸びる。
      50              : // worldstream と components の双方が同じ式を要るので、両者が import する leaf の consts を単一出典にする。
      51              : func BandOriginY(northIndex Chunk, chunkH Tile) AbsTileY {
      52            1 :         return AbsTileY(-int(northIndex.Tiles(chunkH)))
      53            1 : }
      54              : 
      55              : // FloorDiv は負の被除数でも床方向へ丸める整数除算。Go の / はゼロ方向へ丸めるので負側で境界が
      56              : // 二重になるのを防ぐ。北側の負座標のチャンク割り・リージョン割りで query と overworld が共有する。
      57              : func FloorDiv[T ~int](a, b T) T {
      58            1 :         q := a / b
      59            1 :         if (a%b != 0) && ((a < 0) != (b < 0)) {
      60            1 :                 q--
      61            1 :         }
      62            1 :         return q
      63              : }
      64              : 
      65              : // Cardinal は地図の東西南北のどれかの向き。北は Y が減る向き。画面の上下左右と斜めを表す移動の向きとは別
      66              : type Cardinal int
      67              : 
      68              : // 東西南北の向き
      69              : const (
      70              :         North Cardinal = iota
      71              :         East
      72              :         South
      73              :         West
      74              : )
      75              : 
      76              : // Delta はその向きの隣のマスへのずれを返す
      77              : func (c Cardinal) Delta() Coord[Tile] {
      78            1 :         switch c {
      79              :         case North:
      80            1 :                 return Coord[Tile]{X: 0, Y: -1}
      81              :         case East:
      82            1 :                 return Coord[Tile]{X: 1, Y: 0}
      83              :         case South:
      84            1 :                 return Coord[Tile]{X: 0, Y: 1}
      85              :         case West:
      86            1 :                 return Coord[Tile]{X: -1, Y: 0}
      87              :         }
      88            0 :         panic(fmt.Sprintf("unknown cardinal: %d", int(c)))
      89              : }
        

Generated by: LCOV version 2.0-1