Repolode
emef2247

emef2247/x68k_vgm2mml

Инструмент на Python, который преобразует журналы записей в регистры звуковых чипов X68000 из VGM в структурированный MML и PCM IR с возможностью компиляции в MDX/PDX.

Звёзды
13
Форки
0
Открытые issues
0
Последний коммит
позавчера

Что это?

x68k_vgm2mml читает VGM-файлы, в которых записываются обращения к регистрам звуковых чипов, а не ноты, и восстанавливает высоту и длительность нот, громкость и тембр. На выходе получаются структурированный MML для формата MDX, используемого на Sharp X68000, и данные промежуточного представления PCM.

Поддерживается ряд чипов, включая OPM (YM2151), OPNA (YM2608), PSG/SSG, SCC, DCSG (семейство SN76489), PCM в стиле MSM6258, SegaPCM и C140. Звучание чипов без прямого аналога OPM приближённо воспроизводится с помощью голосов FM-синтеза OPM или аддитивного синтеза; PSG также можно направить на PCM.

Скрипт пакетной обработки export_mdx.py может преобразовать каталог VGM-файлов и вызвать внешние компиляторы MDX и PDX, например MXC или mmlx и soundlog. Параметр --force пропускает неподдерживаемые элементы и выводит диагностические сообщения, а --no-song-loop создаёт однократное воспроизведение вместо зацикленной композиции. Преобразование не гарантирует точного совпадения с оригинальным аудио, поэтому результат следует проверить на реальном оборудовании или в эмуляторе.

Ключевые возможности

  • 01Извлекает ноты, их длительность, громкость и тембр из записей обращений к регистрам VGM.
  • 02Выдаёт структурированный MML для воспроизведения в формате MDX на X68000.
  • 03Приближённо воспроизводит звучание OPNA, PSG, SCC и DCSG с помощью голосов OPM.
  • 04Создаёт промежуточное представление PCM и данные PDX для PCM-чипов.
  • 05Пакетно преобразует каталог файлов и при необходимости пропускает элементы с выводом диагностических сообщений.

Сценарии использования

  • Преобразование игровых или музыкальных дампов VGM в файлы MDX для проигрывателей X68000.
  • Изучение того, как последовательности обращений к регистрам чипов преобразуются в данные исполнения MML.
  • Подготовка PCM-сэмплов и банков PDX для воспроизведения звука на X68000.

Быстрый старт

  1. 1

    Используйте Python 3.10 или новее

  2. 2

    Создайте MML из файла VGM

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

    Пакетно преобразуйте каталог в MML и MDX/PDX (требуется внешний компилятор MDX)

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

Что важно знать

  • Для вывода MDX/PDX требуются внешние инструменты, например MXC или mmlx, которые нужно настроить отдельно.
  • Преобразование между звуковыми чипами включает приближения, поэтому соответствие скомпилированного результата исходному аудио не гарантируется.
  • Для воспроизведения PCM требуется совместимый драйвер расширения PCM; некоторые входные файлы могут не обработаться из-за ограничений памяти или размера.

Темы

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

Частые вопросы

Что такое x68k_vgm2mml?
Инструмент на Python, который преобразует журналы записей в регистры звуковых чипов X68000 из VGM в структурированный MML и PCM IR с возможностью компиляции в MDX/PDX. x68k_vgm2mml читает VGM-файлы, в которых записываются обращения к регистрам звуковых чипов, а не ноты, и восстанавливает высоту и длительность нот, громкость и тембр. На выходе получаются структурированный MML для формата MDX, используемого на Sharp X68000, и данные промежуточного представления PCM.
x68k_vgm2mml можно использовать бесплатно? Какая у него лицензия?
x68k_vgm2mml распространяется с открытым исходным кодом под лицензией MIT. Перед использованием в коммерческих продуктах проверьте условия лицензии.
x68k_vgm2mml всё ещё поддерживается?
Активно поддерживается. Последний коммит в x68k_vgm2mml — 5 нояб. 2026 г..
Для чего можно использовать x68k_vgm2mml?
Преобразование игровых или музыкальных дампов VGM в файлы MDX для проигрывателей X68000. Изучение того, как последовательности обращений к регистрам чипов преобразуются в данные исполнения MML. Подготовка PCM-сэмплов и банков PDX для воспроизведения звука на X68000.
Как установить x68k_vgm2mml?
Используйте Python 3.10 или новее Создайте MML из файла VGM: python vgm2mml.py INPUT.vgm --outdir OUTDIR Пакетно преобразуйте каталог в MML и MDX/PDX (требуется внешний компилятор MDX): python scripts/export_mdx.py INDIR --outdir OUTDIR --force
Где скачать x68k_vgm2mml?
Исходный код и инструкции по установке — на GitHub: https://github.com/emef2247/x68k_vgm2mml

Описание создано ИИ на основе README проекта. Статистика GitHub обновляется ежедневно.

Похожие проекты

Эмулятор x86-ПК, работающий в браузере: он преобразует машинный код в WebAssembly на лету и загружает настоящие операционные системы.

23,7 тыс.+19 за неделю1,9 тыс.JavaScriptBSD-2-ClauseАктивно поддерживаетсяОбновлён 8 дней назад

Низкоуровневый эмулятор x86 для запуска старых ОС и программ, созданных для IBM PC и совместимых компьютеров с 1981 года.

5 тыс.+16 за неделю640CGPL-2.0Активно поддерживаетсяОбновлён 18 часов назад

Запускает 16-битные программы Windows (от 1.x до 3.1) на 64-битной Windows с помощью эмулятора; для DOS-программ предусмотрен режим DOS.

3,6 тыс.+22 за неделю209CGPL-2.0Обновлён 14 дней назад