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 myös levittää
peliä muillakin keinoilla (kotisivut, kokoelma CD:t, BBS:sät jne),
ilmaiseksi siis, poikkeuksena kokoelma CD:t. Kokoelma CD:n hinta
saa olla korkeintaan CD:n teosta koituneet kulut.

 Saat myös levittää omatekemiä kenttiä/episodeja niin kauan
kuin mainitset että ne eivät ole minun tekemiäni.

 Ja muista, käytät tätä peliä omalla vastuulla. En ole
vastuussa mistään tämän tuotteen aiheuttamasta vahingosta,
peli ei kuitenkaan aiheuttanut mitään harmeja testauksen
aikana.


VERSIOHISTORIA:
---------------------------------------------------------
 * Versio 1.2 (tämä)
  - Lisätty uusi Free Play - moodi, jossa sinulla on loputtomasti
    elämiä.
  - Please Wait - ilmoitus lisätty alkuun
 * Päivitys versioon 1.1
  - Nyt viholliset resetoidaan alkuperäisiin sijainteihensa kun
    pelaaja on kuollut
  - Vihollisten maksimimäärä on nostettu 9:stä 15:sta
 * Versio 1.0
  - Ensimmäinen julkaistu versio


JOHDANTO:
---------------------------------------------------------
 Ja mikä tämä Enigma on? Enigma on 3d arcade peli.
Se on myös ensimmäinen 3d pelini.

 Sinun tehtäväsi on kerätä kaikki hedelmät (ja muut rojut)
kentältä ja väistellä vihollisia samalla.
"Kenttä" on kuutioista kasattu 10x10x10 alue. Kuutiot
leijuvat ilmassa, omituisten maisemien ympäröiminä.
Hypit siis palikalta palikalle ja yrität pysyä hengissä
tämän hyppelyn ajan.

 Kaikki tämä esitetään tyylikkään 3d kiihdytetyn grafiikan
myötä muutamilla hienoilla efekteillä terästettynä.

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

LAITTEISTOVAATIMUKSET:
---------------------------------------------------------
 En ole täysin varma tarkoista vaatimuksista, mutta peli pyörii
riittävän 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 pitäisi toimia myös vanhemmilla DirectX versiolla, ainakin
 > 5:llä. Musiikit kuulostavat parhaimmalta SB Live!:llä.

 Enigma käynnistyy oletuksena 640x480 resoluutiossa 16 bittisillä väreillä.
Jos haluat muuttaa tämän, editoi GLSCAPE.INI tiedostoa.

 Tässä tarvitsisin hieman apuasi. Mikset ajaisi DEBUG.BAT:ia ja
lähettäisi generoitua GLS_CONSOLE.LOG:ia minulle seuraavien
tietojen kera:
   Nimesi (vapaaehtoinen)
   Prosessorisi tyyppi ja nopeus
   Näytönohjaimesi malli
   Äänikorttisi malli
   DirectX versiosi
   Käyttöjärjestelmäsi
   ja liitteenä GLS_CONSOLE.LOG.
Ja pyydän että lähettäisitte noita logeja + tietoja sillä
haluan todella tietää minkälaisilla kokoonpanoilla
peli on/ei ole toiminut.

 Tässä muutamia kokoonpanoja joilla Enigma on toiminut täysin:
* 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 myös Voodoo korteilla.
Tässä olisi konsti jota te Voodoo miehet voisitte kokeilla.
Ensiksi kopioi uusimmat Quake3 yhteensopivat (compatible) ajurit
ja asenna ne. (www.3dfx.com) Ajureissa pitäisi olla tiedosto
joka on nimeltään 3DFXOGL.DLL tai jotain sinne päin.
Kopioi kyseinen tiedosto samaan kansioon ENIGMA.EXE:n
kanssa. Sitten nimeät DLL:n OPENGL32.DLL:ksi.
Seuraavaksi käynnistä peli.

 Ja jos peli ei toimi, lue seuraava kappale.


VIANMÄÄRITYS:
---------------------------------------------------------
 Peli ei toimi?
Suosittelen sinua ajamaan DEBUG.BAT ja lähettämään GLS_CONSOLE.LOG
tiedoston minulle. En voi auttaa ellen tiedä mitään koneestasi.

Lue myös seuraavat tapaukset.

* En löydä mitään GLS_CONSOLE.LOG tiedostoa!
 Oletko varmasti ajanut DEBUG.BATin? Jos olet, peli luultavasti
 kaatuu käynnistyessä. Jos mitään viestejä ei tule ja peli vain
 kaatuu, on vaikea sanoa mikä on pielessä. Voit editoida
 GLSCAPE.INIä ja kokeilla eri resoluutioita/värisyvyyksiä
 ja yrittää uudelleen. Tässä tapauksessa, pyydän, LÄHETÄ
 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 lähetä loki minulle. Oletko varma että sinulla
 on 3d kortti joka tukee OpenGL:ää täysin?
 Jos sinulla on VoodooI / II, katso edellinen kappale.
 Katso myös että GLSCAPE.INIssä "gls_rendermethod" on 1, ei 0.

* Näppäimistö eikä hiiri toimi ollenkaan!
 Käytössäsi on Windows 2000, eikös? Tämä on tiedetty
 Allegron/AllegroGL:n ongelma. Kokeilepa Alt-tabata
 pois pelistä ja tabbaa sitten takaisin. Sen pitäisi
 tepsiä.

