~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
	DingooNES v1.2 for Native OS by lion_rsm
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~



Что это?
~~~~~~~~
DingooNES - это эмулятор 8-битной игровой консоли Nintendo Entertainment System / Famicom / Dendy (далее просто NES) для портативной игровой консоли Dingoo A320 (SIM-версия для Native OS). Эмулятор основан на модифицированном ядре эмулятора FCEUX v2.1.5.



Чем этот эмулятор лучше аналогов?
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
На данный момент под Dingoo Native OS существует только стандартный эмулятор NES - NES.SIM. Эмулятор DingooNES обладает рядом преимуществ перед своим аналогом:
	- унифицированный пользовательский интерфейс (будущие эмуляторы других систем будут иметь такой же интерфейс) с удобным и интуитивно понятным управлением;
	- высокая скорость эмуляции, не уступающая аналогу, а в ряде случаев превосходящая его;
	- превосходная совместимость с играми благодаря использованию ядра эмуляции FCEUX v2.1.5;
	- поддержка аппаратного билинейного масштабирования с использованием IPU;
	- поддержка игр в телевизионных стандартах NTSC и PAL;
	- поддержка светового пистолета NES Zapper с дополнительной функцией автонаведения на цель;
	- поддержка игр для Famicom Disk System и Nintendo Vs. System;
	- поддержка загрузки сжатых ROM файлов игр, а так же функция автоматического сжатия ROM файлов;
	- безопасная работа эмулятора на Dingoo, подключенной к телевизору;
	- быстрая перемотка эмуляции вперед - Fast forward;
	- специальные режимы запуска эмулятора.



Установка эмулятора
~~~~~~~~~~~~~~~~~~~
Распакуйте zip архив на компьютер в любую папку. В папке окажутся несколько файлов, среди которых будут:

	DingooNES.sim	- собственно, сам эмулятор;
	disksys.rom     - файл BIOS для поддержки FDS;
	README			- данное руководство;

Файл DingooNES.sim скопируйте в папку GAME вашей игровой консоли Dingoo A320, предварительно удалив оттуда старый эмулятор NES.SIM. Если в папке GAME присутствует конфигурационный файл DingooNES.cfg от предыдущей версии эмулятора, то его так же необходимо удалить. 

Добавьте в Dingoo игры для NES (Nintendo Entertainment System) в формате .nes или .fds, если таковые отсутствуют.



Использование эмулятора
~~~~~~~~~~~~~~~~~~~~~~~
Выберите пункт "Interesting game" в меню "Game center" на вашей Dingoo. В браузере файлов отыщите свою папку с играми NES, выберите интересующую игру и нажмите кнопку "A". Запустится эмулятор DingooNES, который загрузит и запустит на выполнение выбранную вами игру. Для входа в меню эмулятора нажмите одновременно "Start" и "Select" или кнопку "Power".



Поддержка сжатых ROM файлов
~~~~~~~~~~~~~~~~~~~~~~~~~~~
Эмулятор DingooNES поддерживает загрузку ROM файлов, сжатых по алгоритму ZIP. Для создания сжатого ROM файла необходимо соответствующий файл .nes или .fds упаковать при помощи подходящего архиватора в .zip. Полученный .zip необходимо переименовать обратно в .nes или .fds и закинуть в Dingoo. При открытии файла игры эмулятор автоматически распознает сжатие и производит распаковку. 

Так же эмулятор способен самостоятельно сжимать ROM файлы. Если данная функция активна и загруженная игра не была сжата ранее, эмулятор при выходе предложит сжать ROM файл данной игры. Используйте возможность сжатия NES ROM файлов для экономии памяти Dingoo!



