Pygame est une bibliothèque multi-plateforme, libre et open-source permettant de développer des applications multimédias comme des jeux-vidéos, avec Python. Il utilise la bibliothèque « Simple DirectMedia Layer » (SDL) et plusieurs autres bibliothèques populaires pour abstraire les fonctions les plus courantes et rendre l’écriture de programmes la plus intuitive possible.
Cette distribution se nomme « pygame - Community Edition » (abrégé « pygame-ce »).
Ceci est un fork du projet initial par ses principaux anciens développeurs, il a été créé suite à de nombreux obstacles impossibles à franchir, les empêchant de continuer le développement du projet initial. Cette nouvelle distribution a pour but d’offrir des mises à jour plus régulières, des améliorations et des correctifs, mais aussi un modèle de gouvernance plus démocratique.
Tout nouveau contributeur est le bienvenu !
pip install pygame-ceSi vous venez de commencer avec pygame, vous devriez être capable de vous y lancer assez
rapidement. Pygame vient avec un grand nombre de tutoriels et d'introductions. Vous avez
aussi une documentation très bien référencée sur toute la bibliothèque. Naviguez dans la
documentation sur la docs page. Vous pouvez aussi y jeter un coup d'œil localement en
exécutant la commande python -m pygame.docs dans votre terminal. Si la documentation
n’est pas trouvée localement, cela va lancer le site web.
La documentation en ligne reste à jour avec la version de pygame-ce en cours de
développement sur GitHub. Cela peut être un peu plus récent que la version de
pygame-ce que vous utilisez. Pour passer à la version sortie la plus récente, lancez
pip install pygame-ce --upgrade dans votre terminal.
Un point particulièrement intéressant : vous avez à votre disposition un dossier d’exemples contenant de nombreux petits programmes jouables, vous permettant de commencer à jouer avec le code tout de suite.
Si vous voulez utiliser des fonctionnalités en cours de développement, ou que vous voulez contribuer à pygame-ce, vous allez avoir besoin de build pygame-ce localement depuis le code source, plutôt que de l’installer avec pip.
Installer pygame-ce depuis le code source est assez automatisé. La majeure
partie du travail sera de compiler et d’installer toutes les dépendances de
pygame. Une fois ceci fait, lancez le script setup.py qui va essayer
de l’auto-configurer, le build, et l’installer.
Plus d’informations à propos de l’installation et de la compilation sont disponibles sur Compilation wiki page.
Un très grand merci à toutes celles et ceux qui ont contribué et contribuent toujours à ce module. Des remerciements particuliers s'imposent également.
- Marcus Von Appen: many changes, and fixes, 1.7.1+ freebsd maintainer
- Lenard Lindstrom: the 1.8+ windows maintainer, many changes, and fixes
- Brian Fisher for svn auto builder, bug tracker and many contributions
- Rene Dudfield: many changes, and fixes, 1.7+ release manager/maintainer
- Phil Hassey for his work on the pygame.org website
- DR0ID for his work on the sprite module
- Richard Goedeken for his smoothscale function
- Ulf Ekström for his pixel perfect collision detection code
- Pete Shinners: original author
- David Clark for filling the right-hand-man position
- Ed Boraas and Francis Irving: Debian packages
- Maxim Sobolev: FreeBSD packaging
- Bob Ippolito: macOS and OS X porting (much work!)
- Jan Ekhol, Ray Kelm, and Peter Nicolai: putting up with early design ideas
- Nat Pryce for starting our unit tests
- Dan Richter for documentation work
- TheCorruptor for his incredible logos and graphics
- Nicholas Dudfield: many test improvements
- Alex Folkner for pygame-ctypes
Merci à celles et ceux qui ont proposé des correctifs : Niki Spahiev, Gordon Tyler, Nathaniel Pryce, Dave Wallace, John Popplewell, Michael Urman, Andrew Straw, Michael Hudson, Ole Martin Bjoerndalen, Herve Cauwelier, James Mazer, Lalo Martins, Timothy Stranex, Chad Lester, Matthias Spiller, Bo Jangeborg, Dmitry Borisov, Campbell Barton, Diego Essaya, Eyal Lotem, Regis Desgroppes, Emmanuel Hainry, Randy Kaelber, Matthew L Daniel, Nirav Patel, Forrest Voight, Charlie Nolan, Frankie Robertson, John Krukoff, Lorenz Quack, Nick Irvine, Michael George, Saul Spatz, Thomas Ibbotson, Tom Rothamel, Evan Kroske, Cambell Barton.
Et à nos chasseurs de bugs : Angus, Guillaume Proux, Frank Raiser, Austin Henry, Kaweh Kazemi, Arturo Aldama, Mike Mulcheck, Michael Benfield, David Lau
Il y a aussi pas mal de personnes présentes qui soumettent des idées utiles et intéressantes, qui ont permis à ce projet de continuer à vivre, et qui ont pratiquement rendu notre travail facile. Merci !
Très grands remerciements à toutes les personnes commentant la documentation, et ajoutant du nouveau contenu dans la documentation de pygame et dans la documentation de pygame-ce.
Aussi de très grands remerciements à toutes les personnes créant des jeux et les partageant sur le site pygame.org pour permettre aux autres d'apprendre et de s’amuser.
Très grands remerciements à James Paige en particulier pour avoir hébergé pygame bugzilla.
Enfin nos meilleurs remerciements à Roger Dingledine et à toute l'équipe de SEUL.ORG pour notre excellent hébergement.
note: This section translation is out of date (September 2023)
Pygame est évidemment très dépendant de SDL et Python. Il a aussi des liens, mais de même intègre plusieurs autres petites bibliothèques. Le module font s’appuie sur SDL_ttf, qui est lui-même dépendant de freetype. Le module mixer (et mixer.music) dépend de SDL_mixer. Le module image dépend de SDL_image, qui dépend de libjpeg et libpng. Le module transform a une version intégrée de SDL_rotozoom pour ses propres fonctions de rotozoom. Le module surfarray a besoin du package python, numpy, pour ses tableaux numériques multidimensionnels.
Versions des dépendances:
| CPython | >= 3.8 (Ou utiliser PyPy3) |
| SDL | >= 2.0.10 |
| SDL_mixer | >= 2.0.4 |
| SDL_image | >= 2.0.4 |
| SDL_ttf | >= 2.0.15 |
Identifiant de licence: LGPL-2.1-or-later
La bibliothèque est distribuée sous la licence GNU LGPL version 2.1, qui
peut être retrouvée dans le fichier docs/LGPL.txt. Nous nous réservons
le droit de placer les futures versions de cette bibliothèque sous une licence
différente.
Ceci veut en quelque sorte dire que vous êtes habilité à utiliser pygame-ce dans n’importe quel projet que souhaitez, mais que si vous voulez effectuer des changements ou des ajouts à pygame lui-même, alors vous serez dans l’obligation de les publier avec une licence compatible (de préférence en les soumettant au projet pygame-ce). Les codes propriétaires et les jeux commerciaux sont autorisés.
Les programmes présents dans le sous-répertoire examples appartiennent
au domaine public.
Voir les docs/licences pour les licences des dépendances.