MOONSHELL - FILE LEGGIMI

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

 Italian translation by Tyrian³  (2006/09/02)
===================================================================================

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: EWIN 2 SD/Mini SD/Micro SD, EZ-Flash IV (Mini SD), 
GBA Movie Player (CF)*, M3 CF/SD/Mini SD/Micro SD, Max Media CF, 
Super Card CF/SD/Micro SD ecc.

 * Deve avere il firmware hack di Chishm installato
   Per informazioni e download: http://tinyurl.com/myg7l 
   o http://shorl.com/dogrostuhadrine
.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 drive di destinazione (dove si vuole 
installare MoonShell)
Nota: EXFS = GBA Flash Cart, Lettera unità=adattatore scheda di memoria
tool for developers (strumenti per gli sviluppatori)

File di configurazione (Configuration files)
- Se si vuole, è possibile rimuovere diverse cose dal setup come il suono d'avvio 
  "startup.mp3" e quello di chiusure "shutdown.mp3" se non se ne ha bisogno.
- Resume function is effective. (si può abilitare la funzione resume-riprendi)

Clock plugin settings (Impostazioni del plugin orologio)
- The settings is updated and copied. (Enable clock plug-in)
- Preview (Anteprima)
[ Disabled       (disabilitato-nessun tema usato)
[ clk_analogdot  (Orologio a lancette)
[ clk_analogled  (Orologio con 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")

Language setting and font file. (Scegliere la codifica testo usata nella propria 
Nazione)
- The setting is updated and copied (Applica e salva le impostazioni)
- All languages set are displayed. (Tutte le codifiche sono mostrate in lista)
[MS0    (Ank)
[MS100  (UTF-8)
[MS110  (UTF-8 Big)
[CP874  (Thai)
[CP932  (Japanese Shift-JIS)
[CP9322 (Japanese Shift-JIS)
[CP9323 (Japanese Shift-JIS, Fixed size)
[CP9324 (Japanese Shift-JIS, Arial Unicode)
[CP9325 (Japanese Shift-JIS, Arial Unicode, Fixed size)
[CP936  (Simplified Chinese GBK)
[CP9362 (Simplified Chinese GBK)
[CP949  (Korean)
[CP950  (Traditional Chinese Big5)
[CP9502 (Traditional Chinese Big5)
[CP1250 (Central Europe)
[CP1251 (Cyrillic)
[CP1252 (Latin I)
[CP1253 (Greek)
[CP1254 (Turkish)
[CP1255 (Hebrew)
[CP1256 (Arabic)
[CP1257 (Baltic)
[CP1258 (Vietnam)

ROM image (Scegliere il dispositivo usato)
- Questa opzione è disponibile solo se si è scelto un filesystem diverso da EXFS. 
  Cancellare le voci non necessarie.


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\moonshl\ (quando si usa il filesystem EXFS)
moonshl\            (quando si usa un altro filesystem)

Configurazione del file moonshl.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
   7.2 ScrollType
   7.3 SelectDisplay

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
  10.5 Interpolation

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|2] (Predefinito = 0)

Azione da eseguire alla chiusura del coperchio DS.
0 = Spegnimento illuminazione schermi
1 = Spegnimento del DS
2 = Riproduzione file "moonshl/shutdown.mp3" e 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]. 


7.2 ScrollType = [0|1] (Predefinito = 0)

Metodo usato per lo scorrimento delle pagine di testo.
0  = Normale
1  = Pagina intera


7.3 SelectDisplay [0|1] (Default = 0)

Seleziona lo schermo sul quale visualizzare il testo.
0 = Touch screen (inferiore)
1 = Schermo normale (superiore)


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).


10.5 Interpolation = [0|1] (Predefinito = 1)

Metodo di interpolazione (supplementazione) usato per ingrandire le immagini.
La modalità doppio schermo può essere usata solo con il metodo Hardware.
0 = Hardware
1 = Software (interpolazione bilineare)


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 "moonshl".

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 ਍