Repolode
Enviar
emef2247

emef2247/x68k_vgm2mml

Herramienta en Python que convierte registros VGM de chips de sonido para X68000 en MML estructurado y una representación intermedia PCM, con compilación opcional a MDX/PDX.

Ver en GitHub
Estrellas
13
Forks
0
Issues abiertos
0
Último commit
hace 3 días

¿Qué es?

x68k_vgm2mml lee archivos VGM, que registran escrituras en los registros de los chips de sonido en lugar de notas, y reconstruye información de tono, duración, volumen y timbre. La salida es MML estructurado para el formato MDX usado en Sharp X68000, junto con datos de representación intermedia PCM.

Es compatible con varios chips, como OPM (YM2151), OPNA (YM2608), PSG/SSG, SCC, DCSG (familia SN76489), PCM del tipo MSM6258, SegaPCM y C140. Los chips sin un equivalente directo en OPM se aproximan proyectando su sonido en voces de síntesis FM OPM o de síntesis aditiva; como alternativa, el PSG se puede dirigir a PCM.

El script por lotes export_mdx.py puede convertir un directorio de archivos VGM y también ejecutar compiladores externos de MDX y PDX, como MXC o mmlx y soundlog. La opción --force omite los elementos no compatibles y muestra diagnósticos, mientras que --no-song-loop genera una sola pasada en lugar de una canción en bucle. La conversión no garantiza que el resultado coincida con el audio original, por lo que conviene comprobarlo en hardware real o en un emulador.

Funciones clave

  • 01Extrae notas, duración, volumen y timbre de las escrituras en registros VGM.
  • 02Genera MML estructurado para la reproducción de MDX en X68000.
  • 03Aproxima los sonidos de OPNA, PSG, SCC y DCSG mediante voces OPM.
  • 04Genera una representación intermedia PCM y datos PDX para chips PCM.
  • 05Convierte directorios por lotes, con omisión opcional basada en diagnósticos.

Casos de uso

  • Convertir extracciones de juegos o música en VGM a archivos MDX para reproductores de X68000.
  • Estudiar cómo se traducen las secuencias de registros de los chips a datos de interpretación MML.
  • Preparar muestras PCM y bancos PDX para la reproducción de sonido en X68000.

Inicio rápido

  1. 1

    Usa Python 3.10 o posterior

  2. 2

    Genera MML a partir de un archivo VGM

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

    Convierte por lotes un directorio a MML y MDX/PDX (requiere un compilador MDX externo)

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

Antes de usarlo

  • La salida MDX/PDX requiere herramientas externas como MXC o mmlx, que deben configurarse por separado.
  • La conversión entre chips de sonido implica aproximaciones, por lo que no se garantiza que el resultado compilado coincida con el audio original.
  • La reproducción PCM requiere un controlador de extensión PCM compatible, y algunas entradas pueden fallar debido a límites de memoria o tamaño.

Temas

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

Preguntas frecuentes

¿Qué es x68k_vgm2mml?
Herramienta en Python que convierte registros VGM de chips de sonido para X68000 en MML estructurado y una representación intermedia PCM, con compilación opcional a MDX/PDX. x68k_vgm2mml lee archivos VGM, que registran escrituras en los registros de los chips de sonido en lugar de notas, y reconstruye información de tono, duración, volumen y timbre. La salida es MML estructurado para el formato MDX usado en Sharp X68000, junto con datos de representación intermedia PCM.
¿x68k_vgm2mml es gratuito? ¿Qué licencia tiene?
x68k_vgm2mml es open source bajo la licencia MIT. Revisa los términos de la licencia antes de usarlo en productos comerciales.
¿x68k_vgm2mml sigue mantenido?
Mantenimiento activo. El último commit de x68k_vgm2mml fue el 5 nov 2026.
¿Para qué puedo usar x68k_vgm2mml?
Convertir extracciones de juegos o música en VGM a archivos MDX para reproductores de X68000. Estudiar cómo se traducen las secuencias de registros de los chips a datos de interpretación MML. Preparar muestras PCM y bancos PDX para la reproducción de sonido en X68000.
¿Cómo se instala x68k_vgm2mml?
Usa Python 3.10 o posterior Genera MML a partir de un archivo VGM: python vgm2mml.py INPUT.vgm --outdir OUTDIR Convierte por lotes un directorio a MML y MDX/PDX (requiere un compilador MDX externo): python scripts/export_mdx.py INDIR --outdir OUTDIR --force
¿Dónde consigo x68k_vgm2mml?
El código fuente y las instrucciones de instalación están en GitHub: https://github.com/emef2247/x68k_vgm2mml

Resumen generado por IA a partir del README del proyecto. Las estadísticas de GitHub se actualizan a diario.

Proyectos relacionados