ENIGMA versio 1.2
Copyright (c) Mika Halttunen 2001
www.enigmagame.cjb.net

LUEMINUT.TXT (23.04.2001)

NOTICE! English version of this text is in README.TXT!
---------------------------------------------------------

LISENSSI:
---------------------------------------------------------
 Enigma on 100% FREEWARE joten saat kopioida sit niin paljon
kuin haluat, mutta ilman maksua. Peli on tarkoitettu ilmaiseksi
niin sinulle kuin kaikille muillekin. Saat mys levitt
peli muillakin keinoilla (kotisivut, kokoelma CD:t, BBS:st jne),
ilmaiseksi siis, poikkeuksena kokoelma CD:t. Kokoelma CD:n hinta
saa olla korkeintaan CD:n teosta koituneet kulut.

 Saat mys levitt omatekemi kentti/episodeja niin kauan
kuin mainitset ett ne eivt ole minun tekemini.

 Ja muista, kytt tt peli omalla vastuulla. En ole
vastuussa mistn tmn tuotteen aiheuttamasta vahingosta,
peli ei kuitenkaan aiheuttanut mitn harmeja testauksen
aikana.


VERSIOHISTORIA:
---------------------------------------------------------
 * Versio 1.2 (tm)
  - Listty uusi Free Play - moodi, jossa sinulla on loputtomasti
    elmi.
  - Please Wait - ilmoitus listty alkuun
 * Pivitys versioon 1.1
  - Nyt viholliset resetoidaan alkuperisiin sijainteihensa kun
    pelaaja on kuollut
  - Vihollisten maksimimr on nostettu 9:st 15:sta
 * Versio 1.0
  - Ensimminen julkaistu versio


JOHDANTO:
---------------------------------------------------------
 Ja mik tm Enigma on? Enigma on 3d arcade peli.
Se on mys ensimminen 3d pelini.

 Sinun tehtvsi on kert kaikki hedelmt (ja muut rojut)
kentlt ja vistell vihollisia samalla.
"Kentt" on kuutioista kasattu 10x10x10 alue. Kuutiot
leijuvat ilmassa, omituisten maisemien ymprimin.
Hypit siis palikalta palikalle ja yritt pysy hengiss
tmn hyppelyn ajan.

 Kaikki tm esitetn tyylikkn 3d kiihdytetyn grafiikan
myt muutamilla hienoilla efekteill terstettyn.

 Peliss on kaksi eri episodia, kummassakin 10 kentt.
Ja siell jossain on mys pari vihulaistakin, mene ja ota selv!

LAITTEISTOVAATIMUKSET:
---------------------------------------------------------
 En ole tysin varma tarkoista vaatimuksista, mutta peli pyrii
riittvn hyvin omalla koneellani:

  AMD K6-2 3dNow! 400MHz
  96mb muistia
  RIVA TNT 16mb AGP
  Sound Blaster 64 PCI
  DirectX 8
  Windows 98

 3d korttisi PIT tukea OpenGL rajapintaa !
 Pelin pitisi toimia mys vanhemmilla DirectX versiolla, ainakin
 > 5:ll. Musiikit kuulostavat parhaimmalta SB Live!:ll.

 Enigma kynnistyy oletuksena 640x480 resoluutiossa 16 bittisill vreill.
Jos haluat muuttaa tmn, editoi GLSCAPE.INI tiedostoa.

 Tss tarvitsisin hieman apuasi. Mikset ajaisi DEBUG.BAT:ia ja
lhettisi generoitua GLS_CONSOLE.LOG:ia minulle seuraavien
tietojen kera:
   Nimesi (vapaaehtoinen)
   Prosessorisi tyyppi ja nopeus
   Nytnohjaimesi malli
   nikorttisi malli
   DirectX versiosi
   Kyttjrjestelmsi
   ja liitteen GLS_CONSOLE.LOG.
Ja pyydn ett lhettisitte noita logeja + tietoja sill
haluan todella tiet minklaisilla kokoonpanoilla
peli on/ei ole toiminut.

 Tss muutamia kokoonpanoja joilla Enigma on toiminut tysin:
* Celeron 954MHz, 196mb, GeForce256  DDR, Aureal Vortex2, Dx8, Win98
* AMD K6 233MHz, 32mb, Voodoo I, SB16
* AMD Athlon 1,2GHz, 256mb, Matrox G400 DH, Terratec DMX XFire, WinMe

 Olen saanut muutamia raportteja omituisista ongelmista Windows2000:ssa,
ne ovat tiedostettuja bugeja AllegroGL:ss. Enigma toimii parhaiten
W98/Me:ss.

VOODOO I / II:n omistajat huomio:
 Sain vahvistuksen ett peli toimii mys Voodoo korteilla.
