Pygame中滚动地形的实现与像素缠绕问题的解决

import pygame as py
import random as r

# --- 常量定义 (遵循PEP 8命名规范) ---
SCREEN_WIDTH = 512
SCREEN_HEIGHT = 512
TILE_SIZE = 16
BACKGROUND_COLOR = (175, 215, 225) # 天空蓝
TERRAIN_COLOR = (0, 100, 20)      # 绿色地形

# --- 辅助函数 ---
def scroll_x(screen_surf, offset_x):
    """
    实现屏幕内容的水平滚动，并填充新暴露的区域。

    参数:
        screen_surf (pygame.Surface): 待滚动的Surface对象 (通常是主显示Surface)。
        offset_x (int): 水平滚动偏移量。负值表示向左滚动，正值表示向右滚动。
    """
    width, height = screen_surf.get_size()

    # 复制当前屏幕内容，避免直接在原Surface上操作导致问题
    copy_surf = screen_surf.copy()

    # 将复制的内容平移到新位置
    screen_surf.blit(copy_surf, (offset_x, 0))

    # 根据滚动方向，填充新暴露的区域
    if offset_x < 0:
        # 向左滚动，右侧暴露区域需要填充
        # 填充矩形区域: (x, y, width, height)
        # x: 屏幕宽度 + 偏移量 (例如 512 + (-16) = 496)
        # y: 0
        # width: 屏幕宽度 (实际上是 abs(offset_x))
        # height: 屏幕高度
        screen_surf.fill(BACKGROUND_COLOR, (width + offset_x, 0, abs(offset_x), height))
    else:
        # 向右滚动，左侧暴露区域需要填充
        # 填充矩形区域: (0, 0, offset_x, height)
        screen_surf.fill(BACKGROUND_COLOR, (0, 0, offset_x, height))

# --- 主程序逻辑 ---
def main():
    py.init()

    display = py.display.set_mode((SCREEN_WIDTH, SCREEN_HEIGHT))
    py.display.set_caption("Pygame 滚动地形示例")
    display.fill(BACKGROUND_COLOR) # 初始化背景

    clock = py.time.Clock()

    # 模拟地形高度，以TILE_SIZE为单位
    # 假设屏幕宽度是32个TILE_SIZE (512 / 16 = 32)
    # 我们需要一个数组来存储每一列的地形高度
    # 初始地形可以随机生成或预设
    terrain_heights = [SCREEN_HEIGHT // TILE_SIZE - 5] * (SCREEN_WIDTH // TILE_SIZE) # 初始地形为平坦地面

    running = True
    while running:
        for event in py.event.get():
            if event.type == py.QUIT:
                running = False
            if event.type == py.KEYDOWN:
                if event.key == py.K_ESCAPE:
                    running = False

        # 模拟地形高度变化
        # 每次向左滚动一格，最右侧需要生成新的地形数据
        # 模拟一个简单的随机地形变化
        last_height = terrain_heights[-1]

        # 随机生成下一个地形块的高度变化
        # 可以在前一个高度的基础上进行微调，确保地形平滑
        delta_height = r.choice([-1, 0, 1]) # 高度变化量
        new_height = last_height + delta_height

        # 限制地形高度在合理范围内
        if new_height < 0: # 避免地形低于屏幕顶部
            new_height = 0
        if new_height > SCREEN_HEIGHT // TILE_SIZE - 1: # 避免地形高于屏幕底部（留出顶部空间）
            new_height = SCREEN_HEIGHT // TILE_SIZE - 1

        # 滚动屏幕
        offset_x = -TILE_SIZE # 每次向左滚动一格
        scroll_x(display, offset_x)

        # 更新地形数据：移除最左侧一列，在最右侧添加新生成的高度
        terrain_heights.pop(0)
        terrain_heights.append(new_height)

        # 绘制所有地形块
        for i, height_in_tiles in enumerate(terrain_heights):
            # 计算地形块的像素位置和大小
            # terrain_y_pixel = height_in_tiles * TILE_SIZE
            # terrain_height_pixel = SCREEN_HEIGHT - terrain_y_pixel

            # 绘制矩形 (left, top, width, height)
            # x坐标是列索引 * TILE_SIZE
            # y坐标是地形块顶部，从屏幕底部向上计算
            # 矩形高度是从地形块顶部到屏幕底部
            py.draw.rect(display, TERRAIN_COLOR, 
                         py.Rect(i * TILE_SIZE, height_in_tiles * TILE_SIZE, 
                                 TILE_SIZE, SCREEN_HEIGHT - height_in_tiles * TILE_SIZE))

        py.display.flip() # 更新整个屏幕显示

        clock.tick(4) # 控制帧率，每秒4帧，模拟原例中的0.25秒延迟

    py.quit()

if __name__ == "__main__":
    main()