.Dd 26 ژوئیه 2014
.Dt DGEN 1
.Os
.Sh "نام (NAME)"
.Nm dgen
.Nd شبیه‌ساز سگا جنسیس / مگا درایو
.Sh "خلاصه دستور (SYNOPSIS)"
.Nm dgen
.Op Fl Pfhmv
.Op Fl R Ar (J|U|E)
.Op Fl H Ar HZ
.Op Fl D Ar DEMONAME
.Op Fl d Ar DEMONAME
.Op Fl n Ar USEC
.Op Fl p Ar CODE,CODE...
.Op Fl r Ar RCFILE
.Op Fl X Ar XFACT
.Op Fl Y Ar YFACT
.Op Fl S Ar FACT
.Op Fl g Ar (0|1)
.Op Fl G Ar XxY
.Op Fl s Ar SLOT
.Ar [romname [...]]
.Sh "توضیحات (DESCRIPTION)"
ایمیج ROM در فایل
.Ar romname
به‌صورت شبیه‌سازی‌شده روی سگا جنسیس یا مگا درایو در حالت 60Hz NTSC اجرا می‌شود (مگر اینکه گزینه
.Fl P
مشخص شده باشد که در این صورت از حالت 50Hz PAL استفاده می‌شود).
.Ar romname
باید در قالب باینری خام (raw binary) یا SMD باشد، و می‌تواند با
.Xr gzip 1 ،
.Xr zip 1
یا
.Xr bzip2 1
فشرده شده باشد.
.Pp
هنگامی که
.Ar romname
مشخص نشده باشد، DGen بدون ROM شروع به کار می‌کند. می‌توان آن را بعداً از طریق اعلان (prompt) بارگذاری کرد. هنگامی که بیش از یک
.Ar romname
مشخص شود، آن‌ها به‌صورت متوالی اجرا می‌شوند.
.Pp
گزینه‌ها به شرح زیر هستند:
.Bl -tag -width Fl
.It Fl H Ar HZ
استفاده از نرخ فریم سفارشی، می‌تواند برای افزایش یا کاهش سرعت شبیه‌سازی استفاده شود.
.It Fl P
شبیه‌سازی حالت 50Hz PAL (همان‌طور که در مدل‌های اروپایی مگا درایو استفاده می‌شود).
.It Fl R Ar (J|U|E)
منطقه جغرافیایی شبیه‌ساز (Region). بدون این گزینه، DGen از اولین منطقه ذکرشده در هدر ROM استفاده می‌کند. برای حالت PAL باید با
.Fl P
ترکیب شود. به جدول زیر مراجعه کنید:
.Bl -tag -width Fl
.It (none)
تشخیص خودکار (NTSC, 60Hz)
.It Fl P
تشخیص خودکار (PAL, 50Hz)
.It Fl R Ar J
ژاپن (NTSC, 60Hz)
.It Fl R Ar J Fl P
ژاپن (PAL, 50Hz)
.It Fl R Ar E
اروپا (NTSC, 60Hz، موسیقی قطعاً بیش از حد سریع پخش خواهد شد)
.It Fl R Ar E Fl P
اروپا (PAL, 50Hz)
.It Fl R Ar U
آمریکا (NTSC, 60Hz)
.It Fl R Ar U Fl P
مشابه
.Fl R Ar E Fl P
.El
.It Fl f
اجرا در حالت تمام‌صفحه، در صورت امکان.
.It Fl h
نمایش خلاصه مختصری از تمام گزینه‌ها.
.It Fl m
فقط در MinGW. این گزینه از جدا شدن DGen از کنسول کنترلی خود جلوگیری می‌کند.
.It Fl v
نمایش شماره نسخه و خروج.
.It Fl D Ar DEMONAME
پخش مجدد دمو ضبط‌شده با گزینه
.Fl d .
.It Fl d Ar DEMONAME
ضبط دموی اجرای برنامه، که بعداً می‌توان با سوئیچ
.Fl D
آن را بازپخش کرد.
.It Fl n Ar USEC
خواب (sleep) به مدت چند میکروثانیه پس از هر فریم، جهت اختصاص زمان به سایر فرآیندها.
.It Fl p Ar CODE,CODE...
تغییر ایمیج ROM در حافظه با استفاده از کدهای سبک Game Genie یا Hex. کدهای Game Genie به شکل
.Ar ABCD-EFGH
و کدهای Hex به شکل
.Ar 123456:ABCD
هستند. برای مشخص کردن بیش از یک کد، آن‌ها را با کاما جدا کنید (از فاصله استفاده
.Ar نکنید
).
.It Fl r Ar RCFILE
تجزیه یک فایل rc دیگر پس از $HOME/.dgen/dgenrc. مقادیر موجود در فایل مشخص‌شده بر مقادیر فایل‌های پیشین اولویت دارند.
.It Fl X Ar XFACT
مقیاس‌بندی پنجره به اندازه XFACT برابر در راستای محور X. مقدار XFACT باید یک عدد صحیح مثبت باشد.
.It Fl Y Ar YFACT
مقیاس‌بندی پنجره به اندازه YFACT برابر در راستای محور Y. مقدار YFACT باید یک عدد صحیح مثبت باشد.
.It Fl S Ar FACT
مقیاس‌بندی پنجره به اندازه FACT برابر در هر دو جهت. مقدار FACT باید یک عدد صحیح مثبت باشد.
.It Fl g Ar (0|1)
فعال/غیرفعال کردن OpenGL (در صورت کامپایل بودن).
.It Fl G Ar XxY
اندازه مورد نظر برای پنجره (مانند 640x480، 800x600 و غیره).
.It Fl s Ar SLOT
بارگذاری وضعیت ذخیره‌شده (saved state) از شیار مشخص‌شده در هنگام راه‌اندازی (0-9).
.El
.Sh "اعلان تعاملی (INTERACTIVE PROMPT)"
یک اعلان تعاملی مینیمالیستی با الهام از
.Xr vi 1
می‌تواند برای انجام عملیات مختلف که در زیر توضیح داده شده استفاده شود. این اعلان با فشردن کلید دونقطه (:) فعال می‌شود که کلید پیش‌فرض است. ویرایش خط فرمان، تاریخچه و تکمیل خودکار پشتیبانی می‌شوند.
.Ss "دستورات (Commands)"
.Bl -tag -width xxxx
.It {quit, exit, q}
خروج، یا بارگذاری
.Ar romname
بعدی از خط فرمان (در صورت وجود).
.It {load, open, plug, o} Ar filename
بارگذاری رام مشخص‌شده
.Ar filename .
.It {unload, close, unplug}
تخلیه رام جاری.
.It config_load Ar filename
بارگذاری پیکربندی از فایل
.Ar filename .
.It config_save Ar filename
ذخیره پیکربندی فعلی در فایل
.Ar filename .
.It reset
راه‌اندازی مجدد جنسیس (Reset).
.It {ctv_push, ctv_pop, ctv_none}
مدیریت پشته فیلترهای Crap TV (در صورت کامپایل بودن).
.It calibrate Ar number
کالیبراسیون تعاملی گیم‌پد مشخص‌شده (1 یا 2). در صورت مشخص نشدن
.Ar number ،
پیش‌فرض 1 است.
.It unbind Ar binding [...]
حذف کلیدهای میانبر مشخص‌شده (متغیرهایی با پیشوند "bind_").
برای اطلاعات بیشتر درباره آن‌ها به
.Xr dgenrc 5
مراجعه کنید.
.It vgmdump start Ar filename
.It vgmdump stop
مدیریت دامپ و ثبت وقایع VGM. اگر آرگومان دوم
.Ar start
باشد، دامپ VGM در مسیر مشخص‌شده توسط آرگومان سوم آغاز می‌شود.
اگر آرگومان دوم
.Ar stop
باشد، دامپ VGM متوقف شده و نهایی می‌شود.
.El
.Ss "متغیرها (Variables)"
تمامی متغیرهای پیکربندی از
.Xr dgenrc 5
را می‌توان به‌صورت تعاملی و با اثرگذاری آنی مشاهده و تغییر داد.
.Bl -tag -width xxxx
.It {int_name, bool_name, key_name, joy_name, ...} {value}
اختصاص دادن
.Ar value
به متغیر
.Ar name .
.It {int_name, bool_name, key_name, joy_name, ...}
نمایش مقدار فعلی متغیر
.Ar name .
.El
.Sh "فایل‌ها (FILES)"
.Bl -tag -width $HOME/.dgen/dgen/saves/* -compact
.It Pa $HOME/.dgen/dgenrc
شامل تنظیمات کاربری برای شبیه‌ساز.
.It Pa $HOME/.dgen/dgenrc.auto
فایل تولیدشده حاوی تنظیمات کاربری ذخیره‌شده.
.It Pa $HOME/.dgen/saves/*
وضعیت‌های ذخیره‌شده تولیدشده توسط شبیه‌ساز.
.It Pa $HOME/.dgen/ram/*
ایمیج‌های RAM پشتیبان‌گیری‌شده با باتری، تولیدشده توسط شبیه‌ساز برای رام‌های دارای باتری ذخیره‌سازی.
.It Pa $HOME/.dgen/screenshots/*
تصاویر ثبت‌شده از صفحه در اینجا تولید می‌شوند.
.It Pa $HOME/.dgen/roms/*
مسیر پیش‌فرض جستجوی رام‌ها.
.It Pa $HOME/.dgen/demos/*
مسیر پیش‌فرض جستجوی دموها.
.El
.Sh "همچنین ببینید (SEE ALSO)"
.Xr gzip 1 ,
.Xr bzip2 1 ,
.Xr zip 1 ,
.Xr dgenrc 5
.Sh "نویسندگان (AUTHORS)"
این صفحه راهنما توسط
.An Joe Groff Aq joe@pknet.com
نوشته شده است.
.An به‌روزرسانی توسط zamaz Aq zamaz@users.sourceforge.net .
.Sh "گزارش اشکالات (BUGS)"
اشکالات شناخته‌شده‌ای در شبیه‌سازی وجود دارد، فایل BUGS را در بسته سورس DGen ببینید.
.Pp
.An گزارش اشکالات به Aq http://sourceforge.net/projects/dgen .