Tss olisi konsti jota te Voodoo miehet voisitte kokeilla.
Ensiksi kopioi uusimmat Quake3 yhteensopivat (compatible) ajurit
ja asenna ne. (www.3dfx.com) Ajureissa pitisi olla tiedosto
joka on nimeltn 3DFXOGL.DLL tai jotain sinne pin.
Kopioi kyseinen tiedosto samaan kansioon ENIGMA.EXE:n
kanssa. Sitten nimet DLL:n OPENGL32.DLL:ksi.
Seuraavaksi kynnist peli.

 Ja jos peli ei toimi, lue seuraava kappale.


VIANMRITYS:
---------------------------------------------------------
 Peli ei toimi?
Suosittelen sinua ajamaan DEBUG.BAT ja lhettmn GLS_CONSOLE.LOG
tiedoston minulle. En voi auttaa ellen tied mitn koneestasi.

Lue mys seuraavat tapaukset.

* En lyd mitn GLS_CONSOLE.LOG tiedostoa!
 Oletko varmasti ajanut DEBUG.BATin? Jos olet, peli luultavasti
 kaatuu kynnistyess. Jos mitn viestej ei tule ja peli vain
 kaatuu, on vaikea sanoa mik on pieless. Voit editoida
 GLSCAPE.INI ja kokeilla eri resoluutioita/vrisyvyyksi
 ja yritt uudelleen. Tss tapauksessa, pyydn, LHET
 tietokoneesi tiedot minulle.

* Peli on _h e l k k a r i n_ hidas?
 Sen on luultavasti software tilassa (ei laitteistokiihdytyst).
 Aja DEBUG.BAT ja lhet loki minulle. Oletko varma ett sinulla
 on 3d kortti joka tukee OpenGL: tysin?
 Jos sinulla on VoodooI / II, katso edellinen kappale.
 Katso mys ett GLSCAPE.INIss "gls_rendermethod" on 1, ei 0.

* Nppimist eik hiiri toimi ollenkaan!
 Kytsssi on Windows 2000, eiks? Tm on tiedetty
 Allegron/AllegroGL:n ongelma. Kokeilepa Alt-tabata
 pois pelist ja tabbaa sitten takaisin. Sen pitisi
 tepsi.

* Peli sanoo: "Unable to find a suitable graphics driver!"
 Editoi GLSCAPE.INI ja kokeile eri resoluutioita ja vrisyvyyksi.
 Voit mys kokeilla ikkunoitua (windowed) moodia.


KUINKA ..... ?:
---------------------------------------------------------
* Kuinka pelaan?
 - Itse pelaaminen on aika simppeli, tovin harjoittelun jlkeen.
   Suosittelen sinun pelaavan "tutoriaali" episodin lpi muutaman
   kerran. Se ei ole oikea tutoriaali, vain episodi jossa on
   erittin helppoja kentti.
   (Start game -> External episodes -> Simple tutorial)

   Tss kontrollit:
   YLS.......................... Kiihdytys
   ALAS.......................... Peruutus (jarrutus)
   VASEN......................... Knny vasemmalle
   OIKEA......................... Knny oikealle
   VLILYNTI.................... Hyppy
   P............................. Pause
   F12........................... Ottaa kuvakaappauksen
   F1............................ Arpoo uuden musiikin

   TILDE (ESCin alapuolella)..... Konsoli esiin/pois
   Konsolista ei ole sinulle oikeastaan hyty, sit kytetn
   pasiassa debug tiedon tallennukseen. Muuten, jos haluat
   tietn koneesi FPS-arvon (frames per second), kirjoita
   "show_fps 1" konsoliin ja paina ENTER.

   Ps. Katso mys "Kuinka kytn kameraa?" kysymys.
---------
* Kuinka kytn kameraa?
 - Kameran ohjastus on hieman vaikeaa, tytyy mynt.
   Kamerasysteemin olisi voinut koodata paremmin, mutta sit on erittin
   vaikea en muuttaa. Meidn on vain prjttv nykyisell......
   Mutta lupaan, ett seuraavassa pelissni on parempi kamerasysteemi ;)

   Joka tapauksessa, peliss on kaksi eri kameramoodia.
   Normaali ja Vapaa. (oletuksena Normaali). Painamalla C-nppint,
   voit vaihtaa aktiivista moodia.

   Normaali-moodissa, WSAD- ja QZ-napeista voit katsella ymprillesi.
   Ja Vapaassa-moodissa, WSADQZ- napit liikuttavat kameraa ja hiiri
   kntelee sit. Ja kun haluat lukita kameran, paina L-nappia ja
   aseta kamera haluaamasi asentoon.

   Vinkki:
    Joitan kentti ei kannata pelata Normaali-moodissa. Kun "Get ready"
    teksti on ruudulla, voit vaihtaa Vapaaseen moodiin ja tutkia
    kentt. Voit lukita kameran ja jtt sen Vapaaseen moodin tai
    palauttaa Normaalin painamalla C:t uudelleen.

   On erittin trke ett opit kyttmn kameraa liikkumisen ohella.
