MOONSHELL - README FILE

===================================================================================
 MoonShell Version 1.2  for Nintendo DS and Nintendo DS Lite
 Copyright (C) 2006 by Moonlight
 Readme file by JuSJo  (26.04.2006)

 Translated from the english translation by Xtreme
===================================================================================

Official website: http://mdxonline.dyndns.org/archives/nds/


Acerca de MoonShell
===================================================================================
MoonShell es un reproductor multimedia para las consolas Nintendo DS (lite).
Soporta formatos de video DPG, de audio MP3/NFS y visionado de ficheros 
JPG/Jpeg/BMP/PNG (non progressive), también soporta ficheros de texto de formato
TXT. MoonShell trabaja con ambas pantallas y soporta totalmente la pantalla 
táctil. MoonShell tiene un sistema de plug-ins que le permite añadir funcionalidad
simplemente añadiendo el plug-in en la carpeta adecuada. MoonShell también viene
con varios plug-ins de diversa utilidad.


Lo que necesitas (1-4)
===================================================================================
1) Consola
Una consola Nintendo DS o Nintendo DS Lite.

2) Dispositivos de almacenamiento
SLOT-2 (Cartucho Flash de GBA)
Adaptador de tarjetas de memoria: M3 SD (Mini SD), M3 CF, Super Card SD (Mini SD), 
Super Card CF, GBA Movie Player *, etc.
 * Necesita tener instalado el hack de firmaware de Chishm
   Download: http://tinyurl.com/h6yqg - About: http://tinyurl.com/f2ovq
.ó.
GBA (o NDS) Flash CART: G6 Flash, X-ROM, Flash 2 Advance, EZ-Flash, etc.
.ó.
SLOT-1 (Cartuchos de memoria NDS)
Adaptador de tarjetas de memoria: Neo Magic Key 2 (MK2), 
Neo Magic Key 3 (MK3 emplea tarjetas de memoria SD/MMC)


3) Software gratuito (PC/NDS)
MoonShell (download from: http://mdxonline.dyndns.org/archives/nds/)


4) Soporte para leer los dispositivos de almacenamiento
Externo: 
 - PassME/PassKey (more info: http://www.dspassme.com)
.ó.
Actualizar el firmware: 
 - FlashMe (more info: http://ds.gcdev.com/dsfirmware)
.ó.
Mediante una tarjeta WLAN: 
 - WifiMe  (more info: http://www.aaronrogers.com/nintendods/wifime.php)


Flash CART                        = GBA dispositivo para almacenar 
                                    programas/juegos
GBA                               = Game Boy Advance (SP/SP2), 
                                    Game Boy Micro
DS                                = Nintendo DS
NDS                               = Nintendo DS
NDSL or DSL                       = Nintendo DS Lite
Adaptador de tarjetas de memoria  = Este adaptador hace posible leer diferentes
                                    dispositivos de almacenamiento en la consola
SLOT-1                            = La ranura pequeña (Empleada para los juegos
                                    oficiales de DDS)
SLOT-2                            = La ranura grande (Empleada para los juegos
                                    GBA y como adaptador externo de la DS)


Arrancado el programa MoonShell (1-7)
===================================================================================
1)
Descarga el fichero moonshell.zip 
(desde: http://mdxonline.dyndns.org/archives/nds/) y descomprímelo.


2)
Configuración de MoonShell en el PC
Arranca el programa "Setup.exe" y selecciona el filesystem de la derecha
(EXFS = GBA Flash CART).
Ficheros de configuración (Configuration files)
- Si quieres, puedes eliminar ciertas cosas en la configuración como el sonido
  de arranque "startup.mp3"
Configuración del plug-in del reloj (Clock plugin settings)
- Disabled (no aparece)
- clk_analogdot (con manecillas)
- clk_analogled (digital)
- clk_chocolate (con apariencia de chocolate)
- clk_simple (apariencia simple)
- clk_vu
Fuentes por defecto de Windows (Language setting and font file)
- Codificación de lenguaje en tu idioma (example: MS100 UTF-8).
Soporte de dispositivos (ROM image)
- Esta opción es accesible si has elegido un filesystem diferente a EXFS 
  (elimina los que no necesites)


3)
Si posees un Flash CART salta al punto "4".

Puedes crear carpetas en tu dispositivo y por ejemplo organizar tus ficheros
DPG/MP3/NSF/Jpeg/BMP/PNG en estas carpetas.
Salta al punto "6".


4)
Si estas empleando un GBA Flash CART tienes que utilizar el filesystem EXFS
(más información en el punto 2). Coloca tus ficheros en la carpeta files_EXFS
y lanza el fichero CreateNDSROM_for_EXFS.bat 
(el tamaño máximo soportado es entorno a unos 30MB).


5)
Graba el fichero _BOOT_MP_gbfs.ds.gba en el (GBA/NDS) Flash CART (puede que 
necesites cambiar el nombre del fichero si lo requiere tu cartucho Flash, 
del modo ".ds.gba" -a-> ".nds").
Salta al punto "7".


