~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
	DingooSNES v1.5 for Native OS by lion_rsm
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~



Что это?
~~~~~~~~
DingooSNES - это эмулятор 16-битной игровой консоли Super Nintendo Emulation System / Super Famicom (далее просто SNES) для портативной игровой консоли Dingoo A320 (SIM-версия для Native OS). DingooSNES является частью пакета эмуляторов "Dingoo Emulation Pack by lion_rsm".



Чем этот эмулятор лучше аналогов?
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
На данный момент под Dingoo Native OS существует два альтернативный эмулятора SNES: стандартный SFC и весьма продвинутый PocketSNES. Эмулятор DingooSNES обладает рядом преимуществ перед аналогами:
	- унифицированный пользовательский интерфейс с удобным и интуитивно понятным управлением;
	- высокая скорость эмуляции, не уступающая аналогам, а в ряде случаев превосходящая их;
	- хорошая совместимость с играми благодаря использованию ядра эмуляции "accurate";
	- функция быстрой перемотки эмуляции вперед (Fast forward);
	- загрузка сжатых ROM файлов игр, а так же функция автоматического сжатия ROM файлов;
	- полноэкранное аппаратное масштабирования с использованием IPU;
	- возможность выбора страны/региона перед запуском игры;
	- поддержка игр в телевизионных стандартах NTSC и PAL;
	- поддержка стандартной для SNES частоты дискретизации звука 32 КГц;
	- поддержка Game Genie чит-кодов;
	- поддержка обложек игровых картриджей.



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

	DingooSNES.sim.fast	    - версия эмулятора, обладающая хорошей скоростью эмуляции;
	DingooSNES.sim.accurate	- версия эмулятора, обладающая хорошей совместимостью с играми;
	README				    - данное руководство;

Выберите один из файлов DingooSNES.sim.* и переименуйте в DingooSNES.sim. Эмулятор, основанный на ядре "fast" работает в большинстве случаев быстрее ядра "accurate", но обладает худшей совместимостью с играми. Полученый файл скопируйте в папку GAME вашей игровой консоли Dingoo A320, предварительно удалив оттуда старый эмулятор SNES (SFC.SIM, PocketSNES.sim и т. п.). Если в папке GAME присутствует конфигурационный файл DingooSNES.cfg от предыдущей версии эмулятора, то его так же необходимо удалить. 

Добавьте в Dingoo игры для SNES (Super Nintendo Entertainment System) в формате .sfc или .smc если таковые отсутствуют.



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



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

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



Поддержка Game Ganie чит-кодов
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
В эмуляторе DingooSNES можно использовать чит-коды Game Genie для получения неуязвимости, бесконечных жизней, необходимого оружия и так далее. Для активации этой функции в папку с игрой необходимо добавить специальный файл, в котором описан набор чит-кодов. Файл должен иметь такое же имя, как у файла игры и расширение .cht. Во время загрузки игры автоматически загружается и файл с Game Genie чит-кодами, при этом, если все прошло успешно, в основном меню эмулятора становится доступным пункт "Cheating".

Подготовка чит-файла: сначала необходимо найти в интернете список Game Genie чит-кодов для интересующей игры, например, здесь - http://www.gamegenie.com/cheats/gamegenie/snes/index.html. Список читов, к примеру, для игры "Contra 3: The Alien Wars" может иметь такой вид:

22BB-AD01 Infinite lives (side-view levels)
2264-D760 Infinite bombs (side-view levels)
D9BB-AFA1 + D9CE-6D0D Start with 5 bombs on each life (side-view levels)
DBBB-AFA1 + DBCE-6D0D Start with 9 bombs on each life (side-view levels)
22BB-6F0B + 6DBB-64DB Infinite lives (top-view levels)
22B8-0766 Infinite bombs (top-view levels) 
D963-6708 + D9CE-6D0F Start with 5 bombs on each life (top-view levels)
DB63-6708 + DBCE-6D0F Start with 9 bombs on each life (top-view levels)

Далее необходимо любым доступным способом создать чит-файл (обычный текстовый файл) и наполнить его Game Genie чит-кодами в специальном формате. Далее пример такого файла для все той же игры "Contra 3: The Alien Wars":

;Infinite lives (side-view levels)
22BB-AD01

;Infinite bombs (side-view levels)
2264-D760

;Start with 5 bombs on each life (side-view levels)
D9BB-AFA1
D9CE-6D0D

