.TH libinput-debug-events "1" "" "libinput 1.31.3" "libinput Manual"
.SH "نام (NAME)"
libinput\-debug\-events \- ابزار کمکی اشکال‌زدایی برای libinput
.SH "خلاصه دستور (SYNOPSIS)"
.B libinput debug\-events \fI[options]\fB
.PP
.B libinput debug\-events \fI[options]\fB \-\-udev \fI<seat>\fB
.PP
.B libinput debug\-events \fI[options]\fB [\-\-device] \fI/dev/input/event0\fB [\fI/dev/input/event1\fB...]
.SH "توضیحات (DESCRIPTION)"
.PP
ابزار
.B "libinput debug\-events"
یک بافت (context) برای libinput ایجاد کرده و تمام رویدادهای ارسالی از این دستگاه‌ها را چاپ می‌کند.
.PP
این صرفاً یک ابزار اشکال‌زدایی است و خروجی آن ممکن است در هر زمان تغییر کند. به این خروجی اتکا نکنید.
.PP
این ابزار معمولاً برای دسترسی به گره‌های /dev/input/eventX باید با دسترسی ریشه (root) اجرا شود.
.SH "گزینه‌ها (OPTIONS)"
.TP 8
.B \-\-device \fI/dev/input/event0\fR
استفاده از دستگاه یا دستگاه‌های مشخص‌شده با بک‌اند مسیر (path backend). آرگومان \fB\-\-device\fR می‌تواند حذف شود.
.TP 8
.B \-\-grab
گرفتن انحصاری (grab) تمام دستگاه‌های باز شده. این کار از تحویل رویدادها به سیستم میزبان جلوگیری می‌کند.
.TP 8
.B \-\-help
نمایش راهنما
.TP 8
.B \-\-quiet
فقط چاپ پیام‌های libinput و چاپ نکردن هیچ پیامی از خود این ابزار. این گزینه در ترکیب با \-\-verbose برای اشکال‌زدایی وضعیت داخلی مفید است.
.TP 8
.B \-\-show\-keycodes
رویدادهای کلید نمایش‌داده‌شده توسط این ابزار تا حدی مبهم‌سازی (obfuscate) می‌شوند تا از نمایش گذرواژه‌ها و دیگر اطلاعات حساس در خروجی جلوگیری شود. از آرگومان
.B \-\-show\-keycodes
برای نمایان کردن تمام کدهای کلید (keycodes) استفاده کنید.
.TP 8
.B \-\-udev \fI<seat>\fR
استفاده از بک‌اند udev برای گوش دادن به اعلان‌های دستگاه روی seat مشخص‌شده. رفتار پیش‌فرض معادل با \-\-udev "seat0" است.
.TP 8
.B \-\-verbose
استفاده از خروجی با جزئیات بیشتر (پُرگو)
.SS "گزینه‌های پیکربندی libinput"
.TP 8
.B \-\-apply-to="pattern"
گزینه‌های پیکربندی فقط در صورتی اعمال می‌شوند که نام دستگاه با الگو مطابقت داشته باشد. این الگو تأثیری بر گزینه \fB\-\-disable-sendevents\fR ندارد.
.TP 8
.B \-\-disable-sendevents="pattern"
غیرفعال کردن گزینه send-events برای دستگاه‌های منطبق با الگوها. این گزینه تحت تأثیر گزینه \fB\-\-apply-to="pattern"\fR قرار نمی‌گیرد.
.TP 8
.B \-\-enable-drag|\-\-disable\-drag
فعال یا غیرفعال کردن ضربه و کشیدن (tap-and-drag)
.TP 8
.B \-\-enable\-drag\-lock|\-\-disable\-drag\-lock
فعال کردن (در حالت مهلت زمانی / timeout) یا غیرفعال کردن قفل کشیدن (drag-lock)
.B \-\-enable\-drag\-lock=[sticky|timeout]
فعال کردن قفل کشیدن در حالت چسبنده (sticky) یا مهلت زمانی (timeout)
.TP 8
.B \-\-enable\-dwt|\-\-disable\-dwt
فعال یا غیرفعال کردن غیرفعال‌سازی هنگام تایپ (disable-while-typing)
.TP 8
.B \-\-enable\-dwtp|\-\-disable\-dwtp
فعال یا غیرفعال کردن غیرفعال‌سازی هنگام استفاده از ترک‌پوینت (disable-while-trackpointing)
.TP 8
.B \-\-enable\-left\-handed|\-\-disable\-left\-handed
فعال یا غیرفعال کردن پیکربندی دکمه‌ها برای افراد چپ‌دست
.TP 8
.B \-\-enable\-middlebutton|\-\-disable\-middlebutton
فعال یا غیرفعال کردن شبیه‌سازی دکمه وسط ماوس
.TP 8
.B \-\-enable\-natural\-scrolling|\-\-disable\-natural\-scrolling
فعال یا غیرفعال کردن پیمایش طبیعی (natural scrolling)
.TP 8
.B \-\-enable\-scroll-button-lock|\-\-disable\-scroll-button-lock
فعال یا غیرفعال کردن قفل دکمه پیمایش
.TP 8
.B \-\-enable\-tap|\-\-disable\-tap
فعال یا غیرفعال کردن ضربه برای کلیک (tap-to-click)
.TP 8
.B \-\-set\-area="x1/y1 x2/y2"
تنظیم ناحیه تبلت به مستطیل توصیف‌شده با دو نقطه x1/y1 و x2/y2. تمام مختصات باید در محدوده [0.0, 1.0] باشند.
.TP 8
.B \-\-set\-calibration="1.0 0.0 0.0 0.0 1.0 0.0"
تنظیم ۶ عنصر اول یک ماتریس ۳×۳ برای استفاده در کالیبراسیون. سطر سوم ماتریس همیشه "0.0 0.0 0.1" است.
.TP 8
.B \-\-set\-click\-method=[none|clickfinger|buttonareas]
تنظیم روش کلیک دلخواه
.TP 8
.B \-\-set\-clickfinger\-map=[lrm|lmr]
تنظیم نگاشت دکمه‌ها برای کلیک با انگشت (clickfinger)
.TP 8
.B \-\-set\-custom\-points="<value>;...;<value>"
تنظیم n نقطه تعریف‌کننده یک تابع شتاب سفارشی. نقاط در یک فهرست جداشده با نقطه ویرگول از اعداد غیرمنفی ممیز شناور تعریف می‌شوند. مقدار پیش‌فرض "0.0;1.0" است. این گزینه فقط برای نمایه سفارشی (custom profile) اعمال می‌شود.
.TP 8
.B \-\-set\-custom\-step=<value>
تنظیم فاصله در امتداد محور x بین هر نقطه، با شروع از 0. پیش‌فرض 1.0 است. این گزینه فقط برای نمایه سفارشی اعمال می‌شود.
.TP 8
.B \-\-set\-custom\-type=[fallback|motion|scroll]
تنظیم نوع تابع شتاب سفارشی. مقدار پیش‌فرض fallback است. این گزینه فقط برای نمایه سفارشی اعمال می‌شود.
.TP 8
.B \-\-set\-eraser\-button\-button=[BTN_STYLUS|BTN_STYLUS2|BTN_STYLUS3]
تنظیم دکمه پاک‌کن به دکمه قلم تبلت داده‌شده. فقط زمانی اثر می‌کند که با
.B \-\-set\-eraser\-button\-mode=on\-button\-down
ترکیب شود.
.TP 8
.B \-\-set\-eraser\-button\-mode=[default|on-button-down]
تنظیم حالت دکمه پاک‌کن به حالت داده‌شده.
.TP 8
.B \-\-set\-pressure\-range=<min>:<max>
تنظیم محدوده فشار قلم تبلت به min:max. مقادیر min و max باید در محدوده [0.0, 1.0] باشند.
.TP 8
.B \-\-set\-profile=[adaptive|flat|custom]
تنظیم نمایه شتاب نشانگر
.TP 8
.B \-\-set\-rotation\-angle=<degrees>
تنظیم زاویه چرخش بر حسب درجه (0 تا 360).
.TP 8
.B \-\-set\-scroll\-button=BTN_MIDDLE
تنظیم دکمه به کد دکمه داده‌شده
.TP 8
.B \-\-set\-scroll\-method=[none|twofinger|edge|button]
تنظیم روش پیمایش دلخواه
.TP 8
.B \-\-set\-sendevents=[disabled|enabled|disabled-on-external-mouse]
تنظیم حالت sendevents مشخص‌شده. این گزینه مقدار
\fB\-\-disable-sendevents="pattern"\fR
را برای هر دستگاهی که از طریق گزینه
\fB\-\-apply-to="pattern"\fR
با آن مطابقت دارد لغو می‌کند.
.TP 8
.B \-\-set\-speed=<value>
تنظیم سرعت شتاب نشانگر. محدوده مجاز [-1, 1] است. این گزینه فقط برای نمایه flat یا adaptive اعمال می‌شود.
.TP 8
.B \-\-set\-tap\-map=[lrm|lmr]
تنظیم نگاشت دکمه‌ها برای ضربه زدن (tapping)
.SH "نکات (NOTES)"
.PP
رویدادهای نمایش‌داده‌شده توسط این ابزار ممکن است با رویدادهای مشاهده‌شده توسط کاربر دیگری از libinput مطابقت نداشته باشد. این ابزار یک بافت (context) جداگانه را مقداردهی اولیه می‌کند.
.SH "لیب‌اینپوت (LIBINPUT)"
بخشی از مجموعه
.BR libinput (1)