نام (NAME)

dgen — شبیه‌ساز سگا جنسیس / مگا درایو

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

dgen [-Pfhmv] [-R (J|U|E)] [-H HZ] [-D DEMONAME] [-d DEMONAME] [-n USEC] [-p CODE,CODE...] [-r RCFILE] [-X XFACT] [-Y YFACT] [-S FACT] [-g (0|1)] [-G XxY] [-s SLOT] [romname [...]]

توضیحات (DESCRIPTION)

ایمیج ROM در فایل romname به‌صورت شبیه‌سازی‌شده روی سگا جنسیس یا مگا درایو در حالت 60Hz NTSC اجرا می‌شود (مگر اینکه گزینه -P مشخص شده باشد که در این صورت از حالت 50Hz PAL استفاده می‌شود). romname باید در قالب باینری خام (raw binary) یا SMD باشد، و می‌تواند با gzip(1) ، zip(1) یا bzip2(1) فشرده شده باشد.

هنگامی که romname مشخص نشده باشد، DGen بدون ROM شروع به کار می‌کند. می‌توان آن را بعداً از طریق اعلان (prompt) بارگذاری کرد. هنگامی که بیش از یک romname مشخص شود، آن‌ها به‌صورت متوالی اجرا می‌شوند.

گزینه‌ها به شرح زیر هستند:

-H HZ

استفاده از نرخ فریم سفارشی، می‌تواند برای افزایش یا کاهش سرعت شبیه‌سازی استفاده شود.

-P

شبیه‌سازی حالت 50Hz PAL (همان‌طور که در مدل‌های اروپایی مگا درایو استفاده می‌شود).

-R (J|U|E)

منطقه جغرافیایی شبیه‌ساز (Region). بدون این گزینه، DGen از اولین منطقه ذکرشده در هدر ROM استفاده می‌کند. برای حالت PAL باید با -P ترکیب شود. به جدول زیر مراجعه کنید:

(none): تشخیص خودکار (NTSC, 60Hz)
-P: تشخیص خودکار (PAL, 50Hz)
-R J: ژاپن (NTSC, 60Hz)
-R J -P: ژاپن (PAL, 50Hz)
-R E: اروپا (NTSC, 60Hz، موسیقی قطعاً بیش از حد سریع پخش خواهد شد)
-R E -P: اروپا (PAL, 50Hz)
-R U: آمریکا (NTSC, 60Hz)
-R U -P: مشابه -R E -P

-f

اجرا در حالت تمام‌صفحه، در صورت امکان.

-h

نمایش خلاصه مختصری از تمام گزینه‌ها.

-m

فقط در MinGW. این گزینه از جدا شدن DGen از کنسول کنترلی خود جلوگیری می‌کند.

-v

نمایش شماره نسخه و خروج.

-D DEMONAME

پخش مجدد دمو ضبط‌شده با گزینه -d.

-d DEMONAME

ضبط دموی اجرای برنامه، که بعداً می‌توان با سوئیچ -D آن را بازپخش کرد.

-n USEC

خواب (sleep) به مدت چند میکروثانیه پس از هر فریم، جهت اختصاص زمان به سایر فرآیندها.

-p CODE,CODE...

تغییر ایمیج ROM در حافظه با استفاده از کدهای سبک Game Genie یا Hex. کدهای Game Genie به شکل ABCD-EFGH و کدهای Hex به شکل 123456:ABCD هستند. برای مشخص کردن بیش از یک کد، آن‌ها را با کاما جدا کنید (از فاصله استفاده نکنید ).

-r RCFILE

تجزیه یک فایل rc دیگر پس از $HOME/.dgen/dgenrc. مقادیر موجود در فایل مشخص‌شده بر مقادیر فایل‌های پیشین اولویت دارند.

-X XFACT

مقیاس‌بندی پنجره به اندازه XFACT برابر در راستای محور X. مقدار XFACT باید یک عدد صحیح مثبت باشد.

-Y YFACT

مقیاس‌بندی پنجره به اندازه YFACT برابر در راستای محور Y. مقدار YFACT باید یک عدد صحیح مثبت باشد.

-S FACT

