APRENDA

Pygame é uma biblioteca de Python feita pra criar jogos 2D. Ela cuida da janela, dos desenhos, dos sons e das teclas pra você.

No Vits, usamos a versão pygame-ce (Community Edition) — é a mesma coisa, mas atualizada e mais rápida.

Estrutura mínima: 1) `pygame.init()` liga o motor, 2) `pygame.display.set_mode((w,h))` cria a tela, 3) o loop principal `while rodando:` desenha tudo a 60 quadros por segundo.

GPIO = General Purpose Input/Output. São os pinos do Raspberry Pi onde você liga os botões físicos.

No seu Vits, cada botão tem um número de pino (ex: Esquerda = GPIO17). Você cria `Button(17)` e o gpiozero cuida do resto.

`btn.is_pressed` retorna True/False. `btn.when_pressed = funcao` chama uma função quando você aperta. Simples assim!

Aqui no Studio, simulamos isso com o módulo `gpio_web`. Quando comprar o Pi, troque `from gpio_web import Button` por `from gpiozero import Button`.

Todo jogo é um loop que se repete muito rápido. Cada volta do loop chama-se 'frame' (quadro).

Em cada frame você faz 3 coisas: 1) ler entrada (botões), 2) atualizar estado (mover personagens, checar colisão), 3) desenhar tudo na tela.

`relogio.tick(60)` força o jogo a rodar a 60 frames por segundo. Sem isso, o jogo roda muito rápido em PCs potentes.

Sempre limpe a tela com `TELA.fill((cor))` no começo do frame, senão fica rastro!

IndentationError: Python liga muito pra espaços. Use SEMPRE 4 espaços (ou TAB) no começo de cada bloco. Nunca misture os dois.

NameError: variável não foi declarada antes. Lembre-se: dentro de uma função, use `global x` se quiser modificar uma variável de fora.

Tela preta: você esqueceu o `pygame.display.flip()` no final do loop — é ele que MOSTRA o que você desenhou.

Jogo travou: você esqueceu de checar o evento `pygame.QUIT` — adicione `if ev.type == pygame.QUIT: rodando = False` no loop.