Поддержка игр для Famicom Disk System и Nintendo Vs. System
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
Файлы с расширением .fds представляют собой образы дисков для Famicom Disk System (http://en.wikipedia.org/wiki/Famicom_Disk_System), которые можно открыть в эмуляторе DingooNES. Для корректной работы эмулятора с FDS необходимо идущий в комплекте файл биоса disksys.rom скопировать в ту же папку, где находится DingooNES.sim. Некоторые FDS игры в процессе загрузки требуют от пользователя сменить сторону диска. Выполнить данную операцию можно при помощи комбинации горячих клавиш "L"+"R"+"Select". Советую испробовать игры для FDS, некоторые известные тайтлы выглядят необычно!

Игры для Nintendo Vs. System (http://en.wikipedia.org/wiki/Nintendo_Vs._System) представляют собой обычные .nes файлы, у которых, как правило, в названии присутствует суффикс (VS) и в каждой такой игре, чтобы начать играть, необходимо вставить монетку. В эмуляторе DingooNES вставить виртуальную монетку можно при помощи комбинации горячих клавиш "L"+"R"+"Start". Некоторые из VS игр расчитаны исключительно на управление посредством светового пистолета, поэтому часть опций эмулятора, связанных с настройкой геймпада, может быть заблокирована. Определенно стоит попробовать игры для Nintendo Vs. System, т. к. некоторые из них, например "Duck Hunt (VS)", смотрятся куда более интересно, чем их стандартные NES аналоги!



Поддержка светового пистолета
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
Данный эмулятор имеет поддержку светового пистолета NES Zapper. DingooNES автоматически распознает игры, использующие NES Zapper, и активирует поддержку светового пистолета, при этом поверх изображения появляется маркер прицела. Управление позицией маркера осуществляется клавишами "Up", "Down", "Left", "Right", выстрел осуществляется клавишей "A" (при настройке управления по умолчанию). Если в игре активен световой пистолет, то управление из геймпада NES недоступно, доступны лишь клавиши "Select" и "Start", которые можно использовать для выбора режима и запуска игры соответственно. Отключить на время световой пистолет и вернуть управление на геймпад NES можно в настройках эмулятора "Input settings".

Так же эмулятор DingooNES имеет функцию автоматического поиска и наведения на цель, которую можно активировать в настройках управления. В зависимости от игры, данная функция может как сильно облегчить, так и неоправдано усложнить геймплей, поэтому пользователь сам должен решать, в каких играх активировать эту функцию. Алгоритм автоматического поиска и наведения на цель работает паралельно ручному управлению маркером прицела и имеет более низкий приоритет, т. е. всегда можно вручную подкорректировать положение маркера. Алгоритм способен распознавать до двух, желательно движущихся, целей. После выстрела маркер автоматически перемещается на альтернативную найденную цель. Переключаться на альтернативную цель можно и без осуществления выстрела, для этого необходимо нажимать клавишу "B" (при настройке управления по умолчанию).



Основное меню эмулятора
~~~~~~~~~~~~~~~~~~~~~~~
Resume
	Выход из меню и возврат в игру. Так же в игру можно вернуться по нажатию клавиши "B".
	
Save state
	Сохранение текущего игрового состояния в файл. Файл состояния сохраняется в той же папке, где расположена игра. Имя файла состоит из названия игры и расширения от .sv0 до .sv9. Клавишами "Left" и "Right" можно выбрать логический слот, в который будет сохраняться состояние, клавишей "A" производится сохранение. Всего доступно 10 слотов. В окошке справа отображается скриншот игрового состояния, сохраненного в выбранном слоте.
	
Load state
	Загрузка игрового состояния из файла. Файл должен располагаться в той же папке, что и игра, название должно совпадать с названием игры а расширение должно быть от .sv0 до .sv9. Клавишами "Left" и "Right" необходимо выбрать слот с нужным игровым состоянием и по клавише "A" загрузить его. После загрузки игрового состояния эмулятор автоматически вернется в игру. Находясь на пункте "Load state" или "Save state", по нажатию на клавишу "X" можно удалить игровое состояние из выбраного слота, при этом, после подтверждения ваших намерений, удаляется соответствующий файл игрового состояния.
	
Skip frames
	Данная опция указывает на то, сколько проэмулированных кадров будет опущено до момента отрисовки на экран. Опция позволяет повысить скорость эмуляции за счет потери в плавности изображения. Значение "0" означает, что на экран отрисовываются все проэмулированные кадры. Значение "AUTO" означает, что эмулятор самостоятельно решает какие кадры и когда будут опущены для достижения 100% скорости эмуляции игры. Клавишами "Left" и "Right" можно выбрать необходимое значение, по нажатию клавиши "A" будет выбрано значение "AUTO". Если быстродействия эмулятора не достаточно, рекомендуется выставить эту опцию в "AUTO".
	
Full screen
	Опция позволяет настроить вывод изображения либо растянутым на всю площадь экрана Dingoo, либо на вывод в родном разрешении по центру экрана с обрамляющими черными полями. При недостаточной скорости эмуляции рекомендуется выставить опцию в "OFF", т.к. отрисовка в родном разрешении не требует масштабирования и работает быстрее.
	
Sound volume
	Данная опция позволяет задать громкость звука либо отключить звук вовсе. Клавишами "Left" и "Right" можно выбрать необходимое значение, по нажатию клавиши "A" будет выбрано значение "OFF". Если скорость эмуляции недостаточна, попробуйте выставить значение опции в "OFF".
	
Advanced sets
	Меню с набором дополнительных опций.
	
Reset
	Сброс игры в начальное состояние. В последующем диалоговом экране необходимо подтвердить свои действия.
	
Exit
	Выход из DingooNES и возврат в меню Dingoo.



Дополнительное меню эмулятора
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
Video settings -> Fullscreen scaling
	Данная опция позволяет задать алгоритм масштабирования изображения при выводе на экран. Значение "HARDWARE" говорит о том, что используется аппаратный блок IPU, выполняющий билинейное масштабирование изображения. Опция актуальна если "Full screen" выставлено в "ON".
	
Video settings -> Vertical stretch
	Данная опция позволяет отключить масштабирование изображения по вертикали. Масштабирование по вертикали выполняется, когда оригинальное разрешение по вертикали меньше 240 точек, например для NTSC игр с разрешением 256x224 точки. При отключенном масштабировании по вертикали, в конечном изображении могут присутствовать пустые черные поля, но при этом изображение в целом получается более четким. Опция актуальна если "Full screen" выставлено в "ON" и изображение выводтся на LCD экран Dingoo.
	
Video settings -> System timing mode
	Существует два основных варианта приставки: Famicom для японского и NES для американского рынков. Отличаются они многими характеристиками, в том числе таймингами CPU и PPU. Тайминги, как правило, определяют и видеостандарт, в котором работает приставка. Так, NES работает в стандарте NTSC и имеет разрешение 256x224@60, Famicom - в стандарте PAL с разрешением 256x240@50. Данная опция позволяет задать тайминги консоли, соответствующие NTSC или PAL видеостандарту. При значении опции "AUTO" эмулятор автоматически выставляет тайминги, необходимые для запущенной игры. Если вы плохо понимаете, что делает эта опция и зачем она нужна, держите ее значение в "AUTO".
	
Sound settings -> Sample rate
	Опция позволяет задать частоту дискретизации для звукового потока, генерируемого эмулятором. Чем ниже значение, тем выше скорость эмуляции но хуже качество звука.

Input settings
	Данное меню позволяет задать соответствие реальных клавиш Dingoo клавишам виртуального геймпада NES. Можно переопределить только часть клавиш, в переопределении которых есть смысл.
	
Input settings -> NES Zapper enable
	Данная опция позволяет деактивировать световой пистолет и переключить управление на геймпад (может быть необходимо в некоторых играх, использующих геймпад наряду со световым пистолетом). Для деактивации светового пистолета выставите значение опции в "OFF". Опция актуальна, если игра поддерживает световой пистолет NES Zapper.
	
Input settings -> NES Zapper auto aim
	С помошью данной опции можно активировать функцию автоматического поиска и наведения на цель, описанную в разделе "Поддержка светового пистолета". Опция актуальна, если игра поддерживает световой пистолет NES Zapper.
	
Input settings -> Diagonals helper
	Конструкция крестовины Dingoo весьма неудачна, нажимать ее по диагонали очень трудно, при этом точность срабатывания оставляет желять лучшего. Данная опция активирует функцию, призванную улучшить срабатывание диагональных комбинаций клавиш. Функция носит экспериментальный характер, поэтому, в случае негативных отзывов пользователей, будет удалена из будущих версий эмулятора.
	
Input settings -> Turbo signal mode
	Данная опция позволяет задать форму сигнала для клавиш "Turbo A" и "Turbo B" из набора предопределенных шаблонов. Если вы наблюдаете в игре проблемы с турбо кнопками, попробуйте подобрать значение этой опции.
	
CPU speed, MHz
	Данная опция позволяет задать частоту работы центрального процессора Dingoo во время эмуляции игры NES. Нормальное значение частоты работы процессора - 336 MHz. При входе в меню эмулятор автоматически понижает частоту до 336 MHz. Чем выше значение данной опции, тем выше скорость эмуляции, тем быстрее разряжается батарея вашей Dingoo. Клавишами "Left" и "Right" можно выбрать необходимое значение из предопределенного списка, по нажатию клавиши "A" значение опции будет увеличиваться на единицу. Значения выше 400 MHz вы выставляете на свой страх и риск, автор эмулятора не несет ответственности за последствия, вызванные вашей манипуляцией с частотой процессора!
	
Show FPS mode
	FPS (Frames Per Second) - это количество кадров, которое эмулятор успевает отрисовать на экран или проэмулировать (в зависимости от режима подсчета) за одну секунду. При значении опции "OFF" вывод счетчика FPS на экран отключен. При значении "RENDERED" на экран выводится количество отрисованных кадров, при значении "EMULATED" - количество виртуальных проэмулированных кадров. По данному значению удобно судить об общей скорости эмуляции. Чем выше значение на экране, тем лучше. Номинальное значение FPS для NTSC игр ~ 60, для PAL ~ 50 в режиме подсчета "EMULATED". Если вы не понимаете назначения этой опции, то ее лучше держать в выключеном состоянии.
	
Auto compress ROM
	Данная опция позволяет включить функцию автоматического сжатия ROM файла текущей загруженной игры при выходе из эмулятора. Если вы не хотите сжимать ROM файлы ваших NES игр, то выставите данную опцию в "OFF".
	
Save global settings
	Запись настроек эмулятора в файл "DingooNES.cfg" в папку, где расположен сам эмулятор (как правило, это папка "GAME"). Если файл "DingooNES.cfg" присутствует, он загружается и применяется при запуске эмулятора.
	
Save game settings
	Запись настроек эмулятора в файл с именем текущей загруженной игры и расширением .cfg, в папку с игрой. Данный файл конфигурации имеет более высокий приоритет, чем "DingooNES.cfg" и если он присутствует для загружаемой игры, он загружается и применяется вместо "DingooNES.cfg". Данный механизм позволяет иметь особые настройки эмулятора для конкретной игры.
	
About emulator
	Краткая информация по эмулятору, версии используемого движка FCEUX, авторе и горячих клавишах управления.



Комбинации горячих клавиш в игре
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
В любой момент игры по комбинации клавиш "Start"+"Select" или "Power" вы можете войти в основное меню эмулятора. Так же во время игры можно быстро сохранить в оперативной памяти текущее игровое состояние, нажав комбинацию клавиш "R"+"Select". Загрузить состояние из памяти можно по нажатии "L"+"Start". Комбинации клавиш "L"+"R"+"Up" и "L"+"R"+"Down" позволяют увеличить или уменьшить громкость звука. Удерживание комбинации клавиш "L"+"R"+"Right" переводит эмулятор в режим "Fast forward", позволяя ускоренно перематывать геймплей вперед. Для смены стороны диска FDS предусмотрена комбинация клавиш "L"+"R"+"Select", для вставки виртуальной монетки - "L"+"R"+"Start" (см. "Поддержка игр для Famicom Disk System и Nintendo Vs. System").



Работа эмулятора при подключении Dingoo к телевизору
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
Если эмулятор запускается на Dingoo, подключенной к телевизору, опции "Full screen", "Vertical stretch" и "CPU speed, MHz" блокируются. При этом опции "Full screen" и "Vertical stretch" выставляются в значение "ON", а "CPU speed, MHz" - в "336". Вызвано это тем, что видеовывод Dingoo на телевизор не работает на частоте процессора, отличной от 336 MHz.



Специальные режимы запуска эмулятора
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
Если во время запука эмулятора удерживать клавишу "L", то настройки эмулятора будут выставлены по умолчанию. При этом файлы конфигурации .cfg не применяются. Впоследствии сброшенные в начальное состояние настройки можно сохранить при помощи "Save global settings" или "Save game settings".

Если во время запуска эмулятора удерживать клавишу "R", то эмулятор будет запущен в режиме максимального быстродействия, при этом эмуляция звука будет отключена, опция "Sound volume" будет выставлена в "OFF" и заблокирована. Так же будут заблокированы комбинации горячих клавиш по управлению громкостью звука.



Об авторе
~~~~~~~~~
DingooNES создан усилиями lion_rsm в 2011-2012 годах. Особая благодарность выражается создателям Dingoo SDK for Native OS, команде FCEUX, людям, причастным к созданию других эмуляторов под Dingoo.

Свои замечания, предложения и багрепорты можете оставлять на сайтах http://a320.emulate.su или http://dingoonity.org.



История изменений
~~~~~~~~~~~~~~~~~
v1.2 - 25.03.2012:
	Добавлена поддержка игр в формате Famicom Disk System (FDS).
	Добавлена поддержка игр в формате Nintendo Vs. System.
	Улучшена поддержка светового пистолета.
	Добавлена возможность переназначения клавиш "Start" и "Select".
	Частота работы CPU по умолчанию выставлена в стандартные 336 МГц.
	Незначительные улучшения в коде.

v1.1 - 16.03.2012:
	На 15% ускорен полноэкранный рендеринг изображения.
	Исправлен баг, при котором после возврата из меню в игру перезаписывалось быстрое сохранение.
	Добавлен алгоритм и опция "Diagonals helper", добавлена опция "Turbo signal mode", улучшено поведение турбо кнопок.
	Добавлена поддержка светового пистолета NES Zapper, добавлен алгоритм автопоиска целей, добавлены соответствующие опции в "Input settings".
	Добавлена опция "System timing mode" для принудительного выбора таймингов системы.
	Добавлена опция "Vertical stretch" для управления масштабированием изображения по вертикали.
	Небольшие улучшения в пользовательском графическом интерфейсе.
	Множество небольших улучшений в коде.
	
v1.0 - 07.03.2012:
	Первый публичный релиз.


