Uma pequena introdução ao pygame - 00
Fala Dev🖖
Neste post, vou fornecer uma breve introdução ao PyGame e mostrar como podemos aprender algoritmos e Design Patterns através de jogos em futuros posts. No entanto, hoje vamos focar nos conceitos básicos do PyGame. Você está pronto para embarcar nessa jornada??
Introdução
Bem, para ser breve e direto ao ponto, o principal objetivo do PyGame é permitir o desenvolvimento de games utilizando a linguagem Python. Mas o foco do Pygame é apenas jogos em 2D e não 3D. Neste artigo vamos aprender o básico sobre o PyGame e alguns comandos legais.
Instalando o PyGame
⚠️ Antes de começar a codar e ver as funções, vamos precisar instalar o PyGame.
Para poder usar o PyGame vai ser preciso instalar o Python. Caso você não tenha o Python instalado na sua máquina basta acessar esse link: https://www.python.org/downloads e instalar a versão mais recente.
se você estiver no Linux basta usar esse comando no seu terminal:
sudo apt-get update
sudo apt-get install python3
Agora com o Python instalado, vamos instalar o PyGame. Basta executar esses comandos abaixo no seu cmd/terminal.
- para instalar basta usar este comando:
pip install pygame
- se você estiver no Linux basta usar este comando:
pip3 install pygame
Para testar se o PyGame foi instalado corretamente, basta importar a biblioteca e executar o Script.
import pygame
Se não aparecer nenhuma mensagem de erro, show, está tudo pronto para poder começar a codar e criar seu primeiro jogo com Python.
Criando a primeira janela com PyGame
para criar uma janela onde sera renderizado o jogo com PyGame é bem simples:
import pygame, sys
from pygame.locals import *
pygame.init()
SURFACE = pygame.display.set_mode((300,300))
pygame.display.set_caption("caption")
while True:
for event in pygame.event.get():
if event.type == QUIT:
pygame.quit()
sys.exit()
pygame.display.update()
Vamos aprender o que cada função serve.
import pygame, sys
A primeira linha do código estamos um import
que importa o pygame
e o sys
que nos permite usar as diversas funções como gráfico, sons e entre outras features disponíveis.
from pygame.locals import *
Neste trecho de código, estamos importando todos os nomes (funções, classes, constantes etc.) do módulo pygame.locals
. Assim nos permitindo usar funções, classes, constantes só pelo nome, sem a necessidade de usar prefixo para chamar uma função pygame.locals.funcao_x()
.
pygame.init()
O init()
é a função inicial do projeto, você não precisa saber o que ela faz, mas esta função tem que esta presente para que outras funções do PyGame possa funcionar.
SURFACE = pygame.display.set_mode((tamanho_eixo_X, tamanho_eixo_Y))
Já a função pygame.display.set_mode((tamanho, tamanho))
é utilizada para definir o tamanho da janela do jogo. Observe que a função recebe dois valores em uma tuple onde será definido o tamanho. O primeiro valor da tupla está relacionada ao tamanho do eixo X (Horizontal) e o segundo valor corresponde ao tamanho do eixo Y (vertical). A constante SURFACE
vai ser explicado em outro post fututo, mas para não deixar dúvida ela vai armazenar o objeto pygame.Surface para fazer algumas configurações/alterações.
pygame.display.set_caption("caption")
Não vou falar muito sobre esta função. Mas de forma direta, ela vai servir para adicionar um título a sua janela.
while True:
for event in pygame.event.get():
Nesta parte vamos precisar de um loop
para que o programa não feche na primeira vez que executar. Esse loop
vai ser importante porque nele vamos gerenciar todos os eventos, ações e atualizações que precisamos fazer no jogo.
Observe que dentro do while
utilizamos um segundo loop for
, para percorrer sobre uma lista de eventos retornada pela função pygame.event.get()
. Essa função é responsável por pegar todos os eventos/ações do jogo. Nela podemos verificar se alguma tecla do teclado foi pressionada, se existe alguma ação do mouse ou se o usuário deseja fechar a janela do jogo.
if event.type == QUIT:
pygame.quit()
sys.exit()
Não vou me aprofundar neste trecho do código. Mas basicamente, esse trecho vai verificar se exite algum evento de fechamento da janela. A função pygame.quit()
vai ser importante, pois, com ela vamos desativar a biblioteca corretamente, liberando todos os recursos associados a ela como a limpeza da memória o fechamento da janela e a liberação de outros recursos do sistema que foram alocados durante a execução do programa. E o sys.exit()
vai encerrar o programa imediatamente.
pygame.display.update()
A função pygame.display.update()
desempenha o papel de atualizar toda a área da tela. Porém, neste post, não nos aprofundaremos nela.
Desenhado figuras com pygame
import pygame, sys
from pygame.locals import *
pygame.init()
DISPLAYSURF = pygame.display.set_mode((500,500))
pygame.display.set_caption("caption")
# configurando cores
BLACK = ( 0,0,0)
WHITE = (255, 255, 255)
RED = (255,0,0)
GREEN = ( 0, 255,0)
BLUE = ( 0,0, 255)
# mudar a cor de fundo
DISPLAYSURF.fill((255, 255, 255))
#desenhando figuras
pygame.draw.rect(DISPLAYSURF, RED, (200, 150, 100, 50))
pygame.draw.ellipse(DISPLAYSURF, RED, (300, 250, 40, 80), 1)
pygame.draw.circle(DISPLAYSURF, BLUE, (300, 50), 20, 0)
while True:
for event in pygame.event.get():
if event.type == QUIT:
pygame.quit()
sys.exit()
pygame.display.update()
Antes de mostrar as funções de desenho, vamos ver algumas observações no código!
1. A função fill()
vai ser responsável por mudar a cor do Background da janela. No exemplo que fiz, eu mudei a cor de fundo para branco. Observe que as cores recebe três valores em uma tuple onde a primeira posição é responsável pela cor vermelha
a segunda pela cor verde
e a última pela cor azul
, RGB
.
2. As constantes RED
, BLACK
, WHITE
, GREEN
e BLUE
são responsáveis pelas cores. Observe o seguinte que elas recebem três valores em uma tuple.
Agora vamos ver as funções:
-
pygame.draw.rect(DISPLAYSURF, Cor, Retângulo, Espessura)
função utilizada para desenhae retângulo.- Retângulo define a posição e o tamanho do retângulo. A tupla consiste em (x, y, largura, altura).
- Espessura é responsavel por definir a espessura da linha de contorno do retângulo. Se não for especificado, a espessura padrão é 0, o que significa que o retângulo será preenchido com a cor definida.
- Cor é uma tupla de três valores que representa a cor do retângulo no formato RGB (vermelho, verde e azul).
-
pygame.draw.ellipse(DISPLAYSURF, Cor, Elipse, Espessura)
função utilizada para desenhar uma elipse.- Elipse define a posição e o tamanho do retângulo. A tupla consiste em (x, y, largura, altura).
- Espessura é responsável por definir a espessura da linha de contorno do retângulo. Se não for especificado, a espessura padrão é 0, o que significa que o retângulo será preenchido com a cor definida.
- Cor é uma tupla de três valores que representa a cor do retângulo no formato RGB (vermelho, verde e azul).
-
pygame.draw.circle(DISPLAYSURF, Cor, Centro, Raio, Espessura)
função utilizada para desenhar círculos.- Centro define a posição e o tamanho do retângulo. A tupla recebe (x, y) posição onde o círculo vai ser desenhado.
- Raio parâmetro que define o raio do círculo.
- Espessura é responsável por definir a espessura da linha de contorno do retângulo. Se não for especificado, a espessura padrão é 0, o que significa que o retângulo será preenchido com a cor definida.
- Cor é uma tupla de três valores que representa a cor do retângulo no formato RGB (vermelho, verde e azul).
Existem outras função, mas não vou abordar neste post. Porém, na documentação do PyGame explica com mais detalhe sobre cada funções.
Conclusão
Obrigado a você que leu até aqui!
Espero que tenha gostado do post, pois é a minha primeira postagem com foco em um tutorial. Espero que tenha sido mais simples e direto nas minhas explicações. Se você quiser compartilhar com mais conhecimento nesse post, deixe seu comentário.
Lembrando que o foco deste post é uma rápida e pequena introdução ao PyGame. Pois existe diversa coisa a ser discutida sobre o PyGame que não acaba aqui.