نام (NAME)

xinput - ابزاری برای پیکربندی و آزمایش دستگاه‌های ورودی X

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

xinput [COMMAND] [OPTIONS] [DEVICE]

توضیحات (DESCRIPTION)

دستور xinput ابزاری برای فهرست کردن دستگاه‌های ورودی موجود، استعلام اطلاعات یک دستگاه و تغییر تنظیمات دستگاه‌های ورودی است.

دستورها (COMMANDS)

--version: بررسی می‌کند که آیا افزونهٔ X Input در دسترس است یا خیر و شماره نسخهٔ برنامه و نسخهٔ پشتیبانی‌شده توسط سرور را بازمی‌گرداند. این گزینه نیازی به نام دستگاه ندارد.
list [--short || --long || --name-only || --id-only] [device]: اگر هیچ آرگومانی داده نشود، همهٔ دستگاه‌های ورودی را فهرست می‌کند. اگر یک آرگومان داده شود، همهٔ قابلیت‌ها و ویژگی‌های device را نمایش می‌دهد. اگر --long ارائه شود، خروجی شامل اطلاعات دقیق دربارهٔ قابلیت‌های هر دستگاه خواهد بود. در غیر این صورت، یا اگر --short ارائه شود، تنها نام دستگاه‌ها و اطلاعاتی حداقلی فهرست می‌شوند. اگر --name-only ارائه شود، خروجی تنها به نام دستگاه‌ها محدود می‌شود؛ در هر خط یک نام دستگاه فهرست می‌شود. توجه داشته باشید که ترتیب فهرست شدن دستگاه‌ها نامشخص است. اگر --id-only ارائه شود، خروجی تنها به شناسهٔ دستگاه‌ها محدود می‌شود؛ در هر خط یک شناسهٔ دستگاه درج می‌شود. توجه داشته باشید که ترتیب فهرست شدن دستگاه‌ها نامشخص است.
get-feedbacks device: بازخوردهای device را نمایش می‌دهد.
set-pointer device: دستگاه device را به اشاره‌گر اصلی (core pointer) تبدیل می‌کند. این گزینه روی سرورهای X نسخهٔ 1.5 و بالاتر کاری انجام نمی‌دهد.
set-mode device ABSOLUTE|RELATIVE: حالت device را تغییر می‌دهد.
set-ptr-feedback device threshold num denom: پارامترهای شتاب (یا بازخورد) اشاره‌گرِ device را تغییر می‌دهد. صفحهٔ راهنمای xset(1) جزئیات بیشتری دارد. برای سرور X.Org نسخهٔ 1.7 و بالاتر، ویژگی‌های دستگاهیِ بیشتری مربوط به شتاب اشاره‌گر وجود دارند. این ویژگی‌ها جایگزین تنظیمات بازخورد اشاره‌گر نمی‌شوند، بلکه مکمل آن هستند.
set-integer-feedback device index value: مقدار بازخورد عدد صحیح (integer feedback) مربوط به device را تغییر می‌دهد.
set-button-map device map_button_1 [map_button_2 [...]]: نگاشت دکمه‌های device را تغییر می‌دهد. دکمه‌ها بر اساس ترتیب فیزیکی (با شروع از دکمهٔ ۱) مشخص می‌شوند و به دکمهٔ منطقی داده‌شده نگاشت می‌شوند. مقدار 0 یک دکمه را غیرفعال می‌کند. نگاشت پیش‌فرض دکمه‌ها برای یک دستگاه 1 2 3 4 5 6 و غیره است.
query-state device: وضعیت دستگاه را استعلام می‌کند.
list-props device [device [...]]: ویژگی‌هایی را که می‌توان برای دستگاه(های) مشخص‌شده تنظیم کرد، فهرست می‌کند.
set-int-prop device property format value: یک ویژگی عدد صحیح برای دستگاه تنظیم می‌کند. مقادیر مناسب برای format بسته به ویژگی، 8، 16 یا 32 هستند. منسوخ شده است، به جای آن از set-prop استفاده کنید.
set-float-prop device property value: یک ویژگی ممیز شناور برای دستگاه تنظیم می‌کند. منسوخ شده است، به جای آن از set-prop استفاده کنید.
set-prop [--type=atom|float|int] [--format=8|16|32] device property value [...]: ویژگی مورد نظر را روی مقدار(های) داده‌شده تنظیم می‌کند. اگر مشخص نشود، قالب و نوع ویژگی بدون تغییر باقی می‌مانند. آرگومان‌ها با توجه به نوع ویژگی تفسیر می‌شوند. بخش تغییر ویژگی‌ها (CHANGING PROPERTIES) را ببینید.
watch-props device: هنگام وقوع تغییرات در ویژگی‌ها، آن‌ها را در خروجی استاندارد چاپ می‌کند.
delete-prop device property: ویژگی را از دستگاه حذف می‌کند.
test [-proximity] device: تمام رویدادهای توسعه‌یافته را از device ثبت کرده و وارد یک حلقهٔ بی‌پایان می‌شود که رویدادهای دریافت‌شده را نمایش می‌دهد. اگر -proximity داده شود، ProximityIn و ProximityOut نیز ثبت می‌شوند.
test-xi2 [--root] [device]: برای تعدادی از رویدادهای XI2 ثبت‌نام کرده و آن‌ها را نمایش می‌دهد. اگر دستگاهی مشخص شود، فقط رویدادهای آن دستگاه نمایش داده می‌شوند. اگر --root داده شود، رویدادها فقط روی پنجرهٔ ریشه (root window) انتخاب می‌شوند. در غیر این صورت، یک پنجرهٔ کلاینت جدید ایجاد می‌شود (مشابه xev).
create-master prefix [sendCore] [enable]: یک جفت دستگاه اصلی (master) جدید روی یک سرور با پشتیبانی از XI2 با پیشوند prefix داده‌شده ایجاد می‌کند. سرور یک اشاره‌گر اصلی به نام "prefix pointer" و یک صفحه‌کلید اصلی به نام "prefix keyboard" ایجاد خواهد کرد. اگر sendCore برابر 1 باشد، این جفت دستگاه اصلی برای ارسال رویدادهای اصلی تنظیم می‌شوند (پیش‌فرض). اگر enable برابر 1 باشد، این جفت دستگاه اصلی بی‌درنگ فعال خواهند شد (پیش‌فرض).
remove-master master [Floating|AttachToMaster] [returnPointer] [returnKeyboard]: دستگاه master و دستگاه اصلی جفت‌شده با آن را حذف می‌کند. دستگاه‌های فرعی (slave) متصل‌شده در صورتی که Floating مشخص شده باشد یا آرگومان حذف شود، به صورت شناور (floating) تنظیم می‌شوند. اگر آرگومان دوم AttachToMaster باشد، returnPointer اشاره‌گر اصلی را مشخص می‌کند که تمام اشاره‌گرهای فرعی به آن متصل شوند و returnKeyboard صفحه‌کلید اصلی را مشخص می‌کند که تمام صفحه‌کلیدهای فرعی به آن متصل شوند.
reattach slave master: دستگاه فرعی slave را دوباره به master متصل می‌کند.
float slave: دستگاه فرعی slave را از دستگاه اصلی فعلی آن جدا می‌کند.
set-cp window master: اشاره‌گر کلاینت (ClientPointer) را برای کلاینت مالک window روی master تنظیم می‌کند. master باید یک اشاره‌گر اصلی را مشخص کند.
map-to-output device crtc: حرکات دستگاه با مختصات مطلق (device) را به crtc مربوط به RandR محدود می‌کند. نام خروجی باید با یک خروجی در حال حاضر متصل مطابقت داشته باشد (به xrandr(1) مراجعه کنید). اگر درایور باینری NVIDIA شناسایی شود یا RandR نسخهٔ 1.2 یا بالاتر در دسترس نباشد، یک خروجی Xinerama ممکن است به صورت "HEAD-N" مشخص شود که در آن N شمارهٔ صفحهٔ Xinerama است. این گزینه روی دستگاه‌های نسبی هیچ اثری ندارد. اگر crtc روی "all" تنظیم شود، رفتار پیش‌فرض اعمال می‌شود.
enable device: دستگاه device را فعال می‌کند. این فراخوانی معادل دستور زیر است: xinput --set-prop device "Device Enabled" 1
disable device: دستگاه device را غیرفعال می‌کند. این فراخوانی معادل دستور زیر است: xinput --set-prop device "Device Enabled" 0

