//Moonshell версия 1.0 , автор Infantile Paralysiser        \\
//gbamp_cf.c, автор chishm                                    \\
//GBAMP CF I/O  test r9, автор SaTa                           \\
//Ангийский ReadMe - автор zubiac , русский ReadMe - автор Kir\\
Официальный сайт программы: http://mdxonline.dyndns.org/archives/nds/

------------------------

Функции Moonshell.

Moonshell - это многоформатный плеер/просмотрщик для Nintendo DS.
Поддерживает звуковые форматы OGG/GSM/MP3/NSF, форматы треккерной
 музыки S3M/XM/IT/MOD , видеоформат DPG, а так же графические JPG/BMP/PNG
и текстовый TXT. Moonshell использует оба экрана DS и поддерживает 
управление стилусом. Так же Moonshell поддерживает скины и плагины.

------------------------

Что потребуется для работы:

1. GBA Movie Player, с прошивкой от Chishm'а 
   (прошивку можно взять здесь: http://www.geocities.com/chishm1/gbamp/flashmp_mb.zip,
    инструкция по установке на английском http://forum.gbadev.org/viewtopic.php?t=6325)
1а. Любая GBA-флешка (если нету GBA MP).

2. Собственно, сам Moonshell v 0.999
   (брать здесь : http://mdxonline.dyndns.org/archives/nds/)

3. PassMe (http://www.dspassme.com)

3а. FlashMe (брать здесь: http://ds.gcdev.com/dsfirmware/))

3б. WiFiMe (информация на английском : http://www.aaronrogers.com/nintendods/wifime.php ,
         брать здесь : http://users.belgacom.net/bn967347/download.htm )

Примечание : Из пунктов 3, 3а, 3б нужен только один.

-------------------------

Запуск Moonshell.

Распаковать скачанный файл moonshell.zip в пустую папку на HDD. Запустить файл Setup.exe,
и следовать инструкциям, появляющимся в окне программы.


Перенос MoonShell на флэшку вручную (оставлено для совместимости со старыми версиями):

1. При использовании GBA MP / M3 :

На предварительно отформатированную CF-флешку переписать файл _BOOT_MP.nds из папки 
с распакованным архивом. После этого на CF-флешку можно записать файлы DVM/MP3/NSF/JPG/BMP/PNG/TXT.
Вставить CF-карточку в GBA MP. Вставить GBA MP в DS и загрузить при помощи PassMe, FlashMe или WiFiMe.


2. При использовании GBAшной флешки :

Открыть папку с распакованным архивом.
Скопировать ваши DVM/MP3/NSF/JPG/BMP/PNG/TXT файлы в папку 'files_gbfs'.
Запустить файл "WriteFile_gbfs.bat". Полученный в результате файл
_BOOT_MP_gbfs.ds.gba записать на вашу GBAшную флешку.
Вставить флешку в DS и загрузить Moonshell с помощью WiFiMe, FlashMe, PassMe.





-------------------------

Смена кодовой страницы для текста и имён файлов.


Сменить язык можно при установке MoonShell на флэшку, с помощью setup.exe 


---------------------------

Установки файла Global.ini : 

Содержание. 

1. [System] 
  1.1 StartPath 
  1.2 FileSelectSubScreen 
  1.3 ClosedSholderButtons 
  1.4 MusicNext 
  1.5 FullScreenOverlaySubScreen

2. [TextPlugin] 
  2.1 SpacePixel 

3. [Boot]
  3.1 hiddenAboutWindow
  3.2 hiddenHelpWindow
  3.3 hiddenDateTimeWindow


------------ 

1. [System] 



1.1 Startpath = //Path/to/folder  ( По умолчанию = // ) 

Определяет папку, которая будет показана в FileBrowser'е сразу после загрузки.
Может быть чем-то навроде '//MPCF' (корень CF-карточки), 
или '//GBFS' (содержимое папки files_gbfs ). 


1.2 FileSelectSubScreen = [0|1]  (По умолчанию = 1 ) 

Определяет, на каком экране показывать FileBrowser.
0 = тачскрин, 
1 = обычный экран. 


1.3 ClosedSholderButtons = [0|1|2]  (По умолчанию = 0 ) 

Определяет поведение кнопок L и R
0 = Когда DS закрыт, кнопки L и R отключены
1 = Когда DS закрыт, кнопки L и R включены
2 = Кнопки L и R всегда отключены

1.4 MusicNext = [0|1|2|3] (По умолчанию = 3 ) 

Определяет режим воспроизведения аудиофайлов. 
0 = Играет один файл, затем останавливается. 
1 = Бесконечное повторение файла 
2 = Играет файл, затем играет следующий 
3 = Играет файл, затем играет произвольный следующий (режим Shuffle/Random)

1.5 FullScreenOverlaySubScreen = [0|1] (По умолчанию = 1)

Определяет, на каком экране отображается видео в полноэкранном режиме.

0 = тачскрин
1 = обычный экран



2. [TextPlugin] 

2.1 SpacePixel = [N]  (По умолчанию = 1) 

Определяет межстрочный интервал в пикселях. Размер интервала должен быть не меньше 1,
и не больше (высота экрана - высота шрифта)


3. [Boot]

3.1 hiddenAboutWindow = [0|1] (По умолчанию = 0)
Определяет состояние окна About.

0 = Окно About включено
1 = Окно About выключено

3.2 hiddenHelpWindow = [0|1] (По умолчанию = 0)
Определяет состояние окна Help.

0 = Окно Help включено
1 = Окно Help выключено

3.3 hiddenDateTimeWindow = [0|1] (По умолчанию = 0)
Определяет состояние окна DateTime.

0 = Окно DateTime включено
1 = Окно DateTime выключено


Файл global.ini находится в папке \Shell  на CF/SD карте (M3/SC). Он создаётся при работе программы 
setup.exe . В старых версиях был изначально доступен в папке с распакованным Moonshell'ом.

---------------------------

Смена скина.

Просто перепишите все .BMP и .INI  файлы из директории желаемого скина в папку \shell на CF/SD карте.



Формат файла skin.ini :

[SkinInfo]

Title=SkinTitle         -     Название скина
Author=AuthorName       -     Имя автора 
LastUpdate=ГГГГ/ММ/ДД   -     Дата последнего обновления


[ColorCoordination]      

DesktopBG= nnnnnn                     \
                                       |
TitleA_Bright= nnnnnn                  |
TitleA_Dark= nnnnnn                    |
TitleA_BG= nnnnnn                      |
TitleA_Text=nnnnnn                     |
TitleA_TextShadow=nnnnnn               |
TitleD_Bright=nnnnnn                   |
TitleD_Dark=nnnnnn                     |
TitleD_BG=nnnnnn                       |
TitleD_Text=nnnnnn                     |
                                       |
ScrollBar=nnnnnn                       |
                                       |
FrameBright=nnnnnn                     |
FrameDark=nnnnnn                       |= nnnnnn - цвет в шестнадцатеричном 
                                       |           формате, RRGGBB. Если стоит
ClientBG=nnnnnn                        |           значение nnnnnn=-1, используется
ClientText=nnnnnn                      |           цвет по умолчанию для данного
                                       |           элемента интерфейса
FileSelectBG=nnnnnn                    |
FileSelectText=nnnnnn                  |
FileSelectCursor=nnnnnn                |
FileSelectPlay=nnnnnn                  |
                                       |
TextViewBG=nnnnnn                      |
TextViewText=nnnnnn                    |
                                       |
ProgressEnd=nnnnnn                     |
ProgressLast=nnnnnn                   /


[OverrideWindowRect_About]
x=N           -  изменяет координату X окна помощи на N. При N=-1 исп. значение по умолчанию.                            
y=N           -  изменяет координату Y окна помощи на N. При N=-1 исп. значение по умолчанию.                            
w=N           -  изменяет ширину окна помощи на N. При N=-1 исп. значение по умолчанию.                            
h=N           -  изменяет высоту окна помощи на N. При N=-1 исп. значение по умолчанию.                            

Такой же формат имеют следующие пункты :

[OverrideWindowRect_Help]
[OverrideWindowRect_PlayControl]
[OverrideWindowRect_FileSelect]
[OverrideWindowRect_DateTime]
[OverrideWindowRect_PicView]
[OverrideWindowRect_TextView]
[OverrideWindowRect_Progress]
[OverrideWindowRect_SetNext]
[OverrideWindowRect_FileInfo]


---------------------------

F.A.Q. (ЧаВо)

В: MoonShell не грузится!
О: Проверьте, перепрошит ли ваш GBA MP прошивкой Chishm'а. Не забудьте, что для загрузки
   вам требуется FlashMe/PassMe/WiFiMe.

В: У меня есть только простая GBA-флешка, но нету GBA MP. Могу ли пользоваться MoonShell?
О: Можете. Выше написано, как именно :)

В: Некоторые JPG-файлы не отображаются!
О: Есть 2 причины подобного поведения :
   1) Ваш JPEG-файл использует прогрессивную структуру изображения. Moonshell не поддерживает
      данную структуру изображения.

   2) Размеры изображения превосходят 16384x16384 пикселей. Тесты показали, что Moonshell
      открывает файлы 16000 x 12800 пикселей при 24-битном цвете (~40 МБайт), но делает это ОЧЕНЬ МЕДЛЕННО.

В: Как мне получить DPG-видеофайлы для MoonShell ?
О: Нужно скачать с сайта отдельный архив DPG Tools, в котором содержатся утилиты для
   перекодирования видео в/из DPG, а так же получения информации о закодированном видео.


---------------------------

При возникновении каких-либо затруднений или возникновении пожеланий,
обращайтесь по этому адресу : http://forum.gbadev.org/viewtopic.php?t=6560&start=75&postdays=0&postorder=asc&highlight=

P.S.
     Естественно, на английском языке. ;)