Class Multishape

All Implemented Interfaces:
ICMPaintable, ICMShape, IDirectable, IFlexible, IChangeable, IMovable, IResizable, IShape, ICopyable

public class Multishape
extends AShape
implements ICMShape, IDirectable
Instance třídy Mnohotvar představují složitější geometrické tvary určené pro práci na virtuálním plátně při prvním seznámení s třídami a objekty. Tyto tvary mohou být složeny z několika tvarů jednodušších, které jsou instancemi interfejsu ICMShape, ve zvláštních případech interfejsu IChangeable – v takovém případě pak ale není vytvořený mnohotvar kopírovatelný.

Mnohotvar je postupně skládán z řady jednodušších tvarů, které musejí být instancemi rozhraní ICMShape, (případně. IChangeable). Jiné požadavky na ně kladeny nejsou. Při sestavování mnohotvar automaticky upravuje interní informaci o své pozici a rozměru tak, aby pozice byla neustále v levém rohu opsaného obdélníku a rozměr mnohotvaru odpovídal rozměru tohoto obdélníku.

  • Field Summary

    Fields 
    Modifier and Type Field Description
    static Direction8 DEFAULT_DIRECTION
    Směr, kam bude mnohotvar nasměrován v případě, když uživatel žádný preferovaný směr nezadá.

    Fields inherited from interface eu.pedu.lib20s.canvasmanager.ICMPaintable

    CM
  • Constructor Summary

    Constructors 
    Constructor Description
    Multishape()
    Vytvoří prázdný mnohotvar očekávající, že jeho jednotlivé části budou teprve dodány pomocí metody addShapes(ICMShape...).
    Multishape​(ICMShape part1, ICMShape... parts)
    Vytvoří mnohotvar skládající se z kopií zadaných tvarů a otočený do implicitního směru; do tohoto mnohotvaru již nebude možno přidávat další tvary.
    Multishape​(Direction8 direction, ICMShape part1, ICMShape... parts)
    Vytvoří mnohotvar skládající se ze zadaných tvarů a otočený do zadaného směru; do tohoto mnohotvaru již nebude možno přidávat další tvary.
  • Method Summary

    Modifier and Type Method Description
    void addShapes​(ICMShape... shapes)
    Přidá do mnohotvaru kopie zadaných tvarů a příslušně upraví novou pozici a velikost mnohotvaru.
    <T extends IChangeable & ICMPaintable>
    Multishape
    addTheShape​(T shape)
    Přidá do mnohotvaru zadaný objekt (tj. ne jeho kopii) a příslušně upraví novou pozici a velikost mnohotvaru.
    Multishape copy()
    Vytvoří stejně velkou a stejně umístěnou hlubokou kopii daného mnohotvaru.
    void creationDone()
    Ukončí tvorbu mnohotvaru; od této chvíle již nebude možno přidat žádný další objekt.
    protected java.lang.String forToString()
    Vrací charakteristiky dané instance do jejího podpisu.
    Direction8 getDirection()
    Vrátí směr, do nějž je instance otočena.
    int getNumberOfShapes()
    Return the number of shapes constituting the multishape.
    int getNumberOfSimpleShapes()
    Return the number of simple shapes constituting the multishape.
    boolean isCopyable()
    Vrátí informaci o tom, je-li daný mnohotvar kopírovatelný.
    void paint​(Painter painter)
    Prostřednictvím dodaného kreslítka vykreslí obraz své instance.
    void setDirection​(Direction8 direction)
    Otočí instanci do zadaného směru.
    void setInitialDirection​(Direction8 initialDirection)
    Nastaví zadaný směr jako výchozí směr vytvářené instance.
    void setPosition​(int x, int y)
    Přemístí instanci na zadanou pozici.
    void setSize​(int width, int height)
    Nastaví nové rozměry instance.

    Methods inherited from class eu.pedu.lib20s.geom.AChangeable

    getHeight, getWidth

    Methods inherited from class eu.pedu.lib20s.geom.AMovable

    getX, getY

    Methods inherited from class eu.pedu.lib20s.geom.ANamed

    getName, setName, toString

    Methods inherited from class java.lang.Object

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

    Methods inherited from interface eu.pedu.lib20s.canvasmanager.ICMPaintable

    hide, show

    Methods inherited from interface eu.pedu.lib20s.geom.IChangeable

    getArea, setArea, setArea, setArea

    Methods inherited from interface eu.pedu.lib20s.geom.IMovable

    getPosition, getX, getY, moveDown, moveRight, setPosition, setX, setY

    Methods inherited from interface eu.pedu.lib20s.geom.IResizable

    getHeight, getSize, getWidth, setHeight, setSize, setSize, setWidth
  • Field Details

    • DEFAULT_DIRECTION

      public static final Direction8 DEFAULT_DIRECTION
      Směr, kam bude mnohotvar nasměrován v případě, když uživatel žádný preferovaný směr nezadá.
  • Constructor Details

    • Multishape

      public Multishape()
      Vytvoří prázdný mnohotvar očekávající, že jeho jednotlivé části budou teprve dodány pomocí metody addShapes(ICMShape...).

      Ukončení sestavování mnohotvaru je třeba oznámit zavoláním metody creationDone(). Dokud není sestavování ukončeno, není možno nastavovat pozici ani rozměr vznikajícího mnohotvaru. Je však možno se na ně zeptat a současně je možno rozdělaný mnohotvar nakreslit.

    • Multishape

      public Multishape​(ICMShape part1, ICMShape... parts)
      Vytvoří mnohotvar skládající se z kopií zadaných tvarů a otočený do implicitního směru; do tohoto mnohotvaru již nebude možno přidávat další tvary. Vkládané tvary jsou skládány na sebe, takže první vložený bude zobrazen vespod a poslední vložený nahoře nade všemi.
      Parameters:
      part1 - Předloha první ze součástí mnohotvaru
      parts - Předlohy dalších součástí mnohotvaru
    • Multishape

      public Multishape​(Direction8 direction, ICMShape part1, ICMShape... parts)
      Vytvoří mnohotvar skládající se ze zadaných tvarů a otočený do zadaného směru; do tohoto mnohotvaru již nebude možno přidávat další tvary. Tvary jsou skládány na sebe, takže první vložený bude zobrazen vespod a poslední vložený nahoře nade všemi.
      Parameters:
      direction - Směr, do nějž bude mnohotvar natočen; tento směr musí být jedním ze 4 hlavních směrů
      part1 - První ze součástí mnohotvaru
      parts - Další součásti mnohotvaru
  • Method Details

    • isCopyable

      public boolean isCopyable()
      Vrátí informaci o tom, je-li daný mnohotvar kopírovatelný.
      Returns:
      Je-li kopírovatelný, vrátí true, jinak vrátí false
    • getDirection

      public Direction8 getDirection()
      Vrátí směr, do nějž je instance otočena.
      Specified by:
      getDirection in interface IDirectable
      Returns:
      Instance třídy Direction8 definující aktuálně nastavený směr
    • setDirection

      public void setDirection​(Direction8 direction)
      Otočí instanci do zadaného směru. Souřadnice instance se otočením nezmění.
      Specified by:
      setDirection in interface IDirectable
      Parameters:
      direction - Směr, do nějž má být instance otočena
    • setInitialDirection

      public void setInitialDirection​(Direction8 initialDirection)
      Nastaví zadaný směr jako výchozí směr vytvářené instance. Tato metoda instancí neotáčí, pouze nastavují výchozí směr. Instance je implicitně považována za otočenou na sever. Má-li mít instance jiný výchozí směr, musí být nastaven před jejím dokončením.
      Parameters:
      initialDirection - Nastavovaný výchozí směr instance
    • setPosition

      public void setPosition​(int x, int y)
      Přemístí instanci na zadanou pozici. Všechny její součásti jsou přesouvány současně jako jeden objekt. Pozice instance je přitom definována jako pozice levého horního rohu opsaného obdélníku.
      Specified by:
      setPosition in interface IMovable
      Overrides:
      setPosition in class AMovable
      Parameters:
      x - Nově nastavovaná vodorovná (x-ová) souřadnice instance, x=0 má levý okraj plátna, souřadnice roste doprava
      y - Nově nastavovaná svislá (y-ová) souřadnice instance, y=0 má horní okraj plátna, souřadnice roste dolů
    • setSize

      public void setSize​(int width, int height)
      Nastaví nové rozměry instance. Upraví rozměry a pozice všech jeho součástí tak, aby výsledný mnohotvar měl i při novém rozměru stále stejný celkový vzhled. Rozměry instance jsou přitom definovány jako rozměry opsaného obdélníku. Nastavované rozměry musí být nezáporné, místo nulového rozměru se nastaví rozměr rovný jedné.
      Specified by:
      setSize in interface IResizable
      Overrides:
      setSize in class AChangeable
      Parameters:
      width - Nově nastavovaná šířka; šířka >= 0
      height - Nově nastavovaná výška; výška >= 0
    • getNumberOfShapes

      public int getNumberOfShapes()
      Return the number of shapes constituting the multishape. If the multishape contains another multishape, this embedded multishape is counted as one shape.
      Returns:
      Number of shapes constituting the multishape.
    • getNumberOfSimpleShapes

      public int getNumberOfSimpleShapes()
      Return the number of simple shapes constituting the multishape. If the multishape contains another multishape, all its subshapes are counted.
      Returns:
      Number of simple shapes constituting the multishape
    • addShapes

      public final void addShapes​(ICMShape... shapes)
      Přidá do mnohotvaru kopie zadaných tvarů a příslušně upraví novou pozici a velikost mnohotvaru.
      Parameters:
      shapes - Přidávané tvary
    • addTheShape

      public final <T extends IChangeable & ICMPaintable> Multishape addTheShape​(T shape)
      Přidá do mnohotvaru zadaný objekt (tj. ne jeho kopii) a příslušně upraví novou pozici a velikost mnohotvaru. Neimplementuje-li přidávaný tvar rozhraní ICopyable, bude celý mnohotvar označen za nekopírovatelný.
      Type Parameters:
      T - Skutečný typ argumentu
      Parameters:
      shape - Přidávaný tvar
      Returns:
      Instance daného mnohotvaru, aby bylo možno příkazy řetězit
    • copy

      public Multishape copy()
      Vytvoří stejně velkou a stejně umístěnou hlubokou kopii daného mnohotvaru. Termín hluboká kopie označuje skutečnost, že tvary, které budou součástí vytvořené kopie, budou kopiemi odpovídajících součástí originálu.
      Specified by:
      copy in interface ICMShape
      Specified by:
      copy in interface ICopyable
      Specified by:
      copy in interface IShape
      Specified by:
      copy in class AShape
      Returns:
      Požadovaná kopie
    • creationDone

      public void creationDone()
      Ukončí tvorbu mnohotvaru; od této chvíle již nebude možno přidat žádný další objekt.
    • paint

      public void paint​(Painter painter)
      Prostřednictvím dodaného kreslítka vykreslí obraz své instance.
      Specified by:
      paint in interface ICMPaintable
      Parameters:
      painter - Kreslítko schopné kreslit na plátno ovládané správcem
    • forToString

      protected java.lang.String forToString()
      Vrací charakteristiky dané instance do jejího podpisu.
      Overrides:
      forToString in class AChangeable
      Returns:
      Charakteristiky dané instance