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