|
| 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`_ `Русский`_ `Ελληνικά`_ **Português (Brasil)** |
| 12 | +------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| 13 | + |
| 14 | +Pygame_ é uma biblioteca gratuita e de código aberto, multiplataforma, |
| 15 | +para o desenvolvimento de aplicações multimídia, como videogames, usando Python. |
| 16 | +Ela utiliza a `Simple DirectMedia Layer library`_ e várias outras bibliotecas |
| 17 | +populares para abstrair as funções mais comuns, tornando a escrita |
| 18 | +desses programas uma tarefa mais intuitiva. |
| 19 | + |
| 20 | +Essa distribuição é chamada **'pygame - Community Edition'** (abreviado como 'pygame-ce'). |
| 21 | + |
| 22 | +É um fork do projeto pygame original, criado por antigos desenvolvedores principais, |
| 23 | +e surgiu após desafios impossíveis impedirem a continuação do desenvolvimento upstream. |
| 24 | +A nova distribuição tem como objetivo oferecer lançamentos mais frequentes, correções e melhorias contínuas, |
| 25 | +além de um modelo de governança mais democrático. |
| 26 | + |
| 27 | +Novos contribuidores são bem-vindos! |
| 28 | + |
| 29 | + |
| 30 | +Instalação |
| 31 | +---------- |
| 32 | + |
| 33 | +:: |
| 34 | + |
| 35 | + pip install pygame-ce |
| 36 | + |
| 37 | + |
| 38 | +Ajuda |
| 39 | +----- |
| 40 | + |
| 41 | +Se você está começando com pygame, deve conseguir iniciar rapidamente. |
| 42 | +O Pygame vem com muitos tutoriais e introduções. |
| 43 | +Também há documentação completa de referência para toda a biblioteca. |
| 44 | +Consulte a documentação na `página de docs`_. |
| 45 | +Você também pode acessar a documentação localmente executando |
| 46 | +``python -m pygame.docs`` no terminal. |
| 47 | +Se os docs não forem encontrados localmente, será aberto o site oficial. |
| 48 | + |
| 49 | +A documentação online é atualizada com a versão de desenvolvimento |
| 50 | +do pygame no GitHub. Isso pode ser um pouco mais recente que a versão do pygame |
| 51 | +que você está usando. Para atualizar para o último lançamento completo, rode: |
| 52 | +``pip install pygame-ce --upgrade`` no terminal. |
| 53 | + |
| 54 | +O melhor de tudo é que o diretório de exemplos contém vários pequenos programas jogáveis |
| 55 | +que permitem brincar com o código imediatamente. |
| 56 | + |
| 57 | + |
| 58 | +Compilando do Código-Fonte |
| 59 | +-------------------------- |
| 60 | + |
| 61 | +Se você deseja usar funcionalidades que estão em desenvolvimento, |
| 62 | +ou contribuir para o pygame-ce, precisará compilar o pygame-ce |
| 63 | +localmente a partir do código-fonte, em vez de instalar via pip. |
| 64 | + |
| 65 | +A instalação a partir do código-fonte é bastante automatizada. |
| 66 | +A maior parte do trabalho envolve compilar e instalar todas as dependências do pygame. |
| 67 | +Depois disso, execute o script ``setup.py``, que tentará |
| 68 | +auto-configurar, compilar e instalar o pygame. |
| 69 | + |
| 70 | +Mais informações sobre instalação e compilação estão disponíveis |
| 71 | +na `página de compilação do wiki`_. |
| 72 | + |
| 73 | + |
| 74 | +Créditos |
| 75 | +-------- |
| 76 | + |
| 77 | +Obrigado a todos que ajudaram a contribuir com esta biblioteca. |
| 78 | +Agradecimentos especiais também são devidos. |
| 79 | + |
| 80 | +* Marcus Von Appen: muitas mudanças e correções, mantenedor FreeBSD 1.7.1+ |
| 81 | +* Lenard Lindstrom: mantenedor Windows 1.8+, muitas mudanças e correções |
| 82 | +* Brian Fisher: construtor automático svn, rastreador de bugs e muitas contribuições |
| 83 | +* Rene Dudfield: muitas mudanças e correções, gerente de lançamentos/mantenedor 1.7+ |
| 84 | +* Phil Hassey: pelo trabalho no site pygame.org |
| 85 | +* DR0ID: pelo trabalho no módulo sprite |
| 86 | +* Richard Goedeken: pela função smoothscale |
| 87 | +* Ulf Ekström: pelo código de detecção de colisão pixel-perfect |
| 88 | +* Pete Shinners: autor original |
| 89 | +* David Clark: pelo apoio como braço direito |
| 90 | +* Ed Boraas e Francis Irving: pacotes Debian |
| 91 | +* Maxim Sobolev: empacotamento FreeBSD |
| 92 | +* Bob Ippolito: port para macOS e OS X (muito trabalho!) |
| 93 | +* Jan Ekhol, Ray Kelm, e Peter Nicolai: por aguentarem ideias de design iniciais |
| 94 | +* Nat Pryce: por iniciar nossos testes unitários |
| 95 | +* Dan Richter: pelo trabalho de documentação |
| 96 | +* TheCorruptor: pelos logos e gráficos incríveis |
| 97 | +* Nicholas Dudfield: por muitas melhorias nos testes |
| 98 | +* Alex Folkner: pelo pygame-ctypes |
| 99 | + |
| 100 | +Agradecimentos a todos que enviaram patches e correções: |
| 101 | +Niki Spahiev, Gordon 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 Spiller, |
| 104 | +Bo Jangeborg, Dmitry Borisov, Campbell Barton, Diego Essaya, Eyal Lotem, |
| 105 | +Regis Desgroppes, Emmanuel Hainry, Randy Kaelber, Matthew L Daniel, Nirav Patel, |
| 106 | +Forrest Voight, Charlie Nolan, Frankie Robertson, John Krukoff, Lorenz Quack, |
| 107 | +Nick Irvine, Michael George, Saul Spatz, Thomas Ibbotson, Tom Rothamel, |
| 108 | +Evan Kroske, Cambell Barton. |
| 109 | + |
| 110 | +E aos caçadores de bugs que foram além: Angus, Guillaume Proux, Frank Raiser, Austin Henry, |
| 111 | +Kaweh Kazemi, Arturo Aldama, Mike Mulcheck, Michael Benfield, David Lau. |
| 112 | + |
| 113 | +Há muitas outras pessoas que enviaram ideias úteis, mantiveram este projeto vivo e |
| 114 | +basicamente tornaram nossa vida mais fácil. Obrigado! |
| 115 | + |
| 116 | +Muito obrigado também a todos que fizeram comentários na documentação, contribuíram para a |
| 117 | +`documentação do pygame`_ e a `documentação do pygame-ce`_. |
| 118 | + |
| 119 | +E obrigado a todos que criam jogos e os publicam no site pygame.org para que outros possam aprender e se divertir. |
| 120 | + |
| 121 | +Muitos agradecimentos a James Paige por hospedar o bugzilla do pygame. |
| 122 | +E um grande obrigado a Roger Dingledine e à equipe do SEUL.ORG pelo excelente serviço de hospedagem. |
| 123 | + |
| 124 | + |
| 125 | +Dependências |
| 126 | +------------ |
| 127 | + |
| 128 | +O Pygame depende fortemente do SDL e do Python. |
| 129 | +Também faz uso e incorpora várias outras bibliotecas menores. |
| 130 | +O módulo de fontes depende do SDL_ttf, que depende do freetype. |
| 131 | +Os módulos mixer (e mixer.music) dependem do SDL_mixer. |
| 132 | +O módulo image depende do SDL_image. |
| 133 | +Transform.rotozoom contém uma versão embutida do SDL_rotozoom, |
| 134 | +e gfxdraw contém uma versão embutida do SDL_gfx. |
| 135 | +Versões de dependências: |
| 136 | + |
| 137 | ++----------+------------------------+ |
| 138 | +| CPython | >= 3.9 (Ou use PyPy3) | |
| 139 | ++----------+------------------------+ |
| 140 | +| SDL | >= 2.0.14 | |
| 141 | ++----------+------------------------+ |
| 142 | +| SDL_mixer| >= 2.0.4 | |
| 143 | ++----------+------------------------+ |
| 144 | +| SDL_image| >= 2.0.4 | |
| 145 | ++----------+------------------------+ |
| 146 | +| SDL_ttf | >= 2.0.15 | |
| 147 | ++----------+------------------------+ |
| 148 | + |
| 149 | + |
| 150 | +Como Contribuir |
| 151 | +--------------- |
| 152 | + |
| 153 | +Antes de tudo, obrigado por considerar contribuir com o pygame-ce! |
| 154 | +São pessoas como você que tornam o pygame-ce uma ótima biblioteca. |
| 155 | +Siga estes passos para começar: |
| 156 | + |
| 157 | +1. Leia as `Diretrizes de Contribuição`_ e a página de wiki `Muitas Formas de Contribuir`_. |
| 158 | +2. Leia a documentação sobre `Abrindo um Pull Request`_ e `Abrindo um Pull Request de Qualidade`_. |
| 159 | +3. Leia como `rotular e vincular issues reportadas`_. |
| 160 | +4. Confira o `rastreador de issues`_ para ver as issues abertas que te interessam ou abra uma nova issue para iniciar uma discussão sobre sua ideia. |
| 161 | + |
| 162 | +Existem muitos outros recursos nas `páginas do wiki`_ que podem ajudar você a começar. |
| 163 | + |
| 164 | +Se tiver dúvidas, sinta-se à vontade para perguntar no `Servidor Discord da Comunidade Pygame`_ ou abrir uma issue. |
| 165 | + |
| 166 | + |
| 167 | +Licença |
| 168 | +------- |
| 169 | + |
| 170 | +**Identificador de Licença:** LGPL-2.1-or-later |
| 171 | + |
| 172 | +Esta biblioteca é distribuída sob a `GNU LGPL versão 2.1`_, que pode ser encontrada no arquivo ``docs/LGPL.txt``. |
| 173 | +Reservamos o direito de disponibilizar versões futuras desta biblioteca sob uma licença diferente. |
| 174 | + |
| 175 | +Isso basicamente significa que você pode usar pygame em qualquer projeto que quiser, |
| 176 | +mas se fizer alterações ou adições ao próprio pygame, estas |
| 177 | +devem ser lançadas com uma licença compatível (de preferência submetidas |
| 178 | +de volta ao projeto pygame-ce). Jogos comerciais e de código fechado são permitidos. |
| 179 | + |
| 180 | +Os programas no subdiretório ``examples`` estão em domínio público. |
| 181 | + |
| 182 | +Veja em docs/licenses as licenças das dependências. |
| 183 | + |
| 184 | + |
| 185 | +.. |PyPiVersion| image:: https://img.shields.io/pypi/v/pygame-ce.svg?v=1 |
| 186 | + :target: https://pypi.python.org/pypi/pygame-ce |
| 187 | + |
| 188 | +.. |PyPiLicense| image:: https://img.shields.io/pypi/l/pygame-ce.svg?v=1 |
| 189 | + :target: https://pypi.python.org/pypi/pygame-ce |
| 190 | + |
| 191 | +.. |Python3| image:: https://img.shields.io/badge/python-3-blue.svg?v=1 |
| 192 | + |
| 193 | +.. |GithubCommits| image:: https://img.shields.io/github/commits-since/pygame-community/pygame-ce/2.5.2.svg |
| 194 | + :target: https://github.com/pygame-community/pygame-ce/compare/2.5.3...main |
| 195 | + |
| 196 | +.. |DocsStatus| image:: https://img.shields.io/website?down_message=offline&label=docs&up_message=online&url=https%3A%2F%2Fpyga.me%2Fdocs%2F |
| 197 | + :target: https://pyga.me/docs/ |
| 198 | + |
| 199 | +.. |BlackFormatBadge| image:: https://img.shields.io/badge/code%20style-black-000000.svg |
| 200 | + :target: https://github.com/psf/black |
| 201 | + |
| 202 | +.. _Pygame: https://pyga.me |
| 203 | +.. _documentação do pygame-ce: https://pyga.me/docs/ |
| 204 | +.. _documentação do pygame: https://www.pygame.org/docs/ |
| 205 | +.. _Simple DirectMedia Layer library: https://www.libsdl.org |
| 206 | +.. _página de compilação do wiki: https://github.com/pygame-community/pygame-ce/wiki#compiling |
| 207 | +.. _página de docs: https://pyga.me/docs |
| 208 | +.. _GNU LGPL versão 2.1: https://www.gnu.org/copyleft/lesser.html |
| 209 | +.. _Diretrizes de Contribuição: https://github.com/pygame-community/pygame-ce/wiki/Contribution-guidelines |
| 210 | +.. _Muitas Formas de Contribuir: https://github.com/pygame-community/pygame-ce/wiki/Many-ways-to-contribute |
| 211 | +.. _Abrindo um Pull Request: https://github.com/pygame-community/pygame-ce/wiki/Opening-a-pull-request |
| 212 | +.. _Abrindo um Pull Request de Qualidade: https://github.com/pygame-community/pygame-ce/wiki/Opening-a-great-pull-request |
| 213 | +.. _rastreador de issues: https://github.com/pygame-community/pygame-ce/issues |
| 214 | +.. _rotular e vincular issues reportadas: https://github.com/pygame-community/pygame-ce/wiki/Labelling-&-linking-reported-issues |
| 215 | +.. _Servidor Discord da Comunidade Pygame: https://discord.gg/pygame |
| 216 | +.. _páginas do wiki: https://github.com/pygame-community/pygame-ce/wiki |
| 217 | + |
| 218 | +.. _English: ./../../README.rst |
| 219 | +.. _简体中文: README.zh-cn.rst |
| 220 | +.. _繁體中文: README.zh-tw.rst |
| 221 | +.. _Français: README.fr.rst |
| 222 | +.. _فارسی: README.fa.rst |
| 223 | +.. _Español: README.es.rst |
| 224 | +.. _日本語: README.ja.rst |
| 225 | +.. _Italiano: README.it.rst |
| 226 | +.. _Русский: README.ru.rst |
| 227 | +.. _Ελληνικά: README.gr.rst |
| 228 | +.. _Português (Brasil): README.pt-br.rst |
0 commit comments