.\" Generated by scdoc 1.11.4 .\" Complete documentation for this program is not available as a GNU info page .ie \n(.g .ds Aq \(aq .el .ds Aq ' .nh .ad l .\" Begin generated content: .TH "sway-input" "5" "2026-06-23" .PP .SH "نام (NAME)" .PP sway-input \- فایل پیکربندی ورودی و دستورات .PP .SH "توضیحات (DESCRIPTION)" .PP محیط Sway امکان پیکربندی دستگاه‌ها را درون فایل پیکربندی sway فراهم می‌کند.\& برای به دست آوردن فهرستی از شناسه‌های دستگاه‌های در دسترس، دستور \fBswaymsg -t get_inputs\fR را اجرا کنید.\& تنظیمات همچنین می‌توانند با استفاده از نویسه عمومی (wildcard) \fI*\fR به جای \fI\fR در دستورات زیر، روی تمامی دستگاه‌های ورودی اعمال شوند.\& علاوه بر این، تنظیمات می‌توانند با استفاده از \fItype:\fR به جای \fI\fR، روی یک نوع خاص از دستگاه اعمال شوند.\& .PP در فایل پیکربندی، تنظیماتی که انتخاب‌گر خاص‌تری دارند نسبت به موارد عمومی‌تر اولویت دارند: \fI\fR > \fItype:\fR > \fI*\fR.\& اما هنگام اجرای دستورات ورودی در خط فرمان، تنظیمات روی تمامی دستگاه‌های ورودی منطبق اعمال می‌شوند!\& این بدان معناست که \fItype:\fR می‌تواند تنظیمات قبلاً اعمال‌شده \fI\fR را بازنویسی کند، هرچند در فایل پیکربندی اولویت با شناسه خاص بود.\& به طور مشابه اگر \fI*\fR دیرتر اعمال شود، می‌تواند هر دو تنظیمات \fI\fR و \fItype:\fR را بازنویسی کند.\& .PP نکته: اگر به نظر می‌رسد تنظیمات پیکربندی اعمال نمی‌شوند، می‌توانید به جای \fI\fR از \fI*\fR استفاده کنید.\& اگر با نویسه عمومی کار کرد، از شناسه‌های مختلف خروجی \fBswaymsg -t get_inputs\fR استفاده کنید تا دستگاه ورودی صحیح را پیدا کنید.\& .PP انواع ورودی موجود در حال حاضر عبارتند از: .PP .PD 0 .IP \(bu 4 touchpad .IP \(bu 4 pointer .IP \(bu 4 keyboard .IP \(bu 4 touch .IP \(bu 4 tablet_tool .IP \(bu 4 tablet_pad .IP \(bu 4 switch .PD .PP نکته: پیکربندی‌های نوع دستگاه (type) همزمان با شناسایی دستگاه‌ها و روی پیکربندی‌های موجود دستگاه اعمال می‌شوند.\& .PP .SH "دستورات ورودی (INPUT COMMANDS)" .PP .SS "پیکربندی صفحه‌کلید (KEYBOARD CONFIGURATION)" .PP \fBinput\fR repeat_delay .RS 4 مدت زمانی را که یک کلید باید نگه داشته شود تا تکرار آن آغاز شود (به میلی‌ثانیه) تنظیم می‌کند.\& .PP .RE \fBinput\fR repeat_rate .RS 4 نرخ تکرار کلید را پس از سپری شدن repeat_delay (به نویسه در ثانیه) تنظیم می‌کند.\& .PP .RE برای اطلاعات بیشتر در مورد این گزینه‌های پیکربندی xkb، به \fBxkeyboard-config\fR(7) مراجعه کنید.\& .PP \fBinput\fR xkb_file .RS 4 تمامی پیکربندی‌های xkb را از یک فایل کامل .\&xkb اعمال می‌کند.\& این فایل را می‌توان با دستور \fIxkbcomp $DISPLAY keymap.\&xkb\fR استخراج کرد.\& این تنظیم، تنظیمات xkb_layout، xkb_model، xkb_options، xkb_rules و xkb_variant را بازنویسی می‌کند.\& .PP .RE \fBinput\fR xkb_layout .RS 4 چیدمان صفحه‌کلید مانند \fIus\fR یا \fIde\fR یا \fIir\fR را تنظیم می‌کند.\& .PP می‌توان چند چیدمان را با جدا کردن آن‌ها با کاما مشخص کرد.\& .PP .RE \fBinput\fR xkb_model .RS 4 مدل صفحه‌کلید را تنظیم می‌کند.\& این مورد بر روی برخی کلیدهای اضافی که ممکن است صفحه‌کلید شما داشته باشد تأثیر می‌گذارد.\& .PP .RE \fBinput\fR xkb_options .RS 4 گزینه‌های پیکربندی اضافی xkb را برای صفحه‌کلید تنظیم می‌کند.\& .PP می‌توان چندین گزینه را با جدا کردن آن‌ها با کاما مشخص کرد.\& .PP .RE \fBinput\fR xkb_rules .RS 4 فایل‌های قوانین مورد استفاده برای ترکیب نگاشت صفحه‌کلید را مشخص می‌کند.\& .PP .RE \fBinput\fR xkb_switch_layout |next|prev .RS 4 چیدمان فعال صفحه‌کلید را به (شمارش از صفر) یا به چیدمان بعدی (next) یا قبلی (prev) در فهرست تغییر می‌دهد.\& اگر چیدمان بعدی یا قبلی وجود نداشته باشد، به سر دیگر فهرست می‌پرد.\& .PP این دستور زمانی کاربرد دارد که چند چیدمان با \fBxkb_layout\fR پیکربندی شده باشند.\& فهرستی از چیدمان‌های قابل تغییر را می‌توان با \fBswaymsg -t get_inputs\fR به دست آورد.\& .PP .RE \fBinput\fR xkb_variant .RS 4 گونه چیدمان صفحه‌کلید مانند \fIdvorak\fR یا \fIcolemak\fR را مشخص می‌کند.\& .PP .RE دستورات زیر تنها می‌توانند در فایل پیکربندی استفاده شوند.\& .PP \fBinput\fR xkb_capslock enabled|disabled .RS 4 کلید CapsLock را در زمان شروع فعال یا غیرفعال می‌کند؛ مقدار پیش‌فرض disabled است.\& .PP .RE \fBinput\fR xkb_numlock enabled|disabled .RS 4 کلید NumLock را در زمان شروع فعال یا غیرفعال می‌کند؛ مقدار پیش‌فرض disabled است.\& .PP .RE .SS "پیکربندی تبلت (TABLET CONFIGURATION)" .PP \fBinput\fR tool_mode .RS 4 مشخص می‌کند که حرکت ابزار تبلت باید به عنوان مطلق (absolute) در نظر گرفته شود یا نسبی (relative)؛ مقدار پیش‌فرض absolute است.\& .PP مقادیر معتبر برای \fI\fR در حال حاضر عبارتند از "pen"، "eraser"، "brush"، "pencil"، "airbrush" و نویسه عمومی \fI*\fR که با تمام ابزارها مطابقت دارد.\& .PP ابزارهای ماوس و لنز این تنظیم را نادیده می‌گیرند و همیشه به صورت نسبی در نظر گرفته می‌شوند.\& .PP .RE .SS "پیکربندی نگاشت (MAPPING CONFIGURATION)" .PP \fBinput\fR map_to_output .RS 4 ورودی‌های این دستگاه را به خروجی (نمایشگر) مشخص‌شده نگاشت می‌کند.\& تنها در صورتی معنادار است که دستگاه یک اشاره‌گر، لمسی یا تبلت طراحی باشد.\& .PP نویسه عمومی \fI*\fR می‌تواند برای نگاشت دستگاه ورودی به کل چیدمان دسکتاپ استفاده شود.\& .PP .RE \fBinput\fR map_to_region .RS 4 ورودی‌های این دستگاه را به ناحیه مشخص‌شده از چیدمان سراسری خروجی نگاشت می‌کند.\& تنها در صورتی معنادار است که دستگاه یک اشاره‌گر، لمسی یا تبلت طراحی باشد.\& .PP .RE \fBinput\fR map_from_region .RS 4 ورودی‌های این دستگاه را که خارج از ناحیه مشخص‌شده رخ می‌دهند نادیده می‌گیرد.\& می‌تواند بر حسب میلی‌متر (مانند 10x20mm 20x40mm) یا کسری از کل فضای موجود بین 0 تا 1 (مانند 0.\&5x0.\&5 0.\&7x0.\&7) باشد.\& همه دستگاه‌ها از میلی‌متر پشتیبانی نمی‌کنند.\& تنها زمانی معنادار است که دستگاه صفحه‌کلید نباشد و رویدادها را بر حسب مقادیر مطلق ارائه دهد (مانند تبلت طراحی یا صفحه لمسی - اکثر اشاره‌گرها رویدادها را نسبت به فریم قبلی ارائه می‌دهند).\& .PP معمولاً برای حفظ نسبت تصویر (aspect ratio) دستگاه ورودی و صفحه نمایش استفاده می‌شود.\& برش دادن یک ناحیه ورودی با نسبت ۱۶:۱۰ برای مطابقت با صفحه نمایش ۱۶:۹ می‌تواند از 0x0 1x0.\&9 به عنوان آرگومان استفاده کند.\& .PP .RE .SS "پیکربندی LIBINPUT (LIBINPUT CONFIGURATION)" .PP \fBinput\fR accel_profile adaptive|flat .RS 4 نمایه شتاب اشاره‌گر را برای دستگاه ورودی مشخص‌شده تنظیم می‌کند.\& .PP .RE \fBinput\fR calibration_matrix <6 space-separated floating point values> .RS 4 ماتریس کالیبراسیون را تنظیم می‌کند.\& .PP .RE \fBinput\fR click_method none|button_areas|clickfinger .RS 4 روش کلیک را برای دستگاه مشخص‌شده تغییر می‌دهد.\& .PP .RE \fBinput\fR clickfinger_button_map lrm|lmr .RS 4 مشخص می‌کند کدام نگاشت کلید برای clickfinger استفاده شود.\& گزینه \fIlrm\fR یک انگشت را کلیک چپ، ۲ انگشت را کلیک راست و ۳ انگشت را کلیک وسط در نظر می‌گیرد.\& گزینه \fIlmr\fR یک انگشت را کلیک چپ، ۲ انگشت را کلیک وسط و ۳ انگشت را کلیک راست در نظر می‌گیرد.\& .PP .RE \fBinput\fR drag enabled|disabled .RS 4 قابلیت ضربه و کشیدن (tap-and-drag) را برای دستگاه ورودی مشخص‌شده فعال یا غیرفعال می‌کند.\& .PP .RE \fBinput\fR drag_lock enabled|disabled|enabled_sticky .RS 4 قفل کشیدن (drag lock) را برای دستگاه ورودی مشخص‌شده فعال یا غیرفعال می‌کند.\& مقدار پیش‌فرض \fIdisabled\fR است.\& .PP .RE \fBinput\fR dwt enabled|disabled .RS 4 قابلیت غیرفعال‌سازی هنگام تایپ (disable-while-typing) را برای دستگاه ورودی مشخص‌شده فعال یا غیرفعال می‌کند.\& .PP .RE \fBinput\fR dwtp enabled|disabled .RS 4 قابلیت غیرفعال‌سازی هنگام استفاده از ترک‌پوینت (disable-while-trackpointing) را برای دستگاه ورودی مشخص‌شده فعال یا غیرفعال می‌کند.\& .PP .RE \fBinput\fR events enabled|disabled|disabled_on_external_mouse|toggle [] .RS 4 ارسال رویدادها (send_events) را برای دستگاه ورودی مشخص‌شده فعال یا غیرفعال می‌کند.\& غیرفعال کردن send_events کل دستگاه ورودی را غیرفعال می‌سازد.\& .PP گزینه \fItoggle\fR در فایل تنظیمات قابل استفاده نیست.\& اگر هیچ حالتی برای تغییر ذکر نشود، تمام حالت‌های پشتیبانی‌شده به این ترتیب پیمایش می‌شوند: enabled، disabled_on_external_mouse، disabled، (برگشت به ابتدا).\& اگر حالت‌ها مشخص شوند، بین آن‌ها جابه‌جا خواهد شد و در صورت عدم تطابق با حالت فعلی به اولین مورد پرش می‌کند.\& همچنین پشتیبانی دستگاه از آن‌ها بررسی نخواهد شد و ممکن است با خطا مواجه شود.\& .PP .RE \fBinput\fR left_handed enabled|disabled .RS 4 حالت چپ‌دست را برای دستگاه ورودی مشخص‌شده فعال یا غیرفعال می‌کند.\& .PP .RE \fBinput\fR middle_emulation enabled|disabled .RS 4 شبیه‌سازی کلیک وسط را فعال یا غیرفعال می‌کند.\& .PP .RE \fBinput\fR natural_scroll enabled|disabled .RS 4 پیمایش طبیعی یا معکوس (natural scrolling) را برای دستگاه ورودی مشخص‌شده فعال یا غیرفعال می‌کند.\& .PP .RE \fBinput\fR pointer_accel [<-1|1>] .RS 4 میزان شتاب اشاره‌گر را برای دستگاه ورودی مشخص‌شده تغییر می‌دهد.\& .PP .RE \fBinput\fR rotation_angle .RS 4 زاویه چرخش دستگاه را بر حسب درجه ساعت‌گرد تنظیم می‌کند.\& زاویه باید بین 0.\&0 (شامل خود آن) و 360.\&0 (بدون خود آن) باشد.\& .PP .RE \fBinput\fR scroll_button disable|button[1-3,8,9]| .RS 4 کلید مورد استفاده برای scroll_method on_button_down را مشخص می‌کند.\& کلید می‌تواند به صورت نام یا کد رویداد (قابل دریافت از \fBlibinput debug-events\fR) یا کلید ماوس x11 (button[1-3,8,9]) داده شود.\& اگر روی \fIdisable\fR تنظیم شود، روش پیمایش on_button_down غیرفعال می‌شود.\& .PP .RE \fBinput\fR scroll_button_lock enabled|disabled .RS 4 قفل کلید پیمایش را برای دستگاه ورودی مشخص‌شده فعال یا غیرفعال می‌کند.\& .PP .RE \fBinput\fR scroll_factor .RS 4 ضریب پیمایش را برای دستگاه ورودی مشخص‌شده تغییر می‌دهد.\& سرعت پیمایش با مقدار داده‌شده (که باید نامنفی باشد) مقیاس‌بندی می‌شود.\& .PP .RE \fBinput\fR scroll_method none|two_finger|edge|on_button_down .RS 4 روش پیمایش را برای دستگاه ورودی مشخص‌شده تغییر می‌دهد.\& .PP .RE \fBinput\fR tap enabled|disabled .RS 4 ضربه برای کلیک (tap) را برای دستگاه ورودی مشخص‌شده فعال یا غیرفعال می‌کند.\& .PP .RE \fBinput\fR tap_button_map lrm|lmr .RS 4 مشخص می‌کند کدام نگاشت کلید برای ضربه زدن استفاده شود.\& گزینه \fIlrm\fR یک انگشت را کلیک چپ، ۲ انگشت را کلیک راست و ۳ انگشت را کلیک وسط در نظر می‌گیرد.\& گزینه \fIlmr\fR یک انگشت را کلیک چپ، ۲ انگشت را کلیک وسط و ۳ انگشت را کلیک راست در نظر می‌گیرد.\& .PP .RE .SS "پیکربندی نشیمن‌گاه (SEAT CONFIGURATION)" .PP گزینه‌های حالت چندکاربره/چندنرم‌افزاری (multiseat) را پیکربندی می‌کند.\& .PP یک \fBseat\fR مجموعه‌ای از دستگاه‌های ورودی است که مستقل از یکدیگر عمل می‌کنند.\& نشیمن‌گاه‌ها با نام شناسایی می‌شوند و اگر نشیمن‌گاهی پیکربندی نشده باشد، نشیمن‌گاه پیش‌فرض \fIseat0\fR است.\& در حین اجرای sway، خط تیره (\fI-\fR) می‌تواند به عنوان نام مستعار برای نشیمن‌گاه فعلی استفاده شود.\& هر نشیمن‌گاه تمرکز صفحه‌کلید مستقل و یک مکان‌نمای مجزا دارد که توسط دستگاه‌های اشاره‌گر آن نشیمن‌گاه کنترل می‌شود.\& این برای استفاده چندین نفر به طور همزمان از دسکتاپ با دستگاه‌های اختصاصی خود کاربرد دارد.\& نویسه عمومی \fI*\fR همچنین می‌تواند به جای \fI\fR برای تغییر تنظیمات همه نشیمن‌گاه‌ها استفاده شود.\& .PP نکته: اگر به نظر می‌رسد تنظیمات اعمال نمی‌شوند، می‌توانید از \fI*\fR به جای \fI\fR استفاده کنید.\& اگر کار کرد، شناسه‌های مختلف حاصل از \fBswaymsg -t get_seats\fR را امتحان کنید تا نشیمن‌گاه صحیح را بیابید.\& .PP \fBseat\fR attach .RS 4 یک دستگاه ورودی را با شناسه آن به این نشیمن‌گاه متصل می‌کند.\& مقدار ویژه "*" تمامی دستگاه‌ها را به نشیمن‌گاه متصل خواهد کرد.\& .PP .RE \fBseat\fR cursor move|set .RS 4 مکان‌نمای نشیمن‌گاه مشخص‌شده را نسبت به موقعیت فعلی حرکت می‌دهد (move) یا روی مختصات مطلق تنظیم می‌کند (set).\& مشخص کردن مقدار 0 برای هر کدام، آن مختصات را به‌روزرسانی نمی‌کند.\& .PP منسوخ‌شده: به جای آن از پروتکل virtual-pointer در Wayland استفاده کنید.\& .PP .RE \fBseat\fR cursor press|release button[1-9]| .RS 4 فشردن (یا رها کردن) کلید ماوس مشخص‌شده را روی نشیمن‌گاه شبیه‌سازی می‌کند.\& کلید می‌تواند نام یا کد رویداد (از \fBlibinput debug-events\fR) یا کلید ماوس x11 (button[1-9]) باشد.\& در صورت استفاده از button[4-7] که به محورها نگاشت شده‌اند، یک رویداد محور شبیه‌سازی می‌شود، اما \fIpress\fR و \fIrelease\fR نادیده گرفته شده و هر دو اتفاق می‌افتند.\& .PP منسوخ‌شده: به جای آن از پروتکل virtual-pointer در Wayland استفاده کنید.\& .PP .RE \fBseat\fR fallback true|false .RS 4 این نشیمن‌گاه را به عنوان نشیمن‌گاه پشتیبان (fallback) تنظیم می‌کند.\& نشیمن‌گاه پشتیبان هر دستگاهی را که صریحاً به نشیمن‌گاه دیگری متصل نشده باشد جذب می‌کند (شبیه به نشیمن‌گاه پیش‌فرض).\& .PP .RE \fBseat\fR hide_cursor |when-typing [enable|disable] .RS 4 تصویر مکان‌نما را پس از وقوع رویداد مشخص پنهان می‌کند.\& .PP اگر \fItimeout\fR مشخص شود، مکان‌نما پس از گذشت این زمان (به میلی‌ثانیه) بدون هیچ فعالیتی پنهان می‌شود.\& مقدار 0 (پیش‌فرض) پنهان‌سازی را غیرفعال می‌کند.\& حداقل زمان ۱۰۰ میلی‌ثانیه است و مقادیر کمتر از آن به ۱۰۰ افزایش می‌یابند.\& .PP اگر \fIwhen-typing\fR فعال باشد، هر زمان که کلیدی فشرده شود مکان‌نما پنهان خواهد شد.\& .PP توجه داشته باشید که این تنظیم می‌تواند در مدیریت ورودی بازی‌ها و برنامه‌هایی مانند Gimp و Blender که به ورودی همزمان ماوس و صفحه‌کلید وابسته‌اند، تداخل ایجاد کند.\& .PP .RE \fBseat\fR idle_inhibit .RS 4 منابع رویدادهای ورودی را که مانع از بیکار (idle) شدن نشیمن‌گاه می‌شوند، به صورت فهرستی از نام‌ها جداشده با فاصله تنظیم می‌کند.\& نام‌های معتبر عبارتند از "keyboard"، "pointer"، "touchpad"، "touch"، "tablet_pad"، "tablet_tool" و "switch".\& رفتار پیش‌فرض ممانعت از بیکاری با هر رویدادی است.\& .PP .RE \fBseat\fR keyboard_grouping none|smart .RS 4 نحوه گروه‌بندی صفحه‌کلیدها در نشیمن‌گاه را مشخص می‌کند.\& در حال حاضر دو گزینه وجود دارد:\& \fInone\fR تمام گروه‌بندی‌ها را غیرفعال کرده و به هر صفحه‌کلید وضعیت مستقل می‌دهد.\& \fIsmart\fR صفحه‌کلیدها را بر اساس نگاشت کلید و اطلاعات تکرار گروه‌بندی می‌کند.\& این حالت زمانی که صفحه‌کلید به عنوان چند دستگاه مجزا شناسایی می‌شود کاربرد دارد.\& در این حالت، چیدمان موثر بین صفحه‌کلیدهای گروه هماهنگ می‌شود.\& پیش‌فرض \fIsmart\fR است.\& برای بازگردانی رفتار نسخه‌های قدیمی‌تر sway از \fInone\fR استفاده کنید.\& .PP .RE \fBseat\fR pointer_constraint enable|disable|escape .RS 4 امکان به دام انداختن مکان‌نما توسط کلاینت‌ها را برای نشیمن‌گاه فعال یا غیرفعال می‌کند (به طور پیش‌فرض فعال است).\& این قابلیت در درجه اول برای بازی‌های ویدیویی کاربرد دارد.\& دستور "escape" می‌تواند در زمان اجرا برای فرار از دست کلاینت به دام‌اندازنده استفاده شود.\& .PP .RE \fBseat\fR shortcuts_inhibitor enable|disable|activate|deactivate|toggle .RS 4 توانایی کلاینت‌ها برای جلوگیری از عمل کردن کلیدهای میانبر نشیمن‌گاه را فعال یا غیرفعال می‌کند.\& این گزینه برای نرم‌افزارهای مجازی‌سازی و ریموت دسکتاپ مفید است.\& زیردستورهای \fIenable\fR و \fIdisable\fR مشخص می‌کنند که آیا مهارکننده‌ها به صورت خودکار پذیرفته شوند یا خیر که پیش‌فرض \fIenable\fR است.\& در صورت استفاده در زمان اجرا، \fIdisable\fR تمام مهارکننده‌های فعال فعلی را نیز غیرفعال می‌کند.\& زیردستورهای \fIactivate\fR، \fIdeactivate\fR و \fItoggle\fR فقط در زمان اجرا قابل استفاده‌اند و وضعیت مهارکننده را در پنجره دارای تمرکز فعلی تغییر می‌دهند.\& این می‌تواند همراه با نام مستعار نشیمن‌گاه فعلی (\fI-\fR) استفاده شود تا تنها پنجره دارای تمرکز در همان نشیمن‌گاه را تحت تاثیر قرار دهد.\& زیردستور \fIdeactivate\fR به ویژه در یک \fBbindsym\fR با \fI--inhibited\fR برای خروج از وضعیتی که میانبرها مهار شده‌اند و کلاینت پاسخگو نیست مفید است.\& لازم به ذکر است که حذف مهارکننده‌های غیرفعال‌شده کاملاً به عهده کلاینت است و ممکن است بعداً دوباره فعال شوند.\& هرگونه نشانه بصری از وجود مهارکننده نیز در حال حاضر به عهده کلاینت گذاشته شده است.\& .PP .RE \fBseat\fR xcursor_theme [] .RS 4 تم پیش‌فرض XCursor سیستم را بازنویسی می‌کند.\& تم نشیمن‌گاه پیش‌فرض (\fIseat0\fR) همچنین به عنوان تم پیش‌فرض مکان‌نما در XWayland استفاده می‌شود و از طریق متغیرهای محیطی \fIXCURSOR_THEME\fR و \fIXCURSOR_SIZE\fR صادر می‌گردد.\& .PP .RE .SH "همچنین ببینید (SEE ALSO)" .PP \fBsway\fR(5) \fBsway-output\fR(5) \fBxkeyboard-config\fR(7)