autosp - manual referensi, opsi, contoh perintah


NAMA

autosp - preprosesor untuk menghasilkan perintah spasi catatan untuk skor MusiXTeX

RINGKASAN

autosp [-v | --version | -h | --help]

autosp [-d | --dotted] [-l | --log] infile[.aspc] [outfile[.tex]]

KETERANGAN

Program ini membuatnya lebih mudah untuk membuat skor MusiXTeX dengan mengonversi perintah (non-standar) dari bentuk \anotes ... \en menjadi satu atau lebih perintah spasi catatan konvensional (\notes \Notes \NOtes ...), ditentukan oleh nilai not sebenarnya, dengan perintah spasi \sk dimasukkan seperlunya. Pengodean untuk seluruh birama dapat dimasukkan satu bagian pada satu waktu, tanpa memperhatikan perubahan jarak not dalam bagian atau persyaratan jarak bagian lain.

Misalnya, jika diterapkan pada


    \anotes\qa J\qa K&\ca l\qa m\ca n\en 

autosp dihasilkan


    \Notes\qa J\sk\qa K\sk&\ca l\qa m\sk\ca n\en

Biasanya, perintah \anotes menghasilkan beberapa perintah spasi catatan konvensional.

Jika argumen infile tidak memiliki ekstensi .aspc, masukan diambil dari infile.aspc jika file tersebut ada.

Jika argumen outfile tidak memiliki ekstensi .tex, output dikirim ke outfile.tex. Jika tidak ada argumen outfile yang diberikan, keluaran akan menuju ke infile.tex (atau ke infile.ltx jika deklarasi \documentclass ditemukan).

Untuk perintah \anotes, jeda baris dan spasi dapat mendahului segmen catatan, memungkinkan pemformatan sumber yang lebih fleksibel; jeda baris dan spasi akan dihilangkan dari output.

Misalnya,


  \anotes
    \ibl0K0\qb0K\nbbl0\qb0{.K}\tbbbl0\tbbl0\tql0L&
    \ibbl1m{-2}\qb1{.m}\tbbbl1\tbbl1\qb1l\tql1k\en

dapat diterima dan menghasilkan


  \notesp\ibl0K0\qb0K&\ibbl1m{-2}\qb1{.m}\en
  \nnotes\sk&\tbbbl1\tbbl1\qb1l\en
  \notesp\nbbl0\qb0{.K}&\tql1k\en
  \nnotes\tbbbl0\tbbl0\tql0L&\sk\en

Jika opsi -l ( --log ) digunakan, log infile.alog yang sangat mendetail akan dihasilkan.

Jika opsi -d ( --dotted ) digunakan, dotted balok mencatat bentuk \qb{n }{.p} tidak diberi ruang ekstra; Diasumsikan bahwa not berikutnya akan digeser oleh perintah mirip \roff atau perintah spasi seperti \qsk atau \hqsk. Perintah dalam bentuk \qlp{p}, \qlpp{p}, ..., \qpb{n}{ p} dan \qppb{n}{p} selalu diberi spasi seperti yang ditunjukkan.

Jika ada satu staf, bar istirahat seluruh bar berturut-turut digabungkan menjadi istirahat multi-bar. Istirahat yang berpusat pada batang dapat dikodekan menggunakan notasi \def\atnextbar standar tetapi perintah non-standar \Cpause (atau \Cp) di segmen catatan juga menghasilkan istirahat yang berpusat pada batang.

Perintah penspasian \sk dan \bsk dalam sumber dibuang, tetapi bukan lompatan "kecil" \hsk, \qsk, \tqsk, \hqsk atau \qqsk, atau lompatan "mundur" kecil \hbsk, \bqsk, \btsk, atau \bhsk. Selain itu, perintah non-standar \QQsk, \HQsk \TQsk dan \Qsk di sumber menghasilkan lompatan "global"; yaitu, efek dari \qqsk, \hqsk, \tqsk atau \qsk, di setiap staf. Ini memastikan bahwa staf tetap tersinkronisasi jika jarak tambahan diperlukan di semua staf.

Lompatan global juga dapat diperoleh dalam urutan pengkodean kolektif dengan menggunakan hingga empat koma berturut-turut untuk mendapatkan efek \QQsk, \HQsk, \TQsk atau \Qsk, masing-masing. Lompatan global \tqsk (atau, untuk double-flat, \qsk) secara otomatis disisipkan sebelum kebetulan ('^', '_', '=', '<', '>') pada catatan pengkodean kolektif (kecuali saat not sebelumnya adalah "virtual"; yaitu, lompatan). Jika spasi tambahan otomatis ini tidak diinginkan dalam beberapa konteks, ini dapat dihindari dengan mengganti ketidaksengajaan dalam urutan pengkodean kolektif dengan salah satu perintah eksplisit tidak disengaja: \sh , \fl, \na, \smallsh, \bigsh, dll. Jika penspasian otomatis tidak mencukupi, penspasian dapat ditingkatkan dengan menambahkan koma yang cukup atau menggunakan perintah catatan konvensional alih-alih \anotes.

Segmen not bisa benar-benar kosong, tetapi jika segmen not harus dimulai dengan atau berisi "spasi", nilai not dari spasi tersebut harus dibuat eksplisit dengan perintah dalam bentuk \ha{*}, \qa{. *}, \qa{*}, \ca{*}, dll.

