~grauw/gngplay - Konverter dan Pemutar Musik Ghosts ’n Goblins

Informasi Proyek

• Lisensi: Simplified BSD License

Mengubah musik arcade Ghosts ’n Goblins dalam format VGM menjadi aliran data yang cocok untuk diputar ulang di Yamaha SFG, Neotron, atau Makoto. Format ini bertujuan efisien untuk pemutaran ulang dan berukuran kecil. Berkat representasi ringkas untuk tipe kejadian yang paling sering, trek individu semuanya di bawah 8K dan total ukuran kurang dari 64K.

Persyaratan Sistem

• MSX, MSX2, MSX2+, atau MSX turboR
• 64K RAM utama
• 16K RAM video
• MSX-DOS

Jika inti pemutar ulang dan data musik tertanam dalam ROM, kebutuhan RAM dikurangi menjadi 16K dan kebutuhan MSX-DOS dihapuskan.

Fungsi Konverter

• Format data ringkas
• Pemutaran ulang sederhana pada tiga chip suara
• Penggabungan pengaturan instrumen per saluran
• Pengelompokan menjadi lima tipe kejadian (kunci, frekuensi, instrumen, tunggu, putaran)
• Konversi frekuensi jam
• Pemetaan ulang saluran
• Penghapusan penundaan kecil
• Kuantisasi waktu
• Pemotongan kesunyian awal
• Memindahkan kejadian frekuensi sebelum kunci aktif
• Penyesuaian volume

Ini juga menghasilkan file VGM untuk YM2151 OPM dan YM2610 OPN untuk pengujian mudah dengan VGMPlay dan debugging dengan vgm2txt.

Format Data Musik

Format data terdiri dari lima jenis kejadian:

• 00-7F: Kejadian kunci aktif/non-aktif. Bit 0-2: saluran, bit 3-6: slot.
• 80-87: Kejadian frekuensi nada. Bit 0-2: saluran, byte 1-2: frekuensi OPM, byte 3-4: frekuensi OPN.
• 88-8F: Pengaturan instrumen. Bit 0-2: saluran, byte 1-25: parameter slot, byte 26: umpan balik/algorithm.
• 90: Offset putaran. Byte 1-2: offset ke titik putaran.
• 91-FF: Tunggu. n - 90H: jumlah tik 60Hz.

Catatan Tambahan

Musik permainan arcade menggunakan dua OPN yang diklock pada 1,5 MHz. Tetapi karena pengaturan prescaler ke pembagi frekuensi 3, bukan 6 seperti biasa, mereka bertindak seperti OPN yang diklock pada 3 MHz dengan prescaling default.

Permainan mengatur frekuensi setelah mengatur kunci aktif. Akibatnya, terkadang Anda mendapatkan nada yang salah di awal trek pada perangkat keras nyata, tergantung pada nilai awal. Ini mungkin bug dalam kode pemutar ulang permainan asli yang tidak terungkap selama permainan normal. Langkah pemrosesan ditambahkan untuk menempatkan frekuensi di depan perintah kunci aktif.

Trek 01 sama dengan Trek 27, tetapi dengan dua saluran dibungkam. Disarankan untuk menggunakan trek 27 daripada trek 01.

Petunjuk Penggunaan

Ekstrak paket VGM Ghosts ’n Goblins arcade, ganti nama file .vgz menjadi .vgm dan ekstrak masing-masing lagi, lalu letakkan di direktori res/. Disarankan untuk mengulang ulang trek 24 agar menjadi lebih kecil dan putaran terdengar lebih baik. Gunakan vgm_trim dengan parameter start: 0, loop: 35111, end: 364391.

File resources dalam direktori res berisi manifes file yang akan dikonversi dan berbagai pengaturan.

Kemudian, di macOS dan Linux jalankan perintah make untuk mengonversi file dan mengompilasi pemutar ulang. Uji dengan menempatkan file sistem MSX-DOS dalam direktori bin/ dan menjalankan perintah make run. Diperlukan OpenMSX 0.16.0 atau lebih baru, saat ini hanya mendukung chip suara Yamaha SFG.

Di Windows, jalankan perintah build dari Makefile secara manual.

Perhatikan bahwa perakitan glass yang disematkan dalam proyek ini membutuhkan Java 8. Untuk memeriksa versi Java, jalankan perintah java -version.

Selain itu, alat konversi ditulis dalam JavaScript untuk Node. Anda perlu menginstal Node dan NPM.