MOONSHELL - LUEMINUT TIEDOSTO

===================================================================================
 MoonShell ohjelmisto on Nintendo DS ja Nintendo DS Lite -pelikonsoleille
 Copyright (C) 2006 by Moonlight
 Readme file by Xtreme (Samtron-Translations)  (2006/06/13)

 Finnish translation by Sami Koivisto / Samtron-Translations  (2006/06/13)
===================================================================================

virallinen sivusto: http://mdxonline.dyndns.org/archives/nds/


Tietoa ohjelmasta
===================================================================================
MoonShell on multimediatoistin Nintendo DS (Lite) -pelikonsolille.
Se tukee DPG-videotiedostojen toistamista, MP3/NSF äänitiedostoja ja 
JPG/Jpeg/BMP/PNG (ei progressiivisten) kuvien katselemista, sekä TXT-tiedostojen 
lukemista. MoonShell tukee molempia näyttöjä, sekä kosketusnäytön ominaisuuksia.
MoonShell-ohjelma tukee lisäosia ja niitä voidaan lisätä rajattomasti, joka 
laajentaa tuettujen tiedostojen määrää. Ohjelman mukana tulee suuri määrä 
lisäosia, jotka ovat valmiina käytettäväksi.


Tarvittavat asiat (1-4)
===================================================================================
1) Pelikonsoli
Nintendo DS, tai Nintendo DS Lite -pelikonsoli.

2) MEDIA
SLOT-2 (ns. GBA tallennusmedia)
Muistikorttiadapteri: M3 SD (Mini SD), M3 CF, Super Card SD (Mini SD), 
Super Card CF, GBA Movie Player *, tms.
 * Jossa Chishm'n firmware hack
   Lataa: http://tinyurl.com/h6yqg - Lisätietoa: http://tinyurl.com/f2ovq
.tai.
GBA (tai NDS) tallennuskasetti (Flash CART): G6 Flash, X-ROM, Flash 2 Advance, 
EZ-Flash, tms.
.tai.
SLOT-1 (NDS tallennusmedia)
Muistikorttiadapteri: Neo Magic Key 2 (MK2), 
Neo Magic Key 3 (MK3 käyttää SD/MMC tallennusmediaa)


3) Ilmainen ohjelmistopaketti (PC/NDS)
MoonShell (lataa osoitteesta: http://mdxonline.dyndns.org/archives/nds/)


4) Tuki ulkoisen median lukemiselle
Erillinen laite: 
 - PassME/PassKey (lisää tietoa osoitteesta: http://www.dspassme.com)
.tai.
Ohjelmistopäivitys: 
 - FlashMe (lisää tietoa osoitteesta: http://ds.gcdev.com/dsfirmware)
.tai.
WLAN-kortin avulla: 
 - WifiMe  (lisää tietoa osoitteesta: 
            http://www.aaronrogers.com/nintendods/wifime.php)


Flash CART           = GBA tallennusmedia
GBA                  = Game Boy Advance (SP/SP2), Game Boy Micro
DS                   = Nintendo DS
NDS                  = Nintendo DS
NDSL tai DSL         = Nintendo DS Lite
Muistikorttiadapteri = Adapteri, jonka avulla DS -konsolissa voi käyttää erilaisia 
                       tallennusmedioita
SLOT-1               = DS:n pienempi aukko medialle (Nintendo DS tallennusmedia, 
                       jolla esim julkaistaan DS-pelit)
SLOT-2               = DS:n alempi iso aukko (GBA tallennusmedia, jolla 
                       julkaistaan GBA-pelit, sekä DS:n lisälaitteet)


MoonShell-ohjelman käynnistäminen (1-7)
===================================================================================
1)
Lataa moonshell.zip -tiedosto (osoitteesta: 
http://mdxonline.dyndns.org/archives/nds/) ja pura pakkaus erillisellä 
pakkausohjelmalla (Lisätietoa: www.7-Zip.org).


2)
MoonShell PC-asetukset
Käynnistä "Setup.exe" ja valitse tiedostojärjestelmä (EXFS = GBA tallennuskasetti).
Asetustiedostot (Configuration files)
- Voit jättää pois erillisiä ohjelman osia, kuten "startup.mp3" aloitusäänen
Kello-lisäosan asetukset (Clock plugin settings)
- Disabled       (Teema ei ole käytössä)
- clk_analogdot  (Analoginen kello lumisade-teemalla)
- clk_analogled  (Analoginen LED-kello -teema)
- clk_bluemoon1  (Bluemoon -teema)
- clk_bluemoon2  (Bluemoon -teema)
- clk_bluemoon3  (Bluemoon -teema)
- clk_bluemoon4  (Bluemoon -teema)
- clk_bluemoon5  (Bluemoon -teema)
- clk_chocolate  (Yksinkertainen chocolate-teema)
- clk_chocolate2 (Paranneltu chocolate-teema)
- clk_simple     (Yksinkertainen tekstipohjainen teema)
- clk_vu         (Audio VU "Volume Unit" teema)
Windowsin käyttämä kieli (Language setting and font file)
- Oman kielesi merkistöä vastaava koodisivu (esim MS100 UTF-8).
Mediatuki (ROM image)
- Jos valitsit muun, kuin EXFS, näkyy lista tuetuista tiedostojärjestelmistä 
  (poista tarpeettomat)


3)
Jos sinulla on GBA-tallennuskasetti, siirry kohtaan "4".

Voit luoda DS-tallennusmediallesi kansioita ja tallentaa niihin 
esim DPG/MP3/NSF/Jpeg/BMP/PNG -mediatiedostoja.
Siirry kohtaan "6".


4)
Jos käytössä on GBA-tallennuskasetti, täytyy sinun käyttää 
EXFS-tiedostojärjestelmää (asetukset kohdassa 2).
Sijoita tiedostot files_EXFS -kansioon ja käynnistä 
CreateNDSROM_for_EXFS.bat -tiedosto (maks. kokoraja n. 30Mt).


