一、HelloWorld

1 pygame.init()     #初始函式，使用pygame的第一步；
2 pygame.display.set_mod((600,500)，0，32)     #生成主螢幕screen；第一個引數是螢幕大小，第二個0表示不使用特性，可用FULLSCREEN,RESIZEBLE,NOFRAME,DOUBLEBUF(雙緩衝，使用時需用pygame.display.flip()來重新整理螢幕)等替換，32表示色深；
3 pygame.display.set_caption("string")     #命名
4 pygame.display.update()        #
 
重新整理
5 pygame.display.list_modes()        #檢視本地顯示器支援的解析度；
6 screen.fill(0,0,0)        #填充

二、繪圖

pygame.draw.rect(surface,color,Rect,width=0) 畫一個矩形，Rect為兩個座標元組的元組；

（一）rect(矩形）引數屬性

 1 r.left         左邊x座標的整數值
 2 r.right        右邊x座標的整數值
 3 r.top        　頂部y座標的整數值
 4 r.bottom    　 底部y座標的整數值
 5
 
 r.centerx      中央x座標整數值
 6 r.centery      中央y座標整數值
 7 r.width        寬度
 8 r.height       高度
 9 r.size         即元組（width,height)
10 r.topleft      (left,top)
11 r.topright     (right,top)
12 r.bottomleft   (left,bottom)
13 r.bottomright  (right,bottom)
14 r.midleft      (left,centery)
15 r.midright     (right,centery)
 
16 r.midtop       (centerx,top)
17 r.midbottom    (centerx,bottom)

（二）其他形狀

1 pygame.draw.polygon(surface,color,pointlist,width=0) 　 　多邊形
2 pygame.draw.circle(surface,color,pos,radius,width=0)      圓
3 pygame.draw.ellipse(surface,color,Rect,width=0)    　　   橢圓
4 pygame.draw.arc(surface,color,Rect,start_angle,stop_angle,width=1) 圓弧
5 pygame.draw.line(surface,color,start_pos,end_pos,width=1) 　　　直線；
6 pygame.draw.lines(surface,color,closed,pointlist,width=1) 　　  closed為一bool值，表示是否封閉；
7 pygame.draw.aaline(surface,color,start_pos,end_pos,width=1)    一根平滑的線;
8 pygame.draw.aalines(surface,color,closed,pointlist,width=1)    一系列平滑的線;

（三）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()檢視當前系統所有可使用的字型

