• Responsabili: Anca Băluțoiu, Alex Grădinaru, Chris Brandon
• Lansare: 31 octombrie 2022
• Termen de predare: 13 noiembrie 2022, ora 23:59
• Regulament: Regulament general
• Notă: Orice informație ce nu a fost acoperită în acest document este la latitudinea voastră!

În cadrul temei 1, veți avea de implementat un joc de tipul Duck Hunt. Pentru inspirație, puteți testa jocul original aici: https://www.duck-hunt.org/. :)

Rațele sunt reprezentate de câteva primitive geometrice 2D (minimum 4: corp, aripi și cap), poziționate sugestiv. Puteți vedea o construcție propusă a raței în imaginea de mai jos, formată din 4 triunghiuri și un cerc (câte un triunghi pentru corp, aripi și cioc, și capul reprezentat de cerc).

Pentru a construi rața va fi așadar nevoie de un ansamblu de mai multe obiecte definite manual (vedeți modalitatea de definirea a pătratului din laborator) care se vor mișca împreuna, dar vor avea și animații independente. Astfel, rața:

• Va avea o animație de zbor: va da din aripi - puteți aplica de exemplu o rotație simplă pe fiecare aripă
• Va zbura în diverse direcții în mod unitar - tot asamblul obiectelor care compun rața se va mișca sau roti împreună

Pentru a obține aceste efecte, recomandăm folosirea de transformări ierarhice: va puteți construi o matrice de transformare a întregii rațe pe care să o aplicați fiecărei primitive în parte, după ce se aplică eventuale transformări individuale ale acestora.

Exemplu de funcționare a transformărilor ierarhice folosind OpenGL și glm (daca porniți de la laboratorul 3, se poate realiza similar folosind funcțiile definite in Transform2D):

1. Definim o structură ierarhică de transformări (relative la o matrice de modelare părinte)
2. Modificând o transformare pe lanțul ierarhic, aceasta se va propaga tuturor copiilor

Ratele apar cate una pe rand pe ecran, astfel incat la un moment dat sa nu fie decat o rata prezenta in scena. In momentul in care o rata este impuscata sau evadeaza se va putea afisa urmatoarea.

Rațele apar în partea de jos a ecranului și își vor începe zborul pe o direcție aleatoare în plan. Continuând pe acea direcție, la un moment dat vor ajunge la marginea ecranului. În această situație, rața trebuie să se “reflecte” și să își continue drumul în direcția aferentă, asemenea unei bile de biliard care lovește marginea mesei. Dacă rața este împușcată, aceasta va cădea pe sol mișcându-se printr-o animație vertical în jos, respectiv dacă evadează va zbura în afara ecranului mișcându-se printr-o animație vertical in sus.

După un număr rezonabil de secunde, în care rața s-a ciocnit de câteva ori de marginea ecranului, aceasta va evada. Numărul de secunde va depinde de viteza cu care se mișcă rața în implementarea voastră, dar propunem să fie în jur de 3-5 secunde pentru a nu sta foarte mult o singură rață pe ecran.

Așadar, rațele au 3 moduri de mișcare:

1. Activ: rața a apărut pe ecran și se mișcă pe o direcție, aceasta schimbându-se la momentul ciocnirii cu marginea ecranului. Din această stare, rata va tranziționa ori către starea de împușcat, ori către starea de evadat.
2. Împușcat: rața a fost împușcată și se va mișca vertical în jos, până ajunge la marginea de jos a ecranului, moment în care dispare
3. Evadat: rața a evadat și se va mișca vertical in sus, până ajunge la marginea de sus a ecranului, moment în care dispare

Observatie: capul ratei trebuie sa fie indreptat aproximativ spre directia de miscare :) Nu sunt permise rate care merg/zboara cu spatele.

Jucătorul va porni inițial cu 3 vieți. În momentul în care o rață scapă (jucătorul a ratat să nimerească rața cu toate cele 3 gloanțe), acesta pierde o viață. Numărul de vieți rămase vor fi desenate pe ecran, în colțul stânga sus, sub forma unor cercuri roșii.

La orice moment de timp, jucătorul trebuie să știe câte gloanțe mai are la dispoziție. Pentru asta, în colțul stânga sus (sub numărul de vieți) veți afișa și numărul de gloanțe disponibile în mod similar cu numărul de vieți, sub forma unor dreptunghiuri verzi.

