Pygame中精灵无法显示求助：多边形与矩形精灵仅显示黑屏

问题分析与修复步骤 #

1. 修正Terrain多边形的相对坐标 #

Terrain类中定义的points使用了屏幕绝对坐标，但绘制操作是在精灵自身的Surface上进行，必须使用相对于Surface左上角(0,0)的坐标。原坐标超出了Surface的范围（Surface尺寸为(200,100)），导致多边形完全绘制在Surface之外，无法显示。

将Terrain类的points修改为相对坐标：

points = [(0, 0), (100, 100), (200, 0), (0, 0)]

2. 优化Star类的矩形绘制参数 #

Star类中使用self.rect作为绘制区域，容易和精灵在屏幕上的位置矩形混淆，建议显式指定相对Surface的绘制区域，代码更清晰：

pygame.draw.rect(self.image, WHITE, (0, 0, *size))

3. 主循环中统一清除屏幕 #

主循环开始时应固定填充背景色，避免画面残留或混乱，原代码仅在碰撞时填充屏幕，会导致非碰撞帧的画面异常。

4. 修正碰撞检测的偏移参数 #

mask.overlap的第二个参数是目标精灵相对于当前精灵的位置偏移，原代码传入固定坐标是错误的，需计算两个精灵rect的相对位置差：

offset = (star.rect.x - terrain.rect.x, star.rect.y - terrain.rect.y)
collision = terrain.mask.overlap(star.mask, offset)

修改后的完整代码 #

import pygame

# Initialize Pygame
pygame.init()

# Colors
WHITE = (255, 255, 255)
RED = (255, 0, 0)
BLACK = (0, 0, 0)


class Terrain(pygame.sprite.Sprite):
    # 使用相对于Surface的坐标
    points = [(0, 0), (100, 100), (200, 0), (0, 0)]

    def __init__(self, size, pos):
        pygame.sprite.Sprite.__init__(self)

        # create transparent background image
        self.image = pygame.Surface(size, pygame.SRCALPHA, 32)
        self.rect = self.image.get_rect()
        self.rect.topleft = pos

        pygame.draw.polygon(self.image, RED, self.points)

        # Create the collision mask (anything not transparent)
        self.mask = pygame.mask.from_surface(self.image)

    def update(self):
        pygame.draw.polygon(self.image, RED, self.points)


class Star(pygame.sprite.Sprite):
    def __init__(self, size, pos):
        pygame.sprite.Sprite.__init__(self)

        # create transparent background image
        self.image = pygame.Surface(size, pygame.SRCALPHA, 32)
        self.rect = self.image.get_rect()
        self.rect.topleft = pos

        # 显式指定相对Surface的绘制区域
        pygame.draw.rect(self.image, WHITE, (0, 0, *size))

        # Create the collision mask (anything not transparent)
        self.mask = pygame.mask.from_surface(self.image)

    def update(self):
        pygame.draw.rect(self.image, WHITE, (0, 0, *self.rect.size))


# Screen size
screen_width = 800
screen_height = 600
screen = pygame.display.set_mode((screen_width, screen_height))
pygame.display.set_caption("Collision Detection")

clock = pygame.time.Clock()

terrain = Terrain((200, 100), (100, 100))
star = Star((10, 10), (120, 111))

running = True
while running:
    for event in pygame.event.get():
        if event.type == pygame.QUIT:
            running = False

    # 每次循环先清除屏幕
    screen.fill(BLACK)

    # 计算正确的碰撞偏移：star相对于terrain的位置差
    offset = (star.rect.x - terrain.rect.x, star.rect.y - terrain.rect.y)
    collision = terrain.mask.overlap(star.mask, offset)

    if collision:
        # 如果碰撞，填充白色背景（可选，用于测试）
        screen.fill(WHITE)

    screen.blit(terrain.image, terrain.rect)
    screen.blit(star.image, star.rect)

    pygame.display.update()
    clock.tick(60)

pygame.quit()

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