Importazione e inizializzazione
Importare ed inizializzare pygame è un processo molto semplice. Ed è inoltre abbastanza flessibile da darvi il controllo di ciò che accade. Pygame è una collezione di moduli differenti riuniti in un singolo package. Alcuni dei moduli sono scritti in C ed altri in Python. Inoltre alcuni moduli sono facoltativi e possono anche non essere presenti.
Questa è solo una breve introduzione a ciò che accade quando importate pygame. Per una spiegazione più chiara dovete assolutamente vedere gli esempi di pygame.
Importazione
Prima di tutto dobbiamo importare il package pygame. Dalla versione 1.4 questa operazione è stata aggiornata per essere più semplice. Molti giochi importeranno tutto il package pygame così.
1 import pygame
2 from pygame.locals import *
La prima riga, che è la sola ad essere necessaria, importa tutti i moduli disponibili nel package pygame. La seconda riga è facoltativa, ed importa un set limitato di funzioni e di costanti nello spazio dei nomi globale del vostro script.
Una cosa importante da ricordare è che alcuni moduli pygame sono facoltativi. Per esempio, uno di questi è il modulo font. Durante l'importazione pygame verificherà la disponibilità del modulo font. Se il modulo è disponibile verrà importato come pygame.font, altrimenti pygame.font verrà settato a None. Questo rende molto più semplice in seguito testare la disponibilità del modulo.
Inizializzazione
Prima che voi possiate fare qualcosa con pygame, avrete bisogno di inizializzarlo. Il modo più comune di fare ciò è chiamara una funzione.
1 pygame.init()
Questa tenterà di inizializzare per voi tutti quei moduli che necessitano di essere inizializzati. Potete anche inizializzare ogni modulo pygame manualmente. Per esempio per inizializzare solo il modulo font dovreste solo chiamare
1 pygame.font.init()
Notate che se si verifica un'errore quando inizializzate con pygame.init(), la funzione fallirà silenziosamente. Quando invece inizializzate moduli manualmente ogni errore solleverà un eccezione. Alcuni moduli che necessitano inizializzazione hanno anche una funzione get_init(), che ritornerà True se il modulo è stato inizializzato.
E' più sicuro chiamare la funzione init() più di una volta per ogni modulo.
Quit
I moduli inizializzati hanno solitamente anche una funzione quit() che resetta il modulo. Non c'è bisogno di chiamare questa funzione esplicitamente, dato che pygame resetta tutti i moduli inizializzati quando python termina.