Častica

java.lang.Object
- Častica

Všetky implementované rozhrania:: Poloha, Rozmer, Smer

Známe priame odvodené triedy:: Castica

public class Častica
extends Object
implements Poloha, Smer, Rozmer

Toto je pomocná trieda určená na tvorbu časticových simulácií. Implementuje dve základné rozhrania Poloha a Smer, čiže táto trieda obsahuje iba metódy na zistenie polohy a smeru častice, ostatnú funkcionalitu je potrebné doprogramovať.

Výhodou takejto implementácie je jej odľahčenosť a široké možnosti použitia. Častica rezervuje omnoho menej prostriedkov ako robot, ale dá sa použiť na mnohých miestach v programovacom rámci GRobot namiesto robota alebo iného objektu implementujúceho rozhranie polohy alebo smeru.

Príklad:

Tento príklad ukazuje využitie triedy Častica pri implementácii simulácie ohňostroja.

import knižnica.*;

public class Ohňostroj extends GRobot
{
    // Vnorená súkromná trieda reprezentujúca raketu ohňostroja. Je
    // odvodená od triedy Častica a rozširuje ju len mierne. Definuje
    // novú metódu (reakciu) aktivita, ktorá sa stará o fungovanie aktívnej
    // rakety (spúšťa rovnomennú reakciu aktívnych čiastočiek – pozri
    // nižšie).
    private class Raketa extends Častica
    {
        // Ďalšia vnorená tried (druhá úroveň), ktorá reprezentuje čiastočku
        // vybuchnutej rakety. Tiež je odvodená od triedy Častica, no
        // rozširuje ju o málo viac než trieda Raketa. Čiastočka totiž musí
        // mať okrem aktivity definovanú ešte rýchlosť a zrýchlenie
        // (vlastnosti, ktoré má robot definované predvolene, ale použitie
        // robota by nebolo efektívne – bolo by to ako použiť Ferrari na
        // jazdu do obchodu, ktorý je krížom cez ulicu). Metóda reset slúži
        // na opätovné nastavenie počiatočných hodnôt vlastností čiastočky.
        private class Čiastočka extends Častica
        {
            // Atribút rýchlosti posunu v smere osi x.
            public double vx = 0;

            // Atribút rýchlosti posunu v smere osi y.
            public double vy = 0;

            // Atribút zrýchlenia posunu v smere osi x.
            public double ax = 0;

            // Atribút zrýchlenia posunu v smere osi y.
            public double ay = 0;

            // Atribút životnosti čiastočky v tikoch.
            public int život = 0;

            // Definovanie vlastnej reakcie na časovač – má za úlohu
            // zabezpečiť činnosť aktívnych čiastočiek a tiež postupné
            // ubúdanie života čiastočky.
            public void aktivita()
            {
                if (život > 0)
                {
                    x += vx;
                    y += vy;
                    vx += ax;
                    vy += ay;
                    --život;
                }
            }

            // Táto metóda slúži na nastavenie počiatočných hodnôt
            // vlastností čiastočky.
            public void reset()
            {
                // Nastavenie súradníc podľa nadradenej triedy rakety:
                x = Raketa.this.x;
                y = Raketa.this.y;

                // Voľba nových parametrov (využíva sa aktuálna inštancia
                // najvyššej hierarchicky, nie dedične, nadradenej triedy):
                Ohňostroj.this.domov();
                Ohňostroj.this.náhodnýSmer();
                double a = Svet.náhodnéReálneČíslo(-0.25, -0.8);
                double v = Svet.náhodnéReálneČíslo(8, 10);

                // Nastavenie nového zrýchlenia:
                Ohňostroj.this.dopredu(a);
                ax = Ohňostroj.this.polohaX();
                ay = Ohňostroj.this.polohaY();

                // Nastavenie novej (počiatočnej) rýchlosti:
                Ohňostroj.this.dopredu(v - a);
                vx = Ohňostroj.this.polohaX();
                vy = Ohňostroj.this.polohaY();

                // Gravitácia:
                ay -= 0.1;

                // Náhodná dĺžka života:
                život = (int)Svet.náhodnéCeléČíslo(8, 16);
            }
        }

