�ݺ�ߣ

Rescue Mission Antonio Dallapè – 115401 Gabriele Baronti – 113188 Principles of Computer Graphics 2008 - 2009 Relazione esplicativa del codice

Layers RescueMission.Buttons.ButtonBaseLayer ButtonNewLayer RescueMission.WorldWind.CompassLayer RescueMission.WorldWind.ScaleBarLayer RescueMission.WorldWind.WorldMapLayer ButtonsBgLayer ButtonPathLayer ButtonAnimateLayer ButtonLOSLayer ButtonVisualLayer

Package Buttons Le classi in RescueMission.Buttons sono dei layers che per la maggior parte hanno funzione di bottoni Estendono quasi tutti da ButtonBaseLayer tranne ButtonsBgLayer ButtonNewLayer ButtonPathLayer ButtonLOSLayer e ButtonAnimateLayer sono bottoni molto simili che fondamentalmente hanno uno stato ‘premuto’ e uno ‘non premuto’ ButtonVisualLayer ha 4 stati possibili che vengono ciclati cliccandoci sopra (dallo stato 0 si passa all’1, dall’1 al 2, ecc...) ButtonsBgLayer scrive i suggerimenti e il Flare selezionato

ButtonBaseLayer Disegna un bottone e la parte di barra di sfondo sottostante alla posizione desiderata position determina la posizione sull’asse delle y: ALIGN_TOP - lo disegna in alto ALIGN_CENTER - lo disegna in centro ALIGN_BOTTOM - lo disegna in basso btnNumber determina la posizione sull’asse delle x: 0, 1, 2, … - moltiplicato per la larghezza totale di un bottone (considerando bordi, la scala, ecc…) mi da l’offset sulle x per poter disegnare un bottone al posto prestabilito Per disegnare correttamente il bottone in base alla scala desiderata e alla finestra vengono usate le funzioni: computeScale(...) getScaledButtonWidth(...) getScaledButtonHeight(...) computeLocation(...)

ButtonBaseLayer Viene disegnato nella funzione drawIcon(...) Nella fase di picking viene controllata la posizione del mouse e viene stabilito se si trova o meno sopra il bottone. Quindi viene settata la texture corretta a seconda se il mouse è sopra al bottone o meno, se il bottone è premuto o meno, o se il bottone è disattivato mouseExited(...) (Il mouse sicuramente non è sul bottone) Viene aggiornata la texture a seconda se il bottone è disattivato o meno

ButtonBaseLayer Per mantenere lo stato di un bottone si usano le variabili: isBtnPressed – se il bottone è premuto o meno isBtnOver – se il mouse è sopra il bottone isBtnEnabled – se il bottone è abilitato o meno mousePressed(...) – si setta isBtnPressed nel caso il mouse sia sopra il bottone, e si chiama buttonClicked(...) setEnabled(...) – si setta isBtnEnabled true o false setOnOff(...) – si setta isBtnPressed true o false e isBtnEnabled a true

ButtonNewLayer Estende ButtonBaseLayer Nel creatore vengono settate le variabili per posizionare il bottone e per trovare le textures buttonClicked(...) Set RescueMissionApplication.isNewPressed a true se era false e viceversa (sostanzialmente se non era premuto diventa premuto e se era premuto non lo è più)

ButtonPathLayer Estende ButtonBaseLayer Nel creatore vengono settate le variabili per posizionare il bottone e per trovare le textures buttonClicked(...) Setta, nel Flare selezionato, isArmed a true se era false e viceversa isArmed viene usata per sapere quando si sta disegnando i percorso (sostanzialmente se non era premuto diventa premuto e se era premuto non lo è più)

ButtonLOSLayer Estende ButtonBaseLayer Nel creatore vengono settate le variabili per posizionare il bottone e per trovare le textures buttonClicked(...) Setta, nel Flare selezionato, isOn a true se era false e viceversa isOn viene usata per sapere se è abilitato il Line Of Sight del Flare (sostanzialmente se non era premuto diventa premuto e se era premuto non lo è più)

ButtonLOSLayer Estende ButtonBaseLayer Nel creatore vengono settate le variabili per posizionare il bottone e per trovare le textures buttonClicked(...) Setta, nel Flare selezionato, isOn a true se era false e viceversa isOn viene usata per sapere se è abilitato il Line Of Sight del Flare Se viene abilitato lo si disegna (si setta isTimeToDo a true) altrimenti lo si cancella (deleteLineOfSight()) (sostanzialmente se non era premuto diventa premuto e se era premuto non lo è più)

