.\"
.\" 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 22, 2005
.Dt SMFPLAY 1
.Os
.Sh "نام (NAME)"
.Nm smfplay
.Nd پخش یک فایل استاندارد MIDI
.Sh "خلاصه دستور (SYNOPSIS)"
.Nm smfplay
.Op Fl mxy
.Op Fl g Ar measure
.Op Fl d Ar devname
.Op Fl i Ar devname
midifile
.Sh "توضیحات (DESCRIPTION)"
ابزار
.Nm
یک فایل MIDI را پخش می‌کند.
در هنگام پخش، می‌تواند رویدادها را از یک دستگاه
.Xr midi 4
به دستگاه دیگری هدایت (route) کند.
برای توقف پخش، یک سیگنال وقفه به
.Nm
ارسال کنید (برای مثال با فشردن Ctrl+C در ترمینال).
گزینه‌ها به شرح زیر هستند:
.Bl -tag -width "-i devname "
.It Fl m
استفاده از مترونوم.
مترونوم تغییرات تمپو (tempo) و کسر میزان (time signature) را در فایل midi دنبال خواهد کرد.
.It Fl x
همگام‌سازی با یک دستگاه خارجی
.Xr midi 4 .
اگر فلگ
.Fl i
استفاده شود، بازپخش با دستگاه ورودی همگام می‌شود،
در غیر این صورت با دستگاه پیش‌فرض همگام خواهد شد.
.It Fl y
ارسال اطلاعات زمان‌بندی midi به دستگاه پیش‌فرض.
زمانی مفید است که دستگاه خروجی یک سکوئنسر (sequencer) پیرو MIDI باشد.
.It Fl g Ar measure
شروع بازپخش از شماره میزان (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 $ smfplay -m -d /dev/rmidi4 mysong.mid
.Sh "همچنین ببینید (SEE ALSO)"
.Xr midiplay 1 ,
.Xr midish 1 ,
.Xr smfrec 1 ,
.Xr midi 4