cz.gyarab.util.teaser

Class HanoiAnimator

java.lang.Object

cz.gyarab.util.teaser.HanoiAnimator

All Implemented Interfaces:

Hanoi

public class HanoiAnimator
extends java.lang.Object
implements Hanoi

Animace průběhu řešení Hanojských věží. Implementace je pouze v JavaFX.

Since:

1.4

Nested Class Summary

Nested classes/interfaces inherited from interface cz.gyarab.util.teaser.Hanoi

Hanoi.Place

Field Summary

Fields

Modifier and Type	Field and Description
static int	DEMO_MAX_SIZE Maximální počet disků pro demonstraci.

Fields inherited from interface cz.gyarab.util.teaser.Hanoi

EMPTY

Method Summary

Modifier and Type	Method and Description
static Hanoi	createAnimator() Vytvoří animaci včetně zobrazené FX stage bez implementace pravidel hry.
static Hanoi	createAnimator(Hanoi hanoi) Vytvoří animaci včetně zobrazené FX stage na základě existující implementace pravidel hry.
static Hanoi	createAnimator(Hanoi hanoi, javafx.stage.Stage stage) Vytvoří animaci a vloží ji do předané FX stage na základě existující implementace pravidel hry.
void	done() Ověří ukončení hry.
static void	main(java.lang.String[] args) Spustí demonstraci použití této třídy.
void	move(Hanoi.Place from, Hanoi.Place to) Přesune jeden disk z jedné věže na druhou.
static void	runDemo(int size) Spustí demo s jedním jevištěm.
static void	runDemos(int sizeFrom, int sizeTo) Spustí demo s několika jevišti, na každém jevišti se odehrává právě jedna animace řešení problému Hanojských věží pro různé počty disků.
static void	setDiskColors(javafx.scene.paint.Color... color) Nastaví sérii barev pro povrchy disků.
static void	setDuration(javafx.util.Duration duration) Nastaví rychlost animace.
static void	setTowerColors(javafx.scene.paint.Color... color) Nastaví sérii barev pro povrchy věží.
void	setup(int count) Spustí novou hru.

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Field Detail

DEMO_MAX_SIZE

public static final int DEMO_MAX_SIZE

Maximální počet disků pro demonstraci. Při vlastním použítí není počet disků nijak omezen, pouze kapacitními možnostmi JVM.

See Also:

runDemos(int, int), Constant Field Values

Method Detail

createAnimator

public static Hanoi createAnimator()

Vytvoří animaci včetně zobrazené FX stage bez implementace pravidel hry. Po vytvoření animace je potřeba postupně provést všechny kroky počínaje nastavením přes jednotlivé tahy po dokončení.

Poznámka: pokud při chybějících pravidlech hry dojde k chybnému tahu, např. k přesunu neexistujícího disku, může být vyvolána výjimka i mimo kontrolu pravidel, případně dojde k nepředvídatelnému chování.

Returns:

nově vytvořenou animaci, tedy FX stage s věžemi a bez disků

createAnimator

public static Hanoi createAnimator(Hanoi hanoi)

Vytvoří animaci včetně zobrazené FX stage na základě existující implementace pravidel hry. Po vytvoření animace je potřeba postupně provést všechny kroky počínaje nastavením přes jednotlivé tahy po dokončení.

Parameters:

hanoi - pravidla hry, pokud nejsou správně implementována a dojde k chybnému tahu, např. k přesunu neexistujícího disku, může být vyvolána výjimka i mimo kontrolu pravidel, případně dojde k nepředvídatelnému chování

Returns:

nově vytvořenou animaci, tedy FX stage s věžemi a bez disků

createAnimator

public static Hanoi createAnimator(Hanoi hanoi,
                                   javafx.stage.Stage stage)

Vytvoří animaci a vloží ji do předané FX stage na základě existující implementace pravidel hry. Po vytvoření animace je potřeba postupně provést všechny kroky počínaje nastavením přes jednotlivé tahy po dokončení.