6)
Guarda el fichero _BOOT_MP*.nds en la raíz de tu tarjeta de memoria CF/SD 
(Mini SD).


7)
MoonShell está preparado para ser usado. Ahora puedes disfrutar de su soporte de 
ficheros. 
Necesitas tener "FlashMe", "PassMe" o "WifiMe" para poder correr MoonShell.


Configuración de MoonShell para la DS
===================================================================================
files_EXFS\shell\  (Si empleas el filesystem EXFS)
shell\             (Si empleas otro filesystem)

Configuración del Global.ini: 

Índice 

1. [System] 
  1.1 StartPath 
  1.2 FileSelectSubScreen 
  1.3 ClosedSholderButtons 
  1.4 MusicNext 
  1.5 SoundVolume
  1.6 FullScreenOverlaySubScreen
  1.7 RTC24Hour
  1.8 FileMaxCount
  1.9 NDSLiteDefaultBrightness

2. [KeyRepeat]
  2.1 DelayCount
  2.2 RateCount

3. [BacklightTimeout]
  3.1 Backlight timeout

4. [TouchPadCalibration]
  4.1 Touchpad calibration

5. [Boot]
  5.1 hiddenAboutWindow
  5.2 hiddenHelpWindow
  5.3 hiddenDateTimeWindow
  5.4 StartupSound

6. [TextPlugin]
  6.1 SpacePixel

7. [NDSROMPlugin]
  7.1 CrashMeProtection

8. [DPGPlugin]
  8.1 Dithering
  8.2 GOPSkip
===================================================================================
1. [System] 


1.1 Startpath = //Path/to/folder  (Default = //) 

Define que fichero es mostrado en el FileBrowser después del arranque. 
Puede ser algo como '//MPCF' (para empezar navegando directamente en la CF), 
o '//GBFS' (para empezar navegando directamente en el GBFS del cartucho flash).


1.2 FileSelectSubScreen = [0|1]  (Default = 1 ) 

Define que pantalla se emplea para mostrar el FileBrowser. 
0 = pantalla táctil (inferior)
1 = pantalla normal (superior)


1.3 ClosedSholderButtons = [0|1|2]  (Default = 0) 

Define el comportamiento de los botones L y R
0 = cuando la shell está cerrada, L & R están deshabilitados
1 = cuando la shell está cerrada, L & R funcionan normalmente
2 = L & R están siempre deshabilitados


1.4 MusicNext = [0|1|2|3|4|5|6] (Default = 4) 

Define el método de reproducción de los ficheros de audio. 
0 = Reproduce el fichero seleccionado, luego para
1 = Reproduce el fichero seleccionado, continua repitiéndolo sin parar
2 = Reproduce el fichero seleccionado, y reproduce el siguiente
3 = Reproduce el fichero seleccionado, y reproduce un fichero aleatorio (shuffle) 
4 = Reproduce el fichero seleccionado, y reproduce un fichero aleatorio sin parar
5 = Reproduce el fichero seleccionado, y reproduce un fichero aleatorio y se apaga
6 = Reproduce el fichero seleccionado, luego se apaga


1.5 SoundVolume = [16=100%, 64=400%] (Default = 16)

Define el volumen del sonido. Siendo el 100% el máximo del volumen real.
Utilizando valores por encima del 100% emplea técnicas especiales para alzar el 
volumen por encima del máximo. El volumen alzado más alto posible es 400%.


1.6 FullScreenOverlaySubScreen = [0|1] (Default = 1)

Define que pantalla se emplea para reproducir el video a pantalla completa.
0 = pantalla táctil (inferior)
1 = pantalla normal (superior)


1.7 RTC24Hour [0|1] (Default = 1)

Muestra la hora.
0 = formato 12 horas con letras AM/PM
1 = formato 24 horas


1.8 FileMaxCount (Default = 256)

El máximo contador de ficheros que permite el sistema.
¡No cambies este valor a no ser que estés absolutamente seguro de lo que 
estás haciendo!


1.9 NDSLiteDefaultBrightness [0|1|2|3|4] (Default = 4)

0 = Light off
1 = Dark
2 = Bright
3 = Brightest
4 = Automatic detection


2. [KeyRepeat]


2.1 DelayCount (Default = 15)

Puedes definir después de cuanto tiempo se repetirá la acción.
1=16ms
30=500ms
60=1s


2.2 RateCount (Default = 1)

1=16ms
30=500ms
60=1s


3. [BacklightTimeout]


3.1 Backlight timeout (Defaults = WhenStandby=10, WhenPicture=15, 
    WhenText=30, WhenSound=10)

