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 : }
|