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

            Line data    Source code
       1              : package resources
       2              : 
       3              : import (
       4              :         "errors"
       5              :         "fmt"
       6              :         "image"
       7              : 
       8              :         "github.com/hajimehoshi/ebiten/v2"
       9              :         "golang.org/x/image/draw"
      10              : 
      11              :         "github.com/kijimaD/ruins/internal/components"
      12              : )
      13              : 
      14              : // errNilSpriteRender は SpriteRender が nil のときに返す
      15              : var errNilSpriteRender = errors.New("sprite render is nil")
      16              : 
      17              : // SpriteStore は SpriteRender が指すスプライトの画像を解決してキャッシュする。
      18              : // 等倍の部分画像と、表示サイズへ縮めた画像の両方を同じ置き場に持ち、スプライトから画像を得る道を1つにする。
      19              : //
      20              : // world ごとに持つ。グローバルな可変状態を作らず、並行して走るテストが互いの画像を混ぜない。
      21              : type SpriteStore struct {
      22              :         sheets map[string]components.SpriteSheet
      23              :         images map[spriteKey]*ebiten.Image
      24              : }
      25              : 
      26              : // spriteKey は解決結果を一意に決める組。size=0 は等倍、正の size は同じスプライトの縮小を表す。
      27              : type spriteKey struct {
      28              :         sheet  string
      29              :         sprite string
      30              :         size   int
      31              : }
      32              : 
      33              : // NewSpriteStore は空のスプライト置き場を作る。
      34              : func NewSpriteStore() *SpriteStore {
      35            1 :         return &SpriteStore{images: map[spriteKey]*ebiten.Image{}}
      36            1 : }
      37              : 
      38              : // SetSheets は解決元のスプライトシートを差し替える。Resources.SetSpriteSheets から呼ぶ。
      39              : // シートが変われば解決結果も変わるので、キャッシュは捨てる。
      40              : func (s *SpriteStore) SetSheets(sheets map[string]components.SpriteSheet) {
      41            1 :         s.sheets = sheets
      42            1 :         s.images = map[spriteKey]*ebiten.Image{}
      43            1 : }
      44              : 
      45              : // Image は sr が指すスプライトの等倍の部分画像を返す。解決できなければ nil を返し、描かない行として扱わせる。
      46              : func (s *SpriteStore) Image(sr *components.SpriteRender) *ebiten.Image {
      47            1 :         if sr == nil {
      48            1 :                 return nil
      49            1 :         }
      50            1 :         key := spriteKey{sheet: sr.SpriteSheetName, sprite: sr.SpriteKey}
      51            1 :         if img, ok := s.images[key]; ok {
      52            1 :                 return img
      53            1 :         }
      54            1 :         tex, rect, ok := s.Rect(sr)
      55            1 :         if !ok {
      56            1 :                 return nil
      57            1 :         }
      58            1 :         img := components.SubImage(tex.Image, rect)
      59            1 :         s.images[key] = img
      60            1 :         return img
      61              : }
      62              : 
      63              : // Sized は sr が指すスプライトを size の正方へ収まるまで縦横比を保って縮めた画像を返す。解決できなければ nil。
      64              : func (s *SpriteStore) Sized(sr *components.SpriteRender, size int) *ebiten.Image {
      65            1 :         if sr == nil || size <= 0 {
      66            1 :                 return nil
      67            1 :         }
      68            1 :         key := spriteKey{sheet: sr.SpriteSheetName, sprite: sr.SpriteKey, size: size}
      69            1 :         if img, ok := s.images[key]; ok {
      70            1 :                 return img
      71            1 :         }
      72            1 :         tex, rect, ok := s.Rect(sr)
      73            1 :         if !ok {
      74            1 :                 return nil
      75            1 :         }
      76            1 :         img := shrinkToFit(tex, rect, size)
      77            1 :         if img == nil {
      78            1 :                 return nil
      79            1 :         }
      80            1 :         s.images[key] = img
      81            1 :         return img
      82              : }
      83              : 
      84              : // Rect は sr が指すスプライトのテクスチャと、その中の切り出し矩形を返す。解決できなければ ok=false。
      85              : // 矩形はテクスチャ範囲へクランプした絶対座標で、SubImage の切り出しにも、アトラス全体を
      86              : // 使うときの UV 座標にも使える。スプライトの矩形を求める箇所はこれを通し、解決を1つに保つ。
      87              : func (s *SpriteStore) Rect(sr *components.SpriteRender) (components.Texture, image.Rectangle, bool) {
      88            1 :         sheet, rect, err := spriteRect(s.sheets, sr)
      89            1 :         if err != nil {
      90            1 :                 return components.Texture{}, image.Rectangle{}, false
      91            1 :         }
      92            1 :         return sheet.Texture, rect, true
      93              : }
      94              : 
      95              : // spriteRect は SpriteRender が指すシートと、その中のスプライトの矩形を返す。
      96              : // 矩形はテクスチャ範囲へクランプするので、範囲外を指す指定でも安全に切り出せる
      97              : func spriteRect(sheets map[string]components.SpriteSheet, sr *components.SpriteRender) (components.SpriteSheet, image.Rectangle, error) {
      98            1 :         if sr == nil {
      99            1 :                 return components.SpriteSheet{}, image.Rectangle{}, errNilSpriteRender
     100            1 :         }
     101            1 :         sheet, ok := sheets[sr.SpriteSheetName]
     102            1 :         if !ok {
     103            1 :                 return components.SpriteSheet{}, image.Rectangle{}, fmt.Errorf("sprite sheet %q not found", sr.SpriteSheetName)
     104            1 :         }
     105            1 :         sprite, ok := sheet.Sprites[sr.SpriteKey]
     106            1 :         if !ok {
     107            1 :                 return components.SpriteSheet{}, image.Rectangle{}, fmt.Errorf("sprite key %q not found in sheet %q", sr.SpriteKey, sr.SpriteSheetName)
     108            1 :         }
     109            1 :         if sheet.Texture.Image == nil {
     110            1 :                 return components.SpriteSheet{}, image.Rectangle{}, fmt.Errorf("sprite sheet %q has no texture image", sr.SpriteSheetName)
     111            1 :         }
     112            1 :         w := sheet.Texture.Image.Bounds().Dx()
     113            1 :         h := sheet.Texture.Image.Bounds().Dy()
     114            1 :         rect := image.Rect(
     115            1 :                 max(0, sprite.X),
     116            1 :                 max(0, sprite.Y),
     117            1 :                 min(w, sprite.X+sprite.Width),
     118            1 :                 min(h, sprite.Y+sprite.Height),
     119            1 :         )
     120            1 :         return sheet, rect, nil
     121              : }
     122              : 
     123              : // shrinkToFit は tex の rect の部分を size の正方へ収まるまで縦横比を保って縮める。
     124              : // 拡大はしないので、すでに収まっている部分はテクスチャの部分画像をそのまま返す。
     125              : //
     126              : // GPU の端数倍率の縮小はテクセル境界の読みが揺れて決定的でないため、縮小は CPU で一度だけ行う。
     127              : func shrinkToFit(tex components.Texture, rect image.Rectangle, size int) *ebiten.Image {
     128            1 :         sw, sh := rect.Dx(), rect.Dy()
     129            1 :         if sw <= 0 || sh <= 0 {
     130            1 :                 return nil
     131            1 :         }
     132            1 :         if (sw <= size && sh <= size) || tex.Source == nil {
     133            1 :                 return components.SubImage(tex.Image, rect)
     134            1 :         }
     135            1 :         dw, dh := size, size
     136            1 :         if sw >= sh {
     137            1 :                 dh = max(1, sh*size/sw)
     138            1 :         } else {
     139            1 :                 dw = max(1, sw*size/sh)
     140            1 :         }
     141              : 
     142              :         // image.RGBA は乗算済みアルファなので、透過の境界でも色がにじまない重み付けになる
     143            1 :         dst := image.NewRGBA(image.Rect(0, 0, dw, dh))
     144            1 :         draw.CatmullRom.Scale(dst, dst.Bounds(), tex.Source, rect, draw.Src, nil)
     145            1 : 
     146            1 :         out := ebiten.NewImage(dw, dh)
     147            1 :         out.WritePixels(dst.Pix)
     148            1 :         return out
     149              : }
        

Generated by: LCOV version 2.0-1