* Peli sanoo: "Unable to find a suitable graphics driver!"
 Editoi GLSCAPE.INIä ja kokeile eri resoluutioita ja värisyvyyksiä.
 Voit myös kokeilla ikkunoitua (windowed) moodia.


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

   Tässä kontrollit:
   YLÖS.......................... Kiihdytys
   ALAS.......................... Peruutus (jarrutus)
   VASEN......................... Käänny vasemmalle
   OIKEA......................... Käänny oikealle
   VÄLILYÖNTI.................... Hyppy
   P............................. Pause
   F12........................... Ottaa kuvakaappauksen
   F1............................ Arpoo uuden musiikin

   TILDE (ESCin alapuolella)..... Konsoli esiin/pois
   Konsolista ei ole sinulle oikeastaan hyötyä, sitä käytetään
   pääasiassa debug tiedon tallennukseen. Muuten, jos haluat
   tietään koneesi FPS-arvon (frames per second), kirjoita
   "show_fps 1" konsoliin ja paina ENTER.

   Ps. Katso myös "Kuinka käytän kameraa?" kysymys.
---------
* Kuinka käytän kameraa?
 - Kameran ohjastus on hieman vaikeaa, täytyy myöntää.
   Kamerasysteemin olisi voinut koodata paremmin, mutta sitä on erittäin
   vaikea enää muuttaa. Meidän on vain pärjättävä nykyisellä......
   Mutta lupaan, että seuraavassa pelissäni on parempi kamerasysteemi ;)

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

   Normaali-moodissa, WSAD- ja QZ-napeista voit katsella ympärillesi.
   Ja Vapaassa-moodissa, WSADQZ- napit liikuttavat kameraa ja hiiri
   kääntelee 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 jättää sen Vapaaseen moodin tai
    palauttaa Normaalin painamalla C:tä uudelleen.

   On erittäin tärkeää että opit käyttämään kameraa liikkumisen ohella.
---------
* Kuinka navigoin valikoissa?
 - Sinun täytyy käyttää hiirtä valikoissa liikkumiseen.

   Tässä valikoiden kuvaukset:

   (MAIN MENU, päävalikko)
   Start game.................... Mene "Start game" - valikkoon
   Single level.................. Pelaa yksittäisen kentän
   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 päävalikkoon
---------
* Kuinka teen omia kenttiä/episodeja?
 - Hienoa. Haluat siis tehdä jotain omaakin? Niin sitä pitää!
   Lue EDITOR_FIN.TXT.
---------
* Kuinka soitan omia MIDejäni pelissä?
 - Laita MIDI tiedostosi MUSIC - hakemistoon (max. 30kpl)
---------
* Kuinka pääsen episodit läpi?
 - Niitä ei ole tarkoitettu läpäistäväksi parin ensimmäisen kerran aikana.
   Sinun täytyy pelata niitä paljon ja harjoitella.
---------
* Kuinka voin huijata?
 - Et mitenkään ;)


EPÄOLEELLISTA TIETOA:
---------------------------------------------------------
 Enigma on ohjelmoitu MSVC++ 6:lla käyttäen 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ä.
Käytin tekstuurien tekoon/editointiin Jasc Paint Shop Pro 7-
ohjelmaa. Taustalla näkyvät maisemat olen tehnyt ilmaisella
TerraGen nimisellä ohjelmalla.

 Ja mitä seuraavaksi? Kuka tietää... Teen muutamia lisäepisodeja/-kenttiä
tähän ja julkaisen niitä Enigman kotisivuilla.
Mitäs sitten?.... Ehkä minulla on vielä aikaa kesällä 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 hyväkin!


ENGINE:
---------------------------------------------------------
 Usko tai älä, Enigmaa pyörittää ihan "engine".
Uuden engineni nimi on GLScape.
OpenGL kiihdytyksen ansiosta se on erittäin nopea (olettaen
että sinulla on huippu PC) ja helppokäyttöinen.
GLScape käyttää OpenGL:ää ja AllegroGL/Allegroa.
Se on kirjoitettu puhtaalla C++:lla käyttäen
yksinkertaisia julkisia luokkia.

 Okei, täytyy myöntää, se ei ole nopein engine maan päällä
(kaukana siitä :), mutta tämä on ensimmäinen 3d räpellykseni
joten se on sellaiseksi ihan jees.

 En muuten aio julkaista enginen lähdekoodeja, ainakaan tällä
hetkellä, mutta voin aina auttaa sinua ohjelmointiongelmissasi
(ainakin voi yrittää auttaa :)

 Alkuperäinen GLScape oli OpenGL kiihdytetty tile engine
muutamilla 3d efekteillä. Enigma käyttää GLScapen versiota
2.0 joka on "oikea" 3d engine modelien käyttö tuella,
backface cullingilla jne.

 Tulevaisuudessa ajattelin lisätä luurankopohjaisen animaatio
tuen ja ehkä lightmapit. Pysyn silti näissä "pikkupeli"-sarjoissa ;)


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

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

Haluan kiittää seuraavia henkilöitä:
- Jeff Molofee alias Nehe mahtavista OpenGL tutoriaaleista (http://nehe.gamedev.net)
- Brett Porter modelin lataus tutoriaalista/koodista
- Shawn Hargreaves + muut Allegron kehittäjät
- George Foot, Robert J Ohannessian + muut AllegroGL:n kehittäjät
- 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 tähän peliin
- Kaikki jotka ovat lähettäneet loki-tiedostonsa minulle


KUINKA MINUUN SAA YHTEYDEN?:
---------------------------------------------------------
 Tavoitat minut sähköpostilla. Heitä palautetta, kenttiä,
episodeja, bugiraportteja, debug infoa, jne:

   lsoft@mbnet.fi

 Ja käy myös Enigman kotisivuilla:

   www.enigmagame.cjb.net