Los números e muestran en segundos. si no se tocan las teclas o la pantalla 
táctil en un tiempo definido la retroiluminación de se apagará.
WhenStandby=Cuando ningún fichero está abierto.
WhenPicture=Cuando una imagen está abierta (por ejemplo: BMP, Jpeg, etc).
WhenText=Cuando un fichero de texto está abierto.
WhenSound=Reproduciendo un fichero de audio (por ejemplo: NSF, MP3, etc).


4. [TouchPadCalibration]


4.1 Touchpad calibration (Defaults = enabled=0, xscale=0, yscale=0, 
    xoffset=0, yoffset=0)

Esto es para calibrar la pantalla táctil especialmente para Magic Key 2/3.
Utiliza 'CalibrationTool.nds' directamente desde otro adaptador GBAMP , o 
desde otro Flash CART.


5. [Boot]


5.1 hiddenAboutWindow = [0|1] (Default = 0)

Define el estado de la ventana About.
0 = Muestra la ventana About
1 = Oculta la ventana About


5.2 hiddenHelpWindow = [0|1] (Default = 0)

Define el estado de ventana Help.
0 = Muestra la ventana Help
1 = Oculta la ventana Help


5.3 hiddenDateTimeWindow = [0|1] (Default = 0)

Define el estado de ventana DateTime.
0 = Muestra la ventana DateTime
1 = Oculta la ventana DateTime


5.4 StartupSound = [0|1|2] (Default = 1)

Esto define si se reproduce un sonido o no en cuando arranque MoonShell. 
En reproducción aleatoria escogerá un archivo mp3 aleatorio de la carpeta.
0 = Sin sonido de arranque
1 = Con sonido de arranque
2 = Reproducción aleatoria de arranque


6. [TextPlugin] 


6.1 SpacePixel = [N]  (Default = 1) 

Define la distancia entre dos líneas de texto en pixeles. 
N puede ser cualquier entero dentro del rango [1..191-FontHeightInPixels]. 


7. [NDSROMPlugin]


7.1 CrashMeProtection = [0=pois, 1=päällä] (Default = 1)

El troyano malicioso de DS: 'Trojan.DSBrickA/B' puede convertir tu sistema en un 
pisapapeles inutil.
MoonShell puede chequear archivo antes de abrirlos. Solamente le lleva un segundo
el chequeo. No es recomendable eliminar está medida de seguridad.


8. [DPGPlugin]


8.1 Dithering [0|1|2] (Default = 1)

Video dithering. Intenta eliminar la pixelación del video.
0 = Sin dithering (---). Calidad original.
1 = Half dithering  (1/2). (Delay: below 200ms = full, below 400ms = half, 
    over 400ms = skip)
2 = Quarter dithering  (1/4). (Delay: below 200ms = full, below 400ms = half, 
    over 400ms = delay quarter)


8.2 GOPSkip [0|1] (Default = 1)

Cuando el video se ralentiza mucho hay un medio efectivo de prevenirlo saltando
GOPs (Group Of Pictures), no reproduce partes.
0 = salto de GOP activado
1 = salto de GOP desactivado


Para aplicar estas configuraciones tienes que lanzar el "CreateNDSROM_for_EXFS.bat"  
después de salvar los cambios. Recuerda además guardar de nuevo _BOOT_MP.nds 
en tu dispositivo.


Cambiando la apariencia del escritorio
===================================================================================
1)
Introduce los ficheros de theme en el directorio "shell".

2)
Si no tiene un filesystem EXFS , salta al punto "4".
Vuelve a crear _BOOT_MP.nds lanzando el fichero "CreateNDSROM_for_EXFS.bat".

3)
Guarda el _BOOT_MP.nds en tu dispositivo.

4)
La nueva apariencia ya está lista.

Para desarrolladores de escritorios: las imágenes BMP deben ser de 256x192 píxeles.


F.A.Q.
===================================================================================
Q: ¡MoonShell no me arranca(GBAMP)!
A: Asegúrate de que has actualizado tu GBAMP con el firmware hack de chishm y no
   te olvides que tienes que emplear bien PassMe,FlashMe o WifiMe para arrancar
   ficheros .nds desde GBAMP.

Q: Yo tengo un cartucho flash. ¿Puedo utilizar también MoonShell o es sólo para GBAMP?
A: También puedes utilizarlo. Simplemente léete el "ReadMe" de arriba.

Q: ¡Tengo una imagen Jpeg que no es capaz de mostrar! ¿Por qué?
A: 2 posible razones:   1) El reproductor de imágenes de MoonShell no soporta Jpeg
                           progresivos. Asegúrate de que no los guardas en ese modo.
                        2) Hay un límite de tamaño para los Jpegs. La anchura máxima es
                           16384 píxeles. Ficheros Jpeg de 16000 x 12800 24bitColor 40 MB
                           se ha confirmado que funcionan pero aparecen MUY despacio.


Bugs, discussion & help
===================================================================================
If you have any questions or problems with MoonShell, 
go to http://forum.gbadev.org/viewforum.php?f=20 
