Aller sur le site de Pygame. Cliquez sur documentation. Il y a tout en haut une liste des fonctions les plus utiles (most useful stuff) et une barre de recherche. Il y a ensuite 3 parties :

• Documents : Un fichier lisez-moi ainsi que les fichiers d'installation et les licences.
• Tutorials : Des tutos pour débutants très complets.
• Reference : La partie la plus utile. La complète des fonctions de Pygame que nous détaillons après.

Toutes les fonctionnalités sont listées dans Index (on s'y perdrait) : Ces fonctionnalités sont aussi regroupées par thématiques dans la partie Reference. Nous résumons les principales utilisées par la suite dans ce tableau :

Nom du paquet	Description
pygame.display	Gestion de la fenêtre d'affichage (initialiser, rafraîchir, femer, etc.)
pygame.draw	Dessin de formes basiques (cercles, rectangles, lignes, polygones, courbes, etc.)
pygame.key	Gestion des touches du clavier
pygame.mouse	Gestion de la souris

Pour aller plus loin :

• les paquets pygame.image et pygame.sprite permettent d'utiliser des images, et des sprites (images animées) pour remplacer les formes géométriques.
• les paquets pygame.mixer et pygame.mixer.music permettent d'ajouter du son.
• le paquets pygame.Rect est incontournable pour gérer les zones de collision plus simplement en allégeant les calculs.
• le paquets pygame.joystick permet de gérer une manette de jeu.

En vue de dessiner une balle, on va utiliser une fonction de pygame.draw pour tracer des cercles : circle.

• Aller sur la documentation de pygame.draw
• Cliquer sur ce qui nous intéresse, c'est à dire pygame.draw.circle.
• On arrive sur le descriptif de la méthode circle et son utilisation.

La méthode circle nécessite plusieurs arguments :

• Surface : le nom de la fenêtre de jeu. Dans notre programme, screen
• color : Une liste de 3 valeurs [R,V,B].
• pos : Une liste de 2 coordonnées pour le centre du cercle [x,y].
• radius : le rayon du cercle.
• width : épaisseur du trait. Si la valeur est zéro, le disque est plein.

Bien sûr, si on ne trouve pas son bonheur dans la documentation, de nombreux exemples existent sur internet. Ne pas hésiter donc à demander à notre moteur de recherche préféré... Si on pose la question en anglais, le nombre de résultats sera encore plus important.