MOONSHELL - FILE LEGGIMI

===================================================================================
 Il software MoonShell è per Nintendo DS e Nintendo DS Lite
 Copyright (C) 2006 by Moonlight
 Readme file by Xtreme (Samtron-Translations)  (2006/06/13)

 Italian translation by Luca Panaccione (aka Tyrian³)  (2006/06/13)
===================================================================================

Sito ufficiale: http://mdxonline.dyndns.org/archives/nds/


Informazioni su MoonShell
===================================================================================
MoonShell è un lettore multimediale per Nintendo DS e DS Lite.
Supporta filmati in formato DPG, file audio MP3/NSF e visualizzazione di immagini
JPG/Jpeg/BMP/PNG (non progressive) e supporta anche file di testo TXT.
MoonShell supporta entrambi gli schermi del DS e le funzionalità del touch screen.
MoonShell ha un sistema di plug-in che permette di aggiungere altre funzionalità
semplicemente copiando i file nella relativa cartella . MoonShell è distribuito 
con alcuni plug-in utili già inclusi.


Cosa serve (1-4)
===================================================================================
1) La console
Una console Nintendo DS o Nintendo DS Lite.

2) Media
per lo SLOT-2 (alias GBA Flash CART)
Adattatore memory card: M3 SD (Mini SD), M3 CF, Super Card SD (Mini SD), 
Super Card CF, GBA Movie Player *, ecc.
 * Deve avere il firmware hack di Chishm installato
   Per scaricarlo: http://tinyurl.com/h6yqg - Informazioni: 
   http://tinyurl.com/f2ovq
.oppure.
Flash CART GBA (o NDS): G6 Flash, X-ROM, Flash 2 Advance, EZ-Flash, ecc.
.oppure.
SLOT-1 (NDS memory card)
Adattatore memory card: Neo Magic Key 2 (MK2), 
Neo Magic Key 3 (l'MK3 usa schede SD/MMC)


3) Software gratis (PC/NDS)
MoonShell (scaricabile da : http://mdxonline.dyndns.org/archives/nds/)


4) Supporti per abilitare la lettura
Esterni: 
 - PassME/PassKey (per ulteriori informazioni: http://www.dspassme.com)
.oppure.
Aggiornamento Firmware: 
 - FlashMe (per ulteriori informazioni: http://ds.gcdev.com/dsfirmware)
.oppure.
Tramite scheda di rete WLAN: 
 - WifiMe  (per ulteriori informazioni: 
   http://www.aaronrogers.com/nintendods/wifime.php)


Flash CART		= supporto scrivibile GBA per giochi/programmi
GBA			= Game Boy Advance (SP/SP2), Game Boy Micro
DS			= Nintendo DS
NDS			= Nintendo DS
NDSL or DSL		= Nintendo DS Lite
Adattatore memory card 	= Adattatore che rende possibile l'uso di diversi supporti
                          di memoria sul DS
SLOT-1                  = Lo slot piccolo del DS (usato per i giochi originali DS)
SLOT-2                  = Lo slot grande del DS (Usato per i giochi GBA e per 
                          adattatori esterni per  DS)


Avviare MoonShell (1-7)
===================================================================================
1)
Scaricare il file moonshell.zip (da: http://mdxonline.dyndns.org/archives/nds/) 
e scompattarlo.


2)
Impostazioni PC di MoonShell
Eseguire il file "Setup.exe" e selezionare il filesystem adatto (EXFS = GBA Flash 
CART).
File di configurazione (Configuration files)
- Se si vuole, è possibile rimuovere diverse cose dal setup come il suono d'avvio 
  "startup.mp3"
Impostazioni del plugin orologio (Clock plugin settings)
- Disabled       (non usato)
- clk_analogdot  (con lancette)
- clk_analogled  (con display LED)
- clk_bluemoon1  (tema Bluemoon)
- clk_bluemoon2  (tema Bluemoon)
- clk_bluemoon3  (tema Bluemoon)
- clk_bluemoon4  (tema Bluemoon)
- clk_bluemoon5  (tema Bluemoon)
- clk_chocolate  (tema Chocolate semplice)
- clk_chocolate2 (tema Chocolate avanzato)
- clk_simple     (tema testuale semplice)
- clk_vu         (tema Audio VU "Volume Unit")
Carattere predefinito di Windows (Language setting and font file)
- Codificazione testo nella propria lingua (esempio: MS100 UTF-8).
Supporto dispositivi (ROM image)
- Questa opzione appare solo se si sceglie un filesystem diverso da EXFS
  (eliminare ciò che non è necessario)


3)
Se si ha una Flash CART passare al punto "4".

Si possono creare delle cartelle sulla propria scheda di memoria e 
per esempio mettere i propri file DPG/MP3/NSF/Jpeg/BMP/PNG nelle 
varie cartelle.
passare al punto "6".


4)
Se si usa una Flash CART GBA si deve selezionare il filesystem EXFS (maggiori
informazioni al punto 2). Mettere i propri file nella cartella files_EXFS ed
eseguire il file CreateNDSROM_for_EXFS.bat (la dimensione massima supportata
è di circa 30MB).


