VRJB - Team 5

2012-10-10T07:37:12Z

Lkermas: Esialgne, kehva vormistusega.

2011-04-18T06:50:51Z

Lkermas:

== Idee ==
Meie tiimil on plaanis teha internetipõhine söökla menüü süsteem (aluseks IT Kolledži kohvik, aga suunitlus selline, et kõik kohvikud/sööklad saaksid teha endale kasutajakonto ja hakata rakendust kasutama), kust saaks jälgida menüüd, mis sööke saab süüa, mis veel järgi on, kasutajatel on ka võimalus sööke hinnata (stiilis "meeldib", "ei meeldi" nagu Facebook-is).

Kohvikupidaja Teele soovid uue elektroonse süsteemi kohta:

* elektroonilisest menüüst asju kustutada, isegi siis kui asja peaks olema teoreetiliselt alles, aga tegelikult on asi otsas.
* elektrikatkestuse korral jääb menüü püsima. Ta peab teadma hindu mistahes olukorras.
* menüül näidatakse automaatselt ka ISIC kaardi omanike soodushinnad
* süsteem toetab ka poole portsjoni müümist.

Linnar Viigi soovid/visioonid uue elektroonse süsteemi kohta:

* kõik oleks ka internetist kättesaadav, peale LCD ekraani, mis kajastab menüüd sööklas.
* aluseks facebook, kus siis söögid oleks nagu facebook-i alateemad.
* saab sööke hinnata, kommenteerida (täna oli väga maitsev praad).
* kasutajad saaks vaadata, mis menüüs on (ka järgmisel nädalal) ja mitu portsu veel alles on.
* kasutajad saaksid välja pakkuda menüüsid.
* erinevate söögikohtade kasutajad saaksid omavahel muljeid jagada.
* kuu aja aktiivsemad saavad prii lõuna.
* mingil ajal võib olla "happy hour" (enne sulgemist saab odavamalt).
* piiranguks on see, et toitu broneerida ei saa

'''Vaba tarkvara kasutamise võimalus'''