;Start with 9 bombs on each life (side-view levels)
DBBB-AFA1
DBCE-6D0D

;Infinite lives (top-view levels)
22BB-6F0B
6DBB-64DB

;Infinite bombs (top-view levels) 
22B8-0766

;Start with 5 bombs on each life (top-view levels)
D963-6708
D9CE-6D0F

;Start with 9 bombs on each life (top-view levels)
DB63-6708
DBCE-6D0F

С точки с запятой начинается название чита, далее с новой строки идет запись самого кода. Обратите внимание, что некоторые читы могут состоять из нескольких кодов, записанных последовательно друг за другом каждый на новой строке. Следует иметь ввиду, что имена читов могут содержать буквы только латинского алфавита. В пакете поставки эмулятора можно найти примеры чит-файлов для некоторых игр.



Поддержка обложек картриджей
~~~~~~~~~~~~~~~~~~~~~~~~~~~~
DingooSNES умеет загружать файлы обложек картриджей. Обложка отображается во всех меню эмулятора, кроме основного меню. Файл обложки представляет собой изображение в формате PNG 24-bit с размерами 136-146 х 200 px для портретной ориентации и 200 х 136-146 px для альбомной ориентации. Файл с изображением обложки должен иметь такое же имя, как и файл игры, для которой создана обложка. Примеры обложек для некоторых игр можно найти в пакете поставки эмулятора.



Основное меню эмулятора
~~~~~~~~~~~~~~~~~~~~~~~
Resume
	Выход из меню и возврат в игру. Так же в игру можно вернуться по нажатию клавиши "B".
	
Save state
	Сохранение текущего игрового состояния в файл. Файл состояния сохраняется в той же папке, где расположена игра. Имя файла состоит из названия игры и расширения от .sv0 до .sv9. Клавишами "Left" и "Right" можно выбрать логический слот, в который будет сохраняться состояние, клавишей "A" производится сохранение. Всего доступно 10 слотов. В окошке справа отображается скриншот игрового состояния, сохраненного в выбранном слоте.
	
Load state
	Загрузка игрового состояния из файла. Файл должен располагаться в той же папке, что и игра, название должно совпадать с названием игры а расширение должно быть от .sv0 до .sv9. Сохраненные игровые состояния совместимы между собой только в пределах одной реализаций DingooSNES (или "fast" или "accurate"). Клавишами "Left" и "Right" необходимо выбрать слот с нужным игровым состоянием и по клавише "A" загрузить его. После загрузки игрового состояния эмулятор автоматически вернется в игру. Находясь на пункте "Load state" или "Save state", по нажатию на клавишу "X" можно удалить игровое состояние из выбраного слота, при этом, после подтверждения ваших намерений, удаляется соответствующий файл игрового состояния.

Cheating
	Опция активизируется после удачной загрузки файла с Game Genie чит-кодами для текущей игры. После выбора данной опции открывается меню со списком доступных Game Genie читов. Каждый чит в любое время можно включить или выключить клавишами "Left" и "Right". По нажатию клавиши "A" можно посмотреть полное имя чита. Часто бывает так, что тот или иной чит начинает действовать только после сброса игры.
	
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
	Выход из DingooSNES и возврат в меню Dingoo.



Дополнительное меню эмулятора
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
Video settings -> Double buffering
	Данная опция позволяет задать алгоритм работы двойной буферизации при выводе изображения на экран. Рекомендуется всегда выставлять опцию в значение "FAST". Если в игре наблюдаются "глюки" в изображении, вы можете попробовать выставить данную опцию в "SLOW" и сбросить игру. Опция актуальна если "Full screen" выставлено в "OFF".
	
Video settings -> Fullscreen scaling
	Данная опция позволяет задать алгоритм масштабирования изображения при выводе на экран. Значение "HARDWARE" говорит о том, что используется аппаратный блок IPU, выполняющий билинейное масштабирование изображения. Опция актуальна если "Full screen" выставлено в "ON".

Video settings -> Vertical stretch
	Данная опция позволяет отключить масштабирование изображения по вертикали. Масштабирование по вертикали выполняется, когда оригинальное разрешение по вертикали меньше 240 точек, например для NTSC игр с разрешением 256x224 точки. При отключенном масштабировании по вертикали, в конечном изображении могут присутствовать пустые черные поля, но при этом изображение в целом получается более четким. Опция актуальна если "Full screen" выставлено в "ON" и изображение выводтся на LCD экран Dingoo.
	