        // Vnútorný zoznam čiastočiek každej rakety. (V konštruktore nižšie
        // je určené, že každá raketa bude obsahovať presne 50 čiastočiek.)
        private final Zoznam<Čiastočka> čiastočky = new Zoznam<Čiastočka>();

        // Konštruktor rakety.
        public Raketa()
        {
            // Vytvorenie 50 čiastočiek:
            for (int i = 0; i < 50; ++i)
                čiastočky.pridaj(new Čiastočka());
        }

        // Táto metóda sa stará o „štart“ rakety. V tejto implementácii je to
        // iba odpálenie rakety na náhodnej pozícii (raketa nevyletuje).
        public void štart()
        {
            náhodnáPoloha();
            for (Čiastočka čiastočka : čiastočky) čiastočka.reset();
        }

        // Definovanie vlastnej reakcie na časovač – má za úlohu
        // zabezpečiť činnosť a kreslenie aktívnych rakiet.
        public void aktivita()
        {
            for (Čiastočka čiastočka : čiastočky)
                if (čiastočka.život > 0)
                {
                    čiastočka.aktivita();
                    skočNa(čiastočka);
                    krúžok();
                }
        }
    }

    // Vnútorný zoznam rakiet ohňostroja. (V konštruktore je ich vytvorených
    // desať.)
    private final Zoznam<Raketa> rakety = new Zoznam<Raketa>();

    // Konštruktor ohňostroja.
    private Ohňostroj()
    {
        // Nastavenie parametrov jedinej inštancie robota, ktorá bude použitá
        // na kreslenie čiastočiek rakiet:
        zdvihniPero();
        veľkosť(3);
        skry();

        // Pridanie desiatich rakiet do vnútorného zoznamu:
        for (int i = 0; i < 10; ++i)
            rakety.pridaj(new Raketa());

        // Spustenie časovača (inak by ohňostroj nefungoval):
        Svet.spustiČasovač();
    }

    // Po každom kliknutí sa odpáli ďalšia raketa (po odpálení poslednej
    // sa pokračuje opäť prvou).
    @Override public void klik()
    {
        rakety.ďalší().štart();
    }

    // Pri každom tiku sa prekreslí obrazovka a zabezpečí sa fungovanie
    // aktívnych rakiet.
    @Override public void tik()
    {
        Svet.vymažGrafiku();
        for (Raketa raketa : rakety) raketa.aktivita();
    }

    // Hlavná metóda.
    public static void main(String... args)
    {
        Svet.použiKonfiguráciu("ohnostroj.cfg");
        new Ohňostroj();
    }
}

Výsledok:

Ohňostroj (ukážka).

Ukážka náhodného výsledku po niekoľkých klikoch.

Ďalší príklad, ktorý používa triedu Častica je v opise metódy vnorMennýPriestorVlastností

Prehľad atribútov

Atribúty
Modifikátor a typ	Atribút a opis
`double`	`h` Atribút výšky častice.
`double`	`uhol` Atribút smeru častice.
`double`	`w` Atribút šírky častice.
`double`	`x` Atribút súradnice x polohy častice.
`double`	`y` Atribút súradnice y polohy častice.

Atribúty zdedené z rozhrania Poloha
stred

Atribúty zdedené z rozhrania Smer
juh, JUH, juhovychod, JUHOVYCHOD, juhovýchod, JUHOVÝCHOD, juhozapad, JUHOZAPAD, juhozápad, JUHOZÁPAD, sever, SEVER, severovychod, SEVEROVYCHOD, severovýchod, SEVEROVÝCHOD, severozapad, SEVEROZAPAD, severozápad, SEVEROZÁPAD, vychod, VYCHOD, východ, VÝCHOD, zapad, ZAPAD, západ, ZÁPAD

Prehľad konštruktorov

Konštruktory
Konštruktor a opis

Častica()

Konštruktory
Konštruktor a opis
`Častica()`

Prehľad metód

