Tilemap

Tilemapは、タイルベースの2Dマップを効率的に表示するためのノードです。グリッド状にタイルを配置してマップを作成する機能を提供します。

作成

タイルのサイズを指定して生成します。

public class GameScene : Scene
{
    public override void OnStart()
    {
        // 16x16ピクセルのタイルサイズでタイルマップを作成
        var tilemap = new Tilemap(tileSize: (16, 16));

        // テクスチャからタイルを作成
        var grassTexture = Window.TextureFactory.Load("assets/grass.png");
        var grassTile = new Tile(grassTexture);

        // タイルを配置
        tilemap.SetTile(0, 0, grassTile);
        tilemap.SetTile(1, 0, grassTile);
        tilemap.SetTile(0, 1, grassTile);

        Root.Add(tilemap);
    }
}

インデクサーを使った、タイルの取得/設定

var tilemap = new Tilemap((16, 16));
var tile = new Tile(texture);

// タイルの設定
tilemap[0, 0] = tile;
tilemap[1, 1] = tile;

// Vector型でも指定可能
tilemap[(2, 2)] = tile;

// タイルの取得
var tileAt = tilemap[0, 0];

// タイルの削除
tilemap[0, 0] = null;

線・矩形の描画

直線・矩形状にタイルを設置するメソッドがあります。

var tilemap = new Tilemap((16, 16));
var wallTile = new Tile(wallTexture);

// 線の描画
tilemap.Line(0, 0, 10, 10, wallTile);

// 矩形の描画
tilemap.Fill(5, 5, 15, 10, wallTile);

タイルの種類

基本的なタイル

// 単一テクスチャのタイル
var texture = Window.TextureFactory.Load("assets/stone.png");
var stoneTile = new Tile(texture);

// タイルを配置
tilemap.SetTile(x, y, stoneTile);

アニメーションタイル

// アニメーション用テクスチャを読み込み
var frame1 = Window.TextureFactory.Load("assets/water_1.png");
var frame2 = Window.TextureFactory.Load("assets/water_2.png");
var frame3 = Window.TextureFactory.Load("assets/water_3.png");

// アニメーションタイルを作成（0.5秒間隔でアニメーション）
var waterTile = new Tile([frame1, frame2, frame3], 0.5f);

// アニメーションタイルを配置
tilemap.SetTile(x, y, waterTile);

色付きタイル

タイルに色を重ねて表示できます：

var baseTile = new Tile(texture);

// 赤みがかったタイル
tilemap.SetTile(x, y, baseTile, Color.Red);

// 半透明のタイル
tilemap.SetTile(x, y, baseTile, Color.FromArgb(128, 255, 255, 255));

// デフォルト色を設定
tilemap.DefaultColor = Color.LightBlue;
tilemap.SetTile(x, y, baseTile); // デフォルト色が適用される

タイルマップのプロパティ

タイルサイズ

// 作成時に指定
var tilemap = new Tilemap(tileSize: (32, 32));

// 後から変更
tilemap.TileSize = (16, 16);

レンダリングモード

タイルマップの描画方法を制御できます。この設定は基本的に弄る必要がありません。

// 自動最適化（デフォルト）
tilemap.RenderingMode = TilemapRenderingMode.Auto;

// 全タイルを常に描画
tilemap.RenderingMode = TilemapRenderingMode.RenderAll;

// 画面内のタイルのみ描画
tilemap.RenderingMode = TilemapRenderingMode.Scan;