package rup.česky.tvary;

import rup.česky.společně.P;

                                                                            /**/
/*******************************************************************************
 * Třída pro prací s čárou komunikující s aktivním plátnem.
 * Čára je určena svými krajními body, přičemž souřadnice počátečního bodu
 * je současně považována za pozici celé instance.
 *
 * Jedná se o výchozí podobu třídy v souboru projektů.
 *    
 * @author     Rudolf Pecinovský
 * @version    2.01, duben 2004
 */
public class Čára  implements IPosuvný
{
//== KONSTANTNÍ ATRIBUTY TŘÍDY =================================================

    /** Počáteční barva nakreslené instance v případě,
     *  kdy uživatel žádnou požadovanou barvu nezadá -
     *  pro čáru Barva.ČERNÁ. */
    public static final Barva IMPLICITNÍ_BARVA = Barva.ČERNÁ;

    /** Aktivní plátno, které dohlíží na správné vykreslení instance. */
    private static final AktivníPlátno AP = AktivníPlátno.getPlátno();



//== PROMĚNNÉ ATRIBUTY TŘÍDY ===================================================

    /** Počet vytvořených instancí */
    private static int počet = 0;



//== KONSTANTNÍ ATRIBUTY INSTANCÍ ==============================================

    /** Název sestávající z názvu třídy a pořadí instance */
    private final String název;



//== PROMĚNNÉ ATRIBUTY INSTANCÍ ================================================

    private int    xPos;    //Bodová x-ová souřadnice počátku
    private int    yPos;    //Bodová y-ová souřadnice počátku
    private int    kx;      //xBodová -ová souřadnice konce 
    private int    ky;      //Bodová y-ová souřadnice konce
    private Barva  barva;   //Barva instance



//== PŘÍSTUPOVÉ METODY VLASTNOSTÍ TŘÍDY ========================================
//== OSTATNÍ METODY TŘÍDY ======================================================

//##############################################################################
//== KONSTRUKTORY A TOVÁRNÍ METODY =============================================

    /***************************************************************************
     * Vytvoří novou instanci s implicitními rozměry, umístěním a barvou.
     * Instance bude umístěna v levém horním rohu plátna 
     * a bude mít implicitní barvu, 
     * Končit bude ve středu plátna.
     */
    public Čára()
    {
        this( 0, 0, AP.getKrok()*AP.getŠířka()/2, 
                    AP.getKrok()*AP.getVýška()/2 );
    }


    /***************************************************************************
     * Vytvoří novou instanci se zadanou polohou a rozměry 
     * a implicitní barvou.
     *
     * @param x       x-ová souřadnice počátku, x=0 má levý okraj plátna
     * @param y       y-ová souřadnice počátku, y=0 má horní okraj plátna
     * @param šířka   Šířka vytvářené instance
     * @param výška   Výška vytvářené instance
     */
    public Čára(int x, int y, int kx, int ky)
    {
        this( x, y, kx, ky, IMPLICITNÍ_BARVA );
    }


    /***************************************************************************
     * Vytvoří novou instanci se zadanou polohou a rozměry 
     * a implicitní barvou.
     *
     * @param počátek   Pozice počátku instance
     * @param konec     Pozice koncového bodu instance
     */
    public Čára(Pozice počátek, Pozice konec)
    {
        this( počátek.x, počátek.y, konec.x, konec.y, IMPLICITNÍ_BARVA );
    }


    /***************************************************************************
     * Vytvoří novou instanci se zadanou polohou a rozměry 
     * a implicitní barvou.
     *
     * @param počátek   Pozice počátku instance
     * @param konec     Pozice koncového bodu instance
     * @param barva     Barva vytvářené instance
     */
    public Čára(Pozice počátek, Pozice konec, Barva barva)
    {
        this( počátek.x, počátek.y, konec.x, konec.y, barva );
    }


    /***************************************************************************
     * Vytvoří novou instanci se zadanými rozměry, polohou a barvou.
     *
     * @param x       x-ová souřadnice počátku, x=0 má levý okraj plátna
     * @param y       y-ová souřadnice počátku, y=0 má horní okraj plátna
     * @param šířka   Šířka vytvářené instance
     * @param výška   Výška vytvářené instance
     * @param barva   Barva vytvářené instance
     */
    public Čára(int x, int y, int kx, int ky, Barva barva)
    {
        this.název = P.názevTřídy(this) + "_" + ++počet;
        this.xPos = x;
        this.yPos = y;
        this.kx = kx;
        this.ky = ky;
        this.barva = barva;
    }



//== PŘÍSTUPOVÉ METODY ATRIBUTU INSTANCÍ =======================================

    /***************************************************************************
     * Vrátí x-ovou souřadnici pozice instance.
     *
     * @return  x-ová souřadnice.
     */
    public int getX()
    {
        return xPos;
    }


    /***************************************************************************
     * Vrátí y-ovou souřadnici pozice instance.
     *
     * @return  y-ová souřadnice.
     */
     public int getY()
     {
         return yPos;
     }


    /***************************************************************************
     * Vrátí instanci třídy Pozice s pozicí instance.
     *
     * @return   Pozice s pozicí instance.
     */
     public Pozice getPozice()
     {
         return new Pozice( xPos, yPos );
     }


    /***************************************************************************
     * Nastaví novou pozici instance.
     * Koncový bod se přitom přesune tak, 
     * aby zůstala zachována velikost a směr instance.
     *       
     * @param x   Nová x-ová pozice instance
     * @param y   Nová y-ová pozice instance
     */
    public void setPozice(int x, int y)
    {
        kx  += x - xPos;
        xPos = x;
        ky  += y - yPos;
        yPos = y;
        AP.překresli();
    }


