Red Alert: Reactor Overheat!

Krok 1: Reactor Class

Tvojou úlohou je vytvoriť triedu, ktorá bude modelovať reaktor v prostredí hry Alien Breed. Stav takého reaktora bude reprezentovaný aktuálnou teplotou jeho jadra, celkovým poškodením reaktora a animáciou, ktorá aktuálny stav graficky vizualizuje. Postupne budeš do tejto triedy pridávať aj správanie reaktora pri jeho činnosti.

Keďže projekt používa nástroj Gradle, je potrebné dodržať jeho konvenciu na umiestňovanie Java zdrojových súborov, a preto je potrebné vytvoriť tento balík v adresári src/main/java.

Zápis, ktorý v jazyku Java hovorí o tom, že trieda A je potomkom triedy B, je nasledovný:

class A extends B {
    // telo triedy
}

Trieda AbstractActor, ktorú použijete ako rodičovskú triedu novej triedy Reactor, predstavuje všeobecného aktéra hry. Je súčasťou knižnice GameLib, ktorá je definovaná medzi závislosťami nášho projektu. Nie je preto potrebné ju vytvárať. Stačí ju importovať do súboru vytvoreného pre triedu Reactor. V tomto vám ale dokáže pomôcť samotné vývojové prostredie po tom, čo napíšete názov triedy, ktorý kompilátor bez import príkazu nebude vedieť interpretovať.

Jedná sa o nasledovné členské premenné:

• temperature - aktuálna teplota reaktora, reprezentovaná celým číslom, pričom minimálna hodnota je 0 stupňov.
• damage - poškodenie reaktora, percentuálna hodnota, reprezentovaná celým číslom v rozsahu od 0 (nepoškodený) do 100 (zničený).
• normalAnimation - objekt animácie, ktorá reprezentuje bezporuchový stav reaktora. Použijeme typ Animation reprezentovaný triedou Animation z balíka sk.tuke.kpi.gamelib.graphics.

Pri tvorbe členských premenných nezabúdajte na to, že nechceme, aby boli voľne viditeľné mimo triedu! Použite preto patričný modifikátor viditeľnosti.

Poznámka

V počítačovej grafike (hlavne v súvislosti s 2D hrami) je možné sa veľmi často stretnúť s termínom sprite. Sprite je malý dvojrozmerný obrázok (alebo animácia), ktorý je integrovaný do väčšej scény. Efekt animácie často vzniká postupným zobrazením niekoľkých obrázkov (snímkov) na rovnakej pozícii.

V hernej knižnici, ktorú používame, budeme pracovať s objektami typu Animation, ktoré je možné rovnako použiť na jednoduché statické obrázky, ako aj na obrázky obsahujúce snímky animácie sprite-u.

V rámci inicializácie objektu nastavte:

• animáciu, ktorá bude znázorňovať reaktor, na nasledujúci obrázok

  

• počiatočnú teplotu jadra reaktora na hodnotu 0, a

• počiatočnú percentuálnu hodnotu poškodenia na hodnotu 0.

Animácie sa nachádzajú v projekte v priečinku src/main/resources/sprites/. Pri nastavovaní cesty k animácii používajte relatívnu cestu, pričom za koreňový priečinok je považovaný src/main/resources/. Cesta k animácii reaktora preto bude vyzerať takto: sprites/reactor_on.png.

Pre nastavenie animácie využite nasledovný fragment kódu umiestnený v konštruktore triedy Reactor:

// create animation object
normalAnimation = new Animation("sprites/reactor_on.png", 80, 80, 0.1f, Animation.PlayMode.LOOP_PINGPONG);
// set actor's animation to just created Animation object
setAnimation(normalAnimation);

Pokiaľ ste postupovali správne, po spustení projektu (Shift+F10) budete vedieť pomocou inšpektora vytvoriť inštanciu triedy Reactor a umiestniť ju do hry.

Tieto metódy poskytnú prístup na čítanie hodnôt teploty a poškodenia. Samozrejme, ich viditeľnosť je potrebné nastaviť na public. Následne viete opäť skontrolovať ich funkcionalitu pomocou inšpektora.

Krok 2: Intermezzo - Method Overloading

Teraz, keď už vieš, ako vytvoriť triedu a jej metódy, ukážeme ti jednu z užitočných vlastností polymorfizmu (ku ktorému sa ešte viackrát vrátime). Tou vlastnosťou je preťaženie metód (anglicky method overloading).