Parameters:

hanoi - pravidla hry, pokud nejsou správně implementována a dojde k chybnému tahu, např. k přesunu neexistujícího disku, může být vyvolána výjimka i mimo kontrolu pravidel, případně dojde k nepředvídatelnému chování

stage - předem vytvořená FX stage na umístění animace

Returns:

nově vytvořený animátor

setTowerColors

public static void setTowerColors(javafx.scene.paint.Color... color)

Nastaví sérii barev pro povrchy věží. Pokud je barev méně, budou se barvy na věžích opakovat. Výchozí je jedna barva.

Parameters:

color - nejméně jedna barva pro věže

setDiskColors

public static void setDiskColors(javafx.scene.paint.Color... color)

Nastaví sérii barev pro povrchy disků. Pokud je barev méně, budou se barvy na discích opakovat. Výchozích je 6 barev s rovnoměrně odstupňovanou barevností (hue).

Parameters:

color - nejméně jedna barva pro disky

setDuration

public static void setDuration(javafx.util.Duration duration)

Nastaví rychlost animace.

Parameters:

duration - doba, za kterou se přesune disk z jedné věže na druhou

runDemo

public static void runDemo(int size)

Spustí demo s jedním jevištěm. Metoda se vrací, jakmile proběhne poslední tah, okno zůstane otevřené. Tuto metodu lze spustit pouze jednou a použití JavaFX před nebo po spuštění může mít nepředvídatelné následky.

Parameters:

size - počet disků k vyřešení

See Also:

DEMO_MAX_SIZE

runDemos

public static void runDemos(int sizeFrom,
                            int sizeTo)

Spustí demo s několika jevišti, na každém jevišti se odehrává právě jedna animace řešení problému Hanojských věží pro různé počty disků. Metoda se vrací, jakmile proběhne poslední tah, okna zůstanou otevřená. Tuto metodu lze spustit pouze jednou a použití JavaFX před nebo po spuštění může mít nepředvídatelné následky.

Parameters:

sizeFrom - počet disků na nejmenším jevišti

sizeTo - počet disků na největším jevišti

See Also:

DEMO_MAX_SIZE

main

public static void main(java.lang.String[] args)

Spustí demonstraci použití této třídy.

Parameters:

args - (ignoruje, pokud ale v prvním argmentu je celé číslo, pak místo výchozí hodnoty spustí animaci řešení pro zadaný počet disků, podobně v druhém argumentu předpokládá číslo větší nebo rovné prvnímu udávající počet disků v další instanci, výchozími hodnotami jsou 3 a 5, tedy v takovém případě se spustí tři souběžné demonstrace pro 3, 4 a 5 disků

setup

public void setup(int count)
           throws java.lang.IllegalArgumentException

Description copied from interface: Hanoi

Spustí novou hru. Všechny disky se umístí ve správném pořadí na levou věž.

Specified by:

setup in interface Hanoi

Parameters:

count - počet disků

Throws:

java.lang.IllegalArgumentException - pokud počet disků není kladné číslo

move

public void move(Hanoi.Place from,
                 Hanoi.Place to)
          throws java.lang.IllegalStateException

Description copied from interface: Hanoi

Přesune jeden disk z jedné věže na druhou. Pokud by byl tah v rozporu s pravidly, tah se neuskuteční a bude vyvolána výjimka.

Specified by:

move in interface Hanoi

Parameters:

from - poloha věže, ze které se má disk přesunout

to - poloha věže, na kterou se má být disk přesunout

Throws:

java.lang.IllegalStateException - pokud je tah v rozporu s pravidly

done

public void done()
          throws java.lang.IllegalStateException

Description copied from interface: Hanoi

Ověří ukončení hry. Hra je ukončena podle pravidel, pokud jsou všechny disky na pravé věží ve správném pořadí.

Specified by:

done in interface Hanoi

Throws:

java.lang.IllegalStateException - pokud hra není na konci (jsou disky, které zůstaly na levé nebo střední věži)