.\" Generated by scdoc 1.11.3
.\" 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 "YDOTOOL" "1" "2024-07-14"
.SH "نام (NAME)"
.PP
ydotool \- ابزار خط فرمان خودکارسازی \fI/dev/uinput\fR
.PP
.SH "خلاصه دستور (SYNOPSIS)"
.PP
\fBydotool\fR \fBcmd\fR \fIargs\fR
.PP
\fBydotool\fR \fBcmd\fR --help
.PP
.SH "توضیحات (DESCRIPTION)"
.PP
\fBydotool\fR به شما اجازه می‌دهد ورودی صفحه‌کلید و فعالیت‌های موشواره و غیره را به‌صورت برنامه‌ریزی‌شده (یا دستی) شبیه‌سازی کنید.\&
دیمن \fBydotoold\fR(8) باید در حال اجرا باشد.\&
.PP
.PP
دستور(های) پیاده‌سازی‌شده در حال حاضر:
.PP
\fBtype\fR
.RS 4
تایپ یک رشته
.RE
\fBkey\fR
.RS 4
فشردن کلیدها
.RE
\fBmousemove\fR
.RS 4
انتقال نشانگر موشواره به موقعیت مطلق
.RE
\fBclick\fR
.RS 4
کلیک روی دکمه‌های موشواره
.PP
.RE
.SH "دستورهای صفحه‌کلید (KEYBOARD COMMANDS)"
\fBkey\fR [\fB-d\fR,\fB--key-delay\fR \fI<ms>\fR] [\fI<KEYCODE:PRESSED>\fR .\&.\&.\&]
.PP
.RS 4
تایپ یک کد کلید (keycode) مشخص.\&
.PP
به‌عنوان مثال، 28:1 28:0 به معنای فشردن کلید Enter روی یک صفحه‌کلید استاندارد US است.\&
(که در آن 1: برای فشرده شدن کلید به پایین و سپس 0: به معنای رها شدن کلید است)
.PP
42:1 38:1 38:0 24:1 24:0 38:1 38:0 42:0 - "LOL"
.PP
مقدارهای غیرقابل تفسیر، مانند 0، aaa و l0l، تنها باعث ایجاد تأخیر خواهند شد.\&
.PP
برای مشاهده کدهای کلید موجود (KEY_*)، به فایل \(lq/usr/include/linux/input-event-codes.\&h\(rq مراجعه کنید.\&
.PP
می‌توانید نام و شماره کلیدی را که صفحه‌کلید شما به libinput ارسال می‌کند، با اجرای دستور \(lqsudo libinput record\(rq و سپس انتخاب صفحه‌کلید خود از فهرست بیابید؛ این کار نام و شماره مناسب در libinput را برای هر کلیدی که فشار می‌دهید نشان خواهد داد.\&
.PP
گزینه‌ها:
\fB-d\fR,\fB--key-delay\fR \fI<ms>\fR
.RS 4
زمان تأخیر میان فشردن کلیدها.\& پیش‌فرض 12ms.\&
.PP
.RE
.RE
\fBtype\fR [\fB-D\fR,\fB--next-delay\fR \fI<ms>\fR] [\fB-d\fR,\fB--key-delay\fR \fI<ms>\fR] [\fB-f\fR,\fB--file\fR \fI<filepath>\fR] "\fItext\fR"
.PP
.RS 4
متن را طوری تایپ می‌کند که گویی خودتان آن را روی صفحه‌کلید تایپ کرده‌اید.\&
.PP
گزینه‌ها:
.PP
\fB-d\fR,\fB--key-delay\fR \fI<ms>\fR
.RS 4
زمان تأخیر میان رویدادهای کلید (هر کدام از بالا/پایین رفتن‌ها).\& پیش‌فرض 12ms.\&
.PP
.RE
\fB-D\fR,\fB--next-delay\fR \fI<ms>\fR
.RS 4
تأخیر میان رشته‌ها.\& پیش‌فرض 0ms.\&
.PP
.RE
\fB-f\fR,\fB--file\fR \fI<filepath>\fR
.RS 4
مشخص کردن فایلی که محتویات آن طوری تایپ می‌شود که گویی به‌عنوان یک آرگومان فرستاده شده است.\& مسیر فایل می‌تواند برای خواندن از stdin برابر \(aq\-\(aq باشد.\&
.PP
.RE
مثال: برای تایپ \(aqHello world!\(aq این کار را انجام دهید:
.RS 4
ydotool type \(aqHello world!\(aq
.PP
.RE
.RE
.SH "دستورهای موشواره (MOUSE COMMANDS)"
.PP
\fBmousemove\fR [\fB-a\fR,\fB--absolute\fR] \fI<x> <y>\fR
.RS 4
انتقال موشواره به مختصات نسبی X و Y روی صفحه نمایش.\&
.PP
گزینه‌ها:
\fB--absolute\fR
.RS 4
استفاده از موقعیت مطلق
.PP
.RE
مثال: برای انتقال مکان‌نما به مختصات مطلق (100,100):
.RS 4
ydotool mousemove --absolute 100 100
.PP
.RE
.RE
\fBclick\fR [\fB-d\fR,\fB--next-delay\fR \fI<ms>\fR] [\fB-r\fR,\fB--repeat\fR \fIN\fR ] [\fIbutton\fR .\&.\&.\&]
.RS 4
ارسال یک کلیک.\&
.PP
گزینه‌ها:
\fB-d\fR,\fB--next-delay\fR \fI<ms>\fR
.RS 4
تأخیر میان رویدادهای ورودی (پایین/بالا، یک کلیک کامل به معنای دو برابر شدن زمان است).\& پیش‌فرض 25ms.\&
.PP
.RE
\fB-r\fR,\fB--repeat\fR \fIN\fR
.RS 4
تکرار کل توالی به تعداد N بار
.PP
.RE
تمام دکمه‌های موشواره با استفاده از مقادیر عددی شانزده‌شانزدهی (هگزادسیمال) نشان داده می‌شوند، همراه با یک ماسک بیتی اختیاری برای مشخص کردن اینکه آیا بالا/پایین رفتن موشواره باید نادیده گرفته شود یا خیر.\&
.PP
.PD 0
.IP \(bu 4
0x00 - LEFT
.IP \(bu 4
0x01 - RIGHT
.IP \(bu 4
0x02 - MIDDLE
.IP \(bu 4
0x03 - SIDE
.IP \(bu 4
0x04 - EXTR
.IP \(bu 4
0x05 - FORWARD
.IP \(bu 4
0x06 - BACK
.IP \(bu 4
0x07 - TASK
.IP \(bu 4
0x40 - Mouse down
.IP \(bu 4
0x80 - Mouse up
.RE
  
.RS 4
.PD
.RE
مثال‌ها:
.PP
.RS 4
.PD 0
.IP \(bu 4
0x00: دکمه چپ را انتخاب می‌کند، اما کاری انجام نمی‌دهد (می‌توانید از این برای ایجاد وقفه‌های اضافی استفاده کنید)
.IP \(bu 4
0xC0: کلیک دکمه چپ (پایین رفتن و سپس بالا آمدن)
.IP \(bu 4
0x41: فشردن دکمه راست به پایین (right button down)
.IP \(bu 4
0x82: رها کردن دکمه وسط به بالا (middle button up)
.PD
.PP
در صورت تمایل می‌توانید از پیشوند \(aq0x\(aq صرف‌نظر کنید.\&
.PP
.RE
.SH "سوکت YDOTOOL (YDOTOOL SOCKET)"
.PP
سوکتی که برای نوشتن در \fBydotoold\fR(8) استفاده می‌شود را می‌توان از طریق متغیر محیطی YDOTOOL_SOCKET تغییر داد.\&
.PP
.SH "نویسندگان (AUTHORS)"
.PP
ابزار ydotool توسط ReimuNotMoe نوشته شده است.\&
.PP
این صفحهٔ راهنما توسط bob.\&hepple@gmail.\&com نوشته شده و پس از آن به‌روزرسانی شده است.\&
.PP
.SH "مجوز (LICENCE)"
AGPLv3
.PP
.SH "همچنین ببینید (SEE ALSO)"
.PP
\fBydotoold\fR(8)
.PP
تارنمای پروژه: <https://github.\&com/ReimuNotMoe/ydotool>