.TH RATBAGCTL "1" "0.18"
.SH "نام (NAME)"
ratbagctl \- بررسی و تغییر تنظیمات ماوس‌های با قابلیت پیکربندی
.SH "خلاصه دستور (SYNOPSIS)"
.B ratbagctl
.RI [< options >]
.B list
.br
.B ratbagctl
.RI [< options >]
.RI < device "> <" command "> ..."
.SH "توضیحات (DESCRIPTION)"
.PP
ابزار
.B ratbagctl
تنظیمات یک دستگاه را بررسی یا تغییر می‌دهد.
.PP
این ابزار معمولاً برای کار به اجرای ratbagd نیاز دارد.
.SH "گزینه‌ها (OPTIONS)"
.TP 8
.B \-\-version, \-V
نمایش شماره نسخه برنامه و خروج.
.TP 8
.B \-\-verbose, \-v
چاپ خروجی اشکال‌زدایی. استفاده چندباره از گزینه \-v میزان جزئیات خروجی را افزایش می‌دهد. برای نمونه،
.B \-vvv
خروجی پروتکل را نشان خواهد داد.
.TP 8
.B \-\-nocommit
تنظیمات را بلافاصله روی ماوس اعمال نکن. این گزینه اجازه می‌دهد چندین پارامتر درون یک اسکریپت تعیین شوند، و آخرین فراخوانی
.B ratbagctl
تمام آن‌ها را به یکباره اعمال خواهد کرد.
.TP 8
.B \-\-help, \-h
نمایش راهنما.
.SH "دستورات عمومی (GENERAL COMMANDS)"
.TP 8
.B list
فهرست کردن دستگاه‌های پشتیبانی‌شده (آرگومان دستگاه نمی‌پذیرد)
.SH "دستورات دستگاه (DEVICE COMMANDS)"
.TP 8
.B info
چاپ اطلاعات مربوط به یک دستگاه
.TP 8
.B name
چاپ نام دستگاه
.SH "دستورات نمایه (PROFILE COMMANDS)"
.TP 8
.B profile active get
چاپ نمایه فعال کنونی
.TP 8
.B profile active set N
تنظیم نمایه N به‌عنوان نمایه فعال
.TP 8
.B profile N {COMMAND}
استفاده از نمایه N برای COMMAND
.PP
.B دستورات COMMAND دردسترس:
.RS
.TP 8
.B get
چاپ اطلاعات نمایه انتخاب‌شده
.TP 8
.B name get
چاپ نام نمایه
.TP 8
.B name set blah
تنظیم نام نمایه
.TP 8
.B enable
فعال‌سازی یک نمایه
.TP 8
.B disable
غیرفعال‌سازی یک نمایه
.TP 8
.B [resolution|dpi|rate|button|led] ...
استفاده از نمایه N برای دستور مشخص‌شده.
.RE
.SH "دستورات تفکیک‌پذیری (RESOLUTION COMMANDS)"
دستورات تفکیک‌پذیری روی نمایه ارائه‌شده، یا در صورت مشخص نشدن روی نمایه فعال کار می‌کنند.
.TP 8
.B resolution active get
چاپ تفکیک‌پذیری فعال کنونی
.TP 8
.B resolution active set N
تنظیم تفکیک‌پذیری N به‌عنوان تفکیک‌پذیری فعال
.TP 8
.B resolution default get
چاپ تفکیک‌پذیری پیش‌فرض کنونی
.TP 8
.B resolution default set N
تنظیم تفکیک‌پذیری N به‌عنوان تفکیک‌پذیری پیش‌فرض
.TP 8
.B resolution N {COMMAND}
استفاده از تفکیک‌پذیری N برای COMMAND
.PP
.B دستورات COMMAND دردسترس:
.RS
.TP 8
.B get
چاپ تفکیک‌پذیری انتخاب‌شده
.TP 8
.B [dpi|rate] ...
استفاده از تفکیک‌پذیری N برای دستور مشخص‌شده.
.RE
.SH "دستورات DPI (DPI COMMANDS)"
دستورات DPI روی نمایه و تفکیک‌پذیری مشخص‌شده، یا در صورت مشخص نشدن روی تفکیک‌پذیری فعال از نمایه فعال کار می‌کنند.
.TP 8
.B dpi get
چاپ مقدار dpi
.TP 8
.B dpi get-all
چاپ مقادیر dpi پشتیبانی‌شده
.TP 8
.B dpi set N
تنظیم مقدار dpi روی N
.SH "دستورات نرخ گزارش‌دهی (RATE COMMANDS)"
دستورات نرخ گزارش‌دهی روی نمایه و تفکیک‌پذیری مشخص‌شده، یا در صورت مشخص نشدن روی تفکیک‌پذیری فعال از نمایه فعال کار می‌کنند.
.TP 8
.B rate get
چاپ نرخ گزارش‌دهی به میلی‌ثانیه (ms)
.TP 8
.B rate get-all
چاپ نرخ‌های گزارش‌دهی پشتیبانی‌شده به میلی‌ثانیه (ms)
.TP 8
.B rate set N
تنظیم نرخ گزارش‌دهی روی N میلی‌ثانیه
.SH "دستورات کلیدها (BUTTON COMMANDS)"
دستورات کلید روی نمایه مشخص‌شده، یا در صورت مشخص نشدن روی نمایه فعال کار می‌کنند.
.TP 8
.B button count
چاپ تعداد کلیدها
.TP 8
.B button N get
چاپ اطلاعات کلید انتخاب‌شده
.TP 8
.B button N action get
چاپ عملکرد کلید
.TP 8
.B button N action set button B
تنظیم عملکرد کلید روی کلید B
.TP 8
.B button N action set special S
تنظیم عملکرد کلید روی عملکرد ویژه S
.TP 8
.B button N action set macro ...
تنظیم عملکرد کلید روی ماکروی مشخص‌شده
.PP
.B نحو ماکرو (Macro syntax):
.HP 8
یک ماکرو دنباله‌ای از رویدادهای کلید یا دوره‌های انتظار است. کلیدها باید با نام‌های کلید مشخص‌شده در linux/input-event-codes.h تعیین شوند.
.RS
.TP 8
.B KEY_A
فشردن و رها کردن 'a'
.TP 8
.B +KEY_A
فشردن 'a'
.TP 8
.B \-KEY_A
رها کردن 'a'
.TP 8
.B t300
انتظار ۳۰۰ میلی‌ثانیه
.RE
.SH "دستورات ال‌ای‌دی (LED COMMANDS)"
دستورات LED روی نمایه مشخص‌شده، یا در صورت مشخص نشدن روی نمایه فعال کار می‌کنند.
.TP 8
.B led get
چاپ مقادیر فعلی led
.TP 8
.B led N get
چاپ مقدار LED انتخاب‌شده
.TP 8
.B led N {COMMAND}
استفاده از led N برای COMMAND
.PP
.B دستورات COMMAND دردسترس:
.RS
.TP 8
.B mode [on|off|cycle|breathing]
حالت مورد نظر برای تنظیم به‌عنوان حالت فعلی
.TP 8
.B color RRGGBB
رنگ مورد نظر برای تنظیم به‌عنوان رنگ فعلی (رنگ باید در قالب شانزده‌شانزدهی/هگزادسیمال باشد).
.TP 8
.B rate R
نرخ مورد نظر برای تنظیم به‌عنوان نرخ فعلی
.TP 8
.B brightness B
روشنایی مورد نظر برای تنظیم به‌عنوان روشنایی فعلی
.RE
.SH "مثال‌ها (EXAMPLES)"
.TP 8
ratbagctl profile active get eventX
.TP 8
ratbagctl profile 0 resolution active set 4 eventX
.TP 8
ratbagctl profile 0 resolution 1 dpi get eventX
.TP 8
ratbagctl resolution 4 rate get eventX
.TP 8
ratbagctl dpi set 800 eventX
.SH "نکات (NOTES)"
.PP
در حال حاضر هیچ تضمینی وجود ندارد که قالب خروجی
.B ratbagctl
در آینده تغییر نکند. دستورات ذکرشده در این صفحه راهنما باید تا حدی پایداری داشته باشند، اما انتظار نداشته باشید که همواره بدون تغییر باقی بمانند.
.SH "نویسندگان (AUTHORS)"
.B ratbagctl
توسط David Herrmann، Peter Hutterer و Benjamin Tissoires نوشته شده است.
.PP
این صفحه راهنما توسط Stephen Kitt <skitt@debian.org> برای سیستم دبیان گنو/لینوکس (Debian GNU/Linux) نوشته شده است (اما ممکن است توسط دیگران نیز استفاده شود).