Pygame 核心常用函数 / 模块汇总pygame 基于模块组织功能先初始化pygame.init()所有示例为标准写法。一、基础全局import pygame # 引入pygame pygame.init() # 初始化所有模块最开头必写 pygame.quit() # 卸载pygame退出前调用 pygame.get_init() # 判断是否初始化完成二、窗口 / 显示模块pygame.display# 创建窗口返回画布Surface screen pygame.display.set_mode((宽,高)) # 设置窗口标题 pygame.display.set_caption(游戏窗口) # 更新画面局部刷新/全局刷新 pygame.display.flip() # 整个屏幕刷新 pygame.display.update() # 可传矩形局部刷新性能更好 # 获取窗口尺寸 pygame.display.get_surface()三、Surface 画布图像、屏幕都属于 Surface# 创建空白画布 surf pygame.Surface((w,h)) # 贴图 blit【你高频用到】 screen.blit(素材, (x,y)) # 填充颜色 surf.fill((R,G,B)) # 获取像素/裁剪 surf.get_rect() # 获取包围矩形Rect极其常用 surf.subsurface(rect) # 截取图片一部分四、矩形类pygame.Rect碰撞、坐标核心# 创建矩形Rect(x,y,w,h) rect pygame.Rect(10,10,50,50) # 属性x,y,top,left,bottom,right,center,centerx,centery rect.center (200,200) # 碰撞检测 rect1.colliderect(rect2) # 矩形碰撞 返回True/False rect.collidepoint(x,y) # 点是否在矩形内五、事件模块pygame.event游戏循环监听按键、鼠标、关闭窗口# 获取所有事件队列 for event in pygame.event.get(): if event.type pygame.QUIT: # 点击窗口关闭 pygame.quit() if event.type pygame.KEYDOWN: # 按键按下 event.key # 获取按键 if event.type pygame.MOUSEBUTTONDOWN: #鼠标点击持续按键检测不在事件循环内keys pygame.key.get_pressed() if keys[pygame.K_w]: 向上移动六、键盘pygame.keypygame.key.get_pressed() # 获取所有按键实时状态适合持续移动 pygame.key.get_mods() # Ctrl/Shift/Alt 组合键常用按键常量pygame.K_w K_a K_s K_d K_ESCAPE K_SPACE七、鼠标pygame.mousemx, my pygame.mouse.get_pos() # 获取鼠标坐标 pressed pygame.mouse.get_pressed() # (左键,中键,右键) pygame.mouse.set_visible(False) # 隐藏鼠标光标八、图像加载pygame.imageimg pygame.image.load(图片路径.png).convert_alpha() # convert()普通图片convert_alpha()支持透明PNG九、文字渲染pygame.fontpygame.font.init() # 创建字体对象 font pygame.font.SysFont(simhei,30) # 渲染文字生成Surface text_surf font.render(文字内容, True, (255,255,255)) screen.blit(text_surf, (x,y))十、时钟控制帧率pygame.time控制游戏速度clock pygame.time.Clock() # 循环内调用限制最大帧率 clock.tick(60) # 锁定60帧 pygame.time.delay(ms) # 延时阻塞不推荐游戏主循环十一、音效pygame.mixerpygame.mixer.init() sound pygame.mixer.Sound(sound.wav) sound.play() # 背景音乐 bgm pygame.mixer.music.load(bgm.mp3) pygame.mixer.music.play(-1) # -1循环播放十二、绘图函数直接画图形到 Surface# 画线 pygame.draw.line(screen,颜色,起点,终点,宽度) # 矩形 pygame.draw.rect(screen,颜色,rect,边线宽度,0填充) # 圆形 pygame.draw.circle(screen,颜色,圆心,半径) # 椭圆、多边形 pygame.draw.ellipse() pygame.draw.polygon()最简标准游戏框架整合所有核心用法import pygame pygame.init() SCREEN_W, SCREEN_H 800, 600 screen pygame.display.set_mode((SCREEN_W, SCREEN_H)) pygame.display.set_caption(Pygame示例) clock pygame.time.Clock() running True while running: # 事件处理 for event in pygame.event.get(): if event.type pygame.QUIT: running False # 持续按键 keys pygame.key.get_pressed() # 绘制 screen.fill((30,30,30)) # 更新画面 pygame.display.update() clock.tick(60) pygame.quit()
