Konversi PMX menjadi PDF

Orang mengonversi source PMX ke PDF ketika mereka memerlukan partitur yang dapat dicetak, partitur dengan tata letak tetap untuk dibagikan, atau salinan yang dapat dilihat tanpa toolchain PMX dan MusiXTeX. PDF juga menyediakan versi arsip yang stabil sementara source asli tetap dapat diedit.

Apa itu format PMX

Dalam konteks Dokumen, PMX adalah format source berbasis teks untuk preprocessor PMX yang digunakan bersama sistem typesetting musik MusiXTeX. Format ini mendeskripsikan not, ritme, suara, lirik, instrumen, dan tata letak halaman; format ini bukan gambar halaman jadi atau partitur yang telah dirender.

Komposer, arranger, dan typesetter musik membuat atau mengedit file PMX dengan tools PMX dan text editor. Sebuah project juga dapat berisi file .tex yang dihasilkan, macro MusiXTeX, music fonts, file lirik, dan resource lain yang direferensikan. Mengganti nama .pmx ke ekstensi lain tidak mengonversi source.

Apa itu format PDF

PDF menyimpan halaman yang telah disusun dalam tata letak tetap, termasuk teks, notasi, spasi, dan biasanya font yang disematkan atau direferensikan. Format ini cocok untuk mencetak, mendistribusikan partitur, mengirimkan score, dan mengarsipkan versi yang tidak memerlukan PMX atau MusiXTeX.

PDF bukan pengganti source yang praktis: mengubah struktur musik, lirik, atau tata letak jauh lebih mudah dilakukan pada .pmx asli dan file terkaitnya. Simpan project source lengkap bersama PDF yang diekspor.

Cara mengonversi PMX ke PDF

Metode yang andal adalah typesetting lokal dengan distribusi TeX, MusiXTeX, dan distribusi PMX. TeX Live mendukung Linux, macOS, dan Windows; MiKTeX dapat digunakan di Windows jika package MusiXTeX yang diperlukan tersedia. PMX sendiri mungkin perlu diinstal secara terpisah dari distribusinya atau source CTAN.

1. Instal TeX Live atau MiKTeX, MusiXTeX, dan PMX. Pastikan bahwa pmxab dan command wrapper MusiXTeX tersedia di PATH sistem.
2. Tempatkan file source dan setiap file yang direferensikan dalam satu direktori kerja. Periksa nama file, relative path, custom macro, font, dan graphics yang disertakan.
3. Buka terminal di direktori tersebut dan jalankan pmxab score.pmx. Ini biasanya menghasilkan file yang kompatibel dengan MusiXTeX seperti score.tex.
4. Jalankan build wrapper MusiXTeX, biasanya musixtex score atau musixtex score.tex, sesuai dengan distribusi yang diinstal. Wrapper tersebut menjalankan pass TeX dan auxiliary-file yang diperlukan untuk spasi musik dan biasanya menghasilkan score.pdf.
5. Buka PDF dan periksa setiap halaman, termasuk spasi system, lirik, tuplet, accidental, pergantian halaman, pemisah baris, dan barline terakhir.

Nama command dan perilaku wrapper berbeda-beda antara rilis PMX dan MusiXTeX. Jika wrapper tidak tersedia, gunakan prosedur build yang disediakan bersama rilis tersebut, bukan mengasumsikan bahwa satu kali menjalankan pdflatex sudah memadai. File PMX yang dihasilkan mungkin memerlukan pass TeX tradisional, musixflx, dan TeX berulang, yang kemudian diikuti oleh pembuatan PDF.

Di Windows, jalankan command di Command Prompt atau PowerShell setelah menambahkan direktori TeX, MusiXTeX, dan PMX ke PATH. Distribusi PMX juga mungkin menyediakan batch file atau command grafis Build atau Typeset.

Opsi konversi online

Website konversi file umum dan converter dokumen kantor biasanya tidak dapat mem-parsing notasi PMX, sehingga tidak dapat diandalkan untuk opsi upload langsung. Overleaf dapat mengompilasi project MusiXTeX .tex yang dihasilkan jika package dan file pendukung yang diperlukan diunggah, tetapi bukan converter PMX langsung karena langkah preprocessing PMX umumnya harus dilakukan secara lokal terlebih dahulu. Kompilasi lokal lebih disarankan untuk score yang belum dipublikasikan atau project yang berisi materi proprietary.

Kualitas dan kompatibilitas

Output bergantung pada versi PMX, MusiXTeX, TeX, macro, dan music-font yang kompatibel. Package atau file yang direferensikan dan hilang dapat menghentikan kompilasi atau menghasilkan notasi yang tidak lengkap; simpan compiler log saat mendiagnosis error.

PMX menggunakan source terstruktur yang sensitif terhadap syntax, bukan teks pengolah kata biasa. Jika page break atau spasi salah, ubah pengaturan tata letak PMX yang relevan dan buat ulang PDF. Mengedit notasi secara langsung dalam PDF dapat mengubah penempatan tanpa memperbaiki musik yang mendasarinya. Simpan source asli dan catat versi tools yang digunakan untuk membuat PDF final.