.TH ASEQSEND 1 "11 Mar 2024"

.SH "نام (NAME)"
aseqsend \- ارسال پیام‌های دلخواه به درگاه انتخاب‌شدهٔ ترتیب‌سنج ALSA MIDI

.SH "خلاصه دستور (SYNOPSIS)"
\fBaseqsend\fP \fB\-p\fP \fIclient:port\fP \fB\-s\fP \fIfile-name\fP
.br
\fBaseqsend\fP \fB\-p\fP \fIclient:port\fP \fI\(dqhex encoded byte-string\(dq\fP

.SH "توضیحات (DESCRIPTION)"
دستور
.B aseqsend
یک ابزار خط فرمان است که امکان ارسال داده‌های SysEx (مخصوص سیستم یا System Exclusive) را به درگاه ترتیب‌سنج (sequencer) ALSA MIDI فراهم می‌کند.
همچنین می‌تواند هر دستور دیگر MIDI را نیز ارسال کند.
پیام‌های ارسالی را می‌توان در آرگومان پایانی به‌صورت یک رشتهٔ بایتی با کدگذاری هگزادسیمال (hex) مشخص کرد یا آن‌ها را از یک فایل باینری خام (raw binary) خواند.
هنگام ارسال هم‌زمان چندین پیام SysEx، به‌طور پیش‌فرض تاخیری معادل ۱ میلی‌ثانیه پس از هر پیام وجود دارد که با استفاده از گزینهٔ
.B \-i
می‌توان آن را به مقدار دیگری تغییر داد.

.PP
یک کلاینت را می‌توان با شماره، نام یا پیشوندی از نام آن مشخص کرد. یک درگاه با شماره‌اش مشخص می‌شود؛ برای درگاه 0 یک کلاینت، می‌توان بخش
.B \(dq:0\(dq
از مشخصه درگاه را نادیده گرفت.

.PP
همچنین
.B aseqsend
می‌تواند با تعیین گزینهٔ
.B \-u
بسته‌های UMP را به‌عنوان یک دستگاه MIDI 2.0 ارسال کند، در حالی که عملکرد پیش‌فرض آن، جریان بایتی سنتی (legacy) در MIDI 1.0 است.

.SH "گزینه‌ها (OPTIONS)"

.TP
.I \-h, \-\-help
فهرستی از گزینه‌ها را چاپ می‌کند.

.TP
.I \-V, \-\-version
نسخهٔ فعلی را چاپ می‌کند.

.TP
.I \-l, \-\-list
فهرستی از درگاه‌های خروجی ممکن را چاپ می‌کند.

.TP
.I \-v, \-\-verbose
تعداد بایت‌های واقعاً ارسال‌شده را چاپ می‌کند.

.TP
.I \-p, \-\-port=client:port
درگاه مقصد را با شماره یا نام مشخص می‌کند.

.TP
.I \-s, \-\-file=filename
داده‌های باینری خام را از نام فایل داده‌شده ارسال می‌کند.

.TP
.I \-i, \-\-interval=msec
فاصلهٔ زمانی بین پیام‌های SysEx بر حسب میلی‌ثانیه.

.TP
.I \-u, \-\-ump=version
نسخهٔ MIDI را مشخص می‌کند؛ مقدار 0 برای MIDI 1.0 سنتی (پیش‌فرض)، مقدار 1 برای پروتکل UMP MIDI 1.0 و مقدار 2 برای پروتکل UMP MIDI 2.0 است.

.PP
هنگامی که پروتکل UMP MIDI 1.0 یا MIDI 2.0 مشخص شده باشد،
.B aseqsend
ورودی را به‌صورت بسته‌های خام UMP، هر ۴ بایت در قالب اندیان بزرگ (big endian) می‌خواند.

.SH "مثال‌ها (EXAMPLES)"

.PP
.B aseqsend \-p 128:0 \(dqF0 41 10 00 00 64 12 18 00 21 06 59 41 59 4E F7\(dq

.PP
.B aseqsend \-p 128:0 \-s I7BulkDump.syx

.SH "همچنین ببینید (SEE ALSO)"
.BR aseqdump (1)

.SH "نویسندگان (AUTHORS)"
Miroslav Kovac <mixxoo@gmail.com>