Ako animáciu použite sprite obrázok computer.

Každá z týchto metód bude mať 2 parametre rovnakého typu pre operandy danej aritmetickej operácie. Keďže raz to budú parametre typu int, raz float, implementáciou takýchto metód nastane ich tzv. preťaženie.

Implementáciu si môžete overiť po spustení hry pomocou nástroja Inšpektor.

Krok 3: Reactor (Over)Heating

Späť k reaktoru! Získať jeho stav už vieš, teraz sa pozrieme na to, ako jeho stav meniť.

Táto metóda nebude vracať žiadnu hodnotu a bude mať jeden celočíselný parameter (pomenovaný napr. increment), ktorý bude reprezentovať hodnotu, o ktorú sa má aktuálna teplota jadra zvýšiť.

Pri implementovaní metódy však zohľadnite nasledovné skutočnosti:

• S nárastom teploty lineárne zvyšujte poškodenie reaktora. Reaktor sa začne kaziť po prekročení teploty 2000 stupňov a prestane byť funkčný pri dosiahnutí 6000 stupňov. Následné ochladenie reaktora ale nezníži úroveň poškodenia, ktoré už vysoká teplota spôsobila (to znamená, že po volaní tejto metódy nemôže byť hodnota poškodenia reaktora nižšia ako pred jej volaním). Pri výpočte úrovne poškodenia zaokrúhľujte desatinnú časť výsledku nadol.

  

  Poznámka

  Znižovanie poškodenia reaktora bude možné jedine jeho opravou, ktorú budete riešiť nabudúce.

• Ak teplota po zvýšení prekročí hodnotu 4000 stupňov, vzhľad reaktora bude od tohto momentu reprezentovaný nasledujúcou animáciou:

  

• Ak je poškodenie reaktora v intervale <33%, 66%>, teplota rastie 1.5-násobne; ak prekročí hodnotu 66%, teplota porastie dvojnásobne. V oboch prípadoch je zmena uvedená oproti pôvodnej hodnote parametra increment. Po výpočte novej hodnoty teploty výsledok zaokrúhlite vždy nahor na najbližšie celé číslo.

• Ak teplota po zvýšení dosiahne (alebo prekročí) hodnotu 6000 stupňov, dôjde ku zničeniu reaktora (poškodenie reaktora dosiahne hodnotu 100%). Zničený reaktor bude reprezentovaný nasledujúcou animáciou:

  

• Ak poškodenie reaktora dosiahlo hodnotu 100%, akékoľvek ďalšie zvyšovanie teploty už nemá žiadny efekt.

Táto metóda nebude vracať žiadnu hodnotu a bude mať jeden celočíselný parameter (pomenovaný napr decrement), ktorý bude reprezentovať hodnotu, o ktorú sa má aktuálna teplota jadra znížiť. Pozor, zníženie teploty neznižuje poškodenie, ktoré vysoká teplota už spôsobila!

Pri implementovaní metódy zohľadnite nasledovné skutočnosti:

• Ak je poškodenie jadra aspoň 50%, reálne znižovanie teploty bude len polovičné oproti hodnote parametra decrement.
• Ak je poškodenie jadra na úrovni 100%, znižovanie teploty už nemá žiaden efekt.
• Ak teplota jadra pri ochladzovaní klesne na 4000 stupňov alebo menej, zmeňte animáciu reprezentujúcu stav reaktora na reactor_on.

Pri pozornom pohľade na metódy increaseTemperature() a decreaseTemperature() si všimnete, že obe metódy riešia nastavenie správnej animácie reaktora v závislosti na jeho teplote. Takáto duplicita je však zbytočná a komplikuje prípadnú zmenu funkcionality. Preto refaktorujte svoj kód tak, že túto spoločnú funkcionalitu oddelíte do samostatnej metódy updateAnimation().

Po refaktorizácii z predchádzajúcej úlohy nezabudnite zmeniť aj pôvodné metódy, kde sa extrahovaný kód nachádzal, aby vyžívali novú metódu.

Krok 4: Repository

Zdrojový kód nahrajte aj v prípade, ak ste nestihli dokončiť všetky úlohy. Rozpracované časti, ktoré by mohli spôsobiť kompilačné chyby, odporúčame zakomentovať.