Scenes, Audio, e Tilemaps

Curso de Desenvolvimento de Jogos com Pygame

Felipe A. Moreno-Vera

🔊 Audio

Arquitetura do pygame.mixer

O sistema de áudio do Pygame tem dois componentes principais:

┌─────────────────────────────────────────────────────┐
│                  pygame.mixer                       │
│                                                     │
│  pygame.mixer.music      pygame.mixer.Sound         │
│  ─────────────────       ─────────────────          │
│  • Streaming playback    • Loaded fully in RAM      │
│  • One track at a time   • Multiple instances       │
│  • MP3 / OGG / WAV       • Short clips only         │
│  • For background music  • For sound effects        │
│                                                     │
│  Channels: 0 ──── 1 ──── 2 ──── ... ──── N-1       │
│  Each Sound plays on one channel at a time          │
└─────────────────────────────────────────────────────┘

Arquitetura do pygame.mixer

O sistema de áudio do Pygame tem dois componentes principais:

┌─────────────────────────────────────────────────────┐
│                  pygame.mixer                       │
│                                                     │
│  pygame.mixer.music      pygame.mixer.Sound         │
│  ─────────────────       ─────────────────          │
│  • Streaming playback    • Loaded fully in RAM      │
│  • One track at a time   • Multiple instances       │
│  • MP3 / OGG / WAV       • Short clips only         │
│  • For background music  • For sound effects        │
│                                                     │
│  Channels: 0 ──── 1 ──── 2 ──── ... ──── N-1       │
│  Each Sound plays on one channel at a time          │
└─────────────────────────────────────────────────────┘

Inicialização

# MUST be called before pygame.init()
pygame.mixer.pre_init(
    frequency = 44100,   # Sample rate (Hz). 44100 = CD quality
    size      = -16,     # Bit depth. -16 = 16-bit signed
    channels  = 2,       # 1 = mono, 2 = stereo
    buffer    = 512      # Smaller = less latency, more CPU
)
pygame.init()

Música de Fundo

# Load and stream (file stays on disk, not loaded into RAM)
pygame.mixer.music.load("music/background.ogg")
pygame.mixer.music.set_volume(0.7)    # 0.0 to 1.0
pygame.mixer.music.play(loops=-1)     # -1 = infinite loop
pygame.mixer.music.play(loops=3)      # Play 3 times

# Control
pygame.mixer.music.pause()
pygame.mixer.music.unpause()
pygame.mixer.music.stop()
pygame.mixer.music.fadeout(2000)      # Fade out over 2000ms

# Query state
pos_ms = pygame.mixer.music.get_pos()   # Current position in ms
is_playing = pygame.mixer.music.get_busy()

Efeitos Sonoros (SFX)

# Load fully into memory (use for short clips)
jump_sfx = pygame.mixer.Sound("sfx/jump.wav")
jump_sfx.set_volume(0.8)

# Play — returns the Channel it plays on
channel = jump_sfx.play()             # Any free channel
channel = jump_sfx.play(loops=2)      # Play 3 times total
channel = jump_sfx.play(maxtime=500)  # Stop after 500ms

# If no free channel is available, returns None
if channel is None:
    print("Nenhum Channel livre!")

Channels

O Pygame tem N Channels de mixer (8 por padrão). Cada Sound é reproduzido em um Channel por vez.

pygame.mixer.set_num_channels(16)

# Reserve a specific channel for a category
music_ch = pygame.mixer.Channel(7)
music_ch.play(bg_sound, loops=-1)
music_ch.set_volume(0.5)

# Stereo panning: set_volume(left, right)
music_ch.set_volume(0.8, 0.2)   # Panned left

# Query
music_ch.get_busy()             # Is something playing?
music_ch.stop()
music_ch.pause()
music_ch.fadeout(1000)

Channels

Spatial audio — stereo pan por posição
=============================================
  posição x      pan      vol esq      vol dir
  --------------------------------------------
  x=0             -1.00    1.0           0.0
  x=150           -0.67    1.0           0.33
  x=300           -0.33    1.0           0.67
  x=450           +0.00    1.0           1.0
  x=600           +0.33    0.67          1.0
  x=750           +0.67    0.33          1.0
  x=900           +1.00    0.0           1.0

Hierarquia de Volume

# Three independent volume levels that multiply together
# Final volume = master * category * sound

# 1. Per-sound volume
sfx.set_volume(0.8)

# 2. Per-channel volume
channel.set_volume(0.7)

# 3. No true "master" in pygame — simulate with a multiplier
master_volume = 0.5

def play_sfx(sound, master=1.0):
    ch = sound.play()
    if ch:
        current = sound.get_volume()
        ch.set_volume(current * master)

Audios — Resumo

• pygame.mixer.pre_init() deve ser chamado antes de pygame.init()
• music faz streaming a partir do disco — use para faixas de fundo longas
• Sound é carregado totalmente na RAM — use apenas para SFX curtos
• Cada Sound é reproduzido em um Channel; reserve channels para categorias
• Panning estéreo: channel.set_volume(left, right)
• Atenuação por distância: volume = max(0, 1 - distance / max_dist)