Pygame/Importation et initialisation
Traduit de l'anglais, l'original par "Pete Shinners" :
http://www.pygame.org/docs/tut/ImportInit.html
Importer Pygame et l'initialiser est très facile. Elle est également assez souple pour nous laisser le contrôle sur ce qui se produit. 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.
Importation.
Premièrement nous importons Pygame, c'est essentiel. Depuis la version 1.4, Pygame est fait pour être plus simple. La plupart des jeux importeront Pygame de cette façon :
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 sert à rendre publiques certaines constantes et fonctions de Pygame.
Une chose à garder à l'esprit est que certains modules de Pygame sont optionnels. Par exemple le module codice_1 est un de ceux-ci. Lorsque le programme lit codice_2, Pygame vérifie si tous les modules sont disponibles. Si le module codice_3 est disponible, il est importé en tant que codice_1. Si le module n'est pas disponible, codice_1 aura la valeur codice_6. Ce qui fait qu'il est facile de tester la présence du module codice_3.
Initialisation.
Ensuite pour pouvoir utiliser Pygame, vous avez besoin de l'initialiser. La façon habituelle de le faire est d'écrire :
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 codice_3 :
pygame.font.init()
Notons que s'il y a une erreur quand nous initialisons avec codice_9, elle échouera de façon silencieuse. Si nous initialisons les modules manuellement, toutes les erreurs soulèverons une exception. Tout module peut être initialisé avec la fonction codice_10 qui retourne codice_11 si le module est initialisé correctement.
Il est possible d'appeler la fonction codice_12 plusieurs fois par module sans danger.
Quit.
Les modules ont généralement une fonction codice_13 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.