Video settings -> Rendering mode
	Опция позволяет выбирать между быстрым или аккуратным, но более медленным режимом рендеринга изображения во время эмуляции. Для большинства игр можно использовать режим "FAST", но если вы наблюдаете в эмуляторе явное несоответствие оригинальному изображению в игре, выставите данную опцию в "ACCURATE".
	
Sound settings -> Sample rate
	Опция позволяет задать частоту дискретизации для звукового потока, генерируемого эмулятором. Чем ниже значение, тем выше скорость эмуляции но хуже качество звука.
	
Sound settings -> Output mode
	Режим вывода звука моно или стерео. Если вы подключаете Dingoo к телевизору с моно входом для звука, имеет смысл выставить эту опцию в значение "Mono".
	
Input settings
	Данное меню позволяет задать соответствие реальных клавиш Dingoo клавишам виртуального геймпада SNES. Можно переопределить только часть клавиш, в переопределении которых есть смысл.

Input settings -> Diagonals helper
	Конструкция крестовины Dingoo весьма неудачна, нажимать ее по диагонали очень трудно, при этом точность срабатывания оставляет желять лучшего. Данная опция активирует функцию, призванную улучшить срабатывание диагональных комбинаций клавиш.
	
CPU speed, MHz
	Данная опция позволяет задать частоту работы центрального процессора Dingoo во время эмуляции игры SNES. Нормальное значение частоты работы процессора - 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". Если вы не понимаете назначения этой опции, то ее лучше держать в выключеном состоянии.
	
Save global settings
	Запись настроек эмулятора в файл "DingooSNES.cfg" в папку, где расположен сам эмулятор (как правило, это папка "GAME"). Если файл "DingooSNES.cfg" присутствует, он загружается и применяется при запуске эмулятора.
	
Save game settings
	Запись настроек эмулятора в файл с именем текущей загруженной игры и расширением .cfg, в папку с игрой. Данный файл конфигурации имеет более высокий приоритет, чем "DingooSNES.cfg" и если он присутствует для загружаемой игры, он загружается и применяется вместо "DingooSNES.cfg". Данный механизм позволяет иметь особые настройки эмулятора для конкретной игры.
	
About emulator
	Краткая информация по эмулятору, автору и горячих клавишах управления.



Дополнительное меню специальных настроек при запуске эмулятора
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
Часть редко изменяемых настроек, а так же настроек, которые должны применяться перед загрузкой ROM файла игры, вынесена в дополнительное меню специальных настроек эмулятора. Попасть в это меню можно путем удерживания клавиши "Select" во время запуска эмулятора. Для сохранения измененных настроек необходимо войти в основное меню эмулятора, перейти в "Advanced sets" и активировать "Save global settings" или "Save game settings".

Country/Region
	Данная опция позволяет задать аппаратную конфигурацию консоли в зависимости от выбранной страны/региона. Загружаемая игра может вести себя на различной аппаратной конфигурации по-разному, например, иметь разные разрешение/частоту кадров, разные тайминги аппаратных компонентов, специфическую локализацию текстов/титульных экранов, аппаратную привязку к региону и тому подобное. Значения опции и отличия в аппаратной конфигурации:

		AUTO - автоматический выбор региона на основе некоторых характеристик ROM файла
		US   - американский регион - видеостандарт - NTSC
		EU   - европейский регион  - видеостандарт - PAL
		JP   - азиатский регион    - видеостандарт - NTSC

Auto compress ROM
	Данная опция позволяет включить функцию автоматического сжатия ROM файла текущей загруженной игры при выходе из эмулятора. Если вы не хотите сжимать ROM файлы ваших SNES игр, то выставите данную опцию в "OFF".

Old school mode
	Если вы ощущаете себя матёрым волком старой игровой школы, можете выставить данную опцию в "ON" :)

Default setings
	Сброс настроек эмулятора в значения, заданные по умолчанию. Впоследствии сброшенные в начальное состояние настройки можно сохранить при помощи "Save global settings" или "Save game settings" из меню "Advanced sets".

Continue
	Выход из данного дополнительного меню с последующей загрузкой ROM файла игры и переходом DingooSNES в режим эмуляции.



