.TH IRXEVENT "1" "Last change: Aug 2015" "irxevent 0.10.2" "User Commands"
.SH "نام (NAME)"
.P
\fBirxevent\fR \- ارسال رویدادهای شبیه‌سازی‌شده صفحه کلید و ماوس X11 از طریق LIRC
.SH "خلاصه دستور (SYNOPSIS)"
.P
\fBirxevent\fR [\fIگزینه\fR]... [\fIفایل_پیکربندی\fR]
.SH "توضیحات (DESCRIPTION)"
.P
برنامه \fBirxevent\fR برای ارسال رویدادهای کلیک دکمه‌های ماوس و فشرده شدن کلیدهای صفحه‌کلید به برنامه‌های X از طریق کنترل از راه دور مبتنی بر LIRC به کار می‌رود. با این برنامه می‌توانید پخش‌کننده CD/MP3 مورد علاقه خود، برنامه گیرنده تلویزیون یا هر برنامه گرافیکی X دیگری را که به ورودی‌های ماوس یا صفحه‌کلید پاسخ می‌دهد، کنترل کنید. حتی در صورت تمایل می‌توانید در حالی که روی صندلی راحتی نشسته‌اید، کلیدهای ^X^S را به emacs ارسال کنید.
.P
برنامه \fBirxevent\fR مکملی برای
.BR irexec (1)
و
.BR irpty (1)
است.
.SH "گزینه‌ها (OPTIONS)"
.TP
\fB\-d\fR, \fB\-\-daemon\fR
انشعاب و اجرا در پس‌زمینه.
.TP
\fB\-h\fR, \fB\-\-help\fR
نمایش خلاصه نحوه استفاده از دستور.
.TP
\fB\-V\fR, \fB\-\-version\fR
نمایش نسخه برنامه.
.SH "فایل‌ها (FILES)"
.P
برنامه \fBirxevent\fR با همان فایل پیکربندی
.B irexec
و
.B irpty
کار می‌کند
.RI ( ~/.config/lircrc ).
برای دیدن یک نمونه کامل از فایل lircrc به
.I examples/lircrc
مراجعه کنید.
.P
بخشی از فایل
.I .lircrc
شما می‌تواند به این شکل باشد:

.nf
begin
        prog = irxevent
        button = VIDEO_UP
        config = Key SHIFT\-KP_Add CurrentWindow
end
begin
        prog = irxevent
        button = VIDEO_DOWN
        config = Key SHIFT\-KP_Subtract CurrentWindow
end
begin
        prog = irxevent
        button = STOP
        config = Key ctrl\-c CurrentWindow
end
begin
        prog = irxevent
        button = 0
        config = Key f xawtv
        config = Key f xawtv
end
begin
        prog = irxevent
        button = POWER
        config = Key q xawtv
end
begin
        prog = irxevent
        button = CH_DOWN
        config = Button 1 329 92 kscd
end
begin
        prog = irxevent
        button = UP
        config = Button 1 110 80 GQmpeg
end
begin
        prog = irxevent
        button = DOWN
        config = Button 1 130 80 GQmpeg
end
.fi

.P
به زبان ساده، خطوط \fIconfig\fR = ممکن است به این شکل باشند:

.nf
config = Key [shift\-][ctrl\-][alt\-]<key> [Focus] <windowname>
        | WindowID <id> | CurrentWindow | RootWindow
config = Button <button> <x> <y> [Focus] <windowname> | WindowID <id>
        | CurrentWindow | RootWindow
config = xy_Key <x> <y> [shift\-][ctrl\-][alt\-]<key> [Focus]
        <windowname> | WindowID id | CurrentWindow | RootWindow
.fi

.P
چند مثال دیگر:

.nf
config = Key Up xawtv
config = Key Down xawtv
config = Button 1 50 110 xclickme
config = Key q xawtv
config = Key ctrl\-c mpg123
config = Key shift\-Page_Up rxvt
.fi

.P
در نماد BNF این ساختار به صورت زیر است:

.RS 3
.nf
LINE    = "config =" <KEY|BUTTON|XYKEY> <TARGET> |
          "config =" <KEY|BUTTON|XYKEY> "Focus" <TARGET>
XYKEY   = "xy_Key" <x_position> <y_position> <MOD><KEYSPEC>
KEY     = "Key" <MOD><KEYSPEC>
MOD     = ["shift\-"]["numlock\-"]["ctrl\-"]["alt\-"]["meta\-"]
          ["numlock\-"]["mod3\-"]["mod4\-"]["mod5\-"]["altgr\-"]["scrlock\-"]
KEYSPEC = Keyname | "KeySym:"KeySym | "KeyCode:"KeyCode
BUTTON  = "Button" <1..5> <x_position> <y_position>
TARGET  = Windowname | "WindowID" id | "CurrentWindow" | "RootWindow"
.fi
.RE

