Skip to content

Latest commit

 

History

History
228 lines (175 loc) · 10.1 KB

README.it.rst

File metadata and controls

228 lines (175 loc) · 10.1 KB
pygame

DocsStatus PyPiVersion PyPiLicense Python3 GithubCommits BlackFormatBadge

Pygame è una libreria open source gratuita e multipiattaforma adibita allo sviluppo di applicazioni multimediali come videogiochi utilizzando Python. Utilizza la Simple DirectMedia Layer library e altre librerie popolari per astrarre le operazioni più comuni, rendendo la scrittura di questi programmi un compito più intuitivo.

Questa distribuzione si chiama `pygame - Community Edition` ('pygame-ce' per abbreviare).

È una fork (divisione) del progetto pygame originale fondata dai suoi precedenti sviluppatori principali, ed è stata creata dopo che ostacoli insuperabili gli hanno impedito di continuare a sviluppare l'originale. La nuova distribuzione ha l'obbiettivo di offrire nuove versioni più di frequente, continue migliorie e bugfixes e un modello governativo più democratico.

Nuovi contributori sono i benvenuti!

Installazione

pip install pygame-ce

Aiuto

Se sei alle prime armi con pygame, dovresti riuscire a iniziare abbastanza velocemente. Pygame ha a disposizione numerosi tutorial e introduzioni. Esiste anche una documentazione di riferimento completa per l'intera libreria. Puoi trovare la documentazione sulla docs page. Puoi anche visualizzare la documentazione localmente eseguento il comando python -m pygame.docs nel tuo terminale. Se la documentazione è inaccessibile localmente, il sito web online verrà aperto al suo posto.

La documentazione online è aggiornata con la versione di sviluppo di pygame-ce su github. Essa potrebbe essere leggermente più recente rispetto alla versione di pygame-ce che stai usando. Per aggiornare alla versione più recente, esegui il comando pip install pygame-ce --upgrade nel tuo terminale.

La cosa migliore è che la cartella degli esempi contiene numerosi piccoli programmi giocabili che ti permetteranno di iniziare a maneggiare il codice fin da subito.

Compilare dal Codice Locale

Se vuoi usare funzionalità che sono ancora in sviluppo o se vuoi contribuire per pygame-ce avrai bisogno di compilare pygame-ce localmente a partire dal suo codice sorgente piuttosto che installarlo con pip.

L'installazione dal codice sorgente è abbastanza automatizzata. La maggior parte del lavoro riguarda compilare e installare le librerie richieste da pygame-ce. Fatto ciò, esegui lo script setup.py che tenterà di configurare automaticamente, compilare e installare pygame-ce.

Più informazioni riguardo all'installazione e alla compilazione sono disponibili sulla Compilation wiki page.

Crediti

Grazie a tutti coloro che hanno aiutato a contribuire per questa libraria. In ordine sono riportati i ringraziamenti speciali.

  • 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

Grazie a coloro che inviano patches e correzioni: 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.

E ai nostri incredibili cacciatori di bug: Angus, Guillaume Proux, Frank Raiser, Austin Henry, Kaweh Kazemi, Arturo Aldama, Mike Mulcheck, Michael Benfield, David Lau.

Ci sono molte altre persone là fuori che hanno condiviso utili idee, che hanno mantenuto il progetto in vita e che ci hanno essenzialmente reso la vita più facile. Grazie!

Molte grazie alle persone che pubblicano commenti sulla documentazione e che contribuiscono alla pygame documentation e alla pygame-ce documentation.

Altrettanti ringraziamenti alle persone che creano giochi e che li pubblicano sul sito pygame.org per rendere possibile agli altri di imparare da essi e di divertirsi.

Molte grazie a James Paige per aver ospitato il bugzilla di pygame.

Un altro grande ringraziamento a Roger Dingledine e al team di SEUL.ORG per un hosting eccellente.

Requisiti

Pygame come si può intuire dipende fortemente da SDL e da Python. È inoltre collegata e incorpora diverse altre librerie più piccole. Il modulo font dipende da SDL_ttf che dipende a sua volta da freetype. Il modulo mixer (e mixer.music) dipendono da SDL_mixer. Il modulo image dipende da SDL_image. La funzione Transform.rotozoom usa una versione incorporata di SDL_rotozoom e il modulo gfxdraw incorpora una versione di SDL_gfx.

Le versioni dei requisiti:

CPython >= 3.8 (Or use PyPy3)
SDL >= 2.0.10
SDL_mixer >= 2.0.4
SDL_image >= 2.0.4
SDL_ttf >= 2.0.15

Come Contribuire

Prima di tutto, grazie per aver considerato di contribuire per pygame-ce! Sono le persone come te che rendono pygame-ce una libreria grandiosa. Per favore segui questi passaggi per iniziare:

  1. Leggi le pagine wiki Contribution Guidelines e Many Ways to Contribute.
  2. Leggi la documentazione riguardo Opening A Pull Request e Opening a Great Pull Request.
  3. Leggi come label and link reported issues.
  4. Controlla l'issue tracker per problemi irrisolti che ti interessano o segnala un nuovo problema per iniziare una discussione riguardo alla tua idea.

Ci sono molte più risorse nelle wiki pages che possono aiutarti ad iniziare.

Se hai qualsiasi domanda, sentiti libero di chiedere nel Pygame Community Discord Server o segnala un problema.

Licenza

License Identifier: LGPL-2.1-or-later

Questa libreria è distribuita con la licenza GNU LGPL version 2.1 che può essere trovata nel file docs/LGPL.txt. Ci riserviamo il diritto di distribuire future versioni di questa libreria con una licenza differente.

Questo significa essenzialmente che puoi usare pygame-ce in qualsiasi progetto che tu voglia, ma se fai alcun cambiamento o aggiunte a pygame-ce stesso, tali modifiche devono essere distribuite con una licenza compatibile (preferibilmente presentate al progetto pygame-ce). Giochi commerciali o a codice chiuso sono consentiti.

I programmi nella sottocartella examples appartengono al dominio pubblico.

Controlla docs/licenses per le licenze dei requisiti.


Last reviewed: 05 October 2024 - Ultima revisione: 05 Ottobre 2024