Všetky metódy Inštančné metódy Skutočne definované metódy
Modifikátor a typ	Metóda a opis
`void`	`aktivita()` Táto metóda je predvolene prázdna.
`boolean`	`jeNa(double x, double y)` Overí, či sa poloha tejto častice dokonale zhoduje so zadanými súradnicami.
`boolean`	`jeNa(Poloha poloha)` Overí, či sa poloha tejto častice a poloha zadaného objektu dokonale zhodujú.
`boolean`	`maRozmer(double šírka, double výška)` Alias pre `máRozmer`.
`boolean`	`máRozmer(double šírka, double výška)` Overí, či sa rozmery častice dokonale zhodujú so zadanými rozmermi.
`boolean`	`maRozmer(Rozmer rozmer)` Alias pre `máRozmer`.
`boolean`	`máRozmer(Rozmer rozmer)` Overí, či sa rozmery častice a rozmery zadaného objektu dokonale zhodujú.
`boolean`	`maSirku(double šírka)` Alias pre `máŠírku`.
`boolean`	`máŠírku(double šírka)` Zistí, či má častica zadanú šírku.
`boolean`	`maVysku(double výška)` Alias pre `máVýšku`.
`boolean`	`máVýšku(double výška)` Zistí, či má častica zadanú výšku.
`void`	`náhodnáPoloha()` Vygeneruje pre časticu náhodné súradnice x a y, ktoré budú v rozsahu hraničných hodnôt plochy plátien sveta grafického robota.
`void`	`náhodnýSmer()` Vygeneruje pre časticu náhodnú hodnotu smeru.
`void`	`pasivita()` Táto metóda je predvolene prázdna.
`Bod`	`poloha()` Metóda vráti objekt spájajúce obidve súradnice polohy častice.
`void`	`poloha(double novéX, double novéY)` Metóda nastaví nové súradnice častice.
`void`	`poloha(Poloha bod)` Metóda nastaví nové súradnice častice podľa zadaného bodu.
`double`	`polohaX()` Metóda vráti súradnicu x polohy častice.
`double`	`polohaY()` Metóda vráti súradnicu y polohy častice.
`Rozmery`	`rozmery()` Zistí aktuálne rozmery častice.
`void`	`rozmery(double šírka, double výška)` Nastaví nové rozmery častice.
`void`	`rozmery(Rozmer rozmer)` Nastaví nové rozmery častice podľa zadanej implementácie rozmeru.
`double`	`sirka()` Alias pre `šírka`.
`void`	`sirka(double šírka)` Alias pre `šírka`.
`double`	`smer()` Metóda vráti smer častice.
`void`	`smer(double uhol)` Metóda nastaví nový smer častice.
`void`	`smer(Smer objekt)` Metóda nastaví nový smer častice.
`double`	`suradnicaX()` Alias pre `súradnicaX`.
`double`	`súradnicaX()` Metóda vráti súradnicu x polohy častice.
`double`	`suradnicaY()` Alias pre `súradnicaY`.
`double`	`súradnicaY()` Metóda vráti súradnicu y polohy častice.
`double`	`šírka()` Vráti aktuálnu šírku častice.
`void`	`šírka(double šírka)` Nastaví novú šírku častice.
`double`	`uhol()` Metóda vráti smer častice.
`void`	`uhol(double uhol)` Metóda nastaví nový smer častice.
`void`	`uhol(Smer objekt)` Metóda nastaví nový smer častice.
`double`	`vyska()` Alias pre `výška`.
`void`	`vyska(double výška)` Alias pre `výška`.
`double`	`výška()` Vráti aktuálnu výšku častice.
`void`	`výška(double výška)` Nastaví novú výšku častice.

Metódy zdedené z triedy java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

- Podrobnosti atribútov
  - x
```
public double x
```
    Atribút súradnice x polohy častice.
  - y
```
public double y
```
    Atribút súradnice y polohy častice.
  - uhol
```
public double uhol
```
    Atribút smeru častice.
  - w
```
public double w
```
    Atribút šírky častice. (Anglicky: width.)
  - h
```
public double h
```
    Atribút výšky častice. (Anglicky: height.)
- Podrobnosti konštruktorov
  - Častica
```
public Častica()
```
- Podrobnosti metód
  - polohaX
```
public double polohaX()
```
    Metóda vráti súradnicu x polohy častice. Metóda je povinnou súčasťou implementácie rozhrania Poloha, inak je prístup k atribútom x, y verejný.
    
    Definované:
    
    polohaX v rozhraní Poloha
    
    Návratová hodnota:
    
    x-ová súradnica častice
  - polohaY