Antud projekti puhul oleks võimalik kasutada [http://www.postgresql.org/ PostgreSQL] andmebaasi (vt. lisaks http://en.wikipedia.org/wiki/PostgreSQL ) Microsoft SQL Server'i asemel. See võiks anda kasutajale võimaluse valida .NET ning [http://www.mono-project.com/ Mono] (vt. lisaks http://en.wikipedia.org/wiki/Mono_(software) ) platvormide vahel. Sel viisil oleks kliendil võimalik Microsoft'i platvormi kõrval valida tõenäoliselt soodsam vaba tarkvara platvorm. Andmebaasi lõplik valik pole hetkel veel otsustatud.

== Meeskond ja tööjaotus==
* Kristjan Stolin - projektijuht, suhtlus kliendiga, XML, wiki, teenuskihtide progemine, rollide halduse lehe progemine
* Ilmar Telga - XML, kliendiga suhtlus, wiki, teenuskihtide progemine, lõpprakenduste menüüd, login
* Rauno Rüga - XML, XSLT, andmebaasi loomine, wiki, mobiilirakendus, statistika
* Lauri Kermas - teenuskihtide ehitamine, wiki, login, kommenteerimise võimaluste progemine

== XML Fail ==
=== XML ===
<source lang="xml">
<?xml version="1.0" encoding="utf-8"?>
<Toidud>
<Toit>
<ToiduNimetus>Viineri kaste</ToiduNimetus>
<ToiduLiik>Praad</ToiduLiik>
<OlemasolevatYhikut>5</OlemasolevatYhikut>
<ToiduKogus>
<Portsjon>
<PortsjoniLiik>Poolportsjon</PortsjoniLiik>
<Myygiaeg>
<Aasta>2011</Aasta>
<Kuu>1</Kuu>
<Paev>9</Paev>
<Tund>15</Tund>
<Minut>07</Minut>
<Sekund>23</Sekund>
</Myygiaeg>
<ToiduHind>
<Eurohind>2.15</Eurohind>
<Soodustus>
<SoodustuseProtsent>5%</SoodustuseProtsent>
<SoodustuseLiik>ISIC kaart</SoodustuseLiik>
</Soodustus>
</ToiduHind>
</Portsjon>
<Portsjon>
<Myygiaeg>
<Aasta>0</Aasta>
<Kuu>0</Kuu>
<Paev>0</Paev>
<Tund>00</Tund>
<Minut>00</Minut>
<Sekund>00</Sekund>
</Myygiaeg>
<PortsjoniLiik>Täisportsjon</PortsjoniLiik>
<ToiduHind>
<Eurohind>2.80</Eurohind>
<Soodustus>
<SoodustuseProtsent>5%</SoodustuseProtsent>
<SoodustuseLiik>ISIC kaart</SoodustuseLiik>
</Soodustus>
</ToiduHind>
</Portsjon>
</ToiduKogus>
<Kommentaarid>
<Kommentaar>
<Saatja>
<SaatjaNimi>Kristjan</SaatjaNimi>
<SaatjaRoll>Tudeng</SaatjaRoll>
</Saatja>
<Sisu>Minu lemmik toit ! Kui algebra tund ei hakkaks, sööks veel 5 portsjonit.</Sisu>
</Kommentaar>
</Kommentaarid>
</Toit>
</Toidud>
</source>

Kommentaariks siis niipalju, et meie näide on ilma kohviku osata, selleks et näidet mitte liiga suureks ajada.

Ka on meil moment puudu ID väljad, mis on igasugu andmebaasiga suhtlemiseks hädavajalikud, samas siin näidises palju juurde ei anna.

Asja tegemisel avastasime, et põhiliseks arusaamatuse kohaks on toitude erinevad kogused (ehk siis pool portsjonit, suur / väike ja muud võrdlevad ühikud). Esimese võimalusena kaalusime teha lihtsalt täiesti eraldi toidud kõige kohta, stiilis "väike viineripraad" ja "suur viineripraad". Kahjuks see variant ei kõlbaks eriti hästi, kuna need erinevad portsjonid kasutavad ikkagi samu materjale ja kui me peaks mingi süsteemiga näitama kui palju portsjoneid alles on. Sööklast näiteks pakuti et väike portsjon kasutab materjale kuskil 0.8 suure portsjoni ulatuses, ehk see suhtarv peaks olema kasutaja poolt (kohvikupidaja, restoraniomanik) ise sätitav.

Tänu sellele sai meie süsteemi alustalaks siiski Toit, millel on oma Portsjonid siis erinevate hindade ja soodustustega. Moment pole meil ka Portsjoni XML osas toodud ära seost kogusega. (Kui palju ühe portsjoni lisamine/müümine peaks toidu üldkogust muutma).

Kommenteerida saab meil moment toitu ennast, mitte eraldi portsjonit. Isegi kui kasutajad tahavad lisada kommentaare stiilis "See väike supp oli tõesti väga väike", ei soovi nad seda ilmselt eraldi portsjoni alla panna. Tulevikus peaks kindlasti olema ka võimalus pigem kommenteerida üldisemalt (Kohvikut ennast, söögipaiku üldse), kui spetsiifilisemalt (Väikse prae kaste lisandi kohta).

=== XML Schema ===
<source lang="xml">
<?xml version="1.0" encoding="utf-8"?>
<xs:schema attributeFormDefault="unqualified" elementFormDefault="qualified" xmlns:xs="http://www.w3.org/2001/XMLSchema">
<xs:element name="Toidud">
<xs:complexType>
<xs:sequence>
<xs:element name="Toit">
<xs:complexType>
<xs:sequence>
<xs:element name="ToiduNimetus" type="xs:string" />
<xs:element name="ToiduLiik" type="xs:string" />
<xs:element name="OlemasolevatYhikut" type="xs:unsignedByte" />
<xs:element name="ToiduKogus">
<xs:complexType>
<xs:sequence>
<xs:element maxOccurs="unbounded" name="Portsjon">
<xs:complexType>
<xs:sequence>
<xs:choice maxOccurs="unbounded">
<xs:element name="PortsjoniLiik" type="xs:string" />
<xs:element name="Myygiaeg">
<xs:complexType>
<xs:sequence>
<xs:element name="Aasta" type="xs:unsignedShort" />
<xs:element name="Kuu" type="xs:unsignedByte" />
<xs:element name="Paev" type="xs:unsignedByte" />
<xs:element name="Tund" type="xs:unsignedByte" />
<xs:element name="Minut" type="xs:unsignedByte" />
<xs:element name="Sekund" type="xs:unsignedByte" />
</xs:sequence>
</xs:complexType>
</xs:element>
<xs:element name="ToiduHind">
<xs:complexType>
<xs:sequence>
<xs:element name="Eurohind" type="xs:decimal" />
<xs:element name="Soodustus">
<xs:complexType>
<xs:sequence>
<xs:element name="SoodustuseProtsent" type="xs:string" />
<xs:element name="SoodustuseLiik" type="xs:string" />
</xs:sequence>
</xs:complexType>
</xs:element>
</xs:sequence>
</xs:complexType>
</xs:element>
</xs:choice>
</xs:sequence>
</xs:complexType>
</xs:element>
</xs:sequence>
</xs:complexType>
</xs:element>
<xs:element name="Kommentaarid">
<xs:complexType>
<xs:sequence>
<xs:element name="Kommentaar">
<xs:complexType>
<xs:sequence>
<xs:element name="Saatja">
<xs:complexType>
<xs:sequence>
<xs:element name="SaatjaNimi" type="xs:string" />
<xs:element name="SaatjaRoll" type="xs:string" />
</xs:sequence>
</xs:complexType>
</xs:element>
<xs:element name="Sisu" type="xs:string" />
</xs:sequence>
</xs:complexType>
</xs:element>
</xs:sequence>
</xs:complexType>
</xs:element>
</xs:sequence>
</xs:complexType>
</xs:element>
</xs:sequence>
</xs:complexType>
</xs:element>
</xs:schema>
</source>

=== XSLT ===
<source lang="xml">
<?xml version="1.0" encoding="utf-8"?>
<xsl:stylesheet version="1.0" xmlns:xsl="http://www.w3.org/1999/XSL/Transform">
<xsl:template match="/">
<html>
<body>
<h2>Kohvikus müüdavad toidud</h2>
<table border="1">
<tr bgcolor="#9acd32">
<th>Toidu Nimetus</th>
<th>Toidu liik</th>
<th>Veel alles</th>
<th>Portsjon</th>
<th>Müügiaeg</th>
<th>Hind</th>
<th>Soodustus</th>
<th>Soodustuse liik</th>
<th>Kommentaar(id)</th>
</tr>
<xsl:for-each select="Toidud/Toit">
<tr>
<td><xsl:value-of select="ToiduNimetus"/></td>
<td><xsl:value-of select="ToiduLiik"/></td>
<td><xsl:value-of select="OlemasolevatYhikut"/></td>
<td>
<xsl:for-each select="ToiduKogus/Portsjon">
<table>
<tr>
<td>
<xsl:value-of select="PortsjoniLiik" />
</td>
</tr>
</table>
</xsl:for-each>
</td>

<td>
<xsl:for-each select="ToiduKogus/Portsjon">
<table>
<tr>
<td>
<xsl:value-of select="Myygiaeg/Paev" />/<xsl:value-of select="Myygiaeg/Kuu" />/<xsl:value-of select="Myygiaeg/Aasta" />  
<xsl:value-of select="Myygiaeg/Tund" />:<xsl:value-of select="Myygiaeg/Minut" />:<xsl:value-of select="Myygiaeg/Sekund" />
</td>
</tr>
</table>
</xsl:for-each>
</td>

<td>
<xsl:for-each select="ToiduKogus/Portsjon">
<table>
<tr>
<td>
<xsl:value-of select="ToiduHind/Eurohind" />
</td>
</tr>
</table>
</xsl:for-each>
</td>

<td>
<xsl:for-each select="ToiduKogus/Portsjon">
<table>
<tr>
<td>
<xsl:value-of select="ToiduHind/Soodustus/SoodustuseProtsent" />
</td>
</tr>
</table>
</xsl:for-each>
</td>

<td>
<xsl:for-each select="ToiduKogus/Portsjon">
<table>
<tr>
<td>
<xsl:value-of select="ToiduHind/Soodustus/SoodustuseLiik" />
</td>
</tr>
</table>
</xsl:for-each>
</td>

<td>
<xsl:for-each select="Kommentaarid/Kommentaar">
<table>
<tr>
<td>
<xsl:value-of select="Sisu" /> (<xsl:value-of select="Saatja/SaatjaRoll" /> <xsl:value-of select="Saatja/SaatjaNimi" />)
</td>
</tr>
</table>
</xsl:for-each>
</td>

</tr>
</xsl:for-each>
</table>
</body>
</html>
</xsl:template>
</xsl:stylesheet>
</source>

XSLT poolt loodud tulemus on järgnev (lisasin veel kaks toitu XML faili, siin wiki lehel on ruumi kokkuhoiuks vaid 1 toit toitude listis):
[[File:Xslt.jpg|1200px]]

== Arhitektuur ==

Süsteem oli vahepeal plaanis ehitada kolmekihilise arhitektuuriga ([http://en.wikipedia.org/wiki/Multitier_architecture#Three-tier_architecture Three-tier architecture]). See peaks lihtsustama süsteemi haldamist ja laiendamist tulevikus. Aga kuna selle jaoks otsest vajadust polenud ja oleks vaid süsteemi keeruliseks ajanud, siis loobusime sellest.

[[Image:three-tier.png|thumb|center|alt=Arhitektuuri skeem.|Arhitektuuri skeem.]]

== Veebiteenus ==
===Andmemudel===
[[Image:KohvikuAndmemudel.jpg|thumb|right|alt=Kohviku projekti andmemudel|Andmemudel]]
Enne veebiteenuse meetodite kirjeldamist koostasime andmemudeli. Loodud andmemudeli põhjal lõime andmebaasi vajalike tabelite ja atribuutidega. Andmemudeli peal on rohelisega tähistatud tabelid, mis on oseselt seotud kohviku valdajaga ja mida WPF rakenduse jaoks kindlasti vaja on. Ülejäänud helesinised tabelid on vajalikud kasutajate võimaluste jaoks. Lisaks on andmemudelil kaks tabelit, mis pole teisega seotud, need on süsteemi administraatori jaoks, et oleks ülevaade, mis rakendused teenust enim kasutavad ning mis meetodeid kõige rohkem välja kutsutakse.

===Teenuskihis olevad meetodid===

====Kasutajatega seotud meetodid:====
*SaidiKasutajaLiik() - Tagastab antud kasutaja ID järgi kasutaja liigi nimetuse
*KustutaSaidiKasutaja() - Kustutab antud kasutaja ID järgi kasutaja tabelis Kasutaja
*AnnaKoikSaidiKasutajad() - Tagastab kõik kirjed tabelist Kasutaja
*AnnaKoikKohvikuKasutajad() - Tagastab antud kohviku ID järgi kõik kohviku kasutajad massiivina
*MuudaSaidiKasutajaLiik() - Muudab antud kasutaja ID järgi kasutaja liigi tabelis Kasutaja
*KoikLubatudSaidiKasutajaTyybid() - Tagastab andmebaasi kõik võimalikud kohviku kasutaja rollid (id-d ja nimed), muud andmed jäävad tühjaks
*KoikLubatudKohvikuRollid() - Tagastab andmebaasi kõik võimalikud site kasutaja rollid (id-d ja nimed), kohviku_id jääb tühjaks
*KasutajaKohvikuRollid() - Tagastab antud kasutaja ID järgi kõik kasutaja rollid kõikides kohvikutes
*MuudaKohvikuKasutajaRoll() - Muudab antud kasutaja ID ja kohviku ID järgi kasutaja rolli kohvikus, kui rolli pole, siis tekitatakse uus
*SaidiKasutajaLiikID() - Tagastab antud kasutaja ID järgi kasutaja liigi ID
*KohvikuKasutajaLiikID() - Tagastab antud kasutaja ID ja kohviku ID järgi kohviku kasutaja rolli ID
*AnnaKasutajaMeiliAadress() - Tagastab antud kasutaja nime alusel kasutaja meiliaadressi
*AnnaKasutajaIdJargi() - Tagastab kasutajanime kasutaja ID järgi
*AuthendiKasutaja() - Autendib kasutaja, õnnestumisel tagastab kasutaja ID, ebaõnnestumisel null
*RegistreeriKasutaja() - Registreerib kasutaja andmebaasi ja tagastab true kui kasutaja loomine õnnestus

====Menüüga seotud meetodid====
*LisaArtikkelMenuuse() - Seob menüüartikli ja menüü
*LisaKohvikuleMenuu() - Seob menüü ja kohviku
*TagastabMenuuMuutujad() - Tagastab menüü järgi kas inimesel oleks õigust seda muuta
*KustutaMenuuJaKohvikuSeos() - Kustutab menüü ja kohviku seose
*LisaUusMenuu() - Teeb uue menüü, seob selle kohvikuga, kui kohviku ID on parameetrina kaasa antud
*MenuuKohvikuIdJargi() - Tagastab kohviku ID järgi kohviku tänaste või mitte tänaste menüüde ID-de massiivi
*LisaMenuuArtikkelMenuuse() - Sisestab antud müügiartikli menüüsse, mille ID on menyy_id
*KustutaMenuuArtikkel() - Kustutab müügiartikli ID ja menüü ID järgi müügiartikli menüüst
*TagastaMenuuArtiklid() - Tagastab menüü ID järgi menüüs olevad müügiartiklid
*VahetaMenuuArtiklit() - Muudab antud müügiartikli tabelis Myygiartikkel
*MenuuNimetus() - Tagastab menüü ID järgi menüü nimetuse
*AnnaMuugiartiklidMidaMenuusPole() - Tagastab müügiartiklid, mis pole veel menüüs, kus on juba müügiartiklid, mille IDd on antud massiivis
*AnnaMenuuNimed() - Tagastab kõigi menüüde nimetused tabelis Menyy

====Kohvikutest üldiselt====
*KohvikuteNimed() - Tagastab kõigi kohvikute nimed massiivina
*KohvikuNimiIdJargi() - Tagastab antud kohviku ID järgi kohviku nime
*AnnaKoikOmanikuKohvikud() - Tagastab antud omaniku ID järgi kõik omaniku kohvikute ID-d massiivina
*Kohvikud() - Tagastab kõik kohvikute kirjed tabelist Kohvik
*KohvikuteArv() - Tagastab kõigi kohvikute arvu
*AnnaKaubad() - Tagastab kõik kaubad tabelist Kaup
*LisaKaup() - Lisab kauba kaupade nimekirja
*LisaKohvik() - Uue kohviku lisamine

====Kommentaaridega seotud meetodid:====
*KohvikuKommentaarideArv() - Kohviku kommentaaride arv
*AnnaKohvikuKommentaarid() - Tagastab kommentaarid lehtede kaupa
*AnnaKohvikuKommentaarideHinded() - Tagastab kommentaaride jaoks võimalikud hinded koos kirjeldustega
*LisaKohvikuKommentaar() - Lisab kohviku kommentaari

====Statistikaga seotud meetodid:====
*StatistikaRakendusteKohtaTana() - Tagastab rakenduse nimed ja nende vastu tehtud päringud tänasel päeval
*StatistikaRakendusteKohtaViimaneNadal() - Tagastab rakenduse nimed ja nende vastu tehtud päringud viimase nädala jooksul
*StatistikaRakendusteKohtaSellelKuul() - Tagastab rakenduse nimed ja nende vastu tehtud päringud selle kuu jooksul
*StatistikaRakendusteKohtaKokku() - Tagastab rakenduse nimed ja nende vastu tehtud päringud kogu aja vältel
*StatistikaMeetoditeKohtaTana() - Meetod leiab tänase päeva jooksul kasutatud meetodid ja paringute arvu
*StatistikaMeetoditeKohtaViimaneNadal() - Meetod leiab viimase nädala jooksul kasutatud meetodid ja paringute arvu
*StatistikaMeetoditeKohtaSellelKuul() - Meetod leiab kuu jooksul kasutatud meetodid ja paringute arvu
*StatistikaMeetoditeKohtaKokku() - Meetod leiab kogu aja vältel kasutatud meetodid ja paringute arvu

Veebiteenuse projekti (WCF + andmebaas) saab siit: http://enos.itcollege.ee/~rruga/VRII/Teenusekiht.zip

== Klientrakendus I : CMS ==

== Klientrakendus I : Veebirakendus ==

== Meeskonna kokkuvõttev aruanne ==

== Logi ==
=== 17. aprill ===
Wikilehe täiendamine andmemudeli ja veebiteenuse meetodite kirjeldusega.

=== 9. aprill ===
Tegime rollide halduse, münüüde muutmise vormi. Meili saatmine registreerimisel. Toimus andmebaasi andmemudeli väike muutus.

=== 30. märts ===
Tehtud on kohviku menüü ja kohviku kommenteerimise leht.

=== 26. märts ===
Tehtud on esimesed veebiteenuse meetodid ja veebirakendusele kasutajate registreerimine.

=== 10. märts ===
Väikese häki abil õnnestus kohviku kassa arvutis saada tööle üks Forms-i proovirakendus.

=== 8. märts ===
Kuna kassa-aparaadis on operatsioonisüsteemiks Windows XP ja raud on 1.99 GHz, 256 RAM siis peaks saama
prototüübiks teha sinna peale rakenduse, mille ülesandeks menüüga tegelemine.

=== 7. märts ===
Linnar Viik andis meile järgmist nõu: tuleb eristada kahte asja - see, mis peab valmis saama (''must'') ja see, mis oleks tore (''nice to have''). Valmis peab saama menüüga ekraan seinal (esialgu kasutajale prototüübi näitamiseks kasvõi näiteks PowerPoint-i abil tehtud). Alles siis kui on kasutajalt positiivne tagasiside saadud, võib edasi minna reaalse tarkvaralahenduse loomisega. Kui ka see on valmis ja kasutaja sellega rahul võib juurde mõelda ''nice to have'' asju (näiteks eelinfo järgmise päeva menüü kohta, üliõpilasesinduse sõnumite riba ja muid asju).

Saime teada, et kui tahame, et meie loodav süsteem suhtleks IT Kohviku kassasüsteemiga, siis tuleb selle süsteemi tootjatega ühendust võtta ja nendega konsulteerida.

=== 19.Veebruar ===
*Valmis XSLT fail.

=== 9.Veebruar ===
* Esmane versioon XML ja XML Schemast olemas
* Tekkis küsimus kas XSLT faili tuleb käsitsi tekitada või automaatselt.
* Küsimus oli ka kas lahendasime portsjoni asja mõistlikult või oleks mõni teine lähenemine parem olnud.
* Küsimus, kas XML fail on liiga üle pingutatud või sobiva keerukusega

=== 7. Veebruar ===
* Võtsime õppejõu poolt pakutud ideest kohe kinni, sest me eelistame teha praktilist asja, mida saab kasutada ja mille kasutamist saame ka iga päev jälgida.
* Esimese asjana otsustasime välja uurida mida meie "kliendid" (süsteemi tellijad) meilt ootavad. (Soovid idee punkti all)
* Valminud on lihtne teenusest ja klientidest koosnev süsteemi testmudel.

== Kasulikud lingid ==

http://www.codeproject.com/KB/WCF/WCF_auto_client_proxies.aspx

http://msdn.microsoft.com/en-us/library/ms178472.aspx

http://support.microsoft.com/kb/305141

http://msdn.microsoft.com/en-us/library/aa702565.aspx

http://weblogs.asp.net/scottgu/archive/2007/04/06/tip-trick-enabling-ssl-on-iis7-using-self-signed-certificates.aspx

[[Category: Võrgurakendused II: hajussüsteemide ehitamine]]
[[Category: Veebirakenduste loomine ASP.NET abil]]

Meeskond "FoodWars"

2011-03-15T16:46:47Z

Lkermas:

2010-10-03T15:00:11Z

Lkermas:

Meeskond "hetkel nimetu"

2010-10-03T14:20:14Z

Lkermas:

[[Category: Programmeerimine CSharp keeles]]

=Mängu üldine kirjeldus=

Mängu graafiline pool peaks põhinema Axiom graafika mootoril (http://axiom.codeplex.com/), sisend ning heli (ja mõned asjad ehk veel) XNA komponentidel. Võimalik on täiendavate võrgu ja füüsika komponentide lisamine.

=Tiimiga liitumine=

Tiimiga liitumiseks pole vaja teha muud, kui lisada oma nimi liikmete loetellu (kui seal veel vabu kohti on), ja lisaks saata ka meil oma kontakt andmetega (vähemalt meili aadress) IT Kolledži meilile "lkermas" (saadetud andmed edastatakse hiljem ka teistele tiimi liikmetele, kuhugi veebi neid välja ei panda).

Projektiga seonduvate küsimuste ja probleemide korral võib samuti kirjutada IT Kolledži meilile "lkermas" (üldiselt üritan hiljemalt paari päeva jooksul vastata).

Lisaks võib end kohe kirja panna ka all pool toodud projekti alam töödele, mida teha soovitakse.

==Tiimi nime valik==

Ideid?

==Axiom'i ülesse seadmine==

Järgnevalt on toodud lühike juhend, kuidas Axiom Visual Studio 2010 all käima saada. Vastav materjal on saadaval ka Axiom'i enda lehel ([http://axiom3d.net/wiki/index.php/Basic_Tutorial_0_(Setting_up_your_application,_Windows) Setting up your application]), ent on siiski paar aspekti, mida siin tasuks mainida.

'''Antud meetod töötab ja on järgi proovitud ka klassis 317.'''

Kui pole plaanis Axiom'i lähtekoodist kompileerida, siis võib selle alla laadida projekti lehelt (http://axiom.codeplex.com/) Downloads sektsioonist (fail nimega '''Axiom-0.8.0.0-B2'''). Lisaks on Axiom'i kasutamiseks vajalik, et arvutis oleks installitud '''SlimDX''' (SDK versioon) ja/või '''XNA'''.

Seejärel tuleks Visual Studio's luua uus C# Console Application projekt. Loodud projekti kausta luuakse kaust '''PROJECT\PROJECT\bin''' (PROJECT tähistab projektile antud nime). Sellesse kausta tuleb kopeerida meedia kaust Axiom'i pakist asukohaga '''AXIOM\samples\media''' (AXIOM tähistab Axiom'i kausta nime). Lisaks kopeerida kausta '''PROJECT\PROJECT\bin\Debug''' kõik DLL ja XML failid kaustast '''AXIOM\samples\dotnet'''.

Visual Studio's tuleb siis Solution Explorer'is teha parem klõps projekti puus '''References''' valikul ning valida '''Add Reference''' ja avanevas aknas liikuda '''Browse''' tab'ile. Seejärel liikuda kausta '''PROJECT\PROJECT\bin\Debug''' ning kasutades Shift ja Ctrl klahve valida kõik DLL failid, välja arvatud '''cg.dll''', '''DevIL.dll''', '''ILU.dll'''.

Kui see on tehtud, siis lisada projekti '''Main''' meetodisse Axiom'i tutorial'is ([http://axiom3d.net/wiki/index.php/Basic_Tutorial_0_(Setting_up_your_application,_Windows) Setting up your application]) lehe alumises osas olev kood. Seejuures tuleks kopeeritud koodis kontrollida, et koodi teisel real oleks seatud õige renderdus süsteem. Vastavalt kas siis

root.RenderSystem = root.RenderSystems["OpenGL"];

või hoopis

root.RenderSystem = root.RenderSystems["DirectX9"];

kuna Axiom DirectX10't veel ei toeta (seega Windows 7 ja Vista kasutajad peaks valima OpenGL variandi).

Lõpuks tuleks '''Main''' meetodiga faili algusesse seada veel järgmised '''using''' laused (need using laused, mis seal algselt on, võib ära kustutada).

using System;
using Axiom.Core;
using Axiom.Graphics;
using Axiom.Demos.Configuration;
using Axiom.Math;

Enne programmi käivitamist tuleks kontrollida, et see kompileeritakse '''x86''' arhitektuurile, mitte aga '''x64''' arhitektuuri jaoks (kuna Axiom'i allalaetavad failid on x86 arhitektuuriga). Arhitektuuri valik on Visual Studio üleval ribal käivitus noole ja Debug valiku kõrval.

Kui kõik on valmis saab test koodi käivitada. Ekraanile peaks tekkima pilt. Pildi akna sulgemiseks sulgeda konsooli aken.

Juhul, kui aga pilti ei teki, tuleks esmalt kontrollida, et SlimDX (SDK versioon) ja/või XNA oleks installitud. Samuti ei tohiks projektini viivate kaustade nimedes olla tühikuid. Kui see ei aita, võib proovida uuendada oma video kaarti draivereid.

Kui siiski ei õnnestu pilti ekraanile saada, siis võib pöörduda Axiom'i Tutorial'i lõpus ([http://axiom3d.net/wiki/index.php/Basic_Tutorial_0_(Setting_up_your_application,_Windows) Setting up your application]) toodud foorumi lingile, ning seal arendajatelt abi küsida.

==Mängu komponentide/tööde ülevaade==

Siin siis toodud algne ülevaade asjadest, mida mängu juures teha tuleks. Lisaks on igale alam ülesandele üritatud anda ka umbkaudne keerukuse hinnang. Kui on soovi projekti juures mõne loetelust välja jäänud tööga tegeleda, siis võib selle siia lisada.

Tabelisse võiks kirja panna, kes millegagi tegeleda soovib. Sama asjaga saaks tegeleda ka mitu inimest, kui see pole just väga väikse. Lisaks, need kes end progemises veidi kindlamalt tunnevad, võiks muidugi valida raskemaid töid.

Üldiselt ehitatakse kogu mäng ühe keskse komponendi ümber. Seepärast ei ole suurt probleemi, kui mõni valikuline töö tegemata jääb.

Tööd ise jagunevadki sisuliselt 3 klassi:
* '''oluline''' - neid komponente on kindlasti vaja, et asi töötaks;
* '''nõutud ülesandes''' - ära toodud ülesande kirjelduses;
* '''vajalik''' - sellised tööd tuleks ära teha, ehkki mängu tööd need suurt ei mõjuta;
* '''valikuline''' - neid asju pole tingimata vaja, aga need annaks midagi juurde.

Baas komponent on see, mis teisi käivitab ja haldab. Mängu üld tsüklit võiks kujutada umbes järgneval viisil.

Baas komponendi initsialiseerimine
Baas komponendi tsükli käivitamine
Sisendi komponendilt andmete võtmine
Võrgu komponendilt andmete võtmine
Mängu objektide liigutamine
Füüsika vastava komponendi poolt
Muu mängu loogika ja ülejäänud komponendid
Graafika komponendi poolt pildi joonistamine
Baas komponendi kustutamine
TÖÖ LÕPP

Iseenesest on enamik töid projektis tehtavad ülejäänud mängust eraldi, kuna nende tulemuseks luuakse võrdlemisi iseseisvad komponendid (näiteks objektide üle võrgu saatmise komponent).

Kui vaja, siis Wiki's tabelitega töötamisel võib abiks olla järgnev link: http://en.wikipedia.org/wiki/Help:Table.

===Mängu olulisemad komponendid/tööd===

{| border="1"
! scope="col" | Komponendi/töö nimetus
! scope="col" | Olulisus ja lühikirjeldus
! scope="col" | Oletatav keerukus
! scope="col" | Kes mida teeb/teha tahab
! scope="col" | Tähtaeg orienteeruvalt
|-
! scope="row" | Baas osa progemine
| Oluline - alus edasisele tööle.
| keskpärane/raske
| Lauri Kermas - hetkel tegelen rakenduse üldise põhja loomisega (loodan selle valmis saada hiljemalt 7. oktoobriks).
| 07.10 (neljapäev)
|-
! scope="row" | Sisend süsteeemi loomine
| Oluline - sisend klaviatuurilt ja hiirelt.
| lihtne
|
| 09.10 (laupäev)
|-
! scope="row" | Xbox'i puldi sisend
| Nõutud ülesandes - sisend puldilt.
| lihtne/keskpärane
|
| 11.10 (esmaspäev)
|-
! scope="row" | Võrgus andmete vahetamise komponent
| Oluline - vajalik andmete saatmiseks üle võrgu.
| keskpärane/raske
|
| 14.10 (neljapäev)
|-
! scope="row" | Punktiarvestus
| Nõutud ülesandes - mängijate tapmised/surmad.
| lihtne/keskpärane
|
| 16.10 (laupäev)
|-
! scope="row" | Mudelite loomine
| Vajalik - tanki 3D mudelid.
| keskpärane
|
| 16.10 (laupäev)
|-
! scope="row" | Heli komponent
| Valikuline - audio komponent.
| lihtne/keskpärane
|
| 16.10 (laupäev)
|-
! scope="row" | Võrgutoe integreerimine projekti
| Oluline - mängu klient/server kujule viimine.
| raske
| Lauri Kermas
| 17.10 (pühapäev)
|}

===Täiendavad komponendid/tööd===

{| border="1"
! scope="col" | Komponendi/töö nimetus
! scope="col" | Olulisus ja lühikirjeldus
! scope="col" | Oletatav keerukus
! scope="col" | Kes mida teeb/teha tahab
! scope="col" | Tähtaeg orienteeruvalt
|-
! scope="row" | Mängusisene menüü
| Valikuline - lihtsa mängusisese menüü loomine.
| keskpärane
|
| 17.10 (pühapäev)
|-
! scope="row" | Füüsika lisamine
| Valikuline - lihtne 3D füüsika.
| keskpärane/raske
|
| 17.10 (pühapäev)
|-
! scope="row" | Graafika efektid
| Valikuline - täiendav silmailu (nagu näiteks suitsu efektid).
| keskpärane/raske
|
| 18.10 (esmaspäev)
|}

===Vähetähtsad komponendid/tööd===

{| border="1"
! scope="col" | Komponendi/töö nimetus
! scope="col" | Olulisus ja lühikirjeldus
! scope="col" | Oletatav keerukus
! scope="col" | Kes mida teeb/teha tahab
! scope="col" | Tähtaeg orienteeruvalt
|-
! scope="row" | Mängusisene konsool
| Valikuline - konsooli loomine mängu.
| keskpärane/raske
|
| 17.10 (pühapäev)
|-
! scope="row" | Skriptimis võimaluse lisamine
| Valikuline - Skriptimootori lisamine.
| keskpärane/raske
|
| 17.10 (pühapäev)
|}

=Komponentide ja tööde pikemad kirjeldused=

==Baas tsükkel ja haldus==

Mängu keskne komponent on vajalik mängu üldiseks haldamiseks. See kasutab .NET ja Axiom'i teeke mängu põhitsükli ülesse seadmiseks ja haldamiseks.

See komponent kuulub baas osa juurde.

==Keskkonna halduse komponent==

Mängu "maailma" hoitakse ja hallatakse Axiom'i komponentide abil.

See komponent kuulub baas osa juurde.

==Graafika komponent==

Graafika komponent luuakse samuti Axiom'i abil.

See komponent kuulub baas osa juurde.

==Täiendavad graafika efektid==

Antud töö puhul on tegemist graafiliste efektide (nagu suits, sädemed jne.) lisamisega mängule. Kuna mängu graafika põhineb Axiom graafika mootoril, siis on järgnevalt toodud mõningad seda puudutavad materjalid.

Axiom põhineb oluliselt OGRE 3D graafika mootoril. Seepärast on ehk parem alustada järgnevatelt lehtedelt. Lisaks eksisteerib ka OGRE .NET wrapper MOGRE, mis sarnaneb veidi rohkem Axiom'ile - need materjalid peaks seega antud projekti puhul veidi asjakohasemad olema.
* OGRE põhileht: http://www.ogre3d.org/.
* MOGRE tutorial'id: http://www.ogre3d.org/tikiwiki/Mogre+Tutorials.
* OGRE tutorial'id: http://www.ogre3d.org/tikiwiki/Tutorials.
* OGRE manual: http://www.ogre3d.org/docs/manual/.
* OGRE code snippets: http://www.ogre3d.org/tikiwiki/Snippets.

Axiom'i materjalid.
* Axiom'i põhi leht: http://axiom3d.net.
* SourceForge leht, kus on ka Axiom'i lähtekood: http://sourceforge.net/projects/axiomengine/.
* Axiom'i foorum: http://www.axiom3d.net/forums/.

==Sisendi komponendid==

Sisendi võib üldiselt jagada kaheks: arvuti sisend (klaviatuur ja hiir); Xbox'i sisend (pult). Nende sisendi süsteemide toe võib realiseerida erinevatel aegadel, ent oluline on arvuti sisend süsteem üsna kiirelt valmis saada. Sisendi realiseerimisel saab hästi kasutada XNA teeke.

Abiks võivad olla järgnevad materjalid.
* XNA teemaline raamat (vt. sisendi peatükk): https://www.facultyresourcecenter.com/curriculum/pfv.aspx?ID=8119.
* Responding to User Input: http://msdn.microsoft.com/en-us/library/bb203899.aspx.

Sisendi süsteemi loomisel võib olla abiks ka järgnevate avatud koodiga projektide lähtekood.
* http://oopsframework.codeplex.com/
* http://ig.codeplex.com/
* http://inputhandlers.codeplex.com/
* http://xcui.codeplex.com/
* http://ixnae.codeplex.com/
* http://gp2kb.codeplex.com/
* http://xnaextend.codeplex.com/
* http://autumn.codeplex.com/
* http://dwcontrollers.codeplex.com/
* http://saga.codeplex.com/

==Võrgutoe komponent==

Komponendi eesmärgiks on saata andmeid (soovitavalt objektide kujul) üle võrgu. Eeskujuks võiks siin ehk võtta [http://goblinxna.codeplex.com/ Goblin XNA] võrgu komponendi (või selle komponendi koguni antud projekti üle tuua), või võrgu toe hoopis ise kirjutada.

Näitena sobiks ehk järgnevad avatud koodi projektid.
* http://goblinxna.codeplex.com/
* http://kaleta.codeplex.com/

==Füüsika komponent==

Antud komponent peaks lisama füüsika reeglitele vastava käitumise mängu objektidele. Kasutada võiks ehk [http://jiglibx.codeplex.com/ JigLibX] või [http://oopsframework.codeplex.com/ Oops Framework] teeki, ent kui on soovi, saab antud osa ka ise progeda.

Füüsika teegid, või projektid, mis sisaldavad ise loodud füüsika komponenti.
* http://jiglibx.codeplex.com/
* http://oopsframework.codeplex.com/
* http://ig.codeplex.com/
* http://oxgameengine.codeplex.com/

==Heli komponent==

See komponent peaks võimaldama mängida heli ühekordselt või tsükliliselt. Lisaks peaks saama muuta heli tugevust. Heli komponent peaks olema lihtsalt realiseeritav XNA teekide abil.

Abiks võivad olla järgnevad raamatud/lehed.
* XNA teemaline raamat (vt. heli peatükk): https://www.facultyresourcecenter.com/curriculum/pfv.aspx?ID=8119.
* Creating and Playing Sounds: http://msdn.microsoft.com/en-us/library/bb195038.aspx.

Näiteks võib võtta järgmised heli kasutavad projektid.
* http://oopsframework.codeplex.com/
* http://ixnae.codeplex.com/
* http://autumn.codeplex.com/

==Mängusisene menüü==

Axiom mootoril puuduvad sisse ehitatud võimalused mängusisese menüü loomiseks. Siiski on sellel eesmärgil kasutatavad Axiom'i overlay'd. Väga keerulisi asju nendega tõenäoliselt teha ei saa, ent antud projekti jaoks peaks nendest piisama.

Mõned materjalid overlay'de kohta.
* OGRE Overlay lühikirjeldus: http://www.ogre3d.org/tikiwiki/tiki-index.php?page=-Overlay.
* OGRE Manual - Overlays: http://www.ogre3d.org/docs/manual/manual_12.html#SEC15.
* Axiom'i näiterakendus: http://axiom3d.net/wiki/index.php/ExampleApplication.cs.

==Mängusisene konsool==

Teksti konsool mängusiseste käskude andmiseks. Siin võibolla saab malli võtta [http://redbulb.codeplex.com/ RedBulb] teksti konsooli komponendilt (sellel projektil paistab olevat ka mingisugune meedia konsool, ent see vist ei puutu siia).

Lingid.
* http://redbulb.codeplex.com/

==Skriptitavus==

Skriptimise võimaluse lisamine mängule. Selle jaoks võiks mängule lisada mõne skriptimootori.

Mõned lingid C# skriptimootoritele.
* http://ksharp.codeplex.com/
* http://blitscript.codeplex.com/

=Üldiselt kasulikud lingid XNA ja antud projekti jaoks=

XNA Creators Club Online

http://creators.xna.com/

XNAWiki

http://www.xnawiki.com/

XNA Game Studio (MSDN)

http://msdn.microsoft.com/en-us/library/aa468128.aspx

Introduction to Programming Through Game Development Using Microsoft XNA Game Studio

https://www.facultyresourcecenter.com/curriculum/pfv.aspx?ID=8119

Introduction to Programming Through Game Development Using Microsoft XNA Game Studio - Text Sample Code

https://www.facultyresourcecenter.com/curriculum/pfv.aspx?ID=8178

==Axiom==

* Axiom'i põhi leht: http://axiom3d.net.
* SourceForge leht, kus on ka Axiom'i lähtekood: http://sourceforge.net/projects/axiomengine/.
* Axiom'i foorum: http://www.axiom3d.net/forums/.
* Axiom'i näiterakendus: http://axiom3d.net/wiki/index.php/ExampleApplication.cs.
* OGRE põhileht: http://www.ogre3d.org/.
* MOGRE tutorial'id: http://www.ogre3d.org/tikiwiki/Mogre+Tutorials.
* OGRE tutorial'id: http://www.ogre3d.org/tikiwiki/Tutorials.
* OGRE manual: http://www.ogre3d.org/docs/manual/.
* OGRE code snippets: http://www.ogre3d.org/tikiwiki/Snippets.

Meeskond "hetkel nimetu"

2010-10-03T11:59:36Z

Lkermas:

[[Category: Programmeerimine CSharp keeles]]

=Mängu üldine kirjeldus=

Mängu graafiline pool peaks põhinema Axiom graafika mootoril (http://axiom.codeplex.com/), sisend ning heli (ja mõned asjad ehk veel) XNA komponentidel. Võimalik on täiendavate võrgu ja füüsika komponentide lisamine.

=Tiimiga liitumine=

Tiimiga liitumiseks pole vaja teha muud, kui lisada oma nimi liikmete loetellu (kui seal veel vabu kohti on), ja lisaks saata ka meil oma kontakt andmetega (vähemalt meili aadress) IT Kolledži meilile "lkermas" (saadetud andmed edastatakse hiljem ka teistele tiimi liikmetele, kuhugi veebi neid välja ei panda).

Projektiga seonduvate küsimuste ja probleemide korral võib samuti kirjutada IT Kolledži meilile "lkermas" (üldiselt üritan hiljemalt paari päeva jooksul vastata).

Lisaks võib end kohe kirja panna ka all pool toodud projekti alam töödele, mida teha soovitakse.

==Tiimi nime valik==

Ideid?

==Axiom'i ülesse seadmine==

Järgnevalt on toodud lühike juhend, kuidas Axiom Visual Studio 2010 all käima saada. Vastav materjal on saadaval ka Axiom'i enda lehel ([http://axiom3d.net/wiki/index.php/Basic_Tutorial_0_(Setting_up_your_application,_Windows) Setting up your application]), ent on siiski paar aspekti, mida siin tasuks mainida.

'''Antud meetod töötab ja on järgi proovitud ka klassis 317.'''

Kui pole plaanis Axiom'i lähtekoodist kompileerida, siis võib selle alla laadida projekti lehelt (http://axiom.codeplex.com/) Downloads sektsioonist (fail nimega '''Axiom-0.8.0.0-B2'''). Lisaks on Axiom'i kasutamiseks vajalik, et arvutis oleks installitud '''SlimDX''' (SDK versioon) ja/või '''XNA'''.

Seejärel tuleks Visual Studio's luua uus C# Console Application projekt. Loodud projekti kausta luuakse kaust '''PROJECT\PROJECT\bin''' (PROJECT tähistab projektile antud nime). Sellesse kausta tuleb kopeerida meedia kaust Axiom'i pakist asukohaga '''AXIOM\samples\media''' (AXIOM tähistab Axiom'i kausta nime). Lisaks kopeerida kausta '''PROJECT\PROJECT\bin\Debug''' kõik DLL ja XML failid kaustast '''AXIOM\samples\dotnet'''.

Visual Studio's tuleb siis Solution Explorer'is teha parem klõps projekti puus '''References''' valikul ning valida '''Add Reference''' ja avanevas aknas liikuda '''Browse''' tab'ile. Seejärel liikuda kausta '''PROJECT\PROJECT\bin\Debug''' ning kasutades Shift ja Ctrl klahve valida kõik DLL failid, välja arvatud '''cg.dll''', '''DevIL.dll''', '''ILU.dll'''.

Kui see on tehtud, siis lisada projekti '''Main''' meetodisse Axiom'i tutorial'is ([http://axiom3d.net/wiki/index.php/Basic_Tutorial_0_(Setting_up_your_application,_Windows) Setting up your application]) lehe alumises osas olev kood. Seejuures tuleks kopeeritud koodis kontrollida, et koodi teisel real oleks seatud õige renderdus süsteem. Vastavalt kas siis

root.RenderSystem = root.RenderSystems["OpenGL"];

või hoopis

root.RenderSystem = root.RenderSystems["DirectX9"];

kuna Axiom DirectX10't veel ei toeta (seega Windows 7 ja Vista kasutajad peaks valima OpenGL variandi).

Lõpuks tuleks '''Main''' meetodiga faili algusesse seada veel järgmised '''using''' laused (need using laused, mis seal algselt on, võib ära kustutada).

using System;
using Axiom.Core;
using Axiom.Graphics;
using Axiom.Demos.Configuration;
using Axiom.Math;

Enne programmi käivitamist tuleks kontrollida, et see kompileeritakse '''x86''' arhitektuurile, mitte aga '''x64''' arhitektuuri jaoks (kuna Axiom'i allalaetavad failid on x86 arhitektuuriga). Arhitektuuri valik on Visual Studio üleval ribal käivitus noole ja Debug valiku kõrval.

Kui kõik on valmis saab test koodi käivitada. Ekraanile peaks tekkima pilt. Pildi akna sulgemiseks sulgeda konsooli aken.

Juhul, kui aga pilti ei teki, tuleks esmalt kontrollida, et SlimDX (SDK versioon) ja/või XNA oleks installitud. Samuti ei tohiks projektini viivate kaustade nimedes olla tühikuid. Kui see ei aita, võib proovida uuendada oma video kaarti draivereid.

Kui siiski ei õnnestu pilti ekraanile saada, siis võib pöörduda Axiom'i Tutorial'i lõpus ([http://axiom3d.net/wiki/index.php/Basic_Tutorial_0_(Setting_up_your_application,_Windows) Setting up your application]) toodud foorumi lingile, ning seal arendajatelt abi küsida.

==Mängu komponentide/tööde ülevaade==

Siin siis toodud algne ülevaade asjadest, mida mängu juures teha tuleks. Lisaks on igale alam ülesandele üritatud anda ka umbkaudne keerukuse hinnang. Kui on soovi projekti juures mõne loetelust välja jäänud tööga tegeleda, siis võib selle siia lisada.

Tabelisse võiks kirja panna, kes millegagi tegeleda soovib. Sama asjaga saaks tegeleda ka mitu inimest, kui see pole just väga väikse. Lisaks, need kes end progemises veidi kindlamalt tunnevad, võiks muidugi valida raskemaid töid.

Üldiselt ehitatakse kogu mäng ühe keskse komponendi ümber. Seepärast ei ole suurt probleemi, kui mõni valikuline töö tegemata jääb.

Tööd ise jagunevadki sisuliselt 3 klassi:
* '''oluline''' - neid komponente on kindlasti vaja, et asi töötaks;
* '''nõutud ülesandes''' - ära toodud ülesande kirjelduses;
* '''vajalik''' - sellised tööd tuleks ära teha, ehkki mängu tööd need suurt ei mõjuta;
* '''valikuline''' - neid asju pole tingimata vaja, aga need annaks midagi juurde.

Baas komponent on see, mis teisi käivitab ja haldab. Mängu üld tsüklit võiks kujutada umbes järgneval viisil.

Baas komponendi initsialiseerimine
Baas komponendi tsükli käivitamine
Sisendi komponendilt andmete võtmine
Võrgu komponendilt andmete võtmine
Mängu objektide liigutamine
Füüsika vastava komponendi poolt
Muu mängu loogika ja ülejäänud komponendid
Graafika komponendi poolt pildi joonistamine
Baas komponendi kustutamine
TÖÖ LÕPP

Iseenesest on enamik töid projektis tehtavad ülejäänud mängust eraldi, kuna nende tulemuseks luuakse võrdlemisi iseseisvad komponendid (näiteks objektide üle võrgu saatmise komponent).

Kui vaja, siis Wiki's tabelitega töötamisel võib abiks olla järgnev link: http://en.wikipedia.org/wiki/Help:Table.

===Mängu olulisemad komponendid/tööd===

{| border="1"
! scope="col" | Komponendi/töö nimetus
! scope="col" | Olulisus ja lühikirjeldus
! scope="col" | Oletatav keerukus
! scope="col" | Kes mida teeb/teha tahab
! scope="col" | Tähtaeg orienteeruvalt
|-
! scope="row" | Baas osa progemine
| Oluline - alus edasisele tööle.
| keskpärane/raske
| Lauri Kermas - hetkel tegelen rakenduse üldise põhja loomisega (loodan selle valmis saada hiljemalt 7. oktoobriks).
| 07.10 (neljapäev)
|-
! scope="row" | Sisend süsteeemi loomine
| Oluline - sisend klaviatuurilt ja hiirelt.
| lihtne
|
| 09.10 (laupäev)
|-
! scope="row" | Xbox'i puldi sisend
| Nõutud ülesandes - sisend puldilt.
| lihtne/keskpärane
|
| 11.10 (esmaspäev)
|-
! scope="row" | Võrgus andmete vahetamise komponent
| Oluline - vajalik andmete saatmiseks üle võrgu.
| keskpärane/raske
|
| 14.10 (neljapäev)
|-
! scope="row" | Punktiarvestus
| Nõutud ülesandes - mängijate tapmised/surmad.
| lihtne/keskpärane
|
| 16.10 (laupäev)
|-
! scope="row" | Mudelite loomine
| Vajalik - tanki 3D mudelid.
| keskpärane
|
| 16.10 (laupäev)
|-
! scope="row" | Heli komponent
| Valikuline - audio komponent.
| lihtne/keskpärane
|
| 16.10 (laupäev)
|-
! scope="row" | Võrgutoe integreerimine projekti
| Oluline - mängu klient/server kujule viimine.
| raske
| Lauri Kermas
| 17.10 (pühapäev)
|}

===Mängu täiendavad komponendid/tööd===

{| border="1"
! scope="col" | Komponendi/töö nimetus
! scope="col" | Olulisus ja lühikirjeldus
! scope="col" | Oletatav keerukus
! scope="col" | Kes mida teeb/teha tahab
! scope="col" | Tähtaeg orienteeruvalt
|-
! scope="row" | Mängusisene menüü
| Valikuline - lihtsa mängusisese menüü loomine.
| keskpärane
|
| 17.10 (pühapäev)
|-
! scope="row" | Füüsika lisamine
| Valikuline - lihtne 3D füüsika.
| keskpärane/raske
|
| 17.10 (pühapäev)
|-
! scope="row" | Graafika efektid
| Valikuline - täiendav silmailu (nagu näiteks suitsu efektid).
| keskpärane/raske
|
| 18.10 (esmaspäev)
|}

=Komponentide ja tööde pikemad kirjeldused=

==Baas tsükkel ja haldus==

Mängu keskne komponent on vajalik mängu üldiseks haldamiseks. See kasutab .NET ja Axiom'i teeke mängu põhitsükli ülesse seadmiseks ja haldamiseks.

See komponent kuulub baas osa juurde.

==Keskkonna halduse komponent==

Mängu "maailma" hoitakse ja hallatakse Axiom'i komponentide abil.

See komponent kuulub baas osa juurde.

==Graafika komponent==

Graafika komponent luuakse samuti Axiom'i abil.

See komponent kuulub baas osa juurde.

==Täiendavad graafika efektid==

Antud töö puhul on tegemist graafiliste efektide (nagu suits, sädemed jne.) lisamisega mängule. Kuna mängu graafika põhineb Axiom graafika mootoril, siis on järgnevalt toodud mõningad seda puudutavad materjalid.

Axiom põhineb oluliselt OGRE 3D graafika mootoril. Seepärast on ehk parem alustada järgnevatelt lehtedelt. Lisaks eksisteerib ka OGRE .NET wrapper MOGRE, mis sarnaneb veidi rohkem Axiom'ile - need materjalid peaks seega antud projekti puhul veidi asjakohasemad olema.
* OGRE põhileht: http://www.ogre3d.org/.
* MOGRE tutorial'id: http://www.ogre3d.org/tikiwiki/Mogre+Tutorials.
* OGRE tutorial'id: http://www.ogre3d.org/tikiwiki/Tutorials.
* OGRE manual: http://www.ogre3d.org/docs/manual/.
* OGRE code snippets: http://www.ogre3d.org/tikiwiki/Snippets.

Axiom'i materjalid.
* Axiom'i põhi leht: http://axiom3d.net.
* SourceForge leht, kus on ka Axiom'i lähtekood: http://sourceforge.net/projects/axiomengine/.
* Axiom'i foorum: http://www.axiom3d.net/forums/.

==Sisend komponendid==

Sisendi võib üldiselt jagada kaheks: arvuti sisend (klaviatuur ja hiir); Xbox'i sisend (pult). Nende sisendi süsteemide toe võib realiseerida erinevatel aegadel, ent oluline on arvuti sisend süsteem üsna kiirelt valmis saada. Sisendi realiseerimisel saab hästi kasutada XNA teeke.

Abiks võivad olla järgnevad materjalid.
* XNA teemaline raamat (vt. sisendi peatükk): https://www.facultyresourcecenter.com/curriculum/pfv.aspx?ID=8119.
* Responding to User Input: http://msdn.microsoft.com/en-us/library/bb203899.aspx.

Sisendi süsteemi loomisel võib olla abiks ka järgnevate avatud koodiga projektide lähtekood.
* http://oopsframework.codeplex.com/
* http://ig.codeplex.com/
* http://inputhandlers.codeplex.com/
* http://xcui.codeplex.com/
* http://ixnae.codeplex.com/
* http://gp2kb.codeplex.com/
* http://xnaextend.codeplex.com/
* http://autumn.codeplex.com/
* http://dwcontrollers.codeplex.com/
* http://saga.codeplex.com/

==Võrgutoe komponent==

Komponendi eesmärgiks on saata andmeid (soovitavalt objektide kujul) üle võrgu. Eeskujuks võiks siin ehk võtta [http://goblinxna.codeplex.com/ Goblin XNA] võrgu komponendi (või selle komponendi koguni antud projekti üle tuua), või võrgu toe hoopis ise kirjutada.

Näitena sobiks ehk järgnevad avatud koodi projektid.
* http://goblinxna.codeplex.com/
* http://kaleta.codeplex.com/

==Füüsika komponent==

Antud komponent peaks lisama füüsika reeglitele vastava käitumise mängu objektidele. Kasutada võiks ehk [http://jiglibx.codeplex.com/ JigLibX] või [http://oopsframework.codeplex.com/ Oops Framework] teeki, ent kui on soovi, saab antud osa ka ise progeda.

Füüsika teegid, või projektid, mis sisaldavad ise loodud füüsika komponenti.
http://jiglibx.codeplex.com/
http://oopsframework.codeplex.com/
http://ig.codeplex.com/
http://oxgameengine.codeplex.com/

==Heli komponent==

See komponent peaks võimaldama mängida heli ühekordselt või tsükliliselt. Lisaks peaks saama muuta heli tugevust. Heli komponent peaks olema lihtsalt realiseeritav XNA teekide abil.

Abiks võivad olla järgnevad raamatud/lehed.
* XNA teemaline raamat (vt. heli peatükk): https://www.facultyresourcecenter.com/curriculum/pfv.aspx?ID=8119.
* Creating and Playing Sounds: http://msdn.microsoft.com/en-us/library/bb195038.aspx.

Näiteks võib võtta järgmised heli kasutavad projektid.
* http://oopsframework.codeplex.com/
* http://ixnae.codeplex.com/
* http://autumn.codeplex.com/

=Üldiselt kasulikud lingid XNA ja antud projekti jaoks=

XNA Creators Club Online

http://creators.xna.com/

XNAWiki

http://www.xnawiki.com/

XNA Game Studio (MSDN)

http://msdn.microsoft.com/en-us/library/aa468128.aspx

Introduction to Programming Through Game Development Using Microsoft XNA Game Studio

https://www.facultyresourcecenter.com/curriculum/pfv.aspx?ID=8119

Introduction to Programming Through Game Development Using Microsoft XNA Game Studio - Text Sample Code

https://www.facultyresourcecenter.com/curriculum/pfv.aspx?ID=8178

==Axiom==

* Axiom'i põhi leht: http://axiom3d.net.
* SourceForge leht, kus on ka Axiom'i lähtekood: http://sourceforge.net/projects/axiomengine/.
* Axiom'i foorum: http://www.axiom3d.net/forums/.
* OGRE põhileht: http://www.ogre3d.org/.
* MOGRE tutorial'id: http://www.ogre3d.org/tikiwiki/Mogre+Tutorials.
* OGRE tutorial'id: http://www.ogre3d.org/tikiwiki/Tutorials.
* OGRE manual: http://www.ogre3d.org/docs/manual/.
* OGRE code snippets: http://www.ogre3d.org/tikiwiki/Snippets.

Meeskond "hetkel nimetu"

2010-10-03T11:53:20Z

Lkermas:

[[Category: Programmeerimine CSharp keeles]]

=Mängu üldine kirjeldus=

Mängu graafiline pool peaks põhinema Axiom graafika mootoril (http://axiom.codeplex.com/), sisend ning heli (ja mõned asjad ehk veel) XNA komponentidel. Võimalik on täiendavate võrgu ja füüsika komponentide lisamine.

=Tiimiga liitumine=

Tiimiga liitumiseks pole vaja teha muud, kui lisada oma nimi liikmete loetellu (kui seal veel vabu kohti on), ja lisaks saata ka meil oma kontakt andmetega (vähemalt meili aadress) IT Kolledži meilile "lkermas" (saadetud andmed edastatakse hiljem ka teistele tiimi liikmetele, kuhugi veebi neid välja ei panda).

Projektiga seonduvate küsimuste ja probleemide korral võib samuti kirjutada IT Kolledži meilile "lkermas" (üldiselt üritan hiljemalt paari päeva jooksul vastata).

Lisaks võib end kohe kirja panna ka all pool toodud projekti alam töödele, mida teha soovitakse.

==Tiimi nime valik==

Ideid?

==Axiom'i ülesse seadmine==

Järgnevalt on toodud lühike juhend, kuidas Axiom Visual Studio 2010 all käima saada. Vastav materjal on saadaval ka Axiom'i enda lehel ([http://axiom3d.net/wiki/index.php/Basic_Tutorial_0_(Setting_up_your_application,_Windows) Setting up your application]), ent on siiski paar aspekti, mida siin tasuks mainida.

'''Antud meetod töötab ja on järgi proovitud ka klassis 317.'''

Kui pole plaanis Axiom'i lähtekoodist kompileerida, siis võib selle alla laadida projekti lehelt (http://axiom.codeplex.com/) Downloads sektsioonist (fail nimega '''Axiom-0.8.0.0-B2'''). Lisaks on Axiom'i kasutamiseks vajalik, et arvutis oleks installitud '''SlimDX''' (SDK versioon) ja/või '''XNA'''.

Seejärel tuleks Visual Studio's luua uus C# Console Application projekt. Loodud projekti kausta luuakse kaust '''PROJECT\PROJECT\bin''' (PROJECT tähistab projektile antud nime). Sellesse kausta tuleb kopeerida meedia kaust Axiom'i pakist asukohaga '''AXIOM\samples\media''' (AXIOM tähistab Axiom'i kausta nime). Lisaks kopeerida kausta '''PROJECT\PROJECT\bin\Debug''' kõik DLL ja XML failid kaustast '''AXIOM\samples\dotnet'''.

Visual Studio's tuleb siis Solution Explorer'is teha parem klõps projekti puus '''References''' valikul ning valida '''Add Reference''' ja avanevas aknas liikuda '''Browse''' tab'ile. Seejärel liikuda kausta '''PROJECT\PROJECT\bin\Debug''' ning kasutades Shift ja Ctrl klahve valida kõik DLL failid, välja arvatud '''cg.dll''', '''DevIL.dll''', '''ILU.dll'''.

Kui see on tehtud, siis lisada projekti '''Main''' meetodisse Axiom'i tutorial'is ([http://axiom3d.net/wiki/index.php/Basic_Tutorial_0_(Setting_up_your_application,_Windows) Setting up your application]) lehe alumises osas olev kood. Seejuures tuleks kopeeritud koodis kontrollida, et koodi teisel real oleks seatud õige renderdus süsteem. Vastavalt kas siis

root.RenderSystem = root.RenderSystems["OpenGL"];

või hoopis

root.RenderSystem = root.RenderSystems["DirectX9"];

kuna Axiom DirectX10't veel ei toeta (seega Windows 7 ja Vista kasutajad peaks valima OpenGL variandi).

Lõpuks tuleks '''Main''' meetodiga faili algusesse seada veel järgmised '''using''' laused (need using laused, mis seal algselt on, võib ära kustutada).

using System;
using Axiom.Core;
using Axiom.Graphics;
using Axiom.Demos.Configuration;
using Axiom.Math;

Enne programmi käivitamist tuleks kontrollida, et see kompileeritakse '''x86''' arhitektuurile, mitte aga '''x64''' arhitektuuri jaoks (kuna Axiom'i allalaetavad failid on x86 arhitektuuriga). Arhitektuuri valik on Visual Studio üleval ribal käivitus noole ja Debug valiku kõrval.

Kui kõik on valmis saab test koodi käivitada. Ekraanile peaks tekkima pilt. Pildi akna sulgemiseks sulgeda konsooli aken.

Juhul, kui aga pilti ei teki, tuleks esmalt kontrollida, et SlimDX (SDK versioon) ja/või XNA oleks installitud. Samuti ei tohiks projektini viivate kaustade nimedes olla tühikuid. Kui see ei aita, võib proovida uuendada oma video kaarti draivereid.

Kui siiski ei õnnestu pilti ekraanile saada, siis võib pöörduda Axiom'i Tutorial'i lõpus ([http://axiom3d.net/wiki/index.php/Basic_Tutorial_0_(Setting_up_your_application,_Windows) Setting up your application]) toodud foorumi lingile, ning seal arendajatelt abi küsida.

==Mängu komponentide/tööde ülevaade==

Siin siis toodud algne ülevaade asjadest, mida mängu juures teha tuleks. Lisaks on igale alam ülesandele üritatud anda ka umbkaudne keerukuse hinnang. Kui on soovi projekti juures mõne loetelust välja jäänud tööga tegeleda, siis võib selle siia lisada.

Tabelisse võiks kirja panna, kes millegagi tegeleda soovib. Sama asjaga saaks tegeleda ka mitu inimest, kui see pole just väga väikse. Lisaks, need kes end progemises veidi kindlamalt tunnevad, võiks muidugi valida raskemaid töid.

Üldiselt ehitatakse kogu mäng ühe keskse komponendi ümber. Seepärast ei ole suurt probleemi, kui mõni valikuline töö tegemata jääb.

Tööd ise jagunevadki sisuliselt 3 klassi:
* '''oluline''' - neid komponente on kindlasti vaja, et asi töötaks;
* '''nõutud ülesandes''' - ära toodud ülesande kirjelduses;
* '''vajalik''' - sellised tööd tuleks ära teha, ehkki mängu tööd need suurt ei mõjuta;
* '''valikuline''' - neid asju pole tingimata vaja, aga need annaks midagi juurde.

Baas komponent on see, mis teisi käivitab ja haldab. Mängu üld tsüklit võiks kujutada umbes järgneval viisil.

Baas komponendi initsialiseerimine
Baas komponendi tsükli käivitamine
Sisendi komponendilt andmete võtmine
Võrgu komponendilt andmete võtmine
Mängu objektide liigutamine
Füüsika vastava komponendi poolt
Muu mängu loogika ja ülejäänud komponendid
Graafika komponendi poolt pildi joonistamine
Baas komponendi kustutamine
TÖÖ LÕPP

Iseenesest on enamik töid projektis tehtavad ülejäänud mängust eraldi, kuna nende tulemuseks luuakse võrdlemisi iseseisvad komponendid (näiteks objektide üle võrgu saatmise komponent).

Kui vaja, siis Wiki's tabelitega töötamisel võib abiks olla järgnev link: http://en.wikipedia.org/wiki/Help:Table.

===Mängu olulisemad komponendid/tööd===

{| border="1"
! scope="col" | Komponendi/töö nimetus
! scope="col" | Olulisus ja lühikirjeldus
! scope="col" | Oletatav keerukus
! scope="col" | Kes mida teeb/teha tahab
! scope="col" | Tähtaeg orienteeruvalt
|-
! scope="row" | Baas osa progemine
| Oluline - alus edasisele tööle.
| keskpärane/raske
| Lauri Kermas - hetkel tegelen rakenduse üldise põhja loomisega (loodan selle valmis saada hiljemalt 7. oktoobriks).
| 07.10 (neljapäev)
|-
! scope="row" | Sisend süsteeemi loomine
| Oluline - sisend klaviatuurilt ja hiirelt.
| lihtne
|
| 09.10 (laupäev)
|-
! scope="row" | Xbox'i puldi sisend
| Nõutud ülesandes - sisend puldilt.
| lihtne/keskpärane
|
| 11.10 (esmaspäev)
|-
! scope="row" | Punktiarvestus
| Nõutud ülesandes - mängijate tapmised/surmad.
| lihtne/keskpärane
|
| 16.10 (laupäev)
|-
! scope="row" | Mudelite loomine
| Vajalik - tanki 3D mudelid.
| keskpärane
|
| 16.10 (laupäev)
|-
! scope="row" | Heli komponent
| Valikuline - audio komponent.
| lihtne/keskpärane
|
| 16.10 (laupäev)
|}

===Mängu täiendavad komponendid/tööd===

{| border="1"
! scope="col" | Komponendi/töö nimetus
! scope="col" | Olulisus ja lühikirjeldus
! scope="col" | Oletatav keerukus
! scope="col" | Kes mida teeb/teha tahab
! scope="col" | Tähtaeg orienteeruvalt
|-
! scope="row" | Objektide osadeks serialiseerimis komponent
| Valikuline - vajalik andmete saatmiseks üle võrgu.
| keskpärane
|
| 09.10 (laupäev)
|-
! scope="row" | Võrgus andmete vahetamise komponent
| Valikuline - vajalik andmete saatmiseks üle võrgu.
| keskpärane/raske
|
| 14.10 (neljapäev)
|-
! scope="row" | Võrgu toe integreerimine projekti
| Valikuline - mängu klient/server kujule viimine.
| raske
|
| 17.10 (pühapäev)
|-
! scope="row" | Mängusisene menüü
| Valikuline - lihtsa mängusisese menüü loomine.
| keskpärane
|
| 17.10 (pühapäev)
|-
! scope="row" | Füüsika lisamine
| Valikuline - lihtne 3D füüsika.
| keskpärane/raske
|
| 17.10 (pühapäev)
|-
! scope="row" | Graafika efektid
| Valikuline - täiendav silmailu (nagu näiteks suitsu efektid).
| keskpärane/raske
|
| 18.10 (esmaspäev)
|}

=Komponentide ja tööde pikemad kirjeldused=

==Baas tsükkel ja haldus==

Mängu keskne komponent on vajalik mängu üldiseks haldamiseks. See kasutab .NET ja Axiom'i teeke mängu põhitsükli ülesse seadmiseks ja haldamiseks.

See komponent kuulub baas osa juurde.

==Keskkonna halduse komponent==

Mängu "maailma" hoitakse ja hallatakse Axiom'i komponentide abil.

See komponent kuulub baas osa juurde.

==Graafika komponent==

Graafika komponent luuakse samuti Axiom'i abil.

See komponent kuulub baas osa juurde.

==Täiendavad graafika efektid==

Antud töö puhul on tegemist graafiliste efektide (nagu suits, sädemed jne.) lisamisega mängule. Kuna mängu graafika põhineb Axiom graafika mootoril, siis on järgnevalt toodud mõningad seda puudutavad materjalid.

Axiom põhineb oluliselt OGRE 3D graafika mootoril. Seepärast on ehk parem alustada järgnevatelt lehtedelt. Lisaks eksisteerib ka OGRE .NET wrapper MOGRE, mis sarnaneb veidi rohkem Axiom'ile - need materjalid peaks seega antud projekti puhul veidi asjakohasemad olema.
* OGRE põhileht: http://www.ogre3d.org/.
* MOGRE tutorial'id: http://www.ogre3d.org/tikiwiki/Mogre+Tutorials.
* OGRE tutorial'id: http://www.ogre3d.org/tikiwiki/Tutorials.
* OGRE manual: http://www.ogre3d.org/docs/manual/.
* OGRE code snippets: http://www.ogre3d.org/tikiwiki/Snippets.

Axiom'i materjalid.
* Axiom'i põhi leht: http://axiom3d.net.
* SourceForge leht, kus on ka Axiom'i lähtekood: http://sourceforge.net/projects/axiomengine/.
* Axiom'i foorum: http://www.axiom3d.net/forums/.

==Sisend komponendid==

Sisendi võib üldiselt jagada kaheks: arvuti sisend (klaviatuur ja hiir); Xbox'i sisend (pult). Nende sisendi süsteemide toe võib realiseerida erinevatel aegadel, ent oluline on arvuti sisend süsteem üsna kiirelt valmis saada. Sisendi realiseerimisel saab hästi kasutada XNA teeke.

Abiks võivad olla järgnevad materjalid.
* XNA teemaline raamat (vt. sisendi peatükk): https://www.facultyresourcecenter.com/curriculum/pfv.aspx?ID=8119.
* Responding to User Input: http://msdn.microsoft.com/en-us/library/bb203899.aspx.

Sisendi süsteemi loomisel võib olla abiks ka järgnevate avatud koodiga projektide lähtekood.
* http://oopsframework.codeplex.com/
* http://ig.codeplex.com/
* http://inputhandlers.codeplex.com/
* http://xcui.codeplex.com/
* http://ixnae.codeplex.com/
* http://gp2kb.codeplex.com/
* http://xnaextend.codeplex.com/
* http://autumn.codeplex.com/
* http://dwcontrollers.codeplex.com/
* http://saga.codeplex.com/

==Võrgutoe komponent==

Komponendi eesmärgiks on saata andmeid (soovitavalt objektide kujul) üle võrgu. Eeskujuks võiks siin ehk võtta [http://goblinxna.codeplex.com/ Goblin XNA] võrgu komponendi (või selle komponendi koguni antud projekti üle tuua), või võrgu toe hoopis ise kirjutada.

Näitena sobiks ehk järgnevad avatud koodi projektid.
* http://goblinxna.codeplex.com/
* http://kaleta.codeplex.com/

==Füüsika komponent==

Antud komponent peaks lisama füüsika reeglitele vastava käitumise mängu objektidele. Kasutada võiks ehk [http://jiglibx.codeplex.com/ JigLibX] või [http://oopsframework.codeplex.com/ Oops Framework] teeki, ent kui on soovi, saab antud osa ka ise progeda.

Füüsika teegid, või projektid, mis sisaldavad ise loodud füüsika komponenti.
http://jiglibx.codeplex.com/
http://oopsframework.codeplex.com/
http://ig.codeplex.com/
http://oxgameengine.codeplex.com/

==Heli komponent==

See komponent peaks võimaldama mängida heli ühekordselt või tsükliliselt. Lisaks peaks saama muuta heli tugevust. Heli komponent peaks olema lihtsalt realiseeritav XNA teekide abil.

Abiks võivad olla järgnevad raamatud/lehed.
* XNA teemaline raamat (vt. heli peatükk): https://www.facultyresourcecenter.com/curriculum/pfv.aspx?ID=8119.
* Creating and Playing Sounds: http://msdn.microsoft.com/en-us/library/bb195038.aspx.

Näiteks võib võtta järgmised heli kasutavad projektid.
* http://oopsframework.codeplex.com/
* http://ixnae.codeplex.com/
* http://autumn.codeplex.com/

=Üldiselt kasulikud lingid XNA ja antud projekti jaoks=

XNA Creators Club Online

http://creators.xna.com/

XNAWiki

http://www.xnawiki.com/

XNA Game Studio (MSDN)

http://msdn.microsoft.com/en-us/library/aa468128.aspx

Introduction to Programming Through Game Development Using Microsoft XNA Game Studio

https://www.facultyresourcecenter.com/curriculum/pfv.aspx?ID=8119

Introduction to Programming Through Game Development Using Microsoft XNA Game Studio - Text Sample Code

https://www.facultyresourcecenter.com/curriculum/pfv.aspx?ID=8178

==Axiom==

* Axiom'i põhi leht: http://axiom3d.net.
* SourceForge leht, kus on ka Axiom'i lähtekood: http://sourceforge.net/projects/axiomengine/.
* Axiom'i foorum: http://www.axiom3d.net/forums/.
* OGRE põhileht: http://www.ogre3d.org/.
* MOGRE tutorial'id: http://www.ogre3d.org/tikiwiki/Mogre+Tutorials.
* OGRE tutorial'id: http://www.ogre3d.org/tikiwiki/Tutorials.
* OGRE manual: http://www.ogre3d.org/docs/manual/.
* OGRE code snippets: http://www.ogre3d.org/tikiwiki/Snippets.

Meeskond "hetkel nimetu"

2010-10-03T11:50:22Z

2010-10-02T13:42:44Z

Lkermas: /* Meeskonnad 2010 */