Skip to content

A fast 2D and 3D game engine — TypeScript SDK, C++/WebAssembly core, visual editor. Ship one project to web, desktop, WeChat MiniGames, playable ads, and native Android / iOS.

test(tilemap): multi-tileset Tiled pixel verify — two tilesets, four exact-color points

yhhfc2244b03844
diff --git a/desktop/package.json b/desktop/package.json
index a7d782a8e..6a3f47cf3 100644
--- a/desktop/package.json
+++ b/desktop/package.json
@@ -33,6 +33,7 @@
"verify:render:filled": "vite build && ESTELLA_VERIFY_SCENE=/scenes/ui-visual-filled.esscene ESTELLA_VERIFY_MANIFEST=/scenes/ui-visual-filled.textures.json ESTELLA_VERIFY_W=800 ESTELLA_VERIFY_H=600 ESTELLA_VERIFY_STEPS=2 ESTELLA_VERIFY_EXPECT=\"[{\\\"x\\\":0.18,\\\"y\\\":0.5,\\\"rgb\\\":[0,255,0],\\\"tol\\\":40},{\\\"x\\\":0.40,\\\"y\\\":0.5,\\\"rgb\\\":[255,0,0],\\\"tol\\\":40},{\\\"x\\\":0.58,\\\"y\\\":0.75,\\\"rgb\\\":[0,255,0],\\\"tol\\\":40},{\\\"x\\\":0.58,\\\"y\\\":0.25,\\\"rgb\\\":[255,0,0],\\\"tol\\\":40},{\\\"x\\\":0.30,\\\"y\\\":0.20,\\\"rgb\\\":[0,255,0],\\\"tol\\\":40},{\\\"x\\\":0.20,\\\"y\\\":0.333,\\\"rgb\\\":[255,0,0],\\\"tol\\\":40},{\\\"x\\\":0.30,\\\"y\\\":0.833,\\\"rgb\\\":[0,255,0],\\\"tol\\\":40},{\\\"x\\\":0.20,\\\"y\\\":0.70,\\\"rgb\\\":[255,0,0],\\\"tol\\\":40}]\" electron scripts/headless-verify.mjs",
"verify:render:tilemap": "vite build && ESTELLA_VERIFY_SCENE=/scenes/tilemap-flip.esscene ESTELLA_VERIFY_MANIFEST=/scenes/tilemap-flip.textures.json ESTELLA_VERIFY_W=256 ESTELLA_VERIFY_H=256 ESTELLA_VERIFY_STEPS=2 ESTELLA_VERIFY_EXPECT=\"[{\\\"x\\\":0.40,\\\"y\\\":0.36,\\\"rgb\\\":[255,0,0]},{\\\"x\\\":0.60,\\\"y\\\":0.36,\\\"rgb\\\":[0,255,0]},{\\\"x\\\":0.40,\\\"y\\\":0.58,\\\"rgb\\\":[0,0,255]},{\\\"x\\\":0.60,\\\"y\\\":0.58,\\\"rgb\\\":[255,255,0]}]\" electron scripts/headless-verify.mjs",
"verify:render:tilemap:transform": "vite build && ESTELLA_VERIFY_SCENE=/scenes/tilemap-transform.esscene ESTELLA_VERIFY_MANIFEST=/scenes/tilemap-transform.textures.json ESTELLA_VERIFY_W=256 ESTELLA_VERIFY_H=256 ESTELLA_VERIFY_STEPS=2 ESTELLA_VERIFY_EXPECT=\"[{\\\"x\\\":0.40,\\\"y\\\":0.36,\\\"rgb\\\":[255,255,0]},{\\\"x\\\":0.60,\\\"y\\\":0.36,\\\"rgb\\\":[0,255,0]},{\\\"x\\\":0.40,\\\"y\\\":0.58,\\\"rgb\\\":[0,0,255]},{\\\"x\\\":0.60,\\\"y\\\":0.58,\\\"rgb\\\":[255,0,0]}]\" electron scripts/headless-verify.mjs",
+ "verify:render:tilemap:multiset": "vite build && ESTELLA_VERIFY_SCENE=/scenes/tilemap-multiset.esscene ESTELLA_VERIFY_MANIFEST=/scenes/tilemap-multiset.textures.json ESTELLA_VERIFY_W=256 ESTELLA_VERIFY_H=256 ESTELLA_VERIFY_STEPS=6 ESTELLA_VERIFY_EXPECT=\"[{\\\"x\\\":0.40,\\\"y\\\":0.36,\\\"rgb\\\":[255,0,0]},{\\\"x\\\":0.60,\\\"y\\\":0.36,\\\"rgb\\\":[0,255,0]},{\\\"x\\\":0.40,\\\"y\\\":0.58,\\\"rgb\\\":[0,0,255]},{\\\"x\\\":0.60,\\\"y\\\":0.58,\\\"rgb\\\":[255,255,0]}]\" electron scripts/headless-verify.mjs",
"verify:render:material": "vite build && ESTELLA_VERIFY_SCENE=/scenes/mat-tint.esscene ESTELLA_VERIFY_MANIFEST=/scenes/mat-tint.textures.json ESTELLA_VERIFY_W=256 ESTELLA_VERIFY_H=256 ESTELLA_VERIFY_STEPS=2 ESTELLA_VERIFY_EXPECT=\"[{\\\"x\\\":0.5,\\\"y\\\":0.5,\\\"rgb\\\":[255,0,0],\\\"tol\\\":40}]\" electron scripts/headless-verify.mjs",
"verify:render:ktx2": "vite build && ESTELLA_VERIFY_SCENE=/scenes/ktx2-sprite.esscene ESTELLA_VERIFY_MANIFEST=/scenes/ktx2-sprite.textures.json ESTELLA_VERIFY_W=256 ESTELLA_VERIFY_H=256 ESTELLA_VERIFY_STEPS=2 ESTELLA_VERIFY_EXPECT=\"[{\\\"x\\\":0.5,\\\"y\\\":0.5,\\\"rgb\\\":[0,180,0],\\\"tol\\\":50}]\" electron scripts/headless-verify.mjs",
"verify:render:cooked": "vite build && ESTELLA_COOK_FIXTURE=1 vitest run tests/cooked-verify-fixture.test.ts && electron scripts/headless-cooked-verify.mjs",
diff --git a/desktop/public/scenes/tilemap-multiset.esscene b/desktop/public/scenes/tilemap-multiset.esscene
new file mode 100644
index 000000000..3588090f5
--- /dev/null
+++ b/desktop/public/scenes/tilemap-multiset.esscene
@@ -0,0 +1,28 @@
+{
+ "version": "1.0",
+ "name": "TilemapMultiset",
+ "entities": [
+ {
+ "id": 0,
+ "name": "Camera",
+ "parent": null,
+ "children": [],
+ "components": [
+ { "type": "Transform", "data": { "position": { "x": 16, "y": -16, "z": 10 } } },
+ { "type": "Camera", "data": { "projectionType": 1, "orthoSize": 40, "isActive": true, "priority": 0 } }
+ ],
+ "visible": true
+ },
+ {
+ "id": 1,
+ "name": "Tilemap",
+ "parent": null,
+ "children": [],
+ "components": [
+ { "type": "Transform", "data": { "position": { "x": 0, "y": 0, "z": 0 } } },
+ { "type": "Tilemap", "data": { "source": "/scenes/tilemap-multiset/map.tmj" } }
+ ],
+ "visible": true
+ }
+ ]
+}
diff --git a/desktop/public/scenes/tilemap-multiset.textures.json b/desktop/public/scenes/tilemap-multiset.textures.json
new file mode 100644
index 000000000..0967ef424
--- /dev/null
+++ b/desktop/public/scenes/tilemap-multiset.textures.json
@@ -0,0 +1 @@
+{}
diff --git a/desktop/public/scenes/tilemap-multiset/a.png b/desktop/public/scenes/tilemap-multiset/a.png
new file mode 100644
index 000000000..3f9167c5d
Binary files /dev/null and b/desktop/public/scenes/tilemap-multiset/a.png differ
diff --git a/desktop/public/scenes/tilemap-multiset/b.png b/desktop/public/scenes/tilemap-multiset/b.png
new file mode 100644
index 000000000..f103d37f0
Binary files /dev/null and b/desktop/public/scenes/tilemap-multiset/b.png differ
diff --git a/desktop/public/scenes/tilemap-multiset/map.tmj b/desktop/public/scenes/tilemap-multiset/map.tmj
new file mode 100644
index 000000000..9eb7682ef
--- /dev/null
+++ b/desktop/public/scenes/tilemap-multiset/map.tmj
@@ -0,0 +1,46 @@
+{
+ "type": "map",
+ "version": "1.10",
+ "orientation": "orthogonal",
+ "renderorder": "right-down",
+ "width": 2,
+ "height": 2,
+ "tilewidth": 16,
+ "tileheight": 16,
+ "infinite": false,
+ "layers": [
+ {
+ "type": "tilelayer",
+ "name": "main",
+ "width": 2,
+ "height": 2,
+ "visible": true,
+ "opacity": 1,
+ "data": [1, 2, 3, 4]
+ }
+ ],
+ "tilesets": [
+ {
+ "firstgid": 1,
+ "name": "a",
+ "image": "a.png",
+ "imagewidth": 32,
+ "imageheight": 16,
+ "tilewidth": 16,
+ "tileheight": 16,
+ "columns": 2,
+ "tilecount": 2
+ },
+ {
+ "firstgid": 3,
+ "name": "b",
+ "image": "b.png",
+ "imagewidth": 32,
+ "imageheight": 16,
+ "tilewidth": 16,
+ "tileheight": 16,
+ "columns": 2,
+ "tilecount": 2
+ }
+ ]
+}
diff --git a/src/esengine/renderer/plugins/TilemapRenderPlugin.cpp b/src/esengine/renderer/plugins/TilemapRenderPlugin.cpp
index 68571519c..f84c3c55d 100644
--- a/src/esengine/renderer/plugins/TilemapRenderPlugin.cpp
+++ b/src/esengine/renderer/plugins/TilemapRenderPlugin.cpp
@@ -139,10 +139,11 @@ void TilemapRenderPlugin::collect(RenderCollectContext& collect_ctx) {
f32 camTop = tr.y / tr.w;
for (const auto& [entity, layer] : layers) {
- // RC2a: the TilemapLayer component is the single source of a painted
- // layer's visual metadata — the renderer reads it live each frame (so
- // animated tint/opacity need no sync). Tiled-imported synthetic layers
- // have no component and still carry their metadata in LayerData.
+ // The TilemapLayer component is the single source of a layer's visual
+ // metadata — the renderer reads it live each frame (so animated
+ // tint/opacity need no sync). Every scene-driven layer has one (Tiled
+ // imports project REAL child entities); only a code-driven TilemapAPI
+ // layer without a component entity still reads LayerData metadata.
const ecs::TilemapLayer* comp = registry.tryGet<ecs::TilemapLayer>(entity);
bool visible;