Dari versi 14-06-2017, efek panggilan \TransformNotes diimplementasikan oleh pra-prosesor autosp. Hal ini memungkinkan penggunaan musixlyr dalam skor autosp; musixlyr.tex tidak kompatibel dengan implementasi musixtnt.tex dari \TransformNotes.

Semua perintah MusiXTeX konvensional lainnya adalah keluaran persis seperti yang diberikan pada masukan.

OPERASI

autosp menentukan spasi untuk not biasa dari perintah not itu sendiri; Misalnya,

+
\qa, \qu, \ql, \qp 

menghasilkan

\NOtes; 
+

\ca, \cu, \cl, \ds

menghasilkan

\Notes; 

dan seterusnya. Spasi untuk catatan berkas ditentukan oleh multiplisitas berkas, sehingga \ib... menghasilkan \Catatan, \ibb... menghasilkan \catatan, dll.

Pengkodean kolektif urutan not (termasuk aksidental dan titik) ditangani dengan memperluas urutan menjadi urutan perintah not individual.

autosp menskalakan not menurut nilai ukuran instrumen yang relevan.

BATASAN

autosp mengasumsikan bahwa & dan | (daripada \nextinstrument dan \nextstaff) digunakan untuk memisahkan instrumen dan staf.

Appoggiaturas dan grace note dikenali dengan menggunakan \tinynotesize; spasi not 1,45\elemskip digunakan. Jika ini tidak cocok dan tidak dapat diperbaiki dengan lompatan kecil, perintah \vnotes dengan spasi yang diinginkan dapat digunakan.

autosp mendukung x-tuplets yang diperkenalkan menggunakan \xtuplet{x} atau \xxtuplet{x:y} dan <kembar tiga diperkenalkan menggunakan salah satu dari perintah berikut (terlepas dari definisi ulang \txt atau \tuplettxt):


  \triolet
  \uptrio
  \downtrio
  \uptuplet
  \downtuplet

autosp mengasumsikan bahwa x-tuplet akan dimainkan dalam (x-1)/x dari durasi x-tuplet yang terlihat. Jadi, misalnya, triplet dalam seperdelapan diasumsikan dimainkan dalam waktu satu not seperempat. Jika asumsi ini tidak valid, x-tuplet harus dikodekan secara eksplisit menggunakan perintah \vnotes yang sesuai; lihat ukuran pertama barsant2.aspc untuk contoh x-tuplet non-standar: 5-tuple dari not ke-64 dengan durasi yang dimaksudkan enam ke-64.

Dalam beberapa skor poliritmik, angka \txt mungkin tergeser, bahkan jika not itu sendiri ditempatkan dengan benar. Dalam kasus ini, dimungkinkan untuk menekan output normal \txt dengan menggunakan perintah non-standar \Triolet (tanpa argumen) atau \Xtuplet{k}\ dan menempatkan angka di lokasi yang benar menggunakan \zcn (yaitu,\zcharnote).

autosp dapat menangani x-tuplet secara bersamaan dalam beberapa staf asalkan nilai x dan total durasi not identik.

Dalam beberapa skor barok, terutama oleh J.S. Bach, nada enam belas yang dipancarkan secara vertikal disejajarkan dengan nada ketiga dari triplet nada kedelapan pada staf lain (menyiratkan bahwa nada tersebut harus dibunyikan secara bersamaan); misalnya.,


    \ibl0L0\qb0{.L}\tqql0L

akan dimainkan seolah-olah dinotasikan


    \uptrio{b}10\ql L\hroff{\cl L}

Pengkodean berikut akan menyelaraskan nada keenam belas yang dipancarkan dengan nada ketiga dari triplet di staf lain:


    \ibl0L0\qb0{.L}\hbsk\tqql0L

dan, demikian pula, untuk triplet nada keenam belas:


    \ibbu0J0\qb0{.J}\hbsk\nqqqu0J\qb0{.J}\hbsk\tqqqu0J

Umumnya, makro yang ditentukan pengguna tidak diproses atau diperluas; Namun, definisi bentuk


    \def\atnextbar{\znotes ... \en}

menghasilkan definisi yang memperhitungkan \TransformNotes.

Semua staf diasumsikan memiliki meteran yang sama; lihat kinder2.aspc untuk contoh cara menyiasatinya.

autosp mungkin tidak efektif untuk musik dengan lebih dari satu suara dalam satu staf. Mungkin disarankan untuk menggunakan staf terpisah untuk setiap suara, untuk menghindari anotasi bila perlu, atau menghilangkan suara tertentu terlebih dahulu dan menambahkannya ke dalam file TeX yang dihasilkan.

CONTOH

Lihat file quod2.aspc, kinder2.aspc, geminiani.aspc, dan barsant2.aspc untuk skor yang cocok untuk input ke autosp. Program tex2aspc dapat digunakan untuk mengonversi skor MusiXTeX "lawas" ke format .aspc.

LIHAT JUGA

msxlint(1) tex2aspc(1)

musixdoc.pdf

PENGARANG

Program dan halaman manual ini ditulis oleh Bob Tennent .