```
public double polohaY()
```
    Metóda vráti súradnicu y polohy častice. Metóda je povinnou súčasťou implementácie rozhrania Poloha, inak je prístup k atribútom x, y verejný.
    
    Definované:
    
    polohaY v rozhraní Poloha
    
    Návratová hodnota:
    
    y-ová súradnica častice
  - súradnicaX
```
public double súradnicaX()
```
    Metóda vráti súradnicu x polohy častice. Metóda je povinnou súčasťou implementácie rozhrania Poloha, inak je prístup k atribútom x, y verejný.
    
    Definované:
    
    súradnicaX v rozhraní Poloha
    
    Návratová hodnota:
    
    x-ová súradnica častice
  - suradnicaX
```
public double suradnicaX()
```
    Alias pre súradnicaX.
    
    Definované:
    
    suradnicaX v rozhraní Poloha
  - súradnicaY
```
public double súradnicaY()
```
    Metóda vráti súradnicu y polohy častice. Metóda je povinnou súčasťou implementácie rozhrania Poloha, inak je prístup k atribútom x, y verejný.
    
    Definované:
    
    súradnicaY v rozhraní Poloha
    
    Návratová hodnota:
    
    y-ová súradnica častice
  - suradnicaY
```
public double suradnicaY()
```
    Alias pre súradnicaY.
    
    Definované:
    
    suradnicaY v rozhraní Poloha
  - poloha
```
public Bod poloha()
```
    Metóda vráti objekt spájajúce obidve súradnice polohy častice. Metóda je povinnou súčasťou implementácie rozhrania Poloha, inak je prístup k atribútom x, y verejný.
    
    Definované:
    
    poloha v rozhraní Poloha
    
    Návratová hodnota:
    
    inštancia triedy Bod obsahujúca aktuálne súradnice častice
  - poloha
```
public void poloha(Poloha bod)
```
    Metóda nastaví nové súradnice častice podľa zadaného bodu.
    
    Parametre:
    
    bod – bod určujúci novú polohu častice
  - poloha
```
public void poloha(double novéX,
                   double novéY)
```
    Metóda nastaví nové súradnice častice.
    
    Parametre:
    
    novéX – nová x-ová súradnica častice
    
    novéY – nová y-ová súradnica častice
  - jeNa
```
public boolean jeNa(double x,
                    double y)
```
    Overí, či sa poloha tejto častice dokonale zhoduje so zadanými súradnicami. Ak je zistená zhoda, tak metóda vráti hodnotu true, v opačnom prípade hodnotu false.
    
    Definované:
    
    jeNa v rozhraní Poloha
    
    Parametre:
    
    x – x-ová súradnica, s ktorou má byť porovnaná poloha tejto častice
    
    y – y-ová súradnica, s ktorou má byť porovnaná poloha tejto častice
    
    Návratová hodnota:
    
    true ak sa poloha tejto častice zhoduje so zadanými súradnicami, false v opačnom prípade
  - jeNa
```
public boolean jeNa(Poloha poloha)
```
    Overí, či sa poloha tejto častice a poloha zadaného objektu dokonale zhodujú. Ak je zistená zhoda, tak metóda vráti hodnotu true, v opačnom prípade hodnotu false.
    
    Definované:
    
    jeNa v rozhraní Poloha
    
    Parametre:
    
    poloha – objekt, ktorého poloha má byť porovnaná s polohou tejto častice
    
    Návratová hodnota:
    
    true ak sa poloha tejto častice zhoduje s polohou zadaného objektu, false v opačnom prípade
  - uhol
```
public double uhol()
```
    Metóda vráti smer častice. Metóda je povinnou súčasťou implementácie rozhrania Smer, inak je prístup k atribútu uhol verejný.
    
    Definované:
    
    uhol v rozhraní Smer
  - smer
```
public double smer()
```
    Metóda vráti smer častice. Metóda je povinnou súčasťou implementácie rozhrania Smer, inak je prístup k atribútu uhol verejný.
    
    Definované:
    
    smer v rozhraní Smer
  - uhol
```
public void uhol(double uhol)
```
    Metóda nastaví nový smer častice.
    
    Parametre:
    
    uhol – hodnota určujúca nový uhol častice
  - smer