پارامتر device می‌تواند نام دستگاه به صورت یک رشته یا XID آن دستگاه باشد.

پارامتر slave می‌تواند نام دستگاه به صورت یک رشته یا XID یک دستگاه وابسته باشد.

پارامتر master می‌تواند نام دستگاه به صورت یک رشته یا XID یک دستگاه اصلی باشد.

پارامتر property می‌تواند ویژگی به صورت یک رشته یا مقدار Atom باشد.

تغییر ویژگی‌ها (CHANGING PROPERTIES)

هنگامی که xinput باید مقدار یک ویژگی موجود درایور را تغییر دهد، کافی است نام دستگاه و نام ویژگی به صورت رشته ارائه شوند و پس از آن مقدار(های) جدید ویژگی بیایند. برای مثال:

: xinput set-prop "my device" "my prop" 1 2 3

XWAYLAND

‏Xwayland یک سرور X است که از یک ترکیب‌گر ویلند (Wayland Compositor) به عنوان بک‌اند استفاده می‌کند. ‏Xwayland به عنوان یک لایهٔ ترجمه میان پروتکل X و پروتکل Wayland عمل می‌کند اما دسترسی مستقیم به سخت‌افزار ندارد. دستگاه‌های افزونهٔ X Input ایجادشده توسط Xwayland (مانند "xwayland-pointer" و "xwayland-keyboard" و غیره) به دستگاه‌های پروتکل Wayland نگاشت می‌شوند، نه به دستگاه‌های فیزیکی.

این دستگاه‌های افزونهٔ X Input تنها برای سایر کلاینت‌های X متصل به همان فرایند Xwayland قابل مشاهده هستند. تغییر ویژگی‌ها در دستگاه‌های Xwayland تنها بر رفتار آن کلاینت‌ها تأثیر می‌گذارد. برای مثال، غیرفعال کردن یک دستگاه Xwayland با xinput، آن دستگاه را در برنامه‌های بومی Wayland غیرفعال نمی‌کند. سایر تغییرات ممکن است اصلاً هیچ اثری نداشته باشند.

در بیشتر موارد، استفاده از xinput با یک دستگاه Xwayland نشان‌دهندهٔ وجود باگ در یک اسکریپت شل است و xinput هشداری چاپ خواهد کرد. به جای آن، از روش‌های بومی پیکربندی دستگاه در ترکیب‌گر Wayland استفاده کنید.

همچنین ببینید (SEE ALSO)

X(7), xset(1), xrandr(1)

کپی‌رایت و تکثیر (COPYRIGHT)

نویسندگان (AUTHORS)

Peter Hutterer <peter.hutterer@who-t.net>
Philip Langdale, <philipl@alumni.utexas.net>
Frederic Lepied, France <Frederic.Lepied@sugix.frmug.org>
Julien Cristau <jcristau@debian.org>
Thomas Jaeger <ThJaeger@gmail.com>
و دیگران.