Repolode
Enviar
emef2247

emef2247/x68k_vgm2mml

Ferramenta em Python que converte logs de registradores de chips de som VGM para X68000 em MML estruturado e IR de PCM, com compilação opcional para MDX/PDX.

Ver no GitHub
Estrelas
13
Forks
0
Issues abertas
0
Último commit
anteontem

O que é?

x68k_vgm2mml lê arquivos VGM, que registram gravações em registradores de chips de som em vez de notas, e reconstrói informações de altura, duração, volume e timbre. A saída é MML estruturado para o formato MDX usado no Sharp X68000, além de dados de representação intermediária de PCM.

A ferramenta abrange vários chips, incluindo OPM (YM2151), OPNA (YM2608), PSG/SSG, SCC, DCSG (família SN76489), PCM no estilo MSM6258, SegaPCM e C140. Chips sem equivalente direto em OPM são aproximados projetando seus sons em vozes de síntese FM OPM ou síntese aditiva; como alternativa, o PSG pode ser direcionado para PCM.

Um script em lote, export_mdx.py, pode converter um diretório de arquivos VGM e também chamar compiladores externos de MDX e PDX, como MXC ou mmlx e soundlog. A opção --force ignora elementos não compatíveis e emite diagnósticos, enquanto --no-song-loop gera uma única reprodução, em vez de uma música em loop. A conversão não garante uma correspondência com o áudio original, então a saída deve ser conferida em hardware real ou em um emulador.

Recursos principais

  • 01Extrai notas, duração, volume e timbre das gravações em registradores VGM.
  • 02Gera MML estruturado para reprodução de MDX no X68000.
  • 03Aproxima sons de OPNA, PSG, SCC e DCSG usando vozes OPM.
  • 04Gera representação intermediária de PCM e dados PDX para chips PCM.
  • 05Converte diretórios em lote, com opção de ignorar elementos e emitir diagnósticos.

Casos de uso

  • Converter dumps de jogos ou músicas em VGM para arquivos MDX destinados a reprodutores de X68000.
  • Estudar como sequências de registradores de chips são mapeadas para dados de execução em MML.
  • Preparar samples PCM e bancos PDX para reprodução de áudio no X68000.

Início rápido

  1. 1

    Use Python 3.10 ou posterior

  2. 2

    Gere MML a partir de um arquivo VGM

    python vgm2mml.py INPUT.vgm --outdir OUTDIR
  3. 3

    Converta um diretório em lote para MML e MDX/PDX (requer um compilador MDX externo)

    python scripts/export_mdx.py INDIR --outdir OUTDIR --force

Antes de usar

  • A saída MDX/PDX requer ferramentas externas, como MXC ou mmlx, que precisam ser configuradas separadamente.
  • A conversão entre chips de som envolve aproximações, e não há garantia de que o resultado compilado corresponda ao áudio original.
  • A reprodução de PCM requer um driver de extensão PCM compatível, e algumas entradas podem falhar devido a limites de memória ou tamanho.

Tópicos

#vgm#mml#x68000#retro-computing#audio-conversion#music#python

Perguntas frequentes

O que é x68k_vgm2mml?
Ferramenta em Python que converte logs de registradores de chips de som VGM para X68000 em MML estruturado e IR de PCM, com compilação opcional para MDX/PDX. x68k_vgm2mml lê arquivos VGM, que registram gravações em registradores de chips de som em vez de notas, e reconstrói informações de altura, duração, volume e timbre. A saída é MML estruturado para o formato MDX usado no Sharp X68000, além de dados de representação intermediária de PCM.
x68k_vgm2mml é gratuito? Qual é a licença?
x68k_vgm2mml é open source sob a licença MIT. Confira os termos da licença antes de usá-lo em produtos comerciais.
x68k_vgm2mml ainda é mantido?
Manutenção ativa. O último commit de x68k_vgm2mml foi em 5 de nov. de 2026.
Para que posso usar x68k_vgm2mml?
Converter dumps de jogos ou músicas em VGM para arquivos MDX destinados a reprodutores de X68000. Estudar como sequências de registradores de chips são mapeadas para dados de execução em MML. Preparar samples PCM e bancos PDX para reprodução de áudio no X68000.
Como instalar x68k_vgm2mml?
Use Python 3.10 ou posterior Gere MML a partir de um arquivo VGM: python vgm2mml.py INPUT.vgm --outdir OUTDIR Converta um diretório em lote para MML e MDX/PDX (requer um compilador MDX externo): python scripts/export_mdx.py INDIR --outdir OUTDIR --force
Onde consigo x68k_vgm2mml?
O código-fonte e as instruções de instalação estão no GitHub: https://github.com/emef2247/x68k_vgm2mml

Resumo gerado por IA a partir do README do projeto. As estatísticas do GitHub são atualizadas diariamente.

Projetos relacionados