نام (NAME)

smfsh - پوستهٔ تعاملی SMF

خلاصه دستور (SYNOPSIS)

smfsh [ -V ] [ file ]

گزینه‌ها (OPTIONS)

-V

نسخهٔ libsmf را نمایش داده و خارج می‌شود.

file

فایل را بارگذاری می‌کند.

توضیحات (DESCRIPTION)

برنامهٔ smfsh، یک «پوستهٔ SMF»، یک پیشانهٔ تعاملی و مبتنی بر دستور برای libsmf است که برای دستکاری دستی فایل‌های MIDI کاربرد دارد. این برنامه ابتدا به عنوان ابزاری کمکی برای اشکال‌زدایی libsmf آغاز به کار کرد.

دستورها به چهار دسته تقسیم می‌شوند: سطح SMF، سطح ترک، سطح رویداد، و سایر موارد.

دستورهای سطح SMF (SMF LEVEL COMMANDS)

دستورهای سطح SMF، ویژگی‌های smf (یعنی کل فایل MIDI) را نمایش داده یا تغییر می‌دهند.

save file

فایل را ذخیره می‌کند. اگر نام file مشخص نشود، از آخرین نام فایل استفاده می‌شود.

توجه داشته باشید که این دستور تأییدیه‌ای درخواست نخواهد کرد.

load file

یک فایل را بارگذاری می‌کند. اگر نام file مشخص نشود، از آخرین نام فایل استفاده می‌شود.

به‌جای استفاده از «load»، می‌توانید نام فایل را در خط فرمان وارد کنید.

ppqn new-ppqn

مقدار PPQN (پالس در هر نت سیاه، موسوم به Division) را نمایش می‌دهد (اگر بدون پارامتر استفاده شود) یا آن را تغییر می‌دهد.

format new-format

قالب را نمایش می‌دهد (اگر بدون پارامتر استفاده شود) یا آن را تغییر می‌دهد.

tempo

نقشهٔ تمپو را نمایش می‌دهد. نقشهٔ تمپو به‌طور خودکار از محتویات SMF محاسبه می‌شود - برای تغییر تمپو، کافی است با استفاده از دستور «add» یک رویداد Tempo Change اضافه کنید.

length

طول کلی آهنگ را نمایش می‌دهد. همانند نقشهٔ تمپو، طول فایل نیز از روی محتویات SMF محاسبه می‌شود.

دستورهای سطح ترک (TRACK LEVEL COMMANDS)

دستورهای سطح ترک، ویژگی‌های ترک‌ها را نمایش می‌دهند یا تغییر می‌دهند. یک SMF ممکن است شامل یک یا چند ترک باشد.

tracks

فهرست ترک‌های موجود در SMF را نمایش می‌دهد.

track track-number

جزئیات یک ترک را نمایش می‌دهد (اگر بدون پارامتر فراخوانی شود)، یا ترکی با شمارهٔ داده‌شده را انتخاب می‌کند - برای نمونه به‌منظور نمایش رویدادهایی که در بر دارد («events»).

trackadd

ترک جدیدی ایجاد می‌کند.

trackrm track-number

ترک را حذف می‌کند. اگر شمارهٔ ترک مشخص نشده باشد، ترکی که در حال حاضر انتخاب شده است حذف خواهد شد.

دستورهای سطح رویداد (EVENT LEVEL COMMANDS)

دستورهای سطح رویداد، ویژگی‌های رویدادها را نمایش می‌دهند یا تغییر می‌دهند. رویدادها در ترک‌ها گروه‌بندی می‌شوند. یک ترک می‌تواند شامل هر تعداد رویداد، از جمله صفر رویداد باشد.

events

فهرست رویدادهای موجود در ترک فعلی را نمایش می‌دهد.

event event-number

اطلاعاتی دربارهٔ رویداد فعلی نمایش می‌دهد (اگر بدون پارامتر استفاده شود) یا رویداد را انتخاب می‌کند.

add time-in-seconds midi-message-as-hex

رویداد جدیدی به ترک انتخاب‌شدهٔ فعلی اضافه می‌کند.

rm event-number

رویداد را حذف می‌کند. اگر شمارهٔ رویداد مشخص نشده باشد، رویدادی که در حال حاضر انتخاب شده است حذف خواهد شد.

سایر دستورها (OTHER COMMANDS)

سه دستور در دستهٔ «سایر» وجود دارد - «help»، «version» و «exit». مفهوم و کاربرد آن‌ها خودگویا است.