pygame模块参数汇总(python游戏编程)

一、HelloWorld

 pygame.init()     #初始函数，使用pygame的第一步；

 pygame.display.set_mod((600,500)，0，32)     #生成主屏幕screen；第一个参数是屏幕大小，第二个0表示不使用特性，可用FULLSCREEN,RESIZEBLE,NOFRAME,DOUBLEBUF(双缓冲，使用时需用pygame.display.flip()来刷新屏幕)等替换，32表示色深；

 pygame.display.set_caption("string")     #命名

 pygame.display.update()        #刷新

 pygame.display.list_modes()        #查看本地显示器支持的分辨率；

 screen.fill(0,0,0)        #填充

二、绘图

pygame.draw.rect(surface,color,Rect,width=0) 画一个矩形，Rect为两个坐标元组的元组；

（一）rect(矩形）参数属性

 r.left         左边x坐标的整数值

 r.right        右边x坐标的整数值

 r.top        　顶部y坐标的整数值

 r.bottom    　 底部y坐标的整数值

 r.centerx      中央x坐标整数值

 r.centery      中央y坐标整数值

 r.width        宽度

 r.height       高度

 r.size         即元组（width,height)

 r.topleft      (left,top)

 r.topright     (right,top)

 r.bottomleft   (left,bottom)

 r.bottomright  (right,bottom)

 r.midleft      (left,centery)

 r.midright     (right,centery)

 r.midtop       (centerx,top)

 r.midbottom    (centerx,bottom)

（二）其他形状

 pygame.draw.polygon(surface,color,pointlist,width=0) 　 　多边形

 pygame.draw.circle(surface,color,pos,radius,width=0)      圆

 pygame.draw.ellipse(surface,color,Rect,width=0)    　　   椭圆

 pygame.draw.arc(surface,color,Rect,start_angle,stop_angle,width=1) 圆弧

 pygame.draw.line(surface,color,start_pos,end_pos,width=1) 　　　直线；

 pygame.draw.lines(surface,color,closed,pointlist,width=1) 　　  closed为一bool值，表示是否封闭；

 pygame.draw.aaline(surface,color,start_pos,end_pos,width=1)    一根平滑的线;

 pygame.draw.aalines(surface,color,closed,pointlist,width=1)    一系列平滑的线;

Normal
0

7.8 磅
0
2

false
false
false

EN-US
ZH-CN
X-NONE

/* Style Definitions */
table.MsoNormalTable
{mso-style-name:普通表格;
mso-tstyle-rowband-size:0;
mso-tstyle-colband-size:0;
mso-style-noshow:yes;
mso-style-priority:99;
mso-style-parent:"";
mso-padding-alt:0cm 5.4pt 0cm 5.4pt;
mso-para-margin:0cm;
mso-para-margin-bottom:.0001pt;
mso-pagination:widow-orphan;
font-size:10.5pt;
mso-bidi-font-size:11.0pt;
font-family:等线;
mso-ascii-font-family:等线;
mso-ascii-theme-font:minor-latin;
mso-fareast-font-family:等线;
mso-fareast-theme-font:minor-fareast;
mso-hansi-font-family:等线;
mso-hansi-theme-font:minor-latin;
mso-font-kerning:1.0pt;}

（三）font(以图形模式输出文本)

1.pygame.font.Font("字体","字号"，*)

2.my_font.render(text,True,(255,255,255)) 使用已有的文本创建一个位图image，返回值为一个image;对于位图可用get_height(),get_width()的方法获得高与宽；True表示是否抗锯齿，第三个为字体颜色，还可以有第四个为背景色，没有时就为默认的透明；

3.Font（）　　使用的是字体文件，要使用系统中的字体需用SysFont()，但一些中文扩展的字体不是很好用。

4.screen.blit(image,(100,100)) 将位图绘制到屏幕上，screen为建立的主屏；

5.pygame.font.get_fonts() 查看当前系统所有可使用的字体

Normal
0

7.8 磅
0
2

false
false
false

EN-US
ZH-CN
X-NONE

三、图片处理

