I. Introduction

Importer Pygame et l'initialiser est très facile. La bibliothèque est également assez souple pour nous laisser le contrôle sur ce qui se passe. Pygame est une collection de différents modules dans un simple paquet Python. La plupart des modules sont écrits en C, d'autres sont écrits en Python. Certains modules sont en option et ne sont pas toujours présents.

Ceci n'est qu'une courte introduction sur ce qui se passe lorsque vous importez Pygame. Pour des explications plus claires voyez les exemples sur Pygame.

II. Importation

Premièrement nous devons importer Pygame. Depuis la version 1.4, Pygame est conçu pour être plus simple. La plupart des jeux importeront Pygame de cette façon :

 
Sélectionnez
import pygame
from pygame.locals import *

La première ligne est la seule obligatoire. C'est l'importation de tous les modules de Pygame existants. La seconde ligne est optionnelle et permet d'introduire certaines constantes et fonctions de Pygame dans l'espace de nommage global de votre script.

Une chose à garder à l'esprit est que certains modules de Pygame sont optionnels. Par exemple le module pygame.font en fait partie. Lorsque le programme lit import pygame, Pygame vérifie si tous les modules sont disponibles. Si le module font est disponible, il est importé en tant que pygame.font. Si le module n'est pas disponible, pygame.font aura la valeur None, rendant facile la détection de la présence du module font.

III. Initialisation

Ensuite pour pouvoir utiliser Pygame, vous avez besoin de l'initialiser. La façon habituelle de faire est d'écrire :

 
Sélectionnez
pygame.init()

Ceci initialise tous les modules de la bibliothèque Pygame pour nous. Tous les modules de Pygame n'ont pas besoin d'être initialisés, mais ceux qui en ont besoin le sont automatiquement. Il est également aussi facile d'initialiser les modules un par un. Par exemple pour initialiser le module font :

 
Sélectionnez
pygame.font.init()

Notons que s'il y a une erreur quand nous initialisons avec pygame.init(), elle échouera de façon silencieuse. Si nous initialisons les modules manuellement, toutes les erreurs soulèveront une exception. Tout module peut être initialisé avec la fonction get_init() qui retourne true si le module est initialisé correctement.

Il est possible d'appeler la fonction init() plusieurs fois par module sans danger.

IV. Quit

Les modules ont généralement une fonction quit() pour quitter en libérant la mémoire. Il n'y a pas besoin d'appeler cette fonction explicitement vu que Python libère de lui-même la mémoire de tous les modules initialisés quand on quitte un programme.

V. Remerciements

Traduit de l'anglais, l'original par Pete Shinners : http://www.pygame.org/docs/tut/ImportInit.html

Cette traduction est aussi disponible sur Wikibooks. La liste des contributeurs est disponible ici.

Merci à f-leb pour sa relecture orthographique.