5)
Tallenna _BOOT_MP_gbfs.ds.gba tiedosto (GBA/NDS) tallennuskasetille (voit joutua 
uudelleennimeämään sen joillekin kaseteille, esim G6-kasetilla ".ds.gba" -> ".nds").
Siirry ohjeen kohtaan "7".


6)
Tallenna _BOOT_MP*.nds -tiedosto CF tai SD (Mini SD) -muistikorttisi 
juurihakemistoon.


7)
MoonShell on nyt tallennettu mediallesi ja voit nauttia sen monipuolisista 
ominaisuuksista. Jokin seuraavista täytyy olla asennettuna laitteeseen, jotta voit 
käynnistää Moonshell-ohjelman: "FlashMe", "PassMe" tai "WifiMe".


MoonShell DS-asetukset
===================================================================================
files_EXFS\shell\  (Kun käytät EXFS -tiedostojärjestelmää)
shell\             (Kun käytät jotain muuta tiedostojärjestelmää)

Global.ini asetukset: 

Osiot 

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 = [//kansion/polku] (Oletus = //AUTO) 

Määrittää tiedostoselaimessa käynnistymisen jälkeen näkyvän kansion.
Voi olla esim. '//AUTO' '//IMFS' '//IMFS/.shell' '//MPCF' '//MPCF/images/jpg' 
'//GBFS' jne.


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

Määrittää kummassa näytössä tiedostoselain näytetään.
0 = kosketusnäyttö (alempi näyttö)
1 = tavallinen näyttö (ylempi näyttö)


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

Määrittää L ja R -hartianäppäinten toiminnan.
0 = kun DS-simpukka on suljettu, L & R ovat pois käytöstä
1 = kun DS-simpukka on suljettu, L & R toimivat normaalisti
2 = L & R näppäimet ovat pysyvästi pois käytöstä
3 = L & R näppäimet ovat aina käytössä


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

Määrittää äänitiedoston toistoasetuksen.
0 = Toista valittu ja lopeta
1 = Toista valittu ja jatka toistamalla sitä päättymättömästi
2 = Toista valittu ja jatka tiedostojen toistamista päättymättömästi
3 = Toista valittu ja jatka listan loppuun asti ja sammuta DS
4 = Toista valittu ja jatka toistamalla sattumanvaraisesti päättymättömästi
5 = Toista valittu ja jatka toistamalla kaikki sattumanvaraisesti ja sammuta DS
6 = Toista valittu ja sammuta DS


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

Määrittää äänenvoimakkuuden. Asetuksella 100% saavutetaan maksimi äänenvoimakkuus. 
Asettaessa äänenvoimakkuudeksi yli 100% käytetään erityistä tehostuskeinoa 
äänen lisäämiseksi. Suurin mahdollinen tehostettu äänenvoimakkuus on 400%.
0  = Äänetön
1  =   6%
16 = 100%
64 = 400%


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

Määrittää kumpi näytöistä toistaa videokuvaa koko ruudulla.
0 = Kosketusnäyttö (alempi näyttö)
1 = Tavallinen näyttö (ylempi näyttö)


1.7 FileMaxCount = [Numero] (Oletus = 256)

Tiedostojärjestelmän suurin sallima tiedostojen määrä.
Älä muuta tätä arvoa, ellet ole täysin varma sen merkityksestä!


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

0 = Himmein
1 = Himmeä
2 = Kirkkaampi
3 = Kirkkain
4 = Automaattinen tunnistus


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

Toiminto, kun DS:n simpukka suljetaan.
0 = Näyttöjen taustavalot pois päältä
1 = Sammuta DS:n virta


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

Ylemmän näytön kuvan kääntäminen.
0 = Normaali (ei kääntämistä)
1 = 180 astetta
2 = Pystysuunnassa (ylösalaisin)
3 = Vaakasuunnassa (peilikuva)


2. [HiddenItem]


Nämä asetukset ovat käytössä vain FAT -tiedostojärjestelmällä.


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

Piilota kaikki tiedostot.
0 = Näytä
1 = Piilota


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

Piilota tiedostot, jotka on määritetty piilotiedostoiksi.
0 = Näytä
1 = Piilota


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

Piilota järjestelmätiedostot.
0 = Näytä
1 = Piilota


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

Piilota tiedostot, jotka on määritetty vain lukukäyttöön.
0 = Näytä
1 = Piilota


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

Piilota MoonShell "shell" kansio.
0 = Näytä
1 = Piilota


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

Piilota MoonShell esikatselukuvien data-tiedostot.
0 = Näytä
1 = Piilota


3. [KeyRepeat]


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

Voit määrittää ajan, jonka jälkeen sama toiminto toistetaan.
1  = 16ms
30 = 500ms
60 = 1s


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

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


4. [BacklightTimeout]


4.1 WhenStandby = [Numero] (Oletus = 10)

Numeron yksikkö on sekuntia. Jos et koske näppäimiin, tai kosketusnäyttöön 
määritettynä aikana, kun mitään tiedostoa ei ole avattuna, taustavalot sammuvat.


4.2 WhenPicture = [Numero] (Oletus = 15)

Numeron yksikkö on sekuntia. Jos et koske näppäimiin, tai kosketusnäyttöön 
määritettynä aikana, kun kuvatiedosto on avattuna, taustavalot sammuvat.


4.3 WhenText = [Numero] (Oletus = 30)

Numeron yksikkö on sekuntia. Jos et koske näppäimiin, tai kosketusnäyttöön 
määritettynä aikana, kun tekstitiedosto on avattuna, taustavalot sammuvat.


4.4 WhenSound = [Numero] (Oletus = 10)

Numeron yksikkö on sekuntia. Jos et koske näppäimiin, tai kosketusnäyttöön 
määritettynä aikana toistaessa äänitiedostoa, taustavalot sammuvat.


5. [Boot]


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

Määrittää About -ikkunan tilan.
0 = About -ikkuna näkyvillä
1 = About -ikkuna ei näy


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

Määrittää Help -ikkunan tilan.
0 = Help -ikkuna näkyvillä
1 = Help -ikkuna ei näy


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

Määrittää DateTime -ikkunan tilan.
0 = DateTime -ikkuna näkyvillä
1 = DateTime -ikkuna ei näy


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

Tässä kohdassa määritetään käynnistysäänen kuuluminen. Sattumanvarainen 
käynnistysääni valitsee kansiosta jonkin äänen sattumanvaraisesti.
0 = Käynnistysääni pois päältä
1 = Käynnistysääni päällä
2 = Sattumanvarainen käynnistysääni


6. [Thumbnail]


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

Esikatselukuvien ja koko ruudun esikatselutilan valinta.
0 = Pois päältä
1 = Vain esikatselukuvat
2 = Vain koko ruudun esikatselutila
3 = Esikatselukuvat ja koko ruudun esikatselutila


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

Valitun esikatselukuvan läpinäkyvyys.
0  = 0%
8  = 50%
16 = 100%


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

Valitsemattomien esikatselukuvien läpinäkyvyys.
0  = 0%
8  = 50%
16 = 100%


7. [TextPlugin] 


7.1 SpacePixel = [Numero]  (Oletus = 1) 

Määrittää kahden tekstirivin välisen etäisyyden pikseleinä. 
"Numero" voi olla arvo välillä [1..191]. 


8. [NDSROMPlugin]


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

DS tuholaisohjelma: 'Trojan.DSBrickA/B' voi tehdä laitteesi käyttökelvottomaksi.
MoonShell voi tarkistaa tiedostot niitä avatessa. Vie vain sekunnin tarkistaa
tiedosto. On suositeltavaa asettaa tämä tarkistus päälle.
0 = Suojaus pois päältä
1 = Suojaus päällä


9. [DPGPlugin]


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

Videokuvan suodatus. Poistaa pikselimäisyyttä kuvasta.
0 = Ei suodatusta (---). Alkuperäinen laatu.
1 = Puolikas suodatusteho  (1/2). (Viive: alle 200ms = täysi, 
    alle 400ms = puolikas, yli 400ms = ohita)
2 = Neljäsosa suodatusteho  (1/4). (Viive: alle 200ms = täysi, 
    alle 400ms = puolikas, yli 400ms = neljäsosa)


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

Kun video hidastelee liian paljon, käytetään synkronointitekniikkaa, jossa 
hypätään GOP:sta toiseen. GOP on MPEG termi, joka tarkoittaa kuvasarjaa (Group Of 
Pictures).
0 = Synkronointiasetus pois päältä
1 = Synkronointiasetus päällä


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

Videokuvan ohjauksen tärkeysasteen määrittäminen.
0 = Videonkuvan toisto (tärkeimmälle sijalle)
1 = Äänen ja videokuvan synkronointi (tärkeimmälle sijalle)


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

GSM audion toistaminen torjutaan. Tätä äänimuotoa käytettiin vanhassa DPG 
enkooderissa. GSM dekooderin toiminta (ARM7 suorittimella) on epävakaa.
0 = Salli
1 = Estä


10. [ImagePlugin]


10.1 GUITimeOutSec = [Numero] (Oletus = 2)

Kun määrätty aika kuluu, selauspalkki ja otsikkopalkki katoavat kuvan ikkunasta.
Numero = Mikä tahansa numero (sekuntia)


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

Kuvien esittämiseen voidaan käyttää yhtä tai kahta näyttöä. Tuplanäyttötilalla on
rajoitettu tuki.
0 = Yhden näytön tila
1 = Tuplanäyttötila


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

Tiedoston tiedot näytetään graafisessa ulkoasussa, jos tiedot on saatavilla.
0 = Piilota tiedot
1 = Näytä tiedot


10.4 VerticalPadding = [Numero] (Oletus = 96)

Ylä ja alaruudun välinen tila voidaan määrittää, kun käytössä on tuplanäyttötila 
(asetus: ImageMode=1).


11. [ClockPlugin]


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

Näytä kello-lisäosa (plug-in).
0 = Piilota
1 = Näytä


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

Tuntijärjestelmän määrittäminen.
0 = 12-tuntinen järjestelmä (AM/PM -tunnisteilla) 
1 = 24-tuntinen järjestelmä


11.3 FormatDate = [arvo] (Oletus = YYYY/MM/DD)

Näytettävän päivän muotoilu. Maksimipituus on 32 merkkiä.
Esimerkeissä vuosi(Y) on 2001, kuukausi(M) 2 ja päivä(D) 3.
Käytettävällä koodilla (näkyy): 
YYYY (2001), YY (01), MM (02), M (2), DD (03), D (3)
Käyttämällä koodia: YYYY/MM/DD  näkyy päiväys muodossa: 2001/02/03
Erilaisia erottimia voidaan käyttää: , - . /



Jotta halutut asetukset tulevat käyttöön, täytyy lopuksi käynnistää 
"CreateNDSROM_for_EXFS.bat", sekä tallentaa _BOOT_MP.nds uudelleen 
tallennusmedialle.


Ulkoasuteeman asentaminen
===================================================================================
1)
Lisää teemapaketin tiedostot esim. "shell" -kansioon.

