本教程旨在指导开发者如何使用 Pygame 结合 SDL2 渲染单个像素。核心在于将 Pygame 的 Surface 对象转换为 SDL2 的 Texture 对象，并使用 `copy` 方法进行渲染。通过本文，你将学会正确使用 SDL2渲染，避免常见的 `TypeError: source must be drawable` 错误。
在使用 Pygame 进行游戏开发时，有时会希望利用 SDL2 提供的更底层渲染能力。直接使用 pygame.Surface 对象与 SDL2 的渲染器进行交互可能会遇到问题。本教程将详细介绍如何正确地使用 SDL2 渲染像素，并解决常见的错误。
渲染单个像素的正确方法
在使用 SDL2 渲染时，renderer.blit 方法通常需要的是一个 texture（纹理）而不是 surface（表面）。Pygame 的 pygame.Surface 对象并不直接兼容 SDL2 的渲染函数。要解决这个问题，需要将 pygame.Surface 转换为 texture。
以下是修改后的代码示例：
import pygame
import pygame._sdl2
SCREEN_W = 800
SCREEN_H = 800
pygame.init()
pygame_screen = pygame.display.set_mode((SCREEN_W, SCREEN_H), vsync=0, flags=pygame.SCALED)
window = pygame._sdl2.Window.from_display_module()
renderer = pygame._sdl2.Renderer.from_window(window)
renderer.draw_color = (0, 255, 0, 255) # Set the draw color to green
clock = pygame.time.Clock()
scale_factor = 1
# Create a green surface
green_pixel = pygame.Surface((scale_factor, scale_factor))
green_pixel.fill((0, 255, 0, 255))
# Convert the surface to a texture
green_pixel_texture = renderer.create_texture_from_surface(green_pixel)
use_sdl2 = True
while True:
msec = clock.tick(60)
pygame_screen.fill((0, 0, 0))
for event in pygame.event.get():
if event.type == pygame.QUIT:
pygame.quit()
quit()
if use_sdl2:
renderer.clear()
dest_rect = pygame.rect.Rect(100, 100, scale_factor, scale_factor)
renderer.copy(green_pixel_texture, dstrect=dest_rect) # Use copy instead of blit
renderer.present()
else:
dest_rect = pygame.rect.Rect(100, 100, scale_factor, scale_factor)
pygame_screen.blit(green_pixel, dest_rect)
pygame.display.flip()关键的修改在于：
- 将 Surface 转换为 Texture: 使用 renderer.create_texture_from_surface(green_pixel) 将 green_pixel Surface 对象转换为 green_pixel_texture Texture 对象。
- 使用 copy 方法: 使用 renderer.copy(green_pixel_texture, dstrect=dest_rect) 代替 renderer.blit(green_pixel, dest_rect)。copy 方法是 SDL2 中用于将纹理渲染到目标矩形区域的正确方法。
代码解释
- pygame._sdl2.Window.from_display_module(): 从 Pygame 显示模块获取 SDL2 窗口对象。
- pygame._sdl2.Renderer.from_window(window): 从 SDL2 窗口对象创建渲染器。
- renderer.create_texture_from_surface(green_pixel): 将 Pygame Surface 对象转换为 SDL2 Texture 对象。这是关键的一步，使得 Surface 对象可以被 SDL2 渲染器使用。
- renderer.copy(green_pixel_texture, dstrect=dest_rect): 将纹理复制到指定的矩形区域。dstrect 参数定义了目标矩形的位置和大小。
- renderer.present(): 将渲染结果呈现到屏幕上。
总结与注意事项
- 在使用 Pygame 的 SDL2 渲染器时，务必将 pygame.Surface 对象转换为 texture 对象。
- 使用 renderer.copy 方法进行纹理渲染，而不是 renderer.blit。
- 确保正确设置目标矩形（dest_rect）的位置和大小。
- renderer.present() 是将渲染结果显示到屏幕上的必要步骤。
通过遵循这些步骤，你就可以成功地使用 Pygame 和 SDL2 渲染像素或其他图形元素，并避免常见的类型错误。这种方法可以扩展到更复杂的渲染场景，为你提供更强大的控制和性能优化选项。
