|
| 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_ είναι μια ελεύθερη και ανοικτού κώδικα βιβλιοθήκη πολλαπλών πλατφορμών. |
| 15 | +Χρησιμοποιεί το `Simple DirectMedia Layer library`_ και πολλές άλλες |
| 16 | +δημοφιλείς βιβλιοθήκες για να χρησιμοποιήσει αφαιρετικά τις περισσότερες βασικές συναρτήσεις, |
| 17 | +έτσι κάνοντας τη γραφή αυτών των προγραμμάτων μια πιο διαισθητική εργασία. |
| 18 | + |
| 19 | +Αυτή η διανομή ονομάζεται **'pygame - Έκδοση Κοινότητας'** ('pygame-ce' για συντομία). |
| 20 | + |
| 21 | +Είναι μια διακλάδωση από το αποθετήριο προέλευσης του έργου pygame από τους πρώην κεντρικούς προγραμματιστές, |
| 22 | +και δημιουργήθηκε μετά από απίθανες προκλήσεις που τους απέτρεψαν να συνεχίσουν την ανάπτυξη στο αποθετήριο προέλευσης. |
| 23 | +Η νέα διανομή στοχεύει στο να προσφέρει πιο συνεχή εκδόσεις, πολλαπλές διορθώσεις προβλημάτων και βελτιώσεις, |
| 24 | +και ένα πιο δημοκρατικό μοντέλο διακυβέρνησης. |
| 25 | + |
| 26 | +Νέοι συνεισφέροντες είναι ευπρόσδεκτοι! |
| 27 | + |
| 28 | + |
| 29 | +Εγκατάσταση |
| 30 | +------------ |
| 31 | + |
| 32 | +:: |
| 33 | + |
| 34 | + pip install pygame-ce |
| 35 | + |
| 36 | + |
| 37 | +Help |
| 38 | +Βοήθεια |
| 39 | +---- |
| 40 | + |
| 41 | +If you are just getting started with pygame, you should be able to |
| 42 | +get started fairly quickly. Pygame comes with many tutorials and |
| 43 | +introductions. There is also full reference documentation for the |
| 44 | +entire library. Browse the documentation on the `docs page`_. You |
| 45 | +can also browse the documentation locally by running |
| 46 | +``python -m pygame.docs`` in your terminal. If the docs aren't found |
| 47 | +locally, it'll launch the online website instead. |
| 48 | + |
| 49 | +The online documentation stays up to date with the development version |
| 50 | +of pygame on github. This may be a bit newer than the version of pygame |
| 51 | +you are using. To upgrade to the latest full release, run |
| 52 | +``pip install pygame-ce --upgrade`` in your terminal. |
| 53 | + |
| 54 | +Best of all, the examples directory has many playable small programs |
| 55 | +which can get you started playing with the code right away. |
| 56 | + |
| 57 | + |
| 58 | +Building From Source |
| 59 | +-------------------- |
| 60 | + |
| 61 | +If you want to use features that are currently in development, |
| 62 | +or you want to contribute to pygame-ce, you will need to build pygame-ce |
| 63 | +locally from its source code, rather than pip installing it. |
| 64 | + |
| 65 | +Installing from source is fairly automated. The most work will |
| 66 | +involve compiling and installing all the pygame dependencies. Once |
| 67 | +that is done, run the ``setup.py`` script which will attempt to |
| 68 | +auto-configure, build, and install pygame. |
| 69 | + |
| 70 | +Much more information about installing and compiling is available |
| 71 | +on the `Compilation wiki page`_. |
| 72 | + |
| 73 | + |
| 74 | +Credits |
| 75 | +------- |
| 76 | + |
| 77 | +Thanks to everyone who has helped contribute to this library. |
| 78 | +Special thanks are also in order. |
| 79 | + |
| 80 | +* Marcus Von Appen: many changes, and fixes, 1.7.1+ freebsd maintainer |
| 81 | +* Lenard Lindstrom: the 1.8+ windows maintainer, many changes, and fixes |
| 82 | +* Brian Fisher for svn auto builder, bug tracker and many contributions |
| 83 | +* Rene Dudfield: many changes, and fixes, 1.7+ release manager/maintainer |
| 84 | +* Phil Hassey for his work on the pygame.org website |
| 85 | +* DR0ID for his work on the sprite module |
| 86 | +* Richard Goedeken for his smoothscale function |
| 87 | +* Ulf Ekström for his pixel perfect collision detection code |
| 88 | +* Pete Shinners: original author |
| 89 | +* David Clark for filling the right-hand-man position |
| 90 | +* Ed Boraas and Francis Irving: Debian packages |
| 91 | +* Maxim Sobolev: FreeBSD packaging |
| 92 | +* Bob Ippolito: macOS and OS X porting (much work!) |
| 93 | +* Jan Ekhol, Ray Kelm, and Peter Nicolai: putting up with early design ideas |
| 94 | +* Nat Pryce for starting our unit tests |
| 95 | +* Dan Richter for documentation work |
| 96 | +* TheCorruptor for his incredible logos and graphics |
| 97 | +* Nicholas Dudfield: many test improvements |
| 98 | +* Alex Folkner for pygame-ctypes |
| 99 | + |
| 100 | +Thanks to those sending in patches and fixes: Niki Spahiev, Gordon |
| 101 | +Tyler, Nathaniel Pryce, Dave Wallace, John Popplewell, Michael Urman, |
| 102 | +Andrew Straw, Michael Hudson, Ole Martin Bjoerndalen, Herve Cauwelier, |
| 103 | +James Mazer, Lalo Martins, Timothy Stranex, Chad Lester, Matthias |
| 104 | +Spiller, Bo Jangeborg, Dmitry Borisov, Campbell Barton, Diego Essaya, |
| 105 | +Eyal Lotem, Regis Desgroppes, Emmanuel Hainry, Randy Kaelber, |
| 106 | +Matthew L Daniel, Nirav Patel, Forrest Voight, Charlie Nolan, |
| 107 | +Frankie Robertson, John Krukoff, Lorenz Quack, Nick Irvine, |
| 108 | +Michael George, Saul Spatz, Thomas Ibbotson, Tom Rothamel, Evan Kroske, |
| 109 | +Cambell Barton. |
| 110 | + |
| 111 | +And our bug hunters above and beyond: Angus, Guillaume Proux, Frank |
| 112 | +Raiser, Austin Henry, Kaweh Kazemi, Arturo Aldama, Mike Mulcheck, |
| 113 | +Michael Benfield, David Lau |
| 114 | + |
| 115 | +There's many more folks out there who've submitted helpful ideas, kept |
| 116 | +this project going, and basically made our life easier. Thanks! |
| 117 | + |
| 118 | +Many thank you's for people making documentation comments, and adding to the |
| 119 | +`pygame documentation`_ and the `pygame-ce documentation`_. |
| 120 | + |
| 121 | +Also many thanks for people creating games and putting them on the |
| 122 | +pygame.org website for others to learn from and enjoy. |
| 123 | + |
| 124 | +Lots of thanks to James Paige for hosting the pygame bugzilla. |
| 125 | + |
| 126 | +Also a big thanks to Roger Dingledine and the crew at SEUL.ORG for our |
| 127 | +excellent hosting. |
| 128 | + |
| 129 | +Dependencies |
| 130 | +------------ |
| 131 | + |
| 132 | +Pygame is obviously strongly dependent on SDL and Python. It also |
| 133 | +links to and embeds several other smaller libraries. The font |
| 134 | +module relies on SDL_ttf, which is dependent on freetype. The mixer |
| 135 | +(and mixer.music) modules depend on SDL_mixer. The image module |
| 136 | +depends on SDL_image. Transform.rotozoom has an embedded version |
| 137 | +of SDL_rotozoom, and gfxdraw has an embedded version of SDL_gfx. |
| 138 | +Dependency versions: |
| 139 | + |
| 140 | + |
| 141 | ++----------+------------------------+ |
| 142 | +| CPython | >= 3.9 (Or use PyPy3) | |
| 143 | ++----------+------------------------+ |
| 144 | +| SDL | >= 2.0.14 | |
| 145 | ++----------+------------------------+ |
| 146 | +| SDL_mixer| >= 2.0.4 | |
| 147 | ++----------+------------------------+ |
| 148 | +| SDL_image| >= 2.0.4 | |
| 149 | ++----------+------------------------+ |
| 150 | +| SDL_ttf | >= 2.0.15 | |
| 151 | ++----------+------------------------+ |
| 152 | + |
| 153 | +How to Contribute |
| 154 | +----------------- |
| 155 | +First of all, thank you for considering contributing to pygame-ce! It's people like you that make pygame-ce a great library. Please follow these steps to get started: |
| 156 | + |
| 157 | +1. Read the `Contribution Guidelines`_ and the `Many Ways to Contribute`_ wiki pages. |
| 158 | +2. Read the documentataion on `Opening A Pull Request`_ and `Opening a Great Pull Request`_. |
| 159 | +3. Read how to `label and link reported issues`_. |
| 160 | +4. Check the `issue tracker`_ for open issues that interest you or open a new issue to start a discussion about your idea. |
| 161 | + |
| 162 | +There are many more resources throughout the `wiki pages`_ that can help you get started. |
| 163 | + |
| 164 | +If you have any questions, please feel free to ask in the `Pygame Community Discord Server`_ or open an issue. |
| 165 | + |
| 166 | +License |
| 167 | +------- |
| 168 | +**License Identifier:** LGPL-2.1-or-later |
| 169 | + |
| 170 | +This library is distributed under `GNU LGPL version 2.1`_, which can |
| 171 | +be found in the file ``docs/LGPL.txt``. We reserve the right to place |
| 172 | +future versions of this library under a different license. |
| 173 | + |
| 174 | +This basically means you can use pygame in any project you want, |
| 175 | +but if you make any changes or additions to pygame itself, those |
| 176 | +must be released with a compatible license (preferably submitted |
| 177 | +back to the pygame-ce project). Closed source and commercial games are fine. |
| 178 | + |
| 179 | +The programs in the ``examples`` subdirectory are in the public domain. |
| 180 | + |
| 181 | +See docs/licenses for licenses of dependencies. |
| 182 | + |
| 183 | + |
| 184 | +.. |PyPiVersion| image:: https://img.shields.io/pypi/v/pygame-ce.svg?v=1 |
| 185 | + :target: https://pypi.python.org/pypi/pygame-ce |
| 186 | + |
| 187 | +.. |PyPiLicense| image:: https://img.shields.io/pypi/l/pygame-ce.svg?v=1 |
| 188 | + :target: https://pypi.python.org/pypi/pygame-ce |
| 189 | + |
| 190 | +.. |Python3| image:: https://img.shields.io/badge/python-3-blue.svg?v=1 |
| 191 | + |
| 192 | +.. |GithubCommits| image:: https://img.shields.io/github/commits-since/pygame-community/pygame-ce/2.5.2.svg |
| 193 | + :target: https://github.com/pygame-community/pygame-ce/compare/2.5.3...main |
| 194 | + |
| 195 | +.. |DocsStatus| image:: https://img.shields.io/website?down_message=offline&label=docs&up_message=online&url=https%3A%2F%2Fpyga.me%2Fdocs%2F |
| 196 | + :target: https://pyga.me/docs/ |
| 197 | + |
| 198 | +.. |BlackFormatBadge| image:: https://img.shields.io/badge/code%20style-black-000000.svg |
| 199 | + :target: https://github.com/psf/black |
| 200 | + |
| 201 | +.. _Pygame: https://pyga.me |
| 202 | +.. _pygame-ce documentation: https://pyga.me/docs/ |
| 203 | +.. _pygame documentation: https://www.pygame.org/docs/ |
| 204 | +.. _Simple DirectMedia Layer library: https://www.libsdl.org |
| 205 | +.. _Compilation wiki page: https://github.com/pygame-community/pygame-ce/wiki#compiling |
| 206 | +.. _docs page: https://pyga.me/docs |
| 207 | +.. _GNU LGPL version 2.1: https://www.gnu.org/copyleft/lesser.html |
| 208 | +.. _Contribution Guidelines: https://github.com/pygame-community/pygame-ce/wiki/Contribution-guidelines |
| 209 | +.. _Many Ways to Contribute: https://github.com/pygame-community/pygame-ce/wiki/Many-ways-to-contribute |
| 210 | +.. _Opening A Pull Request: https://github.com/pygame-community/pygame-ce/wiki/Opening-a-pull-request |
| 211 | +.. _Opening a Great Pull Request: https://github.com/pygame-community/pygame-ce/wiki/Opening-a-great-pull-request |
| 212 | +.. _issue tracker: https://github.com/pygame-community/pygame-ce/issues |
| 213 | +.. _label and link reported issues: https://github.com/pygame-community/pygame-ce/wiki/Labelling-&-linking-reported-issues |
| 214 | +.. _Pygame Community Discord Server: https://discord.gg/pygame |
| 215 | +.. _wiki pages: https://github.com/pygame-community/pygame-ce/wiki |
| 216 | + |
| 217 | +.. _简体中文: ./docs/readmes/README.zh-cn.rst |
| 218 | +.. _繁體中文: ./docs/readmes/README.zh-tw.rst |
| 219 | +.. _Français: ./docs/readmes/README.fr.rst |
| 220 | +.. _فارسی: ./docs/readmes/README.fa.rst |
| 221 | +.. _Español: ./docs/readmes/README.es.rst |
| 222 | +.. _日本語: ./docs/readmes/README.ja.rst |
| 223 | +.. _Italiano: ./docs/readmes/README.it.rst |
| 224 | +.. _Русский: ./docs/readmes/README.ru.rst |
| 225 | +.. _Ελληνικά: ./docs/readmes/README.gr.rst |
0 commit comments