Meeskond "Miinipilduja tuli"

Sissejuhatus

Mäng on tehtud, kasutades C# standard teegis olevat System.Drawing süsteemi. Mängus jookseb peategelane "Lena" ringi ja võitleb ellujäämise nimel(ning ka parema highscore-i tulemuse nimel). Lena võitleb müütiliste olenditega kaugetest galaktikatest ja küsimus ei ole siinkohal, kas ta jääb ellu, vaid kui kauaks ta jääb ellu?

• Source kood: http://code.google.com/p/longdonut/source/browse/trunk/
• Install file: http://enos.itcollege.ee/~tliiv/Long%20Donut.msi
• VsDoc genereeritud dokumentatsioon: http://itcollege.ee/~tilves/long_donut.chm

Versioonihalduseks kasutasime privaatsed Subversion repot.

Kasutusjuhend

Paigaldamine

• Alustamiseks, tuleb mäng allalaadida meie wiki lehelt. Selleks on aadress: Installer.
• Seejärel otsige üles koht, kuhu mängu installer on tõmmatud ja vajutage see käima.
• Järgnevalt küsitakse teilt, kas te olete kindel, et tahate seda käima lükata? Vajutage nupule run, mis suunab teid installeri juurde.

• 

• Avanenud installeril Vajutage nupule Next ja teilt küsitakse kohta, kuhu mäng intallida. Vaikimisi on selleks kohaks C:\Program Files\Miinipilduja\Long Donut\.
• Vajutades nupule Disk Cost, saate teada palju teil on arvutis vaba ruumi, palju ruumi mäng võtab ja tulemust, palju teil jääb alles vaba ruumi, pärast mängu paigaldamist
• Valige koht, kuhu mäng salvestada, ning allpool valige, ka soovite mängu paigaldada ainult endale, või ka kõigile teistele, ning vajutage nuppu Next.

• 

Tööjaotus

Taavi Ilves

- Collision detection

- Tegelase liikumise clippimine

- Tulistamise arvutamine

- Levelite, Skoori, Wave'ide jms arvutamine

- Elektri effekt

- ObjectList wrapper List'ile

- XML mapi parsimine

- Jms. jooksvad asjad

Tanel Liiv

- Sound

- Vastased, nende liikumise loogika

- Tegelase liikumine ja loogika

- XML tulemuste salvestamine, kuvamine

- Mapi dünaamiline joonistamine

- Muu joonistamine

- Jms. jooksvad asjad

- Installer

Jaan Vahtre

- Peamenüü,Pausmenüü,Tulemuste Menüü,Death Menüü vaatedete kujundamine, vaadete ühendamine mängu koodiga.

- Nuppude kujundamine, ja nende kuvamise ühendamine koodiga.

- Logod

- Dokumentatsioon

- Juhend

- Wiki

- Jms. jooksvad asjad

Esialgsed plaanid

Esialgu oli plaanis teha lihtne tulistamisemäng, peategelase ja hulga vaenlastega. Lihtne peamenüü 2-e nupuga: Uusmäng ja välju, ning oli ka teada, et luua tuleb eraldi collision detection, sest me ei teinud mängu XNA-s.

Esialgsed plaanid

• Collision detection.
• Tulistamise arvutamine.
• Vastased, nende liikumise loogika.
• Tegelase liikumine ja loogika
• XML mapi tegemine
• Mapi dünaamiline joonistamine
• Menüü joonistamine ning ühendamine koodiga.
• Nuppude kujundamine ja ühendamine koodiga.
• Dokumentatsioon
• Juhend

Log

2.September

Grupi moodustamine, Idee arutlus, Esialgsete ülesannete jagamine.

3.September

Graafiline displei ehk mängu tagatausta joonistamine. Mängija joonistamine,Jalgade liigutamine, ja Double buffer.K Esinesid esimesed probleemid: Graafika joonistamisel, mängu kiirus langes.

4.September

Mapi Piiride arvutamine ja kuvamine. Parandati liikumise ja graafika kuvamise arvutamine ära.Mängule lisati ka parem graafika, mis mõjus oluliselt mängu kiirusele. Esinenud probleemid: Collision Detection ei tööta, Lisatud Uus graafika, mõjus oluliselt mängu kiirusele. Pöörduti tagasi vana Graafika juurde (kahe suure commiti mahus).

5.September

MapObject List sorteeriti y koordinaadi poolt, enne tagastamist.

6.September

Loodi monsterite baas ning joonistati staatilised vaenlased. Lisati ka liikumine ning mängija tagaajamine.

• 

13.September

Joonistati Mängu logo ja peamenüü.

14.September

