### pygame `set_mode` 方法详解 在 Pygame 中，`pygame.display.set_mode()` 是用于创建显示窗口的核心函数之一。该方法返回一个 Surface 对象，表示游戏的主要绘图区域[^1]。 #### 函数签名 以下是 `set_mode` 的基本语法： ```python screen = pygame.display.set_mode(size=(width, height), flags=0, depth=0, display=0) ``` - **size**: 这是一个元组 `(width, height)`，定义了窗口的宽度和高度（单位为像素）。如果未指定，则默认大小由操作系统决定。 - **flags**: 可选参数，控制屏幕模式的行为。常见的标志位有 `pygame.FULLSCREEN`, `pygame.RESIZABLE`, 和 `pygame.NOFRAME` 等[^2]。 - **depth**: 表示颜色深度（比特数），通常可以忽略，默认会自动匹配系统的最佳设置。 - **display**: 指定显示器编号，在多屏环境下有效；一般情况下无需修改。 #### 返回值 此方法返回一个 Surface 对象，代表新创建的游戏窗口表面。所有的绘制操作都将在这个表面上完成。 #### 示例代码 下面展示如何使用 `set_mode` 创建不同类型的窗口： ##### 基础用法 最简单的调用方式如下所示： ```python import pygame pygame.init() # 设置 800x600 大小的窗口 screen = pygame.display.set_mode((800, 600)) while True: for event in pygame.event.get(): if event.type == pygame.QUIT: pygame.quit() exit() screen.fill((0, 0, 0)) # 清屏并填充黑色背景 pygame.display.flip() # 更新整个窗口的内容到屏幕上 ``` ##### 全屏模式 通过传递 `pygame.FULLSCREEN` 标志来启用全屏功能： ```python screen = pygame.display.set_mode((0, 0), pygame.FULLSCREEN) ``` 这里 `(0, 0)` 表示采用当前显示器的最大分辨率作为窗口尺寸[^3]。 ##### 不带边框的窗口 若希望移除窗口周围的装饰（如标题栏和关闭按钮），可传入 `pygame.NOFRAME` 参数： ```python screen = pygame.display.set_mode((400, 300), pygame.NOFRAME) ``` ##### 支持调整大小 允许用户手动改变窗口大小时需加入 `pygame.RESIZABLE` 标记： ```python screen = pygame.display.set_mode((640, 480), pygame.RESIZABLE) running = True while running: for event in pygame.event.get(): if event.type == pygame.VIDEORESIZE: # 当检测到视频重设事件时更新surface对象 screen = pygame.display.set_mode(event.dict['size'], pygame.RESIZABLE) elif event.type == pygame.QUIT: running = False screen.fill(pygame.Color('white')) pygame.display.flip() pygame.quit() ``` 以上即为关于 `pygame.display.set_mode` 方法较为全面的功能介绍及其实际应用案例[^4]。