三、圖片處理

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

 1 pygame.image.load("圖片路徑").conver()        將圖片處理為surface物件，如果使用conver_alpha()則保留了Alpha通道資訊（可透明），使用時用blit()函式來新增到顯示屏
 2 pygame.Surface((250,250),flags,depth)        建立一個surface物件，如果不指定尺寸則會建立和螢幕一樣大小；flags為可選，有SRCALPHA(保留Alpha通道)、HWSURFACE(優化)兩個選擇，depth為色深；
 3 screen.subsurface((0,0),(80,80))        　　 子表面物件；
 4 screen.set_at(pos,color)                　　 設定一個畫素的色彩；
 5 screen.get_at(pos)                    　　　　獲取某一畫素的色彩，不過此操作的反應比較慢；
 6 pygame.transform.scale(surface,(width//2,height//2)    縮放圖片
 7 pygame.transform.smoothscale(surface,(width,height)    縮放圖片，比scale慢，但效果更好；

 8 pygame.sprite.Group()        　　 精靈組，一個簡單的實體容器；
 9 pygame.sprite.add(sprite)        新增精靈物件；
10 pygame.sprite.update(ticks)        
11 pygame.sprite.draw(screen)
12 pygame.sprite.collide_rect(arrow,dragon)    衝突

13 screen.set_clip(0,400,200,600)    設定裁剪區域；
14 screen.get_clip()        　　　　　 獲得裁剪區域

 四、事件event

1 pygame.event.get()    獲取事件的返回值，使用event.type == 進行區分
2 pygame.event.wait()    等待發生一個事件才會繼續下去；
3 pygame.event.poll()    會根據現在的情形返回一個真實的事件
4 pygame.event.set_blocked(事件名)    過濾
5 pygame.event.set_allowed() 允許事件

 自定義事件

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

pygame所有事件type

 1 QUIT             退出；
 2 ACTIVEEVENT    　pygame被啟用或隱藏；
 3 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()接受鍵值返回鍵名；
 4 KEYUP            按鍵放開
 5 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()返回按鈕狀態陣列(滑鼠三個鍵的狀態)
 6 mouse.set_visible(False) 使滑鼠不可見；
 7 event.set_grab(True)     使滑鼠不會跑出視窗
 8 mouse.set_pos()          設定滑鼠位置
 9 mouse.get_focused()      如果滑鼠在pygame視窗內有效，返回True
10 mouse.set_cursor()       設定滑鼠預設游標式樣；
11 mouse.get_cursor()       獲取滑鼠預設游標式樣；

12 MOUSEBUTTONUP      滑鼠放開
13 MOUSEBUTTONDOWN    滑鼠按下
14 JOYAXISMOTION      x手柄移動
15 JOYBALLMOTION      所有手機移動
16 JOYHATMOTION       hat手柄移動
17 JOYBUTTONUP        手柄按鍵放開
18 JOYBUTTONDOWN      手柄按鍵按下
19 VIDEORESIZE        視窗縮放；
20 VIDEOEXPOSE        視窗部分公開；
21 USEREVENT          觸發了一個使用者事件；

 五、異常捕捉

1 try:
2     screen = pygame.display.set_mode(SCREEN_SIZE)
3 except pygame.error,e:
4     print("Can't create the display :-(")
5     print(e)
6     exit()

六、時間

1 clock = pygame.time.Clock()    初始化一個clock物件
2 clock.tick()     返回一個上次呼叫的時間，以毫秒為單位
3 clock.tick(30)    控制遊戲繪製的最大幀率為30

七、聲音

（一）sound物件

pygame.mixer.Sound("檔案")讀取聲音物件sound，格式只有wav和ogg兩種；

物件方法：

 1 fadeout()        　　　　　　 淡出時間，可用引數為毫秒；
 2 get_lengh()    　　　　　　　　獲得聲音檔案長度，以秒為單位；
 3 get_num_channels()    　　　　聲音要播放的次數；
 4 play(loop,maxtime)    　　　　對讀取的聲音物件可執行播放操作，loop為-1表示無限迴圈，1表示重複兩次，maxtime表示多少毫秒後結束；返回一個Channel物件，失敗則返回None;
 5 set_volum()    　　　　　　　　設定音量；
 6 stop()        　　　　　　　　 停止播放；
 7 pygame.mixer.music        　　背景音樂處理方法
 8 pygame.mixer.music.load()    載入檔案可為mp3和ogg格式；
 9 pygame.mixer.music.play()    播放
10 pygame.mixer.music.stop()    停止,還有pause()和unpause()方法

（二）Channels物件

pygame.mixer.get_num_channels()獲取當前系統可同時播放的聲道數；pygame中預設為8；

物件方法：

 1 fadeout()    　　  設定淡出時間
 2 get_busy()    　　 如果正在播放，返回True;
 3 set_endevent()    設定播放完畢時要做的event;
 4 get_endevent()    獲取播放完畢時要做的event，如果沒有則返回None;
 5 get_queue()    　　獲得佇列中的聲音，如果沒有則返回None;
 6 set_volume()    　 設定音量；
 7 get_volume()      獲得音量；
 8 pause()        　　暫停播放；
 9 unpause()    　　  繼續播放；
10 play()        　　 播放；
11 stop()        　　 停止播放；
12 queue()        　　將一個Sound物件加入佇列，在當前聲音播放完畢後播放；
13 set_num_channels() 自定義聲道數；

（三）music物件

pygame.mixer.pre_init(frequency,size,stereo,buffer) 聲音系統初始化，第一個為取樣率，第二個為量化精度，第三為立體聲效果，第四為緩衝；

物件方法：

1 fadeout()    　　  設定淡出時間
2 set_endevent()    設定播放完畢後事件
3 get_endevent()    獲取播放完畢後進行的事件；
4 set_volume()      設定音量；
5 get_volume()      獲取音量；
6 load()        　　 載入音樂檔案；
7 rewind()    　　   從頭開始播放；
8 get_pos()         獲得當前播放的位置，以毫秒為單位；