jamailmar Files

# Vorbis3 — Decodificador Ogg Vorbis Multithread

Decodificador de áudio Ogg Vorbis para WAV PCM 16-bit com arquitetura de
paralelismo massivo herdada do motor de compressão Gzip3.

## Arquitetura de Paralelismo

O arquivo de áudio é particionado em **N segmentos PCM independentes**.
Cada thread abre seu próprio handle `OggVorbis_File`, seeka para sua faixa
e decodifica concorrentemente. Os segmentos são concatenados no final com
trimagem automática de overlap entre as bordas.

### Componentes

| Componente | Descrição |
|---|---|
| `controladores_memoria[64]` | Semáforos de barramento — 1 thread por controlador |
| `Compartments[64]` | Work stealing — threads ociosas roubam tarefas de outros compartimentos |
| NUMA affinity | Threads pinadas a CPUs físicas primeiro, SMT depois |
| P-core / E-core | Classificação por frequência máxima do cpufreq |
| Overlap trim | Ajuste fino das bordas entre segmentos via `ov_pcm_tell` |
| Buffer dinâmico | `realloc` progressivo — sem estouro |

## Compilação

```bash
make
```

Dependências: `libvorbis-dev`, `libogg-dev`.

## Uso

```bash
./vorbis_decoder <entrada.ogg> <saida.wav> <threads>
```

Exemplo:
```bash
./vorbis_decoder musica.ogg musica.wav 8
```

## Licença

Código aberto. Livre para uso, modificação e distribuição.