    /***************************************************************************
     * Nastaví novou pozici instance.
     *
     * @param pozice   Nová pozice instance
     */
    public void setPozice(Pozice pozice)
    {
        setPozice( pozice.x, pozice.y );
    }


    /***************************************************************************
     * Vrátí x-ovou souřadnici koncového bodu instance.
     *
     * @return  x-ová souřadnice koncového bodu.
     */
    public int getKX()
    {
        return kx;
    }


    /***************************************************************************
     * Vrátí y-ovou souřadnici koncového bodu instance.
     *
     * @return  y-ová souřadnice koncového bodu.
     */
     public int getKY()
     {
         return ky;
     }


    /***************************************************************************
     * Vrátí pozici koncového bodu instance.
     *
     * @return  Pozice koncového bodu.
     */
     public Pozice getKPozice()
     {
         return new Pozice( getKX(), getKY() );
     }


    /***************************************************************************
     * Nastaví pozici koncového bodu instance.
     *
     * @param kpozice  Pozice koncového bodu.
     */
     public void setKPozice( int kx, int ky )
     {
         this.kx = kx;
         this.ky = ky;
         AP.překresli();
     }


    /***************************************************************************
     * Nastaví pozici koncového bodu instance.
     *
     * @param kpozice  Pozice koncového bodu.
     */
     public void setKPozice( Pozice kpozice )
     {
         setPozice( kpozice.x, kpozice.y );
     }


    /***************************************************************************
     * Vrátí barvu instance.
     *
     * @return  Instance třídy Barva definující nastavenou barvu.
     */
    public Barva getBarva()
    {
        return barva;
    }


    /***************************************************************************
     * Nastaví novou barvu instance.
     *
     * @param nová   Požadovaná nová barva.
     */
    public void setBarva(Barva nová)
    {
        barva = nová;
        AP.překresli();
    }


    /***************************************************************************
     * Vrátí název instance, tj. název její třídy následovaný pořadím.
     *
     * @return  Řetězec s názvem instance.
     */
     public String getNázev()
     {
        return název;
     }



//== PŘEKRYTÉ METODY IMPLEMENTOVANÝCH ROZHRANÍ =================================

    /***************************************************************************
     * Za pomoci dodaného kreslítka vykreslí obraz své instance
     * na animační plátno.
     *  
     * @param kreslítko   Kreslítko, kterým se instance nakreslí na plátno.     
     */
    public void nakresli( Kreslítko kreslítko )
    {
        kreslítko.kresliČáru( xPos, yPos, kx, ky, barva );
    }



//== PŘEKRYTÉ ABSTRAKTNÍ METODY RODIČOVSKÉ TŘÍDY ===============================
//== PŘEKRYTÉ KONKRÉTNÍ METODY RODIČOVSKÉ TŘÍDY ================================

    /***************************************************************************
     * Převede instanci na řetězec. Používá se především při ladění.
     *
     * @return Řetězcová reprezentace dané instance.
     */
    public String toString()
    {
        return název + ": [" + xPos + ";" + yPos + "]-[" + kx + ";" + ky + "]";
    }



//== NOVĚ ZAVEDENÉ METODY INSTANCÍ =============================================

    /***************************************************************************
     * Spojí čárou zadané body.
     *
     * @param x1      x-ová souřadnice počátku, x=0 má levý okraj plátna
     * @param y1      y-ová souřadnice počátku, y=0 má horní okraj plátna
     * @param šířka   Šířka vytvářené instance
     * @param výška   Výška vytvářené instance
     */
    public void spoj( int x1, int y1, int kx, int ky )
    {
        setPozice( x1, y1 );
        this.kx   = kx;
        this.ky   = ky;
        AP.překresli();
    }
    

    /***************************************************************************
     * Přesune instanci o zadaný počet bodů vpravo,
     * při záporné hodnotě parametru vlevo.
     *
     * @param vzdálenost Vzdálenost, o kterou se instance přesune.
     */
    public void posunVpravo(int vzdálenost)
    {
        setPozice( xPos+vzdálenost, yPos );
    }


    /***************************************************************************
     * Přesune instanci o krok bodů vpravo.
     */
    public void posunVpravo()
    {
        posunVpravo( AP.getKrok() );
    }


    /***************************************************************************
     * Přesune instanci o krok bodů vlevo.
     */
    public void posunVlevo()
    {
        posunVpravo( -AP.getKrok() );
    }


    /***************************************************************************
     * Přesune instanci o zadaný počet bodů dolů,
     * při záporné hodnotě parametru nahoru.
     *
     * @param vzdálenost    Počet bodů, o které se instance přesune.
     */
    public void posunDolů(int vzdálenost)
    {
        setPozice( xPos, yPos+vzdálenost );
    }


    /***************************************************************************
     * Přesune instanci o krok bodů dolů.
     */
    public void posunDolů()
    {
        posunDolů( AP.getKrok() );
    }


    /***************************************************************************
     * Přesune instanci o krok bodů nahoru.
     */
    public void posunVzhůru()
    {
        posunDolů( -AP.getKrok() );
    }



//== SOUKROMÉ A POMOCNÉ METODY TŘÍDY ===========================================
//== SOUKROMÉ A POMOCNÉ METODY INSTANCÍ ========================================
//== VNOŘENÉ A VNITŘNÍ TŘÍDY ===================================================
//== TESTY A METODA MAIN =======================================================
}

