pygame
pygame 2.6.1 - python 3.13 bugfix release
Pygame é uma biblioteca multiplataforma gratuita e de código aberto para o desenvolvimento de aplicativos multimídia como videogames usando Python. Ele usa a biblioteca Simple DirectMedia Layer e diversas outras bibliotecas populares para abstrair as funções mais comuns, tornando a escrita desses programas uma tarefa mais intuitiva.
Precisamos da sua ajuda para tornar o pygame o melhor possível! Novos contribuidores são bem-vindos.
Antes de instalar o pygame, você deve verificar se o Python está instalado em sua máquina. Para descobrir, abra um prompt de comando (se você tiver Windows) ou um terminal (se você tiver MacOS ou Linux) e digite isto:
python --versão
Se uma mensagem como "Python 3.8.10" aparecer, significa que o Python está instalado corretamente. Se aparecer uma mensagem de erro, significa que ainda não está instalado. Você deve então ir ao site oficial para baixá-lo.
Depois que o Python estiver instalado, você deverá realizar uma verificação final: você deverá ver se o pip está instalado. Geralmente, o pip vem pré-instalado com Python, mas nunca temos certeza. O mesmo que para Python, digite o seguinte comando:
pip --versão
Se uma mensagem como "pip 20.0.2 from /usr/lib/python3/dist-packages/pip (python 3.8)" aparecer, você está pronto para instalar o pygame! Para instalá-lo, digite este comando:
pip instalar pygame
Depois que o pygame estiver instalado, teste rapidamente sua biblioteca digitando o seguinte comando, que abre um dos muitos jogos de exemplo que vêm pré-instalados:
python3 -m pygame.examples.aliens
Se isso não funcionar, a seção Introdução do site oficial contém mais informações sobre problemas específicos da plataforma, como adicionar python às configurações de PATH da sua máquina.
Se você está apenas começando com o pygame, deverá conseguir começar rapidamente. Pygame vem com muitos tutoriais e introduções. Há também documentação de referência completa para toda a biblioteca. Navegue pela documentação na página de documentos. Você também pode navegar pela documentação localmente executando python -m pygame.docs em seu terminal. Se os documentos não forem encontrados localmente, o site on-line será lançado.
A documentação online permanece atualizada com a versão de desenvolvimento do pygame no GitHub. Isso pode ser um pouco mais recente que a versão do pygame que você está usando. Para atualizar para a versão completa mais recente, execute pip install pygame --upgrade em seu terminal.
O melhor de tudo é que o diretório de exemplos possui muitos pequenos programas jogáveis que podem ajudá-lo a começar a brincar com o código imediatamente.
Pygame é uma biblioteca poderosa para desenvolvimento de jogos, oferecendo uma ampla gama de recursos para simplificar sua jornada de codificação. Vamos nos aprofundar no que o pygame tem a oferecer:
Gráficos - Com o pygame, criar gráficos dinâmicos e envolventes nunca foi tão fácil. A biblioteca fornece ferramentas simples, mas eficazes para gráficos e animação 2D, incluindo suporte para imagens, retângulos e formas poligonais. Quer você seja um desenvolvedor de jogos experiente ou esteja apenas começando, o pygame tem o que você precisa.
Som - Pygame também inclui suporte para reprodução e manipulação de som e música, facilitando a adição de efeitos sonoros e música de fundo aos seus jogos. Com suporte para formatos de arquivo WAV, MP3 e OGG, você tem muitas opções para escolher.
Entrada - Pygame fornece funções intuitivas para lidar com entradas de teclado, mouse e joystick, permitindo que você implemente de forma rápida e fácil os controles do jogador em seus jogos. Chega de lutar com códigos de entrada complexos, o pygame torna isso simples.
Desenvolvimento de Jogos – Por último, pygame fornece um conjunto abrangente de ferramentas e recursos projetados especificamente para desenvolvimento de jogos. Da detecção de colisões ao gerenciamento de sprites, o pygame tem tudo que você precisa para criar jogos emocionantes e envolventes. Esteja você construindo um jogo de plataforma, um jogo de quebra-cabeça ou qualquer coisa entre eles, o pygame tem o que você precisa.
Se quiser usar recursos que estão atualmente em desenvolvimento ou quiser contribuir com o pygame, você precisará construir o pygame localmente a partir de seu código-fonte, em vez de instalá-lo por pip.
A instalação a partir da fonte é bastante automatizada. A maior parte do trabalho envolverá a compilação e instalação de todas as dependências do pygame. Feito isso, execute o script setup.py que tentará configurar, construir e instalar automaticamente o pygame.
Muito mais informações sobre instalação e compilação estão disponíveis na página wiki de Compilação.
Obrigado a todos que ajudaram a contribuir para esta biblioteca. Agradecimentos especiais também são necessários.
Obrigado aos que enviaram patches e correções: 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 nossos caçadores de insetos acima e além: Angus, Guillaume Proux, Frank Raiser, Austin Henry, Kaweh Kazemi, Arturo Aldama, Mike Mulcheck, Michael Benfield, David Lau
Há muito mais pessoas por aí que enviaram ideias úteis, deram continuidade a este projeto e basicamente tornaram nossa vida mais fácil. Obrigado!
Muito obrigado pelas pessoas que fazem comentários na documentação e adicionam informações ao wiki do pygame.org.
Também muito obrigado pelas pessoas que criam jogos e os colocam no site pygame.org para que outros possam aprender e se divertir.
Muito obrigado a James Paige por hospedar o pygame bugzilla.
Também um grande obrigado a Roger Dingledine e à equipe do SEUL.ORG por nossa excelente hospedagem.
Obviamente, Pygame é fortemente dependente de SDL e Python. Ele também vincula e incorpora várias outras bibliotecas menores. O módulo de fonte depende de SDL_ttf, que depende de freetype. Os módulos mixer (e mixer.music) dependem do SDL_mixer. O módulo de imagem depende de SDL_image, que também pode usar libjpeg e libpng. O módulo de transformação possui uma versão incorporada de SDL_rotozoom para sua própria função rotozoom. O módulo surfarray requer o pacote Python NumPy para seus arrays numéricos multidimensionais. Versões de dependência:
| CPython | >= 3.6 (ou use PyPy3) |
| SDL | >= 2.0.8 |
| SDL_mixer | >= 2.0.0 |
| Imagem_SDL | >= 2.0.2 |
| SDL_ttf | >= 2.0.11 |
| SDL_gfx | (Opcional, vendido em) |
| NumPy | >= 1.6.2 (Opcional) |
Esta biblioteca é distribuída sob GNU LGPL versão 2.1, que pode ser encontrada no arquivo docs/LGPL.txt . Reservamo-nos o direito de colocar versões futuras desta biblioteca sob uma licença diferente.
Isso basicamente significa que você pode usar o pygame em qualquer projeto que desejar, mas se fizer quaisquer alterações ou acréscimos ao próprio pygame, elas deverão ser lançadas com uma licença compatível (de preferência enviada de volta ao projeto pygame). Jogos comerciais e de código fechado são adequados.
Os programas no subdiretório de examples são de domínio público.
Consulte documentos/licenças para licenças de dependências.