مقیاس‌بندی پنجره به اندازه FACT برابر در هر دو جهت. مقدار FACT باید یک عدد صحیح مثبت باشد.

-g (0|1)

فعال/غیرفعال کردن OpenGL (در صورت کامپایل بودن).

-G XxY

اندازه مورد نظر برای پنجره (مانند 640x480، 800x600 و غیره).

-s SLOT

بارگذاری وضعیت ذخیره‌شده (saved state) از شیار مشخص‌شده در هنگام راه‌اندازی (0-9).

اعلان تعاملی (INTERACTIVE PROMPT)

یک اعلان تعاملی مینیمالیستی با الهام از vi(1) می‌تواند برای انجام عملیات مختلف که در زیر توضیح داده شده استفاده شود. این اعلان با فشردن کلید دونقطه (:) فعال می‌شود که کلید پیش‌فرض است. ویرایش خط فرمان، تاریخچه و تکمیل خودکار پشتیبانی می‌شوند.

دستورات (Commands)

{quit, exit, q}: خروج، یا بارگذاری romname بعدی از خط فرمان (در صورت وجود).
{load, open, plug, o} filename: بارگذاری رام مشخص‌شده filename.
{unload, close, unplug}: تخلیه رام جاری.
config_load filename: بارگذاری پیکربندی از فایل filename.
config_save filename: ذخیره پیکربندی فعلی در فایل filename.
reset: راه‌اندازی مجدد جنسیس (Reset).
{ctv_push, ctv_pop, ctv_none}: مدیریت پشته فیلترهای Crap TV (در صورت کامپایل بودن).
calibrate number: کالیبراسیون تعاملی گیم‌پد مشخص‌شده (1 یا 2). در صورت مشخص نشدن number ، پیش‌فرض 1 است.
unbind binding [...]: حذف کلیدهای میانبر مشخص‌شده (متغیرهایی با پیشوند "bind_"). برای اطلاعات بیشتر درباره آن‌ها به dgenrc(5) مراجعه کنید.
vgmdump start filename
vgmdump stop: مدیریت دامپ و ثبت وقایع VGM. اگر آرگومان دوم start باشد، دامپ VGM در مسیر مشخص‌شده توسط آرگومان سوم آغاز می‌شود. اگر آرگومان دوم stop باشد، دامپ VGM متوقف شده و نهایی می‌شود.

متغیرها (Variables)

تمامی متغیرهای پیکربندی از dgenrc(5) را می‌توان به‌صورت تعاملی و با اثرگذاری آنی مشاهده و تغییر داد.

{int_name, bool_name, key_name, joy_name, ...} {value}: اختصاص دادن value به متغیر name.
{int_name, bool_name, key_name, joy_name, ...}: نمایش مقدار فعلی متغیر name.

فایل‌ها (FILES)

$HOME/.dgen/dgenrc: شامل تنظیمات کاربری برای شبیه‌ساز.
$HOME/.dgen/dgenrc.auto: فایل تولیدشده حاوی تنظیمات کاربری ذخیره‌شده.
$HOME/.dgen/saves/*: وضعیت‌های ذخیره‌شده تولیدشده توسط شبیه‌ساز.
$HOME/.dgen/ram/*: ایمیج‌های RAM پشتیبان‌گیری‌شده با باتری، تولیدشده توسط شبیه‌ساز برای رام‌های دارای باتری ذخیره‌سازی.
$HOME/.dgen/screenshots/*: تصاویر ثبت‌شده از صفحه در اینجا تولید می‌شوند.
$HOME/.dgen/roms/*: مسیر پیش‌فرض جستجوی رام‌ها.
$HOME/.dgen/demos/*: مسیر پیش‌فرض جستجوی دموها.

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

gzip(1), bzip2(1), zip(1), dgenrc(5)

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

این صفحه راهنما توسط Joe Groff ⟨joe@pknet.com⟩ نوشته شده است. به‌روزرسانی توسط zamaz ⟨zamaz@users.sourceforge.net⟩.

گزارش اشکالات (BUGS)

اشکالات شناخته‌شده‌ای در شبیه‌سازی وجود دارد، فایل BUGS را در بسته سورس DGen ببینید.

گزارش اشکالات به ⟨http://sourceforge.net/projects/dgen⟩.