Page History

...

I denne oppgaven vil vi gå ut ifra allerede implementerte spill. Vi vil bygge på tidligere implementerte rutenettbaserte spill og legge til nye funkjoner og anvende grensesnitt. Vi vil bygge på oppgavene Sudoku, Sokoban og TicTacToe. kommandoer.

Del 1 (50%)

Her skal du implementere kommandoer for å angre og gjenta funksjoner. Hvis du velger å angre trekket ditt, (eng: undo) handlinger (legg, trekk, ...) og gjenta (eng: redo) handlinger som er angret. Hvis brukeren angrer en handling, så skal spillet settes tilbake til den forgje tilstanden det hadde før du gjorde siste trekk. Ved å velge gjenta vil det trekket du forrige tilstanden, dvs. tilstanden før handlingen. Dersom brukeren gjentar en handling (altså angrer angringen) vil handlingen som brukeren angret bli utført på nytt.

Du kan se på trekkene dine som to LIFO-køer. Ved angring pop'er du trekk fra den ene LIFO-køen til en annen som vil kunne inneholde angrede trekk. Når du gjentar et trekk vil du pop'e de tilbake igjen. 

Del 2

I denne delen skal du definere et grensesnitt. Grensesnittet skal dekke lagring av spillet ditt til fil. Det skal også dekke lesing av en fil med et allerede lagret spill.

Del 3

I denne delen skal du lage en klasse som implementerer grensesnittet fra del 2. Klassen skal kunne lagret spillets nåværende tilstand til en fil. Den skal også kunne lese et allerede lagret spill fra en fil, og fortsette fra den tilstanden som det lagrede spilelt var i sist.

Del 4

La spillet ditt implemetere det allerede definerste grensesnittet ConsoleGame

TODO fyll mer beskrivene info om det her.

Del 5

I denne delen skal du lage en UI-klasse som bruker ConsoleGame-interfacet. Brukeren skal kunne gi kommandoer til klassen og klassen vil kommunisere med spillobjektet igjennom de definerte interface-metodene.

Angre- og gjenta-logikken kan implementeres med to Stack-objekter som inneholder "handling"-objekter, dvs. objekter som inneholder informasjon om en brukerhandling. Når en handling er utført så legges den på angre-stack'en. Ved angring tas det øverste elementet av angre-stack'en, handlingen som dette objektet representerer reverseres og legges på gjenta-stack'en. Ved gjenta, så tas det øverste elementet av gjenta-stack'en, handlingen som dette objektet representerer utføres og legges (tilbake) på angre-stack'en. For å implementere angre og gjenta må en altså:

• finne en måte å representere brukerhandlinger, dvs. lage en klasse som kan lagre informasjon om handlinger
• implementere logikk for å reversere og gjenta handlingen som slike objekter representerer
• administrere angre- og gjenta-stack'er som forklart over (eller tilsvarende logikk)

Obs! For slagskip-spillet skal man ikke implementere angre og gjenta. Se egen artikkel for slagskip.

Del 2 (50%)

