Codificador FLAC

Propósito e alcance: o codificador FLAC converte entradas PCM em FLAC mantendo a qualidade sem perda para arquivamento, distribuição e produção. Usuários-alvo incluem engenheiros de áudio, desenvolvedores de software e pesquisadores que exigem codificação repetível com metadados em pipelines automatizados. Casos de uso incluem converter WAV/PCM para FLAC para distribuição, arquivamento de masters ou integração da codificação em scripts de build.
Lógica central e recursos: a ferramenta implementa um codificador FLAC sem perdas com opções obrigatórias e avançadas. Entradas obrigatórias: source_audio (PCM WAV/RAW), sample_rate (Hz), channels (1 ou 2) e bits_per_sample (16 ou 24). Entradas opcionais/avançadas: compression_level (0–8), block_size, verify_checksum e metadata_tags. Saídas: flac_file (binário), duration_sec, sample_rate_out, channels_out, bits_per_sample_out e size_bytes. Suporta processamento em lote e enriquecimento de metadados via Vorbis-comments.
Entradas e saídas: Entradas incluem source_audio (arquivo/Blob), sample_rate, channels, bits_per_sample, compression_level e metadata_tags. Saídas fornecem um arquivo FLAC com duração, sample_rate_out, channels_out, bits_per_sample_out e tamanho do arquivo. Algoritmos: Codificação conforme o padrão FLAC: decodificar PCM, aplicar compressão sem perda no nível escolhido e escrever um fluxo FLAC com info de fluxo e metadados. A duração é calculada a partir do número de amostras de entrada e a taxa de amostragem. O bitrate é informado como intervalo aproximado dependendo do nível de compressão e do conteúdo.
Tratamento de erros e casos extremos: entradas não-PCM ou inválidas geram erros de domínio; entradas obrigatórias ausentes, taxas de amostra não suportadas ou profundidade de bits incompatível geram códigos de erro precisos. Padrões da indústria: arquivos FLAC usam a extensão .flac e PCM de 16 ou 24 bits; considerações de localização incluem campos de metadados neutros e suporte a Vorbis. Suposições e exclusões: assume-se entrada PCM linear; não há transcodificação para formatos com perda, nem codificação em streaming ou modificação de dados não audio.