.TP
.I Keyname:
نماد کلیدی است که در محیط X windows تعریف شده است. به عنوان مثال «Up» به کلید جهت‌نمای رو به بالا اشاره دارد. «KP_Add» علامت بعلاوه در صفحه کلید عددی است. در صورتی که در مورد نام یک نماد مطمئن نیستید، به فایل
.I irxevent.keys
(در پوشه اسناد) نگاهی بیندازید.
.TP
.I KeySym:
عددی است که توسط
.BR XStringToKeysym (3x)
برگردانده می‌شود.
.TP
.I KeyCode:
عددی است که توسط
.BR XKeysymToKeycode (3x)
برگردانده می‌شود.
.TP
.I Windowname:
می‌تواند کاراکترهای ابتدایی نام پنجره باشد که توسط مدیر پنجره نمایش داده می‌شود یا نامی باشد که زیر آیکون نمایش می‌یابد. برخی برنامه‌ها از نام نمایش داده شده توسط مدیر پنجره برای نمایش اطلاعات وضعیت زیادی استفاده می‌کنند اما نام آیکون را تغییر نمی‌دهند (مانند xawtv). برنامه‌های دیگر اطلاعاتی را به انتهای نام پنجره اضافه می‌کنند ("GQmpeg \- kill_windooz.mp3"). اگر نام پنجره و نام آیکون هیچ‌کدام با Windowname داده‌شده مطابقت نداشته باشند، اطلاعات
.BR XClassHint (3x)
بررسی خواهد شد.
.TP
.I CurrentWindow:
به پنجره فعال اشاره دارد، همان‌طور که توسط
.BR XGetInputFocus (3x)
برگردانده می‌شود. در بیشتر مواقع این پنجره‌ای است که نشانگر ماوس در آن قرار دارد.
.TP
.I RootWindow:
به پنجره ریشه
.RI ( root )
اشاره دارد، همان‌طور که توسط
.BR RootWindow (3x)
برگردانده می‌شود. ممکن است برای ارسال رویدادها به مدیر پنجره به این گزینه نیاز داشته باشید.
.TP
.I WindowID id:
به پنجره‌ای با شناسه پنجره
.I id
اشاره دارد.
.I id
باید یک عدد در مبنای ده باشد. این ویژگی زمانی مفید است که \fBirxevent\fR نتواند پنجره مورد نظر را از روش‌های دیگر پیدا کند.
.TP
.I Focus:
رویداد مشخص‌شده را تنها در صورتی به پنجره داده‌شده ارسال می‌کند که در آن لحظه فوکوس ورودی را در اختیار داشته باشد. البته ترکیب این مورد با
.I CurrentWindow
چندان منطقی نیست.
.SH "عیب‌یابی (TROUBLESHOOTING)"
.PP
اگر در پیدا کردن مختصات برای کلیک دکمه مشکل دارید، می‌توانید دستور
.B xev \-id <window_id>
را امتحان کنید. شناسه پنجره (window_id) را می‌توان با استفاده از
.B xwininfo
پیدا کرد.
.PP
برخی برنامه‌ها به طور پیش‌فرض هیچ رویداد شبیه‌سازی‌شده X را نمی‌پذیرند زیرا این رویدادها می‌توانند مشکلات امنیتی ایجاد کنند. در حال حاضر مشخص شده است که برنامه‌های
.B xterm
و
.B xemacs
رویدادهای شبیه‌سازی‌شده توسط \fBirxevent\fR را نادیده می‌گیرند.
.PP
با این وجود، می‌توانید با فعال کردن گزینه "Allow SendEvents" در منوی "Main Options" (نگه‌داشتن کلید Ctrl و فشردن کلیک چپ ماوس درون پنجره xterm)، برنامه
.B xterm
را وادار به پذیرش رویدادهای خارجی کنید. همچنین می‌توانید خط زیر را در فایل
.I .Xresources
خود قرار دهید تا این تغییر به صورت دائمی اعمال شود:
.RS 3
.nf
XTerm.vt100.allowSendEvents: true
.fi
.RE
.PP
روش دیگر اجرای
.B xterm
به صورت زیر است:
.RS 3
.nf
xterm \-xrm "XTerm.vt100.allowSendEvents: true"
.fi
.RE
.PP
برنامه
.B xemacs
در صورتی رویدادها را می‌پذیرد که یک متغیر داخلی را مقداردهی کنید. متن زیر از راهنمای آنلاین آن برگرفته شده است:
.RS 3
.nf
`x\-allow\-sendevents' is a built-in boolean variable.

Value: t

Documentation:

*Non-nil means to allow synthetic events.  Nil means they are ignored.

Beware: allowing emacs to process SendEvents opens a big security hole.
.fi
.RE
.PP
برای فعال‌سازی رویدادها باید این کد lisp را ارزیابی و اجرا کنید (کلید‌های Meta\-x را بفشارید و عبارت زیر را وارد کنید):
.RS 3
.nf
(setq x\-allow\-sendevents t)
.fi
.RE
.PP
قرار دادن این خط در فایل
.I .xemacs\-options
شما باید نتیجه یکسانی داشته باشد.
.PP
اگر در ارسال رویدادها مشکلی دارید، لطفاً از طریق ایمیل با نویسنده در میان بگذارید.
.SH "نویسنده (AUTHOR)"
.P
نوشته شده توسط Heinrich Langos <heinrich@mad.scientist.com>.
.SH "همچنین ببینید (SEE ALSO)"
.TP
.BR xdotool (1)
در صورتی که از
.BR irexec (1)
فراخوانی شود،
.B xdotool
جایگزین انعطاف‌پذیرتری برای
.B irxevent
فراهم می‌کند.
.P
مستندات
.B lirc
به صورت صفحات html نگهداری می‌شود. این مستندات در مسیر html/ در پوشه مستندات قرار دارند.