ButtonAnimateLayer Estende ButtonBaseLayer Nel creatore vengono settate le variabili per posizionare il bottone e per trovare le textures buttonClicked(...) Chiama, nel Flare selezionato, setAnimate che fa partire o interrompe l’animazione a seconda se isAnimating era true o false (sostanzialmente se non era premuto diventa premuto e se era premuto non lo è più)

ButtonVisualLayer Estende ButtonBaseLayer Nel creatore vengono settate le variabili per posizionare il bottone e per trovare le textures In drawIcon(...) e mousePressed(...) viene implementata la logica per far funzionare il bottone come una sorta di lista che seleziona la voce seguente quando viene cliccata whatVisual – rappresenta la visuale selezionata 0 – la visuale libera 1 – la visuale dalla macchina della polizia (car) 2 – la visuale dall’F-117 (plane) 3 – la visuale dall’astronave (spaceshio)

ButtonVisualLayer buttonClicked(...) Setta, nel Flare selezionato, whatVisual al valore di visualSelected setEnabled(...) Abilita/disabilita il bottone e resetta visualSelected e whatVisual del Flare selezionato (vengono settate a 0)

ButtonsBgLayer Disegna la parte di barra sotto i suggerimenti, un cerchietto col colore del Flare selezionato e il nome di tale Flare Simile a ButtonBaseLayer ma non implementa MouseListener ed è più semplice Viene disegnato nella funzione drawIcon(...) Scrive suggerimenti diversi nel caso sia selezionato il bottone ‘New’, ‘Path’, o altro Disegna un cerchietto con il colore del flare selezionato con drawCircle(...) o una cerchietto vuoto se non è selezionato nulla con drawCirconference(...) Scrive il nome del file selezionato o ‘none selected’

Package WorldWind Le classi in RescueMission.WorldWind sono dei layers e altre classi di JWW che non sono state molto modificate CompassLayer – è il compass layer ma visualizzato in basso WorldMapLayer – è l’omonimo layer visualizzato in basso e ora importa MouseListener per far selezionare il luogo desiderato, dove ci si vuol spostare, direttamente da lì ScalebarLayer – è l’omonimo layer visualizzato in basso, in centro Configuration – è l’omonima classe che però legge i layer da caricare dal Configorldwind.properties locale, il quale farà caricare i layer stabiliti Polyline – è l’omonima classe che non implementa movable RayCastingSupport – è la classe che viene usata per calcolare e disegnare il Line Of Sight di un Flare

Colors Questa classe offre delle funzioni per ottenere dei colori univoci dispatchColor() – per ottenere un colore univoco isUsed(...) – per sapere se il colore è stato già usato La classe ha un array di 1024 elementi per memorizzare i colori già utilizzati, supponendo che nell’applicazione non saranno mai posizionati così tanti Flares

FlareGFXLoader Questa classe viene usata per caricare in RescueMissionApplication i modelli e le textures che saranno poi utilizzati dai flare Viene creata in RescueMissionApplication Estende Renderable e GLEventListener Inizialmente il caricamento dei modelli veniva eseguito all’inizializzazione di ogni Flare ma con alcune schede video dava errori al caricamento delle textures, inoltre essendo eseguito una volta sola rende il codice più ottimizzato

FlareDragger Questa classe estende SelectListener e permette di draggare i Flare Permette di selezionare un Flare cliccandoci sopra col tasto sinistro e di eliminarlo cliccandolo col destro Nel caso si stia disegnando il percorso di un Flare (se isArmed del Flare selezionato è true), le funzioni di selezione, cancellazione e dragging sono inibite

Flare Viene disegnato nella doRender(...), che viene chiamata all’interno della render(...) dopo l’inizializzazione avvenuta chiamando la initialize(...) Initialize(...) viene chiamata una sola volta e crea delle glCallList contenenti le informazioni per disegnare i modelli 3d e le sfere che compongono un Flare doRender(...) viene chiamata dalla render(...) disegnando il contenuto delle glCallList nella posizione attuale del Flare, pos, settando l’orientamento dei modelli 3d in base alla direzione del Flare (quando viene draggato o durante le animazioni) e l’inclinazione in base alla curva terrestre L’angolo della direzione viene salvato nella variabile globale angle Se isTimeToDo è true chiama la update() che aggiornerà il LOS La direzione viene calcolata usando pos e oldPos