5)
Fleshare il file _BOOT_MP_gbfs.ds.gba nella (GBA/NDS) Flash CART (potrebbe 
essere necessario rinominare il file se la propria Flash CART lo richiede,
ad esempio da ".ds.gba" -a-> ".nds").
passare al punto "7".


6)
Salvare il file _BOOT_MP*.nds nella cartella principale (root) della propria scheda
CF/SD (Mini SD).


7)
MoonShell è ora pronto per essere usato. Adesso si possono sfruttare tutte le sue
funzionalità.
E' necessario avere il "FlashMe", "PassMe" o "WifiMe" installato per avviare 
MoonShell.


Impostazioni DS di MoonShell
===================================================================================
files_EXFS\shell\  (quando si usa il filesystem EXFS)
shell\             (quando si usa un altro filesystem)

Configurazione del file Global.ini: 

Indice 

1. [System] 
   1.1  StartPath 
   1.2  FileSelectSubScreen 
   1.3  ClosedSholderButton 
   1.4  MusicNext 
   1.5  SoundVolume
   1.6  FullScreenOverlaySubScreen
   1.7  FileMaxCount
   1.8  NDSLiteDefaultBrightness
   1.9  WhenPanelClose
   1.10 TopScreenFlip

2. [HiddenItem]
   2.1 Attribute_Archive
   2.2 Attribute_Hidden
   2.3 Attribute_System
   2.4 Attribute_Readonly
   2.5 Path_Shell
   2.6 File_Thumbnail

3. [KeyRepeat]
   3.1 DelayCount
   3.2 RateCount

4. [BacklightTimeout]
   4.1 WhenStandby
   4.2 WhenPicture
   4.3 WhenText
   4.4 WhenSound

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

6. [Thumbnail]
   6.1 Mode
   6.2 SelectItemAlpha
   6.3 UnselectItemAlpha

7. [TextPlugin]
   7.1 SpacePixel

8. [NDSROMPlugin]
   8.1 CrashMeProtection

9. [DPGPlugin]
   9.1 Dithering
   9.2 GOPSkip
   9.3 AdaptiveDelayControl
   9.4 BlockGSMAudio

10. [ImagePlugin]
  10.1 GUITimeOutSec
  10.2 ImageMode
  10.3 DrawFileInfo
  10.4 VerticalPadding

11. [ClockPlugin]
  11.1 Enabled
  11.2 RTC24Hour
  11.3 FormatDate
===================================================================================
1. [System] 