pygame支持的图片格式有：JPEG,PNG,GIF,BMP,PCX,TGA,TIF,LBM,PBM,XPM

 pygame.image.load("图片路径").conver()        将图片处理为surface对象，如果使用conver_alpha()则保留了Alpha通道信息（可透明），使用时用blit()函数来添加到显示屏

 pygame.Surface((250,250),flags,depth)        创建一个surface对象，如果不指定尺寸则会创建和屏幕一样大小；flags为可选，有SRCALPHA(保留Alpha通道)、HWSURFACE(优化)两个选择，depth为色深；

 screen.subsurface((0,0),(80,80))        　　 子表面对象；

 screen.set_at(pos,color)                　　 设置一个像素的色彩；

 screen.get_at(pos)                    　　　　获取某一像素的色彩，不过此操作的反应比较慢；

 pygame.transform.scale(surface,(width//2,height//2)    缩放图片

 pygame.transform.smoothscale(surface,(width,height)    缩放图片，比scale慢，但效果更好；

 pygame.sprite.Group()        　　 精灵组，一个简单的实体容器；

 pygame.sprite.add(sprite)        添加精灵对象；

 pygame.sprite.update(ticks)

 pygame.sprite.draw(screen)

 pygame.sprite.collide_rect(arrow,dragon)    冲突

 screen.set_clip(0,400,200,600)    设定裁剪区域；

 screen.get_clip()        　　　　　 获得裁剪区域

Normal
0

7.8 磅
0
2

false
false
false

EN-US
ZH-CN
X-NONE

四、事件event

 pygame.event.get()    获取事件的返回值，使用event.type == 进行区分

 pygame.event.wait()    等待发生一个事件才会继续下去；

 pygame.event.poll()    会根据现在的情形返回一个真实的事件

 pygame.event.set_blocked(事件名)    过滤

 pygame.event.set_allowed() 允许事件

Normal
0

7.8 磅
0
2

false
false
false

EN-US
ZH-CN
X-NONE

自定义事件

 my_event = pygame.event.Event(KEYDOWN,key=K_SPACE,mod=0,unicode=u' ')

 pygame.event.post(my_event)

Normal
0

7.8 磅
0
2

false
false
false

EN-US
ZH-CN
X-NONE

pygame所有事件type

 QUIT             退出；

 ACTIVEEVENT    　pygame被激活或隐藏；

 KEYDOWN       　 区分不同键 event.key == pygame.K_a,pygame使用keys=pygame.key.get_pressed()来轮询键盘接口，返回的是所有按下键值的元组；用keys[K_b]方式来核对键值；K_b也可以是键值Unicode码；如果mod & KMOD_CTRL为真的话表示同时按下Ctrl键；key.get_mods()组合键，key.set_repeat()重复事件；key.name()接受键值返回键名；

 KEYUP            按键放开

 MOUSEMOTION    　含event.pos,event.rel,event.buttons属性，用mouse_x,mouse_y = event.pos进行确认,pygame.mouse.get_pos()返回鼠标的当前位置，pygame.mouse.get_rel()获取鼠标相对移动，pygame.mouse.get_pressed()返回按钮状态数组(鼠标三个键的状态)

 mouse.set_visible(False) 使鼠标不可见；

 event.set_grab(True)     使鼠标不会跑出窗口

 mouse.set_pos()          设置鼠标位置

 mouse.get_focused()      如果鼠标在pygame窗口内有效，返回True

 mouse.set_cursor()       设置鼠标默认光标式样；

 mouse.get_cursor()       获取鼠标默认光标式样；

 MOUSEBUTTONUP      鼠标放开

 MOUSEBUTTONDOWN    鼠标按下

 JOYAXISMOTION      x手柄移动

 JOYBALLMOTION      所有手机移动

 JOYHATMOTION       hat手柄移动

 JOYBUTTONUP        手柄按键放开

 JOYBUTTONDOWN      手柄按键按下

 VIDEORESIZE        窗口缩放；

 VIDEOEXPOSE        窗口部分公开；

 USEREVENT          触发了一个用户事件；

Normal
0

7.8 磅
0
2

false
false
false

EN-US
ZH-CN
X-NONE

五、异常捕捉

 try:

     screen = pygame.display.set_mode(SCREEN_SIZE)

 except pygame.error,e:

     print("Can't create the display :-(")

     print(e)

     exit()

Normal
0

7.8 磅
0
2

false
false
false

EN-US
ZH-CN
X-NONE

六、时间

 clock = pygame.time.Clock()    初始化一个clock对象

 clock.tick()     返回一个上次调用的时间，以毫秒为单位

 clock.tick(30)    控制游戏绘制的最大帧率为30

Normal
0

7.8 磅
0
2

false
false
false

EN-US
ZH-CN
X-NONE

七、声音

（一）sound对象

Normal
0

7.8 磅
0
2

false
false
false

EN-US
ZH-CN
X-NONE

pygame.mixer.Sound("文件") 读取声音对象sound，格式只有wav和ogg两种；

对象方法：

 fadeout()        　　　　　　 淡出时间，可用参数为毫秒；

 get_lengh()    　　　　　　　　获得声音文件长度，以秒为单位；

 get_num_channels()    　　　　声音要播放的次数；

 play(loop,maxtime)    　　　　对读取的声音对象可执行播放操作，loop为-1表示无限循环，1表示重复两次，maxtime表示多少毫秒后结束；返回一个Channel对象，失败则返回None;

 set_volum()    　　　　　　　　设置音量；

 stop()        　　　　　　　　 停止播放；

 pygame.mixer.music        　　背景音乐处理方法

 pygame.mixer.music.load()    加载文件可为mp3和ogg格式；

 pygame.mixer.music.play()    播放

 pygame.mixer.music.stop()    停止,还有pause()和unpause()方法

（二）Channels对象

Normal
0

7.8 磅
0
2

false
false
false

EN-US
ZH-CN
X-NONE

pygame.mixer.get_num_channels() 获取当前系统可同时播放的声道数；pygame中默认为8；

对象方法：

 fadeout()    　　  设置淡出时间

 get_busy()    　　 如果正在播放，返回True;

 set_endevent()    设置播放完毕时要做的event;

 get_endevent()    获取播放完毕时要做的event，如果没有则返回None;

 get_queue()    　　获得队列中的声音，如果没有则返回None;

 set_volume()    　 设置音量；

 get_volume()      获得音量；

 pause()        　　暂停播放；

 unpause()    　　  继续播放；

 play()        　　 播放；

 stop()        　　 停止播放；

 queue()        　　将一个Sound对象加入队列，在当前声音播放完毕后播放；

 set_num_channels() 自定义声道数；

（三）music对象

Normal
0

7.8 磅
0
2

false
false
false

EN-US
ZH-CN
X-NONE

pygame.mixer.pre_init(frequency,size,stereo,buffer) 声音系统初始化，第一个为采样率，第二个为量化精度，第三为立体声效果，第四为缓冲；

对象方法：

 fadeout()    　　  设置淡出时间

 set_endevent()    设置播放完毕后事件

 get_endevent()    获取播放完毕后进行的事件；

 set_volume()      设置音量；

 get_volume()      获取音量；

 load()        　　 加载音乐文件；

 rewind()    　　   从头开始播放；

 get_pos()         获得当前播放的位置，以毫秒为单位；

Normal
0

7.8 磅
0
2

false
false
false

EN-US
ZH-CN
X-NONE