```
public void smer(double uhol)
```
    Metóda nastaví nový smer častice.
    
    Parametre:
    
    uhol – hodnota určujúca nový uhol častice
  - uhol
```
public void uhol(Smer objekt)
```
    Metóda nastaví nový smer častice.
    
    Parametre:
    
    uhol – objekt určujúci nový uhol častice
  - smer
```
public void smer(Smer objekt)
```
    Metóda nastaví nový smer častice.
    
    Parametre:
    
    uhol – objekt určujúci nový uhol častice
  - šírka
```
public double šírka()
```
    Vráti aktuálnu šírku častice. Metóda je povinnou súčasťou implementácie rozhrania Rozmer, inak je prístup k atribútom w, h verejný.
    
    Definované:
    
    šírka v rozhraní Rozmer
    
    Návratová hodnota:
    
    aktuálna šírka častice
  - sirka
```
public double sirka()
```
    Alias pre šírka.
    
    Definované:
    
    sirka v rozhraní Rozmer
  - výška
```
public double výška()
```
    Vráti aktuálnu výšku častice. Metóda je povinnou súčasťou implementácie rozhrania Rozmer, inak je prístup k atribútom w, h verejný.
    
    Definované:
    
    výška v rozhraní Rozmer
    
    Návratová hodnota:
    
    aktuálna výška častice
  - vyska
```
public double vyska()
```
    Alias pre výška.
    
    Definované:
    
    vyska v rozhraní Rozmer
  - šírka
```
public void šírka(double šírka)
```
    Nastaví novú šírku častice. Metóda je povinnou súčasťou implementácie rozhrania Rozmer, inak je prístup k atribútom w, h verejný.
    
    Definované:
    
    šírka v rozhraní Rozmer
    
    Parametre:
    
    šírka – nová šírka častice
  - sirka
```
public void sirka(double šírka)
```
    Alias pre šírka.
    
    Definované:
    
    sirka v rozhraní Rozmer
  - výška
```
public void výška(double výška)
```
    Nastaví novú výšku častice. Metóda je povinnou súčasťou implementácie rozhrania Rozmer, inak je prístup k atribútom w, h verejný.
    
    Definované:
    
    výška v rozhraní Rozmer
    
    Parametre:
    
    výška – nová výška častice
  - vyska
```
public void vyska(double výška)
```
    Alias pre výška.
    
    Definované:
    
    vyska v rozhraní Rozmer
  - rozmery
```
public Rozmery rozmery()
```
    Zistí aktuálne rozmery častice.
    
    Definované:
    
    rozmery v rozhraní Rozmer
    
    Návratová hodnota:
    
    objekt vytvorený podľa aktuálnych rozmerov častice
  - rozmery
```
public void rozmery(double šírka,
                    double výška)
```
    Nastaví nové rozmery častice. Metóda je povinnou súčasťou implementácie rozhrania Rozmer, inak je prístup k atribútom w, h verejný.
    
    Parametre:
    
    šírka – nová šírka častice
    
    výška – nová výška častice
  - rozmery
```
public void rozmery(Rozmer rozmer)
```
    Nastaví nové rozmery častice podľa zadanej implementácie rozmeru.
    
    Definované:
    
    rozmery v rozhraní Rozmer
    
    Parametre:
    
    rozmer – inštancia obsahujúca nové rozmery častice
  - máŠírku
```
public boolean máŠírku(double šírka)
```
    Zistí, či má častica zadanú šírku.
    
    Definované:
    
    máŠírku v rozhraní Rozmer
    
    Parametre:
    
    šírka – šírka, ktorá má byť porovnaná so šírkou častice
    
    Návratová hodnota:
    
    true ak sa šírka častice zhoduje so zadanou šírkou, false v opačnom prípade
  - maSirku
```
public boolean maSirku(double šírka)
```
    Alias pre máŠírku.
    
    Definované:
    
    maSirku v rozhraní Rozmer
  - máVýšku
```
public boolean máVýšku(double výška)
```
    Zistí, či má častica zadanú výšku.
    
    Definované:
    
    máVýšku v rozhraní Rozmer
    
    Parametre:
    
    výška – výška, ktorá má byť porovnaná s výškou častice
    
    Návratová hodnota:
    
    true ak sa výška častice zhoduje so zadanou výškou, false v opačnom prípade
  - maVysku