1.1 StartPath = [//Percorso/della/cartella] (Predefinito = //AUTO) 

Definisce quali cartelle visualizzare nel FileBrowser dopo l'avvio. 
Può essere tipo '//MPCF' (per partire navigando direttamente nella scheda CF), 
o '//GBFS' (per partire navigando direttamente dalla GBFS della flashcart).


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

Definisce quale schermo viene usato per visualizzare il FileBrowser. 
0 = touch screen (inferiore)
1 = schermo normale (superiore)


1.3 ClosedSholderButton = [0|1|2|3] (Predefinito = 0) 

Definisce il comportamento dei pulsanti L ed R
0 = quando il coperchio del DS è chiuso, L & R sono disattivati
1 = quando il coperchio del DS è chiuso, L & R funzionano normalmente
2 = I pulsanti L & R sono sempre disattivati
3 = I pulsanti L & R sono sempre attivati

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

Definisce la modalità di riproduzione dei file audio. 
0 = Riproduce il file selezionato, poi si ferma
1 = Riproduce il file selezionato, continuamente all'infinito (repeat)
2 = Riproduce il file selezionato, poi riproduce il file successivo
3 = Riproduce il file selezionato, poi riproduce un altro file a caso (shuffle) 
4 = Riproduce il file selezionato, poi riproduce un altro file a caso continuamente
5 = Riproduce il file selezionato, poi riproduce un altro file a caso e si spegne
6 = Riproduce il file selezionato, poi si spegne


1.5 SoundVolume = [0 - 64] (Predefinito = 16)

Definisce il volume dell'audio. L'impostazione 100% è il massimo volume reale.
Impostando oltre il 100% il programma usa tecniche speciali per aumentare il volume
oltre il livello massimo. Il volume aumentato il più possibile è al 400%.
0  = Muto
1  =   6%
16 = 100%
64 = 400%


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

Definisce quale schermo è usato per riprodurre video a tutto schermo
0 = touch screen (inferiore)
1 = schermo normale (superiore)


1.7 FileMaxCount = [N] (Predefinito = 256)

Il massimo numero di file che il filesystem consente.
Non cambiare questo valore se non si è assolutamente sicuri di cosa si stia facendo!


1.8 NDSLiteDefaultBrightness = [0|1|2|3|4] (Predefinito = 4)

0 = Molto scuro
1 = Scuro
2 = Chiaro
3 = Chiarissimo
4 = Rilevazione automatica


1.9 WhenPanelClose = [0|1] (Predefinito = 0)

Azione da eseguire alla chiusura del coperchio DS.
0 = Spegnimento illuminazione schermi
1 = Spegnimento del DS


1.10 TopScreenFlip = [0|1|2|3] (Predefinito = 0)

Rotazione dell'immagine nello schermo superiore.
0 = Normale (nessuna rotazione)
1 = Rotazione di 180°
2 = Rotazione verticale (capovolgimento)
3 = Rotazione orizzontale (effetto specchio)


2. [HiddenItem]


Queste impostazioni hanno effetto solo con il filesystem FAT.


2.1 Attribute_Archive = [0|1] (Predefinito = 0)

Nascondi tutti i file.
0 = Mostra
1 = Nascondi


2.2 Attribute_Hidden = [0|1] (Predefinito = 1)

Nascondi i file con attributo "nascosto".
0 = Mostra
1 = Nascondi


2.3 Attribute_System = [0|1] (Predefinito = 1)

Nascondi file di sistema.
0 = Mostra
1 = Nascondi


2.4 Attribute_Readonly = [0|1] (Predefinito = 0)

Nascondi file di sola lettura.
0 = Mostra
1 = Nascondi


2.5 Path_Shell = [0|1] (Predefinito = 0)

Nascondi la cartella "shell" di Moonshell.
0 = Mostra
1 = Nascondi


2.6 File_Thumbnail = [0|1] (Predefinito = 1)

Nascondi i file thumbnail di Moonshell.
0 = Mostra
1 = Nascondi


3. [KeyRepeat]


3.1 DelayCount = [1|30|60] (Predefinito = 15)

E' possibile definire dopo quanto tempo l'azione verrà ripetuta.
1  = 16ms
30 = 500ms
60 = 1s


3.2 RateCount = [1|30|60] (Predefinito = 1)

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


4. [BacklightTimeout]


4.1 WhenStandby = [N] (Predefinito = 10)

I valori sono espressi in secondi. Se non si toccano i pulsanti o il touch screen
per un certo tempo in modalità standby (quando non è aperto nessun file), la 
retroilluminazione degli schermi si spegnerà.


4.2 WhenPicture = [N] (Predefinito = 15)

I valori sono espressi in secondi. Se non si toccano i pulsanti o il touch screen
per un certo tempo quando un file immagine è aperto, la retroilluminazione degli
schermi si spegnerà.


4.3 WhenText = [N] (Predefinito = 30)

I valori sono espressi in secondi. Se non si toccano i pulsanti o il touch screen
per un certo tempo quando un file di testo è aperto, la retroilluminazione degli
schermi si spegnerà.


4.4 WhenSound = [N] (Predefinito = 10)

I valori sono espressi in secondi. Se non si toccano i pulsanti o il touch screen
per un certo tempo durante la riproduzione di un file audio, la retroilluminazione
degli schermi si spegnerà.


5. [Boot]


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

Deinisce lo stato della finestra "About".
0 = la finestra viene mostrata
1 = la finestra è nascosta


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

Definisce lo stato della finestra "Help".
0 = la finestra viene mostrata
1 = la finestra è nascosta


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

Definisce lo stato della finestra "Datetime".
0 = la finestra viene mostrata
1 = la finestra è nascosta


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

Questa opzione definisce se quando parte MoonShell verrà riprodotto il suono di 
avvio. Con "suono d'avvio casuale" verrà riprodotto un mp3 preso a caso dalla 
cartella.
0 = Suono d'avvio disattivato
1 = Suono d'avvio attivato
2 = Suono d'avvio casuale


6. [Thumbnail]


6.1 Mode = [0|1|2|3] (Predefinito = 3)

Impostazioni anteprima in riquadri e a tutto schermo.
0 = Anteprima disattivata
1 = Solo anteprima in riquadri
2 = Solo anteprima a tutto schermo
3 = Anteprima sia in riquadri sia a tutto schermo


6.2 SelectItemAlpha = [0 - 16] (Predefinito = 16)

Trasparenza dell'anteprima in riquadro selezionata.
0  = 0%
8  = 50%
16 = 100%


6.3 UnselectItemAlpha = [0 - 16] (Predefinito = 10)

Trasparenza dell'anteprima in riquadro non selezionata.
0  = 0%
8  = 50%
16 = 100%


7. [TextPlugin] 


7.1 SpacePixel = [N]  (Predefinito = 1) 

Definisce la distanza fra due righe di testo espressa in pixel. 
N può essere qualsiasi numero intero compreso tra i valori 
[1..191-AltezzaFontInPixel]. 


8. [NDSROMPlugin]


8.1 CrashMeProtection = [0|1] (Predefinito = 1)

Protezione contro un pericoloso Trojan DS: il "Trojan.DSBrickA/B" può ridurre una 
console Nintendo DS ad un inutile pezzo di plastica. MoonShell può controllare 
i file prima di aprirli, il controllo porta via solo un secondo per essere 
effettuato.
E' sconsigliato disattivare questa protezione.
0 = Protezione disattivata
1 = Protezione attivata


9. [DPGPlugin]


9.1 Dithering = [0|1|2] (Predefinito = 1)

Video dithering. Prova a rimuovere l'aspetto "pixelloso" del video.
0 = Nessun dithering. Qualità originale.
1 = Dithering medio (1/2). (Ritardo: sotto 200ms = full, sotto 400ms = half, 
    oltre 400ms = skip)
2 = Dithering ad un quarto (1/4). (Ritardo: sotto 200ms = full, sotto 400ms = half, 
    oltre 400ms = delay quarter)
3 = Dithering forte. (Ritardo: sotto 100ms = full, sotto 200ms = half, 
    sotto 300ms = quarter, oltre 300ms = skip)


9.2 GOPSkip = [0|1] (Predefinito = 1)

Quando il video rallenta molto c'è un modo efficace per prevenire che ciò accada 
saltare i GOP (Group Of Pictures = Gruppi di Immagini).
0 = Salto GOP disattivato
1 = Salto GOP attivato


9.3 AdaptiveDelayControl = [0|1] (Predefinito = 1)

Scegliere il valore di massima priorità per il controllo dei fotogrammi.
0 = Riproduzione video (come massima priorità)
1 = Sincronizzazione audio/video (come massima priorità)


9.4 BlockGSMAudio = [0|1] (Predefinito = 1)

Blocco audio in formato GSM. Questo è il formato usato dalle vecchie versioni 
dell'encoder DPG. L'uso del decoder GSM (con ARM7) non è stabile.
0 = Consenti
1 = Blocca


10. [ImagePlugin]


10.1 GUITimeOutSec = [N] (Predefinito = 2)

Quando il periodo di tempo espresso in secondi scade, la barra del titolo e quella
di scorrimento scompaiono dalla finestra dell'immagine.
N = Qualsiasi numero espresso in secondi


10.2 ImageMode = [0|1] (Predefinito = 0)

Per visualizzare le immagini si può usare la modalità schermo singolo o doppio 
schermo. La modalità doppio schermo ha un supporto limitato.
0 = Modalità schermo singolo
1 = Modalità doppio schermo


10.3 DrawFileInfo = [0|1] (Predefinito = 1)

Le informazioni sul file, se predenti, saranno mostrate nella GUI di programma.
0 = Nascondi informazioni
1 = Mostra informazioni


10.4 VerticalPadding = [N] (Predefinito = 96)

La dimensione dello spazio tra schermo superiore ed inferiore può essere impostata 
quando si usa la modalità doppio schermo. (valore: ImageMode=1).


11. [ClockPlugin]


11.1 Enabled = [0|1] (Predefinito = 1)

Visualizzazione del plug-in orologio.
0 = Nascondi
1 = Mostra


11.2 RTC24Hour = [0|1] (Predefinito = 1)

Definisce il formato dell'ora.
0 = formato 12 ore con specificazione AM/PM
1 = formato 24 ore


11.3 FormatDate = [value] (Predefinito = YYYY/MM/DD)

Definisce il formato di visualizzazione della data. La lunghezza massima è di 32 
caratteri. Nell'esempio seguente, l'anno(Y) è 2001, il mese(M) è 2 ed il giorno(D)
è 3. 
Usando il codice dei valori verrà visualizzato: 
YYYY (2001), YY (01), MM (02), M (2), DD (03), D (3)
Quindi usando il codice: YYYY/MM/DD  la data sarà visualizzata come: 2001/02/03
Possono essere usati diversi caratteri come separatori: , - . /



Per applicare queste impostazioni, avviare il file "CreateNDSROM_for_EXFS.bat" 
dopo aver salvato le modifiche.
Ricordarsi poi di aggiornare il file _BOOT_MP.nds scrivendolo di nuovo sulla 
propria scheda di memoria.


Cambiare tema del desktop
===================================================================================
1)
Estrarre i file dei temi nella cartella "shell".