Pentru fiecare rață împușcată, scorul jucătorului va crește. Acesta va fi și el reprezentat în interfața grafică în colțul dreapta-sus cu ajutorul a două dreptunghiuri:

• Un dreptunghi wireframe, care reprezintă nivelul maxim de scor (puteți considera un nivel maxim de scor de 50 sau orice altă valoare >10)
• Un dreptunghi solid, albastru, în interiorul celui wireframe, care reprezintă scorul curent

Scopul jocului este ca jucatorul sa impuste cat mai multe rate inainte sa ramana fara vieti. Jocul incepe cu un numar de vieti disponibile, dintre care se pierde cate una de fiecare data cand o rata reuseste sa scape fara sa fie impuscata.

Ratele apar cate una singura pe ecran, pe rand, fiecare dupa disparitia (prin evadarea sau impuscarea) celei anterioare. O rata va cadea pe sol cand este impuscata, si va zbura vertical in sus pentru a simboliza evadarea (sunt descrise deja detalii in sectiunile “Rate - Afisare” si “Rate - Miscare”). Ele se misca dupa regulile descrise la sectiunea “Rate - Miscare”. Dupa generarea a cate 5 rate, viteza de miscare a acestora va creste si, ca atare, dificultatea jocului va creste.

De exemplu: daca primele 5 rate se misca la o viteza v0, urmatoarele 5 ar putea avea viteza v1 = v0 + v0 / 5, urmatoarele v2 = v0 + 2 * v0 / 5 si asa mai departe, pentru a avea o modificare incrementala a dificultatii.

Pentru a impusca o rata, jucatorul are la dispozitie 3 gloante care se reincarca de fiecare data cand apare o noua rata. De fiecare data cand acesta face clic pe ecran, se va considera ca un glont a fost tras in acel punct pe ecran si numarul de gloante disponibile va scadea cu 1. Daca punctul de pe ecran (detalii sectiunea “Intersectia glontului cu rata”) care a fost impuscat intersecteaza rata, ea va fi considerata impuscata, scorul (detalii sectiunea “Scor”) va creste, si rata va cadea pe sol (detalii sectiunea “Rate - Miscare”).

Avand in vedere ca ratele au o forma destul de complexa, ar fi greu de calculat exact ce puncte de pe ecran se intersecteaza cu ele. Asadar, le puteti aproxima sub forma unui dreptunghi in care este incadrata rata (similar figurii de mai jos). Pentru a calcula coordonatele colturilor acestui patrat, puteti folosi cateva notiuni de geometrie in plan, aplicate in functie de coordonatele la care se afla punctele de pe silueta ratei.

Patratul incadrator este mult mai usor de calculat daca toate coordonatele locale ale primitivelor din care este construita rata sunt calculate fata de un punct cat mai apropiat de centrul ratei (detalii sectiunea “Rata - Constructie”).

Mai multe detalii despre aproximarea coliziunilor 2D: https://developer.mozilla.org/en-US/docs/Games/Techniques/2D_collision_detection

Pentru a afla daca mouse-ul se afla in interiorul dreptunghiului incadrator al ratei, trebuie facuta o conversie din coordonate de vizualizare catre coordonatele logice in care rata se plimba pe ecran. Daca va folositi de scheletul laboratorului 3, aceste 2 spatii de coordonate corespund 1:1 intrucat spatiul de desenare este limitat la rezolutia portii de afisare si se poate considera ca pozitia cursorului de mouse este si pozitia sa in coordonate logice. Altfel, va trebui aplicata o transformare similara cu cea fereastra poarta (detaliata tot in laboratorul 3), doar ca inversa. Atentie la corectia coordonatei Y.

Dupa ce cursorul si dreptunghiul se afla in acelasi spatiu de coordonate, verificarea intersectiei se rezuma la verificarea daca un punct in plan se afla intr-un dreptunghi aliniat cu axele Ox si Oy. Detaliile acestui calcul sunt lasate ca exercitiu pentru student.

Inputul de la mouse se poate trata in functia “OnMouseMove” din framework. Aceasta are 4 parametri: mouseX, mouseY, deltaX, deltaY. Primele 2 se refera la pozitia la care se afla cursorul in momentul in care se apeleaza functia, in pixeli. Numerotarea incepe din coltul stanga-sus al ferestrei de vizualizare in (0, 0). Cei 2 parametri din urma se refera la deplasarea exacta (tot in pixeli) a cursorului de la pozitia sa in frame-ul anterior pana la pozitia sa in frame-ul in care a fost apelata functia. De exemplu, daca mouse-ul s-a miscat de la pozitia (1200, 300) la pozitia (1220, 294) in intervalul de la ultimul frame pana la cel curent, vom avea urmatoarele valori: mouseX = 1220, mouseY = 294, deltaX = 20, deltaY = 294.

