نام (NAME)

arecordmidi2 - ضبط فایل کلیپ MIDI

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

arecordmidi2 [گزینه‌ها] midi2file

توضیحات (DESCRIPTION)

دستور arecordmidi2 یک ابزار خط فرمانی است که یک فایل کلیپ MIDI را از یک یا چند درگاه ترتیب‌سنج (sequencer) ALSA ضبط می‌کند.

برای متوقف کردن ضبط، کلیدهای Ctrl+C را فشار دهید.

هنگامی که - به عنوان آرگومان فایل کلیپ MIDI داده شود، خروجی در خروجی استاندارد (stdout) ضبط می‌شود. این کار به معنای اعمال گزینه -s نیز هست.

گزینه‌ها (OPTIONS)

-h, --help: نمایش فهرستی از گزینه‌ها.
-V, --version: نمایش نسخه فعلی.
-p, --port=client:port,...: درگاه(های) ترتیب‌سنج را که رویدادها از آن‌ها ضبط می‌شوند تنظیم می‌کند.

یک کلاینت می‌تواند با شماره، نام یا پیشوندی از نام آن مشخص شود. یک درگاه با شماره‌اش مشخص می‌شود؛ برای درگاه ۰ یک کلاینت، بخش ":0" در مشخصات درگاه می‌تواند حذف شود.

دستور arecordmidi2 یک نقطه پایانی (Endpoint) برای UMP حاوی همان تعداد بلوک عملکردی (Function Block) مشخص‌شده توسط این گزینه ایجاد می‌کند که هر کدام به عنوان یک منبع به درگاه مشخص‌شده متصل می‌شوند.

هنگامی که هیچ درگاه منبعی با گزینه -p مشخص نشود، arecordmidi2 یک UMP Endpoint با ۱۶ بلوک عملکردی کامل ایجاد کرده و از آن ورودی‌ها ضبط می‌کند. کاربر می‌تواند به عنوان مثال از طریق aconnect درگاه‌های ترتیب‌سنج را آزادانه متصل کند. این حالت می‌تواند همراه با حالت تعاملی از طریق گزینه -r استفاده شود.

-b, --bpm=beats: تمپوی موسیقی فایل MIDI را بر حسب ضرب در دقیقه (BPM) تنظیم می‌کند. مقدار پیش‌فرض 120 BPM است.
-t, --ticks=ticks: وضوح برچسب‌های زمانی (تیک‌ها) را در فایل MIDI، بر حسب تیک در هر ضرب (ticks/beat) تنظیم می‌کند. مقدار پیش‌فرض 384 تیک در هر ضرب است.
-i, --timesig=numerator:denominator: میزان‌نما (کسر میزان) را برای فایل MIDI تنظیم می‌کند.

میزان‌نما طبق معمول با دو عدد مشخص می‌شود که صورت و مخرج کسر میزان را همان‌گونه که نت‌نویسی می‌شود نشان می‌دهند. مخرج باید توانی از دو باشد. هر دو عدد باید با دو‌نقطه (:) از هم جدا شوند. میزان‌نما به صورت پیش‌فرض 4:4 است.

-n, --num-events=events: ضبط را پس از دریافت تعداد مشخص‌شده از رویدادها متوقف می‌کند.
-u, --ump=version: نسخه پروتکل UMP MIDI را تنظیم می‌کند. برای پروتکل‌های MIDI 1.0 و MIDI 2.0 باید به ترتیب مقدار 1 یا 2 مشخص شود. پیش‌فرض 1 است.
-r, --interactive: اجرا در حالت تعاملی. arecordmidi2 برای شروع ضبط، منتظر ورودی کلید RETURN از ترمینال می‌ماند. پس از شروع، ضبط زمانی پایان می‌یابد که کلید RETURN دیگری از ترمینال وارد شود. رویدادهای دریافت‌شده پیش از شروع ضبط نادیده گرفته می‌شوند.
-s, --silent: پیام‌ها را در خروجی استاندارد (stdout) چاپ نکند.
-P, --profile=file: داده‌های UMP را از فایل داده‌شده خوانده و آن‌ها را در بخش پیکربندی خروجی ضبط‌شده قرار می‌دهد. فایل باید تنها حاوی داده‌های معتبر UMP کدگذاری‌شده با فرمت big-endian باشد.
--song=text, --clip=text, --copyright=text, --composer=text, --lyricist=text, --arranger=text, --publisher=text, --performer=text, --accompany=text, --date=text, --location=text: متن فراداده (metadata) داده‌شده را در بخش پیکربندی قرار می‌دهد.

همچنین ببینید (SEE ALSO)

arecordmidi(1)
aplaymidi2(1)

نویسندگان (AUTHORS)

Takashi Iwai <tiwai@suse.de>