2)
Se non si usa il filesystem EXFS passare al punto "4".
Creare di nuovo il file _BOOT_MP.nds eseguendo il file "CreateNDSROM_for_EXFS.bat".

3)
Fleshare/scrivere il file _BOOT_MP.nds sulla propria scheda di memoria.

4)
Il tema è pronto per essere visualizzato.

Per i creatori di temi: l'immagine BMP deve essere di 256x192 pixel.


F.A.Q. - Domande Frequenti
===================================================================================
Domanda: MoonShell non parte (GBAMP)!
Risposta: Assicurarsi di aver aggiornato il firmware del proprio GBAMP con il 
          firmware hack di chishm e non dimenticarsi che è necessario usare un 
          PassMe,FlashMe o WifiMe per eseguire i file .nds dal GBAMP.

D: Ho una flash cart. Posso usare anche io Moonshell o è solo per GBAMP?
R: Puoi usarlo, consulta questo file "ReadMe" (leggimi) dall'inizio.

D: Ho un'immagine Jpeg che non viene visualizzata! Perchè?
R: 2 possibili cause:  1) Il visualizzatore immagini di MoonShell non supporta 
                          immagini Jpeg progressive
                          Assicurarsi che l'immagine non sia salvata come tale.
                       2) C'è un limite di dimensioni per i file Jpeg. 
                          La larghezza massima consentita è di 16384 pixel. I file
                          Jpeg 16000 x 12800, Colore 24bit, 40 MB sono confermati
                          come funzionanti ma appaiono sullo schermo MOLTO
                          lentamente.


Problemi, discussione & aiuto
===================================================================================
Per domande, o in caso di problemi con Moonshell, 
andare su http://forum.gbadev.org/viewforum.php?f=20 