.\"
.\" Copyright (c) 2003-2010 Alexandre Ratchov <alex@caoua.org>
.\"
.\" Permission to use, copy, modify, and distribute this software for any
.\" purpose with or without fee is hereby granted, provided that the above
.\" copyright notice and this permission notice appear in all copies.
.\"
.\" THE SOFTWARE IS PROVIDED "AS IS" AND THE AUTHOR DISCLAIMS ALL WARRANTIES
.\" WITH REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF
.\" MERCHANTABILITY AND FITNESS. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR
.\" ANY SPECIAL, DIRECT, INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES
.\" WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR PROFITS, WHETHER IN AN
.\" ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF
.\" OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.
.\"
.Dd August 27, 2005
.Dt SMFREC 1
.Os
.Sh "نام (NAME)"
.Nm smfrec
.Nd ضبط فایل‌های استاندارد MIDI (SMF) از دستگاه‌های ورودی
.Sh "خلاصه دستور (SYNOPSIS)"
.Nm smfrec
.Op Fl amxy
.Op Fl g Ar measure
.Op Fl d Ar devname
.Op Fl i Ar devname
midifile
.Sh "توضیحات (DESCRIPTION)"
ابزار
.Nm
یک فایل MIDI را ضبط می‌کند.
این ابزار می‌تواند رویدادهای ضبط‌شده را به یک فایل MIDI موجود اضافه کند.
برای متوقف کردن اجرا، یک سیگنال وقفه به
.Nm
ارسال کنید (برای نمونه با فشردن control ^C در ترمینال).
گزینه‌ها به شرح زیر هستند:
.Bl -tag -width "-i devname "
.It Fl a
حالت الحاق.
فایل MIDI داده‌شده را پخش می‌کند و یک تِرَک جدید شامل رویدادهای ضبط‌شده به آن می‌افزاید.
.It Fl m
استفاده از مترونوم.
.It Fl x
همگام‌سازی با دستگاه پیش‌فرض
.Xr midi 4
به‌جای استفاده از منبع ساعت داخلی.
.It Fl y
ارسال اطلاعات زمان‌بندی MIDI به دستگاه پیش‌فرض.
زمانی که دستگاه یک ترتیب‌سنج تابع MIDI باشد مفید است.
.It Fl g Ar measure
شروع پخش و ضبط از شماره میزان داده‌شده.
.It Fl d Ar filename
دستگاه
.Xr midi 4
پیش‌فرض برای ضبط و ارسال رویدادهای MIDI.
در صورت عدم تعیین، مقدار متغیر محیطی
.Ev MIDIDEV
به‌جای آن استفاده خواهد شد.
.It Fl i Ar filename
دستگاه ورودی
.Xr midi 4
جایگزین.
رویدادهای صوتی (نُت‌ها، کنترل‌کننده‌ها و غیره) دریافت شده روی دستگاه ورودی ضبط شده و همان‌گونه به دستگاه پیش‌فرض ارسال خواهند شد.
بدون این پرچم، از دستگاه پیش‌فرض برای ورودی استفاده می‌شود.
.El
.Pp
ابزار
.Nm
یک رابط کاربری برای
.Xr midish 1
است.
در صورتی که به ویژگی‌های خاص‌تری نیاز باشد، کاربر می‌تواند استفاده از
.Xr midish 1
را در نظر بگیرد.
.Sh "مثال‌ها (EXAMPLES)"
دستور زیر فایل
.Pa mysong.mid
را پخش کرده و رویدادهای ضبط‌شده از دستگاه
.Pa /dev/rmidi4
را به آن می‌افزاید؛ همچنین از مترونوم استفاده خواهد شد.
.Pp
.Dl $ smfrec -a -m -d /dev/rmidi4 mysong.mid
.Sh "همچنین ببینید (SEE ALSO)"
.Xr midish 1 ,
.Xr smfplay 1 ,
.Xr midi 4