Atentie! Aceste valori sunt intregi, aveti grija la tipurile de date daca intentionati sa le impartiti. De asemenea, deltaX si deltaY deja sunt calculate fata de frame-ul anterior. Ca atare, nu mai este nevoie sa ne legam de deltaTimeSeconds pentru a avea o miscare independenta de frame rate.

In momentul in care toate cele 3 gloante au fost consumate fara a fi fost impuscata rata, aceasta evadeaza. De asemenea, daca rata nu a fost impuscata timp de un numar de secunde, va evada. In ambele situatii in care rata evadeaza, jucatorul va pierde o viata (detalii sectiunea “Vieti”) si nu va primi scorul aferent ratei respective.

• Miscare/animatii rata (75p total)
  • Desenare/asamblare figura geometrica rata 15p
  • Deplasare activa (deplasare ansamblu rata si animatii aripi) 20p
  • Pozitionare si directie initiala 10p
  • Reflexii 10p
  • Impuscat 10p
  • Evadare 10p
• Gameplay (75p total)
  • Aparitie rate, cate una pe ecran 5p
  • Incrementare viteza rate 5p
  • Temporizare evadare 5p
  • Trasul cu pusca
    • Tintire 20p
    • Coliziuni rata 20p
  • Interfata grafica (functionalitate si afisare)
    • Vieti 5p
    • Gloante 5p
    • Scor 10p

• Scor variabil în funcție de viteza raței și multiplier aplicat pentru număr de rațe împușcate consecutiv (killing spree). Este necesară afișarea unui element animat (de ex o formă simplă de romb care se rotește) în momentul atingerii acestui prag.
• După ce apar 5 rațe, se trece la următorul nivel: se afișează pe ecran un text care îi comunică jucătorului această schimbare și următoarele 5 rațe (până la schimbarea din nou a nivelului) se vor mișca mai repede.
• Boss fight, care apare de exemplu o dată la 10 rațe - o rața mai mare care se mișcă mai greu și trebuie împușcată de mai multe ori.
• Fiecare rață are o culoare aleatorie (similar cu jocul original) și își poate schimba direcția brusc/random, chiar dacă nu atinge marginea ecranului (poate face de exemplu o mișcare zig-zag cu temporizare aleatoare).
• Realizarea gazonului de jos în spatele căruia apare rața, astfel încât să nu apară brusc pe ecran de nicăieri.
• Rațe mai detaliate/complexe ca geometrie.
• Crosshair pe mouse și eventual o pușcă/armă animată în funcție de poziția cursorului pe ecran (să fie îndreptată/rotită spre cursor).
• Sistem de tragere animat (gloanțe vizibile, o mică animație în momentul în care se atinge rața - de exemplu sar niște ‘pene’ aproximate în direcții aleatorii).
• Rațe “speciale” care dau jucătorului anumite abilități (o viață extra, un glonț extra, toate rațele se vor mișca foarte încet pentru câteva secunde). Fiecare astfel de rață va avea o culoare specifică power up-ului pe care îl acordă si va exista un indicator de timp care arata cat timp mai dureaza acea abilitate (de ex o bara similara cu cea de scor, care scade in timp si dispare cand nu mai e valabila abilitatea).
• Animație complexă când moare rata.
• Posibilitatea de a avea mai multe rațe pe ecran în același timp și sistem de gestiune a gloanțelor corespunzător/îmbunătățit pentru mai multe rațe.

Pentru întrebări vom folosi forumurile de pe moodle. Orice nu este menționat în temă este la latitudinea fiecărui student!

Baremul este orientativ. Fiecare asistent are o anumită libertate în evaluarea temelor (de exemplu, să dea punctaj parțial pentru implementarea incompletă a unei funcționalități sau să scadă pentru hard coding). Același lucru este valabil atât pentru funcționalitățile obligatorii, cât și pentru bonusuri.

Tema va fi implementată în OpenGL și C++. Este indicat să folosiți framework-ul și Visual Studio.