Комбинации горячих клавиш в игре
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
В любой момент игры по комбинации клавиш "Start"+"Select" или "Power" вы можете войти в основное меню эмулятора. Так же во время игры можно быстро сохранить в оперативной памяти текущее игровое состояние, нажав комбинацию клавиш "R"+"Select". Загрузить состояние из памяти можно по нажатии "L"+"Start". Комбинации клавиш "L"+"R"+"Up" и "L"+"R"+"Down" позволяют увеличить или уменьшить громкость звука. "L"+"R"+"Left" переключает значение пункта настроек "Video settings -> Rendering mode". Удерживание комбинации клавиш "L"+"R"+"Right" переводит эмулятор в режим "Fast forward", позволяя ускоренно перематывать геймплей вперед. 



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



Об авторе
~~~~~~~~~
DingooSNES создан усилиями lion_rsm в 2011-2012 годах. Свои замечания, предложения и багрепорты можете оставлять на сайте http://a320.emulate.su.



История изменений
~~~~~~~~~~~~~~~~~
v1.6 - 09.10.2012
	Добавлена поддержка Game Genie чит-кодов, добавлен в главное меню пункт "Cheating".
	Незначительные изменения и улучшения в GUI.
	Добавлена поддержка отображения обложек игровых картриджей.
	Незначительные изменения и улучшения в коде.

v1.4 - 09.05.2012
	Исправлен баг в повидении OSD после загрузки игрового состояния, приводящего к смене разрешения экрана SNES.
	Опция "Video settings -> Transparency" заменена на более универсальную "Video settings -> Rendering mode".
	Изменены тексты некоторых информационных сообщений.
	Изменен формат и добавлена проверка версии файла конфигурации (*.cfg) для решения проблемы, приводившей к зависаниям эмулятора при использовании  старого несовместимого файла конфигурации.
	Изменен формат и добавлена проверка принадлежности файла игрового состояния (*.sv0 - *.sv9) эмулятору DingooSNES.
	Специальные режимы запуска эмулятора упразднены, вместо них реализована возможность попасть в дополнительное меню при запуске эмулятора.
	Добавлено дополнительное меню специальных настроек эмулятора (Extra menu), часть настроек перенесена в данное меню.
	Добавлен экспериментальный режим работы эмулятора "Old school mode" для хардкорных игроков.
	Улучшения во внешнем виде и анимации пользовательского интерфейса (теперь он еще более сексуален!).
	Масштабный рефакторинг кода, перевод эмулятора на универсальный фреймворк эмуляции.

v1.3 - 04.04.2012
	Исправлено ряд багов в работе счетчика FPS.
	Исправлен баг двойной буферизации в режиме FAST для DingooSNES.sim.fast.
	Незначительные изменения и улучшения в коде.

v1.2 - 25.03.2012:
	Опция "Auto save SRAM" удалена, теперь SRAM всегда записывается, если в этом есть потребность.
	Добавлена поддержка чипа S-DD1 (распаковка графических данных).
	Добавлен экспериментальный алгоритм "Diagonals helper".
	Добавлена опция "Vertical stretch" для управления масштабированием изображения по вертикали.
	Частота работы CPU по умолчанию выставлена в стандартные 336 МГц.
	Добавлена возможность изменения частоты CPU с шагом 1 Мгц.
	Небольшие улучшения в пользовательском графическом интерфейсе.
	Множество небольших улучшений в коде.

v1.1 - 28.02.2012:
	Опция "Auto save SRAM" перемещена в раздел "Advanced sets -> Other settings", значение по умолчанию выставлено в "ON".
	Добавлена функция "Fast forward" для быстрой перемотки эмуляции вперед (см. раздел "Комбинации горячих клавиш в игре").
	При доступе к громкости звука по комбинации клавиш вместо цифры отображается шкала громкости.
	Исправлены мелкие баги в отрисовке пользовательского интерфейса, некоторые пункты меню переименованы.
	Добавлена функция удаления по клавише "X" сохраненного игрового состояния из выбраного слота.
	Добавлена функция автоматического сжатия ROM файла при выходе из эмулятора и опция в меню для активации данной функции.
	Добавлен альтернативный режим подсчета FPS, который отображает количество виртуальных проэмулированных кадров.
	В сборку версии DingooSNES.sim.accurate добавлены новые оптимизационные флаги, повышающие быстродействие.
	Наново переписан блок, отвечающий за сохранение игровых состояний, проведен рефакторинг кода.
	Исправлен баг, при котором портились сохраненные в слоты состояния, если между двумя сохранениями в слот выполнить быстрое сохранение в память.
	Обновлена информация в документе README, добавлен некоторый арт для новостных порталов.

v1.0 - 08.02.2012:
	Первый публичный релиз.