I denne delen skal du implementere lagring av spill og innlesing av tidligere lagrede spill, slik at en kan fortsette der en slapp, f.eks. med et vanskelig Sokoban-brett. Du må altså definere et egnet filformat, og støtte dette formatet både ved skriving til fil og lesing fra fil. Merk at det kun er nødvendig å lagre nå-tilstanden til spillet, en trenger ikke lagre tilstand knyttet til angring (undo). Det naturlige vil være å ha et tekstlig (i motsetning til binært) format, med én linje pr. rad i spillet og én eller flere tegn pr. rute i raden. Sokoban har forøvrig et definert standardformat (se http://sokobano.de/wiki/index.php?title=Level_format), som det kan være lurt å støtte for å forenkle bruk av eksisterende brett.

For å gjøre det enklere å bytte til et annet lagringsformat, så skal du definere et grensesnitt (altså et interface) knyttet til lagring og innlesing og lage minst én implementasjon som støtter ditt definerte filformat. Du må selvsagt også implementere en kommando for det, så brukeren både kan lagre og gjenoppta et tidligere lagret spill. Du skal også forklare hvordan du med en annen implementasjon kan støtte et annet lagringsformat og hvordan dette i så fall kan gjøres uten store endringer i hovedprogrammet. Som en ekstra utfordring kan du velge hvilket filformat som brukes basert på endelsen til fila som spillet lagres i.

Før du går i gang med denne delen kan det være lurt å ta en titt på wikisiden for Lesing fra og skriving til fil.

JavaFX-apper for spillene (morsomt, men ikke obligatorisk)

Som for første trinn av spillene, som det er lenket til over, så har vi laget JavaFX-apper for spillene. I tillegg til grafisk visning av rutenettet, er det nå støtte for å

• lese inn spill-tilstand fra fil, nettadresse (URL) eller fra innholdet i et tekstfelt
• lagring av spill-tilstand til et tekstfelt (mest for debugging)
• angre (undo) og gjenta (redo)

Image Added

Eksempel på JavaFX-app (Sokoban). Øverst til venstre kan en velge en fil eller skrive inn en nettadresse som en laster spill-tilstanden fra. En kan også lagre nåværende tilstand til fil. I midten til venstre kan en skrive inn spill-tilstanden i et tekstfelt, evt. lime inn noen en har klippet ut fra en annen applikasjon og starte spillet med denne tilstanden. En kan også kopiere spill-tilstanden som er i spill inn i tekstfeltet (mest for debugging) og evt. kopiere den over i en annen applikasjon. Til høyre er det knapper for angring (undo) og gjenta siste angrede handling (redo).

For at din spill-implementasjon skal kunne kobles til vår JavaFX-app, så må spillklassen din implementere et tilhørende grensesnitt. Dette er en utvidet (og kanskje modifisert) utgave av grensesnittet fra trinn 1, ved at de utvider/bygger på to grensesnitt:

• IPersistable (lagrebar) har metoder for lesing/skriving av tilstand fra/til hhv. InputStream og OutputStream. Metodene brukes av appen til lesing fra fil, nettadresse og tekstfelt og skriving til fil og tekstfelt.
• IUndoable (angrebar) har metoder for angring (spole et hakk tilbake) og gjentaking av siste angrede handling (spole et hakk frem). Metodene er knyttet til tilsvarende knapper.

Spillklassen din må altså implementere både de spill-spesifikk metodene og de to metode-parene fra IPersistable og IUndoable.

For hvert spill har vi laget en "nedlastningspakke" som gjør det lett å importere de nødvendige filene med Digital Compendium-tillegget. Disse finner du under, én for hver app. Når emfs-pakken er importert så må du

1. implementere det nødvendige grensesnittet og
2. legge navnet på din spill-klasse inn i fxml-fila for app-en (se instruksjoner i fila).

Så kan du starte app-en ved å høyreklikke på java-fila med samme navn som fxml-fila og (som vanlig) velge Run As->Java Application.

Nedlastingspakker

Fellespakke (brukes av alle)

emfs
/games/ #java #package
    FxmlApp.java                 @ git@github.com:hallvard/javafx/games/src/games/FxmlApp.java;
    FxmlBuilderFactory.java     @ git@github.com:hallvard/javafx/games/src/games/FxmlBuilderFactory.java;
    FxmlGame.java                @ git@github.com:hallvard/javafx/games/src/games/FxmlGame.java;
    IPersistable.java            @ git@github.com:hallvard/javafx/games/src/games/IPersistable.java;
    IUndoable.java                @ git@github.com:hallvard/javafx/games/src/games/IUndoable.java;
    IUpdateable.java            @ git@github.com:hallvard/javafx/games/src/games/IUpdateable.java;
    PersistableController.java    @ git@github.com:hallvard/javafx/games/src/games/PersistableController.java;
    UndoableController.java        @ git@github.com:hallvard/javafx/games/src/games/UndoableController.java;
    Persistable.fxml            @ git@github.com:hallvard/javafx/games/src/games/Persistable.fxml;
    Undoable.fxml                @ git@github.com:hallvard/javafx/games/src/games/Undoable.fxml;

    imagegrid/ #java #package
        ImageGrid.java        @ git@github.com:hallvard/javafx/games/src/games/imagegrid/ImageGrid.java;
        ImageGridGame.java        @ git@github.com:hallvard/javafx/games/src/games/imagegrid/ImageGridGame.java;

Sokoban

emfs
/games/ #java #package
	sokoban/ #java #package
        sokoban2/ #java #package
            ISokoban.java    @ git@github.com:hallvard/javafx/games/src/games/sokoban/sokoban2/ISokoban.java;
            SokobanFX.java    @ git@github.com:hallvard/javafx/games/src/games/sokoban/sokoban2/SokobanFX.java;
            SokobanFX.fxml    @ git@github.com:hallvard/javafx/games/src/games/sokoban/sokoban2/SokobanFX.fxml;
            ;
        sample.sok    @ git@github.com:hallvard/javafx/games/src/games/sokoban/sample.sok;
        box_on_target16x16.png    @ git@github.com:hallvard/javafx/games/src/games/sokoban/box_on_target16x16.png;
        box16x16.png            @ git@github.com:hallvard/javafx/games/src/games/sokoban/box16x16.png;
        empty16x16.png            @ git@github.com:hallvard/javafx/games/src/games/sokoban/empty16x16.png;
        player_on_target16x16.png    @ git@github.com:hallvard/javafx/games/src/games/sokoban/player_on_target16x16.png;
        player16x16.png            @ git@github.com:hallvard/javafx/games/src/games/sokoban/player16x16.png;
        target16x16.png            @ git@github.com:hallvard/javafx/games/src/games/sokoban/target16x16.png;
        wall16x16.png            @ git@github.com:hallvard/javafx/games/src/games/sokoban/wall16x16.png;

Sudoku

emfs
/games/ #java #package
	sudoku/ #java #package
		sudoku2/ #java #package
            ISudoku.java    @ git@github.com:hallvard/javafx/games/src/games/sudoku/sudoku2/ISudoku.java;
            SudokuFX.java    @ git@github.com:hallvard/javafx/games/src/games/sudoku/sudoku2/SudokuFX.java;
            SudokuFX.fxml    @ git@github.com:hallvard/javafx/games/src/games/sudoku/sudoku2/SudokuFX.fxml;

TicTacToe

emfs
/games/ #java #package
	tictactoe/ #java #package
		tictactoe2/ #java #package
            ITicTacToe.java    @ git@github.com:hallvard/javafx/games/src/games/tictactoe/tictactoe2/ITicTacToe.java;
            TicTacToeFX.java    @ git@github.com:hallvard/javafx/games/src/games/tictactoe/tictactoe2/TicTacToeFX.java;
            TicTacToeFX.fxml    @ git@github.com:hallvard/javafx/games/src/games/tictactoe/tictactoe2/TicTacToeFX.fxml;

Slagskip

Se egen artikkel. 

...