نام (NAME)

libinput-debug-gui - ابزار بصری کمکی برای اشکال‌زدایی libinput

خلاصه دستور (SYNOPSIS)

libinput debug-gui [گزینه‌ها]

libinput debug-gui [گزینه‌ها] --udev <seat>

libinput debug-gui [گزینه‌ها] [--device] /dev/input/event0

توضیحات (DESCRIPTION)

ابزار libinput debug-gui یک بستر (context) libinput و یک پنجرهٔ تمام‌صفحهٔ GTK برای مصورسازی رویدادهای پردازش‌شده توسط libinput ایجاد می‌کند. این ابزار دستگاه‌های اشاره‌گر را به‌طور انحصاری در اختیار می‌گیرد (grab می‌کند) و مانع از تعامل آن‌ها با سایر بخش‌های رابط کاربری گرافیکی (GUI) می‌شود.

برای خروج از این ابزار کلید Esc را فشار دهید.

این ابزار صرفاً برای اشکال‌زدایی است و خروجی یا رفتار آن ممکن است در هر زمان تغییر کند. به خروجی یا رفتار آن وابسته نباشید.

این ابزار معمولاً برای دسترسی به گره‌های /dev/input/eventX باید به عنوان مدیر سیستم (root) اجرا شود.

گزینه‌ها (OPTIONS)

--device /dev/input/event0

استفاده از دستگاه داده‌شده با پسانهٔ مسیر (path backend). آرگومان --device می‌تواند حذف شود.

--grab

در اختیار گرفتن انحصاری (grab) تمام دستگاه‌های بازشده. این کار از ارسال رویدادها به سیستم میزبان جلوگیری می‌کند.

--help

نمایش راهنما

--udev <seat>

استفاده از پسانهٔ udev برای شنود اعلان‌های دستگاه روی seat داده‌شده. رفتار پیش‌فرض معادل با --udev "seat0" است.

--verbose

استفاده از خروجی پرگو (مشروح)

برای گزینه‌های پیکربندی libinput، به libinput-debug-events(1) مراجعه کنید.

قابلیت‌ها (FEATURES)

حرکت مکان‌نما

مکان‌نما به صورت یک مثلث سیاه نمایش داده می‌شود. نشانگرهای متعددی با رنگ خاکستری روشن برای کمک به اشکال‌زدایی موقعیت مکان‌نما نمایش داده می‌شوند. حرکت مکان‌نما همان چیزی است که توسط libinput دیده می‌شود و ممکن است با حرکت مکان‌نما در کارساز نمایش (display server) مطابقت نداشته باشد.

حرکت بدون شتاب مکان‌نما به صورت یک مثلث وارونهٔ خاکستری نمایش داده می‌شود. حرکت این مکان‌نما معمولاً منعکس‌کنندهٔ حرکت نسبی در واحدهای دستگاه است و می‌تواند با حرکت عادی مکان‌نما تفاوت چشمگیری داشته باشد.

حرکت بدون شتاب مکان‌نما همچنین به صورت یک مار زرد رنگ نمایش داده می‌شود. این یک توالی پیوسته از دلتاهای (تغییرات) اخیر است. بر خلاف مکان‌نمای بدون شتاب، این مختصات به پنجره محدود (clip) نمی‌شوند.

آزمایش دکمه‌ها

چهار مستطیل در پایین نمایش داده می‌شوند. سه تای بالایی مربوط به چپ، وسط و راست هستند؛ مستطیل پایینی برای هر دکمهٔ دیگری است و نام دکمه را هنگام فشرده شدن نمایش می‌دهد.

پیمایش

مستطیل‌های سبز رنگ پیمایش را در فضای پیوسته نشان می‌دهند و مستطیل‌های قرمز کوچک‌تر، گام‌های پیمایش را در مراحل گسسته نمایش می‌دهند.

ژست‌های حرکتی

مجموعه‌ای از چهار حلقهٔ سیاه افقی ژست‌های کشیدن (swipe) را نشان می‌دهند که تعداد انگشتان شناسایی‌شده در آن پر می‌شود. مجموعه‌ای از دو حلقهٔ سیاه ژست‌های نیشگون (pinch) را نشان می‌دهند که هنگام شناسایی رویدادها پر می‌شوند.

رویدادهای لمسی و موش با مختصات مطلق

رویدادهای لمسی و موش با مختصات مطلق (absolute mouse) به‌ترتیب به صورت دایره‌های قرمز و آبی در نقطهٔ لمس یا موقعیت مطلق نمایش داده می‌شوند.

ابزارهای تبلت

رویدادهای ابزارهای تبلت یک مربع فیروزه‌ای در موقعیت‌های ورود به محدوده (proximity-in) و خروج از محدوده (proximity-out) نشان می‌دهند. موقعیت ابزار به صورت دایره نمایش داده می‌شود و با افزایش فشار یا فاصله، شعاع آن افزایش می‌یابد. فشار و فاصله همچنین در نوار عمودی جنوب شرقی مرکز نمایش داده می‌شوند. در صورت پشتیبانی از شیب (tilt)، دایره به بیضی تغییر شکل می‌دهد تا زاویهٔ شیب را نشان دهد. رویدادهای نسبی ابزار تبلت به صورت یک مار زرد نمایش داده می‌شوند که همیشه با ورود به محدوده، از مرکز پنجره آغاز می‌شود. رویدادهای دکمه‌ها در پایین‌ترین مستطیل دکمه نمایش داده می‌شوند و نام دکمه هنگام فشردن نشان داده می‌شود.

پدهای تبلت

رویدادهای دکمه در پایین‌ترین مستطیل دکمه نمایش داده می‌شوند و نام دکمه هنگام فشرده شدن نمایش داده می‌شود. رویدادهای چرخانک‌ها (dial)، حلقه‌ها (ring) و نوارهای لمسی (strip) در نماد زرد رنگ 'IO' نمایش داده می‌شوند، به‌طوری که هنگام در دسترس بودن رویدادها، موقعیت حلقه یا نوار یا دلتای چرخانک پر می‌شود. در صورت وجود رویداد، شمارهٔ چرخانک، حلقه یا نوار نمایش داده می‌شود.

رویدادهای هسته

در سمت چپ مرکز، یک حلقهٔ آبی برای اشکال‌زدایی رویدادهای نسبی هسته (REL_X و REL_Y) قرار دارد. هر واحد به صورت یک فلش در جهت مربوطه نمایش داده می‌شود. در سمت راست مرکز، یک مستطیل آبی نشان‌دهندهٔ جدیدترین دستگاه لمسی استفاده‌شده است. رویدادهای لمسی به همان صورتی که از هسته خوانده می‌شوند نمایش می‌یابند.

نکات (NOTES)

رویدادهای نمایش داده شده توسط این ابزار ممکن است با رویدادهایی که توسط کاربر دیگری از libinput دیده می‌شود مطابقت نداشته باشد. این ابزار یک بستر (context) جداگانه را مقداردهی اولیه می‌کند.

LIBINPUT

بخشی از مجموعهٔ libinput(1)