|
| 1 | +.. image:: https://raw.githubusercontent.com/pygame-community/pygame-ce/main/docs/reST/_static/pygame_ce_logo.svg |
| 2 | + :width: 800 |
| 3 | + :alt: pygame |
| 4 | + :target: https://pyga.me/ |
| 5 | + |
| 6 | + |
| 7 | +|DocsStatus| |
| 8 | +|PyPiVersion| |PyPiLicense| |
| 9 | +|Python3| |GithubCommits| |BlackFormatBadge| |
| 10 | + |
| 11 | +`English`_ `简体中文`_ `繁體中文`_ `Français`_ `فارسی`_ `Español`_ `日本語`_ **Italiano** |
| 12 | +--------------------------------------------------------------------------------------------------- |
| 13 | + |
| 14 | +Pygame_ è una libreria open source gratuita e multipiattaforma |
| 15 | +adibita allo sviluppo di applicazioni multimediali come videogiochi utilizzando Python. |
| 16 | +Utilizza la `Simple DirectMedia Layer library`_ e altre librerie |
| 17 | +popolari per astrarre le operazioni più comuni, rendendo la scrittura |
| 18 | +di questi programmi un compito più intuitivo. |
| 19 | + |
| 20 | +Questa distribuzione si chiama **`pygame - Community Edition`** ('pygame-ce' per abbreviare). |
| 21 | + |
| 22 | +È una fork (divisione) del progetto pygame originale fondata dai suoi precedenti sviluppatori principali, |
| 23 | +ed è stata creata dopo che ostacoli insuperabili gli hanno impedito di continuare a sviluppare l'originale. |
| 24 | +La nuova distribuzione ha l'obbiettivo di offrire nuove versioni più di frequente, continue migliorie |
| 25 | +e bugfixes e un modello governativo più democratico. |
| 26 | + |
| 27 | +Nuovi contributori sono i benvenuti! |
| 28 | + |
| 29 | +Installazione |
| 30 | +------------- |
| 31 | + |
| 32 | +:: |
| 33 | + |
| 34 | + pip install pygame-ce |
| 35 | + |
| 36 | + |
| 37 | +Aiuto |
| 38 | +----- |
| 39 | + |
| 40 | +Se sei alle prime armi con pygame, dovresti riuscire a iniziare |
| 41 | +abbastanza velocemente. Pygame ha a disposizione numerosi tutorial |
| 42 | +e introduzioni. Esiste anche una documentazione di riferimento completa |
| 43 | +per l'intera libreria. Puoi trovare la documentazione sulla `docs page`_. |
| 44 | +Puoi anche visualizzare la documentazione localmente eseguento il comando |
| 45 | +``python -m pygame.docs`` nel tuo terminale. Se la documentazione è |
| 46 | +inaccessibile localmente, il sito web online verrà aperto al suo posto. |
| 47 | + |
| 48 | +La documentazione online è aggiornata con la versione di sviluppo di pygame-ce |
| 49 | +su github. Essa potrebbe essere leggermente più recente rispetto alla versione |
| 50 | +di pygame-ce che stai usando. Per aggiornare alla versione più recente, esegui |
| 51 | +il comando ``pip install pygame-ce --upgrade`` nel tuo terminale. |
| 52 | + |
| 53 | +La cosa migliore è che la cartella degli esempi contiene numerosi piccoli |
| 54 | +programmi giocabili che ti permetteranno di iniziare a maneggiare il codice |
| 55 | +fin da subito. |
| 56 | + |
| 57 | +Compilare dal Codice Locale |
| 58 | +--------------------------- |
| 59 | + |
| 60 | +Se vuoi usare funzionalità che sono ancora in sviluppo o se vuoi |
| 61 | +contribuire per pygame-ce avrai bisogno di compilare pygame-ce localmente |
| 62 | +a partire dal suo codice sorgente piuttosto che installarlo con pip. |
| 63 | + |
| 64 | +L'installazione dal codice sorgente è abbastanza automatizzata. La maggior |
| 65 | +parte del lavoro riguarda compilare e installare le librerie richieste da pygame-ce. |
| 66 | +Fatto ciò, esegui lo script ``setup.py`` che tenterà di |
| 67 | +configurare automaticamente, compilare e installare pygame-ce. |
| 68 | + |
| 69 | +Più informazioni riguardo all'installazione e alla compilazione sono |
| 70 | +disponibili sulla `Compilation wiki page`_. |
| 71 | + |
| 72 | +Crediti |
| 73 | +------- |
| 74 | + |
| 75 | +Grazie a tutti coloro che hanno aiutato a contribuire per questa libraria. |
| 76 | +In ordine sono riportati i ringraziamenti speciali. |
| 77 | + |
| 78 | +* Marcus Von Appen: many changes, and fixes, 1.7.1+ freebsd maintainer |
| 79 | +* Lenard Lindstrom: the 1.8+ windows maintainer, many changes, and fixes |
| 80 | +* Brian Fisher for svn auto builder, bug tracker and many contributions |
| 81 | +* Rene Dudfield: many changes, and fixes, 1.7+ release manager/maintainer |
| 82 | +* Phil Hassey for his work on the pygame.org website |
| 83 | +* DR0ID for his work on the sprite module |
| 84 | +* Richard Goedeken for his smoothscale function |
| 85 | +* Ulf Ekström for his pixel perfect collision detection code |
| 86 | +* Pete Shinners: original author |
| 87 | +* David Clark for filling the right-hand-man position |
| 88 | +* Ed Boraas and Francis Irving: Debian packages |
| 89 | +* Maxim Sobolev: FreeBSD packaging |
| 90 | +* Bob Ippolito: macOS and OS X porting (much work!) |
| 91 | +* Jan Ekhol, Ray Kelm, and Peter Nicolai: putting up with early design ideas |
| 92 | +* Nat Pryce for starting our unit tests |
| 93 | +* Dan Richter for documentation work |
| 94 | +* TheCorruptor for his incredible logos and graphics |
| 95 | +* Nicholas Dudfield: many test improvements |
| 96 | +* Alex Folkner for pygame-ctypes |
| 97 | + |
| 98 | +Grazie a coloro che inviano patches e correzioni: Niki Spahiev, Gordon |
| 99 | +Tyler, Nathaniel Pryce, Dave Wallace, John Popplewell, Michael Urman, |
| 100 | +Andrew Straw, Michael Hudson, Ole Martin Bjoerndalen, Herve Cauwelier, |
| 101 | +James Mazer, Lalo Martins, Timothy Stranex, Chad Lester, Matthias |
| 102 | +Spiller, Bo Jangeborg, Dmitry Borisov, Campbell Barton, Diego Essaya, |
| 103 | +Eyal Lotem, Regis Desgroppes, Emmanuel Hainry, Randy Kaelber, |
| 104 | +Matthew L Daniel, Nirav Patel, Forrest Voight, Charlie Nolan, |
| 105 | +Frankie Robertson, John Krukoff, Lorenz Quack, Nick Irvine, |
| 106 | +Michael George, Saul Spatz, Thomas Ibbotson, Tom Rothamel, Evan Kroske, |
| 107 | +Cambell Barton. |
| 108 | + |
| 109 | +E ai nostri incredibili cacciatori di bug: Angus, Guillaume Proux, Frank |
| 110 | +Raiser, Austin Henry, Kaweh Kazemi, Arturo Aldama, Mike Mulcheck, |
| 111 | +Michael Benfield, David Lau. |
| 112 | + |
| 113 | +Ci sono molte altre persone là fuori che hanno condiviso utili idee, che |
| 114 | +hanno mantenuto il progetto in vita e che ci hanno essenzialmente reso la |
| 115 | +vita più facile. Grazie! |
| 116 | + |
| 117 | +Molte grazie alle persone che pubblicano commenti sulla documentazione e che |
| 118 | +contribuiscono alla `pygame documentation`_ e alla `pygame-ce documentation`_. |
| 119 | + |
| 120 | +Altrettanti ringraziamenti alle persone che creano giochi e che li pubblicano |
| 121 | +sul sito pygame.org per rendere possibile agli altri di imparare da essi e di divertirsi. |
| 122 | + |
| 123 | +Molte grazie a James Paige per aver ospitato il bugzilla di pygame. |
| 124 | + |
| 125 | +Un altro grande ringraziamento a Roger Dingledine e al team di SEUL.ORG |
| 126 | +per un hosting eccellente. |
| 127 | + |
| 128 | +Requisiti |
| 129 | +--------- |
| 130 | + |
| 131 | +Pygame come si può intuire dipende fortemente da SDL e da Python. |
| 132 | +È inoltre collegata e incorpora diverse altre librerie più piccole. |
| 133 | +Il modulo font dipende da SDL_ttf che dipende a sua volta da freetype. |
| 134 | +Il modulo mixer (e mixer.music) dipendono da SDL_mixer. Il modulo image |
| 135 | +dipende da SDL_image. La funzione Transform.rotozoom usa una versione |
| 136 | +incorporata di SDL_rotozoom e il modulo gfxdraw incorpora una versione |
| 137 | +di SDL_gfx. |
| 138 | + |
| 139 | +Le versioni dei requisiti: |
| 140 | + |
| 141 | + |
| 142 | ++----------+------------------------+ |
| 143 | +| CPython | >= 3.8 (Or use PyPy3) | |
| 144 | ++----------+------------------------+ |
| 145 | +| SDL | >= 2.0.10 | |
| 146 | ++----------+------------------------+ |
| 147 | +| SDL_mixer| >= 2.0.4 | |
| 148 | ++----------+------------------------+ |
| 149 | +| SDL_image| >= 2.0.4 | |
| 150 | ++----------+------------------------+ |
| 151 | +| SDL_ttf | >= 2.0.15 | |
| 152 | ++----------+------------------------+ |
| 153 | + |
| 154 | +Come Contribuire |
| 155 | +---------------- |
| 156 | +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: |
| 157 | + |
| 158 | +1. Leggi le pagine wiki `Contribution Guidelines`_ e `Many Ways to Contribute`_. |
| 159 | +2. Leggi la documentazione riguardo `Opening A Pull Request`_ e `Opening a Great Pull Request`_. |
| 160 | +3. Leggi come `label and link reported issues`_. |
| 161 | +4. Controlla l'`issue tracker`_ per problemi irrisolti che ti interessano o segnala un nuovo problema per iniziare una discussione riguardo alla tua idea. |
| 162 | + |
| 163 | +Ci sono molte più risorse nelle `wiki pages`_ che possono aiutarti ad iniziare. |
| 164 | + |
| 165 | +Se hai qualsiasi domanda, sentiti libero di chiedere nel `Pygame Community Discord Server`_ o segnala un problema. |
| 166 | + |
| 167 | +Licenza |
| 168 | +------- |
| 169 | +**License Identifier:** LGPL-2.1-or-later |
| 170 | + |
| 171 | +Questa libreria è distribuita con la licenza `GNU LGPL version 2.1`_ che può |
| 172 | +essere trovata nel file ``docs/LGPL.txt``. Ci riserviamo il diritto di |
| 173 | +distribuire future versioni di questa libreria con una licenza differente. |
| 174 | + |
| 175 | +Questo significa essenzialmente che puoi usare pygame-ce in qualsiasi progetto |
| 176 | +che tu voglia, ma se fai alcun cambiamento o aggiunte a pygame-ce stesso, |
| 177 | +tali modifiche devono essere distribuite con una licenza compatibile (preferibilmente |
| 178 | +presentate al progetto pygame-ce). Giochi commerciali o a codice chiuso sono consentiti. |
| 179 | + |
| 180 | +I programmi nella sottocartella ``examples`` appartengono al dominio pubblico. |
| 181 | + |
| 182 | +Controlla docs/licenses per le licenze dei requisiti. |
| 183 | + |
| 184 | +**** |
| 185 | + |
| 186 | +**Last reviewed**: 05 October 2024 - **Ultima revisione**: 05 Ottobre 2024 |
| 187 | + |
| 188 | +.. |PyPiVersion| image:: https://img.shields.io/pypi/v/pygame-ce.svg?v=1 |
| 189 | + :target: https://pypi.python.org/pypi/pygame-ce |
| 190 | + |
| 191 | +.. |PyPiLicense| image:: https://img.shields.io/pypi/l/pygame-ce.svg?v=1 |
| 192 | + :target: https://pypi.python.org/pypi/pygame-ce |
| 193 | + |
| 194 | +.. |Python3| image:: https://img.shields.io/badge/python-3-blue.svg?v=1 |
| 195 | + |
| 196 | +.. |GithubCommits| image:: https://img.shields.io/github/commits-since/pygame-community/pygame-ce/2.4.1.svg |
| 197 | + :target: https://github.com/pygame-community/pygame-ce/compare/2.4.1...main |
| 198 | + |
| 199 | +.. |DocsStatus| image:: https://img.shields.io/website?down_message=offline&label=docs&up_message=online&url=https%3A%2F%2Fpyga.me%2Fdocs%2F |
| 200 | + :target: https://pyga.me/docs/ |
| 201 | + |
| 202 | +.. |BlackFormatBadge| image:: https://img.shields.io/badge/code%20style-black-000000.svg |
| 203 | + :target: https://github.com/psf/black |
| 204 | + |
| 205 | +.. _Pygame: https://pyga.me |
| 206 | +.. _pygame-ce documentation: https://pyga.me/docs/ |
| 207 | +.. _pygame documentation: https://www.pygame.org/docs/ |
| 208 | +.. _Simple DirectMedia Layer library: https://www.libsdl.org |
| 209 | +.. _Compilation wiki page: https://github.com/pygame-community/pygame-ce/wiki#compiling |
| 210 | +.. _docs page: https://pyga.me/docs |
| 211 | +.. _GNU LGPL version 2.1: https://www.gnu.org/copyleft/lesser.html |
| 212 | +.. _Contribution Guidelines: https://github.com/pygame-community/pygame-ce/wiki/Contribution-guidelines |
| 213 | +.. _Many Ways to Contribute: https://github.com/pygame-community/pygame-ce/wiki/Many-ways-to-contribute |
| 214 | +.. _Opening A Pull Request: https://github.com/pygame-community/pygame-ce/wiki/Opening-a-pull-request |
| 215 | +.. _Opening a Great Pull Request: https://github.com/pygame-community/pygame-ce/wiki/Opening-a-great-pull-request |
| 216 | +.. _issue tracker: https://github.com/pygame-community/pygame-ce/issues |
| 217 | +.. _label and link reported issues: https://github.com/pygame-community/pygame-ce/wiki/Labelling-&-linking-reported-issues |
| 218 | +.. _Pygame Community Discord Server: https://discord.gg/pygame |
| 219 | +.. _wiki pages: https://github.com/pygame-community/pygame-ce/wiki |
| 220 | + |
| 221 | +.. _English: ./../../README.rst |
| 222 | +.. _简体中文: README.zh-cn.rst |
| 223 | +.. _繁體中文: README.zh-tw.rst |
| 224 | +.. _فارسی: README.fa.rst |
| 225 | +.. _Français: README.fr.rst |
| 226 | +.. _Español: README.es.rst |
| 227 | +.. _日本語: README.ja.rst |
| 228 | +.. _Italiano: README.it.rst |
0 commit comments