2)
Jos käytössäsi ei ole EXFS-tiedostojärjestelmä, siirry kohtaan "4".
Luo _BOOT_MP.nds uudelleen käynnistämällä "CreateNDSROM_for_EXFS.bat" -tiedosto.

3)
Tallenna _BOOT_MP.nds uudelleen tallennusmedialle.

4)
Teemapaketti on asennettu.

Teemojen suunnittelijoille: BMP kuvan täytyy olla 256x192 pikseliä.


U.K.K.
===================================================================================
K: MoonShell ei käynnisty (GBAMP)!
V: Varmista, että sinulla on GBAMP:ssa Chrism'n muokkaama firmware. Älä unohda 
   käyttää PassMe, FlashMe, tai WifiMe tapaa käynnistääksesi ".nds" -tiedoston.

K: Minulla on tallennuskasetti. Voinko käyttää MoonShell:ia, vai onko se vain 
   GBAMP-adapterille?
V: Kyllä voit. Lue kaikki "ReadMe" -tiedostot.

K: Minulla on Jpeg kuva, joka ei näy! Miksi?
V: Kaksi mahdollista syytä:  1) Progressive-pakatut eivät ole tuettuja.
                             2) Jpeg-kuville on kokorajoitus. Suurin tuettu leveys 
                                on 16384 pikseliä. 16000 x 12800 (24bit 
                                värikartta), 40Mt Jpeg-tiedostot toimivat, mutta 
                                avautuvat todella hitaasti.


Ohjelmavirheet, keskustelua & apua
===================================================================================
Jos sinulla on kysymysiä, tai ongelmia MoonShell -ohjelman kanssa, mene 
osoitteeseen: http://forum.gbadev.org/viewforum.php?f=20 