---------
* Kuinka navigoin valikoissa?
 - Sinun tytyy kytt hiirt valikoissa liikkumiseen.

   Tss valikoiden kuvaukset:

   (MAIN MENU, pvalikko)
   Start game.................... Mene "Start game" - valikkoon
   Single level.................. Pelaa yksittisen kentn
   Create levels................. Heitt sinut kentt editoriin
   Exit game..................... Heitt sinut takaisin Windowsiin

   (START GAME, aloita peli)
   Episode #1.................... Pelaa episodin #1
   Episode #2.................... Pelaa episodin #2 (hieman vaikeampi)
   External episodes............. Pelaa muita episodeja (tai tutoriaalin)
   Cancel........................ Takaisin pvalikkoon
---------
* Kuinka teen omia kentti/episodeja?
 - Hienoa. Haluat siis tehd jotain omaakin? Niin sit pit!
   Lue EDITOR_FIN.TXT.
---------
* Kuinka soitan omia MIDejni peliss?
 - Laita MIDI tiedostosi MUSIC - hakemistoon (max. 30kpl)
---------
* Kuinka psen episodit lpi?
 - Niit ei ole tarkoitettu lpistvksi parin ensimmisen kerran aikana.
   Sinun tytyy pelata niit paljon ja harjoitella.
---------
* Kuinka voin huijata?
 - Et mitenkn ;)


EPOLEELLISTA TIETOA:
---------------------------------------------------------
 Enigma on ohjelmoitu MSVC++ 6:lla kytten C++ kielt ja
Allegroa/AllegroGL:.

 Tekstuurit on ripattu netist, jotkut olen tehnyt/editoinut
itse, muut netist. Modelit on mallinnettu 3ds max:illa ja
teksturoitu MilkShape3d:ll.
Kytin tekstuurien tekoon/editointiin Jasc Paint Shop Pro 7-
ohjelmaa. Taustalla nkyvt maisemat olen tehnyt ilmaisella
TerraGen nimisell ohjelmalla.

 Ja mit seuraavaksi? Kuka tiet... Teen muutamia lisepisodeja/-kentti
thn ja julkaisen niit Enigman kotisivuilla.
Mits sitten?.... Ehk minulla on viel aikaa kesll tehd jokin
pikkupeli. Syksyll kuitenkin pit rient lukioon joten sitten
ei vapaa aikaa koodata erityisen paljon :(

 Jos et muuten tiennyt, edellinen pelini oli asteroids klooni,
Steroids. Voit hakea sen Enigman kotisivuilta.
Se on edelleen pelattava ja ihan hyvkin!


ENGINE:
---------------------------------------------------------
 Usko tai l, Enigmaa pyritt ihan "engine".
Uuden engineni nimi on GLScape.
OpenGL kiihdytyksen ansiosta se on erittin nopea (olettaen
ett sinulla on huippu PC) ja helppokyttinen.
GLScape kytt OpenGL: ja AllegroGL/Allegroa.
Se on kirjoitettu puhtaalla C++:lla kytten
yksinkertaisia julkisia luokkia.

 Okei, tytyy mynt, se ei ole nopein engine maan pll
(kaukana siit :), mutta tm on ensimminen 3d rpellykseni
joten se on sellaiseksi ihan jees.

 En muuten aio julkaista enginen lhdekoodeja, ainakaan tll
hetkell, mutta voin aina auttaa sinua ohjelmointiongelmissasi
(ainakin voi yritt auttaa :)

 Alkuperinen GLScape oli OpenGL kiihdytetty tile engine
muutamilla 3d efekteill. Enigma kytt GLScapen versiota
2.0 joka on "oikea" 3d engine modelien kytt tuella,
backface cullingilla jne.

 Tulevaisuudessa ajattelin list luurankopohjaisen animaatio
tuen ja ehk lightmapit. Pysyn silti niss "pikkupeli"-sarjoissa ;)


CREDITS:
---------------------------------------------------------
Kaikki koodi, grafiikat, modelit, suunnittelu ja rojut:
- Mika Halttunen (lsoft@mbnet.fi)

Musiikit:
- Mike Spang (www.mspang.de)

Haluan kiitt seuraavia henkilit:
- Jeff Molofee alias Nehe mahtavista OpenGL tutoriaaleista (http://nehe.gamedev.net)
- Brett Porter modelin lataus tutoriaalista/koodista
- Shawn Hargreaves + muut Allegron kehittjt
- George Foot, Robert J Ohannessian + muut AllegroGL:n kehittjt
- Kaikki te AGL postituslistalla!

Ja GREETZit:
- Kavereille
- Kaikille teille OpenGL koodareille
- Mikrobitti - lehti (paras suomalainen PC lehti!)
- Pelit - lehti (paras suomalainen PC-peli lehti!)
- Kaikki te jotka teette kentti/episodeja thn peliin
- Kaikki jotka ovat lhettneet loki-tiedostonsa minulle


KUINKA MINUUN SAA YHTEYDEN?:
---------------------------------------------------------
 Tavoitat minut shkpostilla. Heit palautetta, kentti,
episodeja, bugiraportteja, debug infoa, jne:

   lsoft@mbnet.fi

 Ja ky mys Enigman kotisivuilla:

   www.enigmagame.cjb.net