Joonistati välja Uus Mäng nupp, ning lisati see peamenüüsse. Probleemid: Arvuti tegi update-i ja nupu kujundus läks kaduma.

• 

16.September

Peamenüü lisamine mängu, koos Uus Mäng nupuga. Mängul oli nüüd 2 erinevat vaadet:peamenüü, kust sai alustada uut mängu ja mängu vaade.

• 

22.September

Mängule lisati heli. Probleemid: Ainult üks heli sai korraga mängida ning seetõttu läksid mõned helid mängus kaduma.

23.September

Uus interface, lisatud omatehtud border ning koodi lisati ka pausmenüü võimalus.

• 

10.Oktoober

Uus ja parandatud helisüsteem.

12.Oktoober

Mängijale lisati elud ja nüüdsest sai mängija ka surma.Lisati ka punktide arvestus ning tulistamisele lisati "lightning" effekt.

• 

13.Oktoober

Lisati ThreadLocking võimalus. Mäng oli nüüd Threadsafe!

14.Oktoober

ObjectList clone, Threadlock width Monitor. Veel lisati uued helid, pandi map liikuma tüdruku jalge all, lisati Monster.cs klass.

16.Oktoober

Lisati menüüd: DeathMenüü, Highscore Menüü, ning lisati neile nupud Alusta uut mängu, Tulemused, Välju. Probleemid: uut mängu ei olnud võimalik alustada.

17.Oktoober

Lisatud peamenüüse Tulemused ja Välju nupud, Highscore-i menüüsse tagasi nupp. Uus Death Menüü.

• 

18. Oktoober

Alusta uut mängu võimalus töötab.

19.Oktoober

Uus Highscore-i tagataust ja tagasi nupule lisatud Glow.

• 

21.Oktoober

Kogu tekst kommenteeritud, Highscore töötab, Uus font Highscore-le.

22.Oktoober

Surma saades ei lähe enam DeathMenüüsse, vaid Highscore Menüüsse.Lisati veel kommentaare ja parandati Timer-i vigu. Timer ründas liiga paljudes erinevates menüüdes.

23.Oktoober

Parandati mängija liikumine.Loodi installikas ning lisati installikas, dokumentatsioon wikisse. Wiki loomine.

Huvitavat

1. Tegelase juhtimine

Kuna C# standardses libras ja üldse windowsi applicationite puhul on üks tore asi see, et klavatuuril nuppu all hoides, saadetakse alguses 1 signaal, siis tekib umbes poole sekundiline delay ja siis hakatakse juba järjest signaale saatma. See tekitab tegelase liikumisse delay sisse.

Lahendus oli siis selline. Kui mingit nuppu vajutati, registreeriti liikumise flag ja suund. Siis iga taimeri "ticki" ajal vaadati kas liikumise flag oli püsi, kui jah, liiguti, kui ei, siis ei juhtunud midagi. Siis kui nupp lahti lasti, võeti flag maha ja järgmise taimeri "ticki" ajal enam liikumist ei toimunud. Nii liigubki tegelane nüüd sujuvalt. :)

2. Map objektid threadsafe

Meie mängus jookseb korraga 2 threadi. Üks on main thread, kus toimub joonistamine ja siis luuakse pidevalt taimeri poolt "tick" threade, kus toimub tegelase ja kollide liikumine, kollide eemaldamine, skoori arvutamine, leveli arvutamine jne. Juhul kui eelpoolt nimetatud thread kasutab Map objektide listi ja näiteks eemaldab sealt mõne objekti ja samal ajal kasutab ka main thread seda, tekib exception, kuna listi muudeti tema kasutamise ajal.

Lahenduseks, tegin List objekti ümber "wrapperi", kuhu kirjutasin vajalikud meetodid (Clone, Remove, Add, Clear jne.) ja tegin kõik tegevused thread safe'iks. Kasutades Monitor.Enter ja Monitor.Exit meetoteid. See tagab selle, et threadid ei kasutakas samal ajal objekte vaid ootaks üksteise järele.

3. Collision detection

Collision detection on puhtalt ise kirjutatud ja suudab takistada suvaliste suurustega ristkülikute kokkupõrget. Meetod on piisavalt optimaalne mitmesaja eluka(+puud, tegelane ja muruplatsi piirid) ringiliigutamiseks/kollisioonide kontrollimiseks ilma märgatava aeglustumiseta.

4. Heli

Kuna C# standard teegis ei ole mõistliku helimängijat(Soundplayer suudab mängida vaid ühte heli korraga, st. puudub software mixing) siis kasutasime heli jaoks välist teeki irrKlang. irrKlang võimaldab tänu oma lihtsale API'le ja software mixingule mängida korraga mitmeid helisid :)