如何在pytmx中正确处理Tiled地图瓦片的旋转显示问题

问题原因 #

Tiled中瓦片的旋转、翻转属性是编码在瓦片GID的高位标志位中的，pytmx的tiles()方法默认仅返回未做任何变换的原始瓦片图像，不会自动解析处理这些变换标志，因此绘制出来的瓦片全部保持原始角度，和编辑器效果不一致。

Tiled编辑器中效果：

原始代码运行效果：

解决方法 #

需要手动解码每个瓦片的GID获取变换参数，再对原始图像做对应的翻转、旋转处理后再用于绘制。

修改后的代码示例 #

from pytmx import decode_gid
import pygame

# 原有加载代码不变
tiled_map = pytmx.util_pygame.load_pygame(f"mymap.tmx")
tile_list = []
tile_group = pygame.sprite.Group()
tile_layer = tiled_map.get_layer_by_name("tiles")

tw = tiled_map.tilewidth
th = tiled_map.tileheight

# 遍历图层所有瓦片坐标
for y in range(tile_layer.height):
    for x in range(tile_layer.width):
        # 获取当前坐标的GID并解码
        gid = tile_layer.data[y][x]
        if gid == 0:
            continue  # 空瓦片跳过
        real_gid, h_flip, v_flip, d_flip = decode_gid(gid)
        
        # 获取原始瓦片图像
        raw_image = tiled_map.get_tile_image_by_gid(real_gid)
        processed_img = raw_image.copy()
        
        # 应用变换
        if h_flip:
            processed_img = pygame.transform.flip(processed_img, True, False)
        if v_flip:
            processed_img = pygame.transform.flip(processed_img, False, True)
        if d_flip:
            # 对角线翻转对应顺时针旋转90度，可根据实际效果调整旋转方向
            processed_img = pygame.transform.rotate(processed_img, -90)
        
        # 创建瓦片实例，坐标不变
        tile = Tile(x * tw, y * th, image=processed_img)
        tile_group.add(tile)
        tile_list.append(tile)

# 后续绘制逻辑不变
for tile in tile_list:
    sur.blit(tile.image, (tile.x, tile.y))

注意事项 #

• 若你使用的瓦片不是正方形，旋转后瓦片宽高会发生变化，需要额外计算绘制偏移量避免位置错位
• 建议对变换后的瓦片图像做缓存，避免重复执行变换操作，提升地图加载性能

内容的提问来源于stack exchange，提问作者Mattlau04