Flare moveTo(…) aggiorna la posizione pos e oldPos e, se isAnimating è false, modifica il primo punto del percorso facendolo combaciare con la posizione attuale update(), se isOn è true, chiama la computeLineOfSight() computeLineOfSight(), se isComputing è false, lo setta a true, calcola nuovamente il LOS e lo disegna, una volta finito setta nuovamente isComputing a false deleteLineOfSight() cancella il LOS disegnato mouseReleased(...) e mouseWheelMoved(...) settano isTimeToDo a true, dato che corrispondono ad azioni del mouse che, cambiando posizione o vicinanza alla terra e conseguente aggiornamento delle altitudini, devono far ricalcolare il LOS

Flare addPosition() aggiunge un nodo al percorso e aggiorna la linea replacePosition() modifica l’ultimo nodo inserito e aggiorna la linea removePosition() cancella l’ultimo nodo inserito e aggiorna la linea setAnimate() utilizzando un thread anima il Flare, che segue il percorso stabilito, se isAnimating è true, altrimenti interrompe l’animazione Vengono calcolate lunghezza e posizioni intermedie per rendere la velocità del Flare uniforme Vengono utilizzate le varie visuali (car, plane, spaceship) a seconda della variabile whatVisual I modelli 3d vengono orientati in base alla variabile globale angle che è aggiornata alla direzione attuale Alla creazione del flare viene impostato un numero univoco che viene salvato in number

RescueMissionApplication La classe che contiene il main Contiene la classe AppFrame che estende JFrame, che alla creazione inizializza tutto l’ambiente sul quale si basa l’applicazione In variabili globali statiche, sono memorizzati I modelli 3d (model_spaceship, ...) Le textures (texture_plane, texture_car) I layer dei bottoni (bottonNewLayer, ...) Il numero del Flare selezionato (selectedFlare) Il layer su cui si disegnano i Flare (layer) Un’arraylist contenente i Flare (flares) Lo stato del bottone ‘NEW’ (isNewPressed) getFlareFromNumber(...) restituisce, dato il number di un Flare, l’indice del Flare all’interno di flares

RescueMissionApplication selectFlare(...) seleziona il Flare, settando in selectedFlare il number del Flare, e settando lo stato dei vari bottoni a seconda dello stato delle variabili nel Flare selectNone(...) deseleziona il Flare, settando selectedFlare a -1 e disabilitando tutti i bottoni tranne il ‘NEW’ initialize(...) Inizializza gran parte delle variabili globali statiche Aggiunge a layer la renderizzazione di un’istanza di FlareGFXLoader Abilita layer e lo aggiunge ai layers di wwd Aggiunge il SelectListener FlareDragger a wwd Aggiunge MouseListener MouseMotionListener PositionListener KeyListener

RescueMissionApplication mousePressed Se la posizione è ‘off globe’ esce Se era premuto ‘NEW’ crea un Flare alla posizione specificata Se era premuto anche il tasto SHIFT permette l’inserimento del nome Se era premuto anche il tasto CTRL mantiene il bottone ‘NEW’ premuto e permette di creare, di seguito, altri Flare Se isArmed del Flare selezionato è true (cioè si sta definendo il percorso) Aggiunge un nodo chiamando la addPosition() Modifica l’ultimo nodo con la replacePosition() premendo SHIFT Cancella l’ultimo nodo con la removePosition() premendo CTRL Se si aggiunge o modifica viene settato isArmed del Flare selezionato a true

RescueMissionApplication mouseReleased Se isArmed del Flare selezionato è true (cioè si sta definendo il percorso) Viene settato isArmed del Flare selezionato a false keyPressed S – saveToFile(...) – salva i Flare L – loadFromFile(...) – carica i Flare 1 – visualizza solo la ‘car’ Flare selezionato 2 – visualizza solo il ‘plane’ del Flare selezionato 3 – visualizza solo la ‘spaceship’ del Flare selezionato 0 – visualizza tutti i modelli del Flare selezionato

FlareSerializable Questa classe viene utilizzata per salvare in un file delle variabili dalle quali è possibile ricostruire un Flare Le variabili di tipo Position sono salvate sotto forma di tre double (latitudine, longitudine, altezza) Nella classe Flare è possibile creare un nuovo Flare passando come parametro un FlareSerializable, in questo modo le variabili standard vengono inizializzate come di consueto mentre quelle specifiche che caratterizzano il Flare vengono inizializzate utilizzando le variabili del FlareSerializable

�ݺ�ߣ

Rescue Mission

More Related Content

Rescue Mission