```
public boolean maVysku(double výška)
```
    Alias pre máVýšku.
    
    Definované:
    
    maVysku v rozhraní Rozmer
  - máRozmer
```
public boolean máRozmer(Rozmer rozmer)
```
    Overí, či sa rozmery častice a rozmery zadaného objektu dokonale zhodujú. Ak je zistená zhoda, tak je výsledkom true, v opačnom prípade hodnota false.
    
    Definované:
    
    máRozmer v rozhraní Rozmer
    
    Parametre:
    
    rozmer – iný objekt, ktorého rozmery majú byť porovnané s rozmermi častice
    
    Návratová hodnota:
    
    true ak sa rozmery častice zhodujú s rozmermi zadaného objektu, false v opačnom prípade
  - maRozmer
```
public boolean maRozmer(Rozmer rozmer)
```
    Alias pre máRozmer.
    
    Definované:
    
    maRozmer v rozhraní Rozmer
  - máRozmer
```
public boolean máRozmer(double šírka,
                        double výška)
```
    Overí, či sa rozmery častice dokonale zhodujú so zadanými rozmermi. Ak je zistená zhoda, tak je výsledkom true, v opačnom prípade hodnota false.
    
    Definované:
    
    máRozmer v rozhraní Rozmer
    
    Parametre:
    
    šírka – šírka porovnávaná so šírkou častice
    
    výška – výška porovnávaná s výškou častice
    
    Návratová hodnota:
    
    true ak sa rozmery častice zhodujú so zadanými rozmermi, false v opačnom prípade
  - maRozmer
```
public boolean maRozmer(double šírka,
                        double výška)
```
    Alias pre máRozmer.
    
    Definované:
    
    maRozmer v rozhraní Rozmer
  - náhodnáPoloha
```
public void náhodnáPoloha()
```
    Vygeneruje pre časticu náhodné súradnice x a y, ktoré budú v rozsahu hraničných hodnôt plochy plátien sveta grafického robota.
  - náhodnýSmer
```
public void náhodnýSmer()
```
    Vygeneruje pre časticu náhodnú hodnotu smeru.
  - aktivita
```
public void aktivita()
```
    Táto metóda je predvolene prázdna. Je určená na prekrytie v triedach odvodených od častice. Častica môže byť chápaná ako odľahčená verzia robota. O celú jej funkčnosť (vrátane aktivity alebo pasivity) sa musí postarať programátor, ktorý sa ju rozhodne rozšíriť a využiť na svoje účely. Aktivita (rovnako ako pasivita) častice nie je v programovacom rámci GRobot nikde vnútorne použitá, ale jej definícia v tejto triede poskytuje spoločný bod použitia všetkých odvodených tried.
  - pasivita
```
public void pasivita()
```
    Táto metóda je predvolene prázdna. Je určená na prekrytie v triedach odvodených od častice. Častica môže byť chápaná ako odľahčená verzia robota. O celú jej funkčnosť (vrátane aktivity alebo pasivity) sa musí postarať programátor, ktorý sa ju rozhodne rozšíriť a využiť na svoje účely. Pasivita (rovnako ako aktivita) častice nie je v programovacom rámci GRobot nikde vnútorne použitá, ale jej definícia v tejto triede poskytuje spoločný bod použitia všetkých odvodených tried.

Trieda Častica

Prehľad atribútov

Atribúty zdedené z rozhrania Poloha

Atribúty zdedené z rozhrania Smer

Prehľad konštruktorov

Prehľad metód

Metódy zdedené z triedy java.lang.Object

Podrobnosti atribútov

x

y

uhol

w

h

Podrobnosti konštruktorov

Častica

Podrobnosti metód

polohaX

polohaY

súradnicaX

suradnicaX

súradnicaY

suradnicaY

poloha

poloha

poloha

jeNa

jeNa

uhol

smer

uhol

smer

uhol

smer

šírka

sirka

výška

vyska

šírka

sirka

výška

vyska

rozmery

rozmery

rozmery

máŠírku

maSirku

máVýšku

maVysku

máRozmer

maRozmer

máRozmer

maRozmer

náhodnáPoloha

náhodnýSmer

aktivita

pasivita