Phaser游戏引擎中TiledImageCollection的尺寸问题解析与优化

问题背景

在使用Phaser 3.87.0游戏引擎加载Tiled地图编辑器创建的图块地图时，开发者发现当使用ImageCollection（图像集合）且集合中的图像尺寸不一致时，引擎会错误地将所有图块集(tileset)的尺寸统一设置为集合中最大图像的尺寸，而不是保留每个图块的实际尺寸。

技术细节分析

在Tiled地图编辑器的JSON格式中，每个图块都明确指定了自己的尺寸属性：

• imagewidth：图块的实际宽度
• imageheight：图块的实际高度

然而Phaser的TiledImageCollection实现存在以下问题：

1. 在创建图像集合时，没有考虑每个图块的独立尺寸
2. 构建图块集索引时，统一使用了集合的最大尺寸而非单个图块的实际尺寸
3. 这导致渲染时图块定位和尺寸计算出现偏差

问题表现

开发者提供的示例清晰地展示了这个问题：

• 在Tiled编辑器中正确显示的不同尺寸图块
• 在Phaser中渲染时出现错位和尺寸不匹配
• 控制台出现关于图像尺寸不匹配的警告

解决方案

Phaser团队已经针对此问题进行了修复，主要改进包括：

1. 修改imagecollection.addimage方法，使其能够接收并处理每个图块的独立尺寸参数
2. 优化phaser.tilemaps.parsers.tiled.buildtilesetindex方法，使用单个图块的实际尺寸而非集合的统一尺寸
3. 确保图块索引构建过程正确处理不同尺寸的图块

技术实现建议

对于需要处理不同尺寸图块的开发者，建议：

1. 确保Tiled地图中每个图块都正确设置了imagewidth和imageheight
2. 在加载图块时，验证每个图块的尺寸是否被正确识别
3. 对于自定义图块集，考虑实现尺寸适配逻辑

总结

Phaser对TiledImageCollection的这次优化，显著提升了引擎对不同尺寸图块集的支持能力，使开发者能够更灵活地使用Tiled地图编辑器创建多样化的游戏场景。这一改进将在Phaser的下一个版本中正式发布。