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

            Line data    Source code
       1              : package components
       2              : 
       3              : import (
       4              :         "bytes"
       5              :         "image"
       6              : 
       7              :         // テクスチャは PNG。image.Decode が読めるよう復号器を登録する
       8              :         _ "image/png"
       9              : 
      10              :         "github.com/hajimehoshi/ebiten/v2"
      11              :         "github.com/kijimaD/ruins/assets"
      12              :         "github.com/kijimaD/ruins/internal/rawschema"
      13              : )
      14              : 
      15              : // SubImage は画像の部分矩形を切り出す。
      16              : // ebiten.Image.SubImage は image.Image を返すが実体は常に *ebiten.Image であり、
      17              : // 各所での未チェック型アサーションを避けるためここに集約する
      18              : func SubImage(img *ebiten.Image, r image.Rectangle) *ebiten.Image {
      19            1 :         sub, ok := img.SubImage(r).(*ebiten.Image)
      20            1 :         if !ok {
      21            0 :                 panic("ebiten.Image.SubImage did not return *ebiten.Image")
      22              :         }
      23            1 :         return sub
      24              : }
      25              : 
      26              : // Sprite は1つ1つの意味をなす画像の位置を示す情報
      27              : // 1ファイルに対して複数のスプライトが定義されている
      28              : type Sprite struct {
      29              :         X      int
      30              :         Y      int
      31              :         Width  int
      32              :         Height int
      33              : }
      34              : 
      35              : // Texture は複数のスプライトが格納された画像ファイル
      36              : type Texture struct {
      37              :         Image *ebiten.Image
      38              :         // Source は復号したままの CPU 側の画像。GPU のテクスチャはゲームループが始まるまで
      39              :         // 画素を読み出せないため、縮小など画素を触る処理はこちらを源にする
      40              :         Source image.Image
      41              : }
      42              : 
      43              : // UnmarshalText fills structure fields from text data
      44              : func (t *Texture) UnmarshalText(text []byte) error {
      45            1 :         bs, err := assets.FS.ReadFile(string(text))
      46            1 :         if err != nil {
      47            1 :                 return err
      48            1 :         }
      49            1 :         sourceImage, _, err := image.Decode(bytes.NewReader(bs))
      50            1 :         if err != nil {
      51            0 :                 return err
      52            0 :         }
      53              :         // unmanaged にして内部テクスチャアトラスへ載せない。nearest サンプリングのテクセル境界の
      54              :         // 読み分けはアトラス上の配置座標に依存し、配置は画像の生成順で変わるため、managed のままだと
      55              :         // 同じ場面でも画素が揺れる。他の描画ソースの unmanaged 化もこの機構が理由で、説明はここへ集約する
      56            1 :         t.Image = ebiten.NewImageFromImageWithOptions(sourceImage, &ebiten.NewImageFromImageOptions{Unmanaged: true})
      57            1 :         t.Source = sourceImage
      58            1 :         return nil
      59              : }
      60              : 
      61              : // SpriteSheet は画像ファイルであるテクスチャと、その位置ごとの解釈であるスプライトのマッピング
      62              : type SpriteSheet struct {
      63              :         // スプライトシートのキー名
      64              :         Name string
      65              :         // 読み込んだ画像データ
      66              :         Texture Texture `toml:"texture_image"`
      67              :         // 画像に含まれるスプライト辞書
      68              :         Sprites map[string]Sprite
      69              : }
      70              : 
      71              : // SpriteRender component
      72              : // コンポーネントはセーブ&ロード時のシリアライズが必要なので、ファイル類をそのまま保存できない
      73              : type SpriteRender struct {
      74              :         // スプライトシート名(画像データはResourcesから取得)
      75              :         SpriteSheetName string
      76              :         // スプライトキー名
      77              :         SpriteKey string
      78              :         // アニメーション用スプライトキー配列。空ならアニメーションなし
      79              :         AnimKeys []string
      80              :         // 描画順。小さい順に先に(下に)描画する
      81              :         Depth DepthNum
      82              :         // 3D で立てる形。空ならカメラを向く立て板
      83              :         Shape rawschema.SpriteShape
      84              :         // Draw options(実行時の描画オプション。serde対象外)
      85              :         Options ebiten.DrawImageOptions `json:"-"`
      86              : }
      87              : 
      88              : // DepthNum はオブジェクトの描画順。小さい値を先に描画する
      89              : type DepthNum int
      90              : 
      91              : const (
      92              :         // DepthNumFloor は床。最背面に表示する
      93              :         DepthNumFloor DepthNum = iota
      94              :         // DepthNumDecal は床の模様。例: 土のしみ、ワープホール。3D では立て板にせず地面に寝かせて描く
      95              :         DepthNumDecal
      96              :         // DepthNumRug は床に置く低いもの。例: 焚き火、開いた扉
      97              :         DepthNumRug
      98              :         // DepthNumTaller は高さのあるもの。例: テーブル、棚、閉じた扉、壁と虚空のタイル。高さのあるタイルは 3D で箱として描く
      99              :         DepthNumTaller
     100              :         // DepthNumItem は拾えるアイテム。テーブルのような高さのある置物と同じマスにあっても、その上に出す
     101              :         DepthNumItem
     102              :         // DepthNumPlayer は操作キャラを最も手前に表示する
     103              :         DepthNumPlayer
     104              : )
        

Generated by: LCOV version 2.0-1