نام (NAME)

mev - برنامه‌ای برای گزارش رویدادهای ماوس

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

mev [ گزینه‌ها ]

توضیحات (DESCRIPTION)

برنامه mev بخشی از بسته gpm است. اطلاعات زیر از پرونده texinfo، که منبع مرجع اطلاعات است، استخراج شده است.

برنامه mev از روی xev الگوبرداری شده است. این برنامه رویدادهای کنسول ماوس را که دریافت می‌کند در خروجی استاندارد (stdout) چاپ می‌نماید.

رفتار پیش‌فرض mev دریافت تمام رویدادها است، اما می‌توان از سوییچ‌های خط فرمان برای تنظیم فیلدهای مختلف در ساختار Gpm_Connect به‌منظور سفارشی‌سازی رفتار برنامه استفاده کرد. من از mev برای مدیریت رویدادهای ماوس در Emacs استفاده می‌کنم.

سوییچ‌های خط فرمان برای mev به شرح زیر هستند:

-C number

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

-d number

یک ماسک پیش‌فرض انتخاب می‌کند. به‌طور پیش‌فرض سرور هر رویدادی را که متعلق به ماسک رویداد نباشد دریافت می‌کند. ماسک می‌تواند به صورت یک عدد ده‌دهی یا به عنوان یک رشته نمادین ارائه شود.

-e number

ماسک رویداد را انتخاب می‌کند. به‌طور پیش‌فرض هر رویدادی دریافت می‌شود. ماسک می‌تواند به صورت یک عدد ده‌دهی یا به عنوان یک رشته نمادین ارائه شود.

-E

ورود به حالت emacs. در حالت emacs، رویدادها به جای اعداد به صورت فرم‌های lisp گزارش می‌شوند. این همان قالبی است که توسط بسته t-mouse در emacs استفاده می‌شود.

-f

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

-i

حالت تعاملی. ورودی را از stdin برای تغییر پارامترهای اتصال می‌پذیرد.

-m number

حداقل ماسک کلید تبدیل (modifier) را انتخاب می‌کند. هر رویدادی با کلیدهای تبدیل کمتر به mev گزارش نخواهد شد. مقدار پیش‌فرض آن 0 است. ماسک باید یا به صورت یک عدد ده‌دهی یا به عنوان یک رشته نمادین ارائه شود.

-M number

حداکثر ماسک کلید تبدیل (modifier) را انتخاب می‌کند. هر رویدادی با کلیدهای تبدیل بیشتر از مقدار مشخص‌شده به mev گزارش نخواهد شد. مقدار پیش‌فرض آن  ~0 است، یعنی تمام رویدادها دریافت می‌شوند. ماسک باید یا به صورت یک عدد ده‌دهی یا به عنوان یک رشته نمادین ارائه شود.

-p

درخواست ترسیم نشانگر ماوس در طول کشیدن (drag). این گزینه توسط emacs برای جلوگیری از فراخوانی ()ioctl از کدهای lisp استفاده می‌شود.

هنگامی که آرگومان‌ها اعداد صحیح ده‌دهی نباشند، به عنوان فهرستی از نویسه‌های حرفی-عددی در نظر گرفته می‌شوند که با یک نویسه غیرحرفی-عددی از یکدیگر جدا شده‌اند. من از کاما (,) استفاده می‌کنم، اما هر نویسه دیگری نیز مجاز است.

نام‌های مجاز برای رویدادها عبارتند از: move، drag، down یا press، up یا release، motion (که شامل هر دو رویداد move و drag است) و hard.

نام‌های مجاز برای کلیدهای تبدیل (modifiers) عبارتند از: shift، leftAlt، rightAlt، anyAlt (یکی یا دیگری) و control.

هنگامی که سوییچ -i مشخص شود، mev به جای رویدادها، به ورودی استاندارد خود به عنوان خطوط فرمان نگاه می‌کند. خطوط ورودی تجزیه می‌شوند و دستورهای push و pop شناسایی می‌گردند.

سپس دستور push گزینه‌های -d، -e، -m و -M را با همان معانی توصیف‌شده در بالا می‌پذیرد. گزینه‌های مشخص‌نشده مقدار قبلی خود را حفظ می‌کنند و ماسک‌های حاصل برای بازگشایی مجدد اتصال با سرور استفاده می‌شوند. از pop برای خارج کردن از پشته اتصال استفاده می‌شود. اگر روی یک پشته خالی عمل pop انجام شود، برنامه خارج می‌شود.

سایر دستورهای شناسایی‌شده عبارتند از: info که برای بازگرداندن عمق پشته استفاده می‌شود؛ quit برای خاتمه پیش از موعد برنامه؛ و snapshot برای دریافت برخی از اطلاعات پیکربندی از سرور.

اشکالات (BUGS)

از نسخه 1.16 به بعد، mev دیگر تحت xterm کار نمی‌کند. لطفاً از برنامه rmev (ارائه‌شده در پوشه sample) برای مشاهده رویدادهای gpm در xterm یا rxvt استفاده کنید. برنامه rmev علاوه بر رویدادهای ماوس، رویدادهای صفحه‌کلید را نیز نمایش می‌دهد.

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

Alessandro Rubini <rubini@linux.it>
Ian Zimmerman <itz@speakeasy.org>

فایل‌ها (FILES)

/dev/gpmctl سوکت مورد استفاده برای اتصال به gpm.

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

 gpm(8)       سرور ماوس
 gpm-root(1)  گرداننده‌ای برای رویدادهای Control-Mouse.

پرونده info درباره `gpm` که اطلاعات کامل‌تری ارائه می‌دهد و نحوه نوشتن یک کلاینت gpm را توضیح می‌دهد.