.Dd July 26, 2014
.Dt DGENRC 5
.Os
.Sh "نام (NAME)"
.Nm dgenrc
.Nd فایل پیکربندی شبیه‌ساز DGen/SDL برای سگا جنسیس/مگادرایو
.Sh "خلاصه دستور (SYNOPSIS)"
$HOME/.dgen/dgenrc
.Sh "توضیحات (DESCRIPTION)"
فایل
.Pa $HOME/.dgen/dgenrc
هنگام راه‌اندازی شبیه‌ساز توسط
.Xr dgen 1
تجزیه و پردازش می‌شود. این فایل برای تنظیم کلیدهای کنترلر و همچنین سایر ویژگی‌های شبیه‌سازی استفاده می‌شود. محتویات این فایل را می‌توان با محتویات فایل دیگری با قالب مشابه، از طریق سوییچ خط فرمان
.Fl r
جایگزین (override) کرد.
.Sh "قالب فایل (FILE FORMAT)"
هر فایل rc از تعداد نامحدودی خط تشکیل شده است که هر کدام دارای قالب
\(aqfieldname = value\(aq
هستند. همچنین در صورتی که یک خط با نویسه هش (#) آغاز شود، یک توضیح (کامنت) محسوب می‌شود.
.Pp
در ابتدای هر
.Ar fieldname
پیشوندی قرار دارد که نوع آن فیلد را مشخص می‌کند:
.Bl -tag -width bool_*
.It Ar key_*
یک مقدار کلید. می‌تواند روی یکی از شناسه‌های کلید ذکرشده در بخش
.Sx "شناسه‌های کلید (KEY IDENTIFIERS)"
در زیر تنظیم شود.
.It Ar joy_*
یک مقدار جوی‌استیک/دسته بازی. می‌تواند روی یکی از شناسه‌های جوی‌استیک ذکرشده در بخش
.Sx "شناسه‌های جوی‌استیک (JOYSTICK IDENTIFIERS)"
در زیر تنظیم شود.
.It Ar mou_*
یک کنش ماوس. می‌تواند روی یکی از شناسه‌های ماوس ذکرشده در بخش
.Sx "شناسه‌های ماوس (MOUSE IDENTIFIERS)"
در زیر تنظیم شود.
.It Ar bool_*
یک مقدار بولی. مقادیر «false»، «no» و «0» به عنوان نادرست، و مقادیر «true»، «yes» و هر عددی به جز 0 به عنوان درست در نظر گرفته می‌شوند.
.It Ar int_*
یک مقدار عدد صحیح، بزرگ‌تر یا مساوی با 0.
.It Ar str_*
یک مقدار رشته‌ای، می‌تواند خالی باشد.
.El
.Pp
برخی فیلدها مجموعه‌مقادیر خاصی می‌پذیرند که در بخش‌های مربوطه به آن‌ها پرداخته شده است. هیچ‌یک از نام‌ها یا مقادیر فیلدها به حروف بزرگ و کوچک حساس نیستند.
.Pp
فیلدها ذیل چند گروه اصلی قرار می‌گیرند. این فیلدها در زیر به همراه مقادیر پیش‌فرض آن‌ها در قلاب ([]) فهرست شده‌اند:
.Pp
تمام آن‌ها را می‌توان به صورت تعاملی از اعلان خط فرمان (prompt) تغییر داد، همان‌طور که در
.Xr dgen 1
توضیح داده شده است.
.Sh "کنترلرها (CONTROLLERS)"
.Bl -tag -width xxxx
.It key_pad1_up [up]
.It key_pad1_down [down]
.It key_pad1_left [left]
.It key_pad1_right [right]
.It key_pad1_a [a]
.It key_pad1_b [s]
.It key_pad1_c [d]
.It key_pad1_x [q]
.It key_pad1_y [w]
.It key_pad1_z [e]
.It key_pad1_mode [backspace]
.It key_pad1_start [return]
نگاشت کلیدها به اولین کنترلر جنسیس. هر یک از این فیلدها دارای یک فیلد متناظر «key_pad2» برای نگاشت به کنترلر دوم است.
.It joy_pad1_up [joystick0-axis1-min]
.It joy_pad1_down [joystick0-axis1-max]
.It joy_pad1_left [joystick0-axis0-min]
.It joy_pad1_right [joystick0-axis0-max]
.It joy_pad1_a [joystick0-button0]
.It joy_pad1_b [joystick0-button3]
.It joy_pad1_c [joystick0-button1]
.It joy_pad1_x [joystick0-button6]
.It joy_pad1_y [joystick0-button4]
.It joy_pad1_z [joystick0-button5]
.It joy_pad1_mode [joystick0-button9]
.It joy_pad1_start [joystick0-button8]
نگاشت دکمه‌های جوی‌استیک/دسته بازی به اولین کنترلر جنسیس. هر یک از این فیلدها دارای یک فیلد متناظر «joy_pad2» برای نگاشت به کنترلر دوم است.
.It bool_joystick [true]
استفاده از جوی‌استیک‌ها برای شبیه‌سازی کنترلرها. توجه داشته باشید که در صورت تنظیم این مقدار، کلیدهای صفحه‌کلید همچنان کار خواهند کرد. این فیلد تنها در صورتی در دسترس است که پشتیبانی از جوی‌استیک را فعال کرده باشید.
.It int_mouse_delay [50]
تعداد میلی‌ثانیه‌های انتظار پس از آخرین رویداد حرکت ماوس جهت رها کردن دکمه‌های مقیدشده به چنین رویدادهایی.
.El
.Sh "کلیدهای تعریف‌شده توسط کاربر (USER-DEFINED BINDINGS)"
.Bl -tag -width xxxx
.It bind_{keysym} Ar action
.It bind_{joypad} Ar action
.It bind_{mouse} Ar action
یک مقیدسازی جدید برای صفحه‌کلید، جوی‌استیک/دسته بازی یا ماوس به یک کنش دلخواه تعریف می‌کند. این متغیرها از قالب
.Ar keysym
همان‌طور که در
.Sx "شناسه‌های کلید (KEY IDENTIFIERS)" ,
قالب
.Ar joypad
همان‌طور که در
.Sx "شناسه‌های جوی‌استیک (JOYSTICK IDENTIFIERS)" ,
یا قالب
.Ar mouse
همان‌طور که در
.Sx "شناسه‌های ماوس (MOUSE IDENTIFIERS)"
تعریف شده است، استفاده می‌کنند. هنگامی که
.Ar action
دارای پیشوند «key_»، «joy_» یا «mou_» باشد، به یک نام مستعار برای متغیر متناظر در
.Sx "کنترلرها (CONTROLLERS)"
تبدیل می‌شود. در غیر این صورت، به گونه‌ای تفسیر می‌شود که گویی در اعلان (prompt) وارد شده است، و می‌توان از آن برای تغییر متغیرها یا اجرای دستورات استفاده کرد (برای اطلاعات بیشتر به
.Xr dgenrc 5
مراجعه کنید).
به طور پیش‌فرض هیچ اتصالی تعریف نشده است.
.It bind_"{keysym|joypad|mouse} [{keysym|joypad|mouse} [...]]" Ar action
نحو جایگزینی که از ترکیب چند شناسه برای انجام
.Ar action
پشتیبانی می‌کند. انواع کنترلرها را می‌توان با هم ترکیب کرد. شناسه‌ها با فاصله از یکدیگر جدا می‌شوند. برای جلوگیری از خطاهای نحوی، فاصله‌ها باید به درستی نقل‌قول یا اسکیپ شوند.
.El
.Sh "صدا (AUDIO)"
.Bl -tag -width xxxx
.It bool_sound [true]
فعال‌سازی زیرسیستم صدا.
.It int_soundrate [44100]
فرکانس پخش صدا، بر حسب هرتز (Hz).
.It int_soundsegs [8]
تعداد بخش‌های صوتی مورد استفاده برای بافر کردن صدا. مقادیر کمتر تاخیر پایینی را تضمین می‌کنند. این مقدار را تنها در صورتی افزایش دهید که صدا بریده‌بریده شود.
.It int_soundsamples [0]
اندازه بافر صوتی سیستم، بر حسب نمونه (نمونه‌ها واحد صدا هستند و نرخ صدا مشخص می‌کند که چه تعداد از آن‌ها در هر ثانیه پخش می‌شوند). تعیین مقدار 0 به طور خودکار امن‌ترین مقدار را انتخاب می‌کند. اگر با مشکلات صوتی روبرو هستید که int_soundsegs قادر به حل آن‌ها نیست، مقدار این گزینه را تغییر دهید. افزایش آن باعث تاخیر صوتی محسوسی خواهد شد (متاسفانه این کار اغلب در سیستم‌های کندتر مورد نیاز است).
.It int_volume [100]
سطح بلندی صدا، بر حسب درصد. مقادیر بالاتر از 100 باعث اعوجاج صدا می‌شوند.
.It key_volume_inc [=]
.It key_volume_dec [-]
.It joy_volume_inc []
.It joy_volume_dec []
.It mou_volume_inc []
.It mou_volume_dec []
کلیدهای مقیدشده برای کنترل بلندی صدا.
.It bool_mjazz [false]
گزینه MJazz - ۲ تراشه FM بیشتر در مگادرایو قرار می‌دهد تا نوعی تقویت صدای ۲۲ کاناله ایجاد کند. می‌تواند صدای خوبی داشته باشد، اما سرعت اجرا را بسیار کاهش می‌دهد.
.El
.Sh "ویدیو (VIDEO)"
.Bl -tag -width xxxx
.It int_depth [0]
عمق رنگ (بیت بر پیکسل). مقادیر مجاز عبارتند از 0 (خودکار)، 8، 15، 16، 24 و 32. در حالت OpenGL نادیده گرفته می‌شود.
.It int_width [-1]
.It int_height [-1]
عرض و ارتفاع مد نظر برای پنجره.
.It bool_opengl [true]
استفاده از رندرکننده OpenGL، در صورت در دسترس بودن.
.It bool_opengl_stretch [true]
اجازه به OpenGL برای کشیدن تصویر صفحه (stretch).
.It bool_opengl_linear [true]
استفاده از فیلتر GL_LINEAR برای بافت‌ها به جای GL_NEAREST.
.It bool_opengl_32bit [true]
استفاده از بافت‌های ۳۲ بیتی. این بافت‌ها به حافظه بیشتری نیاز دارند اما معمولاً سریع‌تر از بافت‌های ۱۶ بیتی هستند.
.It bool_opengl_square [false]
استفاده از بافت‌های مربعی. مقدار زیادی حافظه هدر می‌دهد اما ممکن است خطاهای مقداردهی اولیه OpenGL را برطرف کند.
.It bool_fullscreen [false]
تلاش برای اجرا در حالت تمام‌صفحه، در صورت امکان.
.It int_scale [-1]
.It int_scale_x [-1]
.It int_scale_y [-1]
میزانی که تصویر رندرشده باید نسبت به تفکیک‌پذیری پیش‌فرض مقیاس‌بندی شود. فیلترهای مقیاس‌بندی را مشاهده کنید.
.It bool_aspect [true]
حفظ نسبت ابعاد تصویر اصلی هنگام تغییر اندازه پنجره.
.It key_fullscreen_toggle [alt-enter]
.It joy_fullscreen_toggle []
.It mou_fullscreen_toggle []
دکمه تغییر وضعیت حالت تمام‌صفحه (اگر SDL روی پلتفرم شما از تغییر حالت تمام‌صفحه پشتیبانی نکند، ممکن است این گزینه هیچ کاری انجام ندهد).
.It int_info_height [-1]
ارتفاع ناحیه متنی در پایین صفحه، بر حسب پیکسل. این مقدار اندازه قلم را نیز تحت تاثیر قرار می‌دهد. مقادیر کوچک‌تر از حداقل اندازه قلم، باعث می‌شوند DGen متن را به stdout هدایت کند. مقدار پیش‌فرض 1- باعث می‌شود DGen ارتفاع مناسب را انتخاب کند.
.It bool_fps [false]
نمایش تعداد فریم‌های جاری در هر ثانیه.
.It bool_buttons [false]
نمایش دکمه‌های فشرده‌شده. می‌تواند برای کمک به پیکربندی آن‌ها استفاده شود.
.It bool_swab [false]
جابه‌جایی بایت‌ها در خروجی ویدیو. گاهی زمانی که خروجی ویدیو روی سیستم دیگری قرار دارد مفید است. این گزینه به عنوان یک فیلتر CTV پیاده‌سازی شده و برای کارکرد باید به صورت کامپایل‌شده در برنامه وجود داشته باشد.
.It bool_doublebuffer [true]
تغییر وضعیت بافرینگ دوگانه (double buffering). فعال کردن آن باید از پارگی تصویر جلوگیری کند. غیرفعال کردن آن ممکن است تعداد فریم‌های نمایش‌داده‌شده در ثانیه را در برخی سیستم‌ها بهبود بخشد.
.It bool_screen_thread [false]
در صورت فعال بودن، یک ریسه (thread) جداگانه برای تخلیه بار نمایش فریم‌ها ایجاد می‌شود. این گزینه تنها در سیستم‌های کندتر که تعویض بافرهای ویدیویی زمان‌بر است مفید واقع می‌شود؛ به ویژه هنگامی که V-sync فعال است و این کار تا فریم بعدی بدون مصرف زمان CPU مسدود می‌شود (که گاهی در صورت فعال بودن bool_doublebuffer رخ می‌دهد). این گزینه در حال حاضر با فعال بودن OpenGL تاثیری ندارد و تنها در صورتی کار می‌کند که پشتیبانی از چندریسگی به صورت کامپایل‌شده در برنامه وجود داشته باشد.
.El
.Sh "وضعیت‌های ذخیره‌شده (SAVE STATES)"
.Bl -tag -width xxxx
.It key_slot_X [X]
.It joy_slot_X []
.It mou_slot_X []
اسلات وضعیت ذخیره‌شده جاری را روی شماره X تنظیم می‌کند.
.It key_slot_next [f8]
.It joy_slot_next []
.It mou_slot_next []
جابه‌جایی به اسلات ذخیره بعدی.
.It key_slot_prev [f7]
.It joy_slot_prev []
.It mou_slot_prev []
جابه‌جایی به اسلات ذخیره قبلی.
.It key_save [f2]
.It joy_save []
.It mou_save []
وضعیت بازی را در اسلات جاری ذخیره می‌کند.
.It key_load [f3]
.It joy_load []
.It mou_load []
وضعیت بازی را از اسلات جاری بارگذاری می‌کند.
.El
.Sh "کلیدهای متفرقه (MISCELLANEOUS KEYS)"
.Bl -tag -width xxxx
.It key_fix_checksum [f1]
.It joy_fix_checksum []
.It mou_fix_checksum []
مقدار چک‌سام را اصلاح می‌کند. برخی بازی‌های قدیمی‌تر در صورتی که رام هک شده باشد یا با کدهای Game Genie تغییر یافته باشد، با یک صفحه قرمز قفل (فریز) می‌کنند. در این حالت، فشردن این کلید و راه‌اندازی مجدد بازی باید مشکل را برطرف کند.
.It key_quit [escape]
.It joy_quit []
.It mou_quit []
خروج از DGen یا رفتن به رام بعدی در خط فرمان.
.It key_craptv_toggle [f5]
.It joy_craptv_toggle []
.It mou_craptv_toggle []
تغییر وضعیت فیلترهای تصویری Crap-TV. این فیلترها در حالت ۸ بیت بر پیکسل (8 bpp) در دسترس نیستند.
.It key_scaling_toggle [f6]
.It joy_scaling_toggle []
.It mou_scaling_toggle []
تغییر الگوریتم‌های مقیاس‌بندی. گزینه scaling_startup در زیر را مشاهده کنید.
.It key_reset [tab]
.It joy_reset []
.It mou_reset []
راه‌اندازی مجدد شبیه‌سازی جنسیس.
.It key_cpu_toggle [f11]
.It joy_cpu_toggle []
.It mou_cpu_toggle []
تعویض شبیه‌سازهای CPU. شبیه‌ساز پردازنده اسمبلی StarScream برای x86 سریع است، اما دارای اشکالاتی است که روی چند بازی تاثیر می‌گذارد. تغییر به هسته کندتر Musashi این مشکلات را برطرف می‌کند، البته با کاهش سرعت اجرا.
.It key_z80_toggle [f10]
.It joy_z80_toggle []
.It mou_z80_toggle []
تعویض شبیه‌سازهای Z80. شبیه‌ساز MZ80 به ویژه در نسخه اسمبلی آن (تنها در دسترس برای x86) کمی سریع‌تر از CZ80 است، اما CZ80 با بازی‌های بیشتری کار می‌کند. این کلید همچنین می‌تواند شبیه‌سازی Z80 را غیرفعال کند.
.It key_stop [z]
.It joy_stop []
.It mou_stop []
توقف موقت شبیه‌سازی، تا بتوانید برای چند ثانیه روی زندگی واقعی تمرکز کنید. :)
.It key_game_genie [f9]
.It joy_game_genie []
.It mou_game_genie []
ورود کد Game Genie یا کد هگزادسیمال. این کلید در حالت متوقف‌شده نیز کار می‌کند.
.It key_screenshot [f12]
.It joy_screenshot []
.It mou_screenshot []
گرفتن تصویر از صفحه (اسکرین‌شات). در حالت ۸ بیت بر پیکسل در دسترس نیست.
.It key_prompt [:]
.It joy_prompt []
.It mou_prompt []
توقف موقت شبیه‌سازی و نمایش اعلان تعاملی. در حالت متوقف‌شده نیز کار می‌کند.
.It key_debug_enter [`]
.It joy_debug_enter []
.It mou_debug_enter []
ورود به اشکال‌زدا (debugger). تنها در صورتی معنادار است که پشتیبانی از اشکال‌زدا به صورت کامپایل‌شده در برنامه وجود داشته باشد.
.El
.Sh "ترجیحات (PREFERENCES)"
.Bl -tag -width xxxx
.It int_hz [60]
نرخ نوسازی ویدیو. مقدار پیش‌فرض 60 مانند کنسول‌های NTSC است.
.It bool_pal [false]
در صورت درست بودن، یک کنسول PAL شبیه‌سازی می‌شود. این گزینه باید همراه با int_hz در بالا برای شبیه‌سازی 50Hz استفاده شود.
.It region [' ']
مقدار U برای آمریکا (NTSC)، مقدار E برای اروپا (PAL)، مقدار J برای ژاپن (NTSC)، مقدار X برای ژاپن (PAL)، یا فاصله خالی برای تشخیص خودکار (پیش‌فرض).
بر bool_pal و int_hz اولویت دارد و آن‌ها را بازنویسی می‌کند.
.It str_region_order [JUEX]
مناطقی که DGen در صورت فعال بودن تشخیص خودکار مجاز به شبیه‌سازی آن‌ها است، به ترتیب اولویت.
.It emu_m68k_startup [musa]
هنگامی که هر دو شبیه‌ساز Musashi و StarScream به صورت کامپایل‌شده در برنامه وجود دارند کاربرد دارد. این گزینه شبیه‌ساز پیش‌فرض را برای استفاده انتخاب می‌کند (مقدار «musa» برای Musashi، مقدار «star» برای StarScream و «none» برای هیچ‌کدام). گزینه key_cpu_toggle را مشاهده کنید.
.It emu_z80_startup [cz80]
هنگامی که هر دو شبیه‌ساز CZ80 و MZ80 به صورت کامپایل‌شده در برنامه وجود دارند کاربرد دارد. این گزینه شبیه‌ساز پیش‌فرض را برای استفاده انتخاب می‌کند (مقادیر «cz80»، «mz80» یا «none» در صورتی که می‌خواهید آن را به طور کامل غیرفعال کنید). گزینه key_z80_toggle را مشاهده کنید.
.It bool_autoload [false]
بارگذاری خودکار وضعیت ذخیره‌شده از اسلات 0 هنگام شروع به کار DGen.
.It bool_autosave [false]
ذخیره خودکار وضعیت جاری در اسلات 0 هنگام خروج. با تنظیم هر دوی این فیلدها روی true، می‌توانید از DGen خارج شوید و با راه‌اندازی مجدد، بازی را به طور خودکار از همان جایی که رها کرده بودید ادامه دهید.
.It bool_autoconf [true]
ذخیره خودکار پیکربندی جاری در dgenrc.auto پیش از خروج. این فایل هنگام راه‌اندازی همیشه پیش از dgenrc بارگذاری می‌شود.
.It bool_frameskip [true]
رد کردن خودکار فریم‌ها در صورت لزوم جهت حفظ سرعت مناسب شبیه‌سازی. در صورت تنظیم این گزینه روی false، ممکن است بخواهید صدا را غیرفعال کنید یا int_nice را روی مقداری غیر از صفر قرار دهید.
.It int_nice [0]
در صورت تنظیم روی مقداری غیر از صفر، DGen پس از رندر هر فریم تابع
.Xr usleep 3
را با پارامتر مشخص‌شده فراخوانی می‌کند. این کار سرعت برنامه را کاهش می‌دهد (اگر روی رایانه شما بیش از حد سریع اجرا می‌شود) و به سیستم‌عامل اجازه می‌دهد بخشی از زمان پردازنده (CPU) را بازپس گیرد.
.It ctv_craptv_startup [off]
فیلتر CTV مورد استفاده به صورت پیش‌فرض. فیلترهای موجود عبارتند از «blur»، «scanline»، «interlace» و «swab».
.It scaling_startup [stretch]
مقیاس‌دهنده‌ای که هنگام بزرگ‌تر بودن تفکیک‌پذیری نمایشگر از صفحه اصلی استفاده می‌شود. فیلترهای موجود عبارتند از «stretch»، «scale»، «hqx»، «hqx stretch»، «scale2x»، «scale2x stretch» و «none».
.It bool_show_carthead [false]
نمایش اطلاعات هدر کارتریج هنگام راه‌اندازی.
.It bool_raw_screenshots [false]
تولید تصویرهای صفحه (اسکرین‌شات‌ها) بدون فیلتر.
.It str_rom_path ["roms"]
پوشه‌ای که DGen به صورت پیش‌فرض باید در آن به دنبال رام‌ها بگردد. این مسیر نسبت به پوشه خانگی DGen است، مگر اینکه یک مسیر مطلق مشخص شده باشد.
.El
.Sh "اشکال‌زدایی (DEBUGGING)"
.Bl -tag -width xxxx
.It bool_vdp_hide_plane_a [false]
.It bool_vdp_hide_plane_b [false]
.It bool_vdp_hide_plane_w [false]
.It bool_vdp_hide_sprites [false]
پنهان کردن صفحه‌های مختلف در حین رندر فریم. نیازمند آن است که قابلیت اشکال‌زدایی VDP به صورت کامپایل‌شده در برنامه وجود داشته باشد.
.It bool_vdp_sprites_boxing [false]
.It int_vdp_sprites_boxing_fg [0xffff00] (yellow)
.It int_vdp_sprites_boxing_bg [0x00ff00] (green)
تغییر وضعیت کادربندی اسپریت‌ها و پیکربندی رنگ‌های آن. نیازمند آن است که قابلیت اشکال‌زدایی VDP به صورت کامپایل‌شده در برنامه وجود داشته باشد. مقدار «fg» برای اسپریت‌هایی است که بیت اولویت بالا در آن‌ها تنظیم شده است، و «bg» برای سایرین است. قالب رنگ به صورت 0xRRGGBB است.
.El
.Sh "مثال‌ها (EXAMPLES)"
فایل «sample.dgenrc» را در توزیع DGen/SDL ببینید.
.Sh "شناسه‌های کلید (KEY IDENTIFIERS)"
یک شناسه کلید می‌تواند دارای پیشوندهای «-shift»، «-ctrl»، «-alt» و «-meta» یا هر ترکیبی از آن‌ها باشد تا فشرده شدن کلید تبدیل‌کننده مشخص‌شده همراه با آن کلید الزامی شود. برای مثال، شناسه «alt-enter» معادل نگه داشتن کلید Alt هنگام فشردن Enter است.
.Pp
تبدیل‌کننده «-shift» تنها با کلیدهایی کار می‌کند که نماد یا نویسه تولید نمی‌کنند (مانند کلیدهای جهت‌نما). در غیر این صورت باید از نمایه UTF-8 آن‌ها مستقیماً استفاده شود.
.Pp
اعداد «0» تا «9» (و «kp_0» تا «kp_9» برای صفحه کلید عددی)، حروف «A» تا «Z» و کلیدهای تابعی «F1» تا «F12» به کلیدهای معادل خود نگاشت می‌شوند.
علاوه بر این، شناسه‌های زیر به کلیدهای هم‌نام و متناظر خود نگاشت می‌شوند. شناسه‌هایی که در یک خط قرار دارند به یک کلید یکسان نگاشت می‌شوند:
.Bd -literal -offset indent
escape
backspace
tab
capslock	caps_lock
lshift		shift_l
rshift		shift_r
lctrl		ctrl_l
lmeta		meta_l
lalt		alt_l
ralt		alt_r
rmeta		meta_r
rctrl		ctrl_r
return		enter
space

scrollock	scroll_lock
numlock		num_lock

insert
home
page_up		pageup
delete
end
page_down	pagedown
left
right
up
down

kp_home
kp_up
kp_pageup	kp_page_up
kp_left
kp_right
kp_end
kp_down
kp_pagedown	kp_page_down
kp_insert
kp_delete	kp_period

kp_enter
kp_divide
kp_minus
kp_multiply
kp_plus
.Ed
.Sh "شناسه‌های جوی‌استیک (JOYSTICK IDENTIFIERS)"
همانند شناسه‌های کلید، شناسه‌های جوی‌استیک (یا دسته بازی) یک رویداد جوی‌استیک را توصیف می‌کنند. هر جوی‌استیک شناسایی‌شده از شماره 0 شماره‌گذاری می‌شود. سه نوع رویداد مختلف پشتیبانی می‌شوند.
.Bl -tag -width xxxx
.It دکمه‌ها (Buttons): joystickX-buttonY
برای جوی‌استیک/دسته بازی شماره X، دکمه شماره Y. واژه «button» را می‌توان به صورت «b» خلاصه کرد.
.It محورها (Axes): joystickX-axisY-min, joystickX-axisY-max
برای جوی‌استیک/دسته بازی شماره X، محور شماره Y و موقعیت آن، که می‌تواند «min» (همچنین «n» یا «negative») یا «max» (همچنین «p» یا «positive») باشد. واژه «axis» را می‌توان به صورت «a» خلاصه کرد.
.It کلاه‌ک‌ها (Hats): joystickX-hatY-{direction}
برای جوی‌استیک/دسته بازی شماره X، کلاه‌ک (hat) شماره Y و جهت آن. واژه «hat» را می‌توان به صورت «h» خلاصه کرد. جهت‌های ممکن عبارتند از «up»، «right»، «down» و «left».
.El
.Sh "شناسه‌های ماوس (MOUSE IDENTIFIERS)"
این شناسه‌ها یک رویداد ماوس را توصیف می‌کنند. هر ماوس شناسایی‌شده از شماره 0 شماره‌گذاری می‌شود. دو نوع رویداد مختلف پشتیبانی می‌شوند.
.Bl -tag -width xxxx
.It دکمه‌ها (Buttons): mouseX-buttonY
برای ماوس شماره X، دکمه شماره Y. واژه «button» را می‌توان به صورت «b» خلاصه کرد.
.It حرکت‌ها (Motions): mouseX-{direction}
برای ماوس شماره X و جهت حرکت. جهت‌های ممکن عبارتند از «up»، «right»، «down» و «left».
.El
.Sh "همچنین ببینید (SEE ALSO)"
.Xr dgen 1
.Sh "نویسندگان (AUTHORS)"
این صفحه راهنما توسط
.An Joe Groff Aq joe@pknet.com
نوشته شده است.
.An به‌روزرسانی توسط zamaz Aq zamaz@users.sourceforge.net .