Svet

Všetky implementované rozhrania:: ImageObserver, MenuContainer, Serializable, Accessible, RootPaneContainer, WindowConstants

public final class Svet
extends JFrame

Trieda, ktorá spája metódy obsluhujúce hlavné okno so statickými metódami rôzneho významu.

Majiteľom sveta je hlavný robot. Je to prvý vytvorený robot, ktorý má o niečo vyššie postavenie oproti ostatným robotom. Poskytuje alternatívu k definovaniu obsluhy udalostí a implicitne riadi niektoré procesy.

Vo svete grafického robota jestvujú dve kresliace plátna (podlaha a strop), na ktoré môžu roboty kresliť. Svet umožňuje (okrem iného) napríklad prácu s obrázkami, zvukmi, vstupmi a výstupmi údajov, náhodnými číslami a časovačom, ktorý požadujú niektoré aktivity robotov.

Niektoré príkazy sveta sú zhromaždené v nasledujúcom jednoduchom príklade hry na ozvenu – všetko, čo používateľ zadá do vstupného riadka a potvrdí klávesom Enter, sa zopakuje vypísaním na obrazovku:

Svet.skry();
Svet.začniVstup();
Svet.neskrývajVstupnýRiadok();
Svet.vymažPonuku();
Svet.zobraz();
Svet.farbaTextu(hnedá);
Svet.vypíšRiadok("Hra na ozvenu…", riadok);
Svet.farbaTextu(tmavotyrkysová);

new ObsluhaUdalostí()
{
    @Override public void potvrdenieÚdajov()
    {
        Svet.vypíšRiadok("  Ozvena:", Svet.prevezmiReťazec());
    }
};

Nasledujúci rozsiahlejší príklad ukazuje implementáciu primitívneho prehliadača obrázkov:

import knižnica.*;

public class PrehliadačObrázkov extends GRobot
{
    // Názov práve prehliadaného obrázka
    private String   obrázok = null;

    // Zoznam obrázkov prečítaný z priečinka
    private String[] zoznam  = null;

    // Index posledného obrázka zobrazeného zo zoznamu
    private int index = -1;

    // Konštruktor
    private PrehliadačObrázkov()
    {
        // Nastavenie rozmerov plátna na rozmery prvého zobrazovacieho
        // zariadenia (prvého monitora)
        super(Svet.šírkaZariadenia(), Svet.výškaZariadenia());
    }

    // Metóda slúžiaca na upravenie mierky obrázka podľa
    // rozmerov viditeľnej časti plátna
    public void upravMierku()
    {
        if (null != obrázok)
        {
            if (Svet.šírkaObrázka(obrázok) > Svet.viditeľnáŠírka())
                veľkosť(Svet.viditeľnáŠírka());
            else
                veľkosť(Svet.šírkaObrázka(obrázok));

            if (veľkosť() * Svet.výškaObrázka(obrázok) /
                Svet.šírkaObrázka(obrázok) > Svet.viditeľnáVýška())
                veľkosť(Svet.šírkaObrázka(obrázok) *
                    Svet.viditeľnáVýška() / Svet.výškaObrázka(obrázok));
        }
    }

    // Nastavenie nového prehliadaného obrázka
    public boolean nastavObrázok(String názov)
    {
        if (null != (obrázok = názov))
        {
            názov = názov.toLowerCase();

            if (názov.endsWith(".png") || názov.endsWith(".jpeg") ||
                názov.endsWith(".jpg"))
            {
                veľkosť(Svet.šírkaObrázka(obrázok));
                vlastnýTvar(obrázok);
                upravMierku();
                return true;
            }
        }

        veľkosť(10);
        return false;
    }

    // Metóda slúžiaca na cyklické prehliadanie všetkých obrázkov v priečinku
    public void prehliadaj()
    {
        if (null == zoznam)
            nastavObrázok(null);
        else
        {
            for (int i = 0; i < zoznam.length; ++i)
            {
                if (++index >= zoznam.length) index = 0;
                if (nastavObrázok(zoznam[index])) break;
            }
        }
    }

    // Uvoľnenie ľubovoľného klávesu bude znamenať prehliadanie nasledujúceho
    // obrázka
    @Override public void uvoľnenieKlávesu()
    {
        prehliadaj();
    }

    // Zmena veľkosti okna bude mať za následok upravenie mierky prehliadaného
    // obrázka
    @Override public void zmenaVeľkostiOkna()
    {
        upravMierku();
    }

    // Pustenie súboru (priečinka) nad plátnom bude mať za následok spustenie
    // prehliadania
    @Override public void pustenieSúboru(String súbor)
    {
        // Ak je pustený „súbor“ (resp. položka) priečinok, tak sa spustí
        // prehliadanie priečinka (ak táto akcia náhodou zlyhá, tak metóda
        // prehliadaj sa automaticky postará o to, aby bol zobrazený dutý
        // robot s veľkosťou 10)
        if (Súbor.jePriečinok(súbor))
        {
            try
            {
                Svet.priečinokObrázkov(súbor);
                zoznam = Súbor.zoznamSúborov(súbor);
            }
            catch (Exception e)
            {
                Svet.správa(e.getMessage());
                zoznam = null;
            }
            prehliadaj();
        }
        // V opačnom prípade sa zoznam vymaže a prehliadač sa zadanú položku
        // pokúsi spracovať ako individuálny obrázok (jeho zobrazenie však
        // potrvá len do najbližšieho stlačenia, resp. uvoľnenia, klávesu; na
        // zabezpečenie inteligentnejšieho správania by bolo potrebné
        // implementovať inteligentnejší mechanizmus prehliadania)
        else
        {
            zoznam = null;
            nastavObrázok(súbor);
        }
    }

    // Hlavná metóda
    public static void main(String[] args)
    {
        new PrehliadačObrázkov();
    }
}

Poznámka: Táto trieda používa na generovanie pseudonáhodných čísiel implementáciu Mersennovho twistera z CERNu z roku 1999. Uvedená implementácia bola použitá aj v rámci procesu implementácie vlastnej optimalizovanej verzie generátora pseudonáhodných čísiel s binomickým rozložením. (Pozri zdroj nižšie.)

Súvisiaci zdroj:

Horváth, Roman: Optimisation of Algorithms Generating Pseudorandom Integers with Binomial Distribution. ICETA 2022. Danver : Institute of Electrical and Electronics Engineers, 2022. ISBN 979-8-3503-2032-9. Pp. 197–201. [prevziať]

Pozri tiež:: JFrame, Serializovateľnosť

Prehľad vnorených tried

Vnorené triedy
Modifikátor a typ	Trieda a opis
`static class`	`Svet.PrikazovyRiadok` Alias pre `PríkazovýRiadok`.
`static class`	`Svet.PríkazovýRiadok` Hlavná časť implementácie jednoduchého príkazového riadka operačného systému.

Vnorené triedy/rozhrania odvodené od triedy javax.swing.JFrame
JFrame.AccessibleJFrame

Vnorené triedy/rozhrania odvodené od triedy java.awt.Frame
Frame.AccessibleAWTFrame

Vnorené triedy/rozhrania odvodené od triedy java.awt.Window
Window.AccessibleAWTWindow, Window.Type

Vnorené triedy/rozhrania odvodené od triedy java.awt.Container
Container.AccessibleAWTContainer

Vnorené triedy/rozhrania odvodené od triedy java.awt.Component
Component.AccessibleAWTComponent, Component.BaselineResizeBehavior, Component.BltBufferStrategy, Component.FlipBufferStrategy

Prehľad atribútov

Atribúty
Modifikátor a typ	Atribút a opis
`static DecimalFormat`	`format` Alias pre `formát`.
`static DecimalFormat`	`formát` Inštancia triedy `DecimalFormat` slúžiaca na formátovanie číselných výstupov.
`static Svet.PrikazovyRiadok`	`prikazovyRiadok` Alias pre `príkazovýRiadok`.
`static Svet.PrikazovyRiadok`	`príkazovýRiadok` Inštancia triedy `PríkazovýRiadok` slúžiaca na komunikáciu s príkazovým prostredím operačného systému.
`static SVGPodpora`	`svgExport` Atribút na podporu exportu kreslenia robotov do zadanej inštancie `SVGPodpora`.
`static boolean`	`ukladajStavOknaNaVrchu` Tento rezervovaný atribút je predvolene nastavený na `false`.
`static ZmenaCelejObrazovky`	`zmenaCelejObrazovky` Hodnota tohto atribútu môže obsahovať vlastnú implementáciu spôsobu zmeny režimu celej obrazovky.
`static boolean`	`zmenaLAF` Tento špeciálny atribút je predvolene nastavený na `true`.

Atribúty zdedené z triedy javax.swing.JFrame
accessibleContext, EXIT_ON_CLOSE, rootPane, rootPaneCheckingEnabled

Atribúty zdedené z triedy java.awt.Frame
CROSSHAIR_CURSOR, DEFAULT_CURSOR, E_RESIZE_CURSOR, HAND_CURSOR, ICONIFIED, MAXIMIZED_BOTH, MAXIMIZED_HORIZ, MAXIMIZED_VERT, MOVE_CURSOR, N_RESIZE_CURSOR, NE_RESIZE_CURSOR, NORMAL, NW_RESIZE_CURSOR, S_RESIZE_CURSOR, SE_RESIZE_CURSOR, SW_RESIZE_CURSOR, TEXT_CURSOR, W_RESIZE_CURSOR, WAIT_CURSOR

Atribúty zdedené z triedy java.awt.Component
BOTTOM_ALIGNMENT, CENTER_ALIGNMENT, LEFT_ALIGNMENT, RIGHT_ALIGNMENT, TOP_ALIGNMENT

Atribúty zdedené z rozhrania javax.swing.WindowConstants
DISPOSE_ON_CLOSE, DO_NOTHING_ON_CLOSE, HIDE_ON_CLOSE

Atribúty zdedené z rozhrania java.awt.image.ImageObserver
ABORT, ALLBITS, ERROR, FRAMEBITS, HEIGHT, PROPERTIES, SOMEBITS, WIDTH

Prehľad metód

Všetky metódy Statické metódy Skutočne definované metódy
Modifikátor a typ	Metóda a opis
`static boolean`	`aktivnaHistoriaVstupnehoRiadka()` Alias pre `aktívnaHistóriaVstupnéhoRiadka`.
`static boolean`	`aktívnaHistóriaVstupnéhoRiadka()` Zistí, či je automatické uchovávanie potvrdených vstupných riadkov aktívne.
`static ObsluhaUdalostí`	`aktívnaObsluhaUdalostí()` Táto metóda slúži na získanie aktívnej inštancie obsluhy udalostí.
`static ObsluhaUdalosti`	`aktivnaObsluhuUdalosti()` Alias pre `aktívnaObsluhaUdalostí`.
`static void`	`aktivujHistoriuVstupnehoRiadka()` Alias pre `aktivujHistóriuVstupnéhoRiadka`.
`static void`	`aktivujHistóriuVstupnéhoRiadka()` Aktivuje automatické uchovávanie potvrdených vstupných riadkov.
`static boolean`	`aktivujStandardnyVstup()` Alias pre `aktivujŠtandardnýVstup`.
`static boolean`	`aktivujStandardnyVstup(String kódovanie)` Alias pre `aktivujŠtandardnýVstup`.
`static boolean`	`aktivujŠtandardnýVstup()` Táto metóda vykoná jednorazovú akciu aktivovania štandardného vstupu s predvoleným kódovaním UTF-8.
`static boolean`	`aktivujŠtandardnýVstup(String kódovanie)` Táto metóda vykoná jednorazovú akciu aktivovania štandardného vstupu so zadaným kódovaním.
`static void`	`aktivujVstupnyRiadok()` Alias pre `aktivujVstupnýRiadok`.
`static void`	`aktivujVstupnýRiadok()` V prípade, že vstupný riadok je stále viditeľný, môžeme do neho touto metódou presmerovať vstup – v riadku sa aktivuje blikajúci kurzor.
`static String`	`bodVAktivnomSlove(double x, double y)` Alias pre `bodVAktívnomSlove`.
`static String`	`bodVAktívnomSlove(double x, double y)` Overí, či sa bod identifikovaný zadanými súradnicami nachádza v oblasti niektorého z aktívnych slov.
`static String`	`bodVAktivnomSlove(Poloha poloha)` Alias pre `bodVAktívnomSlove`.
`static String`	`bodVAktívnomSlove(Poloha poloha)` Funguje rovnako ako metóda `bodVAktívnomSlove`, ale namiesto súradníc bodu je zadaný objekt, ktorý je implementáciou rozhrania `Poloha`.
`static void`	`cakaj(double početSekúnd)` Alias pre `čakaj`.
`static KeyEvent`	`cakajNaKlaves()` Alias pre `čakajNaKláves`.
`static InputEvent[]`	`cakajNaKlavesAleboKlik()` Alias pre `čakajNaKlikAleboKláves`.
`static MouseEvent`	`cakajNaKlik()` Alias pre `čakajNaKlik`.
`static InputEvent[]`	`cakajNaKlikAleboKlaves()` Alias pre `čakajNaKlikAleboKláves`.
`static String`	`cakajNaVstup()` Alias pre `čakajNaVstup`.
`static boolean`	`casovacAktivny()` Alias pre `časovačAktívny`.
`static boolean`	`casovacSpi()` Alias pre `časovačSpí`.
`static boolean`	`casovacSpusteny()` Alias pre `časovačAktívny`.
`static boolean`	`celaObrazovka()` Alias pre `celáObrazovka`.
`static boolean`	`celáObrazovka()` Pokúsi sa prepnúť svet do režimu celej obrazovky.
`static boolean`	`celaObrazovka(boolean celáObrazovka)` Alias pre `celáObrazovka`.
`static boolean`	`celáObrazovka(boolean celáObrazovka)` Pokúsi sa prepnúť svet do režimu celej obrazovky alebo späť.
`static boolean`	`celaObrazovka(int zariadenie)` Alias pre `celáObrazovka`.
`static boolean`	`celáObrazovka(int zariadenie)` Pokúsi sa prepnúť svet do režimu celej obrazovky na určenom zobrazovacom zariadení.
`static boolean`	`celaObrazovka(int zariadenie, boolean celáObrazovka)` Alias pre `celáObrazovka`.
`static boolean`	`celáObrazovka(int zariadenie, boolean celáObrazovka)` Pokúsi sa prepnúť svet do režimu celej obrazovky alebo späť na určenom zobrazovacom zariadení.
`static String`	`celeNaRimske(long celé)` Alias pre `celéNaRímske`.
`static String`	`celéNaRímske(long celé)` Prevedie zadané celé číslo na reťazec s rímskou reprezentáciou celých čísiel.
`static long`	`ciselnyKoren(long číslo)` Alias pre `číselnýKoreň`.
`static long`	`ciselnyKoren(long číslo, long základ)` Alias pre `číselnýKoreň`.
`static int`	`cisloTiku()` Alias pre `čísloTiku`.
`static void`	`citajKonfiguraciuSveta()` Alias pre `čítajKonfiguráciuSveta`.
`static void`	`citajObrazky(Object... súbory)` Alias pre `čítajObrázky`.
`static void`	`citajObrazky(String[] súbory)` Alias pre `čítajObrázky`.
`static Image`	`citajObrazok(String súbor)` Alias pre `čítajObrázok`.
`static Object`	`citajPremennu(String názov, Class<?> typ)` Alias pre `čítajPremennú`.
`static Zvuk`	`citajZvuk(String súbor)` Alias pre `čítajZvuk`.
`static Zvuk`	`citajZvuk(String súbor, boolean unikátny)` Alias pre `čítajZvuk`.
`static void`	`citajZvuky(Object... súbory)` Alias pre `čítajZvuky`.
`static void`	`citajZvuky(String[] súbory)` Alias pre `čítajZvuky`.
`static void`	`čakaj(double početSekúnd)` Pozdrží vykonávanie programu na zadaný počet sekúnd.
`static KeyEvent`	`čakajNaKláves()` Slúži na pozastavenie (blokovanie) programu s cieľom čakania na stlačenie klávesu.
`static InputEvent[]`	`čakajNaKlávesAleboKlik()` Alias pre `čakajNaKlikAleboKláves`.
`static MouseEvent`	`čakajNaKlik()` Slúži na pozastavenie (blokovanie) programu s cieľom čakania na kliknutie ľubovoľným tlačidlom myši.
`static InputEvent[]`	`čakajNaKlikAleboKláves()` Slúži na pozastavenie (blokovanie) programu s cieľom čakania na stlačenie ľubovoľného klávesu alebo kliknutie ľubovoľným tlačidlom myši.
`static String`	`čakajNaVstup()` Táto metóda implementuje mechanizmus blokovania pri čakaní údajov zo štandardného vstupu (v samostatnom vlákne).
`static boolean`	`časovačAktívny()` Zistí, či je časovač aktívny.
`static boolean`	`časovačSpí()` Zistí, či je časovač v „režime spánku.“ Podrobnosti o užitočnosti spánku časovača nájdete v opise metódy uspiČasovač.
`static boolean`	`časovačSpustený()` Alias pre `časovačAktívny`.
`static long`	`číselnýKoreň(long číslo)` Vypočíta číselný koreň (digital root; alebo opakovaný digitálny súčet) absolútnej hodnoty zadaného čísla v desiatkovej číselnej sústave.
`static long`	`číselnýKoreň(long číslo, long základ)` Vypočíta číselný koreň (digital root; alebo opakovaný digitálny súčet) absolútnej hodnoty zadaného čísla podľa zadaného číselného základu.
`static int`	`čísloTiku()` Overí, ktorý násobok tiku je práve vykonávaný.
`static void`	`čítajKonfiguráciuSveta()` Prečíta konfiguráciu sveta (a plátien).
`static void`	`čítajObrázky(Object... súbory)` Táto metóda slúži na čítanie zadaných obrázkov do vnútornej pamäte sveta (napríklad pri štarte aplikácie).
`static void`	`čítajObrázky(String[] súbory)` Táto metóda slúži na čítanie zadaných obrázkov do vnútornej pamäte sveta (napríklad pri štarte aplikácie).
`static Image`	`čítajObrázok(String súbor)` Prečíta do vnútornej pamäte sveta zadaný obrázok zo súboru a vráti ho v objekte typu `Image`.
`static Object`	`čítajPremennú(String názov, Class<?> typ)` Zistí hodnotu premennej zadaného údajového typu interaktívneho režimu.
`static Zvuk`	`čítajZvuk(String súbor)` Prečíta do vnútornej pamäte sveta zadaný zvuk zo súboru a vráti ho v objekte typu `Zvuk`.
`static Zvuk`	`čítajZvuk(String súbor, boolean unikátny)` Prečíta do vnútornej pamäte sveta zadaný zvuk zo súboru a vráti ho v objekte typu `Zvuk`.
`static void`	`čítajZvuky(Object... súbory)` Táto metóda slúži na čítanie zadaných zvukových súborov do vnútornej pamäte sveta (napríklad pri štarte aplikácie).
`static void`	`čítajZvuky(String[] súbory)` Táto metóda slúži na čítanie zadaných zvukových súborov do vnútornej pamäte sveta (napríklad pri štarte aplikácie).
`static long`	`dajPrvocislo(int n)` Alias pre `dajPrvočíslo`.
`static long`	`dajPrvočíslo(int n)` Vráti n-té prvočíslo.
`static GRobot`	`dajRobot(String menoRobota)` Vráti inštanciu robota podľa jeho mena.
`static GRobot`	`dajRobota(String menoRobota)` Alias pre `dajRobot`.
`static Skript`	`dajSkript(String názov)` Vráti inštanciu skriptu registrovanú vo vnútornej pamäti programovacieho rámca pod zadaným menom.
`static void`	`deaktivujHistoriuVstupnehoRiadka()` Alias pre `deaktivujHistóriuVstupnéhoRiadka`.
`static void`	`deaktivujHistóriuVstupnéhoRiadka()` Deaktivuje automatické uchovávanie potvrdených vstupných riadkov počas činnosti aplikácie.
`static Vlnenie`	`definovaneVlnenie()` Alias pre `jestvujúceVlnenie`.
`static Vlnenie`	`definovanéVlnenie()` Alias pre `jestvujúceVlnenie`.
`static boolean`	`dialog(String[] popisy, Object[] údaje)` Alias pre `dialóg`.
`static boolean`	`dialóg(String[] popisy, Object[] údaje)` Otvorí prispôsobiteľný dialóg s prvkami vytvorenými podľa poľa `údaje`.
`static boolean`	`dialog(String[] popisy, Object[] údaje, String titulok)` Alias pre `dialóg`.
`static boolean`	`dialóg(String[] popisy, Object[] údaje, String titulok)` Vytvorí a otvorí prispôsobiteľný dialóg s prvkami vytvorenými podľa obsahu poľa `údaje`.
`static double`	`dolnyOkraj()` Alias pre `dolnýOkraj`.
`static double`	`dolnýOkraj()` Alias pre `spodnýOkraj`.
`static Vlnenie`	`existujuceVlnenie()` Alias pre `jestvujúceVlnenie`.
`static Vlnenie`	`existujúceVlnenie()` Alias pre `jestvujúceVlnenie`.
`static String`	`F(double číslo, int desatinné)` Táto metóda slúži na jednoduché formátovanie reálnych čísiel.
`static String`	`F(double číslo, int šírka, int desatinné)` Táto metóda slúži na jednoduché formátovanie reálnych čísiel.
`static Farba`	`farbaBodu(double x, double y)` Zistí farbu bodu (jedného pixela) na zadaných súradniciach.
`static boolean`	`farbaBodu(double x, double y, Color farba)` Zistí, či sa farba bodu (jedného pixela) na zadaných súradniciach zhoduje so zadanou farbou.
`static boolean`	`farbaBodu(double x, double y, Farebnosť objekt)` Zistí, či sa farba bodu (jedného pixela) na zadaných súradniciach zhoduje s farbou zadaného objektu.
`static boolean`	`farbaBodu(double x, double y, int r, int g, int b)` Zistí, či sa farba bodu (jedného pixela) na zadaných súradniciach zhoduje s farbou zadanou prostredníctvom farebných zložiek.
`static boolean`	`farbaBodu(double x, double y, int r, int g, int b, int a)` Zistí, či sa farba bodu (jedného pixela) na zadaných súradniciach zhoduje s farbou zadanou prostredníctvom farebných zložiek a úrovne priehľadnosti.
`static Farba`	`farbaBodu(Poloha objekt)` Zistí farbu bodu (jedného pixela) na pozícii zadaného objektu.
`static boolean`	`farbaBodu(Poloha objekt, Color farba)` Zistí, či sa farba bodu (jedného pixela) na súradniciach zadaného objektu zhoduje so zadanou farbou.
`static boolean`	`farbaBodu(Poloha objekt, Farebnosť farebnosť)` Zistí, či sa farba bodu (jedného pixela) na zadaných súradniciach zhoduje s farbou zadaného objektu.
`static boolean`	`farbaBodu(Poloha objekt, int r, int g, int b)` Zistí, či sa farba bodu (jedného pixela) na súradniciach zadaného objektu zhoduje s farbou zadanou prostredníctvom farebných zložiek.
`static boolean`	`farbaBodu(Poloha objekt, int r, int g, int b, int a)` Zistí, či sa farba bodu (jedného pixela) na súradniciach zadaného objektu zhoduje s farbou zadanou prostredníctvom farebných zložiek a úrovne priehľadnosti.
`static Farba`	`farbaNaMysi()` Alias pre `farbaNaMyši`.
`static boolean`	`farbaNaMysi(Color farba)` Alias pre `farbaNaMyši`.
`static boolean`	`farbaNaMysi(Farebnosť objekt)` Alias pre `farbaNaMyši`.
`static boolean`	`farbaNaMysi(int r, int g, int b)` Alias pre `farbaNaMyši`.
`static boolean`	`farbaNaMysi(int r, int g, int b, int a)` Alias pre `farbaNaMyši`.
`static Farba`	`farbaNaMyši()` Zistí farbu bodu (jedného pixela) na súradniciach myši.
`static boolean`	`farbaNaMyši(Color farba)` Zistí, či sa farba bodu (jedného pixela) na súradniciach myši zhoduje so zadanou farbou.
`static boolean`	`farbaNaMyši(Farebnosť objekt)` Zistí, či sa farba bodu (jedného pixela) na súradniciach myši zhoduje so zadanou farbou.
`static boolean`	`farbaNaMyši(int r, int g, int b)` Zistí, či je farba bodu (jedného pixela) na súradniciach myši zhodná s farbou zadanou prostredníctvom farebných zložiek.
`static boolean`	`farbaNaMyši(int r, int g, int b, int a)` Zistí, či sa farba bodu (jedného pixela) na súradniciach myši zhoduje s farbou zadanou prostredníctvom farebných zložiek a úrovne priehľadnosti.
`static Farba`	`farbaPlochy()` Číta farbu plochy sveta.
`static void`	`farbaPlochy(Color nováFarba)` Nastaví farbu plochy sveta.
`static void`	`farbaPlochy(Farebnosť objekt)` Nastaví farbu plochy sveta podľa farby zadaného objektu.
`static Farba`	`farbaPlochy(int r, int g, int b)` Nastaví farbu plochy sveta.
`static Farba`	`farbaPlochy(int r, int g, int b, int a)` Nastaví farbu a (ne)priehľadnosť plochy sveta.
`static Farba`	`farbaPozadia()` Čítaj farbu pozadia sveta.
`static void`	`farbaPozadia(Color nováFarba)` Nastav farbu pozadia sveta.
`static void`	`farbaPozadia(Farebnosť objekt)` Nastaví farbu pozadia sveta podľa farby zadaného objektu.
`static Farba`	`farbaPozadia(int r, int g, int b)` Nastav farbu pozadia sveta.
`static Farba`	`farbaPozadia(int r, int g, int b, int a)` Nastav farbu a (ne)priehľadnosť pozadia sveta.
`static Farba`	`farbaPozadiaTextu()` Zistí aktuálnu farbu pozadia výpisu nových textov stropu.
`static void`	`farbaPozadiaTextu(Color nováFarba)` Nastav farbu pozadia textov stropu.
`static void`	`farbaPozadiaTextu(Farebnosť objekt)` Nastav farbu pozadia textov stropu.
`static Farba`	`farbaPozadiaTextu(int r, int g, int b)` Nastav farbu pozadia textov stropu.
`static Farba`	`farbaPozadiaTextu(int r, int g, int b, int a)` Nastav farbu pozadia textov stropu.
`static Farba`	`farbaTextu()` Zistí aktuálnu farbu výpisu nových textov stropu.
`static void`	`farbaTextu(Color nováFarba)` Nastav farbu textov stropu.
`static void`	`farbaTextu(Farebnosť objekt)` Nastav farbu textov stropu.
`static Farba`	`farbaTextu(int r, int g, int b)` Nastav farbu textov stropu.
`static Farba`	`farbaTextu(int r, int g, int b, int a)` Nastav farbu textov stropu.
`static void`	`formulujChybuSkriptu(int kódSkriptu)` Sformuluje znenie chyby skriptu na základe zadaného kódu chyby a zobrazí dialóg s chybovým hlásením rozdeleným na riadky so predvoleným počtom znakov (`60`) a predvoleným titulkom chybového dialógu (`"Chyba skriptu…"`).
`static void`	`formulujChybuSkriptu(int kódSkriptu, int šírkaRiadka)` Sformuluje znenie chyby skriptu na základe zadaného kódu chyby a zobrazí dialóg s chybovým hlásením rozdeleným na riadky so zadaným počtom znakov a predvoleným titulkom chybového dialógu (`"Chyba skriptu…"`).
`static void`	`formulujChybuSkriptu(int kódSkriptu, String titulokChyby)` Sformuluje znenie chyby skriptu na základe zadaného kódu chyby a zobrazí dialóg s chybovým hlásením rozdeleným na riadky so predvoleným počtom znakov (`60`) a zadaným titulkom chybového dialógu.
`static void`	`formulujChybuSkriptu(int kódSkriptu, String titulokChyby, int šírkaRiadka)` Sformuluje znenie chyby skriptu na základe zadaného kódu chyby a zobrazí dialóg s chybovým hlásením rozdeleným na riadky so zadaným počtom znakov a zadaným titulkom chybového dialógu.
`static double`	`frekvenciaNoty(int nota, int oktáva)` Vypočíta harmonickú frekvenciu tónu na základe zadaného poradového čísla noty (odporúčané sú hodnoty 1 až 12) a oktávy (odporúčané sú hodnoty −1 až 9).
`static knižnica.podpora.BeepChannel`	`generatorTonov()` Alias pre `generátorTónov`.
`static knižnica.podpora.BeepChannel`	`generátorTónov()` Táto metóda sprostredkúva prístup k vnútornej inštancii generátora tónov (`BeepChannel`).
`static Graphics2D`	`grafika()` Vráti grafický objekt sveta na kreslenie v reakcii `ObsluhaUdalostí.dokreslenie()`.
`static boolean`	`grafikaDoSchranky()` Alias pre `obrázokDoSchránky`.
`static boolean`	`grafikaDoSchránky()` Alias pre `obrázokDoSchránky`.
`static Zoznam<String>`	`historiaVstupnehoRiadka()` Alias pre `históriaVstupnéhoRiadka`.
`static Zoznam<String>`	`históriaVstupnéhoRiadka()` Vráti zoznam reťazcov histórie vstupného riadka.
`static void`	`hlasitostPreZvuky(double miera, Object... súbory)` Alias pre `hlasitosťPreZvuky`
`static void`	`hlasitosťPreZvuky(double miera, Object... súbory)` Nastaví hromadne hlasitosť pre všetky uvedené zvuky.
`static void`	`hlasitostPreZvuky(double miera, String[] súbory)` Alias pre `hlasitosťPreZvuky`
`static void`	`hlasitosťPreZvuky(double miera, String[] súbory)` Nastaví hromadne hlasitosť pre všetky uvedené zvuky.
`static JPanel`	`hlavnyPanel()` Alias pre `hlavnýPanel`.
`static JPanel`	`hlavnýPanel()` Poskytne komponent hlavného panela vloženého v hlavnom okne aplikácie (vo svete).
`static GRobot`	`hlavnyRobot()` Alias pre `hlavnýRobot`.
`static GRobot`	`hlavnýRobot()` Vráti hlavný robot.
`static double`	`hornyOkraj()` Alias pre `hornýOkraj`.
`static double`	`hornýOkraj()` Alias pre `vrchnýOkraj`.
`static void`	`hrajTon(double frekvencia)` Alias pre `hrajTón`.
`static void`	`hrajTón(double frekvencia)` Spustí prehrávanie tónu tvoreného jedinou harmonickou frekvenciou.
`static void`	`hrajTon(double frekvencia, double hlasitosť)` Alias pre `hrajTón`.
`static void`	`hrajTón(double frekvencia, double hlasitosť)` Spustí prehrávanie tónu tvoreného jedinou harmonickou frekvenciou so zadanou hlasitosťou (v rozsahu od `0.0` do `1.0`).
`static void`	`hrajTon(double frekvencia, double hlasitosť, double trvanie)` Alias pre `hrajTón`.
`static void`	`hrajTón(double frekvencia, double hlasitosť, double trvanie)` Spustí prehrávanie tónu tvoreného jedinou harmonickou frekvenciou so zadanou hlasitosťou (v rozsahu od `0.0` do `1.0`) a s dĺžkou trvania prehrávania v sekundách.
`static boolean`	`hraZvukNaPozadi()` Alias pre `hráZvukNaPozadí`.
`static boolean`	`hráZvukNaPozadí()` Zistí, či je aktívne prehrávanie zvuku na pozadí, ktoré bolo spustené metódou `zvukNaPozadí`.
`static void`	`chyba(String chyba)` Zobrazí štandardný dialóg so zadanou textovou správou a ikonou chyby.
`static void`	`chyba(String chyba, String titulok)` Zobrazí štandardný dialóg so zadanou textovou správou a ikonou chyby.
`static boolean`	`chybaSystemovejIkony(String chyba)` Alias pre `chybaSystémovejIkony`.
`static boolean`	`chybaSystémovejIkony(String chyba)` Ak je definovaná systémová ikona, tak v jej kontexte zobrazí zadané chybové oznámenie.
`static boolean`	`chybaSystemovejIkony(String chyba, String titulok)` Alias pre `chybaSystémovejIkony`.
`static boolean`	`chybaSystémovejIkony(String chyba, String titulok)` Ak je definovaná systémová ikona, tak v jej kontexte zobrazí zadané chybové oznámenie s titulkom.
`static Obrazok`	`ikona()` Prečíta ikonu okna aplikácie a prevedie ju na obrázok.
`static void`	`ikona(Image obrázok)` Nastaví oknu aplikácie ikonu podľa zadaného obrázka.
`static void`	`ikona(String súbor)` Nastaví oknu aplikácie novú ikonu.
`static boolean`	`informaciaSystemovejIkony(String informácia)` Alias pre `informáciaSystémovejIkony`.
`static boolean`	`informáciaSystémovejIkony(String informácia)` Ak je definovaná systémová ikona, tak v jej kontexte zobrazí zadané informačné oznámenie.
`static boolean`	`informaciaSystemovejIkony(String informácia, String titulok)` Alias pre `informáciaSystémovejIkony`.
`static boolean`	`informáciaSystémovejIkony(String informácia, String titulok)` Ak je definovaná systémová ikona, tak v jej kontexte zobrazí zadané informačné oznámenie s titulkom.
`static String`	`interaktivnaInstancia()` Alias pre `interaktívnaInštancia`.
`static void`	`interaktivnaInstancia(String inštancia)` Alias pre `interaktívnaInštancia`.
`static String`	`interaktívnaInštancia()` Vráti aktívnu inštanciu interaktívneho režimu alebo `null`.
`static void`	`interaktívnaInštancia(String inštancia)` Nastaví alebo zruší aktívnu inštanciu pre interaktívny režim.
`static boolean`	`interaktivnyRezim()` Alias pre `interaktívnyRežim`.
`static void`	`interaktivnyRezim(boolean zapni)` Alias pre `interaktívnyRežim`.
`static boolean`	`interaktívnyRežim()` Zistí stav interaktívneho režimu pre svet.
`static void`	`interaktívnyRežim(boolean zapni)` Zapne alebo vypne interaktívny režim pre inštanciu sveta.
`static double`	`intervalCasovaca()` Alias pre `intervalČasovača`.
`static double`	`intervalČasovača()` Vráti časový interval časovača v sekundách.
`static boolean`	`jePrvocislo(long číslo)` Alias pre `jePrvočíslo`.
`static boolean`	`jePrvočíslo(long číslo)` Overí, či zadané číslo je prvočíslo.
`static Vlnenie`	`jestvujuceVlnenie()` Alias pre `jestvujúceVlnenie`.
`static Vlnenie`	`jestvujúceVlnenie()` Táto metóda vráti inštanciu vlnenia len v prípade, že jestvuje.
`static int`	`kodPoslednejChyby()` Alias pre `kódPoslednejChyby`.
`static int`	`kódPoslednejChyby()` Získa kód poslednej chyby, ktorá nastala počas vykonávania príkazov interaktívneho režimu alebo skriptu.
`static Súbor`	`konfiguracnySubor()` Alias pre `konfiguračnýSúbor`.
`static Súbor`	`konfiguračnýSúbor()` Vráti inštanciu konfiguračného súboru na účely úpravy jeho parametrov, napríklad na úpravu predvolenej sekcie automatickej konfigurácie.
`static void`	`koniec()` Skončí aplikáciu bez opýtania.
`static void`	`koniec(int kód)` Skončí aplikáciu s návratovým kódom pre opreračný systém.
`static boolean`	`kreslenie()` Overí, či je automatické prekresľovanie sveta zapnuté.
`static void`	`kresli()` Zapne automatické prekresľovanie sveta, ktoré bolo vypnuté metódou `nekresli`.
`static void`	`kresli(Shape tvar)` Táto metóda slúži na kreslenie obrysov zadaného tvaru na podlahu.
`static void`	`kresli(Shape tvar, GRobot kreslič)` Táto metóda slúži na kreslenie obrysov zadaného tvaru na podlahu.
`static double`	`kubickaAproximacia(double v0, double v1, double v2, double v3, double t)` Alias pre `kubickáAproximácia`.
`static double`	`kubickáAproximácia(double v0, double v1, double v2, double v3, double t)` Kubická aproximácia je počítaná zo štyroch vstupných hodnôt (a parametra).
`static double`	`kubickaInterpolacia(double v0, double v1, double v2, double v3, double t)` Alias pre `kubickáInterpolácia`.
`static double`	`kubickáInterpolácia(double v0, double v1, double v2, double v3, double t)` Kubická interpolácia je počítaná zo štyroch vstupných hodnôt (a parametra).
`static double`	`kvadratickaAproximacia(double a, double b, double c, double t)` Alias pre `kvadratickáAproximácia`.
`static double`	`kvadratickáAproximácia(double a, double b, double c, double t)` Kvadratická aproximácia je počítaná z troch vstupných hodnôt (a parametra).
`static double`	`kvadratickaInterpolacia(double a, double b, double c, double t)` Alias pre `kvadratickáInterpolácia`.
`static double`	`kvadratickáInterpolácia(double a, double b, double c, double t)` Kvadratická interpolácia je počítaná z troch vstupných hodnôt (a parametra).
`static double`	`lavyOkraj()` Alias pre `ľavýOkraj`.
`static double`	`ľavýOkraj()` Zistí najmenšiu aktuálne viditeľnú x-ovú súradnicu plátien (podlahy alebo stropu).
`static boolean`	`lenRezimLadenia()` Alias pre `lenRežimLadenia`.
`static boolean`	`lenRežimLadenia()` Zistí, či je zapnutý režim ladenia programovacieho rámca GRobot bez ohľadu na režim výpisu chybových hlásení rámca.
`static double`	`linearnaInterpolacia(double a, double b, double t)` Alias pre `lineárnaInterpolácia`.
`static double`	`lineárnaInterpolácia(double a, double b, double t)` Táto metóda slúži na parametrické vypočítanie hodnoty ležiacej medzi dvomi zadanými hodnotami.
`static boolean`	`maVlnenie()` Alias pre `máVlnenie`.
`static boolean`	`máVlnenie()` Overí, či má svet definovanú inštanciu vlnenia.
`static boolean`	`maximalizovany()` Alias pre `maximalizovaný`.
`static boolean`	`maximalizovaný()` Zistí, či je okno sveta v maximalizovanom stave.
`static void`	`maximalizuj()` Pokúsi sa prepnúť okno sveta do maximalizovaného stavu.
`static double`	`maximalneX()` Alias pre `najväčšieX`.
`static double`	`maximálneX()` Alias pre `najväčšieX`.
`static double`	`maximalneY()` Alias pre `najväčšieY`.
`static double`	`maximálneY()` Alias pre `najväčšieY`.
`static Bod`	`mierkaVyplne()` Alias pre `mierkaVýplne`.
`static Bod`	`mierkaVýplne()` Vráti bod s hodnotami mierky obrázkových dlaždicových výplní v osiach x a y.
`static void`	`mierkaVyplne(double mierka)` Alias pre `mierkaVýplne`.
`static void`	`mierkaVýplne(double mierka)` Nastaví mierku obrázkových dlaždicových výplní (v oboch osiach naraz).
`static void`	`mierkaVyplne(double mx, double my)` Alias pre `mierkaVýplne`.
`static void`	`mierkaVýplne(double mx, double my)` Nastaví mierku obrázkových dlaždicových výplní jednotlivo pre osi x a y.
`static boolean`	`minimalizovany()` Alias pre `minimalizovaný`.
`static boolean`	`minimalizovaný()` Zistí, či je okno sveta v minimalizovanom stave.
`static void`	`minimalizuj()` Pokúsi sa prepnúť okno sveta do minimalizovaného stavu.
`static double`	`minimalneX()` Alias pre `najmenšieX`.
`static double`	`minimálneX()` Alias pre `najmenšieX`.
`static double`	`minimalneY()` Alias pre `najmenšieY`.
`static double`	`minimálneY()` Alias pre `najmenšieY`.
`static Object[]`	`mojeOdpovede()` Vráti pole vlastných odpovedí komunikačných dialógov programovacieho rámca alebo hodnotu `null`, ak sú aktívne predvolené odpovede.
`static void`	`mojeOdpovede(Object[] odpovede)` Zmení predvolené odpovede komunikačných dialógov programovacieho rámca na vlastné.
`static boolean`	`mysJeZachytena()` Alias pre `myšJeZachytená`.
`static String`	`mysVAktivnomSlove()` Alias pre `myšVAktívnomSlove`.
`static boolean`	`myšJeZachytená()` Overí, či je myš zachytená v okne sveta.
`static String`	`myšVAktívnomSlove()` Overí, či sa súradnice kurzora myši nachádzajú v oblasti niektorého z aktívnych slov.
`static long`	`nahodneCeleCislo()` Alias pre `náhodnéCeléČíslo`.
`static long`	`nahodneCeleCislo(long hodnota)` Alias pre `náhodnéCeléČíslo`.
`static long`	`nahodneCeleCislo(long min, long max)` Alias pre `náhodnéCeléČíslo`.
`static long`	`náhodnéCeléČíslo()` Generovanie náhodného celého čísla v celom rozsahu `long`.
`static long`	`náhodnéCeléČíslo(long hodnota)` Generovanie náhodného celého čísla v rozsahu od nula (vrátane) po zadanú hodnotu parametra (vrátane).
`static long`	`náhodnéCeléČíslo(long min, long max)` Generovanie náhodného celého čísla v zadanom rozsahu.
`static double`	`nahodneRealneCislo()` Alias pre `náhodnéReálneČíslo`.
`static double`	`nahodneRealneCislo(double hodnota)` Alias pre `náhodnéReálneČíslo`.
`static double`	`nahodneRealneCislo(double min, double max)` Alias pre `náhodnéReálneČíslo`.
`static double`	`náhodnéReálneČíslo()` Generovanie náhodného reálneho čísla v rozsahu od nula (vrátane) po jeden (vynímajúc).
`static double`	`náhodnéReálneČíslo(double hodnota)` Generovanie náhodného reálneho čísla v rozsahu od nula (vrátane) po zadanú hodnotu parametra (vynímajúc).
`static double`	`náhodnéReálneČíslo(double min, double max)` Generovanie náhodného reálneho čísla v zadanom rozsahu.
`static Skript`	`nahrajSkript(String súbor)` Toto je klon metódy `nahrajSkript(názov, súbor)`, ktorý bol definovaný preto, aby bolo možné nahrávať zo súborov skripty aj v rámci iných skriptov.
`static Skript`	`nahrajSkript(String názov, String súbor)` Nahrá skript zo súboru a uloží ho do vnútornej pamäte pod zadaným názvom.
`static Bod`	`najblizsiBodNaKruznici(double x0, double y0, double x1, double y1, double r)` Alias pre `najbližšíBodNaKružnici`.
`static Bod`	`najblizsiBodNaKruznici(Poloha V, Poloha S, double r)` Alias pre `najbližšíBodNaKružnici`.
`static Bod`	`najblizsiBodNaPriamke(double x0, double y0, double x1, double y1, double x2, double y2)` Alias pre `najbližšíBodNaPriamke`.
`static Bod`	`najblizsiBodNaPriamke(Poloha[] poleBodov)` Alias pre `najbližšíBodNaPriamke`.
`static Bod`	`najblizsiBodNaPriamke(Poloha V, Poloha A, Poloha B)` Alias pre `najbližšíBodNaPriamke`.
`static Bod`	`najblizsiBodNaUsecke(double x0, double y0, double x1, double y1, double x2, double y2)` Alias pre `najbližšíBodNaÚsečke`.
`static Bod`	`najblizsiBodNaUsecke(Poloha[] poleBodov)` Alias pre `najbližšíBodNaÚsečke`.
`static Bod`	`najblizsiBodNaUsecke(Poloha V, Poloha A, Poloha B)` Alias pre `najbližšíBodNaÚsečke`.
`static Bod`	`najbližšíBodNaKružnici(double x0, double y0, double x1, double y1, double r)` Nájde najbližší bod na kružnici so stredom S[x1, y1] a polomerom r k zadanému voľnému bodu V[x0, y0] a vráti jeho polohu v objekte typu `Bod`.
`static Bod`	`najbližšíBodNaKružnici(Poloha V, Poloha S, double r)` Nájde najbližší bod na kružnici so stredom S a polomerom r k zadanému voľnému bodu V a vráti jeho polohu v objekte typu `Bod`.
`static Bod`	`najbližšíBodNaPriamke(double x0, double y0, double x1, double y1, double x2, double y2)` Nájde najbližší bod na priamke určenej dvomi bodmi A[x1, y1] a B[x2, y2] k zadanému voľnému bodu V[x0, y0] a vráti jeho súradnice v objekte typu `Bod`.
`static Bod`	`najbližšíBodNaPriamke(Poloha[] poleBodov)` Nájde najbližší bod na priamke AB k zadanému voľnému bodu V a vráti jeho súradnice v objekte typu `Bod`.
`static Bod`	`najbližšíBodNaPriamke(Poloha V, Poloha A, Poloha B)` Nájde najbližší bod na priamke AB k zadanému voľnému bodu V a vráti jeho súradnice v objekte typu `Bod`.
`static Bod`	`najbližšíBodNaÚsečke(double x0, double y0, double x1, double y1, double x2, double y2)` Nájde najbližší bod na úsečke určenej dvomi bodmi A[x1, y1] a B[x2, y2] k zadanému voľnému bodu V[x0, y0] a vráti jeho súradnice v objekte typu `Bod`.
`static Bod`	`najbližšíBodNaÚsečke(Poloha[] poleBodov)` Nájde najbližší bod na úsečke AB k zadanému voľnému bodu V a vráti jeho súradnice v objekte typu `Bod`.
`static Bod`	`najbližšíBodNaÚsečke(Poloha V, Poloha A, Poloha B)` Nájde najbližší bod na úsečke AB k zadanému voľnému bodu V a vráti jeho súradnice v objekte typu `Bod`.
`static double`	`najmensieX()` Alias pre `najmenšieX`.
`static double`	`najmensieY()` Alias pre `najmenšieY`.
`static double`	`najmenšieX()` Zistí najmenšiu x-ovú súradnicu sveta.
`static double`	`najmenšieY()` Zistí najmenšiu y-ovú súradnicu sveta.
`static double`	`najvacsieX()` Alias pre `najväčšieX`.
`static double`	`najvacsieY()` Alias pre `najväčšieY`.
`static double`	`najväčšieX()` Zistí najväčšiu x-ovú súradnicu sveta.
`static double`	`najväčšieY()` Zistí najväčšiu y-ovú súradnicu sveta.
`static String[]`	`naRiadkyBezZmien(String text)` Rozdelí zadaný reťazec na samostatné riadky bez ďalších úprav.
`static int`	`nasobTiky()` Alias pre `násobTiky`.
`static int`	`násobTiky()` Zistí aktuálnu hodnotu násobičky tikov časovača.
`static void`	`nasobTiky(int násobTiky)` Alias pre `násobTiky`.
`static void`	`násobTiky(int počet)` Upraví hodnotu násobičky tikov časovača.
`static String`	`nazovKonfiguracnehoSuboru()` Alias pre `názovKonfiguračnéhoSúboru`.
`static String`	`názovKonfiguračnéhoSúboru()` Vráti naposledy použitý názov konfiguračného súboru.
`static boolean`	`neboloPrekreslene()` Alias pre `nebolPrekreslený`.
`static boolean`	`neboloPrekreslené()` Alias pre `nebolPrekreslený`.
`static boolean`	`nebolPrekresleny()` Alias pre `nebolPrekreslený`.
`static boolean`	`nebolPrekreslený()` Zistí stav príznaku zamietnutej požiadavky na automatické prekreslenie.
`static void`	`nekresli()` Vypne predvolenú implementáciu automatického prekresľovanie sveta.
`static void`	`neskryvajVstupnyRiadok()` Alias pre `neskrývajVstupnýRiadok`.
`static void`	`neskrývajVstupnýRiadok()` Prikáže vstupnému riadku, aby sa neskrýval po potvrdení klávesom `Enter`.
`static boolean`	`neskryvajVstupnyRiadok(boolean začniVstup)` Alias pre `neskrývajVstupnýRiadok`.
`static boolean`	`neskrývajVstupnýRiadok(boolean začniVstup)` Prikáže vstupnému riadku, aby sa neskrýval po potvrdení klávesom `Enter`.
`static void`	`nespi()` Spustí aktivitu pravidelného generovania udalostí pohybu kurzorom myšky, aby sa zabránilo prechodu počítača do režimu spánku.
`static void`	`nespi(int novýInterval)` Spustí aktivitu pravidelného generovania udalostí pohybu kurzorom myšky, aby sa zabránilo prechodu počítača do režimu spánku.
`static void`	`nespi(int novýInterval, boolean ajČasovač)` Spustí aktivitu pravidelného generovania udalostí pohybu kurzorom myšky, aby sa zabránilo prechodu počítača do režimu spánku.
`static void`	`neuchovajHistoriuVstupnehoRiadka()` Alias pre `neuchovajHistóriuVstupnéhoRiadka`.
`static void`	`neuchovajHistóriuVstupnéhoRiadka()` Deaktivuje automatické uchovávanie histórie vstupných riadkov do konfiguračného súboru.
`static void`	`nezalamujTexty()` Vypne zalamovanie textov vnútornej konzoly stropu.
`static boolean`	`normalny()` Alias pre `normálny`.
`static boolean`	`normálny()` Zistí, či je okno sveta v normálnom stave.
`static void`	`novyKurzorMysi(Image predloha, double x, double y, String meno)` Alias pre `novýKurzorMyši`.
`static void`	`novyKurzorMysi(Image predloha, int x, int y, String meno)` Alias pre `novýKurzorMyši`.
`static void`	`novýKurzorMyši(Image predloha, double x, double y, String meno)` Alias pre `novýKurzorMyši`.
`static void`	`novýKurzorMyši(Image predloha, int x, int y, String meno)` Definuje nový kurzor myši použiteľný v hlavnom okne aplikácie.
`static void`	`obnov()` Pokúsi sa prepnúť okno sveta do normálneho stavu.
`static BufferedImage`	`obrazok()` Alias pre `obrázok`.
`static BufferedImage`	`obrázok()` Vráti objekt typu `BufferedImage` obsahujúci aktuálnu obrazovú informáciu sveta.
`static void`	`obrazok(double x, double y, Image obrázok)` Alias pre `obrázok`.
`static void`	`obrázok(double x, double y, Image obrázok)` Nakreslí na zadaných súradniciach na podlahe obrázok.
`static void`	`obrazok(double x, double y, String súbor)` Alias pre `obrázok`.
`static void`	`obrázok(double x, double y, String súbor)` Nakreslí na zadaných súradniciach na podlahe obrázok.
`static void`	`obrazok(Image obrázok)` Alias pre `obrázok`.
`static void`	`obrázok(Image obrázok)` Nakreslí v strede podlahy zadaný obrázok.
`static void`	`obrazok(Poloha objekt, Image obrázok)` Alias pre `obrázok`.
`static void`	`obrázok(Poloha objekt, Image obrázok)` Nakreslí na súradniciach zadaného objektu na podlahe obrázok.
`static void`	`obrazok(Poloha objekt, String súbor)` Alias pre `obrázok`.
`static void`	`obrázok(Poloha objekt, String súbor)` Nakreslí na súradniciach zadaného objektu na podlahe obrázok.
`static void`	`obrazok(String súbor)` Alias pre `obrázok`.
`static void`	`obrázok(String súbor)` Nakreslí v strede podlahy zadaný obrázok.
`static boolean`	`obrazokDoSchranky()` Alias pre `obrázokDoSchránky`.
`static boolean`	`obrázokDoSchránky()` Vloží obrázok (grafiku) sveta do schránky.
`static char`	`oddelovacDesatinnejCasti()` Alias pre `oddeľovačDesatinnejČasti`.
`static void`	`oddelovacDesatinnejCasti(char oddeľovač)` Alias pre `oddeľovačDesatinnejČasti`.
`static String`	`oddelovacPrvkovPola()` Alias pre `oddeľovačPrvkovPoľa`.
`static void`	`oddelovacPrvkovPola(String oddeľovač)` Alias pre `oddeľovačPrvkovPoľa`.
`static Character`	`oddelovacTisicov()` Alias pre `oddeľovačTisícov`.
`static void`	`oddelovacTisicov(Character oddeľovač)` Alias pre `oddeľovačTisícov`.
`static char`	`oddeľovačDesatinnejČasti()` Zistí, aký oddeľovač desatinnej časti je aktuálne používaný pri výpisoch čísiel príkazmi `vypíš`, `vypíšRiadok`.
`static void`	`oddeľovačDesatinnejČasti(char oddeľovač)` Nastaví hodnotu oddeľovača desatinnej časti, ktorý bude používaný pri výpisoch príkazmi `vypíš`, `vypíšRiadok`.
`static String`	`oddeľovačPrvkovPoľa()` Zistí, aký oddeľovač prvkov je aktuálne používaný pri výpisoch polí príkazmi `vypíš`, `vypíšRiadok`.
`static void`	`oddeľovačPrvkovPoľa(String oddeľovač)` Nastaví hodnotu oddeľovača prvkov poľa, ktorý bude používaný pri výpisoch polí príkazmi `vypíš`, `vypíšRiadok`.
`static Character`	`oddeľovačTisícov()` Zistí, aký oddeľovač tisícov je aktuálne používaný pri výpisoch čísiel príkazmi `vypíš`, `vypíšRiadok`.
`static void`	`oddeľovačTisícov(Character oddeľovač)` Nastaví hodnotu oddeľovača tisícov, ktorý bude používaný pri výpisoch príkazmi `vypíš`, `vypíšRiadok`.
`static void`	`odlozCasovac(double čas)` Alias pre `odložČasovač`.
`static void`	`odložČasovač(double čas)` Odloží časovač o zadaný časový interval v sekundách.
`static void`	`odoberKlavesovuSkratku(String príkaz)` Alias pre `odoberKlávesovúSkratku`.
`static void`	`odoberKlávesovúSkratku(String príkaz)` Odoberie definovanú klávesovú skratku, ktorá je previazaná so zadaným príkazom.
`static int`	`odpovedDialogu()` Alias pre `odpoveďDialógu`.
`static int`	`odpoveďDialógu()` Vráti číslo (index) voľby v poslednom dialógu, ktorý bol zobrazený používateľovi.
`static void`	`odstranVlnenie()` Alias pre `odstráňVlnenie`.
`static void`	`odstráňVlnenie()` Ukončí vlnenie sveta a úplne odstráni inštanciu vlnenia, ktorá bola pre neho definovaná z prostredia programovacieho rámca GRobot.
`static JFrame`	`oknoCelejObrazovky()` Ak je svet v režime celej obrazovky, tak táto metóda vráti inštanciu `okna` celej obrazovky, inak metóda vráti hodnotu `null`.
`static int`	`opakovaniePerlina()` Vráti hodnotu opakovania vzoru generátora Perlinovho šumu.
`static void`	`opakovaniePerlina(int opakovanie)` Nastaví novú hodnotu opakovania vzoru generátora Perlinovho šumu.
`static CharSequence`	`orez(CharSequence sekvenciu, CharSequence znakmi)` Alias pre `orež`.
`static String`	`orez(String reťazec, String znakmi)` Alias pre `orež`.
`static CharSequence`	`orež(CharSequence sekvenciu, CharSequence znakmi)` Oreže sekvenciu znakov prvého parametra o znaky zadané do sekvencie znakov druhého parametra.
`static String`	`orež(String reťazec, String znakmi)` Oreže reťazec prvého parametra o znaky zadané do reťazca druhého parametra.
`static Obrazok`	`osvetlenie()` Overí, či má svet aktívne osvetlenie.
`static Obrazok`	`osvetlenie(boolean osvetli)` Zapne alebo vypne osvetlenie sveta.
`static int`	`otazka(String otázka)` Alias pre `otázka`.
`static int`	`otázka(String otázka)` Zobrazí štandardný dialóg s otázkou na používateľa (odpoveď používateľ volí stlačením tlačidla).
`static int`	`otazka(String otázka, Object[] tlačidlá)` Alias pre `otázka`.
`static int`	`otázka(String otázka, Object[] tlačidlá)` Zobrazí štandardný dialóg s otázkou na používateľa (odpoveď používateľ volí stlačením tlačidla).
`static int`	`otazka(String otázka, Object[] tlačidlá, int predvolenéTlačidlo)` Alias pre `otázka`.
`static int`	`otázka(String otázka, Object[] tlačidlá, int predvolenéTlačidlo)` Zobrazí štandardný dialóg s otázkou na používateľa (odpoveď používateľ volí stlačením tlačidla).
`static int`	`otazka(String otázka, String titulok)` Alias pre `otázka`.
`static int`	`otázka(String otázka, String titulok)` Zobrazí štandardný dialóg s otázkou na používateľa (odpoveď používateľ volí stlačením tlačidla).
`static int`	`otazka(String otázka, String titulok, Object[] tlačidlá)` Alias pre `otázka`.
`static int`	`otázka(String otázka, String titulok, Object[] tlačidlá)` Zobrazí štandardný dialóg s otázkou na používateľa (odpoveď používateľ volí stlačením tlačidla).
`static int`	`otazka(String otázka, String titulok, Object[] tlačidlá, int predvolenéTlačidlo)` Alias pre `otázka`.
`static int`	`otázka(String otázka, String titulok, Object[] tlačidlá, int predvolenéTlačidlo)` Zobrazí štandardný dialóg s otázkou na používateľa (odpoveď používateľ volí stlačením tlačidla).
`static double`	`otocenieVyplne()` Alias pre `otočenieVýplne`.
`static void`	`otocenieVyplne(double uhol)` Alias pre `otočenieVýplne`.
`static void`	`otocenieVyplne(double uhol, double sx, double sy)` Alias pre `otočenieVýplne`.
`static void`	`otocenieVyplne(double uhol, Poloha poloha)` Alias pre `otočenieVýplne`.
`static void`	`otocenieVyplne(double uhol, Shape tvar)` Alias pre `otočenieVýplne`.
`static void`	`otocenieVyplne(Smer smer)` Alias pre `otočenieVýplne`.
`static void`	`otocenieVyplne(Smer smer, double sx, double sy)` Alias pre `otočenieVýplne`.
`static void`	`otocenieVyplne(Smer smer, Poloha poloha)` Alias pre `otočenieVýplne`.
`static void`	`otocenieVyplne(Smer smer, Shape tvar)` Alias pre `otočenieVýplne`.
`static void`	`otocenieVyplneNaMys()` Alias pre `otočenieVýplneNaMyš`.
`static double`	`otočenieVýplne()` Vráti hodnotu pootočenia obrázkových dlaždicových výplní.
`static void`	`otočenieVýplne(double uhol)` Nastaví nový uhol pootočenia obrázkových dlaždicových výplní.
`static void`	`otočenieVýplne(double uhol, double sx, double sy)` Nastaví nový uhol pootočenia a zároveň nový relatívny stred otáčania obrázkových dlaždicových výplní.
`static void`	`otočenieVýplne(double uhol, Poloha poloha)` Táto metóda funguje podobne ako metóda `otočenieVýplne(uhol, sx, sy)`.
`static void`	`otočenieVýplne(double uhol, Shape tvar)` Táto metóda funguje podobne ako metóda `otočenieVýplne(uhol, sx, sy)`.
`static void`	`otočenieVýplne(Smer smer)` Táto metóda funguje podobne ako metóda `otočenieVýplne(uhol)`.
`static void`	`otočenieVýplne(Smer smer, double sx, double sy)` Táto metóda funguje podobne ako metóda `otočenieVýplne(uhol, sx, sy)`.
`static void`	`otočenieVýplne(Smer smer, Poloha poloha)` Táto metóda funguje podobne ako metóda `otočenieVýplne(uhol, sx, sy)`.
`static void`	`otočenieVýplne(Smer smer, Shape tvar)` Táto metóda funguje podobne ako metóda `otočenieVýplne(uhol, sx, sy)`.
`static void`	`otočenieVýplneNaMyš()` Táto metóda použije súradnice myši na vypočítanie nového pootočenia obrázkových výplní.
`static boolean`	`otvor(String súbor)` Pokúsi sa otvoriť zadaný súbor v predvolenej aplikácii podľa nastavení operačného systému.
`static boolean`	`otvor(String súbor, boolean naÚpravu)` Pokúsi sa otvoriť (spustiť) alebo otvoriť na úpravy zadaný súbor v predvolenej aplikácii podľa nastavení operačného systému.
`static boolean`	`otvorSuborNaUlozenieTonu(String názov)` Alias pre `otvorSúborNaUloženieTónu`.
`static boolean`	`otvorSuborNaUlozenieTonu(String názov, boolean prepísať)` Alias pre `otvorSúborNaUloženieTónu`.
`static boolean`	`otvorSúborNaUloženieTónu(String názov)` Umožní začať záznam všetkých generovaných tónov, ktorý sa po zavolaní párovej metódy `zavriSúborNaUloženieTónu` uloží do súboru s požadovaným názvom.
`static boolean`	`otvorSúborNaUloženieTónu(String názov, boolean prepísať)` Umožní začať záznam všetkých generovaných tónov, ktorý sa po zavolaní párovej metódy `zavriSúborNaUloženieTónu` uloží do súboru s požadovaným názvom.
`static boolean`	`otvorVPredvolenejAplikacii(String súbor)` Alias pre `otvorVPredvolenejAplikácii`.
`static boolean`	`otvorVPredvolenejAplikácii(String súbor)` Alias pre `otvorVPredvolenejAplikácii`.
`static boolean`	`otvorVPredvolenejAplikacii(String súbor, boolean naÚpravu)` Alias pre `otvorVPredvolenejAplikácii`.
`static boolean`	`otvorVPredvolenejAplikácii(String súbor, boolean naÚpravu)` Alias pre `otvorVPredvolenejAplikácii`.
`static boolean`	`otvorWebovyOdkaz(String uri)` Alias pre `otvorWebovýOdkaz`.
`static boolean`	`otvorWebovýOdkaz(String uri)` Pokúsi sa použiť zadaný textový reťazec ako webovú adresu a otvoriť ju v predvolenom prehliadači operačného systému.
`static boolean`	`overujPociatocnuPolohuOkna()` Alias pre `overujPočiatočnúPolohuOkna`.
`static void`	`overujPociatocnuPolohuOkna(boolean overuj)` Alias pre `overujPočiatočnúPolohuOkna`.
`static boolean`	`overujPočiatočnúPolohuOkna()` Zistí aktuálny stav automatického overovania počiatočnej polohy okna po jeho inicializácii.
`static void`	`overujPočiatočnúPolohuOkna(boolean overuj)` Zmení stav automatického overovania počiatočnej polohy okna po jeho inicializácii.
`static JMenuBar`	`panelVstupnehoRiadka()` Alias pre `panelVstupnéhoRiadka`.
`static JMenuBar`	`panelVstupnéhoRiadka()` Vráti komponent panela vstupného riadka, aby s ním mohlo byť manipulované na nižšej úrovni (úrovni bližšej k systému).
`static double`	`perlin(double x, double y, double z)` Vráti hodnotu 3D Perlinovho šumu z rozsahu ⟨−1; 1⟩ v bode so zadanými súradnicami.
`static double`	`perlin(double x, double y, double z, int početOktáv)` Vráti hodnotu 3D Perlinovho šumu z rozsahu ⟨−1; 1⟩ v bode so zadanými súradnicami a so zadaným počtom obsiahnutých oktáv.
`static double`	`perlin(double x, double y, double z, int početOktáv, double stabilita)` Vráti hodnotu 3D Perlinovho šumu z rozsahu ⟨−1; 1⟩ v bode so zadanými súradnicami a so zadaným počtom obsiahnutých oktáv.
`static void`	`pipni()` Alias pre `pípni`.
`static void`	`pípni()` Aplikácia vydá štandardný zvuk operačného systému.
`static void`	`pipni(String názov)` Alias pre `pípni`.
`static void`	`pípni(String názov)` Aplikácia vydá štandardný zvuk operačného systému Windows podľa vloženého pomenovania.
`static Pismo`	`pismo()` Alias pre `písmo`.
`static Písmo`	`písmo()` Čítaj aktuálny typ písma textov stropu.
`static void`	`pismo(Font novéPísmo)` Alias pre `písmo`.
`static void`	`písmo(Font novéPísmo)` Nastav nový typ písma textov stropu.
`static Pismo`	`pismo(String názov, double veľkosť)` Alias pre `písmo`.
`static Písmo`	`písmo(String názov, double veľkosť)` Nastav nový typ písma textov stropu.
`static void`	`pisNa(double x, double y, Object... argumenty)` Alias pre `píšNa`.
`static void`	`pisRiadokNa(double x, double y, Object... argumenty)` Alias pre `píšRiadokNa`.
`static void`	`píšNa(double x, double y, Object... argumenty)` Vypíše sériu argumentov na zadaných súradniciach v tvare textu na strope.
`static void`	`píšRiadokNa(double x, double y, Object... argumenty)` Vypíše sériu argumentov na zadaných súradniciach v tvare textu na strope a posunie sa na ďalší riadok.
`static int`	`pocetObrazoviek()` Alias pre `početZariadení`.
`static int`	`pocetZariadení()` Alias pre `početZariadení`.
`static int`	`početObrazoviek()` Alias pre `početZariadení`.
`static int`	`početZariadení()` Zistí počet obrazovkových zariadení, ktoré sú dostupné na tomto počítači.
`static PoložkaPonuky`	`polozkaPonukyKoniec()` Alias pre `položkaPonukyKoniec`.
`static PoložkaPonuky`	`polozkaPonukyPrekreslit()` Alias pre `položkaPonukyPrekresliť`.
`static PoložkaPonuky`	`polozkaPonukyVymazat()` Alias pre `položkaPonukyVymazať`.
`static PoložkaPonuky`	`položkaPonukyKoniec()` Poskytne preddefinovanú položku „Koniec“ na prípadné úpravy.
`static PoložkaPonuky`	`položkaPonukyPrekresliť()` Poskytne preddefinovanú položku „Prekresliť“ na prípadné úpravy.
`static PoložkaPonuky`	`položkaPonukyVymazať()` Poskytne preddefinovanú položku „Vymazať“ na prípadné úpravy.
`static double`	`polPerlina(double x, double y, double z)` Vráti hodnotu polovičného 3D Perlinovho šumu z rozsahu ⟨0; 1⟩ v bode so zadanými súradnicami.
`static double`	`polPerlina(double x, double y, double z, int početOktáv)` Vráti hodnotu polovičného 3D Perlinovho šumu z rozsahu ⟨0; 1⟩ v bode so zadanými súradnicami a so zadaným počtom obsiahnutých oktáv.
`static double`	`polPerlina(double x, double y, double z, int početOktáv, double stabilita)` Vráti hodnotu polovičného 3D Perlinovho šumu z rozsahu ⟨0; 1⟩ v bode so zadanými súradnicami a so zadaným počtom obsiahnutých oktáv.
`static double`	`pomerHviezdy(int p)` Vypočíta pomer polomerov kružníc, ktoré prechádzajú vnútornými a vonkajšími bodmi pravidelnej polygónovej hviezdy.
`static double`	`pomerHviezdy(int p, int q)` Vypočíta pomer polomerov kružníc, ktoré prechádzajú vnútornými a vonkajšími bodmi pravidelnej polygónovej hviezdy.
`static double`	`pootocenieVyplne()` Alias pre `pootočenieVýplne`.
`static void`	`pootocenieVyplne(double uhol)` Alias pre `pootočenieVýplne`.
`static void`	`pootocenieVyplne(double uhol, double sx, double sy)` Alias pre `pootočenieVýplne`.
`static void`	`pootocenieVyplne(double uhol, Poloha poloha)` Alias pre `pootočenieVýplne`.
`static void`	`pootocenieVyplne(double uhol, Shape tvar)` Alias pre `pootočenieVýplne`.
`static void`	`pootocenieVyplne(Smer smer)` Alias pre `pootočenieVýplne`.
`static void`	`pootocenieVyplne(Smer smer, double sx, double sy)` Alias pre `pootočenieVýplne`.
`static void`	`pootocenieVyplne(Smer smer, Poloha poloha)` Alias pre `pootočenieVýplne`.
`static void`	`pootocenieVyplne(Smer smer, Shape tvar)` Alias pre `pootočenieVýplne`.
`static void`	`pootocenieVyplneNaMys()` Alias pre `pootočenieVýplneNaMyš`.
`static double`	`pootočenieVýplne()` Vráti hodnotu pootočenia obrázkových dlaždicových výplní.
`static void`	`pootočenieVýplne(double uhol)` Nastaví nový uhol pootočenia obrázkových dlaždicových výplní.
`static void`	`pootočenieVýplne(double uhol, double sx, double sy)` Nastaví nový uhol pootočenia a zároveň nový relatívny stred otáčania obrázkových dlaždicových výplní.
`static void`	`pootočenieVýplne(double uhol, Poloha poloha)` Táto metóda funguje podobne ako metóda `pootočenieVýplne(uhol, sx, sy)`.
`static void`	`pootočenieVýplne(double uhol, Shape tvar)` Táto metóda funguje podobne ako metóda `pootočenieVýplne(uhol, sx, sy)`.
`static void`	`pootočenieVýplne(Smer smer)` Táto metóda funguje podobne ako metóda `pootočenieVýplne(uhol)`.
`static void`	`pootočenieVýplne(Smer smer, double sx, double sy)` Táto metóda funguje podobne ako metóda `pootočenieVýplne(uhol, sx, sy)`.
`static void`	`pootočenieVýplne(Smer smer, Poloha poloha)` Táto metóda funguje podobne ako metóda `pootočenieVýplne(uhol, sx, sy)`.
`static void`	`pootočenieVýplne(Smer smer, Shape tvar)` Táto metóda funguje podobne ako metóda `pootočenieVýplne(uhol, sx, sy)`.
`static void`	`pootočenieVýplneNaMyš()` Táto metóda použije súradnice myši na vypočítanie nového pootočenia obrázkových výplní.
`static String`	`popisVstupnehoRiadka()` Alias pre `popisVstupnéhoRiadka`.
`static String`	`popisVstupnéhoRiadka()` Získa text popisu vstupného riadka.
`static void`	`popisVstupnehoRiadka(String výzva)` Alias pre `popisVstupnéhoRiadka`.
`static void`	`popisVstupnéhoRiadka(String výzva)` Nastaví text popisu vstupného riadka.
`static Object`	`poslednaNavratovaHodnota()` Alias pre `poslednáNávratováHodnota`.
`static Object`	`poslednáNávratováHodnota()` Získa návratovú hodnotu naposledy vykonaného príkazu interaktívneho režimu alebo skriptu.
`static boolean`	`posliEmail(String... údajeSprávy)` Alias pre `pošliEmail`.
`static Bod`	`posunutieVyplne()` Alias pre `posunutieVýplne`.
`static Bod`	`posunutieVýplne()` Vráti bod so súradnicami relatívneho posunutia obrázkových dlaždicových výplní.
`static void`	`posunutieVyplne(double x, double y)` Alias pre `posunutieVýplne`.
`static void`	`posunutieVýplne(double x, double y)` Nastaví relatívne posunutie obrázkových dlaždicových výplní.
`static void`	`posunutieVyplne(Poloha poloha)` Alias pre `posunutieVýplne`.
`static void`	`posunutieVýplne(Poloha poloha)` Táto metóda funguje podobne ako metóda `posunutieVýplne(x, y)`.
`static void`	`posunutieVyplne(Shape tvar)` Alias pre `posunutieVýplne`.
`static void`	`posunutieVýplne(Shape tvar)` Táto metóda funguje podobne ako metóda `posunutieVýplne(x, y)`.
`static void`	`posunutieVyplneNaMys()` Alias pre `posunutieVýplneNaMyš`.
`static void`	`posunutieVýplneNaMyš()` Táto metóda číta súradnice myši, ktoré použije na posunutie počiatku obrázkových výplní.
`static boolean`	`pošliEmail(String... údajeSprávy)` Otvorí okno na napísanie novej správy elektronickej pošty predvoleného e-mailového klienta OS.
`static void`	`potvrdVstup()` Alias pre `potvrďVstup`.
`static void`	`potvrďVstup()` Vykoná pre vstupný riadok rovnakú akciu ako pri stlačení klávesu `Enter`.
`static void`	`pouziInteraktivnyRezim(String... nastavenia)` Alias pre `použiInteraktívnyRežim`.
`static void`	`pouziKonfiguraciu()` Alias pre `použiKonfiguráciu`.
`static void`	`pouziKonfiguraciu(int x, int y, int šírka, int výška)` Alias pre `použiKonfiguráciu`.
`static void`	`pouziKonfiguraciu(String názovSúboru)` Alias pre `použiKonfiguráciu`.
`static void`	`pouziKonfiguraciu(String názovSúboru, int x, int y, int šírka, int výška)` Alias pre `použiKonfiguráciu`.
`static void`	`použiInteraktívnyRežim(String... nastavenia)` Komplexný konfiguračný príkaz umožňujúci vykonanie mnohých nastavení sveta naraz.
`static void`	`použiKonfiguráciu()` Zapne automatické spracovanie konfiguračného súboru sveta.
`static void`	`použiKonfiguráciu(int x, int y, int šírka, int výška)` Zapne automatickú konfiguráciu, pričom umožní zadať počiatočnú polohu a rozmery okna.
`static void`	`použiKonfiguráciu(String názovSúboru)` Zapne automatické spracovanie konfiguračného súboru sveta.
`static void`	`použiKonfiguráciu(String názovSúboru, int x, int y, int šírka, int výška)` Zapne automatickú konfiguráciu, pričom umožní zadať počiatočnú polohu a rozmery okna.
`static void`	`povolViacnasobnuObsluhuUdalosti()` Alias pre `povoľViacnásobnúObsluhuUdalostí`.
`static void`	`povoľViacnásobnúObsluhuUdalostí()` Po spustení tejto metódy bude možné vytváranie viacerých verzií obsluhy udalostí, ktoré môžu byť neskôr podľa potreby uvedené do činnosti metódou `presmerujObsluhuUdalostí`.
`static double`	`pravyOkraj()` Alias pre `pravýOkraj`.
`static double`	`pravýOkraj()` Zistí najväčšiu aktuálne viditeľnú x-ovú súradnicu plátien (podlahy alebo stropu).
`static void`	`prebudCasovac()` Alias pre `prebuďČasovač`.
`static void`	`prebuďČasovač()` Prebudí časovač z „režimu spánku.“ Podrobnosti o užitočnosti spánku časovača nájdete v opise metódy uspiČasovač.
`static void`	`precitajKonfiguraciuSveta()` Alias pre `čítajKonfiguráciuSveta`.
`static void`	`precitajObrazky(Object... súbory)` Alias pre `čítajObrázky`.
`static void`	`precitajObrazky(String[] súbory)` Alias pre `čítajObrázky`.
`static Image`	`precitajObrazok(String súbor)` Alias pre `čítajObrázok`.
`static Zvuk`	`precitajZvuk(String súbor)` Alias pre `čítajZvuk`.
`static Zvuk`	`precitajZvuk(String súbor, boolean unikátny)` Alias pre `čítajZvuk`.
`static void`	`precitajZvuky(Object... súbory)` Alias pre `čítajZvuky`.
`static void`	`precitajZvuky(String[] súbory)` Alias pre `čítajZvuky`.
`static void`	`prečítajKonfiguráciuSveta()` Alias pre `čítajKonfiguráciuSveta`.
`static void`	`prečítajObrázky(Object... súbory)` Alias pre `čítajObrázky`.
`static void`	`prečítajObrázky(String[] súbory)` Alias pre `čítajObrázky`.
`static Image`	`prečítajObrázok(String súbor)` Alias pre `čítajObrázok`.
`static Zvuk`	`prečítajZvuk(String súbor)` Alias pre `čítajZvuk`.
`static Zvuk`	`prečítajZvuk(String súbor, boolean unikátny)` Alias pre `čítajZvuk`.
`static void`	`prečítajZvuky(Object... súbory)` Alias pre `čítajZvuky`.
`static void`	`prečítajZvuky(String[] súbory)` Alias pre `čítajZvuky`.
`static void`	`predvolenaFarbaPlochy()` Alias pre `predvolenáFarbaPlochy`.
`static void`	`predvolenáFarbaPlochy()` Nastaví predvolenú farbu plochy.
`static void`	`predvolenaFarbaPozadia()` Alias pre `predvolenáFarbaPozadia`.
`static void`	`predvolenáFarbaPozadia()` Nastav predvolenú farbu pozadia.
`static void`	`predvolenaFarbaPozadiaTextu()` Alias pre `predvolenáFarbaPozadiaTextu`.
`static void`	`predvolenáFarbaPozadiaTextu()` Zmení farbu pozadia textov stropu na predvolenú.
`static void`	`predvolenaFarbaTextu()` Alias pre `predvolenáFarbaTextu`.
`static void`	`predvolenáFarbaTextu()` Zmení farbu textov stropu na predvolenú.
`static String`	`predvolenaSekciaKonfiguracie()` Alias pre `predvolenáSekciaKonfigurácie`.
`static String`	`predvolenáSekciaKonfigurácie()` Vráti názov predvolenej sekcie.
`static void`	`predvolenaSekciaKonfiguracie(String názov)` Alias pre `predvolenáSekciaKonfigurácie`.
`static void`	`predvolenáSekciaKonfigurácie(String názov)` Zmení názov predvolenej sekcie, ktorú používajú metódy automatickej konfigurácie.
`static void`	`predvolenePismo()` Alias pre `predvolenéPísmo`.
`static void`	`predvolenéPísmo()` Nastav predvolený typ písma textov stropu.
`static void`	`prekresli()` Jednorazovo prekreslí obsah sveta (bez ohľadu na použitie metódy `nekresli`).
`static boolean`	`premennaExistuje(String názov, Class<?> typ)` Alias pre `premennáJestvuje`.
`static boolean`	`premennáExistuje(String názov, Class<?> typ)` Alias pre `premennáJestvuje`.
`static boolean`	`premennaJestvuje(String názov, Class<?> typ)` Alias pre `premennáJestvuje`.
`static boolean`	`premennáJestvuje(String názov, Class<?> typ)` Zistí, či premenná interaktívneho režimu so zadaným názvom a typom jestvuje (je definovaná).
`static boolean`	`premenujPolozkuHlavnejPonuky(int ktorá, String text)` Alias pre `premenujPoložkuHlavnejPonuky`.
`static boolean`	`premenujPolozkuHlavnejPonuky(int ktorá, String text, int mnemonickáSkratka)` Alias pre `premenujPoložkuHlavnejPonuky`.
`static boolean`	`premenujPoložkuHlavnejPonuky(int ktorá, String text)` Premenuje zadanú položku hlavnej ponuky.
`static boolean`	`premenujPoložkuHlavnejPonuky(int ktorá, String text, int mnemonickáSkratka)` Premenuje zadanú položku hlavnej ponuky.
`static void`	`premiestniNaObrazovku()` Alias pre `premiestniNaZariadenie`.
`static void`	`premiestniNaObrazovku(int zariadenie)` Alias pre `premiestniNaZariadenie`.
`static void`	`premiestniNaZariadenie()` Umiestni okno sveta na predvolené zobrazovacie zariadenie.
`static void`	`premiestniNaZariadenie(int zariadenie)` Umiestni okno sveta na určené zobrazovacie zariadenie.
`static void`	`prenes(JFrame inéOkno)` Prenesie grafiku sveta do iného okna.
`static void`	`prenes(JFrame inéOkno, boolean tam)` Prenesie grafiku sveta do iného okna alebo späť.
`static double`	`prepocitajSpatX(double x)` Alias pre `prepočítajSpäťX`.
`static double`	`prepocitajSpatY(double y)` Alias pre `prepočítajSpäťY`.
`static double`	`prepocitajX(double x)` Alias pre `prepočítajX`.
`static double`	`prepocitajY(double y)` Alias pre `prepočítajY`.
`static double`	`prepočítajSpäťX(double x)` Prepočíta zadanú x-ovú (horizontálnu) súradnicu zo súradnicového priestoru používaného v oblasti 2D počítačovej grafiky do súradnicového priestoru programovacieho rámca GRobot.
`static double`	`prepočítajSpäťY(double y)` Prepočíta zadanú y-ovú (vertikálnu) súradnicu zo súradnicového priestoru používaného v oblasti 2D počítačovej grafiky do súradnicového priestoru programovacieho rámca GRobot.
`static double`	`prepočítajX(double x)` Prepočíta zadanú x-ovú (horizontálnu) súradnicu zo súradnicového priestoru programovacieho rámca GRobot do súradnicového priestoru používaného v oblasti 2D počítačovej grafiky.
`static double`	`prepočítajY(double y)` Prepočíta zadanú y-ovú (vertikálnu) súradnicu zo súradnicového priestoru programovacieho rámca GRobot do súradnicového priestoru používaného v oblasti 2D počítačovej grafiky.
`static void`	`presmerujObsluhuUdalosti(ObsluhaUdalostí obsluha)` Alias pre `presmerujObsluhuUdalostí`.
`static void`	`presmerujObsluhuUdalostí(ObsluhaUdalostí obsluha)` Presmeruje spracovanie udalostí do inej inštancie triedy `ObsluhaUdalostí`.
`static void`	`presunNaObrazovku()` Alias pre `premiestniNaZariadenie`.
`static void`	`presuňNaObrazovku()` Alias pre `premiestniNaZariadenie`.
`static void`	`presunNaObrazovku(int zariadenie)` Alias pre `premiestniNaZariadenie`.
`static void`	`presuňNaObrazovku(int zariadenie)` Alias pre `premiestniNaZariadenie`.
`static void`	`presunNaZariadenie()` Alias pre `premiestniNaZariadenie`.
`static void`	`presuňNaZariadenie()` Alias pre `premiestniNaZariadenie`.
`static void`	`presunNaZariadenie(int zariadenie)` Alias pre `premiestniNaZariadenie`.
`static void`	`presuňNaZariadenie(int zariadenie)` Alias pre `premiestniNaZariadenie`.
`static Long`	`prevezmiCeleCislo()` Alias pre `prevezmiCeléČíslo`.
`static Long`	`prevezmiCeléČíslo()` Vráti celé číslo zadané do vstupného riadka po potvrdení klávesom `Enter`.
`static Double`	`prevezmiRealneCislo()` Alias pre `prevezmiReálneČíslo`.
`static Double`	`prevezmiReálneČíslo()` Vráti reálne číslo zadané do vstupného riadka po potvrdení klávesom `Enter`.
`static String`	`prevezmiRetazec()` Alias pre `prevezmiReťazec`.
`static String`	`prevezmiReťazec()` Vráti reťazec zadaný do vstupného riadka po potvrdení klávesom `Enter`.
`static String`	`prevezmiZruseneUdaje()` Alias pre `prevezmiZrušenéÚdaje`.
`static String`	`prevezmiZrušenéÚdaje()` Vráti reťazec, ktorý obsahoval vstupný riadok tesne pred zrušením klávesom `Escape`.
`static void`	`pridajKlavesovuSkratku(String príkaz, int kódKlávesu)` Alias pre `pridajKlávesovúSkratku`.
`static void`	`pridajKlávesovúSkratku(String príkaz, int kódKlávesu)` Definuje novú klávesovú skratku s modifikátorom pre ponuky, ktorá bude previazaná so zadaným príkazom.
`static void`	`pridajKlavesovuSkratku(String príkaz, int kódKlávesu, int modifikátor)` Alias pre `pridajKlávesovúSkratku`.
`static void`	`pridajKlávesovúSkratku(String príkaz, int kódKlávesu, int modifikátor)` Definuje novú klávesovú skratku, ktorá bude previazaná so zadaným príkazom.
`static void`	`pridajKlavesovuSkratku(String príkaz, int kódKlávesu, int modifikátor, boolean ajVstupnýRiadok)` Alias pre `pridajKlávesovúSkratku`.
`static void`	`pridajKlávesovúSkratku(String príkaz, int kódKlávesu, int modifikátor, boolean ajVstupnýRiadok)` Definuje novú klávesovú skratku, ktorá bude previazaná so zadaným príkazom.
`static void`	`pridajKlavesovuSkratkuVstupnehoRiadka(String príkaz, int kódKlávesu, int modifikátor)` Alias pre `pridajKlávesovúSkratkuVstupnéhoRiadka`.
`static void`	`pridajKlávesovúSkratkuVstupnéhoRiadka(String príkaz, int kódKlávesu, int modifikátor)` Definuje novú klávesovú skratku pre vstupný riadok, ktorá bude previazaná so zadaným príkazom.
`static void`	`pridajOddelovacPonuky()` Alias pre `pridajOddeľovačPonuky`.
`static void`	`pridajOddeľovačPonuky()` Pridá do hlavnej ponuky oddeľovač.
`static void`	`pridajPolozkuHlavnejPonuky(String text)` Alias pre `pridajPoložkuHlavnejPonuky`.
`static void`	`pridajPolozkuHlavnejPonuky(String text, int mnemonickáSkratka)` Alias pre `pridajPoložkuHlavnejPonuky`.
`static PolozkaPonuky`	`pridajPolozkuPonuky(String text)` Alias pre `pridajPoložkuPonuky`.
`static PolozkaPonuky`	`pridajPolozkuPonuky(String text, int mnemonickáSkratka)` Alias pre `pridajPoložkuPonuky`.
`static PolozkaPonuky`	`pridajPolozkuPonuky(String text, int mnemonickáSkratka, int klávesováSkratka)` Alias pre `pridajPoložkuPonuky`.
`static void`	`pridajPolozkuPonukyKoniec()` Alias pre `pridajPoložkuPonukyKoniec`.
`static void`	`pridajPolozkuPonukyPrekreslit()` Alias pre `pridajPoložkuPonukyPrekresliť`.
`static void`	`pridajPolozkuPonukyVymazat()` Alias pre `pridajPoložkuPonukyVymazať`.
`static void`	`pridajPoložkuHlavnejPonuky(String text)` Rozšíri hlavnú ponuku o ďalšiu položku alebo prepíše aktuálnu položku hlavnej ponuky.
`static void`	`pridajPoložkuHlavnejPonuky(String text, int mnemonickáSkratka)` Rozšíri hlavnú ponuku o ďalšiu položku alebo prepíše aktuálnu položku hlavnej ponuky.
`static PoložkaPonuky`	`pridajPoložkuPonuky(String text)` Pridá do hlavnej ponuky položku so zadaným textom.
`static PoložkaPonuky`	`pridajPoložkuPonuky(String text, int mnemonickáSkratka)` Funguje rovnako ako `pridajPoložkuPonuky(String text)` s tým, že definuje novej položke mnemonickú skratku (skratky, ktoré sú v položkách ponuky znázorňované podčiarknutým písmenom).
`static PoložkaPonuky`	`pridajPoložkuPonuky(String text, int mnemonickáSkratka, int klávesováSkratka)` Funguje rovnako ako `pridajPoložkuPonuky(String text, int mnemonickáSkratka)` s tým, že definuje novej položke okrem mnemonickej aj klávesovú skratku (skratky, ktoré pri v položkách ponuky znázorňované v pravej časti textom Ctrl + písmeno).
`static void`	`pridajPoložkuPonukyKoniec()` Pridá do ponuky preddefinovanú položku „Koniec.“ Toto je využiteľné keď sme ponuku vymazali a chceme do nej pridať túto položku, ktorej funkcionalita je vopred naprogramovaná.
`static void`	`pridajPoložkuPonukyPrekresliť()` Pridá do ponuky položku „Prekresliť.“ Položka je jednou z preddefinovaných položiek, ktoré majú vopred definovanú funkcionalitu.
`static void`	`pridajPoložkuPonukyVymazať()` Pridá do ponuky položku „Vymazať.“ Položka je jednou z preddefinovaných položiek, ktoré majú vopred definovanú funkcionalitu.
`static void`	`pridajVlnenie()` Pridá alebo zresetuje vlnenie sveta.
`static void`	`pridajVlnenie(boolean ajČasovač)` Pridá alebo zresetuje vlnenie sveta.
`static void`	`pridajVlnenie(int útlm)` Pridá alebo zresetuje vlnenie sveta.
`static void`	`pridajVlnenie(int útlm, boolean ajČasovač)` Pridá alebo zresetuje vlnenie sveta.
`static JMenu`	`pridajVnorenuPonuku(String text, JMenuItem... položky)` Alias pre `pridajVnorenúPonuku`.
`static JMenu`	`pridajVnorenúPonuku(String text, JMenuItem... položky)` Vytvorí a pridá do hlavnej ponuky vnorenú ponuku zo zadaných položiek.
`static String`	`priecinokObrazkov()` Alias pre `priečinokObrázkov`.
`static void`	`priecinokObrazkov(String priečinok)` Alias pre `priečinokObrázkov`.
`static String`	`priecinokZvukov()` Alias pre `priečinokZvukov`.
`static void`	`priecinokZvukov(String priečinok)` Alias pre `priečinokZvukov`.
`static String`	`priečinokObrázkov()` Vráti reťazec s aktuálnym priečinkom, z ktorého sú obrázky prečítané.
`static void`	`priečinokObrázkov(String priečinok)` Ak sú všetky obrázky uložené v spoločnom priečinku, môžeme pre nich touto metódou nastaviť zdrojový priečinok čítania.
`static String`	`priečinokZvukov()` Vráti reťazec s aktuálnym priečinkom, z ktorého sú zvuky čítané.
`static void`	`priečinokZvukov(String priečinok)` Ak sú všetky zvuky uložené v spoločnom priečinku, môžeme pre nich touto metódou nastaviť zdrojový priečinok čítania.
`static void`	`priehladnost(double prePodlahu, double preStrop)` Alias pre `priehľadnosť`.
`static void`	`priehľadnosť(double prePodlahu, double preStrop)` Naraz nastaví priehľadnosť pre podlahu aj strop.
`static Bod`	`priesecnikPriamkyAUsecky(double x0, double y0, double x1, double y1, double x2, double y2, double x3, double y3)` Alias pre `priesečníkPriamkyAÚsečky`.
`static Bod`	`priesecnikPriamkyAUsecky(Poloha[] poleBodov)` Alias pre `priesečníkPriamkyAÚsečky`.
`static Bod`	`priesecnikPriamkyAUsecky(Poloha A, Poloha B, Poloha C, Poloha D)` Alias pre `priesečníkPriamkyAÚsečky`.
`static Bod`	`priesecnikPriamok(double x0, double y0, double x1, double y1, double x2, double y2, double x3, double y3)` Alias pre `priesečníkPriamok`.
`static Bod`	`priesecnikPriamok(Poloha[] poleBodov)` Alias pre `priesečníkPriamok`.
`static Bod`	`priesecnikPriamok(Poloha A, Poloha B, Poloha C, Poloha D)` Alias pre `priesečníkPriamok`.
`static Bod`	`priesecnikUseciek(double x0, double y0, double x1, double y1, double x2, double y2, double x3, double y3)` Alias pre `priesečníkÚsečiek`.
`static Bod`	`priesecnikUseciek(Poloha[] poleBodov)` Alias pre `priesečníkÚsečiek`.
`static Bod`	`priesecnikUseciek(Poloha A, Poloha B, Poloha C, Poloha D)` Alias pre `priesečníkÚsečiek`.
`static Bod[]`	`priesecnikyKruznic(double x1, double y1, double r1, double x2, double y2, double r2)` Alias pre `priesečníkyKružníc`.
`static Bod[]`	`priesecnikyKruznic(Poloha S1, double r1, Poloha S2, double r2)` Alias pre `priesečníkyKružníc`.
`static Bod[]`	`priesecnikyPriamkyAKruznice(double x1, double y1, double x2, double y2, double x3, double y3, double r)` Alias pre `priesečníkyPriamkyAKružnice`.
`static Bod[]`	`priesecnikyPriamkyAKruznice(Poloha A, Poloha B, Poloha S, double r)` Alias pre `priesečníkyPriamkyAKružnice`.
`static Bod[]`	`priesecnikyUseckyAKruznice(double x1, double y1, double x2, double y2, double x3, double y3, double r)` Alias pre `priesečníkyÚsečkyAKružnice`.
`static Bod[]`	`priesecnikyUseckyAKruznice(Poloha A, Poloha B, Poloha S, double r)` Alias pre `priesečníkyÚsečkyAKružnice`.
`static Bod`	`priesečníkPriamkyAÚsečky(double x0, double y0, double x1, double y1, double x2, double y2, double x3, double y3)` Hľadá priesečník priamky AB a úsečky CD.
`static Bod`	`priesečníkPriamkyAÚsečky(Poloha[] poleBodov)` Hľadá priesečník priamky AB a úsečky CD.
`static Bod`	`priesečníkPriamkyAÚsečky(Poloha A, Poloha B, Poloha C, Poloha D)` Hľadá priesečník priamky AB a úsečky CD.
`static Bod`	`priesečníkPriamok(double x0, double y0, double x1, double y1, double x2, double y2, double x3, double y3)` Hľadá priesečník dvoch priamok určených bodmi A, B a C, D.
`static Bod`	`priesečníkPriamok(Poloha[] poleBodov)` Hľadá priesečník dvoch priamok určených polohami bodov v poli parametra.
`static Bod`	`priesečníkPriamok(Poloha A, Poloha B, Poloha C, Poloha D)` Hľadá priesečník dvoch priamok určených bodmi A, B a C, D.
`static Bod`	`priesečníkÚsečiek(double x0, double y0, double x1, double y1, double x2, double y2, double x3, double y3)` Hľadá priesečník dvoch úsečiek AB a CD.
`static Bod`	`priesečníkÚsečiek(Poloha[] poleBodov)` Hľadá priesečník dvoch úsečiek AB a CD.
`static Bod`	`priesečníkÚsečiek(Poloha A, Poloha B, Poloha C, Poloha D)` Hľadá priesečník dvoch úsečiek AB a CD.
`static Bod[]`	`priesečníkyKružníc(double x1, double y1, double r1, double x2, double y2, double r2)` Hľadá priesečníky dvoch kružníc určených súradnicami ich stredov S1[x1, y1] a S2[x2, y2] a polomermi r1 a r2.
`static Bod[]`	`priesečníkyKružníc(Poloha S1, double r1, Poloha S2, double r2)` Hľadá priesečníky dvoch kružníc určených polohami ich stredov S1 a S2 a polomermi r1 a r2.
`static Bod[]`	`priesečníkyPriamkyAKružnice(double x1, double y1, double x2, double y2, double x3, double y3, double r)` Hľadá priesečníky priamky AB a kružnice určenej súradnicami stredu S a polomeru r.
`static Bod[]`	`priesečníkyPriamkyAKružnice(Poloha A, Poloha B, Poloha S, double r)` Hľadá priesečníky priamky AB a kružnice určenej polohou stredu S a polomeru r.
`static Bod[]`	`priesečníkyÚsečkyAKružnice(double x1, double y1, double x2, double y2, double x3, double y3, double r)` Hľadá priesečníky úsečky AB a kružnice so stredom S a polomerom r.
`static Bod[]`	`priesečníkyÚsečkyAKružnice(Poloha A, Poloha B, Poloha S, double r)` Hľadá priesečníky úsečky AB a kružnice so stredom S a polomerom r.
`static void`	`pripojTextVstupnehoRiadka(String naPripojenie)` Alias pre `pripojTextVstupnéhoRiadka`.
`static void`	`pripojTextVstupnéhoRiadka(String naPripojenie)` Pripojí zadaný text na koniec vstupného riadka.
`static boolean`	`prveSpustenie()` Alias pre `prvéSpustenie`.
`static boolean`	`prvéSpustenie()` Účelom tejto metódy je overiť, či pred spustením aplikácie jestvoval konfiguračný súbor.
`static void`	`registrujRobot()` Registruje hlavný robot v konfigurácii sveta.
`static void`	`registrujRobot(GRobot robot)` Registruje robot v konfigurácii.
`static void`	`registrujRobot(GRobot robot, String meno)` Registruje robot v konfigurácii podľa zadaného mena.
`static void`	`registrujRobot(String meno)` Registruje robot v konfigurácii podľa jeho (vopred priradeného) mena.
`static void`	`registrujRobota()` Alias pre `registrujRobot`.
`static void`	`registrujRobota(GRobot robot)` Alias pre `registrujRobot`.
`static void`	`registrujRobota(GRobot robot, String meno)` Alias pre `registrujRobot`.
`static void`	`registrujRobota(String meno)` Alias pre `registrujRobot`.
`static Skript`	`registrujSkript(String názov, List<String> skript)` Vyrobí zo zadaného zoznamu reťazcov nový skript, registruje ho pod zadaným názvom a vráti ho na prípadné ďalšie spracovanie.
`static Skript`	`registrujSkript(String názov, String skript)` Vyrobí zo zadaného reťazca nový skript, registruje ho pod zadaným názvom a vráti ho na prípadné ďalšie spracovanie.
`static Skript`	`registrujSkript(String názov, String[] skript)` Vyrobí zo zadaného reťazcového poľa nový skript, registruje ho pod zadaným názvom a vráti ho na prípadné ďalšie spracovanie.
`static void`	`resetujRaster()` Zresetuje raster sveta – úplne vyčistí jeho obsah.
`static Long`	`retazecNaCeleCislo(String reťazec)` Alias pre `reťazecNaCeléČíslo`.
`static Long`	`reťazecNaCeléČíslo(String reťazec)` Pokúsi sa previesť zadaný reťazec na celé číslo.
`static Double`	`retazecNaRealneCislo(String reťazec)` Alias pre `reťazecNaReálneČíslo`.
`static Double`	`reťazecNaReálneČíslo(String reťazec)` Pokúsi sa previesť zadaný reťazec na reálne číslo.
`static String`	`retazecSkratkyPrikazu(String príkaz)` Alias pre `reťazecSkratkyPríkazu`.
`static String`	`reťazecSkratkyPríkazu(String príkaz)` Táto metóda prevedie definíciu klávesovej skratku, ktorá je priradená zadanému príkazu do textovej podoby.
`static boolean`	`rezimLadenia()` Alias pre `režimLadenia`.
`static void`	`rezimLadenia(boolean zapniLadenie)` Alias pre `režimLadenia`.
`static void`	`rezimLadenia(boolean zapniLadenie, boolean vypíšChybovéHlásenia)` Alias pre `režimLadenia`.
`static boolean`	`režimLadenia()` Zistí, či je zapnutý režim ladenia programovacieho rámca GRobot alebo aspoň výpis chybových hlásení programovacieho rámca.
`static void`	`režimLadenia(boolean zapniLadenie)` Zapne alebo vypne režim ladenia programovacieho rámca GRobot.
`static void`	`režimLadenia(boolean zapniLadenie, boolean vypíšChybovéHlásenia)` Zapne alebo vypne režim ladenia programovacieho rámca GRobot so spresnením zapnutia alebo vypnutia výpisu chybových hlásení programovacieho rámca.
`static int`	`riadokPoslednejChyby()` Ak posledná chyba vznikla na konkrétnom riadku skriptu, tak táto metóda vráti číslo tohto riadka.
`static String`	`rimskaNula()` Alias pre `rímskaNula`.
`static String`	`rímskaNula()` Vráti aktuálny reťazec nuly používaný pri prevode z celých čísiel na rímske.
`static void`	`rimskaNula(String rímskaNula)` Alias pre `rímskaNula`.
`static void`	`rímskaNula(String rímskaNula)` Nastaví hodnotu reťazca nuly používaného pri prevode z celých čísiel na rímske.
`static long`	`rimskeNaCele(String reťazec)` Alias pre `rímskeNaCelé`.
`static Long`	`rímskeNaCelé(String rímske)` Prevedie zadaný reťazec obsahujúci číslo reprezentované v rímskej číselnej sústave na celé číslo.
`static double`	`rotovaneX(double x, double y, double uhol)` Alias pre `rotovanéX`.
`static double`	`rotovanéX(double x, double y, double uhol)` Vráti výpočet x-ovej súradnice zadaného bodu pootočeného okolo stredu súradnicovej sústavy o zadaný uhol.
`static double`	`rotovaneY(double x, double y, double uhol)` Alias pre `rotovanéY`.
`static double`	`rotovanéY(double x, double y, double uhol)` Vráti výpočet y-ovej súradnice zadaného bodu pootočeného okolo stredu súradnicovej sústavy o zadaný uhol.
`static long[]`	`rozlozNaPrvocisla(long číslo)` Alias pre `rozložNaPrvočísla`.
`static long[]`	`rozložNaPrvočísla(long číslo)` Rozloží zadané celé číslo na prvočísla, ak je to možné.
`static String`	`S(Object... argumenty)` Táto metóda slúži na rýchly prevod rôznych objektov do textovej podoby a ich zlúčenie do jedného reťazca.
`static int`	`sirka()` Alias pre `šírka`.
`static int`	`sirkaObrazka(String súbor)` Alias pre `šírkaObrázka`.
`static int`	`sirkaObrazovky()` Alias pre `šírkaZariadenia`.
`static int`	`sirkaObrazovky(int zariadenie)` Alias pre `šírkaZariadenia`.
`static int`	`sirkaOkna()` Alias pre `šírkaOkna`.
`static int`	`sirkaZariadenia()` Alias pre `šírkaZariadenia`.
`static int`	`sirkaZariadenia(int zariadenie)` Alias pre `šírkaZariadenia`.
`static KeyStroke`	`skratkaPrikazu(String príkaz)` Alias pre `skratkaPríkazu`.
`static KeyStroke`	`skratkaPríkazu(String príkaz)` Táto metóda zistí, aká klávesová skratka je priradená zadanému príkazu.
`static boolean`	`skratkyPodlahy()` Overí, či sú zapnuté preddefinované skratky podlahy.
`static void`	`skratkyPodlahy(boolean zapnúť)` Zapne alebo vypne fungovanie niekoľkých predvolených skratiek vnútornej konzoly podlahy.
`static boolean`	`skratkyStropu()` Overí, či sú zapnuté preddefinované skratky stropu.
`static void`	`skratkyStropu(boolean zapnúť)` Zapne alebo vypne fungovanie niekoľkých predvolených skratiek vnútornej konzoly stropu.
`static boolean`	`skriptJeSpusteny()` Alias pre `skriptJeSpustený`.
`static boolean`	`skriptJeSpustený()` Zistí, či je práve vykonávaný skript, ktorý bol spustený príkazom `spustiSkript` (alebo niektorou jeho modifikáciou).
`static void`	`skry()` Skryje hlavné okno.
`static void`	`skryUvodnuObrazovku()` Alias pre `skryÚvodnúObrazovku`.
`static void`	`skryÚvodnúObrazovku()` Skryje úvodnú obrazovku a zobrazí hlavné okno aplikácie.
`static void`	`skryvajVstupnyRiadok()` Alias pre `skrývajVstupnýRiadok`.
`static void`	`skrývajVstupnýRiadok()` Umožní vstupnému riadku, aby sa skryl po potvrdení klávesom `Enter` alebo po zrušení vstupu klávesom `Escape`.
`static void`	`skryvajVstupnyRiadok(boolean zrušVstup)` Alias pre `skrývajVstupnýRiadok`.
`static void`	`skrývajVstupnýRiadok(boolean zrušVstup)` Umožní vstupnému riadku, aby sa skryl po potvrdení klávesom `Enter` alebo po zrušení vstupu klávesom `Escape`.
`static double`	`smer(double súradnicaBoduX, double súradnicaBoduY)` Zistí uhol (smer) zvieraný medzi osou x a priamkou vedúcou stredom súradnicovej sústavy a zadaným bodom.
`static double`	`smer(double súradnicaBoduX1, double súradnicaBoduY1, double súradnicaBoduX2, double súradnicaBoduY2)` Zistí uhol (smer) zvieraný medzi osou x a priamkou vedúcou zadanými bodmi.
`static double`	`smer(double súradnicaBoduX1, double súradnicaBoduY1, Poloha objekt2)` Zistí uhol (smer) zvieraný medzi osou x a priamkou vedúcou bodmi určenými zadanými súradnicami a polohou zadaného objektu.
`static double`	`smer(double súradnicaBoduX1, double súradnicaBoduY1, Shape tvar2)` Zistí uhol (smer) zvieraný medzi osou x a priamkou vedúcou bodmi určenými zadanými súradnicami a stredom hraníc^[1] zadaného tvaru Javy.
`static double`	`smer(Poloha objekt)` Zistí uhol (smer) zvieraný medzi osou x a priamkou vedúcou stredom súradnicovej sústavy a bodom určeným polohou zadaného objektu.
`static double`	`smer(Poloha objekt1, double súradnicaBoduX2, double súradnicaBoduY2)` Zistí uhol (smer) zvieraný medzi osou x a priamkou vedúcou bodmi určenými polohou zadaného objektu a zadanými súradnicami.
`static double`	`smer(Poloha objekt1, Poloha objekt2)` Zistí uhol (smer) zvieraný medzi osou x a priamkou vedúcou bodmi zadanými vo forme polôh objektov.
`static double`	`smer(Poloha objekt1, Shape tvar2)` Zistí uhol (smer) zvieraný medzi osou x a priamkou vedúcou bodmi určenými polohou zadaného objektu a stredom hraníc^[1] zadaného tvaru Javy.
`static double`	`smer(Shape tvar)` Zistí uhol (smer) zvieraný medzi osou x a priamkou vedúcou stredom súradnicovej sústavy a bodom určeným polohou stredu hraníc^[1] zadaného tvaru.
`static double`	`smer(Shape tvar1, double súradnicaBoduX2, double súradnicaBoduY2)` Zistí uhol (smer) zvieraný medzi osou x a priamkou vedúcou bodmi určenými stredom hraníc^[1] zadaného tvaru Javy a zadanými súradnicami.
`static double`	`smer(Shape tvar1, Poloha objekt2)` Zistí uhol (smer) zvieraný medzi osou x a priamkou vedúcou bodmi určenými stredom hraníc^[1] zadaného tvaru Javy a polohou zadaného objektu.
`static double`	`smer(Shape tvar1, Shape tvar2)` Zistí uhol (smer) zvieraný medzi osou x a priamkou vedúcou bodmi vypočítanými zo stredov hraníc^[1] zadaných tvarov Javy.
`static void`	`spi()` Zastaví aktivitu pravidelného generovania udalostí pohybu kurzorom myšky, ktorá slúžila na to, aby sa zabránilo prechodu počítača do režimu spánku.
`static double`	`spodnyOkraj()` Alias pre `spodnýOkraj`.
`static double`	`spodnýOkraj()` Zistí najmenšiu aktuálne viditeľnú y-ovú súradnicu plátien (podlahy alebo stropu).
`static void`	`spracujPrikaz(String príkaz)` Alias pre `spracujPríkaz`.
`static void`	`spracujPríkaz(String príkaz)` Spracuje jeden príkaz príkazového riadka.
`static void`	`sprava(String správa)` Alias pre `správa`.
`static void`	`správa(String správa)` Zobrazí štandardný dialóg so zadanou textovou správou.
`static void`	`sprava(String správa, String titulok)` Alias pre `správa`.
`static void`	`správa(String správa, String titulok)` Zobrazí štandardný dialóg so zadanou textovou správou.
`static boolean`	`spravaSystemovejIkony(String správa)` Alias pre `správaSystémovejIkony`.
`static boolean`	`správaSystémovejIkony(String správa)` Ak je definovaná systémová ikona, tak v jej kontexte zobrazí zadanú správu.
`static boolean`	`spravaSystemovejIkony(String správa, String titulok)` Alias pre `správaSystémovejIkony`.
`static boolean`	`správaSystémovejIkony(String správa, String titulok)` Ak je definovaná systémová ikona, tak v jej kontexte zobrazí zadanú správu s titulkom.
`static void`	`spustiCasomieru()` Alias pre `spustiČasomieru`.
`static void`	`spustiCasovac()` Alias pre `spustiČasovač`.
`static void`	`spustiCasovac(double čas)` Alias pre `spustiČasovač`.
`static void`	`spustiČasomieru()` Táto metóda „spustí“ časomieru.
`static void`	`spustiČasovač()` Spustí časovač s naposledy zadaným časovým intervalom (v sekundách) alebo s predvoleným intervalom 40 milisekúnd (ak nebol v činnosti).
`static void`	`spustiČasovač(double čas)` Spustí časovač so zadaným časovým intervalom v sekundách.
`static void`	`spustiSkript(List<String> skript)` Funguje podobne ako `vykonajSkript(skript)` a principiálne pre neho platia rovnaké pravidlá ako pre `spustiSkript(skript)`.
`static void`	`spustiSkript(String skript)` Funguje podobne ako `vykonajSkript(skript)`, ale spustí vykonávanie v samostatnom vlákne Javy, takže môže byť ladené.
`static void`	`spustiSkript(String[] riadky)` Funguje podobne ako `vykonajSkript(riadky)`, ale spustí vykonávanie v samostatnom vlákne Javy, takže môže byť ladené.
`static void`	`spustiSkript(String skript, boolean zoSúboru)` Funguje podobne ako `vykonajSkript(skript, zoSúboru)`, ale spustí vykonávanie v samostatnom vlákne Javy, takže môže byť ladené.
`static boolean`	`standardnyVstupAktivny()` Alias pre `štandardnýVstupAktívny`.
`static Bod`	`stredOtacaniaVyplne()` Alias pre `stredOtáčaniaVýplne`.
`static void`	`stredOtacaniaVyplne(double sx, double sy)` Alias pre `stredOtáčaniaVýplne`.
`static void`	`stredOtacaniaVyplne(Poloha poloha)` Alias pre `stredOtáčaniaVýplne`.
`static void`	`stredOtacaniaVyplne(Shape tvar)` Alias pre `stredOtáčaniaVýplne`.
`static void`	`stredOtacaniaVyplneNaMys()` Alias pre `stredOtáčaniaVýplneNaMyš`.
`static Bod`	`stredOtáčaniaVýplne()` Vráti bod so súradnicami relatívneho posunutia stredu otáčania obrázkových dlaždicových výplní vztiahnutý k súradniciam posunutia výplne.
`static void`	`stredOtáčaniaVýplne(double sx, double sy)` Nastaví nový relatívny stred otáčania obrázkových dlaždicových výplní.
`static void`	`stredOtáčaniaVýplne(Poloha poloha)` Táto metóda funguje podobne ako metóda `stredOtáčaniaVýplne(sx, sy)`.
`static void`	`stredOtáčaniaVýplne(Shape tvar)` Táto metóda funguje podobne ako metóda `stredOtáčaniaVýplne(sx, sy)`.
`static void`	`stredOtáčaniaVýplneNaMyš()` Táto metóda číta súradnice myši, ktoré použije na nastavenie nového relatívneho stredu otáčania obrázkových výplní.
`static TrayIcon`	`systemovaIkona()` Alias pre `systémováIkona`.
`static TrayIcon`	`systémováIkona()` Vráti objekt systémovej ikony sveta, ak je definovaná.
`static boolean`	`systemovaIkona(Image ikona, String... položkyPonuky)` Alias pre `systémováIkona`.
`static boolean`	`systémováIkona(Image ikona, String... položkyPonuky)` Definuje alebo aktualizuje ikonu v systémovej oblasti.
`static boolean`	`systemovaIkona(String popis, Image ikona, String... položkyPonuky)` Alias pre `systémováIkona`.
`static boolean`	`systémováIkona(String popis, Image ikona, String... položkyPonuky)` Definuje alebo aktualizuje systémovú ikonu nazývanú aj ikonou v systémovej oblasti alebo v oblasti oznámení (angl. system tray).
`static boolean`	`systemovaIkona(String popis, String... položkyPonuky)` Alias pre `systémováIkona`.
`static boolean`	`systémováIkona(String popis, String... položkyPonuky)` Aktualizuje jestvujúcu ikonu v systémovej oblasti.
`static boolean`	`systemovaIkonaZobrazena()` Alias pre `systémováIkonaZobrazená`.
`static boolean`	`systémováIkonaZobrazená()` Zistí, či je jestvujúca ikona v systémovej oblasti zobrazená.
`static int`	`šírka()` Zistí šírku plátien sveta.
`static int`	`šírkaObrázka(String súbor)` Zistí šírku zadaného obrázka.
`static int`	`šírkaObrazovky()` Alias pre `šírkaZariadenia`.
`static int`	`šírkaObrazovky(int zariadenie)` Alias pre `šírkaZariadenia`.
`static int`	`šírkaOkna()` Zistí šírku hlavného okna aplikácie.
`static int`	`šírkaZariadenia()` Zistí šírku dostupného obrazovkového zariadenia.
`static int`	`šírkaZariadenia(int zariadenie)` Zistí šírku dostupného obrazovkového zariadenia.
`static boolean`	`štandardnýVstupAktívny()` Overí, či je štandardný vstup, ktorý bol aktivovaný metódou `aktivujŠtandardnýVstup` (alebo niektorou jej verziou) stále aktívny.
`static void`	`tahajSubory(int ako, String... súbory)` Alias pre `ťahajSúbory`.
`static boolean`	`ťahajSúbory(int ako, String... súbory)` Vytvorí operáciu ťahania súborov.
`static void`	`tahajSubory(String... súbory)` Alias pre `ťahajSúbory`.
`static boolean`	`ťahajSúbory(String... súbory)` Vytvorí operáciu ťahania súborov.
`static boolean`	`textDoSchranky()` Alias pre `textyDoSchránky`.
`static boolean`	`textDoSchránky()` Alias pre `textyDoSchránky`.
`static boolean`	`textDoSchranky(boolean lenOznačené)` Alias pre `textyDoSchránky`.
`static boolean`	`textDoSchránky(boolean lenOznačené)` Alias pre `textyDoSchránky`.
`static String`	`textChyby(int kódChyby)` Vráti vysvetľujúci text ku kódu chyby určenej parametrom `kódChyby`.
`static String`	`textMenovky(String menovka)` Umožňuje overiť aktuálne definované znenie textu menovky na niektorých paneloch volieb (pozri napríklad metódu `dialóg`).
`static void`	`textMenovky(String menovka, String text)` Umožňuje upraviť text menovky na niektorých paneloch volieb (pozri napríklad metódu `dialóg`).
`static String[]`	`textNaRiadky(String text, int dĺžkaRiadka)` Rozdelí dlhý text na riadky s maximálnou zadanou dĺžkou v znakoch.
`static String[]`	`textNaRiadky(String text, int dĺžkaRiadka, boolean zachovajMedzery)` Rozdelí dlhý text na riadky s maximálnou zadanou dĺžkou v znakoch.
`static String`	`textPoslednejChyby()` Vráti vysvetľujúci text ku kódu poslednej chyby, ktorá nastala počas vykonávania príkazov interaktívneho režimu alebo skriptu.
`static String`	`textTlacidla(String tlačidlo)` Alias pre `textTlačidla`.
`static void`	`textTlacidla(String tlačidlo, String text)` Alias pre `textTlačidla`.
`static String`	`textTlačidla(String tlačidlo)` Umožňuje overiť aktuálne definované znenie textu tlačidla konkrétnej odpovede na otázku (pozri napríklad metódu `otázka`) alebo zadania/zmeny údaju (pozri napríklad metódu `zadajReťazec`).
`static void`	`textTlačidla(String tlačidlo, String text)` Umožňuje upraviť text tlačidla odpovede na otázku (pozri napríklad metódu `otázka`) alebo zadania údaju (pozri napríklad metódu `zadajReťazec`).
`static String`	`textVstupnehoRiadka()` Alias pre `textVstupnéhoRiadka`.
`static String`	`textVstupnéhoRiadka()` Získa text aktuálne zadaný do vstupného riadka.
`static void`	`textVstupnehoRiadka(String text)` Alias pre `textVstupnéhoRiadka`.
`static void`	`textVstupnéhoRiadka(String text)` Nastaví text vstupného riadka na zadanú hodnotu.
`static boolean`	`textyDoSchranky()` Alias pre `textyDoSchránky`.
`static boolean`	`textyDoSchránky()` Vloží do schránky všetky texty vypísané na vnútorných konzolách podlahy a stropu.
`static boolean`	`textyDoSchranky(boolean lenOznačené)` Alias pre `textyDoSchránky`.
`static boolean`	`textyDoSchránky(boolean lenOznačené)` Vloží do schránky buď všetky texty vypísané na vnútorných konzolách podlahy a stropu, alebo len označené časti – v závislosti od hodnoty parametra `lenOznačené`.
`static void`	`tik()` Simuluje vykonanie reakcie na tik časovača.
`static String`	`titulok()` Vráti titulok hlavného okna aplikácie.
`static void`	`titulok(String titulok)` Nastaví titulok hlavného okna aplikácie.
`static long`	`udrzba()` Alias pre `údržba`.
`static long`	`údržba()` Po pamäťovo náročných operáciách môže byť vhodné uvoľniť systémové prostriedky.
`static double`	`uhol(double súradnicaBoduX, double súradnicaBoduY)` Zistí uhol zvieraný medzi osou x a priamkou vedúcou stredom súradnicovej sústavy a zadaným bodom.
`static double`	`uhol(double súradnicaBoduX1, double súradnicaBoduY1, double súradnicaBoduX2, double súradnicaBoduY2)` Zistí uhol zvieraný medzi osou x a priamkou vedúcou zadanými bodmi.
`static double`	`uhol(double súradnicaBoduX1, double súradnicaBoduY1, Poloha objekt2)` Zistí uhol zvieraný medzi osou x a priamkou vedúcou bodmi určenými zadanými súradnicami a polohou zadaného objektu.
`static double`	`uhol(double súradnicaBoduX1, double súradnicaBoduY1, Shape tvar2)` Zistí uhol zvieraný medzi osou x a priamkou vedúcou bodmi určenými zadanými súradnicami a stredom hraníc^[1] zadaného tvaru Javy.
`static double`	`uhol(Poloha objekt)` Zistí uhol zvieraný medzi osou x a priamkou vedúcou stredom súradnicovej sústavy a bodom určeným polohou zadaného objektu.
`static double`	`uhol(Poloha objekt1, double súradnicaBoduX2, double súradnicaBoduY2)` Zistí uhol zvieraný medzi osou x a priamkou vedúcou bodmi určenými polohou zadaného objektu a zadanými súradnicami.
`static double`	`uhol(Poloha objekt1, Poloha objekt2)` Zistí uhol zvieraný medzi osou x a priamkou vedúcou bodmi zadanými vo forme polôh objektov.
`static double`	`uhol(Poloha objekt1, Shape tvar2)` Zistí uhol zvieraný medzi osou x a priamkou vedúcou bodmi určenými polohou zadaného objektu a stredom hraníc^[1] zadaného tvaru Javy.
`static double`	`uhol(Shape tvar)` Zistí uhol zvieraný medzi osou x a priamkou vedúcou stredom súradnicovej sústavy a bodom určeným polohou stredu hraníc^[1] zadaného tvaru.
`static double`	`uhol(Shape tvar1, double súradnicaBoduX2, double súradnicaBoduY2)` Zistí uhol zvieraný medzi osou x a priamkou vedúcou bodmi určenými stredom hraníc^[1] zadaného tvaru Javy a zadanými súradnicami.
`static double`	`uhol(Shape tvar1, Poloha objekt2)` Zistí uhol zvieraný medzi osou x a priamkou vedúcou bodmi určenými stredom hraníc^[1] zadaného tvaru Javy a polohou zadaného objektu.
`static double`	`uhol(Shape tvar1, Shape tvar2)` Zistí uhol zvieraný medzi osou x a priamkou vedúcou bodmi vypočítanými zo stredov hraníc^[1] zadaných tvarov Javy.
`static void`	`uchovajHistoriuVstupnehoRiadka()` Alias pre `uchovajHistóriuVstupnéhoRiadka`.
`static void`	`uchovajHistóriuVstupnéhoRiadka()` Aktivuje automatické uchovávanie potvrdených vstupných riadkov do konfiguračného súboru.
`static boolean`	`uchovavaSaHistoriaVstupnehoRiadka()` Alias pre `uchovávaSaHistóriaVstupnéhoRiadka`.
`static boolean`	`uchovávaSaHistóriaVstupnéhoRiadka()` Zistí, či je aktívne automatické uchovanie histórie potvrdených vstupných riadkov do konfiguračného súboru.
`static void`	`ulozObrazok(String súbor)` Alias pre `uložObrázok`.
`static void`	`ulozObrazok(String súbor, boolean prepísať)` Alias pre `uložObrázok`.
`static void`	`uložObrázok(String súbor)` Uloží aktuálne zobrazený obsah sveta do súboru s obrázkom.
`static void`	`uložObrázok(String súbor, boolean prepísať)` Uloží aktuálny obsah sveta do súboru s obrázkom.
`static void`	`upevni()` Upevní hlavné okno (svet) – okno bude mať pevnú veľkosť.
`static Long`	`upravCeleCislo(long celéČíslo, String výzva)` Alias pre `upravCeléČíslo`.
`static Long`	`upravCeleCislo(long celéČíslo, String výzva, String titulok)` Alias pre `upravCeléČíslo`.
`static Long`	`upravCeléČíslo(long celéČíslo, String výzva)` Otvorí štandardný dialóg so zadanou výzvou a zadávacím poľom na úpravu údajov (očakávaný je celočíselný údaj).
`static Long`	`upravCeléČíslo(long celéČíslo, String výzva, String titulok)` Otvorí štandardný dialóg so zadanou výzvou a zadávacím poľom na úpravu údajov (očakávaný je celočíselný údaj).
`static void`	`upravPriehladnost(double prePodlahu, double preStrop)` Alias pre `upravPriehľadnosť`.
`static void`	`upravPriehľadnosť(double prePodlahu, double preStrop)` Naraz upraví úroveň priehľadnosti pre podlahu aj strop.
`static Double`	`upravRealneCislo(double reálneČíslo, String výzva)` Alias pre `upravReálneČíslo`.
`static Double`	`upravRealneCislo(double reálneČíslo, String výzva, String titulok)` Alias pre `upravReálneČíslo`.
`static Double`	`upravReálneČíslo(double reálneČíslo, String výzva)` Otvorí štandardný dialóg so zadanou výzvou a zadávacím poľom na úpravu údajov (očakávaný je číselný údaj).
`static Double`	`upravReálneČíslo(double reálneČíslo, String výzva, String titulok)` Otvorí štandardný dialóg so zadanou výzvou a zadávacím poľom na úpravu údajov (očakávaný je číselný údaj).
`static String`	`upravRetazec(String reťazec, String výzva)` Alias pre `upravReťazec`.
`static String`	`upravReťazec(String reťazec, String výzva)` Otvorí štandardný dialóg so zadanou výzvou a zadávacím poľom na úpravu údajov.
`static String`	`upravRetazec(String reťazec, String výzva, String titulok)` Alias pre `upravReťazec`.
`static String`	`upravReťazec(String reťazec, String výzva, String titulok)` Otvorí štandardný dialóg so zadanou výzvou a zadávacím poľom na úpravu údajov.
`static void`	`upravRozmeryPlatien(int šírka, int výška)` Alias pre `zmeňRozmeryPlátien`.
`static void`	`upravRozmeryPlátien(int šírka, int výška)` Alias pre `zmeňRozmeryPlátien`.
`static void`	`uspiCasovac()` Alias pre `uspiČasovač`.
`static void`	`uspiČasovač()` Uvedie časovač do „režimu spánku.“ Keď časovač spí, preskakuje tiky, čiže sa zdá, ako keby nefungoval.
`static void`	`uvolni()` Alias pre `uvoľni`.
`static void`	`uvoľni()` Uvoľní hlavné okno (svet) – okno nebude mať pevnú veľkosť (predvolené správanie sveta).
`static void`	`uvolni(Class typ)` Alias pre `uvoľni`.
`static void`	`uvoľni(Class typ)` Metóda slúži na hromadné vymazanie robotov určitého typu z vnútorného zoznamu robotov.
`static void`	`uvolni(GRobot ktorý)` Alias pre `uvoľni`.
`static void`	`uvoľni(GRobot ktorý)` Metóda slúži na odstránenie konkrétneho robota (alebo inštancie odvodeného typu) z vnútorného zoznamu robotov.
`static void`	`uvolni(Obrázok ktorý)` Alias pre `uvoľni`.
`static void`	`uvoľni(Obrázok ktorý)` Táto metóda slúži na odstránenie konkrétneho obrázka z vnútorného zoznamu obrázkov.
`static void`	`uvolni(Plazma ktorá)` Alias pre `uvoľni`.
`static void`	`uvoľni(Plazma ktorá)` Táto metóda slúži na odstránenie konkrétnej inštancie pixelového generátora plazmy z vnútorného zoznamu týchto generátorov.
`static void`	`uvolni(String názovZdroja)` Alias pre `uvoľni`.
`static void`	`uvoľni(String názovZdroja)` Táto metóda slúži na odstránenie zdrojov (obrázkov a/alebo zvukov) z vnútorných zoznamov zdrojov sveta.
`static boolean`	`uvolniMys()` Alias pre `uvoľniMyš`.
`static boolean`	`uvoľniMyš()` Zruší zachytenie kurzora myš v okne sveta.
`static void`	`vahaPreZvuky(double miera, Object... súbory)` Alias pre `váhaPreZvuky`
`static void`	`váhaPreZvuky(double miera, Object... súbory)` Nastaví hromadne stereováhu pre všetky uvedené zvuky.
`static void`	`vahaPreZvuky(double miera, String[] súbory)` Alias pre `váhaPreZvuky`
`static void`	`váhaPreZvuky(double miera, String[] súbory)` Nastaví hromadne stereováhu pre všetky uvedené zvuky.
`static void`	`varovanie(String varovanie)` Zobrazí štandardný dialóg so zadanou textovou správou a ikonou varovania.
`static void`	`varovanie(String varovanie, String titulok)` Zobrazí štandardný dialóg so zadanou textovou správou a ikonou varovania.
`static boolean`	`varovanieSystemovejIkony(String varovanie)` Alias pre `varovanieSystémovejIkony`.
`static boolean`	`varovanieSystémovejIkony(String varovanie)` Ak je definovaná systémová ikona, tak v jej kontexte zobrazí zadané varovné oznámenie.
`static boolean`	`varovanieSystemovejIkony(String varovanie, String titulok)` Alias pre `varovanieSystémovejIkony`.
`static boolean`	`varovanieSystémovejIkony(String varovanie, String titulok)` Ak je definovaná systémová ikona, tak v jej kontexte zobrazí zadané varovné oznámenie s titulkom.
`static int`	`verzia(int hlavná, int vedľajšia)` Porovná aktuálnu verziu robota so zadanou.
`static int`	`viditelnaSirka()` Alias pre `viditeľnáŠírka`.
`static int`	`viditeľnáŠírka()` Zistí aktuálnu šírku tzv. klientskej oblasti okna.
`static int`	`viditelnaVyska()` Alias pre `viditeľnáVýška`.
`static int`	`viditeľnáVýška()` Zistí viditeľnú výšku tzv. klientskej oblasti okna.
`static boolean`	`viditelny()` Alias pre `viditeľný`.
`static boolean`	`viditeľný()` Zistí, či je hlavné okno (svet) viditeľné.
`static Vlnenie`	`vlnenie()` Vráti inštanciu vlnenia sveta, aby s ňou bolo možné ďalej pracovať.
`static int`	`volajSkript(String názov)` Spustí skript registrovaný vo vnútornej pamäti rámca pod zadaným menom.
`static double`	`vrchnyOkraj()` Alias pre `vrchnýOkraj`.
`static double`	`vrchnýOkraj()` Zistí najväčšiu aktuálne viditeľnú y-ovú súradnicu plátien (podlahy alebo stropu).
`static JTextField`	`vstupnyRiadok()` Alias pre `vstupnýRiadok`.
`static JTextField`	`vstupnýRiadok()` Vráti komponent vstupného riadka, aby s ním mohlo byť manipulované na nižšej úrovni (úrovni bližšej k systému).
`static boolean`	`vstupnyRiadokZobrazeny()` Alias pre `vstupnýRiadokZobrazený`.
`static boolean`	`vstupnýRiadokZobrazený()` Overí, či je zobrazený panel vstupného riadka.
`static boolean`	`vykonajPrikaz(String príkaz)` Alias pre `vykonajPríkaz`.
`static boolean`	`vykonajPríkaz(String príkaz)` Táto metóda má rovnaké jadro ako mechanizmus vykonávania príkazov v interaktívnom režime a umožňuje používať príkazy, ktoré sú dostupné v tomto režime aj za jeho hranicami (t. j. bez nevyhnutnosti jeho aktivácie).
`static int`	`vykonajSkript(List<String> skript)` Vykoná skript zadaný vo forme parametrického zoznamu.
`static int`	`vykonajSkript(String skript)` Vykoná skript zadaný vo forme reťazca.
`static int`	`vykonajSkript(String[] riadky)` Vykoná skript uložený v poli reťazcov.
`static int`	`vykonajSkript(String skript, boolean zoSúboru)` Vykoná skript zadaný vo forme reťazca alebo vo forme názvu súboru, z ktorého má byť prečítaný.
`static void`	`vykonatNeskor(Runnable vykonať)` Alias pre `vykonaťNeskôr`.
`static void`	`vykonatNeskor(Runnable vykonať, boolean samostatnéVlákno)` Alias pre `vykonaťNeskôr`.
`static void`	`vykonaťNeskôr(Runnable vykonať)` Táto metóda slúži na zadanie príkazov Javy, ktoré majú byť vykonané „neskôr“ – asynchrónne vzhľadom na reťaz čakajúcich správ (udalostí) aktívneho vlákna.
`static void`	`vykonaťNeskôr(Runnable vykonať, boolean samostatnéVlákno)` Táto metóda slúži na zadanie príkazov Javy, ktoré majú byť vykonané „neskôr“ – pozri opis metódy `vykonaťNeskôr(vykonať)`.
`static void`	`vymaz()` Alias pre `vymaž`.
`static void`	`vymazGrafiku()` Alias pre `vymažGrafiku`.
`static void`	`vymazPonuku()` Alias pre `vymažPonuku`.
`static void`	`vymazPremennu(String názov, Class<?> typ)` Alias pre `vymažPremennú`.
`static void`	`vymazTexty()` Alias pre `vymažTexty`.
`static void`	`vymaž()` Vymaže obsah sveta.
`static void`	`vymažGrafiku()` Vymaže plátno podlahy a stropu.
`static void`	`vymažPonuku()` Vymaže všetky položky hlavnej ponuky (vrátane predvolených).
`static void`	`vymažPremennú(String názov, Class<?> typ)` Vymaže definíciu premennej zadaného údajového typu interaktívneho režimu.
`static void`	`vymažTexty()` Vymaže texty podlahy a stropu.
`static void`	`vypis(Object... argumenty)` Alias pre `vypíš`.
`static void`	`vypisAktivneSlova(String identifikátor, Object... argumenty)` Alias pre `vypíšAktívneSlovo`.
`static void`	`vypisAktivneSlovo(String identifikátor, Object... argumenty)` Alias pre `vypíšAktívneSlovo`.
`static boolean`	`vypisChybovychHlaseni()` Alias pre `výpisChybovýchHlásení`.
`static boolean`	`výpisChybovýchHlásení()` Zistí, či je zapnutý výpis chybových hlásení programovacieho rámca.
`static void`	`vypisNa(double x, double y, Object... argumenty)` Alias pre `vypíšNa`.
`static void`	`vypisRiadok(Object... argumenty)` Alias pre `vypíšRiadok`.
`static void`	`vypisRiadokNa(double x, double y, Object... argumenty)` Alias pre `vypíšRiadokNa`.
`static void`	`vypíš(Object... argumenty)` Vypíše sériu argumentov v tvare textu na strope.
`static void`	`vypíšAktívneSlová(String identifikátor, Object... argumenty)` Alias pre `vypíšAktívneSlovo`.
`static void`	`vypíšAktívneSlovo(String identifikátor, Object... argumenty)` Vypíše sériu argumentov v tvare textu na strope ako aktívne slová.
`static void`	`vypíšNa(double x, double y, Object... argumenty)` Vypíše sériu argumentov na zadaných súradniciach v tvare textu na strope.
`static void`	`vypíšRiadok(Object... argumenty)` Vypíše sériu argumentov v tvare textu na strope a posunie sa na ďalší riadok.
`static void`	`vypíšRiadokNa(double x, double y, Object... argumenty)` Vypíše sériu argumentov na zadaných súradniciach v tvare textu na strope a posunie sa na ďalší riadok.
`static void`	`vypln(Color farba)` Alias pre `vyplň`.
`static void`	`vyplň(Color farba)` Vyplní podlahu zadanou farbou, ktorá prekryje aj farbu pozadia sveta.
`static void`	`vypln(Farebnosť objekt)` Alias pre `vyplň`.
`static void`	`vyplň(Farebnosť objekt)` Vyplní podlahu farbou zadaného objektu, ktorá prekryje aj farbu pozadia sveta.
`static void`	`vypln(Image výplň)` Alias pre `vyplň`.
`static void`	`vyplň(Image výplň)` Vyplní podlahu zadanou textúrou.
`static Farba`	`vypln(int r, int g, int b)` Alias pre `vyplň`.
`static Farba`	`vyplň(int r, int g, int b)` Vyplní podlahu farbou zadanou prostredníctvom farebných zložiek.
`static Farba`	`vypln(int r, int g, int b, int a)` Alias pre `vyplň`.
`static Farba`	`vyplň(int r, int g, int b, int a)` Vyplní podlahu farbou zadanou prostredníctvom farebných zložiek a úrovne priehľadnosti.
`static void`	`vypln(Shape tvar)` Alias pre `vyplň`.
`static void`	`vyplň(Shape tvar)` Táto metóda slúži na kreslenie vyplnených tvarov na podlahu.
`static void`	`vypln(Shape tvar, GRobot kreslič)` Alias pre `vyplň`.
`static void`	`vyplň(Shape tvar, GRobot kreslič)` Táto metóda slúži na kreslenie vyplnených tvarov na podlahu.
`static void`	`vypln(String súbor)` Alias pre `vyplň`.
`static void`	`vyplň(String súbor)` Vyplní podlahu zadanou textúrou.
`static Skript`	`vyrobSkript(List<String> skript)` Vyrobí zo zadaného zoznamu reťazcov reprezentujúcich riadky skriptu nový skript a vráti ho v inštancii triedy `Skript` na ďalšie spracovanie.
`static Skript`	`vyrobSkript(String skript)` Vyrobí zo zadaného textového reťazca skript a vráti ho v inštancii triedy `Skript` na ďalšie spracovanie.
`static Skript`	`vyrobSkript(String[] skript)` Vyrobí zo zadaného reťazcového poľa, ktorého prvky reprezentujú riadky skriptu, nový skript a vráti ho na ďalšie spracovanie v inštancii triedy `Skript`.
`static Skript`	`vyrobSkript(String skript, boolean zoSúboru)` Vyrobí skript (zo zadaného textového reťazca alebo zo súboru) a vráti ho v inštancii triedy `Skript` na ďalšie spracovanie.
`static int`	`vyska()` Alias pre `šírka`.
`static int`	`vyskaObrazka(String súbor)` Alias pre `výškaObrázka`.
`static int`	`vyskaObrazovky()` Alias pre `výškaZariadenia`.
`static int`	`vyskaObrazovky(int zariadenie)` Alias pre `výškaZariadenia`.
`static int`	`vyskaOkna()` Alias pre `výškaOkna`.
`static int`	`vyskaZariadenia()` Alias pre `výškaZariadenia`.
`static int`	`vyskaZariadenia(int zariadenie)` Alias pre `výškaZariadenia`.
`static void`	`vystred()` Alias pre `vystreď`.
`static void`	`vystreď()` Presunie okno tak, aby sa nachádzalo v strede obrazovky.
`static int`	`výška()` Zistí výšku plátien sveta.
`static int`	`výškaObrázka(String súbor)` Zistí výšku zadaného obrázka.
`static int`	`výškaObrazovky()` Alias pre `výškaZariadenia`.
`static int`	`výškaObrazovky(int zariadenie)` Alias pre `výškaZariadenia`.
`static int`	`výškaOkna()` Zistí výšku hlavného okna aplikácie.
`static int`	`výškaZariadenia()` Zistí výšku dostupného obrazovkového zariadenia.
`static int`	`výškaZariadenia(int zariadenie)` Zistí výšku dostupného obrazovkového zariadenia.
`static boolean`	`vytlac(String súbor)` Alias pre `vytlač`.
`static boolean`	`vytlač(String súbor)` Ak je pre zadaný súbor asociovaný príkaz na tlač dokumentu, tak otvorí prislúchajúci tlačový dialóg operačného systému, pomocou ktorého bude možné súbor (dokument) vytlačiť.
`static void`	`vyzviRobotov()` Alias pre `vyzviRoboty`.
`static void`	`vyzviRobotov(int kľúč)` Alias pre `vyzviRoboty`.
`static void`	`vyzviRobotov(int kľúč, boolean obrátene)` Alias pre `vyzviRoboty`.
`static void`	`vyzviRoboty()` Spustením tejto metódy sa pre každý robot (podľa ich aktuálneho poradia) vykoná reakcia `prijatieVýzvy` bez určenia autora výzvy (autor je rovný `null`) a s hodnotou argumentu `kľúč` rovnou `-1`.
`static void`	`vyzviRoboty(int kľúč)` Spustením tejto metódy sa pre každý robot (podľa ich aktuálneho poradia) vykoná reakcia `prijatieVýzvy` bez určenia autora výzvy (autor je rovný `null`).
`static void`	`vyzviRoboty(int kľúč, boolean obrátene)` Spustením tejto metódy sa pre každý robot (podľa ich aktuálneho poradia) vykoná reakcia `prijatieVýzvy` bez určenia autora výzvy (autor je rovný `null`).
`static double`	`vzdialenost(double súradnicaBoduX, double súradnicaBoduY)` Alias pre `vzdialenosť`.
`static double`	`vzdialenosť(double súradnicaBoduX, double súradnicaBoduY)` Zistí vzdialenosť bodu so zadanými súradnicami od stredu súradnicovej sústavy.
`static double`	`vzdialenost(double súradnicaBoduX1, double súradnicaBoduY1, double súradnicaBoduX2, double súradnicaBoduY2)` Alias pre `vzdialenosť`.
`static double`	`vzdialenosť(double súradnicaBoduX1, double súradnicaBoduY1, double súradnicaBoduX2, double súradnicaBoduY2)` Zistí vzájomnú vzdialenosť medzi bodmi so zadanými súradnicami.
`static double`	`vzdialenost(double súradnicaBoduX1, double súradnicaBoduY1, Poloha objekt2)` Alias pre `vzdialenosť`.
`static double`	`vzdialenosť(double súradnicaBoduX1, double súradnicaBoduY1, Poloha objekt2)` Zistí vzájomnú vzdialenosť medzi bodom so zadanými súradnicami a zadaným objektom.
`static double`	`vzdialenost(double súradnicaBoduX1, double súradnicaBoduY1, Shape tvar2)` Alias pre `vzdialenosť`.
`static double`	`vzdialenosť(double súradnicaBoduX1, double súradnicaBoduY1, Shape tvar2)` Zistí vzájomnú vzdialenosť medzi bodom so zadanými súradnicami a stredom hraníc^[1] zadaného tvaru.
`static double`	`vzdialenost(Poloha objekt)` Alias pre `vzdialenosť`.
`static double`	`vzdialenosť(Poloha objekt)` Zistí, aká je vzdialenosť zadaného objektu od stredu súradnicovej sústavy.
`static double`	`vzdialenost(Poloha objekt1, double súradnicaBoduX2, double súradnicaBoduY2)` Alias pre `vzdialenosť`.
`static double`	`vzdialenosť(Poloha objekt1, double súradnicaBoduX2, double súradnicaBoduY2)` Zistí vzájomnú vzdialenosť zadaného objektu a bodu so zadanými súradnicami.
`static double`	`vzdialenost(Poloha objekt1, Poloha objekt2)` Alias pre `vzdialenosť`.
`static double`	`vzdialenosť(Poloha objekt1, Poloha objekt2)` Zistí vzájomnú vzdialenosť zadaných objektov.
`static double`	`vzdialenost(Poloha objekt1, Shape tvar2)` Alias pre `vzdialenosť`.
`static double`	`vzdialenosť(Poloha objekt1, Shape tvar2)` Zistí vzájomnú vzdialenosť medzi zadaným objektom a stredom hraníc^[1] zadaného tvaru.
`static double`	`vzdialenost(Shape tvar)` Alias pre `vzdialenosť`.
`static double`	`vzdialenosť(Shape tvar)` Zistí vzdialenosť stredu hraníc^[1] zadaného tvaru od stredu súradnicovej sústavy.
`static double`	`vzdialenost(Shape tvar1, double súradnicaBoduX2, double súradnicaBoduY2)` Alias pre `vzdialenosť`.
`static double`	`vzdialenosť(Shape tvar1, double súradnicaBoduX2, double súradnicaBoduY2)` Zistí vzájomnú vzdialenosť stredu hraníc^[1] zadaného tvaru a bodu so zadanými súradnicami.
`static double`	`vzdialenost(Shape tvar1, Poloha objekt2)` Alias pre `vzdialenosť`.
`static double`	`vzdialenosť(Shape tvar1, Poloha objekt2)` Zistí vzájomnú vzdialenosť stredu hraníc^[1] zadaného tvaru a polohy zadaného objektu.
`static double`	`vzdialenost(Shape tvar1, Shape tvar2)` Alias pre `vzdialenosť`.
`static double`	`vzdialenosť(Shape tvar1, Shape tvar2)` Zistí vzájomnú vzdialenosť stredov hraníc^[1] zadaných tvarov.
`static double`	`vzdialenostBodov(double x1, double y1, double x2, double y2)` Alias pre `vzdialenosťBodov`.
`static double`	`vzdialenosťBodov(double x1, double y1, double x2, double y2)` Vypočíta vzdialenosť medzi dvomi bodmi so súradnicami [x1, y1] a [x2, y2].
`static double`	`vzdialenostBodov(Poloha[] poleBodov)` Alias pre `vzdialenosťBodov`.
`static double`	`vzdialenosťBodov(Poloha[] poleBodov)` Vypočíta vzdialenosť medzi dvomi bodmi so súradnicami určenými polohami bodov v poli parametra.
`static double`	`vzdialenostBodov(Poloha A, Poloha B)` Alias pre `vzdialenosťBodov`.
`static double`	`vzdialenosťBodov(Poloha A, Poloha B)` Vypočíta vzdialenosť medzi dvomi bodmi A a B.
`static double`	`vzdialenostBoduOdKruznice(double x0, double y0, double x1, double y1, double r)` Alias pre `vzdialenosťBoduOdKružnice`.
`static double`	`vzdialenostBoduOdKruznice(Poloha[] poleBodov, double polomer)` Alias pre `vzdialenosťBoduOdKružnice`.
`static double`	`vzdialenostBoduOdKruznice(Poloha V, Poloha S, double r)` Alias pre `vzdialenosťBoduOdKružnice`.
`static double`	`vzdialenosťBoduOdKružnice(double x0, double y0, double x1, double y1, double r)` Vypočíta vzdialenosť od zadaného voľného bodu V ku kružnici určenej stredom S a polomerom r.
`static double`	`vzdialenosťBoduOdKružnice(Poloha[] poleBodov, double polomer)` Vypočíta vzdialenosť medzi voľným bodom V a kružnicou, ktorá je určená stredom S a polomerom r, pričom body V a S sú prvkami poľa `poleBodov` a r je uložený v parametri `polomer`).
`static double`	`vzdialenosťBoduOdKružnice(Poloha V, Poloha S, double r)` Vypočíta vzdialenosť od zadaného voľného bodu V ku kružnici určenej stredom S a polomerom r.
`static double`	`vzdialenostBoduOdPriamky(double x0, double y0, double x1, double y1, double x2, double y2)` Alias pre `vzdialenosťBoduOdPriamky`.
`static double`	`vzdialenosťBoduOdPriamky(double x0, double y0, double x1, double y1, double x2, double y2)` Vypočíta vzdialenosť od zadaného voľného bodu V[x0, y0] k priamke určenej dvomi bodmi A[x1, y1] a B[x2, y2].
`static double`	`vzdialenostBoduOdPriamky(Poloha[] poleBodov)` Alias pre `vzdialenosťBoduOdPriamky`.
`static double`	`vzdialenosťBoduOdPriamky(Poloha[] poleBodov)` Vypočíta vzdialenosť medzi voľným bodom a priamkou, ktoré sú určené určenými polohami bodov v poli parametra.
`static double`	`vzdialenostBoduOdPriamky(Poloha V, Poloha A, Poloha B)` Alias pre `vzdialenosťBoduOdPriamky`.
`static double`	`vzdialenosťBoduOdPriamky(Poloha V, Poloha A, Poloha B)` Vypočíta vzdialenosť od zadaného voľného bodu V k priamke AB.
`static double`	`vzdialenostBoduOdUsecky(double x0, double y0, double x1, double y1, double x2, double y2)` Alias pre `vzdialenosťBoduOdÚsečky`.
`static double`	`vzdialenostBoduOdUsecky(Poloha[] poleBodov)` Alias pre `vzdialenosťBoduOdÚsečky`.
`static double`	`vzdialenostBoduOdUsecky(Poloha V, Poloha A, Poloha B)` Alias pre `vzdialenosťBoduOdÚsečky`.
`static double`	`vzdialenosťBoduOdÚsečky(double x0, double y0, double x1, double y1, double x2, double y2)` Vypočíta vzdialenosť od zadaného voľného bodu V[x0, y0] k úsečke určenej dvomi bodmi A[x1, y1] a B[x2, y2].
`static double`	`vzdialenosťBoduOdÚsečky(Poloha[] poleBodov)` Vypočíta vzdialenosť medzi voľným bodom V a úsečkou AB, ktoré sú určené polohami bodov v poli parametra `poleBodov`.
`static double`	`vzdialenosťBoduOdÚsečky(Poloha V, Poloha A, Poloha B)` Vypočíta vzdialenosť od zadaného voľného bodu V k úsečke AB.
`static double`	`vzdialenostKruznic(double x1, double y1, double r1, double x2, double y2, double r2)` Alias pre `vzdialenosťKružníc`.
`static double`	`vzdialenostKruznic(Poloha[] poleBodov, double polomer1, double polomer2)` Alias pre `vzdialenosťKružníc`.
`static double`	`vzdialenostKruznic(Poloha S1, double r1, Poloha S2, double r2)` Alias pre `vzdialenosťKružníc`.
`static double`	`vzdialenosťKružníc(double x1, double y1, double r1, double x2, double y2, double r2)` Vypočíta vzdialenosť medzi dvomi kružnicami, ktoré sú určené svojími stredmi (S1, S2) a polomermi (r1, r2).
`static double`	`vzdialenosťKružníc(Poloha[] poleBodov, double polomer1, double polomer2)` Vypočíta vzdialenosť medzi dvomi kružnicami určenými stredmi S1 a S2 a polomermi r1 a r2, pričom stredy S1 a S2 sú prvkami poľa `poleBodov`.
`static double`	`vzdialenosťKružníc(Poloha S1, double r1, Poloha S2, double r2)` Vypočíta vzdialenosť medzi dvomi kružnicami, ktoré sú určené svojími stredmi (S1, S2) a polomermi (r1, r2).
`static double`	`vzdialenostPriamkyOdKruznice(double x1, double y1, double x2, double y2, double x3, double y3, double r)` Alias pre `vzdialenosťPriamkyOdKružnice`.
`static double`	`vzdialenostPriamkyOdKruznice(Poloha[] poleBodov, double r)` Alias pre `vzdialenosťPriamkyOdKružnice`.
`static double`	`vzdialenostPriamkyOdKruznice(Poloha A, Poloha B, Poloha S, double r)` Alias pre `vzdialenosťPriamkyOdKružnice`.
`static double`	`vzdialenosťPriamkyOdKružnice(double x1, double y1, double x2, double y2, double x3, double y3, double r)` Vypočíta vzdialenosť medzi určenou priamkou a kružnicou.
`static double`	`vzdialenosťPriamkyOdKružnice(Poloha[] poleBodov, double r)` Vypočíta vzdialenosť medzi určenou priamkou AB a kružnicou so stredom S a polomerom r, pričom body A, B a stred S sú určené prvkami poľa `poleBodov`.
`static double`	`vzdialenosťPriamkyOdKružnice(Poloha A, Poloha B, Poloha S, double r)` Vypočíta vzdialenosť medzi určenou priamkou AB a kružnicou so stredom S a polomerom r.
`static double`	`vzdialenostUseciek(double x1, double y1, double x2, double y2, double x3, double y3, double x4, double y4)` Alias pre `vzdialenosťÚsečiek`.
`static double`	`vzdialenostUseciek(Poloha[] poleBodov)` Alias pre `vzdialenosťÚsečiek`.
`static double`	`vzdialenostUseciek(Poloha A, Poloha B, Poloha C, Poloha D)` Alias pre `vzdialenosťÚsečiek`.
`static double`	`vzdialenostUseckyOdKruznice(double x1, double y1, double x2, double y2, double x3, double y3, double r)` Alias pre `vzdialenosťÚsečkyOdKružnice`.
`static double`	`vzdialenostUseckyOdKruznice(Poloha[] poleBodov, double r)` Alias pre `vzdialenosťÚsečkyOdKružnice`.
`static double`	`vzdialenostUseckyOdKruznice(Poloha A, Poloha B, Poloha S, double r)` Alias pre `vzdialenosťÚsečkyOdKružnice`.
`static double`	`vzdialenosťÚsečiek(double x1, double y1, double x2, double y2, double x3, double y3, double x4, double y4)` Vypočíta vzdialenosť medzi dvomi úsečkami AB a CD.
`static double`	`vzdialenosťÚsečiek(Poloha[] poleBodov)` Vypočíta vzdialenosť medzi dvomi úsečkami AB a CD, pričom ich určujúce body sú prvkami poľa `poleBodov`.
`static double`	`vzdialenosťÚsečiek(Poloha A, Poloha B, Poloha C, Poloha D)` Vypočíta vzdialenosť medzi dvomi úsečkami AB a CD.
`static double`	`vzdialenosťÚsečkyOdKružnice(double x1, double y1, double x2, double y2, double x3, double y3, double r)` Vypočíta vzdialenosť medzi určenou úsečkou a kružnicou.
`static double`	`vzdialenosťÚsečkyOdKružnice(Poloha[] poleBodov, double r)` Vypočíta vzdialenosť medzi určenou úsečkou AB a kružnicou so stredom S a polomerom r, pričom body A, B a stred S sú určené prvkami poľa `poleBodov`.
`static double`	`vzdialenosťÚsečkyOdKružnice(Poloha A, Poloha B, Poloha S, double r)` Vypočíta vzdialenosť medzi určenou úsečkou AB a kružnicou so stredom S a polomerom r.
`static boolean`	`zacniVstup()` Alias pre `začniVstup`.
`static boolean`	`zacniVstup(String výzva)` Alias pre `začniVstup`.
`static boolean`	`začniVstup()` Zobrazí vstupný riadok v spodnej časti okna.
`static boolean`	`začniVstup(String výzva)` Funguje rovnako ako `začniVstup()`, s tým rozdielom, že pred vstupným riadkom je zobrazená návesť s výzvou.
`static Long`	`zadajCeleCislo(String výzva)` Alias pre `zadajCeléČíslo`.
`static Long`	`zadajCeleCislo(String výzva, String titulok)` Alias pre `zadajCeléČíslo`.
`static Long`	`zadajCeléČíslo(String výzva)` Otvorí štandardný dialóg so zadanou výzvou a zadávacím poľom na zadanie údajov (očakávaný je celočíselný údaj).
`static Long`	`zadajCeléČíslo(String výzva, String titulok)` Otvorí štandardný dialóg so zadanou výzvou a zadávacím poľom na zadanie údajov (očakávaný je celočíselný údaj).
`static String`	`zadajHeslo(String výzva)` Otvorí štandardný dialóg so zadanou výzvou a zadávacím poľom na zadanie hesla.
`static String`	`zadajHeslo(String výzva, String titulok)` Otvorí štandardný dialóg so zadanou výzvou a zadávacím poľom na zadanie hesla.
`static Double`	`zadajRealneCislo(String výzva)` Alias pre `zadajReálneČíslo`.
`static Double`	`zadajRealneCislo(String výzva, String titulok)` Alias pre `zadajReálneČíslo`.
`static Double`	`zadajReálneČíslo(String výzva)` Otvorí štandardný dialóg so zadanou výzvou a zadávacím poľom na zadanie údajov (očakávaný je číselný údaj).
`static Double`	`zadajReálneČíslo(String výzva, String titulok)` Otvorí štandardný dialóg so zadanou výzvou a zadávacím poľom na zadanie údajov (očakávaný je číselný údaj).
`static String`	`zadajRetazec(String výzva)` Alias pre `zadajReťazec`.
`static String`	`zadajReťazec(String výzva)` Otvorí štandardný dialóg so zadanou výzvou a zadávacím poľom na zadanie údajov.
`static String`	`zadajRetazec(String výzva, String titulok)` Alias pre `zadajReťazec`.
`static String`	`zadajReťazec(String výzva, String titulok)` Otvorí štandardný dialóg so zadanou výzvou a zadávacím poľom na zadanie údajov.
`static boolean`	`zachytMys()` Alias pre `zachyťMyš`.
`static boolean`	`zachyťMyš()` Zachytí kurzor myši v okne sveta.
`static boolean`	`zalamujeTexty()` Zistí stav/hodnotu vlastnosti zalamovania textov vnútornej konzoly stropu.
`static void`	`zalamujTexty()` Zapne zalamovanie textov vnútornej konzoly stropu.
`static void`	`zalamujTexty(boolean zalamuj)` Nastaví vlastnosť zalamovania textov vnútornej konzoly stropu podľa hodnoty parametra.
`static double`	`zaokruhli(double hodnota, int miest)` Alias pre `zaokrúhli`.
`static double`	`zaokrúhli(double hodnota, int miest)` Zaokrúhli zadané číslo na zadaný počet (desatinných) miest.
`static boolean`	`zapisPremennu(String názov, Object hodnota)` Alias pre `zapíšPremennú`.
`static boolean`	`zapíšPremennú(String názov, Object hodnota)` Nastaví novú hodnotu premennej interaktívneho režimu.
`static double`	`zastavCasomieru()` Alias pre `zastavČasomieru`.
`static void`	`zastavCasovac()` Alias pre `zastavČasovač`.
`static double`	`zastavČasomieru()` Táto metóda „zastaví“ časomieru a vráti výsledok merania v sekundách.
`static void`	`zastavČasovač()` Zastaví časovač, ktorý bol spustený metódou `spustiČasovač`.
`static void`	`zastavTon()` Alias pre `zastavTón`.
`static void`	`zastavTón()` Okamžite zastaví prehrávanie generovaného harmonického signálu a vyčistí vnútorný zoznam tónov naplánovaných na prehranie.
`static void`	`zastavZvuky(Object... súbory)` Zastaví všetky uvedené zvuky.
`static void`	`zastavZvuky(String[] súbory)` Zastaví všetky uvedené zvuky.
`static void`	`zavriet()` Alias pre `zavrieť`.
`static void`	`zavrieť()` Vygeneruje udalosť zavretia hlavného okna.
`static boolean`	`zavriSuborNaUlozenieTonu()` Alias pre `zavriSúborNaUloženieTónu`.
`static boolean`	`zavriSúborNaUloženieTónu()` Ukončí záznam generovaných tónov, ktorý bol začatý volaním niektorej verzie metódy `otvorSúborNaUloženieTónu`.
`static void`	`zbal()` Alias pre `zbaľ`.
`static void`	`zbaľ()` Prispôsobí veľkosť okna tak, aby sa do neho pohodlne vošli všetky viditeľné komponenty.
`static void`	`ziadajPrekreslenie()` Alias pre `žiadajPrekreslenie`.
`static int`	`zistiZariadenieOkna()` Zistí číslo zariadenia, na ktorom sa nachádza okno sveta.
`static void`	`zmenKurzorMysi(String meno)` Alias pre `zmeňKurzorMyši`.
`static void`	`zmeňKurzorMyši(String meno)` Zmení hlavnému oknu tvar kurzora myši buď na vlastný tvar kurzora vytvorený prostredníctvom metódy `novýKurzorMyši` (prípadne `zmeňNovýKurzorMyši`), alebo na niektorý zo systémom preddefinovaných kurzorov.
`static void`	`zmenNovyKurzorMysi(Image predloha, double x, double y, String meno)` Alias pre `zmeňNovýKurzorMyši`.
`static void`	`zmenNovyKurzorMysi(Image predloha, int x, int y, String meno)` Alias pre `zmeňNovýKurzorMyši`.
`static void`	`zmeňNovýKurzorMyši(Image predloha, double x, double y, String meno)` Alias pre `zmeňNovýKurzorMyši`.
`static void`	`zmeňNovýKurzorMyši(Image predloha, int x, int y, String meno)` Táto metóda je kombináciou volania metód `novýKurzorMyši` a `zmeňKurzorMyši`.
`static void`	`zmenRozmeryPlatien(int šírka, int výška)` Alias pre `zmeňRozmeryPlátien`.
`static void`	`zmeňRozmeryPlátien(int šírka, int výška)` Upraví rozmery plátna sveta, podlahy a stropu, čo je komplexný proces, preto by mal byť vykonaný len vo výnimočných prípadoch!
`static void`	`zobraz()` Zobrazí hlavné okno (svet).
`static boolean`	`zobrazeny()` Alias pre `zobrazený`.
`static boolean`	`zobrazený()` Zistí, či je hlavné okno (svet) viditeľné.
`static boolean`	`zobrazSystemovuIkonu(boolean zobraz)` Alias pre `zobrazSystémovúIkonu`.
`static boolean`	`zobrazSystémovúIkonu(boolean zobraz)` Zobrazí alebo skryje jestvujúcu ikonu v systémovej oblasti.
`static void`	`zobrazUvodnuObrazovku(Image úvodnýObrázok)` Alias pre `zobrazÚvodnúObrazovku`.
`static void`	`zobrazÚvodnúObrazovku(Image obrázok)` Zobrazí úvodnú obrazovku so zadaným obrázkom.
`static void`	`zobrazUvodnuObrazovku(String názovSúboru)` Alias pre `zobrazÚvodnúObrazovku`.
`static void`	`zobrazÚvodnúObrazovku(String názovSúboru)` Zobrazí úvodnú obrazovku so zadaným obrázkom prečítaným zo súboru.
`static void`	`zobudCasovac()` Alias pre `prebuďČasovač`.
`static void`	`zobuďČasovač()` Alias pre `prebuďČasovač`.
`static void`	`zrusInteraktivnuInstanciu()` Alias pre `zrušInteraktívnuInštanciu`.
`static void`	`zrusVstup()` Alias pre `zrušVstup`.
`static void`	`zrušInteraktívnuInštanciu()` Zruší interaktívnu inštanciu.
`static void`	`zrušVstup()` Vykoná pre vstupný riadok rovnakú akciu ako pri stlačení klávesu `Escape`.
`static void`	`zvuk(String súbor)` Prehrá zvukový súbor (formát `.wav`, `.au` alebo `.mp3`).
`static void`	`zvukNaPozadi(String súbor)` Alias pre `zvukNaPozadí`.
`static void`	`zvukNaPozadí(String súbor)` Začne alebo ukončí prehrávanie zvuku zo súboru na pozadí (formát `.wav`, `.au` alebo `.mp3`).
`static void`	`žiadajPrekreslenie()` Nastaví vnútorný príznak (stav) prekreslenia sveta tak, aby metóda `nebolPrekreslený` vrátila hodnotu `true`.

Metódy zdedené z triedy java.awt.Frame
addNotify, getCursorType, getExtendedState, getFrames, getIconImage, getMaximizedBounds, getMenuBar, getState, getTitle, isResizable, isUndecorated, remove, removeNotify, setBackground, setCursor, setExtendedState, setMaximizedBounds, setMenuBar, setOpacity, setResizable, setShape, setState, setTitle, setUndecorated

Metódy zdedené z triedy java.awt.Window
addPropertyChangeListener, addPropertyChangeListener, addWindowFocusListener, addWindowListener, addWindowStateListener, applyResourceBundle, applyResourceBundle, createBufferStrategy, createBufferStrategy, dispose, getBackground, getBufferStrategy, getFocusableWindowState, getFocusCycleRootAncestor, getFocusOwner, getFocusTraversalKeys, getIconImages, getInputContext, getListeners, getLocale, getModalExclusionType, getMostRecentFocusOwner, getOpacity, getOwnedWindows, getOwner, getOwnerlessWindows, getShape, getToolkit, getType, getWarningString, getWindowFocusListeners, getWindowListeners, getWindows, getWindowStateListeners, hide, isActive, isAlwaysOnTop, isAlwaysOnTopSupported, isAutoRequestFocus, isFocusableWindow, isFocusCycleRoot, isFocused, isLocationByPlatform, isOpaque, isShowing, isValidateRoot, pack, paint, postEvent, processEvent, processWindowFocusEvent, processWindowStateEvent, removeWindowFocusListener, removeWindowListener, removeWindowStateListener, reshape, setAlwaysOnTop, setAutoRequestFocus, setBounds, setBounds, setCursor, setFocusableWindowState, setFocusCycleRoot, setIconImages, setLocation, setLocation, setLocationByPlatform, setLocationRelativeTo, setMinimumSize, setModalExclusionType, setSize, setSize, setType, setVisible, show, toBack, toFront

Metódy zdedené z triedy java.awt.Container
add, add, add, add, add, addContainerListener, applyComponentOrientation, areFocusTraversalKeysSet, countComponents, deliverEvent, doLayout, findComponentAt, findComponentAt, getAlignmentX, getAlignmentY, getComponent, getComponentAt, getComponentAt, getComponentCount, getComponents, getComponentZOrder, getContainerListeners, getFocusTraversalPolicy, getInsets, getLayout, getMaximumSize, getMinimumSize, getMousePosition, getPreferredSize, insets, invalidate, isAncestorOf, isFocusCycleRoot, isFocusTraversalPolicyProvider, isFocusTraversalPolicySet, layout, list, list, locate, minimumSize, paintComponents, preferredSize, print, printComponents, processContainerEvent, remove, removeAll, removeContainerListener, setComponentZOrder, setFocusTraversalKeys, setFocusTraversalPolicy, setFocusTraversalPolicyProvider, setFont, transferFocusDownCycle, validate, validateTree

Metódy zdedené z triedy java.awt.Component
action, add, addComponentListener, addFocusListener, addHierarchyBoundsListener, addHierarchyListener, addInputMethodListener, addKeyListener, addMouseListener, addMouseMotionListener, addMouseWheelListener, bounds, coalesceEvents, contains, contains, createImage, createImage, createVolatileImage, createVolatileImage, disable, disableEvents, dispatchEvent, enable, enable, enableEvents, enableInputMetódy, firePropertyChange, firePropertyChange, firePropertyChange, firePropertyChange, firePropertyChange, firePropertyChange, firePropertyChange, firePropertyChange, firePropertyChange, getBaseline, getBaselineResizeBehavior, getBounds, getBounds, getColorModel, getComponentListeners, getComponentOrientation, getCursor, getDropTarget, getFocusListeners, getFocusTraversalKeysEnabled, getFont, getFontMetrics, getForeground, getGraphicsConfiguration, getHeight, getHierarchyBoundsListeners, getHierarchyListeners, getIgnoreRepaint, getInputMethodListeners, getInputMethodRequests, getKeyListeners, getLocation, getLocation, getLocationOnScreen, getMouseListeners, getMouseMotionListeners, getMousePosition, getMouseWheelListeners, getName, getParent, getPeer, getPropertyChangeListeners, getPropertyChangeListeners, getSize, getSize, getTreeLock, getWidth, getX, getY, gotFocus, handleEvent, hasFocus, checkImage, checkImage, imageUpdate, inside, isBackgroundSet, isCursorSet, isDisplayable, isDoubleBuffered, isEnabled, isFocusable, isFocusOwner, isFocusTraversable, isFontSet, isForegroundSet, isLightweight, isMaximumSizeSet, isMinimumSizeSet, isPreferredSizeSet, isValid, isVisible, keyDown, keyUp, list, list, list, location, lostFocus, mouseDown, mouseDrag, mouseEnter, mouseExit, mouseMove, mouseUp, move, nextFocus, paintAll, prepareImage, prepareImage, printAll, processComponentEvent, processFocusEvent, processHierarchyBoundsEvent, processHierarchyEvent, processInputMethodEvent, processKeyEvent, processMouseEvent, processMouseMotionEvent, processMouseWheelEvent, removeComponentListener, removeFocusListener, removeHierarchyBoundsListener, removeHierarchyListener, removeInputMethodListener, removeKeyListener, removeMouseListener, removeMouseMotionListener, removeMouseWheelListener, removePropertyChangeListener, removePropertyChangeListener, repaint, repaint, repaint, requestFocus, requestFocus, requestFocusInWindow, requestFocusInWindow, resize, resize, revalidate, setComponentOrientation, setDropTarget, setEnabled, setFocusable, setFocusTraversalKeysEnabled, setForeground, setIgnoreRepaint, setLocale, setMaximumSize, setName, setPreferredSize, show, size, toString, transferFocus, transferFocusBackward, transferFocusUpCycle

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

Metódy zdedené z rozhrania java.awt.MenuContainer
getFont, postEvent

Podrobnosti atribútov
- zmenaLAF
```
public static boolean zmenaLAF
```
  Tento špeciálny atribút je predvolene nastavený na true. Vtedy rámec pri inicializácii sveta a/alebo okien vykonáva zmenu vzhľadu (Look and Feel – LAF) na systémovú schému. Keď je však vopred nastavený na false rámec tieto zmeny nebude vykonávať.
- ukladajStavOknaNaVrchu
```
public static boolean ukladajStavOknaNaVrchu
```
  Tento rezervovaný atribút je predvolene nastavený na false. Vtedy rámec pri ukladaní konfigurácie (po ukončení aplikácie) neberie do úvahy aktuálny stav príznaku okna „vždy na vrchu“ (always on top). Keď je však atribút pred ukončením aplikácie nastavený na true rámec uloží aktuálny stav príznaku okna do konfigurácie.
- formát
```
public static final DecimalFormat formát
```
  Inštancia triedy DecimalFormat slúžiaca na formátovanie číselných výstupov. Úpravou vlastností tejto inštancie je možné dosiahnuť zmenu spôsobu formátovania celých a reálnych čísiel na výstupe (konzolovom alebo pri použití metódy F). Niektoré vlastnosti tejto inštancie sú použité aj na úpravu formátu čísiel zadávaných vstupnými prvkami (dialógmi alebo vstupným riadkom).
  
  Pozri tiež:
  
  oddeľovačPrvkovPoľa(String), oddeľovačDesatinnejČasti(char), oddeľovačTisícov(Character), zadajCeléČíslo(String), zadajReálneČíslo(String), upravCeléČíslo(long, String), upravReálneČíslo(double, String), prevezmiCeléČíslo(), prevezmiReálneČíslo(), vypíš(Object[]), F(double, int), F(double, int, int), GRobot.F(double, int), GRobot.F(double, int, int)
- format
```
public static final DecimalFormat format
```
  Alias pre formát.
- svgExport
```
public static SVGPodpora svgExport
```
  Atribút na podporu exportu kreslenia robotov do zadanej inštancie SVGPodpora. Tento atribút je statický! (Na rozdiel od rovnomenného atribútu v triede GRobot – pozri GRobot.svgExport.) To znamená, že správanie, ktoré sprostredkúva bude spoločné pre celý svet = všetky roboty.
  
  Predvolená hodnota tohto atribútu je null. Keď je do neho vložená ľubovoľná inštancia triedy SVGPodpora, tak sa pred každým prekreslením sveta skontrolujú všetky v nej obsiahnuté tvary a vymažú sa tie, ktoré boli vložené dôsledkom kreslenia vlastných alebo predvolených tvarov robotov. Tým sa zamedzí ich lineárnemu hromadeniu v zadanej inštancii SVG podpory.
  
  Keďže tento atribút nie je zoznamom, predpokladá sa, že všetky viditeľné roboty s nastavenou inštananciou svgExport (ktorých kreslené tvary sú do tejto inštancie automaticky pridávané pri každom prekreslení sveta) budú mať na export nastavenú tú istú inštanciu SVG podpory, napríklad predvolenú statickú inštanciu svgPodpora triedy GRobot.
  
  Pozri tiež:
  
  GRobot.svgExport
- príkazovýRiadok
```
public static Svet.PrikazovyRiadok príkazovýRiadok
```
  Inštancia triedy PríkazovýRiadok slúžiaca na komunikáciu s príkazovým prostredím operačného systému.
- prikazovyRiadok
```
public static Svet.PrikazovyRiadok prikazovyRiadok
```
  Alias pre príkazovýRiadok.
- zmenaCelejObrazovky
```
public static ZmenaCelejObrazovky zmenaCelejObrazovky
```
  Hodnota tohto atribútu môže obsahovať vlastnú implementáciu spôsobu zmeny režimu celej obrazovky. (Predvolený spôsob je hardvérový – pozri aj ZmenaCelejObrazovky.hardvérová.)

Podrobnosti metód

zavrieť
```
public static void zavrieť()
```
Vygeneruje udalosť zavretia hlavného okna. Ak nie je zavretie odmietnuté žiadnou z reakcií na zavretie okna (pozri napríklad ObsluhaUdalostí.zavretie()), tak bude aplikácia ukončená.

Pozri tiež:

koniec()

zavriet
```
public static void zavriet()
```
Alias pre zavrieť.

verzia

public static int verzia(int hlavná,
                         int vedľajšia)

Porovná aktuálnu verziu robota so zadanou.

Príklad:

if (Svet.verzia(2, 25) < 0)
{
    Svet.pípni();
    Svet.správa("Na fungovanie tejto aplikácie je potrebná\n" +
        "vyššia verzia programovacieho rámca GRobot!\n" +
        "(Najmenej 2.25; k dispozícii je: " + majorVersion + "." +
        Integer.toString(minorVersion + 100).substring(1) + ")");
    Svet.koniec();
}

Návratová hodnota:: ak je zadaná verzia zhodná s aktuálnou, tak je vrátená hodnota 0; ak je aktuálna verzia nižšia, než zadaná, tak je vrátená záporná hodnota, inak kladná

hlavnýRobot
```
public static GRobot hlavnýRobot()
```
Vráti hlavný robot. Hlavný robot je predvolene prvý vytvorený robot. Tento robot je považovaný za vlastníka sveta. On asistuje pri vytvorení okna aplikácie, pomocou neho sú spracované niektoré úlohy… O svoje privilégium by mohol prísť jedine v prípade, že by bol (pravdepodobne omylom) uvoľnený. V takom prípade by bol nahradený najbližším definovaným robotom s posunutím všetkých privilégií jemu. Problém by mohol nastať, keby nebol k dispozícii žiadny ďalší robot, ktorý by ho nahradil.

Návratová hodnota:

hlavný (prvý) robot

hlavnyRobot
```
public static GRobot hlavnyRobot()
```
Alias pre hlavnýRobot.

vyzviRoboty
```
public static void vyzviRoboty()
```
Spustením tejto metódy sa pre každý robot (podľa ich aktuálneho poradia) vykoná reakcia prijatieVýzvy bez určenia autora výzvy (autor je rovný null) a s hodnotou argumentu kľúč rovnou -1. Prvotné poradie robotov je určené poradím ich vytvorenia (čiže ak sme nijako neovplyvnili poradie robotov, je prvý vyzvaný ten robot, ktorý bol vytvorený ako prvý, to jest robot, ktorý je nakreslený pod všetkými ostatnými robotmi). Dodatočne môžeme poradie ovplyvniť volaním metód naVrch, naSpodok, vyššie, nižšie, pred a za.

Poznámka: Ak je poradie robotov zmenené počas spracovania výzviev, tak bude posielanie výziev z technických príčin opätovne spustené (inak povedané – posielanie výziev sa „reštartuje“). To znamená, že niektoré roboty budú vyzvané dva alebo viac ráz. Buďte preto opatrní so zmenami poradia v rámci spracovania výziev, aby ste nespôsobili vznik nekonečného cyklu… (Rovnaký efekt má prípadné vytvorenie nového robota, resp. ľubovoľnej inštancie triedy odvodenej od robota.)

Poznámka: Mechanizmus výziev nie je taký efektívny ako definícia vlastného zoznamu robotov (prípadne inštancií odvodených tried) a vykonanie hromadnej akcie pomocou tohto zoznamu. Slúži predovšedkým na umožnenie hromadného spracovania bez nevyhnutnosti vytvárania takého zoznamu (napríklad pri malom počte robotov alebo predtým, než sa programátor podrobnejšie oboznámi s možnosťami zoznamov).

Príklad použitia mechanizmu výziev je napríklad v opise metódy mimoHraníc.

Pozri tiež:

GRobot.prijatieVýzvy(GRobot, int), vyzviRoboty(int), vyzviRoboty(int, boolean), GRobot.vyzviRoboty()

vyzviRobotov
```
public static void vyzviRobotov()
```
Alias pre vyzviRoboty.

vyzviRoboty
```
public static void vyzviRoboty(int kľúč)
```
Spustením tejto metódy sa pre každý robot (podľa ich aktuálneho poradia) vykoná reakcia prijatieVýzvy bez určenia autora výzvy (autor je rovný null). S pomocou argumentu kľúč môžeme odlišovať rôzne druhy výziev a ovplyvňovať tým správanie reakcie prijatieVýzvy. Prvotné poradie robotov je určené poradím ich vytvorenia (čiže ak sme nijako neovplyvnili poradie robotov, je prvý vyzvaný ten robot, ktorý bol vytvorený ako prvý, to jest robot, ktorý je nakreslený pod všetkými ostatnými robotmi). Dodatočne môžeme poradie ovplyvniť volaním metód naVrch, naSpodok, vyššie, nižšie, pred a za.

Poznámka: Ak je poradie robotov zmenené počas spracovania výzviev, tak bude posielanie výziev z technických príčin opätovne spustené (inak povedané – posielanie výziev sa „reštartuje“). To znamená, že niektoré roboty budú vyzvané dva alebo viac ráz. Buďte preto opatrní so zmenami poradia v rámci spracovania výziev, aby ste nespôsobili vznik nekonečného cyklu… (Rovnaký efekt má prípadné vytvorenie nového robota, resp. ľubovoľnej inštancie triedy odvodenej od robota.)

Poznámka: Mechanizmus výziev nie je taký efektívny ako definícia vlastného zoznamu robotov (prípadne inštancií odvodených tried) a vykonanie hromadnej akcie pomocou tohto zoznamu. Slúži predovšedkým na umožnenie hromadného spracovania bez nevyhnutnosti vytvárania takého zoznamu (napríklad pri malom počte robotov alebo predtým, než sa programátor podrobnejšie oboznámi s možnosťami zoznamov).

Príklad použitia mechanizmu výziev je napríklad v opise metódy mimoHraníc.

Parametre:

kľúč – celočíselná hodnota, ktorá je poslaná do reakcie prijatieVýzvy každého robota; takto je možné odlíšiť rôzne druhy výziev, vďaka čomu môžeme ovplyvniť správanie reakcie prijatieVýzvy

Pozri tiež:

GRobot.prijatieVýzvy(GRobot, int), vyzviRoboty(), vyzviRoboty(int, boolean), GRobot.vyzviRoboty(int)

vyzviRobotov

public static void vyzviRobotov(int kľúč)

Alias pre vyzviRoboty.

vyzviRoboty
```
public static void vyzviRoboty(int kľúč,
                               boolean obrátene)
```
Spustením tejto metódy sa pre každý robot (podľa ich aktuálneho poradia) vykoná reakcia prijatieVýzvy bez určenia autora výzvy (autor je rovný null). S pomocou argumentu kľúč môžeme odlišovať rôzne druhy výziev a ovplyvňovať tým správanie reakcie prijatieVýzvy. Argument obrátene určuje smer spracovania. Ak je rovný true, zoznam robotov bude spracovaný od konca, to znamená, že prvý bude vyzvaný buď naposledy vytvorený robot, alebo robot aktuálne umiestnený na konci vnútorného zoznamu robotov. Záleží od toho, či sme dodatočne ovplyvňovali poradie robotov metódami naVrch, naSpodok, vyššie, nižšie, pred a za. Ak je hodnota argumentu obrátene rovná false, metóda sa správa rovnako ako vyzviRoboty(int kľúč).

Poznámka: Ak je poradie robotov zmenené počas spracovania výzviev, tak bude posielanie výziev z technických príčin opätovne spustené (inak povedané – posielanie výziev sa „reštartuje“). To znamená, že niektoré roboty budú vyzvané dva alebo viac ráz. Buďte preto opatrní so zmenami poradia v rámci spracovania výziev, aby ste nespôsobili vznik nekonečného cyklu… (Rovnaký efekt má prípadné vytvorenie nového robota, resp. ľubovoľnej inštancie triedy odvodenej od robota.)

Poznámka: Mechanizmus výziev nepovažujeme za taký efektívny ako je definícia vlastného zoznamu robotov (prípadne inštancií odvodených tried) a nasledujúce vykonanie hromadnej akcie pomocou tohto vlastného zoznamu. Výzvy slúžia predovšedkým na umožnenie hromadného spracovania bez nevyhnutnosti vytvárania takého zoznamu (napríklad v prípade, keď nepovažujeme vytvorenie vlastného zoznamu za významný prínos, alebo predtým, než sa programátor podrobnejšie oboznámi s možnosťami zoznamov).

Príklad použitia mechanizmu výziev je napríklad v opise metódy mimoHraníc.

Parametre:

kľúč – celočíselná hodnota, ktorá je poslaná do reakcie prijatieVýzvy každého robota; takto je možné odlíšiť rôzne druhy výziev, vďaka čomu môžeme ovplyvniť správanie reakcie prijatieVýzvy

obrátene – týmto argumentom môžeme ovplyvniť smer spracovania; true znamená spracovanie vnútorného zoznamu robotov od konca; false znamená rovnaký spôsob spracovania ako pri metóde vyzviRoboty(int kľúč)

Pozri tiež:

GRobot.prijatieVýzvy(GRobot, int), vyzviRoboty(), vyzviRoboty(int), GRobot.vyzviRoboty(int, boolean)

vyzviRobotov

public static void vyzviRobotov(int kľúč,
                                boolean obrátene)

Alias pre vyzviRoboty.

najmenšieX
```
public static double najmenšieX()
```
Zistí najmenšiu x-ovú súradnicu sveta. Plátna podlahy a stropu majú obmedzenú veľkosť, ktorá je o niečo väčšia ako predvolená veľkosť okna aplikácie.

Návratová hodnota:

najmenšia x-ová súradnica plátien

Pozri tiež:

najväčšieX(), najmenšieY(), najväčšieY()

najmensieX
```
public static double najmensieX()
```
Alias pre najmenšieX.

minimálneX
```
public static double minimálneX()
```
Alias pre najmenšieX.

minimalneX
```
public static double minimalneX()
```
Alias pre najmenšieX.

najmenšieY
```
public static double najmenšieY()
```
Zistí najmenšiu y-ovú súradnicu sveta. Plátna podlahy a stropu majú obmedzenú veľkosť, ktorá je o niečo väčšia ako predvolená veľkosť okna aplikácie.

Návratová hodnota:

najmenšia y-ová súradnica plátien

Pozri tiež:

najmenšieX(), najväčšieX(), najväčšieY()

najmensieY
```
public static double najmensieY()
```
Alias pre najmenšieY.

minimálneY
```
public static double minimálneY()
```
Alias pre najmenšieY.

minimalneY
```
public static double minimalneY()
```
Alias pre najmenšieY.

najväčšieX
```
public static double najväčšieX()
```
Zistí najväčšiu x-ovú súradnicu sveta. Plátna podlahy a stropu majú obmedzenú veľkosť, ktorá je o niečo väčšia ako predvolená veľkosť okna aplikácie.

Návratová hodnota:

najväčšia x-ová súradnica plátien

Pozri tiež:

najmenšieX(), najmenšieY(), najväčšieY()

najvacsieX
```
public static double najvacsieX()
```
Alias pre najväčšieX.

maximálneX
```
public static double maximálneX()
```
Alias pre najväčšieX.

maximalneX
```
public static double maximalneX()
```
Alias pre najväčšieX.

najväčšieY
```
public static double najväčšieY()
```
Zistí najväčšiu y-ovú súradnicu sveta. Plátna podlahy a stropu majú obmedzenú veľkosť, ktorá je o niečo väčšia ako predvolená veľkosť okna aplikácie.

Návratová hodnota:

najväčšia y-ová súradnica plátien

Pozri tiež:

najmenšieX(), najväčšieX(), najmenšieY()

najvacsieY
```
public static double najvacsieY()
```
Alias pre najväčšieY.

maximálneY
```
public static double maximálneY()
```
Alias pre najväčšieY.

maximalneY
```
public static double maximalneY()
```
Alias pre najväčšieY.

šírka
```
public static int šírka()
```
Zistí šírku plátien sveta.

Návratová hodnota:

šírka plátien sveta

sirka
```
public static int sirka()
```
Alias pre šírka.

výška
```
public static int výška()
```
Zistí výšku plátien sveta.

Návratová hodnota:

výška plátien sveta

vyska
```
public static int vyska()
```
Alias pre šírka.

viditeľnáŠírka
```
public static int viditeľnáŠírka()
```
Zistí aktuálnu šírku tzv. klientskej oblasti okna. Ide o viditeľnú časť komponentu okna zahŕňajúceho obvykle šedú plochu s predvolene bielou kresliacou oblasťou a prípadne ďalšími komponentmi (vstupným riadkom, tlačidlami…). Ak je okno užšie, než sú rozmery plátien sveta, tak ide v podstate o viditeľnú šírku plátien.

Návratová hodnota:

šírka klientskej oblasti okna (ak je okno užšie, než plátno, tak ide o viditeľnú časť plátien sveta)

viditelnaSirka
```
public static int viditelnaSirka()
```
Alias pre viditeľnáŠírka.

viditeľnáVýška
```
public static int viditeľnáVýška()
```
Zistí viditeľnú výšku tzv. klientskej oblasti okna. Pozri aj opis metódy viditeľnáŠírka() – rovnaké informácie platia aj pre túto metódu (viditeľnáVýška).

Návratová hodnota:

výška klientskej oblasti okna (ak je okno menšie, než výška plátna, tak ide o viditeľnú časť plátien sveta)

viditelnaVyska
```
public static int viditelnaVyska()
```
Alias pre viditeľnáVýška.

šírkaOkna
```
public static int šírkaOkna()
```
Zistí šírku hlavného okna aplikácie.

Návratová hodnota:

šírka hlavného okna aplikácie

sirkaOkna
```
public static int sirkaOkna()
```
Alias pre šírkaOkna.

výškaOkna
```
public static int výškaOkna()
```
Zistí výšku hlavného okna aplikácie.

Návratová hodnota:

výška hlavného okna aplikácie

vyskaOkna
```
public static int vyskaOkna()
```
Alias pre výškaOkna.

titulok
```
public static String titulok()
```
Vráti titulok hlavného okna aplikácie. Ak metóda zistí, že aktuálny titulok sa zhoduje s predvoleným titulkom (prípadne ak hlavné okno ešte nejestvuje), tak vráti hodnotu null.

Návratová hodnota:

titulok hlavného okna aplikácie alebo null

titulok
```
public static void titulok(String titulok)
```
Nastaví titulok hlavného okna aplikácie. Ak je zadaná hodnota null, tak metóda nastaví predvolený titulok okna.

Parametre:

titulok – nový titulok hlavného okna aplikácie alebo null na nastavenie predvoleného titulku okna

ľavýOkraj
```
public static double ľavýOkraj()
```
Zistí najmenšiu aktuálne viditeľnú x-ovú súradnicu plátien (podlahy alebo stropu).

Návratová hodnota:

najmenšia viditeľná x-ová súradnica plátien

Pozri tiež:

pravýOkraj(), spodnýOkraj(), vrchnýOkraj()

lavyOkraj
```
public static double lavyOkraj()
```
Alias pre ľavýOkraj.

spodnýOkraj
```
public static double spodnýOkraj()
```
Zistí najmenšiu aktuálne viditeľnú y-ovú súradnicu plátien (podlahy alebo stropu).

Návratová hodnota:

najmenšia viditeľná y-ová súradnica plátien

Pozri tiež:

ľavýOkraj(), pravýOkraj(), vrchnýOkraj()

spodnyOkraj
```
public static double spodnyOkraj()
```
Alias pre spodnýOkraj.

dolnýOkraj
```
public static double dolnýOkraj()
```
Alias pre spodnýOkraj.

dolnyOkraj
```
public static double dolnyOkraj()
```
Alias pre dolnýOkraj.

pravýOkraj
```
public static double pravýOkraj()
```
Zistí najväčšiu aktuálne viditeľnú x-ovú súradnicu plátien (podlahy alebo stropu).

Návratová hodnota:

najväčšia viditeľná x-ová súradnica plátien

Pozri tiež:

ľavýOkraj(), spodnýOkraj(), vrchnýOkraj()

pravyOkraj
```
public static double pravyOkraj()
```
Alias pre pravýOkraj.

vrchnýOkraj
```
public static double vrchnýOkraj()
```
Zistí najväčšiu aktuálne viditeľnú y-ovú súradnicu plátien (podlahy alebo stropu).

Návratová hodnota:

najväčšia viditeľná y-ová súradnica plátien

Pozri tiež:

ľavýOkraj(), pravýOkraj(), spodnýOkraj()

vrchnyOkraj
```
public static double vrchnyOkraj()
```
Alias pre vrchnýOkraj.

hornýOkraj
```
public static double hornýOkraj()
```
Alias pre vrchnýOkraj.

hornyOkraj
```
public static double hornyOkraj()
```
Alias pre hornýOkraj.

zmeňRozmeryPlátien
```
public static void zmeňRozmeryPlátien(int šírka,
                                      int výška)
```
Upraví rozmery plátna sveta, podlahy a stropu, čo je komplexný proces, preto by mal byť vykonaný len vo výnimočných prípadoch! Tento proces má za následok prebudovanie grafických objektov sveta, stropu a podlahy (čo má za následok vymazanie ich grafického obsahu), ich opätovné priradenie grafickým robotom, aktualizáciu umiestnenia komponentov sveta (tlačidiel – pozri triedu Tlačidlo), zrušenie úprav textov (pozri metódu upravText), odstránenie prípadných definovaných inštancií vlnenia oboch plátien aj sveta (pretože sa menia ich rozmery; prípadné definované vlnenia obrázkov zostanú zachované), vypnutie osvetlenia sveta (aj oboch plátien), prepočet niektorých ďalších vnútorných parametrov a úpravu súradnicových systémov všetkých obrázkov programovacieho rámca.

Parametre:

šírka – nová šírka plátien

výška – nová výška plátien

Pozri tiež:

GRobot.GRobot(int, int), GRobot.GRobot(int, int, String)

zmenRozmeryPlatien

public static void zmenRozmeryPlatien(int šírka,
                                      int výška)

Alias pre zmeňRozmeryPlátien.

upravRozmeryPlátien

public static void upravRozmeryPlátien(int šírka,
                                       int výška)

Alias pre zmeňRozmeryPlátien.

upravRozmeryPlatien

public static void upravRozmeryPlatien(int šírka,
                                       int výška)

Alias pre zmeňRozmeryPlátien.

viditeľný
```
public static boolean viditeľný()
```
Zistí, či je hlavné okno (svet) viditeľné. Ak okno sveta ešte nebolo inicializované (to platí v prípade, keď ešte nebola vytvorená ani jedna inštancia robota, to znamená, že nejestvuje hlavný robot), metóda informuje o tom, či bude okno zobrazené hneď po inicializácii. (Ak nie, znamená to, že sme volali metódu skry, prípadne niektorú z verzií metódy zobrazÚvodnúObrazovku. V tom prípade musíme po inicializácii okno zobraziť metódou zobraz, prípadne metódou skryÚvodnúObrazovku.) Alternatívou tejto metódy je metóda zobrazený.

Návratová hodnota:

true – áno; false – nie

Pozri tiež:

zobrazený(), zobraz(), skry()

viditelny
```
public static boolean viditelny()
```
Alias pre viditeľný.

zobrazený
```
public static boolean zobrazený()
```
Zistí, či je hlavné okno (svet) viditeľné. Ak okno sveta ešte nebolo inicializované (to platí v prípade, keď ešte nebola vytvorená ani jedna inštancia robota, to znamená, že nejestvuje hlavný robot), metóda informuje o tom, či bude okno zobrazené hneď po inicializácii. (Ak nie, znamená to, že sme volali metódu skry, prípadne niektorú z verzií metódy zobrazÚvodnúObrazovku. V tom prípade musíme po inicializácii okno zobraziť metódou zobraz, prípadne metódou skryÚvodnúObrazovku.) Alternatívou tejto metódy je metóda viditeľný.

Návratová hodnota:

true – áno; false – nie

Pozri tiež:

viditeľný(), zobraz(), skry()

zobrazeny
```
public static boolean zobrazeny()
```
Alias pre zobrazený.

skry
```
public static void skry()
```
Skryje hlavné okno. Zároveň spôsobí, že okno sveta nebude automaticky zobrazené pri štarte. Aplikácia sa môže inicializovať a potom zobraziť hlavné okno metódou zobraz.

Pozri tiež:

zobraz(), viditeľný(), zobrazený()

zobraz
```
public static void zobraz()
```
Zobrazí hlavné okno (svet). Metóda je protikladom metódy skry.

Pozri tiež:

skry(), viditeľný(), zobrazený()

upevni
```
public static void upevni()
```
Upevní hlavné okno (svet) – okno bude mať pevnú veľkosť. Opakom je metóda uvoľni. Veľkosť okna nemá vplyv na veľkosti plátien podlahy a stropu. Tie je v súčasnej verzii programovacieho rámca možné upraviť konštruktorom hlavného robota (čo je historicky starší spôsob – pozri aj konštruktor GRobot.GRobot(int, int)) alebo volaním metódy zmeňRozmeryPlátien.

Pozri tiež:

uvoľni(), zbaľ(), vystreď()

uvoľni
```
public static void uvoľni()
```
Uvoľní hlavné okno (svet) – okno nebude mať pevnú veľkosť (predvolené správanie sveta). Opakom je metóda upevni. Veľkosť okna nemá vplyv na veľkosti plátien podlahy a stropu. Tie je v súčasnej verzii programovacieho rámca možné upraviť konštruktorom hlavného robota (čo je historicky starší spôsob – pozri aj konštruktor GRobot.GRobot(int, int)) alebo volaním metódy zmeňRozmeryPlátien.

Poznámka: Názov uvoľni má v programovacom rámci GRobot deväť rôznych metód: GRobot.uvoľni(), GRobot.uvoľni(Oblasť), Oblasť.uvoľni(), Oblasť.uvoľni(GRobot) – slúžia na uvoľnenie robota zo zamestnania pre stanovenú oblasť (čo je geometrická trieda), Svet.uvoľni() – slúži na uvoľnenie hlavného okna sveta, t. j. umožnenie zmeny veľkosti okna používateľovi (ide o opak metódy Svet.upevni) a nakoniec Svet.uvoľni(GRobot), Svet.uvoľni(Class), Svet.uvoľni(Plazma) Svet.uvoľni(Obrázok) a Svet.uvoľni(String) – slúžia na uvoľňovanie nepotrebných inštancií robotov, vytvorených alebo prečítaných obrázkov a prečítaných zvukov z vnútorných zoznamov zdrojov (robotov, obrázkov, zvukov), čo je jednak nevyhnutnou podmienkou ich úspešného vymazania z pamäte zberačom odpadkov Javy a jednak to môže byť niekedy potrebné (napríklad ak sa obsah súboru so zdrojom uloženým na disku zmenil).

Pozri tiež:

upevni(), zbaľ(), vystreď()

uvolni
```
public static void uvolni()
```
Alias pre uvoľni.

zbaľ
```
public static void zbaľ()
```
Prispôsobí veľkosť okna tak, aby sa do neho pohodlne vošli všetky viditeľné komponenty.

Pozri tiež:

upevni(), uvoľni(), vystreď()

zbal
```
public static void zbal()
```
Alias pre zbaľ.

vystreď
```
public static void vystreď()
```
Presunie okno tak, aby sa nachádzalo v strede obrazovky.

Pozri tiež:

upevni(), uvoľni(), zbaľ()

vystred
```
public static void vystred()
```
Alias pre vystreď.

premiestniNaZariadenie
```
public static void premiestniNaZariadenie(int zariadenie)
```
Umiestni okno sveta na určené zobrazovacie zariadenie. Zariadenie je určené jeho „poradovým číslom“ (indexom; čiže nula označuje prvé zariadenie). Okno je umiestnené tak, aby bola na určenom zariadení viditeľná celá jeho plocha, ak to rozmery okna dovoľujú. Ak je okno väčšie, než sú rozmery zariadenia, tak je umiestnené do ľavého horného rohu zariadenia. Ak zariadenie so zadaným indexom nejestvuje, tak nie je vykonaná žiadna operácia.

Parametre:

zariadenie – číslo zariadenia, na ktoré má byť okno umiestnené

Pozri tiež:

početZariadení(), premiestniNaZariadenie(), zistiZariadenieOkna()

premiestniNaZariadenie
```
public static void premiestniNaZariadenie()
```
Umiestni okno sveta na predvolené zobrazovacie zariadenie. Okno je umiestnené tak, aby bola viditeľná celá jeho plocha, ak to jeho rozmery dovoľujú. Ak je okno väčšie, než sú rozmery zariadenia, tak je umiestnené do ľavého horného rohu.

Pozri tiež:

početZariadení(), premiestniNaZariadenie(int), zistiZariadenieOkna()

premiestniNaObrazovku

public static void premiestniNaObrazovku(int zariadenie)

Alias pre premiestniNaZariadenie.

premiestniNaObrazovku
```
public static void premiestniNaObrazovku()
```
Alias pre premiestniNaZariadenie.

presuňNaZariadenie

public static void presuňNaZariadenie(int zariadenie)

Alias pre premiestniNaZariadenie.

presuňNaZariadenie
```
public static void presuňNaZariadenie()
```
Alias pre premiestniNaZariadenie.

presunNaZariadenie

public static void presunNaZariadenie(int zariadenie)

Alias pre premiestniNaZariadenie.

presunNaZariadenie
```
public static void presunNaZariadenie()
```
Alias pre premiestniNaZariadenie.

presuňNaObrazovku

public static void presuňNaObrazovku(int zariadenie)

Alias pre premiestniNaZariadenie.

presuňNaObrazovku
```
public static void presuňNaObrazovku()
```
Alias pre premiestniNaZariadenie.

presunNaObrazovku

public static void presunNaObrazovku(int zariadenie)

Alias pre premiestniNaZariadenie.

presunNaObrazovku
```
public static void presunNaObrazovku()
```
Alias pre premiestniNaZariadenie.

zistiZariadenieOkna
```
public static int zistiZariadenieOkna()
```
Zistí číslo zariadenia, na ktorom sa nachádza okno sveta. Zariadenie je určené jeho „poradovým číslom“ (indexom; čiže nula označuje prvé zariadenie). Pri zisťovaní polohy je braný do úvahy stred okna. Ak také zariadenie, do ktorého plochy by patril stred okna nejestvuje, tak je vrátená hodnota -1.

Návratová hodnota:

číslo zariadenia, do ktorého patrí stred okna sveta alebo -1, ak také zariadenie nejestvuje

Pozri tiež:

početZariadení(), premiestniNaZariadenie(), premiestniNaZariadenie(int)

maximalizovaný
```
public static boolean maximalizovaný()
```
Zistí, či je okno sveta v maximalizovanom stave.

Návratová hodnota:

ak je okno sveta v maximalizovanom stave, tak vráti hodnotu true, inak false

Pozri tiež:

ObsluhaUdalostí.maximalizovanie(), maximalizuj(), minimalizovaný(), minimalizuj(), normálny(), obnov()

maximalizovany

public static boolean maximalizovany()

Alias pre maximalizovaný.

maximalizuj
```
public static void maximalizuj()
```
Pokúsi sa prepnúť okno sveta do maximalizovaného stavu. O tom, či sa táto akcia podarila sa dá presvedčiť volaním metódy maximalizovaný.

Pozri tiež:

ObsluhaUdalostí.maximalizovanie(), maximalizovaný(), minimalizovaný(), minimalizuj(), normálny(), obnov()

minimalizovaný
```
public static boolean minimalizovaný()
```
Zistí, či je okno sveta v minimalizovanom stave.

Návratová hodnota:

ak je okno sveta v minimalizovanom stave, tak vráti hodnotu true, inak false

Pozri tiež:

ObsluhaUdalostí.minimalizovanie(), maximalizovaný(), maximalizuj(), minimalizuj(), normálny(), obnov()

minimalizovany

public static boolean minimalizovany()

Alias pre minimalizovaný.

minimalizuj
```
public static void minimalizuj()
```
Pokúsi sa prepnúť okno sveta do minimalizovaného stavu. O tom, či sa táto akcia podarila sa dá presvedčiť volaním metódy minimalizovaný.

Pozri tiež:

ObsluhaUdalostí.minimalizovanie(), maximalizovaný(), maximalizuj(), minimalizovaný(), normálny(), obnov()

normálny
```
public static boolean normálny()
```
Zistí, či je okno sveta v normálnom stave.

Návratová hodnota:

ak je okno sveta v normálnom stave, tak vráti hodnotu true, inak false

Pozri tiež:

ObsluhaUdalostí.obnovenie(), maximalizovaný(), maximalizuj(), minimalizovaný(), minimalizuj(), obnov()

normalny
```
public static boolean normalny()
```
Alias pre normálny.

obnov
```
public static void obnov()
```
Pokúsi sa prepnúť okno sveta do normálneho stavu. (V zmysle „nie maximalizovaného a nie minimalizovaného“ stavu.) O tom, či sa táto akcia podarila sa dá presvedčiť volaním metódy normálny.

Pozri tiež:

ObsluhaUdalostí.obnovenie(), maximalizovaný(), maximalizuj(), minimalizovaný(), minimalizuj(), normálny(), obnov()

hlavnýPanel
```
public static JPanel hlavnýPanel()
```
Poskytne komponent hlavného panela vloženého v hlavnom okne aplikácie (vo svete).

Upozornenie: Neodborná manipulácia s týmto komponentom môže mať nežiaduce vedľajšie účinky.

Poznámka: Táto metóda bola do programovacieho rámca niekoľkokrát pridaná na testovacie účely, pričom hneď po skončení testov bola odobraná. Autor rámca nemal v úmysle trvalé ponechanie možnosti získania hlavného panela na ďalšiu manipuláciu, ale dňa 12. 6. 2019 ho okolnosti presvedčili o tom, aby túto možnosť predsa ponechal dostupnú natrvalo. Riaďte sa však upozornením vyššie.

Návratová hodnota:

hlavný panel aplikačného okna

hlavnyPanel
```
public static JPanel hlavnyPanel()
```
Alias pre hlavnýPanel.

vzdialenosť
```
public static double vzdialenosť(double súradnicaBoduX,
                                 double súradnicaBoduY)
```
Zistí vzdialenosť bodu so zadanými súradnicami od stredu súradnicovej sústavy.

Parametre:

súradnicaBoduX – x-ová súradnica bodu

súradnicaBoduY – y-ová súradnica bodu

Návratová hodnota:

vzdialenosť medzi stredom súradnicovej sústavy a zadaným bodom

Pozri tiež:

GRobot.vzdialenosť(), vzdialenosť(Poloha), vzdialenosť(Shape)

vzdialenost

public static double vzdialenost(double súradnicaBoduX,
                                 double súradnicaBoduY)

Alias pre vzdialenosť.

vzdialenosť
```
public static double vzdialenosť(Poloha objekt)
```
Zistí, aká je vzdialenosť zadaného objektu od stredu súradnicovej sústavy.

Parametre:

objekt – objekt, ktorého vzdialenosť zisťujeme

Návratová hodnota:

vzdialenosť objektu od stredu súradnicovej sústavy

Pozri tiež:

GRobot.vzdialenosť(), vzdialenosť(double, double), vzdialenosť(Shape)

vzdialenost

public static double vzdialenost(Poloha objekt)

Alias pre vzdialenosť.

vzdialenosť
```
public static double vzdialenosť(Shape tvar)
```
Zistí vzdialenosť stredu hraníc^[1] zadaného tvaru od stredu súradnicovej sústavy.

[1] – nejde presne o stred útvaru; je použitý najrýchlejší a najjednoduchší spôsob zistenia približného stredu: vezme sa obdĺžnik tesne ohraničujúci útvar a určí sa jeho stred – čiže „stred hraníc.“

Parametre:

tvar – tvar Javy (Shape), stred hraníc ktorého vzdialenosť od stredu zisťujeme

Návratová hodnota:

vzdialenosť stredom súradnicovej sústavy a stredom zadaného tvaru

Pozri tiež:

GRobot.vzdialenosť(), vzdialenosť(double, double), vzdialenosť(Poloha)

vzdialenost

public static double vzdialenost(Shape tvar)

Alias pre vzdialenosť.

vzdialenosť
```
public static double vzdialenosť(double súradnicaBoduX1,
                                 double súradnicaBoduY1,
                                 double súradnicaBoduX2,
                                 double súradnicaBoduY2)
```
Zistí vzájomnú vzdialenosť medzi bodmi so zadanými súradnicami.

Parametre:

súradnicaBoduX1 – x-ová súradnica prvého bodu

súradnicaBoduY1 – y-ová súradnica prvého bodu

súradnicaBoduX2 – x-ová súradnica druhého bodu

súradnicaBoduY2 – y-ová súradnica druhého bodu

Návratová hodnota:

vzájomná vzdialenosť medzi zadanými bodmi

Pozri tiež:

GRobot.vzdialenosť(), vzdialenosť(Poloha, Poloha), vzdialenosť(Shape, Shape)

vzdialenost

public static double vzdialenost(double súradnicaBoduX1,
                                 double súradnicaBoduY1,
                                 double súradnicaBoduX2,
                                 double súradnicaBoduY2)

Alias pre vzdialenosť.

vzdialenosť
```
public static double vzdialenosť(Poloha objekt1,
                                 Poloha objekt2)
```
Zistí vzájomnú vzdialenosť zadaných objektov.

Parametre:

objekt1 – prvý objekt, ktorého súradnice sa berú do úvahy

objekt2 – druhý objekt, ktorého súradnice sa berú do úvahy

Návratová hodnota:

vzájomná vzdialenosť medzi zadanými objektmi

Pozri tiež:

GRobot.vzdialenosť(), vzdialenosť(double, double, double, double), vzdialenosť(Shape, Shape)

vzdialenost

public static double vzdialenost(Poloha objekt1,
                                 Poloha objekt2)

Alias pre vzdialenosť.

vzdialenosť
```
public static double vzdialenosť(Shape tvar1,
                                 Shape tvar2)
```
Zistí vzájomnú vzdialenosť stredov hraníc^[1] zadaných tvarov.

[1] – nejde presne o stred útvarov; je použitý najrýchlejší a najjednoduchší spôsob zistenia približného stredu: vezme sa obdĺžnik tesne ohraničujúci útvar a určí sa jeho stred – čiže „stred hraníc.“

Parametre:

tvar1 – prvý tvar Javy (Shape), ktorého stred hraníc sa berie do úvahy

tvar2 – druhý tvar Javy (Shape), ktorého stred hraníc sa berie do úvahy

Návratová hodnota:

vzájomná vzdialenosť stredov hraníc zadaných tvarov

Pozri tiež:

GRobot.vzdialenosť(), vzdialenosť(double, double, double, double), vzdialenosť(Poloha, Poloha)

vzdialenost

public static double vzdialenost(Shape tvar1,
                                 Shape tvar2)

Alias pre vzdialenosť.

vzdialenosť
```
public static double vzdialenosť(Poloha objekt1,
                                 double súradnicaBoduX2,
                                 double súradnicaBoduY2)
```
Zistí vzájomnú vzdialenosť zadaného objektu a bodu so zadanými súradnicami.

Parametre:

objekt1 – objekt, ktorého súradnice sa berú do úvahy

súradnicaBoduX2 – x-ová súradnica bodu

súradnicaBoduY2 – y-ová súradnica bodu

Návratová hodnota:

vzájomná vzdialenosť medzi zadaným objektom a bodom

Pozri tiež:

GRobot.vzdialenosť(), vzdialenosť(Shape, double, double)

vzdialenost

public static double vzdialenost(Poloha objekt1,
                                 double súradnicaBoduX2,
                                 double súradnicaBoduY2)

Alias pre vzdialenosť.

vzdialenosť
```
public static double vzdialenosť(Shape tvar1,
                                 double súradnicaBoduX2,
                                 double súradnicaBoduY2)
```
Zistí vzájomnú vzdialenosť stredu hraníc^[1] zadaného tvaru a bodu so zadanými súradnicami.

[1] – nejde presne o stred útvaru; je použitý najrýchlejší a najjednoduchší spôsob zistenia približného stredu: vezme sa obdĺžnik tesne ohraničujúci útvar a určí sa jeho stred – čiže „stred hraníc.“

Parametre:

tvar1 – tvar Javy (Shape), ktorého stred hraníc sa berie do úvahy

súradnicaBoduX2 – x-ová súradnica bodu

súradnicaBoduY2 – y-ová súradnica bodu

Návratová hodnota:

vzájomná vzdialenosť medzi stredom hraníc zadaného tvaru a bodom

Pozri tiež:

GRobot.vzdialenosť(), vzdialenosť(Poloha, double, double)

vzdialenost

public static double vzdialenost(Shape tvar1,
                                 double súradnicaBoduX2,
                                 double súradnicaBoduY2)

Alias pre vzdialenosť.

vzdialenosť
```
public static double vzdialenosť(double súradnicaBoduX1,
                                 double súradnicaBoduY1,
                                 Poloha objekt2)
```
Zistí vzájomnú vzdialenosť medzi bodom so zadanými súradnicami a zadaným objektom.

Parametre:

súradnicaBoduX1 – x-ová súradnica bodu

súradnicaBoduY1 – y-ová súradnica bodu

objekt2 – objekt, ktorého súradnice sa berú do úvahy

Návratová hodnota:

vzájomná vzdialenosť medzi zadaným bodom a objektom

Pozri tiež:

GRobot.vzdialenosť(), vzdialenosť(Shape, Poloha)

vzdialenost

public static double vzdialenost(double súradnicaBoduX1,
                                 double súradnicaBoduY1,
                                 Poloha objekt2)

Alias pre vzdialenosť.

vzdialenosť
```
public static double vzdialenosť(Shape tvar1,
                                 Poloha objekt2)
```
Zistí vzájomnú vzdialenosť stredu hraníc^[1] zadaného tvaru a polohy zadaného objektu.

[1] – nejde presne o stred útvaru; je použitý najrýchlejší a najjednoduchší spôsob zistenia približného stredu: vezme sa obdĺžnik tesne ohraničujúci útvar a určí sa jeho stred – čiže „stred hraníc.“

Parametre:

tvar1 – tvar Javy (Shape), ktorého stred hraníc sa berie do úvahy

objekt2 – objekt, ktorého súradnice sa berú do úvahy

Návratová hodnota:

vzájomná vzdialenosť stredu hraníc zadaného tvaru a polohy zadaného objektu

Pozri tiež:

GRobot.vzdialenosť(), vzdialenosť(double, double, Poloha)

vzdialenost

public static double vzdialenost(Shape tvar1,
                                 Poloha objekt2)

Alias pre vzdialenosť.

vzdialenosť
```
public static double vzdialenosť(double súradnicaBoduX1,
                                 double súradnicaBoduY1,
                                 Shape tvar2)
```
Zistí vzájomnú vzdialenosť medzi bodom so zadanými súradnicami a stredom hraníc^[1] zadaného tvaru.

[1] – nejde presne o stred útvaru; je použitý najrýchlejší a najjednoduchší spôsob zistenia približného stredu: vezme sa obdĺžnik tesne ohraničujúci útvar a určí sa jeho stred – čiže „stred hraníc.“

Parametre:

súradnicaBoduX1 – x-ová súradnica bodu

súradnicaBoduY1 – y-ová súradnica bodu

tvar2 – tvar Javy (Shape), ktorého stred hraníc sa berie do úvahy

Návratová hodnota:

vzájomná vzdialenosť medzi zadaným bodom a stredom hraníc zadaného tvaru

Pozri tiež:

GRobot.vzdialenosť(), vzdialenosť(Poloha, Shape)

vzdialenost

public static double vzdialenost(double súradnicaBoduX1,
                                 double súradnicaBoduY1,
                                 Shape tvar2)

Alias pre vzdialenosť.

vzdialenosť
```
public static double vzdialenosť(Poloha objekt1,
                                 Shape tvar2)
```
Zistí vzájomnú vzdialenosť medzi zadaným objektom a stredom hraníc^[1] zadaného tvaru.

[1] – nejde presne o stred útvaru; je použitý najrýchlejší a najjednoduchší spôsob zistenia približného stredu: vezme sa obdĺžnik tesne ohraničujúci útvar a určí sa jeho stred – čiže „stred hraníc.“

Parametre:

objekt1 – objekt, ktorého súradnice sa berú do úvahy

tvar2 – tvar Javy (Shape), ktorého stred hraníc sa berie do úvahy

Návratová hodnota:

vzájomná vzdialenosť medzi zadaným objektom a stredom hraníc zadaného tvaru

Pozri tiež:

GRobot.vzdialenosť(), vzdialenosť(double, double, Shape)

vzdialenost

public static double vzdialenost(Poloha objekt1,
                                 Shape tvar2)

Alias pre vzdialenosť.

smer
```
public static double smer(double súradnicaBoduX,
                          double súradnicaBoduY)
```
Zistí uhol (smer) zvieraný medzi osou x a priamkou vedúcou stredom súradnicovej sústavy a zadaným bodom.

Parametre:

súradnicaBoduX – x-ová súradnica určujúceho bodu

súradnicaBoduY – y-ová súradnica určujúceho bodu

Návratová hodnota:

uhol (smer) medzi osou x a priamkou určenou stredom súradnicovej sústavy a zadaným bodom

Pozri tiež:

GRobot.smerNa(double, double), smer(Poloha), smer(Shape)

smer
```
public static double smer(Poloha objekt)
```
Zistí uhol (smer) zvieraný medzi osou x a priamkou vedúcou stredom súradnicovej sústavy a bodom určeným polohou zadaného objektu.

Parametre:

objekt – objekt, ktorého poloha učuje súradnice určujúceho bodu priamky

Návratová hodnota:

uhol (smer) medzi osou x a priamkou určenou stredom súradnicovej sústavy a bodom určeným polohou zadaného objektu

Pozri tiež:

GRobot.smerNa(Poloha), smer(double, double), smer(Shape)

smer
```
public static double smer(Shape tvar)
```
Zistí uhol (smer) zvieraný medzi osou x a priamkou vedúcou stredom súradnicovej sústavy a bodom určeným polohou stredu hraníc^[1] zadaného tvaru.

[1] – nejde presne o stred útvaru; je použitý najrýchlejší a najjednoduchší spôsob zistenia približného stredu: vezme sa obdĺžnik tesne ohraničujúci útvar a určí sa jeho stred – čiže „stred hraníc.“

Parametre:

objekt – tvar Javy (Shape), ktorého stred hraníc učuje súradnice určujúceho bodu priamky

Návratová hodnota:

uhol (smer) medzi osou x a priamkou určenou stredom súradnicovej sústavy a bodom určeným stredom hraníc zadaného tvaru Javy

Pozri tiež:

GRobot.smerNa(Shape), smer(double, double), smer(Poloha)

smer
```
public static double smer(double súradnicaBoduX1,
                          double súradnicaBoduY1,
                          double súradnicaBoduX2,
                          double súradnicaBoduY2)
```
Zistí uhol (smer) zvieraný medzi osou x a priamkou vedúcou zadanými bodmi.

Parametre:

súradnicaBoduX1 – x-ová súradnica prvého bodu

súradnicaBoduY1 – y-ová súradnica prvého bodu

súradnicaBoduX2 – x-ová súradnica druhého bodu

súradnicaBoduY2 – y-ová súradnica druhého bodu

Návratová hodnota:

uhol (smer) medzi osou x a priamkou vedúcou zadanými bodmi

Pozri tiež:

GRobot.smerNa(double, double), smer(Poloha, Poloha), smer(Shape, Shape)

smer
```
public static double smer(Poloha objekt1,
                          Poloha objekt2)
```
Zistí uhol (smer) zvieraný medzi osou x a priamkou vedúcou bodmi zadanými vo forme polôh objektov.

Parametre:

objekt1 – prvý objekt, ktorého súradnice sa berú do úvahy

objekt2 – druhý objekt, ktorého súradnice sa berú do úvahy

Návratová hodnota:

uhol (smer) medzi osou x a priamkou vedúcou zadanými bodmi

Pozri tiež:

GRobot.smerNa(Poloha), smer(double, double, double, double), smer(Shape, Shape)

smer
```
public static double smer(Shape tvar1,
                          Shape tvar2)
```
Zistí uhol (smer) zvieraný medzi osou x a priamkou vedúcou bodmi vypočítanými zo stredov hraníc^[1] zadaných tvarov Javy.

[1] – nejde presne o stred útvarov; je použitý najrýchlejší a najjednoduchší spôsob zistenia približného stredu: vezme sa obdĺžnik tesne ohraničujúci útvar a určí sa jeho stred – čiže „stred hraníc.“

Parametre:

tvar1 – prvý tvar Javy (Shape), ktorého stred hraníc sa berie do úvahy

tvar2 – druhý tvar Javy (Shape), ktorého stred hraníc sa berie do úvahy

Návratová hodnota:

uhol (smer) medzi osou x a priamkou vedúcou zadanými bodmi

Pozri tiež:

GRobot.smerNa(Shape), smer(double, double, double, double), smer(Poloha, Poloha)

smer
```
public static double smer(Poloha objekt1,
                          double súradnicaBoduX2,
                          double súradnicaBoduY2)
```
Zistí uhol (smer) zvieraný medzi osou x a priamkou vedúcou bodmi určenými polohou zadaného objektu a zadanými súradnicami.

Parametre:

objekt1 – objekt, ktorého súradnice sa berú do úvahy

súradnicaBoduX2 – x-ová súradnica druhého bodu

súradnicaBoduY2 – y-ová súradnica druhého bodu

Návratová hodnota:

uhol (smer) medzi osou x a určenou priamkou

Pozri tiež:

GRobot.smerNa(Poloha), smer(Shape, double, double)

smer
```
public static double smer(Shape tvar1,
                          double súradnicaBoduX2,
                          double súradnicaBoduY2)
```
Zistí uhol (smer) zvieraný medzi osou x a priamkou vedúcou bodmi určenými stredom hraníc^[1] zadaného tvaru Javy a zadanými súradnicami.

[1] – nejde presne o stred útvaru; je použitý najrýchlejší a najjednoduchší spôsob zistenia približného stredu: vezme sa obdĺžnik tesne ohraničujúci útvar a určí sa jeho stred – čiže „stred hraníc.“

Parametre:

tvar1 – tvar Javy (Shape), ktorého stred hraníc sa berie do úvahy

súradnicaBoduX2 – x-ová súradnica druhého bodu

súradnicaBoduY2 – y-ová súradnica druhého bodu

Návratová hodnota:

uhol (smer) medzi osou x a určenou priamkou

Pozri tiež:

GRobot.smerNa(Shape), smer(Poloha, double, double)

smer
```
public static double smer(double súradnicaBoduX1,
                          double súradnicaBoduY1,
                          Poloha objekt2)
```
Zistí uhol (smer) zvieraný medzi osou x a priamkou vedúcou bodmi určenými zadanými súradnicami a polohou zadaného objektu.

Parametre:

súradnicaBoduX1 – x-ová súradnica prvého bodu

súradnicaBoduY1 – y-ová súradnica prvého bodu

objekt2 – objekt, ktorého súradnice sa berú do úvahy

Návratová hodnota:

uhol (smer) medzi osou x a určenou priamkou

Pozri tiež:

GRobot.smerNa(Poloha), smer(Shape, Poloha)

smer
```
public static double smer(Shape tvar1,
                          Poloha objekt2)
```
Zistí uhol (smer) zvieraný medzi osou x a priamkou vedúcou bodmi určenými stredom hraníc^[1] zadaného tvaru Javy a polohou zadaného objektu.

[1] – nejde presne o stred útvaru; je použitý najrýchlejší a najjednoduchší spôsob zistenia približného stredu: vezme sa obdĺžnik tesne ohraničujúci útvar a určí sa jeho stred – čiže „stred hraníc.“

Parametre:

tvar1 – tvar Javy (Shape), ktorého stred hraníc sa berie do úvahy

objekt2 – objekt, ktorého súradnice sa berú do úvahy

Návratová hodnota:

uhol (smer) medzi osou x a určenou priamkou

Pozri tiež:

GRobot.smerNa(Poloha), smer(double, double, Poloha)

smer
```
public static double smer(double súradnicaBoduX1,
                          double súradnicaBoduY1,
                          Shape tvar2)
```
Zistí uhol (smer) zvieraný medzi osou x a priamkou vedúcou bodmi určenými zadanými súradnicami a stredom hraníc^[1] zadaného tvaru Javy.

[1] – nejde presne o stred útvaru; je použitý najrýchlejší a najjednoduchší spôsob zistenia približného stredu: vezme sa obdĺžnik tesne ohraničujúci útvar a určí sa jeho stred – čiže „stred hraníc.“

Parametre:

súradnicaBoduX1 – x-ová súradnica bodu

súradnicaBoduY1 – y-ová súradnica bodu

tvar2 – tvar Javy (Shape), ktorého stred hraníc sa berie do úvahy

Návratová hodnota:

uhol (smer) medzi osou x a určenou priamkou

Pozri tiež:

GRobot.smerNa(Shape), smer(Poloha, Shape)

smer
```
public static double smer(Poloha objekt1,
                          Shape tvar2)
```
Zistí uhol (smer) zvieraný medzi osou x a priamkou vedúcou bodmi určenými polohou zadaného objektu a stredom hraníc^[1] zadaného tvaru Javy.

[1] – nejde presne o stred útvaru; je použitý najrýchlejší a najjednoduchší spôsob zistenia približného stredu: vezme sa obdĺžnik tesne ohraničujúci útvar a určí sa jeho stred – čiže „stred hraníc.“

Parametre:

objekt1 – objekt, ktorého súradnice sa berú do úvahy

tvar2 – tvar Javy (Shape), ktorého stred hraníc sa berie do úvahy

Návratová hodnota:

uhol (smer) medzi osou x a určenou priamkou

Pozri tiež:

GRobot.smerNa(Shape), smer(double, double, Shape)

uhol
```
public static double uhol(double súradnicaBoduX,
                          double súradnicaBoduY)
```
Zistí uhol zvieraný medzi osou x a priamkou vedúcou stredom súradnicovej sústavy a zadaným bodom.

Parametre:

súradnicaBoduX – x-ová súradnica určujúceho bodu

súradnicaBoduY – y-ová súradnica určujúceho bodu

Návratová hodnota:

uhol medzi osou x a priamkou určenou stredom súradnicovej sústavy a zadaným bodom

Pozri tiež:

GRobot.smerNa(double, double), uhol(Poloha), uhol(Shape)

uhol
```
public static double uhol(Poloha objekt)
```
Zistí uhol zvieraný medzi osou x a priamkou vedúcou stredom súradnicovej sústavy a bodom určeným polohou zadaného objektu.

Parametre:

objekt – objekt, ktorého poloha učuje súradnice určujúceho bodu priamky

Návratová hodnota:

uhol medzi osou x a priamkou určenou stredom súradnicovej sústavy a bodom určeným polohou zadaného objektu

Pozri tiež:

GRobot.smerNa(Poloha), uhol(double, double), uhol(Shape)

uhol
```
public static double uhol(Shape tvar)
```
Zistí uhol zvieraný medzi osou x a priamkou vedúcou stredom súradnicovej sústavy a bodom určeným polohou stredu hraníc^[1] zadaného tvaru.

[1] – nejde presne o stred útvaru; je použitý najrýchlejší a najjednoduchší spôsob zistenia približného stredu: vezme sa obdĺžnik tesne ohraničujúci útvar a určí sa jeho stred – čiže „stred hraníc.“

Parametre:

objekt – tvar Javy (Shape), ktorého stred hraníc učuje súradnice určujúceho bodu priamky

Návratová hodnota:

uhol medzi osou x a priamkou určenou stredom súradnicovej sústavy a bodom určeným stredom hraníc zadaného tvaru Javy

Pozri tiež:

GRobot.smerNa(Shape), uhol(double, double), uhol(Poloha)

uhol
```
public static double uhol(double súradnicaBoduX1,
                          double súradnicaBoduY1,
                          double súradnicaBoduX2,
                          double súradnicaBoduY2)
```
Zistí uhol zvieraný medzi osou x a priamkou vedúcou zadanými bodmi.

Parametre:

súradnicaBoduX1 – x-ová súradnica prvého bodu

súradnicaBoduY1 – y-ová súradnica prvého bodu

súradnicaBoduX2 – x-ová súradnica druhého bodu

súradnicaBoduY2 – y-ová súradnica druhého bodu

Návratová hodnota:

uhol medzi osou x a priamkou vedúcou zadanými bodmi

Pozri tiež:

GRobot.smerNa(double, double), uhol(Poloha, Poloha), uhol(Shape, Shape)

uhol
```
public static double uhol(Poloha objekt1,
                          Poloha objekt2)
```
Zistí uhol zvieraný medzi osou x a priamkou vedúcou bodmi zadanými vo forme polôh objektov.

Parametre:

objekt1 – prvý objekt, ktorého súradnice sa berú do úvahy

objekt2 – druhý objekt, ktorého súradnice sa berú do úvahy

Návratová hodnota:

uhol medzi osou x a priamkou vedúcou zadanými bodmi

Pozri tiež:

GRobot.smerNa(Poloha), uhol(double, double, double, double), uhol(Shape, Shape)

uhol
```
public static double uhol(Shape tvar1,
                          Shape tvar2)
```
Zistí uhol zvieraný medzi osou x a priamkou vedúcou bodmi vypočítanými zo stredov hraníc^[1] zadaných tvarov Javy.

[1] – nejde presne o stred útvarov; je použitý najrýchlejší a najjednoduchší spôsob zistenia približného stredu: vezme sa obdĺžnik tesne ohraničujúci útvar a určí sa jeho stred – čiže „stred hraníc.“

Parametre:

tvar1 – prvý tvar Javy (Shape), ktorého stred hraníc sa berie do úvahy

tvar2 – druhý tvar Javy (Shape), ktorého stred hraníc sa berie do úvahy

Návratová hodnota:

uhol medzi osou x a priamkou vedúcou zadanými bodmi

Pozri tiež:

GRobot.smerNa(Shape), uhol(double, double, double, double), uhol(Poloha, Poloha)

uhol
```
public static double uhol(Poloha objekt1,
                          double súradnicaBoduX2,
                          double súradnicaBoduY2)
```
Zistí uhol zvieraný medzi osou x a priamkou vedúcou bodmi určenými polohou zadaného objektu a zadanými súradnicami.

Parametre:

objekt1 – objekt, ktorého súradnice sa berú do úvahy

súradnicaBoduX2 – x-ová súradnica druhého bodu

súradnicaBoduY2 – y-ová súradnica druhého bodu

Návratová hodnota:

uhol medzi osou x a určenou priamkou

Pozri tiež:

GRobot.smerNa(double, double), uhol(Shape, double, double)

uhol
```
public static double uhol(Shape tvar1,
                          double súradnicaBoduX2,
                          double súradnicaBoduY2)
```
Zistí uhol zvieraný medzi osou x a priamkou vedúcou bodmi určenými stredom hraníc^[1] zadaného tvaru Javy a zadanými súradnicami.

[1] – nejde presne o stred útvaru; je použitý najrýchlejší a najjednoduchší spôsob zistenia približného stredu: vezme sa obdĺžnik tesne ohraničujúci útvar a určí sa jeho stred – čiže „stred hraníc.“

Parametre:

tvar1 – tvar Javy (Shape), ktorého stred hraníc sa berie do úvahy

súradnicaBoduX2 – x-ová súradnica druhého bodu

súradnicaBoduY2 – y-ová súradnica druhého bodu

Návratová hodnota:

uhol medzi osou x a určenou priamkou

Pozri tiež:

GRobot.smerNa(double, double), uhol(Poloha, double, double)

uhol
```
public static double uhol(double súradnicaBoduX1,
                          double súradnicaBoduY1,
                          Poloha objekt2)
```
Zistí uhol zvieraný medzi osou x a priamkou vedúcou bodmi určenými zadanými súradnicami a polohou zadaného objektu.

Parametre:

súradnicaBoduX1 – x-ová súradnica prvého bodu

súradnicaBoduY1 – y-ová súradnica prvého bodu

objekt2 – objekt, ktorého súradnice sa berú do úvahy

Návratová hodnota:

uhol medzi osou x a určenou priamkou

Pozri tiež:

GRobot.smerNa(Poloha), uhol(Shape, Poloha)

uhol
```
public static double uhol(Shape tvar1,
                          Poloha objekt2)
```
Zistí uhol zvieraný medzi osou x a priamkou vedúcou bodmi určenými stredom hraníc^[1] zadaného tvaru Javy a polohou zadaného objektu.

[1] – nejde presne o stred útvaru; je použitý najrýchlejší a najjednoduchší spôsob zistenia približného stredu: vezme sa obdĺžnik tesne ohraničujúci útvar a určí sa jeho stred – čiže „stred hraníc.“

Parametre:

tvar1 – tvar Javy (Shape), ktorého stred hraníc sa berie do úvahy

objekt2 – objekt, ktorého súradnice sa berú do úvahy

Návratová hodnota:

uhol medzi osou x a určenou priamkou

Pozri tiež:

GRobot.smerNa(Poloha), uhol(double, double, Poloha)

uhol
```
public static double uhol(double súradnicaBoduX1,
                          double súradnicaBoduY1,
                          Shape tvar2)
```
Zistí uhol zvieraný medzi osou x a priamkou vedúcou bodmi určenými zadanými súradnicami a stredom hraníc^[1] zadaného tvaru Javy.

[1] – nejde presne o stred útvaru; je použitý najrýchlejší a najjednoduchší spôsob zistenia približného stredu: vezme sa obdĺžnik tesne ohraničujúci útvar a určí sa jeho stred – čiže „stred hraníc.“

Parametre:

súradnicaBoduX1 – x-ová súradnica bodu

súradnicaBoduY1 – y-ová súradnica bodu

tvar2 – tvar Javy (Shape), ktorého stred hraníc sa berie do úvahy

Návratová hodnota:

uhol medzi osou x a určenou priamkou

Pozri tiež:

GRobot.smerNa(Shape), uhol(Poloha, Shape)

uhol
```
public static double uhol(Poloha objekt1,
                          Shape tvar2)
```
Zistí uhol zvieraný medzi osou x a priamkou vedúcou bodmi určenými polohou zadaného objektu a stredom hraníc^[1] zadaného tvaru Javy.

[1] – nejde presne o stred útvaru; je použitý najrýchlejší a najjednoduchší spôsob zistenia približného stredu: vezme sa obdĺžnik tesne ohraničujúci útvar a určí sa jeho stred – čiže „stred hraníc.“

Parametre:

objekt1 – objekt, ktorého súradnice sa berú do úvahy

tvar2 – tvar Javy (Shape), ktorého stred hraníc sa berie do úvahy

Návratová hodnota:

uhol medzi osou x a určenou priamkou

Pozri tiež:

GRobot.smerNa(Shape), uhol(double, double, Shape)

resetujRaster
```
public static void resetujRaster()
```
Zresetuje raster sveta – úplne vyčistí jeho obsah. Táto funkcia je využiteľná len v špeciálnych prípadoch – pozri metódu prenes(inéOkno, tam).

vymaž
```
public static void vymaž()
```
Vymaže obsah sveta. Má rovnaký efekt, ako keby sme za sebou spustili metódy podlaha.vymaž() a strop.vymaž().

vymaz
```
public static void vymaz()
```
Alias pre vymaž.

vymažTexty
```
public static void vymažTexty()
```
Vymaže texty podlahy a stropu. Má rovnaký efekt, ako keby sme za sebou spustili metódy podlaha.vymažTexty() a strop.vymažTexty().

vymazTexty
```
public static void vymazTexty()
```
Alias pre vymažTexty.

vymažGrafiku
```
public static void vymažGrafiku()
```
Vymaže plátno podlahy a stropu. Má rovnaký efekt, ako keby sme za sebou spustili metódy podlaha.vymažGrafiku() a strop.vymažGrafiku().

vymazGrafiku
```
public static void vymazGrafiku()
```
Alias pre vymažGrafiku.

povoľViacnásobnúObsluhuUdalostí
```
public static void povoľViacnásobnúObsluhuUdalostí()
```
Po spustení tejto metódy bude možné vytváranie viacerých verzií obsluhy udalostí, ktoré môžu byť neskôr podľa potreby uvedené do činnosti metódou presmerujObsluhuUdalostí. Vždy môže byť v činnosti len jedna obsluha udalostí. Vytváranie viacerých inštancií triedy ObsluhaUdalostí (resp. inštancií odvodených tried) je predvolene zakázané, aby nedochádzalo k omylom. Po povolení tvorby viacerých inštancií obsluhy udalostí zostáva aktívna prvá vytvorená inštancia, dokedy tok udalostí nepresmerujeme do inej metódou presmerujObsluhuUdalostí.

Upozornenie: Pri povoľovaní viacnásobnej obsluhy musíme dobre rozumieť mechanizmu spracovania udalostí. Nemali by sme ju povoliť bezdôvodne. Príkadom takého dôvodu môže byť potreba využitia odlišnej skupiny udalostí v rôznych situáciách hry, ktorú programujeme napríklad keď hráč vstúpi do hlavnej ponuky hry, má obsluha udalostí fungovať ináč, než keď hráč aktívne hrá hru…

Príklad, ktorý používa zapnutie viacnásobného spracovania udalostí je pri opise metódy presmerujObsluhuUdalostí.

Pozri tiež:

ObsluhaUdalostí, presmerujObsluhuUdalostí(ObsluhaUdalostí)

povolViacnasobnuObsluhuUdalosti
```
public static void povolViacnasobnuObsluhuUdalosti()
```
Alias pre povoľViacnásobnúObsluhuUdalostí.

presmerujObsluhuUdalostí

public static void presmerujObsluhuUdalostí(ObsluhaUdalostí obsluha)

Presmeruje spracovanie udalostí do inej inštancie triedy ObsluhaUdalostí. Použitie tejto metódy má význam len po povolení vytvárania viacerých inštancií obsluhy udalostí (čo je predvolene zakázané). Po použití metódy presmerujObsluhuUdalostí sú ďalšie vznikajúce udalosti presmerované do zadanej inštancie obsluha. Táto akcia automaticky vyradí z činnosti predchádzajúcu inštanciu obsluhy udalostí, z čoho vyplýva, že v činnosti môže byť vždy len jedna obsluha udalostí.

Príklad:

V tomto príklade sú definované dve obsluhy udalostí. Obidve definujú spracovanie udalosti kliku myšou. Príklad je demonštratívny. Po prvom kliku je (popri zobrazení robota, vymazaní a zmeny pozadia sveta) presmerovaný tok udalostí do druhej verzie obsluhy udalostí, ktorá má na starosti jediné: upravovať cieľ cesty hlavného robota…

import knižnica.*;

public class ViacnásobnáObsluhaUdalostí extends GRobot
{
    private ObsluhaUdalostí obsluha1, obsluha2;

    private ViacnásobnáObsluhaUdalostí()
    {
        // Napísanie bieleho textu
        farba(biela);
        text("…kliknite myšou…");

        // Nastavenie vlastností hlavného robota
        farba(200, 0, 0, 100);
        skry();
        veľkosť(30);
        zdvihniPero();
        hrúbkaČiary(3);
        zrýchlenie(0.5, false);
        maximálnaRýchlosť(20);
        rýchlosťOtáčania(5, false);

        // Prvá verzia obsluhy udalostí
        obsluha1 = new ObsluhaUdalostí()
        {
            @Override public void klik()
            {
                zobraz();
                Svet.vymaž();
                Svet.farbaPozadia(svetlotyrkysová.svetlejšia());
                Svet.presmerujObsluhuUdalostí(obsluha2);
            }
        };

        // Najneskôr tu musíme povoliť viacnásobnú obsluhu udalostí…
        // …inak nasledujúci príkaz „new ObsluhaUdalostí“ zlyhá.
        Svet.povoľViacnásobnúObsluhuUdalostí();

        // Druhá verzia obsluhy udalostí
        obsluha2 = new ObsluhaUdalostí()
        {
            @Override public void klik()
            {
                cieľNaMyš();
            }
        };

        // Nastavenie vlastností sveta
        Svet.farbaPozadia(čierna);
        Svet.upevni();
        Svet.zbaľ();
    }
    
    public static void main(String[] args)
    {
        new ViacnásobnáObsluhaUdalostí();
    }
}

Výsledok:

Fáza 1 – pred prvým kliknutím je robot skrytý
(plátno na obrázku je zmenšené).

Fáza 2 – po prvom kliknutí sa robot zobrazí
a potom smeruje do cieľa určeného ďalším
klikom; každý ďalší klik určí nový cieľ
(plátno na obrázku je zmenšené).

Parametre:: obsluha – inštancia obsluhy udalostí, do ktorej budú presmerované ďalšie udalosti spracúvané svetom grafického robota
Pozri tiež:: ObsluhaUdalostí, povoľViacnásobnúObsluhuUdalostí()

presmerujObsluhuUdalosti

public static void presmerujObsluhuUdalosti(ObsluhaUdalostí obsluha)

Alias pre presmerujObsluhuUdalostí.

aktívnaObsluhaUdalostí
```
public static ObsluhaUdalostí aktívnaObsluhaUdalostí()
```
Táto metóda slúži na získanie aktívnej inštancie obsluhy udalostí. Je užitočná v súvislosti s možnosťou povolenia viacnásobnej obsluhy udalostí. Ak obsluha udalostí nebola definovaná, prípadne nie je z nejakého dôvodu aktívna žiadna z jestvujúcich inštancií obsluhy udalostí, tak metóda vráti hodnotu null.

Návratová hodnota:

aktívna inštancia obsluhy udalostí alebo null

Pozri tiež:

ObsluhaUdalostí.aktívna()

aktivnaObsluhuUdalosti

public static ObsluhaUdalosti aktivnaObsluhuUdalosti()

Alias pre aktívnaObsluhaUdalostí.

vyplň
```
public static void vyplň(Color farba)
```
Vyplní podlahu zadanou farbou, ktorá prekryje aj farbu pozadia sveta. Má rovnaký efekt, ako keby sme volali metódu podlaha.vyplň(farba).

Parametre:

farba – objekt určujúci farbu výplne podlahy

Pozri tiež:

vymaž()

vypln

public static void vypln(Color farba)

Alias pre vyplň.

vyplň
```
public static void vyplň(Farebnosť objekt)
```
Vyplní podlahu farbou zadaného objektu, ktorá prekryje aj farbu pozadia sveta. Má rovnaký efekt, ako keby sme volali metódu podlaha.vyplň(farba).

Parametre:

objekt – objekt určujúci farbu výplne podlahy

Pozri tiež:

vymaž()

vypln

public static void vypln(Farebnosť objekt)

Alias pre vyplň.

vyplň
```
public static Farba vyplň(int r,
                          int g,
                          int b)
```
Vyplní podlahu farbou zadanou prostredníctvom farebných zložiek. Má rovnaký efekt, ako keby sme volali metódu podlaha.vyplň(r, g, b).

Parametre:

r – červená zložka farby; celé číslo v rozsahu 0 – 255

g – zelená zložka farby; celé číslo v rozsahu 0 – 255

b – modrá zložka farby; celé číslo v rozsahu 0 – 255

Návratová hodnota:

objekt typu Farba vytvorený podľa zadaných zložiek

Pozri tiež:

vyplň(Color)

vypln

public static Farba vypln(int r,
                          int g,
                          int b)

Alias pre vyplň.

vyplň
```
public static Farba vyplň(int r,
                          int g,
                          int b,
                          int a)
```
Vyplní podlahu farbou zadanou prostredníctvom farebných zložiek a úrovne priehľadnosti. Má rovnaký efekt, ako keby sme volali metódu podlaha.vyplň(r, g, b, a).

Parametre:

r – červená zložka farby; celé číslo v rozsahu 0 – 255

g – zelená zložka farby; celé číslo v rozsahu 0 – 255

b – modrá zložka farby; celé číslo v rozsahu 0 – 255

a – úroveň (ne)priehľadnosti farby; celé číslo v rozsahu 0 – 255 (0 – neviditeľná farba; 255 – nepriehľadná farba)

Návratová hodnota:

objekt typu Farba vytvorený podľa zadaných hodnôt parametrov

Pozri tiež:

vyplň(Color)

vypln

public static Farba vypln(int r,
                          int g,
                          int b,
                          int a)

Alias pre vyplň.

vyplň
```
public static void vyplň(String súbor)
```
Vyplní podlahu zadanou textúrou. Textúra je súbor s obrázkom, ktorý bude použitý na dlaždicové vyplnenie plochy podlahy. Má rovnaký efekt, ako keby sme volali metódu podlaha.vyplň(súbor).

Poznámka: Parametre textúry sa dajú ovplyvňovať špeciálnymi príkazmi. Súvisí s nimi i predvolené správanie príkazov vypĺňania. Predvolený bod začiatku vypĺňania dlaždicami sa nachádza v strede plátna alebo vypĺňaného obrázka. Pozrite si aj opis metódy posunutieVýplne, kde nájdete príklad použitia a odkazy na metódy upravujúce ďalšie parametre obrázkových výplní.

Parametre:

súbor – názov súboru s obrázkom textúry

Výnimky:

GRobotException – ak súbor s obrázkom nebol nájdený

Pozri tiež:

vyplň(Color), priečinokObrázkov(String)

vypln

public static void vypln(String súbor)

Alias pre vyplň.

vyplň
```
public static void vyplň(Image výplň)
```
Vyplní podlahu zadanou textúrou. Textúra je obrázok (objekt typu Image alebo odvodený), ktorý bude použitý na dlaždicové vyplnenie plochy podlahy. Má rovnaký efekt, ako keby sme volali metódu podlaha.vyplň(obrázok).

Poznámka: Parametre textúry sa dajú ovplyvňovať špeciálnymi príkazmi. Súvisí s nimi i predvolené správanie príkazov vypĺňania. Predvolený bod začiatku vypĺňania dlaždicami sa nachádza v strede plátna alebo vypĺňaného obrázka. Pozrite si aj opis metódy posunutieVýplne, kde nájdete príklad použitia a odkazy na metódy upravujúce ďalšie parametre obrázkových výplní.

Parametre:

výplň – obrázok textúry

Pozri tiež:

vyplň(Color)

vypln

public static void vypln(Image výplň)

Alias pre vyplň.

posunutieVýplne

public static Bod posunutieVýplne()

Vráti bod so súradnicami relatívneho posunutia obrázkových dlaždicových výplní.

Príklad:

Tento krátky príklad ukazuje vytvorenie a použitie dialógu na úpravu vybraných parametrov aktuálneho (hlavného) robota.

import knižnica.*;

public class DialógParametrov extends GRobot
{
    private Farba farba = čierna;
    private Bod poloha = stred;
    private Uhol uhol = sever;
    private Rozmer rozmery = new Rozmery(80, 60);

    private DialógParametrov()
    {
        Svet.vypíš(this);
        hrúbkaČiary(1.5);
        aktualizuj();
    }

    private String[] menovky = {"Farba: ", "Poloha: ", null,
        "Uhol: ", "Rozmery: "};

    private void aktualizuj()
    {
        Svet.vymaž();

        Svet.vypíšRiadok(menovky[0], Farba.farbaNaReťazec(farba));
        Svet.vypíšRiadok(menovky[1], Bod.bodNaReťazec(poloha));
        Svet.vypíšRiadok(menovky[3], uhol);
        Svet.vypíšRiadok(menovky[4], Rozmery.rozmeryNaReťazec(rozmery));

        farba(farba);
        poloha(poloha);
        uhol(uhol);
        rozmer(rozmery);
    }

    @Override public void kresliSeba()
    {
        obdĺžnik();
        dopredu();
    }

    @Override public void klik()
    {
        Object[] údaje = {farba, poloha, '\n', uhol, rozmery};

        if (Svet.dialóg(menovky, údaje))
        {
            if (null != údaje[0] && údaje[0] instanceof Farba)
                farba = (Farba)údaje[0];
            if (null != údaje[1] && údaje[1] instanceof Bod)
                poloha = (Bod)údaje[1];
            if (null != údaje[3] && údaje[3] instanceof Uhol)
                uhol = (Uhol)údaje[3];
            if (null != údaje[4] && údaje[4] instanceof Rozmery)
                rozmery = (Rozmery)údaje[4];

            aktualizuj();
        }
    }

    public static void main(String[] args)
    {
        Svet.použiKonfiguráciu("DialógParametrov.cfg");
        new DialógParametrov();
    }
}

Výsledok:

Po spustení aplikácie a kliknutí na plochu sa používateľovi zobrazí dialóg (na obrázku nižšie), v ktorom bude môcť upravovať vybrané parametre aktuálneho robota.

Vzhľad dialógu
parametrov.

Dialóg parametrov v OS Windows.

Návratová hodnota:: objekt typu Bod určujúci súradnice relatívneho posunutia obrázkových dlaždicových výplní
Pozri tiež:: posunutieVýplne(double, double), mierkaVýplne(), otočenieVýplne(), stredOtáčaniaVýplne()

posunutieVyplne
```
public static Bod posunutieVyplne()
```
Alias pre posunutieVýplne.

posunutieVýplne

public static void posunutieVýplne(double x,
                                   double y)

Nastaví relatívne posunutie obrázkových dlaždicových výplní. Každé ďalšie spustenie niektorého z príkazov vypĺňania bude používať novú relatívnu polohu dlaždíc. Predvolené posunutie [0, 0] znamená, že dlaždicová textúra sa začína v strede plátna, čo je platné aj pre vypĺňanie útvarov a oblastí, alebo v strede vypĺňaného obrázka.

Príklad:

Nasledujúci príklad zhŕňa použitie viacerých metód súvisiacich s úpravou parametrov dlaždicových výplní. Príklad si sám vygeneruje textúru, ktorá je predvolene dlaždicovo sa nadpájajúca alebo bezšvová (anglicky tileable alebo seamless), ale môže byť úmyselne pregenerovaná aj tak, aby sa dlaždicovo nenadpájala (aby bolo lepšie vidno jej hranice). Textúrou sú potom vypĺňané rôzne druhy cieľov, vrátane celého plátna. Parametre textúry sa dajú možné dynamicky upravovať myšou.

import knižnica.*;

public class TestVypĺňaniaTextúrou extends GRobot
{
    // Mliečna farba výplne stropu v režime zobrazenia pomocníka
    private final static Farba mliečna = new Farba(1.0, 1.0, 1.0, 0.8);

    // Oblasť, ktorá je jedným z cieľov vypĺňania:
    private Oblasť oblasť;

    // Obrázok, ktorý je ďalším z cieľov vypĺňania:
    private Obrázok obrázok;

    // Obrázok s vygenerovanou výplňou (textúrou):
    private Obrázok textúra;

    // Rôzne nastavenia:
    private boolean bezšvová;
    private boolean zamknuté;
    private boolean upravTextúru;
    private int zobrazPomoc;
    private int cieľVýplne;
    private int typ;

    // Zálohy pre jeden z režimov práce:
    private Poloha zálohaPosunutia;
    private double zálohaPootočenia;

    // Konštruktor.
    private TestVypĺňaniaTextúrou()
    {
        // Úprava rozmerov plátna (volaním nadradeného konštruktora):
        super(1200, 600);

        // Vypnutie automatického prekresľovania:
        Svet.nekresli();

        // Vytvorenie relatívne komplikovaného tvaru oblasti – medzikružie
        // prekryté dvomi pootočenými hviezdami – „jež v obruči“:
        veľkosť(200);
        oblasť = new Oblasť();
        oblasť.pridaj(kruh(veľkosť() * 4.0 / 5.0));
        oblasť.odober(kruh(veľkosť() * 3.0 / 4.0));
        vpravo(18);
        oblasť.pridaj(hviezda());
        vľavo(36);
        oblasť.pridaj(hviezda());
        vpravo(18);
        oblasť.pridaj(kruh(veľkosť() * 2.0 / 3.0));

        // Vytvorenie práznych inštancií obrázkov. Prvá inštancia „obrázok“
        // je jedným z cieľov vypĺňania. Druhá inštancia „textúra“ je výplň
        // použitá na rôzne ciele (podľa nastavenia, ktoré sa dá meniť počas
        // činnosti programu):
        obrázok = new Obrázok(200, 200);
        textúra = new Obrázok(160, 120);
        
        // Vykonanie počiatočných nastavení príkladu:

        bezšvová = true;
        zamknuté = false;
        upravTextúru = true;
        zobrazPomoc = 3;
        cieľVýplne = 2;
        typ = 0;

        vygenerujTextúru();
        vyplňTextúrou();
        pomoc();
        Svet.spustiČasovač();
    }

    // Generovanie textúry aktuálneho typu v aktuálnom režime
    private void vygenerujTextúru()
    {
        // Záloha stavu robota pred generovaním textúry (nesúvisí so zálohou
        // pre jeden z režimov – toto je nezávislá záloha tých vlastností
        // robota, ktoré táto metóda ovplyvňuje):
        Farba zálohaFarby = farba();
        Poloha zálohaPolohy = poloha();
        double zálohaSmeru  = smer();
        double zálohaHrúbky = hrúbkaČiary();

        // Presmerovanie kreslenia robota. Toto je jediná vlastnosť, ktorú
        // metóda nezálohuje poctivo – spoliehame sa na to, že robot bude
        // pred aj po vykonaní tejto metódy kresliť na podlahu (čo je
        // predvolené nastavenie robota):
        kresliDoObrázka(textúra);
        textúra.vymaž();

        // Generovanie textúry aktuálneho typu:
        for (int i = 0; i < 280; ++i)
        {
            // Farba, poloha, smer aj hrúbka čiary sú náhodne zmenené:
            náhodnáFarba();
            náhodnáPoloha();
            náhodnýSmer();
            hrúbkaČiary(Svet.náhodnéReálneČíslo(3, 5));

            if (bezšvová)
            {
                // Ak má byť textúra bezšvová, tak musí byť každá čiara
                // a tvar nakreslený deväť ráz – na aktuálnej pozícii a na
                // ôsmich ďalších pozíciách:
                //  – dvoch posunutých o šírku obrázka vpravo a vľavo,
                //  – dvoch posunutých o výšku obrázka hore a dole
                //  – a štyroch zvyšných diagonálnych smerov podľa rozmerov
                //    textúry.
                // 
                // To je najjednoduchší spôsob ako získať istotu, že ak čiara
                // alebo tvar presahujú v niektorom smere von, tak budú určite
                // nakreslené yak, aby zasahovali do obrázka aj z protiľahlej
                // strany. (Základným predpokladom je, že čiara alebo tvar nie
                // sú niekoľkonásobne väčšie než sú rozmery obrázka. Ak by to
                // tak, nebolo, tak by generovanie bezšvovej textúry bolo
                // komplikovanejšie.)
                // 
                // (Efektívnejším spôsobom, no komplikovanejším na
                // naprogramovanie, by bolo overovať, ktorý okraj alebo okraje
                // obrázka čiara alebo tvar prekročili a podľa toho ich
                // nakresliť pokračujúc z opačnej strany alebo strán.
                // 
                // Ďalšia úroveň spoľahlivosti algoritmu by dokázala overiť aj
                // to, o koľko čiara prípadne tvar prekračujú okraj(e)
                // a zabezpečiť nakreslenie viacnásobného prekročenia hraníc
                // obrázka.
                // 
                // Pri kreslení čiary vo vodorovnom alebo zvislom smere by išlo
                // len o viacnásobné prekreslenie čiary na určitom riadku alebo
                // stĺpci. Výsledný efekt by bol málo viditeľný. No ak by bola
                // čiara nakreslená pod určitým uhlom, tak by dostatočne dlhá
                // vhodne umiestnená čiara dokázala vyšrafovať celú plochu
                // obrázka. No s tým algoritmom, ktorý je použitý tu, by to
                // nefungovalo…
                // 
                // Posledný tip: Ďalším spôsobom, ktorý by ani nemusel byť
                // taký náročný na naprogramovanie, by mohlo byť využitie
                // pretáčania obrázka s textúrou. Ak by tvar alebo čiara,
                // ktoré by mali tvoriť textúru boli vždy menšie než rozmery
                // textúry, tak by stačilo, aby sme vždy nakreslili tvar
                // alebo čiaru presne do stredu textúry a potom ju
                // pretočili o náhodný počet bodov v oboch smeroch – pozri
                // metódu pretoč(Δx, Δy).)

                // Zálohujeme polohu – budeme ju recyklovať ako východiskovú
                // polohu:
                Poloha poloha = poloha();

                // Podľa hodnoty atribútu typ vygenerujeme textúru:
                switch (typ % 3)
                {
                case 1: // krúžky – kružnice kreslené hrubšou čiarou
                    {
                        // (Vtáčie zátvorky sú tu preto, aby sme mohli
                        // v rámci jednej vetvy, presnejšie v rámci
                        // zátvoriek, definovať lokálne premenné.)

                        // Vygenerujeme veľkosť:
                        double veľkosť = Svet.náhodnéReálneČíslo(3, 12);
                        // Nakreslíme strednú kružnicu:
                        kružnica(veľkosť);

                        // Presunieme sa do východiskovej polohy, posunieme
                        // sa doľava o šírku textúry a nakreslíme ďalšiu
                        // kružnicu:
                        skočNa(poloha);
                        skoč(-textúra.šírka, 0);
                        kružnica(veľkosť);

                        // (Podobne doprava.)
                        skočNa(poloha);
                        skoč(textúra.šírka, 0);
                        kružnica(veľkosť);

                        // (Hore.)
                        skočNa(poloha);
                        skoč(0, -textúra.výška);
                        kružnica(veľkosť);

                        // (Dole.)
                        skočNa(poloha);
                        skoč(0, textúra.výška);
                        kružnica(veľkosť);

                        // (Vľavo dole.)
                        skočNa(poloha);
                        skoč(-textúra.šírka, -textúra.výška);
                        kružnica(veľkosť);

                        // (Vľavo hore.)
                        skočNa(poloha);
                        skoč(-textúra.šírka, textúra.výška);
                        kružnica(veľkosť);

                        // (Vpravo dole.)
                        skočNa(poloha);
                        skoč(textúra.šírka, -textúra.výška);
                        kružnica(veľkosť);

                        // (Vpravo hore.)
                        skočNa(poloha);
                        skoč(textúra.šírka, textúra.výška);
                        kružnica(veľkosť);
                    }
                    break;

                case 2: // čiarky
                    {
                        // (Princíp je rovnaký ako pri krúžkoch vyššie, ale
                        // vygenerovaná hodnota je použitá ako dĺžka čiary.)
                        double dĺžka = Svet.náhodnéReálneČíslo(60, 100);
                        dopredu(dĺžka);

                        skočNa(poloha);
                        skoč(-textúra.šírka, 0);
                        dopredu(dĺžka);

                        skočNa(poloha);
                        skoč(textúra.šírka, 0);
                        dopredu(dĺžka);

                        skočNa(poloha);
                        skoč(0, -textúra.výška);
                        dopredu(dĺžka);

                        skočNa(poloha);
                        skoč(0, textúra.výška);
                        dopredu(dĺžka);

                        skočNa(poloha);
                        skoč(-textúra.šírka, -textúra.výška);
                        dopredu(dĺžka);

                        skočNa(poloha);
                        skoč(-textúra.šírka, textúra.výška);
                        dopredu(dĺžka);

                        skočNa(poloha);
                        skoč(textúra.šírka, -textúra.výška);
                        dopredu(dĺžka);

                        skočNa(poloha);
                        skoč(textúra.šírka, textúra.výška);
                        dopredu(dĺžka);
                    }
                    break;

                default: // plné kruhy
                    {
                        // (Princíp je rovnaký ako pri krúžkoch vyššie,
                        // len sú kreslené plné kruhy.)
                        double veľkosť = Svet.náhodnéReálneČíslo(3, 12);
                        kruh(veľkosť);

                        skočNa(poloha);
                        skoč(-textúra.šírka, 0);
                        kruh(veľkosť);

                        skočNa(poloha);
                        skoč(textúra.šírka, 0);
                        kruh(veľkosť);

                        skočNa(poloha);
                        skoč(0, -textúra.výška);
                        kruh(veľkosť);

                        skočNa(poloha);
                        skoč(0, textúra.výška);
                        kruh(veľkosť);

                        skočNa(poloha);
                        skoč(-textúra.šírka, -textúra.výška);
                        kruh(veľkosť);

                        skočNa(poloha);
                        skoč(-textúra.šírka, textúra.výška);
                        kruh(veľkosť);

                        skočNa(poloha);
                        skoč(textúra.šírka, -textúra.výška);
                        kruh(veľkosť);

                        skočNa(poloha);
                        skoč(textúra.šírka, textúra.výška);
                        kruh(veľkosť);
                    }
                }
            }
            else
            {
                // V režime švovej textúry kreslíme každý tvar len raz:
                switch (typ % 3)
                {
                case 1:
                    kružnica(Svet.náhodnéReálneČíslo(3, 12));
                    break;

                case 2:
                    dopredu(Svet.náhodnéReálneČíslo(60, 100));
                    break;

                default:
                    kruh(Svet.náhodnéReálneČíslo(3, 12));
                }
            }
        }

        // Presmerujeme kreslenie späť na podlahu:
        kresliNaPodlahu();

        // Vrátenie zálohy vykonanej na začiatku tejto metódy:
        farba(zálohaFarby);
        skočNa(zálohaPolohy);
        smer(zálohaSmeru);
        hrúbkaČiary(zálohaHrúbky);
    }

    // Vyplnenie aktuálneho cieľa vypĺňania textúrou
    private void vyplňTextúrou()
    {
        // Vymazanie grafiky podlahy:
        podlaha.vymažGrafiku();

        if (zamknuté)
        {
            // Ak je posúvanie a otáčanie textúry zamknuté, tak vykonáme
            // posunutie a otočenie výplne podľa aktuálnych parametrov robota
            // (zaujímavo sa to prejaví na vypĺňanom obrázku, ktorý pracuje
            // akoby so samostatnou súradnicovou sústavou):
            Svet.posunutieVýplne(this);
            Svet.pootočenieVýplne(this);
        }

        // Podľa cieľa výplne prekreslíme požadovanú súčasť (vždy použijeme
        // príkaz vyplň tej ktorej súčasti, aby bolo vidno výsledok
        // s aktuálnymi parametrami textúry):
        switch (cieľVýplne)
        {
        case 0:
            obrázok.vymaž();
            obrázok.vyplň(textúra);
            obrázok(obrázok, 1.0);
            break;

        case 1:
            // Kreslenie tvarov nie je vypnuté, preto sa hviezda zároveň
            // nakreslí na plochu plátna aktuálnou hrúbkou a farbou čiary.
            vyplňTvar(hviezda(), textúra);
            break;

        case 2:
            vyplňOblasť(oblasť, textúra);
            break;

        case 3:
            podlaha.vyplň(textúra);
            break;
        }
    }

    // Výpis obsahu elektronického pomocníka
    private void pomoc()
    {
        strop.vymažTexty();
        strop.vymažGrafiku();

        if (zobrazPomoc > 0)
        {
            strop.vyplň(mliečna);

            int zobrazenie = (zobrazPomoc - 1) % 3;

            if (zobrazenie >= 2)
            {
                Svet.vypíšRiadok("Medzerníkom prepnete medzi režimom úprav (transformácie) textúry a tvaru.");
                Svet.vypíšRiadok("Enterom sa prepnete medzi režimom zamknutého alebo voľného posunu a otáčania textúry s tvarom.");
                Svet.vypíšRiadok("Klávesom F1 zobrazíte tohto pomocníka (viacnásobné stlačenie prepína mieru zobrazených informácií).");
                Svet.vypíšRiadok("Klávesom Escape skryjete pomocníka.");
                Svet.vypíšRiadok("Klávesy 1 až 4 prepínajú ciele vypĺňania: obrázok, tvar hviezdy, oblasť ježa v obruči a celú plochu podlahy. (Všímajte si odlišnosti.)");
                Svet.vypíšRiadok("Kláves F prepne na ďalší typ textúry a vygeneruje novú náhodnú textúru (v aktuálnom režime).");
                Svet.vypíšRiadok("Kláves G vygeneruje novú náhodnú textúru aktuálneho typu v aktuálnom režime.");
                Svet.vypíšRiadok("Kláves H prepne medzi režimom bezšvovej a švovej textúry a vygeneruje novú náhodnú textúru (aktuálneho typu).", riadok);
            }

            if (zobrazenie >= 1)
            {
                Svet.vypíšRiadok("Kliknutím alebo ťahaním niektorým tlačidlom myši vykonáte jednu z nasledujúcich akcií s tvarom (v režime úprav tvaru):");
                Svet.vypíšRiadok(" — ľavé tlačidlo: posunutie tvaru,");
                Svet.vypíšRiadok(" — pravé tlačidlo: pootočenie tvaru.", riadok);

                Svet.vypíšRiadok("Kliknutím alebo ťahaním niektorým tlačidlom myši vykonáte jednu z nasledujúcich akcií s textúrou (v režime úprav textúry):");
                Svet.vypíšRiadok(" — ak je posúvanie a otáčenie textúry voľné:");
                Svet.vypíšRiadok("   — ľavé tlačidlo: posunutie textúry,");
                Svet.vypíšRiadok("   — pravé tlačidlo: pootočenie textúry,", riadok);
                Svet.vypíšRiadok(" — ak je posúvanie a otáčenie textúry zamknuté:");
                Svet.vypíšRiadok("   — ľavé tlačidlo: posunutie stredu otáčania textúry,");
                Svet.vypíšRiadok("   — pravé tlačidlo: zmena mierky textúry.", riadok);
            }

            if (zobrazenie >= 0)
            {
                Svet.vypíšRiadok("Aktuálny stav:", riadok);

                Svet.vypíš(" — Cieľ výplne: ");
                switch (cieľVýplne)
                {
                case 0: Svet.vypíš("obrázok"); break;
                case 1: Svet.vypíš("tvar hviezdy"); break;
                case 2: Svet.vypíš("oblasť ježa v obruči"); break;
                case 3: Svet.vypíš("podlaha"); break;
                }
                Svet.vypíšRiadok(".");

                Svet.vypíš(" — Režim úprav: ");
                if (upravTextúru)
                    Svet.vypíš("textúra");
                else
                    Svet.vypíš("tvaru");
                Svet.vypíšRiadok(".");

                Svet.vypíš(" — Stav zámku textúry: ");
                if (zamknuté)
                    Svet.vypíš("zamknuté");
                else
                    Svet.vypíš("voľné");
                Svet.vypíšRiadok(".");
            }

            Svet.vypíšRiadok(riadok, "(Tip: Ak je miera zobrazených textov pomocníka vyššia, tak kolieskom myši môžete rolovať text…)");

            Svet.vypíšRiadok(riadok, "Stlačte Escape…");
        }
    }
    
    // Obsluhy udalostí (časovača, myši a klávesnice):
    
    @Override public void tik()
    {
        if (Svet.neboloPrekreslené()) Svet.prekresli();
    }

    @Override public void stlačenieTlačidlaMyši()
    {
        ťahanieMyšou();
    }

    @Override public void ťahanieMyšou()
    {
        if (upravTextúru)
        {
            if (zamknuté)
            {
                if (ÚdajeUdalostí.tlačidloMyši(ĽAVÉ))
                    Svet.stredOtáčaniaVýplne(
                        ÚdajeUdalostí.súradnicaMyšiX() - súradnicaX(),
                        ÚdajeUdalostí.súradnicaMyšiY() - súradnicaY());
                else
                    Svet.mierkaVýplne(ÚdajeUdalostí.súradnicaMyšiX() / 100.0,
                        ÚdajeUdalostí.súradnicaMyšiY() / 100.0);
            }
            else
            {
                if (ÚdajeUdalostí.tlačidloMyši(ĽAVÉ))
                    Svet.posunutieVýplneNaMyš();
                else
                    Svet.pootočenieVýplneNaMyš();
            }
        }
        else
        {
            if (ÚdajeUdalostí.tlačidloMyši(ĽAVÉ))
                skočNaMyš();
            else
                otočNaMyš();
        }

        vyplňTextúrou();
    }

    @SuppressWarnings("fallthrough") // toto je vysvetlené na konci metódy
    @Override public void uvoľnenieKlávesu()
    {
        switch (ÚdajeUdalostí.kláves())
        {
            case Kláves.MEDZERA:
                upravTextúru = !upravTextúru;
                pomoc();
                break;

            case Kláves.ENTER:
                if (zamknuté)
                {
                    Svet.posunutieVýplne(zálohaPosunutia);
                    Svet.pootočenieVýplne(zálohaPootočenia);
                }
                else
                {
                    zálohaPosunutia = Svet.posunutieVýplne();
                    zálohaPootočenia = Svet.pootočenieVýplne();
                }
                zamknuté = !zamknuté;
                vyplňTextúrou();
                pomoc();
                break;

            case Kláves.ESCAPE:
                if (zobrazPomoc > 0)
                    zobrazPomoc = -zobrazPomoc;
                else if (0 == zobrazPomoc)
                    zobrazPomoc = -3;
                pomoc();
                break;

            case Kláves.VK_F1:
                if (zobrazPomoc < 0)
                    zobrazPomoc = -zobrazPomoc;
                else if (0 == zobrazPomoc)
                    zobrazPomoc = 3;
                else
                    ++zobrazPomoc;
                pomoc();
                break;

            case Kláves.VK_1:
                cieľVýplne = 0;
                vyplňTextúrou();
                pomoc();
                break;

            case Kláves.VK_2:
                cieľVýplne = 1;
                vyplňTextúrou();
                pomoc();
                break;

            case Kláves.VK_3:
                cieľVýplne = 2;
                vyplňTextúrou();
                pomoc();
                break;

            case Kláves.VK_4:
                cieľVýplne = 3;
                vyplňTextúrou();
                pomoc();
                break;

            case Kláves.VK_F:
                ++typ;
                bezšvová = !bezšvová;
                // Na tomto mieste býva obvykle príkaz break. Jeho
                // neprítomnosť tu nie je chybou. Ide o úmyselné
                // prepadnutie sa do ďalšej vetvy, ktorá sa prepadáva
                // ešte hlbšie, takže posledné tri príkazy
                // (vygenerujTextúru – pomoc) sú vykonané vo všetkých
                // troch vetvách.
                // 
                // Posledný príkaz v tejto vetve (bezšvová = !bezšvová)
                // iba kompenzuje účinok nasledujúcej vetvy tak, aby
                // bola hodnota príznaku „bešvová“ po vykonaní tejto
                // vetvy nezmenená (pretože stlačenie klávesu F má mať
                // za následok iba zmenu typu generovanej textúry, nie
                // švového režimu).
                // 
                // Java by programátora varovala, že v tejto metóde sa
                // nachádza prepadnutie sa medzi vetvami riadiacej
                // štruktúry switch, preto je pred deklaračnou časťou
                // tejto metódy anotácia @SuppressWarnings("fallthrough"),
                // ktorá varovanie potlačí. Túto anotáciu smie
                // programátor použiť len v prípade, že o prepadnutí sa,
                // vie a úmyselne ho chce vo svojej metóde ponechať.

            case Kláves.VK_H:
                bezšvová = !bezšvová;

            case Kláves.VK_G:
                vygenerujTextúru();
                vyplňTextúrou();
                pomoc();
                break;
        }
    }
    
    // Hlavná metóda.
    public static void main(String... args)
    {
        Svet.použiKonfiguráciu("TestVypĺňaniaTextúrou.cfg");
        new TestVypĺňaniaTextúrou();
    }
}

Výsledok:

Príklad ukazujúci možnosti
výplne tesne po spustení.

Ukážka výsledku – úvodné zobrazenie.

Parametre:: x – x-ová súradnica určujúca novú hodnotu relatívneho posunutia obrázkových dlaždicových výplní; y – y-ová súradnica určujúca novú hodnotu relatívneho posunutia obrázkových dlaždicových výplní
Pozri tiež:: posunutieVýplne(), mierkaVýplne(double), mierkaVýplne(double, double), otočenieVýplne(double), otočenieVýplne(double, double, double), stredOtáčaniaVýplne(double, double), GRobot.vyplňTvar(Shape, String), GRobot.vyplňTvar(Shape, Image), GRobot.vyplňOblasť(Area, String), GRobot.vyplňOblasť(Area, Image), Plátno.vyplň(String), Plátno.vyplň(Image), Obrázok.vyplň(Shape, String), Obrázok.vyplň(Shape, Image), Obrázok.vyplň(String), Obrázok.vyplň(Image), Oblasť.vyplň(String), Oblasť.vyplň(Image)

posunutieVyplne

public static void posunutieVyplne(double x,
                                   double y)

Alias pre posunutieVýplne.

posunutieVýplne
```
public static void posunutieVýplne(Poloha poloha)
```
Táto metóda funguje podobne ako metóda posunutieVýplne(x, y). Rozdielom je, že namiesto dvoch samostatných súradníc prijíma objekt, ktorého polohu použije namiesto zadania súradníc. Inak funguje táto metóda úplne rovnako ako spomenutá metóda. Všetky informácie uvedené v jej opise sú tiež relevantné, preto odporúčame prečítať si aj jej opis.

Parametre:

poloha – objekt určujúci nové relatívne posunutie výplní

Pozri tiež:

posunutieVýplne(double, double)

posunutieVyplne

public static void posunutieVyplne(Poloha poloha)

Alias pre posunutieVýplne.

posunutieVýplne
```
public static void posunutieVýplne(Shape tvar)
```
Táto metóda funguje podobne ako metóda posunutieVýplne(x, y). Rozdielom je, že namiesto dvoch samostatných súradníc prijíma objekt, ktorého polohu použije namiesto zadania súradníc. Inak funguje táto metóda úplne rovnako ako spomenutá metóda. Všetky informácie uvedené v jej opise sú tiež relevantné, preto odporúčame prečítať si aj jej opis.

Parametre:

tvar – objekt určujúci nové relatívne posunutie výplní

Pozri tiež:

posunutieVýplne(double, double)

posunutieVyplne

public static void posunutieVyplne(Shape tvar)

Alias pre posunutieVýplne.

mierkaVýplne
```
public static Bod mierkaVýplne()
```
Vráti bod s hodnotami mierky obrázkových dlaždicových výplní v osiach x a y.

Návratová hodnota:

objekt typu Bod určujúci hodnoty mierky obrázkových dlaždicových výplní v osiach x a y

Pozri tiež:

mierkaVýplne(double, double), posunutieVýplne(), otočenieVýplne(), stredOtáčaniaVýplne()

mierkaVyplne
```
public static Bod mierkaVyplne()
```
Alias pre mierkaVýplne.

mierkaVýplne
```
public static void mierkaVýplne(double mierka)
```
Nastaví mierku obrázkových dlaždicových výplní (v oboch osiach naraz). Každé ďalšie spustenie niektorého z príkazov vypĺňania bude používať novú mierku. Hodnota mierky 1.0 je neutrálna – znamená, že rozmer textúry nebude zmenený. Hodnoty menšie než 1.0 (ale väčšie než 0.0 – to jest neceločíselné hodnoty) znamenajú zmenšenie a hodnoty väčšie než 1.0 znamenajú zväčšenie.

Parametre:

mierka – hodnota určujúca novú mierku textúry

Pozri tiež:

mierkaVýplne(), posunutieVýplne(double, double), mierkaVýplne(double, double), otočenieVýplne(double), otočenieVýplne(double, double, double), stredOtáčaniaVýplne(double, double), GRobot.vyplňTvar(Shape, String), GRobot.vyplňTvar(Shape, Image), GRobot.vyplňOblasť(Area, String), GRobot.vyplňOblasť(Area, Image), Plátno.vyplň(String), Plátno.vyplň(Image), Obrázok.vyplň(Shape, String), Obrázok.vyplň(Shape, Image), Obrázok.vyplň(String), Obrázok.vyplň(Image), Oblasť.vyplň(String), Oblasť.vyplň(Image)

mierkaVyplne

public static void mierkaVyplne(double mierka)

Alias pre mierkaVýplne.

mierkaVýplne
```
public static void mierkaVýplne(double mx,
                                double my)
```
Nastaví mierku obrázkových dlaždicových výplní jednotlivo pre osi x a y. Každé ďalšie spustenie niektorého z príkazov vypĺňania bude používať nové mierky. Hodnota mierky 1.0 pre niektorú z osí je neutrálna – znamená, že rozmer textúry nebude v smere tejto osi zmenený. Hodnoty menšie než 1.0 (ale väčšie než 0.0 – to jest neceločíselné hodnoty) znamenajú zmenšenie v určenom smere a hodnoty väčšie než 1.0 znamenajú zväčšenie.

Parametre:

mx – hodnota určujúca novú mierku v smere osi x

my – hodnota určujúca novú mierku v smere osi y

Pozri tiež:

mierkaVýplne(), posunutieVýplne(double, double), mierkaVýplne(double), otočenieVýplne(double), otočenieVýplne(double, double, double), stredOtáčaniaVýplne(double, double), GRobot.vyplňTvar(Shape, String), GRobot.vyplňTvar(Shape, Image), GRobot.vyplňOblasť(Area, String), GRobot.vyplňOblasť(Area, Image), Plátno.vyplň(String), Plátno.vyplň(Image), Obrázok.vyplň(Shape, String), Obrázok.vyplň(Shape, Image), Obrázok.vyplň(String), Obrázok.vyplň(Image), Oblasť.vyplň(String), Oblasť.vyplň(Image)

mierkaVyplne

public static void mierkaVyplne(double mx,
                                double my)

Alias pre mierkaVýplne.

otočenieVýplne
```
public static double otočenieVýplne()
```
Vráti hodnotu pootočenia obrázkových dlaždicových výplní.

Návratová hodnota:

objekt typu Bod určujúci mieru pootočenia obrázkových dlaždicových výplní

Pozri tiež:

otočenieVýplne(double), otočenieVýplne(double, double, double), posunutieVýplne(), mierkaVýplne(), stredOtáčaniaVýplne()

otocenieVyplne
```
public static double otocenieVyplne()
```
Alias pre otočenieVýplne.

pootočenieVýplne
```
public static double pootočenieVýplne()
```
Vráti hodnotu pootočenia obrázkových dlaždicových výplní.

Návratová hodnota:

objekt typu Bod určujúci mieru pootočenia obrázkových dlaždicových výplní

Pozri tiež:

pootočenieVýplne(double), pootočenieVýplne(double, double, double), posunutieVýplne(double, double), posunutieVýplne(), mierkaVýplne(), stredOtáčaniaVýplne()

pootocenieVyplne
```
public static double pootocenieVyplne()
```
Alias pre pootočenieVýplne.

otočenieVýplne
```
public static void otočenieVýplne(double uhol)
```
Nastaví nový uhol pootočenia obrázkových dlaždicových výplní. Každé ďalšie spustenie niektorého z príkazov vypĺňania bude pracovať s pootočenou textúrou. Predvolené je nulové, to jest žiadne, pootočenie so stredom otáčania v bode relatívneho posunutia textúry – pozri príkaz posunutieVýplne(x, y).

Parametre:

uhol – nový uhol pootočenia obrázkových dlaždicových výplní

Pozri tiež:

otočenieVýplne(), posunutieVýplne(double, double), mierkaVýplne(double), mierkaVýplne(double, double), otočenieVýplne(double, double, double), stredOtáčaniaVýplne(double, double), GRobot.vyplňTvar(Shape, String), GRobot.vyplňTvar(Shape, Image), GRobot.vyplňOblasť(Area, String), GRobot.vyplňOblasť(Area, Image), Plátno.vyplň(String), Plátno.vyplň(Image), Obrázok.vyplň(Shape, String), Obrázok.vyplň(Shape, Image), Obrázok.vyplň(String), Obrázok.vyplň(Image), Oblasť.vyplň(String), Oblasť.vyplň(Image)

otocenieVyplne

public static void otocenieVyplne(double uhol)

Alias pre otočenieVýplne.

pootočenieVýplne
```
public static void pootočenieVýplne(double uhol)
```
Nastaví nový uhol pootočenia obrázkových dlaždicových výplní. Každé ďalšie spustenie niektorého z príkazov vypĺňania bude pracovať s pootočenou textúrou. Predvolené je nulové, to jest žiadne, pootočenie so stredom otáčania v bode relatívneho posunutia textúry – pozri príkaz posunutieVýplne(x, y).

Parametre:

uhol – nový uhol pootočenia obrázkových dlaždicových výplní

Pozri tiež:

pootočenieVýplne(), posunutieVýplne(double, double), mierkaVýplne(double), mierkaVýplne(double, double), pootočenieVýplne(double, double, double), stredOtáčaniaVýplne(double, double), GRobot.vyplňTvar(Shape, String), GRobot.vyplňTvar(Shape, Image), GRobot.vyplňOblasť(Area, String), GRobot.vyplňOblasť(Area, Image), Plátno.vyplň(String), Plátno.vyplň(Image), Obrázok.vyplň(Shape, String), Obrázok.vyplň(Shape, Image), Obrázok.vyplň(String), Obrázok.vyplň(Image), Oblasť.vyplň(String), Oblasť.vyplň(Image)

pootocenieVyplne

public static void pootocenieVyplne(double uhol)

Alias pre pootočenieVýplne.

otočenieVýplne
```
public static void otočenieVýplne(double uhol,
                                  double sx,
                                  double sy)
```
Nastaví nový uhol pootočenia a zároveň nový relatívny stred otáčania obrázkových dlaždicových výplní. Každé ďalšie spustenie niektorého z príkazov vypĺňania bude pracovať s novými parametrami. Predvolené je nulové, to jest žiadne, pootočenie so stredom otáčania [0, 0], ktorý označuje bod relatívneho posunutia textúry – pozri príkaz posunutieVýplne(x, y).

Parametre:

uhol – nový uhol pootočenia obrázkových dlaždicových výplní

sx – x-ová súradnica nového relatívneho stredu otáčania obrázkových dlaždicových výplní

sy – y-ová súradnica nového relatívneho stredu otáčania obrázkových dlaždicových výplní

Pozri tiež:

otočenieVýplne(), posunutieVýplne(double, double), mierkaVýplne(double), mierkaVýplne(double, double), otočenieVýplne(double), stredOtáčaniaVýplne(double, double), GRobot.vyplňTvar(Shape, String), GRobot.vyplňTvar(Shape, Image), GRobot.vyplňOblasť(Area, String), GRobot.vyplňOblasť(Area, Image), Plátno.vyplň(String), Plátno.vyplň(Image), Obrázok.vyplň(Shape, String), Obrázok.vyplň(Shape, Image), Obrázok.vyplň(String), Obrázok.vyplň(Image), Oblasť.vyplň(String), Oblasť.vyplň(Image)

otocenieVyplne

public static void otocenieVyplne(double uhol,
                                  double sx,
                                  double sy)

Alias pre otočenieVýplne.

pootočenieVýplne
```
public static void pootočenieVýplne(double uhol,
                                    double sx,
                                    double sy)
```
Nastaví nový uhol pootočenia a zároveň nový relatívny stred otáčania obrázkových dlaždicových výplní. Každé ďalšie spustenie niektorého z príkazov vypĺňania bude pracovať s novými parametrami. Predvolené je nulové, to jest žiadne, pootočenie so stredom otáčania [0, 0], ktorý označuje bod relatívneho posunutia textúry – pozri príkaz posunutieVýplne(x, y).

Parametre:

uhol – nový uhol pootočenia obrázkových dlaždicových výplní

sx – x-ová súradnica nového relatívneho stredu otáčania obrázkových dlaždicových výplní

sy – y-ová súradnica nového relatívneho stredu otáčania obrázkových dlaždicových výplní

Pozri tiež:

pootočenieVýplne(), posunutieVýplne(double, double), mierkaVýplne(double), mierkaVýplne(double, double), pootočenieVýplne(double), stredOtáčaniaVýplne(double, double), GRobot.vyplňTvar(Shape, String), GRobot.vyplňTvar(Shape, Image), GRobot.vyplňOblasť(Area, String), GRobot.vyplňOblasť(Area, Image), Plátno.vyplň(String), Plátno.vyplň(Image), Obrázok.vyplň(Shape, String), Obrázok.vyplň(Shape, Image), Obrázok.vyplň(String), Obrázok.vyplň(Image), Oblasť.vyplň(String), Oblasť.vyplň(Image)

pootocenieVyplne

public static void pootocenieVyplne(double uhol,
                                    double sx,
                                    double sy)

Alias pre pootočenieVýplne.

otočenieVýplne
```
public static void otočenieVýplne(Smer smer)
```
Táto metóda funguje podobne ako metóda otočenieVýplne(uhol). Rozdielom je, že namiesto číselnej hodnoty smeru prijíma objekt, ktorý musí byť implementáciou rozhrania Smer. Inak funguje táto metóda úplne rovnako ako spomenutá metóda. Všetky informácie uvedené v jej opise sú tiež relevantné, preto odporúčame prečítať si aj jej opis.

Parametre:

smer – objekt určujúci nový uhol pootočenia výplní

Pozri tiež:

otočenieVýplne(double)

otocenieVyplne

public static void otocenieVyplne(Smer smer)

Alias pre otočenieVýplne.

pootočenieVýplne
```
public static void pootočenieVýplne(Smer smer)
```
Táto metóda funguje podobne ako metóda pootočenieVýplne(uhol). Rozdielom je, že namiesto číselnej hodnoty smeru prijíma objekt, ktorý musí byť implementáciou rozhrania Smer. Inak funguje táto metóda úplne rovnako ako spomenutá metóda. Všetky informácie uvedené v jej opise sú tiež relevantné, preto odporúčame prečítať si aj jej opis.

Parametre:

smer – objekt určujúci nový uhol pootočenia výplní

Pozri tiež:

pootočenieVýplne(double)

pootocenieVyplne

public static void pootocenieVyplne(Smer smer)

Alias pre pootočenieVýplne.

otočenieVýplne
```
public static void otočenieVýplne(Smer smer,
                                  double sx,
                                  double sy)
```
Táto metóda funguje podobne ako metóda otočenieVýplne(uhol, sx, sy). Rozdielom je, že namiesto číselnej hodnoty smeru prijíma objekt, ktorý musí byť implementáciou rozhrania Smer. Inak funguje táto metóda úplne rovnako ako spomenutá metóda. Všetky informácie uvedené v jej opise sú tiež relevantné, preto odporúčame prečítať si aj jej opis.

Parametre:

smer – objekt určujúci nový uhol pootočenia výplní

sx – nová x-ová súradnica relatívneho posunutia stredu otáčania výplní

sy – nová y-ová súradnica relatívneho posunutia stredu otáčania výplní

Pozri tiež:

otočenieVýplne(double, double, double)

otocenieVyplne

public static void otocenieVyplne(Smer smer,
                                  double sx,
                                  double sy)

Alias pre otočenieVýplne.

otočenieVýplne
```
public static void otočenieVýplne(double uhol,
                                  Poloha poloha)
```
Táto metóda funguje podobne ako metóda otočenieVýplne(uhol, sx, sy). Rozdielom je, že namiesto dvoch samostatných súradníc určujúcich vysunutie stredu otáčania prijíma objekt, ktorého polohu použije v relatívnom kontexte namiesto priameho zadania hodnôt súradníc (čiže absolútne súradnice polohy objektu použije priamo ako relatívne hodnoty – nie je vykonaný žiadny prepočet). Inak funguje táto metóda úplne rovnako ako spomenutá metóda. Všetky informácie uvedené v jej opise sú tiež relevantné, preto odporúčame prečítať si aj jej opis.

Parametre:

uhol – nový uhol pootočenia výplní

poloha – objekt určujúci nové relatívne posunutie stredu otáčania výplní

Pozri tiež:

otočenieVýplne(double, double, double)

otocenieVyplne

public static void otocenieVyplne(double uhol,
                                  Poloha poloha)

Alias pre otočenieVýplne.

otočenieVýplne
```
public static void otočenieVýplne(Smer smer,
                                  Poloha poloha)
```
Táto metóda funguje podobne ako metóda otočenieVýplne(uhol, sx, sy). Rozdielom je, že namiesto číselnej hodnoty smeru prijíma objekt, ktorý musí byť implementáciou rozhrania Smer a namiesto dvoch samostatných súradníc určujúcich vysunutie stredu otáčania prijíma objekt, ktorého polohu použije v relatívnom kontexte namiesto priameho zadania hodnôt súradníc (čiže absolútne súradnice polohy objektu použije priamo ako relatívne hodnoty – nie je vykonaný žiadny prepočet). Inak funguje táto metóda úplne rovnako ako spomenutá metóda. Všetky informácie uvedené v jej opise sú tiež relevantné, preto odporúčame prečítať si aj jej opis.

Parametre:

smer – objekt určujúci nový uhol pootočenia výplní

poloha – objekt určujúci nové relatívne posunutie stredu otáčania výplní

Pozri tiež:

otočenieVýplne(double, double, double)

otocenieVyplne

public static void otocenieVyplne(Smer smer,
                                  Poloha poloha)

Alias pre otočenieVýplne.

otočenieVýplne
```
public static void otočenieVýplne(double uhol,
                                  Shape tvar)
```
Táto metóda funguje podobne ako metóda otočenieVýplne(uhol, sx, sy). Rozdielom je, že namiesto dvoch samostatných súradníc určujúcich vysunutie stredu otáčania prijíma objekt, ktorého polohu použije v relatívnom kontexte namiesto priameho zadania hodnôt súradníc (čiže absolútne súradnice polohy objektu použije priamo ako relatívne hodnoty – nie je vykonaný žiadny prepočet). Inak funguje táto metóda úplne rovnako ako spomenutá metóda. Všetky informácie uvedené v jej opise sú tiež relevantné, preto odporúčame prečítať si aj jej opis.

Parametre:

uhol – nový uhol pootočenia výplní

tvar – objekt určujúci nové relatívne posunutie stredu otáčania výplní

Pozri tiež:

otočenieVýplne(double, double, double)

otocenieVyplne

public static void otocenieVyplne(double uhol,
                                  Shape tvar)

Alias pre otočenieVýplne.

otočenieVýplne
```
public static void otočenieVýplne(Smer smer,
                                  Shape tvar)
```
Táto metóda funguje podobne ako metóda otočenieVýplne(uhol, sx, sy). Rozdielom je, že namiesto číselnej hodnoty smeru prijíma objekt, ktorý musí byť implementáciou rozhrania Smer a namiesto dvoch samostatných súradníc určujúcich vysunutie stredu otáčania prijíma objekt, ktorého polohu použije v relatívnom kontexte namiesto priameho zadania hodnôt súradníc (čiže absolútne súradnice polohy objektu použije priamo ako relatívne hodnoty – nie je vykonaný žiadny prepočet). Inak funguje táto metóda úplne rovnako ako spomenutá metóda. Všetky informácie uvedené v jej opise sú tiež relevantné, preto odporúčame prečítať si aj jej opis.

Parametre:

smer – objekt určujúci nový uhol pootočenia výplní

tvar – objekt určujúci nové relatívne posunutie stredu otáčania výplní

Pozri tiež:

otočenieVýplne(double, double, double)

otocenieVyplne

public static void otocenieVyplne(Smer smer,
                                  Shape tvar)

Alias pre otočenieVýplne.

pootočenieVýplne
```
public static void pootočenieVýplne(Smer smer,
                                    double sx,
                                    double sy)
```
Táto metóda funguje podobne ako metóda pootočenieVýplne(uhol, sx, sy). Rozdielom je, že namiesto číselnej hodnoty smeru prijíma objekt, ktorý musí byť implementáciou rozhrania Smer. Inak funguje táto metóda úplne rovnako ako spomenutá metóda. Všetky informácie uvedené v jej opise sú tiež relevantné, preto odporúčame prečítať si aj jej opis.

Parametre:

smer – objekt určujúci nový uhol pootočenia výplní

sx – nová x-ová súradnica relatívneho posunutia stredu otáčania výplní

sy – nová y-ová súradnica relatívneho posunutia stredu otáčania výplní

Pozri tiež:

pootočenieVýplne(double, double, double)

pootocenieVyplne

public static void pootocenieVyplne(Smer smer,
                                    double sx,
                                    double sy)

Alias pre pootočenieVýplne.

pootočenieVýplne
```
public static void pootočenieVýplne(double uhol,
                                    Poloha poloha)
```
Táto metóda funguje podobne ako metóda pootočenieVýplne(uhol, sx, sy). Rozdielom je, že namiesto dvoch samostatných súradníc určujúcich vysunutie stredu otáčania prijíma objekt, ktorého polohu použije v relatívnom kontexte namiesto priameho zadania hodnôt súradníc (čiže absolútne súradnice polohy objektu použije priamo ako relatívne hodnoty – nie je vykonaný žiadny prepočet). Inak funguje táto metóda úplne rovnako ako spomenutá metóda. Všetky informácie uvedené v jej opise sú tiež relevantné, preto odporúčame prečítať si aj jej opis.

Parametre:

uhol – nový uhol pootočenia výplní

poloha – objekt určujúci nové relatívne posunutie stredu otáčania výplní

Pozri tiež:

pootočenieVýplne(double, double, double)

pootocenieVyplne

public static void pootocenieVyplne(double uhol,
                                    Poloha poloha)

Alias pre pootočenieVýplne.

pootočenieVýplne
```
public static void pootočenieVýplne(Smer smer,
                                    Poloha poloha)
```
Táto metóda funguje podobne ako metóda pootočenieVýplne(uhol, sx, sy). Rozdielom je, že namiesto číselnej hodnoty smeru prijíma objekt, ktorý musí byť implementáciou rozhrania Smer a namiesto dvoch samostatných súradníc určujúcich vysunutie stredu otáčania prijíma objekt, ktorého polohu použije v relatívnom kontexte namiesto priameho zadania hodnôt súradníc (čiže absolútne súradnice polohy objektu použije priamo ako relatívne hodnoty – nie je vykonaný žiadny prepočet). Inak funguje táto metóda úplne rovnako ako spomenutá metóda. Všetky informácie uvedené v jej opise sú tiež relevantné, preto odporúčame prečítať si aj jej opis.

Parametre:

smer – objekt určujúci nový uhol pootočenia výplní

poloha – objekt určujúci nové relatívne posunutie stredu otáčania výplní

Pozri tiež:

pootočenieVýplne(double, double, double)

pootocenieVyplne

public static void pootocenieVyplne(Smer smer,
                                    Poloha poloha)

Alias pre pootočenieVýplne.

pootočenieVýplne
```
public static void pootočenieVýplne(double uhol,
                                    Shape tvar)
```
Táto metóda funguje podobne ako metóda pootočenieVýplne(uhol, sx, sy). Rozdielom je, že namiesto dvoch samostatných súradníc určujúcich vysunutie stredu otáčania prijíma objekt, ktorého polohu použije v relatívnom kontexte namiesto priameho zadania hodnôt súradníc (čiže absolútne súradnice polohy objektu použije priamo ako relatívne hodnoty – nie je vykonaný žiadny prepočet). Inak funguje táto metóda úplne rovnako ako spomenutá metóda. Všetky informácie uvedené v jej opise sú tiež relevantné, preto odporúčame prečítať si aj jej opis.

Parametre:

uhol – nový uhol pootočenia výplní

tvar – objekt určujúci nové relatívne posunutie stredu otáčania výplní

Pozri tiež:

pootočenieVýplne(double, double, double)

pootocenieVyplne

public static void pootocenieVyplne(double uhol,
                                    Shape tvar)

Alias pre pootočenieVýplne.

pootočenieVýplne
```
public static void pootočenieVýplne(Smer smer,
                                    Shape tvar)
```
Táto metóda funguje podobne ako metóda pootočenieVýplne(uhol, sx, sy). Rozdielom je, že namiesto číselnej hodnoty smeru prijíma objekt, ktorý musí byť implementáciou rozhrania Smer a namiesto dvoch samostatných súradníc určujúcich vysunutie stredu otáčania prijíma objekt, ktorého polohu použije v relatívnom kontexte namiesto priameho zadania hodnôt súradníc (čiže absolútne súradnice polohy objektu použije priamo ako relatívne hodnoty – nie je vykonaný žiadny prepočet). Inak funguje táto metóda úplne rovnako ako spomenutá metóda. Všetky informácie uvedené v jej opise sú tiež relevantné, preto odporúčame prečítať si aj jej opis.

Parametre:

smer – objekt určujúci nový uhol pootočenia výplní

tvar – objekt určujúci nové relatívne posunutie stredu otáčania výplní

Pozri tiež:

pootočenieVýplne(double, double, double)

pootocenieVyplne

public static void pootocenieVyplne(Smer smer,
                                    Shape tvar)

Alias pre pootočenieVýplne.

stredOtáčaniaVýplne
```
public static Bod stredOtáčaniaVýplne()
```
Vráti bod so súradnicami relatívneho posunutia stredu otáčania obrázkových dlaždicových výplní vztiahnutý k súradniciam posunutia výplne.

Návratová hodnota:

objekt typu Bod určujúci súradnice relatívneho posunutia stredu otáčania obrázkových dlaždicových výplní vztiahnutý k súradniciam posunutia výplne

Pozri tiež:

stredOtáčaniaVýplne(double, double), posunutieVýplne(), mierkaVýplne(), otočenieVýplne()

stredOtacaniaVyplne
```
public static Bod stredOtacaniaVyplne()
```
Alias pre stredOtáčaniaVýplne.

stredOtáčaniaVýplne
```
public static void stredOtáčaniaVýplne(double sx,
                                       double sy)
```
Nastaví nový relatívny stred otáčania obrázkových dlaždicových výplní. Každé ďalšie spustenie niektorého z príkazov vypĺňania bude pracovať s novými parametrami. Tento parameter má na textúru vplyv len pri nenulovom uhle pootočenia výplní. Predvolený stred otáčania [0, 0] označuje bod relatívneho posunutia textúry – pozri príkaz posunutieVýplne(x, y).

Parametre:

uhol – nový uhol pootočenia obrázkových dlaždicových výplní

sx – x-ová súradnica nového relatívneho stredu otáčania obrázkových dlaždicových výplní

sy – y-ová súradnica nového relatívneho stredu otáčania obrázkových dlaždicových výplní

Pozri tiež:

stredOtáčaniaVýplne(), posunutieVýplne(double, double), mierkaVýplne(double), mierkaVýplne(double, double), otočenieVýplne(double), otočenieVýplne(double, double, double), GRobot.vyplňTvar(Shape, String), GRobot.vyplňTvar(Shape, Image), GRobot.vyplňOblasť(Area, String), GRobot.vyplňOblasť(Area, Image), Plátno.vyplň(String), Plátno.vyplň(Image), Obrázok.vyplň(Shape, String), Obrázok.vyplň(Shape, Image), Obrázok.vyplň(String), Obrázok.vyplň(Image), Oblasť.vyplň(String), Oblasť.vyplň(Image)

stredOtacaniaVyplne

public static void stredOtacaniaVyplne(double sx,
                                       double sy)

Alias pre stredOtáčaniaVýplne.

stredOtáčaniaVýplne
```
public static void stredOtáčaniaVýplne(Poloha poloha)
```
Táto metóda funguje podobne ako metóda stredOtáčaniaVýplne(sx, sy). Rozdielom je, že namiesto dvoch samostatných súradníc určujúcich vysunutie stredu otáčania prijíma objekt, ktorého polohu použije v relatívnom kontexte namiesto priameho zadania hodnôt súradníc (čiže absolútne súradnice polohy objektu použije priamo ako relatívne hodnoty – nie je vykonaný žiadny prepočet). Inak funguje táto metóda úplne rovnako ako spomenutá metóda. Všetky informácie uvedené v jej opise sú tiež relevantné, preto odporúčame prečítať si aj jej opis.

Parametre:

poloha – objekt určujúci nové relatívne posunutie stredu otáčania výplní

Pozri tiež:

stredOtáčaniaVýplne(double, double)

stredOtacaniaVyplne

public static void stredOtacaniaVyplne(Poloha poloha)

Alias pre stredOtáčaniaVýplne.

stredOtáčaniaVýplne
```
public static void stredOtáčaniaVýplne(Shape tvar)
```
Táto metóda funguje podobne ako metóda stredOtáčaniaVýplne(sx, sy). Rozdielom je, že namiesto dvoch samostatných súradníc určujúcich vysunutie stredu otáčania prijíma objekt, ktorého polohu použije v relatívnom kontexte namiesto priameho zadania hodnôt súradníc (čiže absolútne súradnice polohy objektu použije priamo ako relatívne hodnoty – nie je vykonaný žiadny prepočet). Inak funguje táto metóda úplne rovnako ako spomenutá metóda. Všetky informácie uvedené v jej opise sú tiež relevantné, preto odporúčame prečítať si aj jej opis.

Parametre:

tvar – objekt určujúci nové relatívne posunutie stredu otáčania výplní

Pozri tiež:

stredOtáčaniaVýplne(double, double)

stredOtacaniaVyplne

public static void stredOtacaniaVyplne(Shape tvar)

Alias pre stredOtáčaniaVýplne.

posunutieVýplneNaMyš
```
public static void posunutieVýplneNaMyš()
```
Táto metóda číta súradnice myši, ktoré použije na posunutie počiatku obrázkových výplní. Funguje tak, ako keby sme do metódy posunutieVýplne(x, y) zadali súradnice myši namiesto parametrov. Informácie nachádzajúce sa v opise uvedenej metódy sú relevantné aj v prípade tejto metódy, preto odporúčame prečítať si ho.

Pozri tiež:

posunutieVýplne(double, double)

posunutieVyplneNaMys
```
public static void posunutieVyplneNaMys()
```
Alias pre posunutieVýplneNaMyš.

otočenieVýplneNaMyš
```
public static void otočenieVýplneNaMyš()
```
Táto metóda použije súradnice myši na vypočítanie nového pootočenia obrázkových výplní. Najprv prevezme súradnice myši, vypočíta z nich uhol smerom k aktuálnemu stredu otáčania obrázkových výplní a uhol použije na nastavenie nového pootočenia.

Metóda funguje tak, ako keby sme vypočítaný uhol zadali ako parameter do metódy otočenieVýplne(uhol). Informácie nachádzajúce sa v opise uvedenej metódy sú relevantné aj pre túto metódu, preto odporúčame prečítať si aj jej opis.

Pozri tiež:

otočenieVýplne(double)

otocenieVyplneNaMys
```
public static void otocenieVyplneNaMys()
```
Alias pre otočenieVýplneNaMyš.

pootočenieVýplneNaMyš
```
public static void pootočenieVýplneNaMyš()
```
Táto metóda použije súradnice myši na vypočítanie nového pootočenia obrázkových výplní. Najprv prevezme súradnice myši, vypočíta z nich uhol smerom k aktuálnemu stredu otáčania obrázkových výplní a uhol použije na nastavenie nového pootočenia.

Metóda funguje tak, ako keby sme vypočítaný uhol zadali ako parameter do metódy pootočenieVýplne(uhol). Informácie nachádzajúce sa v opise uvedenej metódy sú relevantné aj pre túto metódu, preto odporúčame prečítať si aj jej opis.

Pozri tiež:

pootočenieVýplne(double)

pootocenieVyplneNaMys
```
public static void pootocenieVyplneNaMys()
```
Alias pre pootočenieVýplneNaMyš.

stredOtáčaniaVýplneNaMyš
```
public static void stredOtáčaniaVýplneNaMyš()
```
Táto metóda číta súradnice myši, ktoré použije na nastavenie nového relatívneho stredu otáčania obrázkových výplní. Funguje tak, ako keby sme do parametrov metódy stredOtáčaniaVýplne(sx, sy) zadali rozdiel súradníc myši a aktuálnych hodnôt posunutia textúr. Informácie nachádzajúce sa v opise dotknutej metódy sú relevantné aj v prípade tejto metódy, preto odporúčame prečítať si ho.

Pozri tiež:

stredOtáčaniaVýplne(double, double)

stredOtacaniaVyplneNaMys
```
public static void stredOtacaniaVyplneNaMys()
```
Alias pre stredOtáčaniaVýplneNaMyš.

kresli
```
public static void kresli(Shape tvar,
                          GRobot kreslič)
```
Táto metóda slúži na kreslenie obrysov zadaného tvaru na podlahu. Metóda potrebuje na svoje správne fungovanie robota „kresliča,“ ktorého farbu a štýl čiary použije na kreslenie. Ak je do metódy namiesto konkrétneho kresliča zadaná hodnota null, tak je na získanie parametrov kreslenia použitý hlavný robot. Spustenie tejto metódy má rovnaký efekt, ako keby sme volali metódu podlaha.kresli(tvar, kreslič).

Parametre:

tvar – objekt typu Shape, ktorý bude nakreslený aktuálnym štýlom čiary a farbou zadaného robota („kresliča“)

kreslič – grafický robot, ktorého parametre budú použité na kreslenie alebo null

Pozri tiež:

kresli(Shape), vyplň(Shape, GRobot), vyplň(Shape)

vyplň
```
public static void vyplň(Shape tvar,
                         GRobot kreslič)
```
Táto metóda slúži na kreslenie vyplnených tvarov na podlahu. Metóda potrebuje na svoje správne fungovanie robota „kresliča,“ ktorého farbu použije na vyplnenie zadaného tvaru. Ak je do metódy namiesto konkrétneho kresliča zadaná hodnota null, tak je na získanie parametrov kreslenia použitý hlavný robot. Spustenie tejto metódy má rovnaký efekt, ako keby sme volali metódu podlaha.vyplň(tvar, kreslič).

Parametre:

tvar – objekt typu Shape, ktorý bude vyplnený aktuálnou farbou zadaného robota („kresliča“)

kreslič – grafický robot, ktorého parametre budú použité na kreslenie alebo null

Pozri tiež:

kresli(Shape, GRobot), kresli(Shape), vyplň(Shape)

vypln

public static void vypln(Shape tvar,
                         GRobot kreslič)

Alias pre vyplň.

kresli
```
public static void kresli(Shape tvar)
```
Táto metóda slúži na kreslenie obrysov zadaného tvaru na podlahu. Metóda používa na získanie parametrov kreslenia (štýlu a farby čiary) hlavného robota. Spustenie tejto metódy má rovnaký efekt, ako keby sme volali metódu podlaha.kresli(tvar).

Parametre:

tvar – objekt typu Shape, ktorý bude nakreslený aktuálnym štýlom čiary a farbou hlavného robota

Pozri tiež:

kresli(Shape, GRobot), vyplň(Shape, GRobot), vyplň(Shape)

vyplň
```
public static void vyplň(Shape tvar)
```
Táto metóda slúži na kreslenie vyplnených tvarov na podlahu. Metóda používa na získanie parametrov kreslenia (farby výplne) hlavného robota. Spustenie tejto metódy má rovnaký efekt, ako keby sme volali metódu podlaha.vyplň(tvar).

Parametre:

tvar – objekt typu Shape, ktorý bude vyplnený farbou hlavného robota

Pozri tiež:

kresli(Shape, GRobot), kresli(Shape), vyplň(Shape, GRobot)

vypln
```
public static void vypln(Shape tvar)
```
Alias pre vyplň.

priehľadnosť
```
public static void priehľadnosť(double prePodlahu,
                                double preStrop)
```
Naraz nastaví priehľadnosť pre podlahu aj strop.

Parametre:

prePodlahu – nová úroveň (ne)priehľadnosti pre podlahu (0.0 – 1.0)

preStrop – nová úroveň priehľadnosti pre strop (0.0 – 1.0)

Pozri tiež:

upravPriehľadnosť(double, double), Plátno.priehľadnosť(double), Plátno.priehľadnosť(), Plátno.upravPriehľadnosť(double)

priehladnost

public static void priehladnost(double prePodlahu,
                                double preStrop)

Alias pre priehľadnosť.

upravPriehľadnosť

public static void upravPriehľadnosť(double prePodlahu,
                                     double preStrop)

Naraz upraví úroveň priehľadnosti pre podlahu aj strop. Parametre sú koeficienty, ktorými bude násobená aktuálna úroveň priehľadnosti stanoveného plátna – ak napríklad zadáme Svet.upravPriehľadnosť(0.5, 2), tak úroveň priehľadnosti podlahy klesne na polovicu a stropu stúpne dvojnásobne.

Príklad:

V tomto príklade použijeme úpravu priehľadnosti plátien na vytvorenie prechodového efektu (pozri zoznam zmien: poďakovanie uvedené pri verzii 1.35):

// Najskôr zaplníme plátno a strop kresbou:

hrúbkaČiary(10.0);
skry();

for (int i = 0; i < 2; ++i)
{
    farba((int)Svet.náhodnéCeléČíslo(0, 255),
        (int)Svet.náhodnéCeléČíslo(0, 255),
        (int)Svet.náhodnéCeléČíslo(0, 255));
    vyplň();

    for (int j = 0; j < 22; ++j)
    {
        smer(0);
        náhodnáPoloha();
        skoč(0, -113.5);

        for (int k = 0; k < 24; ++k)
        {
            farba((int)Svet.náhodnéCeléČíslo(0, 255),
                (int)Svet.náhodnéCeléČíslo(0, 255),
                (int)Svet.náhodnéCeléČíslo(0, 255));
            doľava(15);
            dopredu(30);
        }
    }

    podlaha.priehľadnosť(0.0);
    kresliNaStrop();
}

// Definujeme obsluhu udalostí (z dôvodu obsluhy časovača):

new ObsluhaUdalostí()
{
    @Override public void tik()
    {
        Svet.upravPriehľadnosť(1.1, 0.9);
        if (strop.priehľadnosť() <= 0.03)
        {
            Svet.pípni();
            Svet.zastavČasovač();
            Svet.priehľadnosť(1.0, 0.0);
        }
    }
};

// A spustíme časovač:

Svet.čakaj(1.0);
Svet.spustiČasovač(0.1);
Svet.pípni();

Výsledok:

Prvý (náhodne) generovaný obrázok
(plátno na obrázku je zmenšené).

Fáza prelivu obrázkov pomocou priehľadnosti
(zhruba v polovici procesu)
(plátno na obrázku je zmenšené).

Druhý (náhodne) generovaný obrázok
(plátno na obrázku je zmenšené).

Poznámka: Ak by sme chceli vytvoriť plynulý prechod priehľadnosti medzi dvomi kresbami pokrývajúcimi celé plátna, tak by bolo lepšie, keby sme postupovali tak, že by sme na začiatku nastavili obom plátnam úplnú nepriehľadnosť, spodnému plátnu by sme ponechali nepriehľadnosť nezmenenú a nepriehľadnosť horného plátna by sme plynule znižovali. Avšak pre nepravidelné kresby alebo rôzne veľkosti obrázkov by tento postup nefugoval. Podobne by sme s týmto prístupom neuspeli, keby sme chceli, aby bolo počas prelivu vidno určité (napríklad vzorkované) pozadie, ktoré by nebolo súčasťou ani jednej z kresieb.

Parametre:: prePodlahu – koeficient zmeny úrovne priehľadnosti podlahy; preStrop – koeficient zmeny úrovne priehľadnosti stropu
Pozri tiež:: priehľadnosť(double, double), Plátno.upravPriehľadnosť(double), Plátno.priehľadnosť(double), Plátno.priehľadnosť(), Plátno.upravPriehľadnosť(double)

upravPriehladnost

public static void upravPriehladnost(double prePodlahu,
                                     double preStrop)

Alias pre upravPriehľadnosť.

kreslenie
```
public static boolean kreslenie()
```
Overí, či je automatické prekresľovanie sveta zapnuté. Vypnutie automatického prekresľovania zabezpečuje metóda nekresli, zapnutie zase metóda kresli.

Poznámka: Predvolená implementácia automatického prekresľovania sveta nie je efektívna (ale má svoje príčiny). Pozrite si komentáre a príklady v opisoch metód prekresli a nebolPrekreslený.

Návratová hodnota:

true ak je automatické prekresľovanie zapnuté, false ak je vypnuté

Pozri tiež:

nebolPrekreslený(), nekresli(), kresli(), prekresli(), žiadajPrekreslenie()

nebolPrekreslený
```
public static boolean nebolPrekreslený()
```
Zistí stav príznaku zamietnutej požiadavky na automatické prekreslenie. Ak je hodnota tohto príznaku rovná true, tak je pravdepodobné, že obsah okna na obrazovke nekorešponduje so skutočnými obsahmi pozadia a plátien (prípadne ďalších komponentov).

Táto metóda súvisí s vypnutím predvolenej implementácie automatického prekresľovania, ktoré i tak nie je efektívne. Nasledujúci príklad ukazuje lepší spôsob implementácie automatického (resp. pravidelného) prekresľovania. Ide o pravidelnú kontrolu nevyhnutnoti prekresľovanie sveta s využitím tejto metódy a prekreslenie v prípade potreby. (Ide vlastne o implementáciu prekresľovania v jednotkách snímok za sekundu – frames per second – FPS.)

Tento spôsob prekresľovania je v súvislosti s počítačovou grafikou ideálny, ale nemohol byť implementovaný v rámci programovacieho rámca predvolene, pretože by vyžadoval implicitné zapnutie časovača so stanovením predvoleného času obnovovania (čomu sa autor programovaceho rámca chcel vyhnúť). Pri implementácii programovacieho rámca bolo cieľom:
1. ponechať čo najviac možností slobodnej voľby na programátorovi (automatické zapnutie časovača by bolo považované za rozhodnutie nad rámec kompetencií programovacieho rámca, pretože časovač je jedným z obmedzovaných systémových zdrojov – nie je možné vytvoriť nekonečné množstvo časovačov a časovače ovplyvňujú činnosť celého systému)
2. a zároveň minimalizácia objemu vstupných poznatkov pre začiatočníkov (zvolený prístup nevyžaduje od začiatočníka, aby sa najskôr podrobne oboznámil s nevyhnutnosťou prekresľovania a s možnosťami jeho implementácie – jednoducho si sadne k vhodne zvolenému a nakonfigurovanému programovaciemu prostrediu a začne používať príkazy grafického robota).
To viedlo k predvolenej implementácii automatického prekresľovania v súčasnej podobe, čiže po každej zmene plátna. Voľba tohto prístupu bola pri vzatí do úvahy uvedených cieľov najlepšou možnosťou. Tento nevýhodný spôsob vykresľovania sa dá vypnúť a nahradiť iným lepším spôsobom, napríklad tým, ktorý ukazuje nasledujúci príklad. Vďaka tomu môže učiteľ študentom ukázať výhody a nevýhody rôznych prístupov a vysvetliť dôvody ich použitia.

Dôležité upozornenie! V rámci používania programovacieho rámca môžu nastať určité špeciálne situácie, kedy nie je automaticky rozpoznaná potreba prekreslenia, napríklad pri použití vlastných metód obrázka na jeho úpravu, pričom obrázok je nastavený ako vlastný tvar niektorému z robotov. Nepoužívajte v takom prípade príkaz Svet.prekresli()! Na tento účel je rezervovaný príkaz Svet.žiadajPrekreslenie().

Príklad:
```
import knižnica.*;

public class TestPrekresľovania extends GRobot
{
    private TestPrekresľovania()
    {
        super(300, 200); // nadradený konštruktor upraví veľkosť plátna
        Svet.nekresli(); // vypne predvolený spôsob automatického prekresľovania

        // V nasledujúcej obsluje udalostí (v reakcii tik) bude zabezpečené
        // pravidelné prekresľovanie:
        new ObsluhaUdalostí()
        {
            @Override public void tik()
            {
                // Ak je treba, tak prekresli svet…
                if (Svet.neboloPrekreslené()) Svet.prekresli();
            }

            // …
            // Obsluha prípadných ďalších udalostí…
            // …
        };

        Svet.spustiČasovač();

        // Príklad časovo náročnej činnosti (pri zapnutom pôvodnom
        // automatickom prekresľovaní by bola časovo ešte náročnejšia, pretože
        // prekreslenie by nastalo po každom príkaze v tele cyklu – dokončenie
        // vykonávania cyklu by trvalo možno aj niekoľko minút; takto sa celý
        // príklad vykoná za necelú sekundu…):
        for (int i = 0; i < 1000000; ++i)
        {
            náhodnáPoloha();
            bod();
        }
    }

    public static void main(String... args)
    {
        // Príkaz „Svet.nekresli()“ môže byť prípadne uvedený aj tu…
        Svet.použiKonfiguráciu("test-prekresľovania.cfg");
        new TestPrekresľovania();
    }
}
```
Výsledok:

Niekoľko obrázkov zobrazujúcich priebeh zapĺňania plátna bodmi počas vykonávania tohto príkladu.

Poznámka: Pozrite si aj komentáre a príklad v opise metódy prekresli.
Návratová hodnota:

true ak vznikla požiadavka na automatické prekreslenie, zapnuté, no bola zamietnutá (napríklad v dôsledku vypnutia automatického prekresľovania – pozri aj: nekresli); false v opačnom prípade

Pozri tiež:

kreslenie(), nekresli(), kresli(), prekresli(), žiadajPrekreslenie()

nebolPrekresleny
```
public static boolean nebolPrekresleny()
```
Alias pre nebolPrekreslený.

neboloPrekreslené
```
public static boolean neboloPrekreslené()
```
Alias pre nebolPrekreslený.

neboloPrekreslene
```
public static boolean neboloPrekreslene()
```
Alias pre nebolPrekreslený.

nekresli
```
public static void nekresli()
```
Vypne predvolenú implementáciu automatického prekresľovanie sveta. Tá funguje tak, že prekresľovanie sveta je automaticky vykonávané po rôznych aktivitách robotov (zmena polohy, orientácie a podobne), pri zmene niektorých parametrov sveta, prípadne pri inej relevantnej príležitosti (to jest vždy, keď je pravdepodobné, že sa niečo na plátnach sveta vizuálne zmenilo).

Vypnutie automatického prekresľovania môže značne zvýšiť grafickú efektívnosť aplikácie, aby sme však po jeho vypnutí mohli vidieť výsledok kreslenia, musíme vždy (po akejkoľvek zmene, ktorá by sa mohla prejaviť graficky) použiť metódu prekresli (napríklad pravidelne po určitom počte vykonaných príkazov, alebo v pravidelných časových intervaloch, prípadne po overení potreby prekreslenia sveta metódou nebolPrekreslený). Túto predvolenú implementáciu automatického prekresľovania sveta opätovne zapneme metódou kresli.

Poznámka: Predvolená implementácia automatického prekresľovania sveta nie je efektívna, i keď má svoje príčiny. Pozrite si komentáre a príklady v opisoch metód prekresli a nebolPrekreslený.

Pozri tiež:

kreslenie(), nebolPrekreslený(), kresli(), prekresli(), žiadajPrekreslenie()

kresli
```
public static void kresli()
```
Zapne automatické prekresľovanie sveta, ktoré bolo vypnuté metódou nekresli. Ak nechceme prekresľovanie zapnúť, ale chceme napríklad vidieť, čo medzičasom nakreslil niektorý robot, môžeme použiť metódu prekresli.

Poznámka: Predvolená implementácia automatického prekresľovania sveta nie je efektívna (ale má svoje príčiny). Pozrite si komentáre a príklady v opisoch metód prekresli a nebolPrekreslený.

Pozri tiež:

kreslenie(), nebolPrekreslený(), nekresli(), prekresli(), žiadajPrekreslenie()

prekresli
```
public static void prekresli()
```
Jednorazovo prekreslí obsah sveta (bez ohľadu na použitie metódy nekresli).

To znamená, že metóda prekreslí obsah sveta bez ohľadu na nastavenie automatického prekresľovania (pozri napríklad metódu nekresli). Metóda spustí rovnaký proces, aký je vykonávaný pri automatickom prekresľovaní. V prípade, že je automatické prekresľovanie sveta vypnuté (metódou nekresli), nie je prekreslenie vykonané bez vedomia programátora, okrem prípadu, keď sú splnené nasledujúce podmienky:
1. bola aspoň raz použitá niektorá z metód vypíš, vypíšRiadok
  a súčasne
2. sa zmenila veľkosť hlavného okna (buď aktivitou používateľa, alebo z iných príčin)
  a súčasne
3. nie je aktívna obsluha udalostí (pozri ObsluhaUdalostí.zmenaVeľkostiOkna()).
Vypnutie automatického prekresľovania môže značne zvýšiť grafickú efektívnosť aplikácie.

Príklad:

V tomto príklade najskôr vypneme kreslenie a začneme kresliť vymyslenú mapu kruhového sveta… Svet bude mať dvadsať kontinentov. Po nakreslení každého z nich použijeme metódu prekresli na ukázanie čiastočného (a nakoniec konečného) výsledku (pozri zoznam zmien: poďakovanie uvedené pri verzii 1.35):
```
// V tomto príklade nakreslíme „Novú Zem“:

Svet.farbaPozadia(modrá);
Svet.nekresli();
hrúbkaČiary(1.5);

for (int i = 0; i < 20; ++i)
{
    // Pevninu rozbijeme na viacero kontinentov (kolízie nebudeme
    // kontrolovať, dovolíme, aby sa prekrývali). Každý kontinent
    // začneme na náhodnej pozícii:
    náhodnáPoloha();

    for (int j = 0; j < 25000; ++j)
    {
        // Tieto dva príkazy sa postarajú o kreslenie pevniny
        // (náhodným spôsobom):
        náhodnýSmer();
        dopredu(1.5);

        // Nasledujúci výpočet a podmienka sa postarajú o vznik
        // červených „kruhov“ (tenkých obručí) na ploche pevniny:
        double výpočet = vzdialenosť() / 50 - vzdialenosť() % 50;

        if ((výpočet % 2) >= 1)
            farba(červená);
        else
            farba(zelená);
    }

    Svet.prekresli();
}

Svet.kresli();
```
Nová Zem sa bude vykresľovať po fázach, výsledok bude náhodný a môže vyzerať napríklad takto:

Poznámka: Táto metóda súvisí s vypnutím predvolenej implementácie automatického prekresľovania, ktoré i tak nie je efektívne. Pozrite si aj komentáre a príklad v opise metódy nebolPrekreslený.
Pozri tiež:

kreslenie(), nebolPrekreslený(), nekresli(), kresli(), žiadajPrekreslenie()

žiadajPrekreslenie
```
public static void žiadajPrekreslenie()
```
Nastaví vnútorný príznak (stav) prekreslenia sveta tak, aby metóda nebolPrekreslený vrátila hodnotu true. Táto metóda nedokáže zabezpečiť prekreslenie sveta. Jej účelom je len nastaviť uvedený príznak. Využitie nájde v prípadoch, kedy je vypnuté automatické prekresľovanie sveta a čas (interval) prekresľovania určuje aplikácia. (Pozri aj upozornenie v opise metódy nebolPrekreslený.)

Pozri tiež:

kreslenie(), nebolPrekreslený(), nekresli(), kresli(), prekresli()

ziadajPrekreslenie
```
public static void ziadajPrekreslenie()
```
Alias pre žiadajPrekreslenie.

vymažPonuku
```
public static void vymažPonuku()
```
Vymaže všetky položky hlavnej ponuky (vrátane predvolených). Metóda automaticky skryje hlavnú ponuku. Viditeľnosť ponuky je automaticky obnovená po začatí pridávania položiek.

Pozri tiež:

PoložkaPonuky, pridajPoložkuHlavnejPonuky(String), pridajPoložkuHlavnejPonuky(String, int), pridajPoložkuPonuky(String), pridajVnorenúPonuku(String, JMenuItem...), pridajOddeľovačPonuky()

vymazPonuku
```
public static void vymazPonuku()
```
Alias pre vymažPonuku.

pridajPoložkuHlavnejPonuky
```
public static void pridajPoložkuHlavnejPonuky(String text)
```
Rozšíri hlavnú ponuku o ďalšiu položku alebo prepíše aktuálnu položku hlavnej ponuky. Aktuálna hlavná položka je prepísaná v prípade, že zatiaľ neobsauje žiadne podpoložky (pozri pridajPoložkuPonuky alebo jej „klony“).

Parametre:

text – reťazec textu pridávanej položky

Pozri tiež:

PoložkaPonuky, vymažPonuku(), pridajPoložkuHlavnejPonuky(String, int), premenujPoložkuHlavnejPonuky(int, String), pridajPoložkuPonuky(String), pridajVnorenúPonuku(String, JMenuItem...), pridajOddeľovačPonuky()

pridajPolozkuHlavnejPonuky

public static void pridajPolozkuHlavnejPonuky(String text)

Alias pre pridajPoložkuHlavnejPonuky.

pridajPoložkuHlavnejPonuky
```
public static void pridajPoložkuHlavnejPonuky(String text,
                                              int mnemonickáSkratka)
```
Rozšíri hlavnú ponuku o ďalšiu položku alebo prepíše aktuálnu položku hlavnej ponuky. Aktuálna hlavná položka je prepísaná v prípade, že zatiaľ neobsauje žiadne podpoložky (pozri pridajPoložkuPonuky alebo jej „klony“). Význam parametra mnemonickáSkratka je rovnaký ako pri metóde pridajPoložkuPonuky(text, mnemonickáSkratka).

Parametre:

text – reťazec textu pridávanej položky

mnemonickáSkratka – kód mnemonickej skratky (príklad: Kláves.VK_A)

Pozri tiež:

PoložkaPonuky, vymažPonuku(), pridajPoložkuHlavnejPonuky(String), premenujPoložkuHlavnejPonuky(int, String, int), pridajPoložkuPonuky(String, int), pridajVnorenúPonuku(String, JMenuItem...), pridajOddeľovačPonuky()

pridajPolozkuHlavnejPonuky

public static void pridajPolozkuHlavnejPonuky(String text,
                                              int mnemonickáSkratka)

Alias pre pridajPoložkuHlavnejPonuky.

premenujPoložkuHlavnejPonuky
```
public static boolean premenujPoložkuHlavnejPonuky(int ktorá,
                                                   String text)
```
Premenuje zadanú položku hlavnej ponuky. (Cieľom tejto metódy je uľahčiť jazykovú lokalizáciu.) Prvý parameter je index („poradové číslo“ začínajúce od nuly) položky, ktorá má byť premenovaná. Ak nastane chyba (napríklad položka so zadaným indexom nejestvuje), tak metóda vráti hodnotu false.

Parametre:

ktorá – index položky, ktorej text má byť zmenený

text – nové znenie textu položky

Návratová hodnota:

kontrolná návratová hodnota: true ak akcia uspela

Pozri tiež:

premenujPoložkuHlavnejPonuky(int, String, int), pridajPoložkuHlavnejPonuky(String)

premenujPolozkuHlavnejPonuky

public static boolean premenujPolozkuHlavnejPonuky(int ktorá,
                                                   String text)

Alias pre premenujPoložkuHlavnejPonuky.

premenujPoložkuHlavnejPonuky
```
public static boolean premenujPoložkuHlavnejPonuky(int ktorá,
                                                   String text,
                                                   int mnemonickáSkratka)
```
Premenuje zadanú položku hlavnej ponuky. (Cieľom tejto metódy je uľahčiť jazykovú lokalizáciu.) Prvý parameter je index („poradové číslo“ začínajúce od nuly) položky, ktorá má byť premenovaná. Ak nastane chyba (napríklad položka so zadaným indexom nejestvuje), tak metóda vráti hodnotu false. Význam parametra mnemonickáSkratka je rovnaký ako pri metóde pridajPoložkuPonuky(text, mnemonickáSkratka).

Parametre:

ktorá – index položky, ktorej text má byť zmenený

text – nové znenie textu položky

mnemonickáSkratka – kód mnemonickej skratky (príklad: Kláves.VK_A)

Návratová hodnota:

kontrolná návratová hodnota: true ak akcia uspela

Pozri tiež:

premenujPoložkuHlavnejPonuky(int, String), pridajPoložkuHlavnejPonuky(String, int)

premenujPolozkuHlavnejPonuky

public static boolean premenujPolozkuHlavnejPonuky(int ktorá,
                                                   String text,
                                                   int mnemonickáSkratka)

Alias pre premenujPoložkuHlavnejPonuky.

pridajPoložkuPonuky
```
public static PoložkaPonuky pridajPoložkuPonuky(String text)
```
Pridá do hlavnej ponuky položku so zadaným textom. Zvolenie položky vyvolá reakciu voľbaPoložkyPonuky v triede obsluhy udalostí. V tej je možné položku identifikovať pomocou metódy ÚdajeUdalostí.položkaPonuky ktorá vracia objekt typu PoložkaPonuky. Ten môžeme porovnať s hodnotou vrátenou z tejto metódy (ktorú si odložíme do pomocnej premennej) alebo použiť iný spôsob identifikácie. Napríklad metódu aktivovaná, ktorá vráti true v prípade, že bola táto položka naposledy aktivovaná.

Parametre:

text – reťazec textu pridávanej položky ponuky

Návratová hodnota:

objekt novej položky ponuky (PoložkaPonuky) alebo null ak nastala chyba

Pozri tiež:

PoložkaPonuky, vymažPonuku(), pridajPoložkuPonuky(String, int), pridajPoložkuPonuky(String, int, int), pridajVnorenúPonuku(String, JMenuItem...), pridajOddeľovačPonuky(), pridajPoložkuPonukyVymazať(), pridajPoložkuPonukyPrekresliť(), pridajPoložkuPonukyKoniec()

pridajPolozkuPonuky

public static PolozkaPonuky pridajPolozkuPonuky(String text)

Alias pre pridajPoložkuPonuky.

pridajPoložkuPonuky
```
public static PoložkaPonuky pridajPoložkuPonuky(String text,
                                                int mnemonickáSkratka)
```
Funguje rovnako ako pridajPoložkuPonuky(String text) s tým, že definuje novej položke mnemonickú skratku (skratky, ktoré sú v položkách ponuky znázorňované podčiarknutým písmenom). Skratku je možné najjednoduchšie určiť konštantou triedy KeyEvent.VK_XXX (tá je v programovacom rámci na zjednodušenie prístupu prekrytá triedou Kláves, takže môžeme použiť napríklad konštanty Kláves.VK_A, Kláves.VK_B, Kláves.VK_C…).

Parametre:

text – reťazec textu pridávanej položky ponuky

mnemonickáSkratka – kód mnemonickej skratky (príklad: Kláves.VK_A)

Návratová hodnota:

objekt novej položky ponuky (PoložkaPonuky) alebo null ak nastala chyba

Pozri tiež:

PoložkaPonuky, vymažPonuku(), pridajPoložkuPonuky(String), pridajPoložkuPonuky(String, int, int), pridajVnorenúPonuku(String, JMenuItem...), pridajOddeľovačPonuky(), pridajPoložkuPonukyVymazať(), pridajPoložkuPonukyPrekresliť(), pridajPoložkuPonukyKoniec()

pridajPolozkuPonuky

public static PolozkaPonuky pridajPolozkuPonuky(String text,
                                                int mnemonickáSkratka)

Alias pre pridajPoložkuPonuky.

pridajPoložkuPonuky
```
public static PoložkaPonuky pridajPoložkuPonuky(String text,
                                                int mnemonickáSkratka,
                                                int klávesováSkratka)
```
Funguje rovnako ako pridajPoložkuPonuky(String text, int mnemonickáSkratka) s tým, že definuje novej položke okrem mnemonickej aj klávesovú skratku (skratky, ktoré pri v položkách ponuky znázorňované v pravej časti textom Ctrl + písmeno). Skratky je možné najjednoduchšie určiť konštantou triedy KeyEvent.VK_XXX (tá je v programovacom rámci na zjednodušenie prístupu prekrytá triedou Kláves, takže môžeme použiť napríklad konštanty Kláves.VK_A, Kláves.VK_B, Kláves.VK_C…).

Parametre:

text – reťazec textu pridávanej položky ponuky

mnemonickáSkratka – kód mnemonickej skratky (príklad: Kláves.VK_A)

klávesováSkratka – kód klávesovej skratky (príklad: Kláves.VK_B)

Návratová hodnota:

objekt novej položky ponuky (PoložkaPonuky) alebo null ak nastala chyba

Pozri tiež:

PoložkaPonuky, vymažPonuku(), pridajPoložkuPonuky(String), pridajPoložkuPonuky(String, int), pridajVnorenúPonuku(String, JMenuItem...), pridajOddeľovačPonuky(), pridajPoložkuPonukyVymazať(), pridajPoložkuPonukyPrekresliť(), pridajPoložkuPonukyKoniec()

pridajPolozkuPonuky

public static PolozkaPonuky pridajPolozkuPonuky(String text,
                                                int mnemonickáSkratka,
                                                int klávesováSkratka)

Alias pre pridajPoložkuPonuky.

pridajVnorenúPonuku
```
public static JMenu pridajVnorenúPonuku(String text,
                                        JMenuItem... položky)
```
Vytvorí a pridá do hlavnej ponuky vnorenú ponuku zo zadaných položiek. Táto metóda bola pridaná podľa vzoru metódy KontextováPonuka.pridajPonuku(text, položky) na umožnenie vkladania kaskádových ponúk do hlavnej ponuky. A táto metóda tiež pracuje s rovnakými pravidlami ako uvedená metóda.

Upozornenie: Do vnorenej ponuky nie je možné vkladať inštancie triedy PoložkaPonuky, pretože tie sú implementované tak, aby sa automaticky pri svojom vytvorení pridávali do hlavnej ponuky sveta. Je však možné použiť inštancie triedy KontextováPoložka. To má však prirodzený dôsledok, že voľbu takejto položky neobsluhujeme v rámci reakcie voľbaPoložkyPonuky, ale voľbaKontextovejPoložky.

Ak má niektorá zo položiek zadaných v zozname parametrov položky hodnotu null, tak je do ponuky vložený oddeľovač.

Parametre:

text – text položky vnorenej ponuky

položky – zoznam položiek

Návratová hodnota:

vytvorená (a pridaná) ponuka

Pozri tiež:

PoložkaPonuky, vymažPonuku(), pridajPoložkuHlavnejPonuky(String), pridajPoložkuPonuky(String), pridajOddeľovačPonuky()

pridajVnorenuPonuku

public static JMenu pridajVnorenuPonuku(String text,
                                        JMenuItem... položky)

Alias pre pridajVnorenúPonuku.

pridajOddeľovačPonuky
```
public static void pridajOddeľovačPonuky()
```
Pridá do hlavnej ponuky oddeľovač. Štandardne je oddeľovač pridaný za prvé dve predvolené položky ponuky. Toto správanie nie je možné potlačiť, iba ak by ponuka bola najskôr vymazaná a znova vytvorená s vlastnou obsluhou nových položiek. Táto metóda slúži na pridávanie vlastných oddeľovačov do ponuky.

Pozri tiež:

PoložkaPonuky, vymažPonuku(), pridajPoložkuHlavnejPonuky(String), pridajPoložkuPonuky(String), pridajVnorenúPonuku(String, JMenuItem...)

pridajOddelovacPonuky
```
public static void pridajOddelovacPonuky()
```
Alias pre pridajOddeľovačPonuky.

pridajPoložkuPonukyVymazať
```
public static void pridajPoložkuPonukyVymazať()
```
Pridá do ponuky položku „Vymazať.“ Položka je jednou z preddefinovaných položiek, ktoré majú vopred definovanú funkcionalitu. Táto po zvolení vymaže a prekreslí svet.

Pozri tiež:

PoložkaPonuky, pridajPoložkuPonuky(String), pridajPoložkuPonukyPrekresliť(), pridajPoložkuPonukyKoniec()

pridajPolozkuPonukyVymazat
```
public static void pridajPolozkuPonukyVymazat()
```
Alias pre pridajPoložkuPonukyVymazať.

pridajPoložkuPonukyPrekresliť
```
public static void pridajPoložkuPonukyPrekresliť()
```
Pridá do ponuky položku „Prekresliť.“ Položka je jednou z preddefinovaných položiek, ktoré majú vopred definovanú funkcionalitu. Táto vynúti prekreslenie sveta.

Pozri tiež:

PoložkaPonuky, pridajPoložkuPonuky(String), pridajPoložkuPonukyVymazať(), pridajPoložkuPonukyKoniec()

pridajPolozkuPonukyPrekreslit
```
public static void pridajPolozkuPonukyPrekreslit()
```
Alias pre pridajPoložkuPonukyPrekresliť.

pridajPoložkuPonukyKoniec
```
public static void pridajPoložkuPonukyKoniec()
```
Pridá do ponuky preddefinovanú položku „Koniec.“ Toto je využiteľné keď sme ponuku vymazali a chceme do nej pridať túto položku, ktorej funkcionalita je vopred naprogramovaná.

Pozri tiež:

PoložkaPonuky, pridajPoložkuPonuky(String), pridajPoložkuPonukyVymazať(), pridajPoložkuPonukyPrekresliť()

pridajPolozkuPonukyKoniec
```
public static void pridajPolozkuPonukyKoniec()
```
Alias pre pridajPoložkuPonukyKoniec.

položkaPonukyVymazať
```
public static PoložkaPonuky položkaPonukyVymazať()
```
Poskytne preddefinovanú položku „Vymazať“ na prípadné úpravy. Ak položka doteraz nebola použitá, bude automaticky pridaná do hlavnej ponuky. Toto správanie nie je možné ovplyvniť. Ak je položka v ponuke nežiaduca, je potrebné ju dodatočne odstrániť.

Pozri tiež:

PoložkaPonuky, pridajPoložkuPonukyVymazať()

polozkaPonukyVymazat

public static PoložkaPonuky polozkaPonukyVymazat()

Alias pre položkaPonukyVymazať.

položkaPonukyPrekresliť
```
public static PoložkaPonuky položkaPonukyPrekresliť()
```
Poskytne preddefinovanú položku „Prekresliť“ na prípadné úpravy. Ak položka doteraz nebola použitá, bude automaticky pridaná do hlavnej ponuky. Toto správanie nie je možné ovplyvniť. Ak je položka v ponuke nežiaduca, je potrebné ju dodatočne odstrániť.

Pozri tiež:

PoložkaPonuky, pridajPoložkuPonukyPrekresliť()

polozkaPonukyPrekreslit

public static PoložkaPonuky polozkaPonukyPrekreslit()

Alias pre položkaPonukyPrekresliť.

položkaPonukyKoniec
```
public static PoložkaPonuky položkaPonukyKoniec()
```
Poskytne preddefinovanú položku „Koniec“ na prípadné úpravy.

Pozri tiež:

PoložkaPonuky, pridajPoložkuPonukyKoniec()

polozkaPonukyKoniec

public static PoložkaPonuky polozkaPonukyKoniec()

Alias pre položkaPonukyKoniec.

naRiadkyBezZmien
```
public static String[] naRiadkyBezZmien(String text)
```
Rozdelí zadaný reťazec na samostatné riadky bez ďalších úprav. Metóda berie do úvahy v prvom rade znak nového riadka (new line, '\n', ASCII 10), ktorý smie (ale nemusí) susediť so znakom návratu vozíka (carriage return, '\r', ASCII 13) z oboch strán a potom (v druhom rade) samostatný znak návratu vozíka.

Parametre:

text – text, ktorý má byť rozdelený na riadky

dĺžkaRiadka – maximálna dĺžka jednotlivých riadkov udaná v znakoch

Návratová hodnota:

pole reťazcov – jednotlivé riadky pôvodného textu

Pozri tiež:

textNaRiadky(String, int), textNaRiadky(String, int, boolean)

textNaRiadky
```
public static String[] textNaRiadky(String text,
                                    int dĺžkaRiadka)
```
Rozdelí dlhý text na riadky s maximálnou zadanou dĺžkou v znakoch.

Poznámka: Metóda zmení všetky znaky tabulátorov na medzery.

Parametre:

text – text, ktorý má byť rozdelený na riadky

dĺžkaRiadka – maximálna dĺžka jednotlivých riadkov udaná v znakoch

Návratová hodnota:

pole reťazcov – jednotlivé riadky pôvodného textu

Pozri tiež:

textNaRiadky(String, int, boolean), naRiadkyBezZmien(String)

textNaRiadky
```
public static String[] textNaRiadky(String text,
                                    int dĺžkaRiadka,
                                    boolean zachovajMedzery)
```
Rozdelí dlhý text na riadky s maximálnou zadanou dĺžkou v znakoch.

Poznámka: Metóda zmení všetky znaky tabulátorov na medzery.

Parametre:

text – text, ktorý má byť rozdelený na riadky

dĺžkaRiadka – maximálna dĺžka jednotlivých riadkov udaná v znakoch

zachovajMedzery – ak je false, medzery budú redukované na minimum – medzery na koncoch a začiatkoch riadkov budú odstránené a viacnásobné medzery medzi slovami budú redukované na jedinú medzeru

Návratová hodnota:

pole reťazcov – jednotlivé riadky pôvodného textu

Pozri tiež:

textNaRiadky(String, int), naRiadkyBezZmien(String)

orež

public static CharSequence orež(CharSequence sekvenciu,
                                CharSequence znakmi)

Oreže sekvenciu znakov prvého parametra o znaky zadané do sekvencie znakov druhého parametra. Orezanie v tomto kontexte znamená odstránenie určitých znakov zo začiatku a konca sekvencie, pričom zoznam znakov, ktoré majú byť vynechané obsahuje sekvencia zadaná do druhého parametra.

Niekoľko príkladov tabuliek orezávania:

reťazec/rez	`"nami"`	`"SR"`
`"Riman"`	`"R"`	`"iman"`
`"Ramin"`	`"R"`	`"amin"`
`"SONAR"`	`"SONAR"`	`"ONA"`

reťazec/rez	`"Kadejkuvyč"`	`"Kadejkuvyčž "`	`"KadejkuvyčŽ"`
`"KedyŽujeŤavaŽuvačku"`	`"ŽujeŤavaŽ"`	`"ŽujeŤavaŽ"`	`"Ť"`
`"Kedy žuje ťava žuvačku"`	`" žuje ťava ž"`	`"ť"`	`" žuje ťava ž"`

reťazec/rez	`" "`	`"\tnrme "`	`"\r\n\t"`	`"\r\n\ttil"`	`"\r\n\t "`
`"zrej me "`	`"zrej me"`	`"zrej"`	`"zrej me "`	`"zrej me "`	`"zrej me"`
`" zrej me"`	`"zrej me"`	`"zrej"`	`" zrej me"`	`" zrej me"`	`"zrej me"`
`"\t neo \t \r\n lit\n"`	`"\t neo \t \r\n lit\n"`	`"o \t \r\n lit\n"`	`" neo \t \r\n lit"`	`" neo \t \r\n "`	`"neo \t \r\n lit"`
`"\n lot \t \r\n eni\t"`	`"\n lot \t \r\n eni\t"`	`"\n lot \t \r\n eni"`	`" lot \t \r\n eni"`	`" lot \t \r\n en"`	`"lot \t \r\n eni"`
`" \t\r\n\t "`	`"\t\r\n\t"`	`"\r\n"`	`" \t\r\n\t "`	`" \t\r\n\t "`	`""`

Parametre:: sekvenciu – sekvencia znakov, ktorá má byť orezaná; znakmi – sekvencia znakov obsahujúca znaky, ktoré majú byť orezané
Návratová hodnota:: buď pôvodná sekvencia znakov, ak nenastala žiadna zmena, alebo sekvencia znakov, ktorá na svojom začiatku a konci neobsahuje znaky obsiahnuté v sekvencii druhého parametra

orez

public static CharSequence orez(CharSequence sekvenciu,
                                CharSequence znakmi)

Alias pre orež.

orež
```
public static String orež(String reťazec,
                          String znakmi)
```
Oreže reťazec prvého parametra o znaky zadané do reťazca druhého parametra. Orezanie v tomto kontexte znamená odstránenie určitých znakov zo začiatku a konca reťazca. Zoznam znakov, ktoré majú byť vynechané obsahuje druhý parameter.

Príklady orezávania usporiadané v tabuľkách sú v opise metódy orež(sekvenciu, znakmi).

Parametre:

reťazec – reťazec, ktorý má byť orezaný

znakmi – reťazec obsahujúci znaky, ktoré majú byť orezané

Návratová hodnota:

buď pôvodný reťazec, ak nenastala žiadna zmena, alebo reťazec, ktorý na svojom začiatku a konci neobsahuje znaky obsiahnuté v druhom parametri

orez

public static String orez(String reťazec,
                          String znakmi)

Alias pre orež.

oddeľovačPrvkovPoľa
```
public static String oddeľovačPrvkovPoľa()
```
Zistí, aký oddeľovač prvkov je aktuálne používaný pri výpisoch polí príkazmi vypíš, vypíšRiadok.

Návratová hodnota:

oddeľovač prvkov poľa (reťazec)

Pozri tiež:

formát, oddeľovačPrvkovPoľa(String), oddeľovačDesatinnejČasti(char), oddeľovačTisícov(Character), vypíš(Object[]), F(double, int), F(double, int, int), GRobot.F(double, int), GRobot.F(double, int, int)

oddelovacPrvkovPola
```
public static String oddelovacPrvkovPola()
```
Alias pre oddeľovačPrvkovPoľa.

oddeľovačPrvkovPoľa
```
public static void oddeľovačPrvkovPoľa(String oddeľovač)
```
Nastaví hodnotu oddeľovača prvkov poľa, ktorý bude používaný pri výpisoch polí príkazmi vypíš, vypíšRiadok.

Parametre:

oddeľovač – nový oddeľovač prvkov poľa

Pozri tiež:

formát, oddeľovačPrvkovPoľa(), oddeľovačDesatinnejČasti(char), oddeľovačTisícov(Character), vypíš(Object[]), F(double, int), F(double, int, int), GRobot.F(double, int), GRobot.F(double, int, int)

oddelovacPrvkovPola

public static void oddelovacPrvkovPola(String oddeľovač)

Alias pre oddeľovačPrvkovPoľa.

oddeľovačDesatinnejČasti
```
public static char oddeľovačDesatinnejČasti()
```
Zistí, aký oddeľovač desatinnej časti je aktuálne používaný pri výpisoch čísiel príkazmi vypíš, vypíšRiadok. Tento oddeľovač je braný do úvahy aj pri rozpoznávaní číselných hodnôt rôznymi metódami vstupu.

Návratová hodnota:

oddeľovač desatinnej časti

Pozri tiež:

formát, oddeľovačPrvkovPoľa(String), oddeľovačDesatinnejČasti(char), oddeľovačTisícov(Character), vypíš(Object[]), F(double, int), F(double, int, int), GRobot.F(double, int), GRobot.F(double, int, int)

oddelovacDesatinnejCasti
```
public static char oddelovacDesatinnejCasti()
```
Alias pre oddeľovačDesatinnejČasti.

oddeľovačDesatinnejČasti
```
public static void oddeľovačDesatinnejČasti(char oddeľovač)
```
Nastaví hodnotu oddeľovača desatinnej časti, ktorý bude používaný pri výpisoch príkazmi vypíš, vypíšRiadok. Zadaný oddeľovač bude vzatý do úvahy aj pri rozpoznávaní číselných hodnôt rôznymi metódami vstupu.

Parametre:

oddeľovač – nový oddeľovač desatinnej časti

Pozri tiež:

formát, oddeľovačPrvkovPoľa(String), oddeľovačDesatinnejČasti(), oddeľovačTisícov(Character), vypíš(Object[]), F(double, int), F(double, int, int), GRobot.F(double, int), GRobot.F(double, int, int)

oddelovacDesatinnejCasti

public static void oddelovacDesatinnejCasti(char oddeľovač)

Alias pre oddeľovačDesatinnejČasti.

oddeľovačTisícov
```
public static Character oddeľovačTisícov()
```
Zistí, aký oddeľovač tisícov je aktuálne používaný pri výpisoch čísiel príkazmi vypíš, vypíšRiadok. Tento oddeľovač je braný do úvahy aj pri rozpoznávaní číselných hodnôt rôznymi metódami vstupu. Ak oddeľovač tisícov nie je použitý (to znamená, že celá časť čísla je vždy vypísaná spolu a tisíce nie sú oddeľované), tak je výsledkom tejto metódy hodnota null.

Návratová hodnota:

oddeľovač tisícov alebo null

Pozri tiež:

formát, oddeľovačPrvkovPoľa(String), oddeľovačDesatinnejČasti(char), oddeľovačTisícov(Character), vypíš(Object[]), F(double, int), F(double, int, int), GRobot.F(double, int), GRobot.F(double, int, int)

oddelovacTisicov

public static Character oddelovacTisicov()

Alias pre oddeľovačTisícov.

oddeľovačTisícov
```
public static void oddeľovačTisícov(Character oddeľovač)
```
Nastaví hodnotu oddeľovača tisícov, ktorý bude používaný pri výpisoch príkazmi vypíš, vypíšRiadok. Zadaný oddeľovač bude vzatý do úvahy aj pri rozpoznávaní číselných hodnôt rôznymi metódami vstupu. Ak je požadované, aby vo výpisoch tisíce neboli oddeľované, tak je potrebné vložiť hodnotu null.

Parametre:

oddeľovač – nový oddeľovač tisícov alebo null

Pozri tiež:

formát, oddeľovačPrvkovPoľa(String), oddeľovačDesatinnejČasti(char), oddeľovačTisícov(), vypíš(Object[]), F(double, int), F(double, int, int), GRobot.F(double, int), GRobot.F(double, int, int)

oddelovacTisicov

public static void oddelovacTisicov(Character oddeľovač)

Alias pre oddeľovačTisícov.

F
```
public static String F(double číslo,
                       int desatinné)
```
Táto metóda slúži na jednoduché formátovanie reálnych čísiel. Prijíma reálne číslo a hodnotu počtu desatinných miest, ktoré majú byť zobrazené. Na jednoduchšie používanie je rovnaká metóda definovaná aj v triede GRobot: F(číslo, desatinné). (V jej opise je uvedený aj príklad použitia a ďalšie fakty.) Metóda má ešte jednu verziu: Svet.F(číslo, šírka, desatinné).

Parametre:

číslo – hodnota, ktorá má byť naformátovaná

desatinné – počet desatinných miest, ktoré majú byť uvedené vo výslednom (naformátovanom) tvare

Pozri tiež:

formát, oddeľovačPrvkovPoľa(String), oddeľovačDesatinnejČasti(char), oddeľovačTisícov(Character), vypíš(Object[]), F(double, int, int), GRobot.F(double, int), GRobot.F(double, int, int)

F
```
public static String F(double číslo,
                       int šírka,
                       int desatinné)
```
Táto metóda slúži na jednoduché formátovanie reálnych čísiel. Prijíma reálne číslo, potom hodnotu určujúcu šírku výsledného reťazca (počet znakov), na ktorú má byť zarovnaný zľava a nakoniec počet desatinných miest, ktoré majú byť zobrazené. Na jednoduchšie používanie je rovnaká metóda definovaná aj v triede GRobot: F(číslo, šírka, desatinné). (V jej opise je uvedený aj príklad použitia a ďalšie fakty.) Metóda má ešte jednu verziu: Svet.F(číslo, desatinné).

Parametre:

číslo – hodnota, ktorá má byť naformátovaná

šírka – najmenší počet znakov výsledného naformátovaného reťazca (pri krátkych číslach budú chýbajúce znaky doplnené medzerami)

desatinné – počet desatinných miest, ktoré majú byť uvedené vo výslednom (naformátovanom) tvare

Pozri tiež:

formát, oddeľovačPrvkovPoľa(String), oddeľovačDesatinnejČasti(char), oddeľovačTisícov(Character), vypíš(Object[]), F(double, int), GRobot.F(double, int), GRobot.F(double, int, int)

S
```
public static String S(Object... argumenty)
```
Táto metóda slúži na rýchly prevod rôznych objektov do textovej podoby a ich zlúčenie do jedného reťazca. Pri zlučovaní používa rovnaké pravidlá, aké sú opísané v opise metódy Plátno.vypíš(argumenty). Súvisí to napríklad so spôsobom pridávania medzier medzi reťazce zlučovaných argumentov, automatickým formátovaním čísiel a podobne. Na jednoduchšie používanie je rovnaká metóda definovaná aj v triede GRobot: S(argumenty). (V jej opise je uvedená aj ukážka použitia a ďalšie fakty.)

Parametre:

argumenty – zoznam argumentov rôzneho údajového typu oddelený čiarkami

Pozri tiež:

vypíš(Object[]), GRobot.S(Object[])

zaokrúhli
```
public static double zaokrúhli(double hodnota,
                               int miest)
```
Zaokrúhli zadané číslo na zadaný počet (desatinných) miest. Počet miest rovný nule znamená zaokrúhlenie na celé číslo (myslené iba terminologicky, pretože vrátená hodnota je vždy údajového typu double). Ak je zadaný záporný počet miest na zaokrúhlenie, tak bude výsledné číslo zaokrúhlené na počet miest pred desatinnou čiarkou (desiatky, stovky…). Pri zaokrúhľovaní je uplatnené pravidlo „half up“ (od polovice nahor), to znamená, že hodnoty 0 – 4 na pozícii zaokrúhlenia zaokrúhľujú výsledok smerom nadol a 5 – 9 nahor.

Parametre:

hodnota – hodnota, ktorá má byť zaokrúhlená

miest – počet (desatinných) miest, ktoré majú byť zachované

Návratová hodnota:

výsledná zaokrúhlená hodnota

zaokruhli

public static double zaokruhli(double hodnota,
                               int miest)

Alias pre zaokrúhli.

ikona
```
public static void ikona(String súbor)
```
Nastaví oknu aplikácie novú ikonu.

Ikona prečítaná zo súboru je prevedená z obrázka, ktorý je chápaný ako zdroj a ktorý po prečítaní zostane uložený vo vnútornej pamäti sveta rovnako ako prevedená verzia ikony. Obidva objekty môžu byť v prípade potreby (napríklad ak sa obsah súboru na disku zmenil) z vnútornej pamäte odstránené metódou Svet.uvoľni(názovZdroja). (Táto informácia je platná pre všetky metódy pracujúce s obrázkami (resp. ikonami) alebo zvukmi, ktoré prijímajú názov súboru ako parameter.)

Poznámka: Z dôvodu konzistencie by k tejto metóde mal byť definovaný alias obrazok(súbor) (bez diakritiky), ktorý by korešpondoval s rovnakým aliasom metódy ikona(), podobne ako je to v triedach kontextových a klasických položiek ponuky. V tejto triede to však nie je možné, pretože už obsahuje definíciu metódy obrazok(súbor) (ktorá je aliasom metódy obrázok(súbor) – s diakritikou). Nie je to závažný technický problém, pretože metódy sú navrhnuté tak, aby boli univerzálne. Je to iba „kozmetický“ problém.

Parametre:

súbor – názov súboru s obrázkom

Výnimky:

GRobotException – ak súbor s obrázkom nebol nájdený

Pozri tiež:

priečinokObrázkov(String)

ikona
```
public static void ikona(Image obrázok)
```
Nastaví oknu aplikácie ikonu podľa zadaného obrázka.

Parametre:

obrázok – obrázok slúžiaci ako predloha pre ikonu

ikona
```
public static Obrazok ikona()
```
Prečíta ikonu okna aplikácie a prevedie ju na obrázok.

Poznámka: Táto metóda vracia objekt typu Obrazok (t. j. triedy, ktorá je aliasom triedy Obrázok). Dôvod je uvedený v poznámke v opise metódy ikona(súbor).

Návratová hodnota:

obrázok s ikonou

novýKurzorMyši

public static void novýKurzorMyši(Image predloha,
                                  int x,
                                  int y,
                                  String meno)

Definuje nový kurzor myši použiteľný v hlavnom okne aplikácie. Tvar kurzora určí aktuálna grafika zadaného obrázka (neskoršie zmeny grafiky obrázka sa v kurzore neprejavia; môže byť použitý aj objekt typu Obrázok). Súradnice x a y určujú aktívny bod kurzora (hot spot), t. j. bod, ktorý bude považovaný za „špičku,“ či „stred“ nového kurzora (terminológia záleží na tvare kurzora – pri niečom ako šípka by sme to skôr pomenovali špičkou a pri niečom ako terčík stredom) v rámci súradnicového priestoru obrázka, pričom súradnice [0, 0] určujú počiatok súradnicovej sústavy umiestnený v strede obrázka (rovnako ako všade v tomto programovacom rámci; tiež y-ová súradnica stúpa smerom nahor – v súlade s princípmi tohto programovacieho rámca). Rozsah súradníc je určený rozmermi obrázka. Odporúčame zvoliť také rozmery obrázka, ktoré sú štandardné pre kurzory, napríklad 32 × 32 bodov, inak by mohol vzniknúť neželaný posun aktívneho bodu kurzora (spôsobený mechanizmami individuálneho operačného systému, ktoré nie sú v moci tohto rámca). Názov kurzora musí byť jedinečný v rámci pomenovaní vlastných kurzorov. (Môže byť rovnaký ako názov systémového kurzora – pozri zmeňKurzorMyši – čím sa systémový kurzor prekryje, ale nesmie byť rovnaký ako názov jestvujúceho vlastného kurzora – vytvoreného touto alebo príbuznou metódou rámca.) Tento názov treba použiť pri volaní metódy zmeňKurzorMyši.

Príklad:

Obrázok ihla = new Obrázok(32, 32);

kresliDoObrázka(ihla);
hrúbkaČiary(2.5);

farba(tyrkysová);
choďNa(-16, -16);

domov();
farba(modrá);
kruh(4.5);

Svet.novýKurzorMyši(ihla, -15, -15, "ihla");
Svet.zmeňKurzorMyši("ihla");

Maličký výrez plátna so zobrazeným novým kurzorom nad ním.

Parametre:: predloha – obrázok, ktorého grafika bude použitá na vytvorenie kurzora; x – x-ová súradnica aktívneho bodu nového kurzora; y – y-ová súradnica aktívneho bodu nového kurzora; meno – meno kurzora, ktoré bude neskôr použité pri volaní metódy zmeňKurzorMyši
Výnimky:: GRobotException – ak kurzor so zadaným menom už jestvuje
Pozri tiež:: zmeňKurzorMyši(String), zmeňNovýKurzorMyši(Image, int, int, String)

novyKurzorMysi

public static void novyKurzorMysi(Image predloha,
                                  int x,
                                  int y,
                                  String meno)

Alias pre novýKurzorMyši.

novýKurzorMyši

public static void novýKurzorMyši(Image predloha,
                                  double x,
                                  double y,
                                  String meno)

Alias pre novýKurzorMyši.

novyKurzorMysi

public static void novyKurzorMysi(Image predloha,
                                  double x,
                                  double y,
                                  String meno)

Alias pre novýKurzorMyši.

zmeňKurzorMyši
```
public static void zmeňKurzorMyši(String meno)
```
Zmení hlavnému oknu tvar kurzora myši buď na vlastný tvar kurzora vytvorený prostredníctvom metódy novýKurzorMyši (prípadne zmeňNovýKurzorMyši), alebo na niektorý zo systémom preddefinovaných kurzorov. Systémové kurzory majú nasledujúce preddefinované názvy: "predvolený", "mieridlo", "text", "čakaj", "jzZmeniťVeľkosť", "jvZmeniťVeľkosť", "szZmeniťVeľkosť", "svZmeniťVeľkosť", "sZmeniťVeľkosť", "jZmeniťVeľkosť", "zZmeniťVeľkosť", "vZmeniťVeľkosť", "ruka", "presunúť". Ak namiesto názvu kurzora zadáte null, bude použitý prázdny (neviditeľný) kurzor.

Poznámka: Testy ukázali, že táto metóda nemá vplyv na tvar kurzora v režime celej obrazovky v operačnom systéme Windows s viacerými zobrazovacími zariadeniami. Je možné, že nastavenie tvaru kurzora nebude fungovať aj v iných situáciách súvisiacich s režimom celej obrazovky.

Parametre:

meno – názov vlastného kurzora, systémového kurzora alebo null

Výnimky:

GRobotException – ak kurzor so zadaným menom nejestvuje

Pozri tiež:

novýKurzorMyši(Image, int, int, String), zmeňNovýKurzorMyši(Image, int, int, String)

zmenKurzorMysi

public static void zmenKurzorMysi(String meno)

Alias pre zmeňKurzorMyši.

zmeňNovýKurzorMyši

public static void zmeňNovýKurzorMyši(Image predloha,
                                      int x,
                                      int y,
                                      String meno)

Táto metóda je kombináciou volania metód novýKurzorMyši a zmeňKurzorMyši. Platia pre ňu rovnaké pravidlá ako pre uvedené dve metódy…

Pozri tiež:: novýKurzorMyši(Image, int, int, String), zmeňKurzorMyši(String)

zmenNovyKurzorMysi

public static void zmenNovyKurzorMysi(Image predloha,
                                      int x,
                                      int y,
                                      String meno)

Alias pre zmeňNovýKurzorMyši.

zmeňNovýKurzorMyši

public static void zmeňNovýKurzorMyši(Image predloha,
                                      double x,
                                      double y,
                                      String meno)

Alias pre zmeňNovýKurzorMyši.

zmenNovyKurzorMysi

public static void zmenNovyKurzorMysi(Image predloha,
                                      double x,
                                      double y,
                                      String meno)

Alias pre zmeňNovýKurzorMyši.

systémováIkona
```
public static TrayIcon systémováIkona()
```
Vráti objekt systémovej ikony sveta, ak je definovaná.

Návratová hodnota:

buď objekt typu TrayIcon, alebo null

systemovaIkona

public static TrayIcon systemovaIkona()

Alias pre systémováIkona.

systémováIkona

public static boolean systémováIkona(String popis,
                                     Image ikona,
                                     String... položkyPonuky)

Definuje alebo aktualizuje systémovú ikonu nazývanú aj ikonou v systémovej oblasti alebo v oblasti oznámení (angl. system tray). Pri prvom volaní metódy ide o vytvorenie ikony. Vtedy nesmie byť ikona prázdna (null). Položky kontextovej ponuky sú určené voliteľným zoznamom reťazcov, v ktorom hodnota null znamená oddeľovač. Ak vytvorenie alebo aktualizácia zlyhá, tak metóda vráti hodnotu false.

Príklad:

Tento príklad ukazuje vytvorenie primitívnej aplikácie, ktorá sa po zatvorení hlavého okna aplikácie skryje/presunie do ikony v systémovej oblasti.

import knižnica.*;

public class AplikáciaVSystémovejOblasti extends GRobot
{
    // Tento atribút bude riadiť to, či pri pokuse o zavretie okna okno iba
    // skryjeme alebo vykonáme predvolenú akciu (zavrieme aplikáciu):
    private boolean skry = false;

    private AplikáciaVSystémovejOblasti()
    {
        // Nastavenie titulku okna.
        super("Aplikácia v systémovej oblasti…");

        // Vyrobenie grafiky ikony a jej použitie ako ikony aplikácie.
        Obrázok ikona = new Obrázok(32, 32);
        ikona.vyplň(žltá);
        kresliDoObrázka(ikona);
        kruh(12);
        kresliNaPodlahu();
        Svet.ikona(ikona);

        // Pokúsime sa vytvoriť systémovú ikonu s práve vytvorenou grafikou
        // a dvomi položkami kontextovej ponuky:
        if (Svet.systémováIkona(ikona, "Obnoviť", null, "Ukončiť"))
        {
            // Ak je systémová ikona podporovaná, tak povolíme skrývanie
            // namiesto zatvárania:
            skry = true;

            // Poznámka: Keby sme zmenili akciu zatvorenia okna z predvoleného
            // zavretia aplikácie na jej skrytie (riadky s naznačeným
            // komentárom nižšie, dosiahli by sme nekonistentné správanie
            // systémových ovládacích prvkov a položky ponuky Koniec.
            // Systémové prvky (ako je systémová ikona zavretia okna a položka
            // systémovej ponuky Zavrieť) by okno skrývali a položka ponuky
            // Koniec by iba posielala správu o zavretí okna. (Keby sme túto
            // správu iba zamietli reakciou zavretie a nevykonali nič iné, tak
            // položka by v podstate prestala fungovať.)
            // svet.setDefaultCloseOperation(
            //  javax.swing.JFrame.HIDE_ON_CLOSE);

                // (poznámka: teraz má používateľ len dve možnosti zavretia
                // tejto aplikácie s použitím jej grafického používateľského
                // rozhrania – predvolenou položkou „Koniec“ v hlavnej ponuke
                // alebo zvolením kontextovej položky „Ukončiť“ v kontextovej
                // ponuke systémovej ikony)

            // …a vypíšeme o tom do okna informáciu:
            skoč(15);
            text("Tlačidlo „Zavrieť“ okna aplikácie teraz");
            odskoč(30);
            text("slúži na jeho skrytie do systémovej oblasti.");

            // Systémovú ikonu nateraz skryjeme.
            Svet.zobrazSystémovúIkonu(false);
        }
        else
        {
            // V opačnom prípade vypíšeme informáciu o tom, že systém túto
            // vlastnosť nepodporuje (alebo jej použitiu bránia iné okolnosti).
            farba(červená);
            text("Systémová ikona nie je podporovaná.");
        }

        // Skryjeme robot a vystredíme okno aplikácie.
        skry();
        Svet.vystreď();
    }

    @Override public void voľbaSystémovejIkony()
    {
        // Predvolenou akciou dvojitého kliknutia na ikonu v systémovej oblasti
        // bude skrytie systémovej ikony a zobrazenie okna aplikácie (ak je
        // skryté).
        Svet.zobrazSystémovúIkonu(false);
        if (!Svet.viditeľný()) Svet.zobraz();
    }

    @Override public void voľbaSystémovejPoložky()
    {
        switch (ÚdajeUdalostí.položkaSystémovejPonuky())
        {
        case 0:
            // Prvá položka kontextovej ponuky bude vykonávať rovnakú akciu
            // ako dvojklik na systémovú ikonu.
            voľbaSystémovejIkony();
            break;

            // Poznámka: Index 1 má oddeľovač.

        case 2:
            // Druhá položka (technicky tretia) kontextovej ponuky aplikáciu
            // ukončí.
            Svet.koniec();
            break;
        }
    }

    @Override public boolean zavretie()
    {
        if (skry)
        {
            // Touto vetvou vypneme klasickú akciu zavretia okna.
            Svet.skry();
            return false;
        }

        return true;
    }

    @Override public void skrytieOkna()
    {
        // Pri skrytí okna aplikácie bude zobrazená systémová ikona.
        Svet.zobrazSystémovúIkonu(true);
    }

    public static void main(String... args)
    {
        Svet.skry();
        new AplikáciaVSystémovejOblasti();
        Svet.zobraz();
    }
}

Výsledok:

Okno aplikácie po spustení v stave, keď je
ikona v systémovej oblasti podporovaná.


Ikona aplikácie na paneli úloh.	Ikona aplikácie (s ponukou) v systémovej oblasti.

Parametre:: popis – popis zobrazovaný pri ukázaní na ikonu v systémovej oblasti; ikona – obrázok určujúci vzhľad ikony v systémovej oblasti; položkyPonuky – voliteľný zoznam reťazcov, z ktorých bude vytvorená kontextová ponuka ikony
Návratová hodnota:: true pri úspechu; false v opačnom prípade

systemovaIkona

public static boolean systemovaIkona(String popis,
                                     Image ikona,
                                     String... položkyPonuky)

Alias pre systémováIkona.

systémováIkona
```
public static boolean systémováIkona(String popis,
                                     String... položkyPonuky)
```
Aktualizuje jestvujúcu ikonu v systémovej oblasti. Ďalšie podrobnosti čítajte v opise metódy systémováIkona(popis, ikona, položkyPonuky).

Parametre:

popis – popis zobrazovaný pri ukázaní na ikonu v systémovej oblasti

položkyPonuky – voliteľný zoznam reťazcov, z ktorých bude vytvorená kontextová ponuka ikony

Návratová hodnota:

true pri úspechu; false v opačnom prípade

systemovaIkona

public static boolean systemovaIkona(String popis,
                                     String... položkyPonuky)

Alias pre systémováIkona.

systémováIkona
```
public static boolean systémováIkona(Image ikona,
                                     String... položkyPonuky)
```
Definuje alebo aktualizuje ikonu v systémovej oblasti. Pri prvom volaní metódy ide o vytvorenie ikony, vtedy nesmie byť ikona prázdna (null). Ďalšie podrobnosti čítajte v opise metódy systémováIkona(popis, ikona, položkyPonuky).

Parametre:

ikona – obrázok určujúci vzhľad ikony v systémovej oblasti

položkyPonuky – voliteľný zoznam reťazcov, z ktorých bude vytvorená kontextová ponuka ikony

Návratová hodnota:

true pri úspechu; false v opačnom prípade

systemovaIkona

public static boolean systemovaIkona(Image ikona,
                                     String... položkyPonuky)

Alias pre systémováIkona.

systémováIkonaZobrazená
```
public static boolean systémováIkonaZobrazená()
```
Zistí, či je jestvujúca ikona v systémovej oblasti zobrazená.

Návratová hodnota:

booleovská hodnota určujúca, či je ikona viditeľná

systemovaIkonaZobrazena
```
public static boolean systemovaIkonaZobrazena()
```
Alias pre systémováIkonaZobrazená.

zobrazSystémovúIkonu
```
public static boolean zobrazSystémovúIkonu(boolean zobraz)
```
Zobrazí alebo skryje jestvujúcu ikonu v systémovej oblasti.

Parametre:

zobraz – booleovská hodnota určuje, či má byť ikona zobrazená alebo skrytá

Návratová hodnota:

true pri úspechu; false v opačnom prípade

zobrazSystemovuIkonu

public static boolean zobrazSystemovuIkonu(boolean zobraz)

Alias pre zobrazSystémovúIkonu.

správaSystémovejIkony
```
public static boolean správaSystémovejIkony(String správa,
                                            String titulok)
```
Ak je definovaná systémová ikona, tak v jej kontexte zobrazí zadanú správu s titulkom.

Parametre:

správa – text správy

titulok – text titulku

Návratová hodnota:

true pri úspechu; false v opačnom prípade

správaSystémovejIkony
```
public static boolean správaSystémovejIkony(String správa)
```
Ak je definovaná systémová ikona, tak v jej kontexte zobrazí zadanú správu.

Parametre:

správa – text správy

Návratová hodnota:

true pri úspechu; false v opačnom prípade

spravaSystemovejIkony

public static boolean spravaSystemovejIkony(String správa,
                                            String titulok)

Alias pre správaSystémovejIkony.

spravaSystemovejIkony

public static boolean spravaSystemovejIkony(String správa)

Alias pre správaSystémovejIkony.

informáciaSystémovejIkony
```
public static boolean informáciaSystémovejIkony(String informácia,
                                                String titulok)
```
Ak je definovaná systémová ikona, tak v jej kontexte zobrazí zadané informačné oznámenie s titulkom.

Parametre:

informácia – text informácie

titulok – text titulku

Návratová hodnota:

true pri úspechu; false v opačnom prípade

informáciaSystémovejIkony
```
public static boolean informáciaSystémovejIkony(String informácia)
```
Ak je definovaná systémová ikona, tak v jej kontexte zobrazí zadané informačné oznámenie.

Parametre:

informácia – text informácie

Návratová hodnota:

true pri úspechu; false v opačnom prípade

informaciaSystemovejIkony

public static boolean informaciaSystemovejIkony(String informácia,
                                                String titulok)

Alias pre informáciaSystémovejIkony.

informaciaSystemovejIkony

public static boolean informaciaSystemovejIkony(String informácia)

Alias pre informáciaSystémovejIkony.

varovanieSystémovejIkony
```
public static boolean varovanieSystémovejIkony(String varovanie,
                                               String titulok)
```
Ak je definovaná systémová ikona, tak v jej kontexte zobrazí zadané varovné oznámenie s titulkom.

Parametre:

varovanie – text varovania

titulok – text titulku

Návratová hodnota:

true pri úspechu; false v opačnom prípade

varovanieSystémovejIkony
```
public static boolean varovanieSystémovejIkony(String varovanie)
```
Ak je definovaná systémová ikona, tak v jej kontexte zobrazí zadané varovné oznámenie.

Parametre:

varovanie – text varovania

Návratová hodnota:

true pri úspechu; false v opačnom prípade

varovanieSystemovejIkony

public static boolean varovanieSystemovejIkony(String varovanie,
                                               String titulok)

Alias pre varovanieSystémovejIkony.

varovanieSystemovejIkony

public static boolean varovanieSystemovejIkony(String varovanie)

Alias pre varovanieSystémovejIkony.

chybaSystémovejIkony
```
public static boolean chybaSystémovejIkony(String chyba,
                                           String titulok)
```
Ak je definovaná systémová ikona, tak v jej kontexte zobrazí zadané chybové oznámenie s titulkom.

Parametre:

chyba – text chyby

titulok – text titulku

Návratová hodnota:

true pri úspechu; false v opačnom prípade

chybaSystémovejIkony
```
public static boolean chybaSystémovejIkony(String chyba)
```
Ak je definovaná systémová ikona, tak v jej kontexte zobrazí zadané chybové oznámenie.

Parametre:

chyba – text chyby

Návratová hodnota:

true pri úspechu; false v opačnom prípade

chybaSystemovejIkony

public static boolean chybaSystemovejIkony(String chyba,
                                           String titulok)

Alias pre chybaSystémovejIkony.

chybaSystemovejIkony

public static boolean chybaSystemovejIkony(String chyba)

Alias pre chybaSystémovejIkony.

koniec
```
public static void koniec()
```
Skončí aplikáciu bez opýtania. Pozri aj koniec(kód).

Pozri tiež:

zavrieť()

koniec
```
public static void koniec(int kód)
```
Skončí aplikáciu s návratovým kódom pre opreračný systém. Ukončenie je okamžité, na rozdiel od metódy zavrieť, ktorá generuje udalosť zavretia okna (ktorá môže byť odmietnutá).

Parametre:

kód – celočíselný návratový kód, ktorý je schopný prijať operačný systém

Pozri tiež:

zavrieť()

obrázok
```
public static BufferedImage obrázok()
```
Vráti objekt typu BufferedImage obsahujúci aktuálnu obrazovú informáciu sveta. Vrátený objekt obsahuje zobrazenie spájajúce dohromady grafiky plátien, robotov, spojníc, konzolových textov a tak podobne. Tento objekt je pravidelne aktualizovaný, takže akékoľvek zmeny v ňom budú mať krátke trvanie. Vrátený objekt je skôr vhodný na získanie aktuálnej verzie grafickej informácie sveta.

Vrátený objekt (typu BufferedImage) nemá prispôsobený súradnicový priestor potrebám programovacieho rámca GRobot – pracuje v rovnakom súradnicovom systéme ako všetky grafické objekty Javy – začiatok súradnicovej sústavy je umiestnený v ľavom hornom rohu obrázka a y-ové súradnice sú v porovnaní s klasickým kartéziánskym súradnicovým systémom zrkadlovo prevrátené, to znamená, že y-ová súradnica stúpa smerom nadol.

(O súradnicových priestoroch sa podrobnejšie píše napríklad v opisoch metód GRobot.cesta(), SVGpodpora.zapíš(…), SVGpodpora.čítaj(meno) a priebežne v celej dokumentácii.)

Návratová hodnota:

objekt typu BufferedImage obsahujúci aktuálnu obrazovú informáciu sveta

Pozri tiež:

grafika()

obrazok
```
public static BufferedImage obrazok()
```
Alias pre obrázok.

grafika
```
public static Graphics2D grafika()
```
Vráti grafický objekt sveta na kreslenie v reakcii ObsluhaUdalostí.dokreslenie(). Tento objekt pracuje v súradnicovom priestore Javy a všetko, čo pomocou neho nakreslíte, bude na obrazovke zobrazené len do najbližšieho prekreslenia. Jeho používanie je vyhradené viac-menej iba pre skúsených programátorov. Žiadny robot nedokáže priamo kresliť do tohto objektu, ale niektoré metódy robotov môžu byť využité, napríklad na generovanie tvarov, ktoré kresliace metódy tohto objektu dokážu akceptovať.

(Objekty generované robotmi sú vygenerované tak, aby boli použiteľné v súradnicovom priestore Javy, teda aj tohto objektu. O súradnicových priestoroch sa podrobnejšie píše napríklad v opisoch metód GRobot.cesta(), SVGpodpora.zapíš(…), SVGpodpora.čítaj(meno) a priebežne v celej dokumentácii.)

Pozri tiež:

obrázok()

údržba
```
public static long údržba()
```
Po pamäťovo náročných operáciách môže byť vhodné uvoľniť systémové prostriedky. Metóda sa pokúsi uvoľniť čo najviac nepoužívaných prostriedkov. Vráti informáciu o objeme uvoľnenej pamäte.

Návratová hodnota:

množstvo uvoľnenej pamäte

udrzba
```
public static long udrzba()
```
Alias pre údržba.

uvoľni
```
public static void uvoľni(GRobot ktorý)
```
Metóda slúži na odstránenie konkrétneho robota (alebo inštancie odvodeného typu) z vnútorného zoznamu robotov. Prijíma jeden argument typu GRobot (to znamená, že môže ísť aj o hocijakú inštanciu odvodeného údajového typu). Zadaný objekt bude potom vymazaný z vnútorného zoznamu robotov. Keď aplikácia zabezpečí aj vynulovanie všetkých ostatných premenných, v ktorých je stanovená inštancia uložená, objekt by mal byť (resp. bude, aj keď možno nie hneď) uvoľnený z pamäte počítača zberačom odpadkov Javy. Uvoľnený robot už nie je možné do sveta vrátiť! V prípade, že je uvoľnený hlavný robot, nastúpi na jeho miesto najbližší jestvujúci robot. Problém by mohol nastať, keby nie je k dispozícii žiadny ďalší robot, ktorý by ho mohol nahradiť.

Poznámka: Názov uvoľni má v programovacom rámci GRobot deväť rôznych metód: GRobot.uvoľni(), GRobot.uvoľni(Oblasť), Oblasť.uvoľni(), Oblasť.uvoľni(GRobot) – slúžia na uvoľnenie robota zo zamestnania pre stanovenú oblasť (čo je geometrická trieda), Svet.uvoľni() – slúži na uvoľnenie hlavného okna sveta, t. j. umožnenie zmeny veľkosti okna používateľovi (ide o opak metódy Svet.upevni) a nakoniec Svet.uvoľni(GRobot), Svet.uvoľni(Class), Svet.uvoľni(Plazma) Svet.uvoľni(Obrázok) a Svet.uvoľni(String) – slúžia na uvoľňovanie nepotrebných inštancií robotov, vytvorených alebo prečítaných obrázkov a prečítaných zvukov z vnútorných zoznamov zdrojov (robotov, obrázkov, zvukov), čo je jednak nevyhnutnou podmienkou ich úspešného vymazania z pamäte zberačom odpadkov Javy a jednak to môže byť niekedy potrebné (napríklad ak sa obsah súboru so zdrojom uloženým na disku zmenil).

Parametre:

ktorý – objekt, ktorý má byť odstránený

Pozri tiež:

uvoľni(java.lang.Class)

uvolni

public static void uvolni(GRobot ktorý)

Alias pre uvoľni.

uvoľni
```
public static void uvoľni(Class typ)
```
Metóda slúži na hromadné vymazanie robotov určitého typu z vnútorného zoznamu robotov. Očakáva určenie údajového typu prostredníctvom inštancie typu Class. Tú môžeme získať, napríklad takto: GRobot.class, Postavička.class…). Zo zoznamu budú v dôsledku toho vymazané všetky inštancie určeného typu, ale aj inštancie odvodených tried. Preto je dobré byť pri hromadnom odstraňovaní obozretný. Ak si nie ste istí, aký dopad by malo použitie tejto metódy, použite radšej na uvoľnenie konkrétnych robotov metódu uvoľni(GRobot). Uvoľnených robotov už nie je možné do sveta vrátiť! V prípade, že nastane uvoľnenie hlavného robota, nastúpi na jeho miesto najbližší jestvujúci robot. Problém by mohol nastať, keby nie je k dispozícii žiadny ďalší robot, ktorý by ho mohol nahradiť.

Poznámka: Názov uvoľni má v programovacom rámci GRobot deväť rôznych metód: GRobot.uvoľni(), GRobot.uvoľni(Oblasť), Oblasť.uvoľni(), Oblasť.uvoľni(GRobot) – slúžia na uvoľnenie robota zo zamestnania pre stanovenú oblasť (čo je geometrická trieda), Svet.uvoľni() – slúži na uvoľnenie hlavného okna sveta, t. j. umožnenie zmeny veľkosti okna používateľovi (ide o opak metódy Svet.upevni) a nakoniec Svet.uvoľni(GRobot), Svet.uvoľni(Class), Svet.uvoľni(Plazma) Svet.uvoľni(Obrázok) a Svet.uvoľni(String) – slúžia na uvoľňovanie nepotrebných inštancií robotov, vytvorených alebo prečítaných obrázkov a prečítaných zvukov z vnútorných zoznamov zdrojov (robotov, obrázkov, zvukov), čo je jednak nevyhnutnou podmienkou ich úspešného vymazania z pamäte zberačom odpadkov Javy a jednak to môže byť niekedy potrebné (napríklad ak sa obsah súboru so zdrojom uloženým na disku zmenil).

Parametre:

typ – objekt typu Class

Pozri tiež:

uvoľni(GRobot)

uvolni
```
public static void uvolni(Class typ)
```
Alias pre uvoľni.

uvoľni
```
public static void uvoľni(Plazma ktorá)
```
Táto metóda slúži na odstránenie konkrétnej inštancie pixelového generátora plazmy z vnútorného zoznamu týchto generátorov. Prijíma jeden argument typu Plazma, ktorý určuje objekt určený na vymazanie z vnútorného zoznamu generátorov. Aplikácia musí zabezpečiť vynulovanie všetkých premenných, v ktorých je inštancia tohto generátora uložená, pretože po vymazaní generátora z vnútorného zoznamu prestane byť objekt synchronizovaný so zvyškom programovacieho rámca a mohol by sa správať inak než by sa od neho očakávalo. Uvoľnený pixelový generátor plazmy už nie je možné do sveta vrátiť!

Poznámka: Názov uvoľni má v programovacom rámci GRobot deväť rôznych metód: GRobot.uvoľni(), GRobot.uvoľni(Oblasť), Oblasť.uvoľni(), Oblasť.uvoľni(GRobot) – slúžia na uvoľnenie robota zo zamestnania pre stanovenú oblasť (čo je geometrická trieda), Svet.uvoľni() – slúži na uvoľnenie hlavného okna sveta, t. j. umožnenie zmeny veľkosti okna používateľovi (ide o opak metódy Svet.upevni) a nakoniec Svet.uvoľni(GRobot), Svet.uvoľni(Class), Svet.uvoľni(Plazma) Svet.uvoľni(Obrázok) a Svet.uvoľni(String) – slúžia na uvoľňovanie nepotrebných inštancií robotov, vytvorených alebo prečítaných obrázkov a prečítaných zvukov z vnútorných zoznamov zdrojov (robotov, obrázkov, zvukov), čo je jednak nevyhnutnou podmienkou ich úspešného vymazania z pamäte zberačom odpadkov Javy a jednak to môže byť niekedy potrebné (napríklad ak sa obsah súboru so zdrojom uloženým na disku zmenil).

Parametre:

ktorá – inštancia plazmy, ktorá má byť odstránená z vnútorného zoznamu

uvolni

public static void uvolni(Plazma ktorá)

Alias pre uvoľni.

uvoľni
```
public static void uvoľni(Obrázok ktorý)
```
Táto metóda slúži na odstránenie konkrétneho obrázka z vnútorného zoznamu obrázkov. Prijíma jeden argument typu Obrázok, ktorý určuje objekt určený na vymazanie z vnútorného zoznamu obrázkov. Aplikácia musí zabezpečiť vynulovanie všetkých premenných, v ktorých je inštancia tohto obrázka uložená, pretože po vymazaní obrázka z vnútorného zoznamu prestane byť objekt synchronizovaný so zvyškom programovacieho rámca a mohol by sa správať inak než by sa od neho očakávalo. Uvoľnený obrázok už nie je možné do sveta vrátiť!

Táto metóda (rovnako ako všetky jej klony) je nevyhnutná pri implementácii správy vnútornej pamäte programovacieho rámca. Ak aplikácia pracuje s veľkým množstvom grafických a/alebo zvukových súborov, je dôležité priebežne pamäť uvoľňovať, inak bude vyčerpaná a aplikácia sa zrúti. Základné použitie tejto metódy je ukázané v opise metódy pustenieSúboru.

Poznámka: Názov uvoľni má v programovacom rámci GRobot deväť rôznych metód: GRobot.uvoľni(), GRobot.uvoľni(Oblasť), Oblasť.uvoľni(), Oblasť.uvoľni(GRobot) – slúžia na uvoľnenie robota zo zamestnania pre stanovenú oblasť (čo je geometrická trieda), Svet.uvoľni() – slúži na uvoľnenie hlavného okna sveta, t. j. umožnenie zmeny veľkosti okna používateľovi (ide o opak metódy Svet.upevni) a nakoniec Svet.uvoľni(GRobot), Svet.uvoľni(Class), Svet.uvoľni(Plazma) Svet.uvoľni(Obrázok) a Svet.uvoľni(String) – slúžia na uvoľňovanie nepotrebných inštancií robotov, vytvorených alebo prečítaných obrázkov a prečítaných zvukov z vnútorných zoznamov zdrojov (robotov, obrázkov, zvukov), čo je jednak nevyhnutnou podmienkou ich úspešného vymazania z pamäte zberačom odpadkov Javy a jednak to môže byť niekedy potrebné (napríklad ak sa obsah súboru so zdrojom uloženým na disku zmenil).

Parametre:

ktorý – objekt, ktorý má byť odstránený z vnútorného zoznamu

uvolni

public static void uvolni(Obrázok ktorý)

Alias pre uvoľni.

uvoľni
```
public static void uvoľni(String názovZdroja)
```
Táto metóda slúži na odstránenie zdrojov (obrázkov a/alebo zvukov) z vnútorných zoznamov zdrojov sveta. Argument určuje názov súboru, z ktorého bol objekt zdroja prečítaný. Podľa neho sú vo vnútorných zoznamoch sveta (označovaných v tejto dokumentácii aj termínom „vnútorná pamäť sveta“) vyhľadané všetky korešpondujúce záznamy a sú z nich vymazané. Pri najbližšom čítaní tohto zdroja bude zdroj opätovne prečítaný z pevného disku (zdrojového súboru) a nová verzia bude opäť uložená do vnútorného zoznamu zdrojov sveta.

Táto metóda (rovnako ako všetky jej klony) je nevyhnutná pri implementácii správy vnútornej pamäte programovacieho rámca. Ak aplikácia pracuje s veľkým množstvom grafických a/alebo zvukových súborov, je dôležité priebežne pamäť uvoľňovať, inak bude vyčerpaná a aplikácia sa zrúti. Základné použitie tejto metódy je ukázané v opise metódy pustenieSúboru.

Poznámka: Názov uvoľni má v programovacom rámci GRobot deväť rôznych metód: GRobot.uvoľni(), GRobot.uvoľni(Oblasť), Oblasť.uvoľni(), Oblasť.uvoľni(GRobot) – slúžia na uvoľnenie robota zo zamestnania pre stanovenú oblasť (čo je geometrická trieda), Svet.uvoľni() – slúži na uvoľnenie hlavného okna sveta, t. j. umožnenie zmeny veľkosti okna používateľovi (ide o opak metódy Svet.upevni) a nakoniec Svet.uvoľni(GRobot), Svet.uvoľni(Class), Svet.uvoľni(Plazma) Svet.uvoľni(Obrázok) a Svet.uvoľni(String) – slúžia na uvoľňovanie nepotrebných inštancií robotov, vytvorených alebo prečítaných obrázkov a prečítaných zvukov z vnútorných zoznamov zdrojov (robotov, obrázkov, zvukov), čo je jednak nevyhnutnou podmienkou ich úspešného vymazania z pamäte zberačom odpadkov Javy a jednak to môže byť niekedy potrebné (napríklad ak sa obsah súboru so zdrojom uloženým na disku zmenil).

Parametre:

názovZdroja – názov súboru so zdrojom, ktorý má byť uvoľnený z vnútornej pamäte sveta

uvolni

public static void uvolni(String názovZdroja)

Alias pre uvoľni.

konfiguračnýSúbor
```
public static Súbor konfiguračnýSúbor()
```
Vráti inštanciu konfiguračného súboru na účely úpravy jeho parametrov, napríklad na úpravu predvolenej sekcie automatickej konfigurácie. Neodporúčame túto inštanciu používať na vlastné účely! Tiež odporúčame vykonávať čo najmenej zásahov do jej vlastností…

Návratová hodnota:

inštancia konfiguračného súboru

konfiguracnySubor
```
public static Súbor konfiguracnySubor()
```
Alias pre konfiguračnýSúbor.

názovKonfiguračnéhoSúboru
```
public static String názovKonfiguračnéhoSúboru()
```
Vráti naposledy použitý názov konfiguračného súboru. Pozri aj napríklad metódu konfiguračnýSúbor alebo reakciu zapíšKonfiguráciu.

Návratová hodnota:

názov konfiguračného súboru

nazovKonfiguracnehoSuboru
```
public static String nazovKonfiguracnehoSuboru()
```
Alias pre názovKonfiguračnéhoSúboru.

predvolenáSekciaKonfigurácie
```
public static String predvolenáSekciaKonfigurácie()
```
Vráti názov predvolenej sekcie. (Pozri aj predvolenáSekciaKonfigurácie.) Prázdny reťazec označuje prvú bezmennú konfiguračnú pasáž.

Návratová hodnota:

názov predvolenej sekcie alebo prázdny reťazec

Pozri tiež:

ObsluhaUdalostí.konfiguráciaZmenená(), predvolenáSekciaKonfigurácie(String), použiKonfiguráciu(String, int, int, int, int), použiKonfiguráciu(int, int, int, int), použiKonfiguráciu(String), použiKonfiguráciu(), registrujRobot(GRobot, String), čítajKonfiguráciuSveta(), overujPočiatočnúPolohuOkna()

predvolenaSekciaKonfiguracie
```
public static String predvolenaSekciaKonfiguracie()
```
Alias pre predvolenáSekciaKonfigurácie.

predvolenáSekciaKonfigurácie
```
public static void predvolenáSekciaKonfigurácie(String názov)
```
Zmení názov predvolenej sekcie, ktorú používajú metódy automatickej konfigurácie.

Parametre:

názov – názov novej predvolenej sekcie

Pozri tiež:

ObsluhaUdalostí.konfiguráciaZmenená(), predvolenáSekciaKonfigurácie(), použiKonfiguráciu(String, int, int, int, int), použiKonfiguráciu(int, int, int, int), použiKonfiguráciu(String), použiKonfiguráciu(), registrujRobot(GRobot, String), čítajKonfiguráciuSveta(), overujPočiatočnúPolohuOkna()

predvolenaSekciaKonfiguracie
```
public static void predvolenaSekciaKonfiguracie(String názov)
```
Alias pre predvolenáSekciaKonfigurácie.

použiKonfiguráciu
```
public static void použiKonfiguráciu(String názovSúboru,
                                     int x,
                                     int y,
                                     int šírka,
                                     int výška)
```
Zapne automatickú konfiguráciu, pričom umožní zadať počiatočnú polohu a rozmery okna. Parametre polohy a rozmerov okna opísané nižšie určujú predvolené hodnoty údajov – neskôr budú nahradené aktuálnymi hodnotami uloženými v konfigurácii. Súradnice x a y určujú, o koľko bodov je posunutý ľavý horný roh okna od ľavého horného rohu obrazovky (y-ová súradnica rastie smerom nadol). Viac informácií je v opise metódy použiKonfiguráciu(názovSúboru).

Parametre:

názovSúboru – názov konfiguračného súboru (.cfg)

x – predvolená (pozri vyššie) x-ová súradnica polohy okna

y – predvolená (pozri vyššie) y-ová súradnica polohy okna

šírka – predvolená (pozri vyššie) šírka okna

výška – predvolená (pozri vyššie) výška okna

Výnimky:

GRobotException – ak svet už bol inicializovaný

Pozri tiež:

ObsluhaUdalostí.konfiguráciaZmenená(), predvolenáSekciaKonfigurácie(), predvolenáSekciaKonfigurácie(String), použiKonfiguráciu(int, int, int, int), použiKonfiguráciu(String), použiKonfiguráciu(), registrujRobot(GRobot, String), čítajKonfiguráciuSveta(), overujPočiatočnúPolohuOkna()

pouziKonfiguraciu

public static void pouziKonfiguraciu(String názovSúboru,
                                     int x,
                                     int y,
                                     int šírka,
                                     int výška)

Alias pre použiKonfiguráciu.

použiKonfiguráciu
```
public static void použiKonfiguráciu(int x,
                                     int y,
                                     int šírka,
                                     int výška)
```
Zapne automatickú konfiguráciu, pričom umožní zadať počiatočnú polohu a rozmery okna. Metóda použije predvolené meno konfiguračného súboru "grobot.cfg". Parametre polohy a rozmerov okna opísané nižšie určujú predvolené hodnoty údajov – neskôr budú nahradené aktuálnymi hodnotami uloženými v konfigurácii. Súradnice x a y určujú, o koľko bodov je posunutý ľavý horný roh okna od ľavého horného rohu obrazovky (y-ová súradnica rastie smerom nadol). Viac informácií je v opise metódy použiKonfiguráciu().

Parametre:

x – predvolená (pozri vyššie) x-ová súradnica polohy okna

y – predvolená (pozri vyššie) y-ová súradnica polohy okna

šírka – predvolená (pozri vyššie) šírka okna

výška – predvolená (pozri vyššie) výška okna

Pozri tiež:

ObsluhaUdalostí.konfiguráciaZmenená(), predvolenáSekciaKonfigurácie(), predvolenáSekciaKonfigurácie(String), použiKonfiguráciu(String, int, int, int, int), použiKonfiguráciu(String), použiKonfiguráciu(), registrujRobot(GRobot, String), čítajKonfiguráciuSveta(), overujPočiatočnúPolohuOkna()

pouziKonfiguraciu

public static void pouziKonfiguraciu(int x,
                                     int y,
                                     int šírka,
                                     int výška)

Alias pre použiKonfiguráciu.

použiKonfiguráciu
```
public static void použiKonfiguráciu(String názovSúboru)
```
Zapne automatické spracovanie konfiguračného súboru sveta. Metóda musí byť volaná pred vytvorením hlavného robota, čiže ešte pred začatím inicializácie sveta (najlepšie v hlavnej metóde). V súčasnosti konfigurácia sveta zahŕňa polohu a rozmery hlavného okna (vrátane stavu minimalizovania/maximalizovania okna) a ukladanie vlastností registrovaných robotov. Meno konfiguračného súboru určuje parameter názovSúboru. Súbor nemusí jestvovať, v takom prípade bude vytvorený automaticky pri ukončení aplikácie.

Príklad:
```
public static void main(String[] args)
{
    Svet.použiKonfiguráciu("grobot.cfg");
    // new …
}
```
(Táto metóda použije predvolené hodnoty polohy [25, 25] a rozmerov 600 × 500 bodov.)

Upozornenie: Upozorňujeme na to, že nie je bezpečné používať súbor so zadaným názvom na iné účely. Prosím, venujte pozornosť upozorneniu pri metóde zapíšVlastnosť!
Parametre:

názovSúboru – názov konfiguračného súboru (.cfg)

Pozri tiež:

ObsluhaUdalostí.konfiguráciaZmenená(), predvolenáSekciaKonfigurácie(), predvolenáSekciaKonfigurácie(String), použiKonfiguráciu(String, int, int, int, int), použiKonfiguráciu(int, int, int, int), použiKonfiguráciu(), registrujRobot(GRobot, String), čítajKonfiguráciuSveta(), overujPočiatočnúPolohuOkna()

pouziKonfiguraciu

public static void pouziKonfiguraciu(String názovSúboru)

Alias pre použiKonfiguráciu.

použiKonfiguráciu
```
public static void použiKonfiguráciu()
```
Zapne automatické spracovanie konfiguračného súboru sveta. Metóda musí byť volaná pred vytvorením hlavného robota, čiže ešte pred začatím inicializácie sveta (najlepšie v hlavnej metóde). V súčasnosti konfigurácia sveta zahŕňa polohu a rozmery hlavného okna (vrátane stavu minimalizovania/maximalizovania okna) a ukladanie vlastností registrovaných robotov. Metóda použije predvolené meno konfiguračného súboru "grobot.cfg". Súbor nemusí jestvovať, v takom prípade bude vytvorený automaticky pri ukončení aplikácie.

Príklad:
```
public static void main(String[] args)
{
    Svet.použiKonfiguráciu();
    // new …
}
```
(Táto metóda použije predvolené hodnoty polohy [25, 25] a rozmerov 600 × 500 bodov.)

Upozornenie: Upozorňujeme na to, že nie je bezpečné používať súbor "grobot.cfg" na iné účely. Prosím, venujte pozornosť upozorneniu pri metóde zapíšVlastnosť!
Pozri tiež:

ObsluhaUdalostí.konfiguráciaZmenená(), predvolenáSekciaKonfigurácie(), predvolenáSekciaKonfigurácie(String), použiKonfiguráciu(String, int, int, int, int), použiKonfiguráciu(int, int, int, int), použiKonfiguráciu(String), registrujRobot(GRobot, String), čítajKonfiguráciuSveta(), overujPočiatočnúPolohuOkna()

pouziKonfiguraciu
```
public static void pouziKonfiguraciu()
```
Alias pre použiKonfiguráciu.

použiInteraktívnyRežim

public static void použiInteraktívnyRežim(String... nastavenia)

Komplexný konfiguračný príkaz umožňujúci vykonanie mnohých nastavení sveta naraz.

Zoznam reťazcov nastavenia môže obsahovať ľubovoľný počet z nasledujúcich nastavení (predvolene sú všetky zapnuté):

`"nerežimLadenia"`	vypne	vykonanie príkazu `Svet.režimLadenia(true,` `true)` po vyhodnotení všetkých konfiguračných direktív.
`"režimLadenia"`	zapne
`"`«názov súboru»`.cfg"`	zapne	vykonanie príkazu `Svet.použiKonfiguráciu(…)` po vyhodnotení všetkých konfiguračných direktív so zadaným názvom súboru.
`"x=`«celé číslo»`"`	upraví	hodnotu x-ovej pozície okna pre príkaz `Svet.použiKonfiguráciu(…)`, ktorý sa vykoná po vyhodnotení všetkých konfiguračných direktív, ak nebol zakázaný inou direktívou v zozname nastavení.
`"y=`«celé číslo»`"`	upraví	hodnotu y-ovej pozície okna pre príkaz `Svet.použiKonfiguráciu(…)`, ktorý sa vykoná po vyhodnotení všetkých konfiguračných direktív, ak nebol zakázaný inou direktívou v zozname nastavení.
`"šírka=`«celé číslo»`"`	upraví	hodnotu šírky okna pre príkaz `Svet.použiKonfiguráciu(…)`, ktorý sa vykoná po vyhodnotení všetkých konfiguračných direktív, ak nebol zakázaný inou direktívou v zozname nastavení.
`"výška=`«celé číslo»`"`	upraví	hodnotu výšky okna pre príkaz `Svet.použiKonfiguráciu(…)`, ktorý sa vykoná po vyhodnotení všetkých konfiguračných direktív, ak nebol zakázaný inou direktívou v zozname nastavení.
`"nepoužiKonfiguráciu"`	vypne	vykonanie príkazu `Svet.použiKonfiguráciu(…)` po vyhodnotení všetkých konfiguračných direktív. (Vypnutie vymaže prípadne skôr zadaný názov konfiguračného súboru a opätovné zapnutie potom názov súboru zresetuje na predvolený.)
`"použiKonfiguráciu"`	zapne
`"skryHlavnýRobot"`	vypne	vykonanie príkazu `Svet.vypíš(this)` počas inicializácie hlavného robota (príkaz vypína automatické skrývanie hlavného robota po prvom výpise textu konzoly).
`"neskryHlavnýRobot"`	zapne
`"nezačniVstup"`	vypne	vykonanie príkazu `Svet.začniVstup()` počas inicializácie hlavného robota.
`"začniVstup"`	zapne
`"skrývajVstupnýRiadok"`	vypne	vykonanie príkazu `Svet.neskrývajVstupnýRiadok()` počas inicializácie hlavného robota.
`"neskrývajVstupnýRiadok"`	zapne
`"neinteraktívnyRežim"`	vypne	vykonanie príkazov `Svet.interaktívnyRežim(true)` a `interaktívnyRežim(true)` počas inicializácie hlavného robota.
`"interaktívnyRežim"`	zapne
`"neaktivujHistóriuVstupnéhoRiadka"`	vypne	vykonanie príkazu `Svet.aktivujHistóriuVstupnéhoRiadka()` počas inicializácie hlavného robota.
`"aktivujHistóriuVstupnéhoRiadka"`	zapne
`"neuchovajHistóriuVstupnéhoRiadka"`	vypne	vykonanie príkazu `Svet.uchovajHistóriuVstupnéhoRiadka()` počas inicializácie hlavného robota.
`"uchovajHistóriuVstupnéhoRiadka"`	zapne
`"neskratkyStropu"`	vypne	vykonanie príkazu `Svet.skratkyStropu(true)` počas inicializácie hlavného robota.
`"skratkyStropu"`	zapne
`"neautomatickéZobrazovanieLíšt"`	vypne	vykonanie príkazu `strop.automatickéZobrazovanieLíšt(true)` počas inicializácie hlavného robota.
`"automatickéZobrazovanieLíšt"`	zapne
`"nezmeňOdsadenieSprava"`	vypne	vykonanie príkazu `strop.zmeňOdsadenieSprava(30)` počas inicializácie hlavného robota.
`"zmeňOdsadenieSprava"`	zapne
`"vypisujFarby"`	vypne	vykonanie príkazu `strop.nevypisujFarby(true)` počas inicializácie hlavného robota.
`"nevypisujFarby"`	zapne
`"vypniVšetko"`	vypne	všetky (vyššie vymenované) direktívy. (V kontexte ukladania konfigurácie vypnutie vymaže prípadne skôr zadaný názov konfiguračného súboru a opätovné zapnutie názov súboru zresetuje na predvolený.)
`"zapniVšetko"`	zapne

Nastavenia sú vyhodnocované sekvenčne. Neskoršie uvedené menia platnosť skôr uvedených. Všetky prepínače sú implementované ako booleovské hodnoty, okrem ukladania konfigurácie, ktorá je realizovaná nastavovaním alebo mazaním názvu konfiguračného súboru (bez ktorého by ukladanie konfigurácie ani nemalo zmysel).

Parametre:: nastavenia – reťazcový zoznam konfiguračných direktív

pouziInteraktivnyRezim

public static void pouziInteraktivnyRezim(String... nastavenia)

Alias pre použiInteraktívnyRežim.

overujPočiatočnúPolohuOkna
```
public static boolean overujPočiatočnúPolohuOkna()
```
Zistí aktuálny stav automatického overovania počiatočnej polohy okna po jeho inicializácii. Viac podrobností nájdete v opise metódy overujPočiatočnúPolohuOkna(overuj).

Návratová hodnota:

aktuálny stav overovania: true/false

Pozri tiež:

použiKonfiguráciu(), overujPočiatočnúPolohuOkna(boolean)

overujPočiatočnúPolohuOkna
```
public static void overujPočiatočnúPolohuOkna(boolean overuj)
```
Zmení stav automatického overovania počiatočnej polohy okna po jeho inicializácii. Ak je stav overovania nastavený na true, tak sa počas inicializácie okna (sveta) overí, či je umiestnené v rámci aktuálnych obrazoviek (zariadení) a ak nie, tak bude automaticky presunuté na primárnu obrazovku (resp. predvolené zobrazovacie zariadenie).

Z vyššie uvedených informácií vyplýva, že tento stav (príznak) má zmysel meniť len pred inicializáciou okna sveta. Najlepšie pred použitím konfigurácie. Po inicializácii okna sveta už nie je poloha okna overovaná automaticky, ale dá sa vykonať týmto (alebo podobným) kódom:
```
if (Svet.zistiZariadenieOkna())
    Svet.premiestniNaZariadenie();
```
Parametre:

overuj – nový stav overovania: true/false

Pozri tiež:

použiKonfiguráciu(), overujPočiatočnúPolohuOkna(), overujPočiatočnúPolohuOkna(boolean), premiestniNaZariadenie()

overujPociatocnuPolohuOkna
```
public static boolean overujPociatocnuPolohuOkna()
```
Alias pre overujPočiatočnúPolohuOkna.

overujPociatocnuPolohuOkna
```
public static void overujPociatocnuPolohuOkna(boolean overuj)
```
Alias pre overujPočiatočnúPolohuOkna.

prvéSpustenie
```
public static boolean prvéSpustenie()
```
Účelom tejto metódy je overiť, či pred spustením aplikácie jestvoval konfiguračný súbor. Ak áno, nejde o prvé spustenie a metóda vráti hodnotu false. Ak nie, tak je toto spustenie považované za prvé a aplikácia si v tejto situácii môže nakonfigurovať niektoré vlastnosti alebo vykonať určité aktivity (napríklad zbaliť okno) bez obáv, že by táto činnosť zničila údaje prečítané z konfiguračného súboru.

Návratová hodnota:

true ak konfigurácia nejestvovala; false v opačnom prípade

prveSpustenie
```
public static boolean prveSpustenie()
```
Alias pre prvéSpustenie.

registrujRobot
```
public static void registrujRobot()
```
Registruje hlavný robot v konfigurácii sveta. Rezervované meno pre hlavný robot je robot. Pozri aj informácie pri metóde registrujRobot(robot).

Parametre:

meno – meno robota

Pozri tiež:

ObsluhaUdalostí.konfiguráciaZmenená(), GRobot.uložDoSúboru(Súbor), GRobot.čítajZoSúboru(Súbor), Písmo.uložDoSúboru(Súbor), Písmo.čítajZoSúboru(Súbor), registrujRobot(String), registrujRobot(GRobot), registrujRobot(GRobot, String), použiKonfiguráciu(), použiKonfiguráciu(String), použiKonfiguráciu(String, int, int, int, int), použiKonfiguráciu(int, int, int, int), čítajKonfiguráciuSveta(), overujPočiatočnúPolohuOkna()

registrujRobota
```
public static void registrujRobota()
```
Alias pre registrujRobot.

registrujRobot
```
public static void registrujRobot(String meno)
```
Registruje robot v konfigurácii podľa jeho (vopred priradeného) mena. Ak nejestvuje žiadny robot so zadaným menom, tak vznikne výnimka. Pozri aj informácie pri metóde registrujRobot(robot).

Parametre:

meno – meno robota

Výnimky:

GRobotException – ak robot so zadaným menom nejestvuje

Pozri tiež:

ObsluhaUdalostí.konfiguráciaZmenená(), GRobot.uložDoSúboru(Súbor), GRobot.čítajZoSúboru(Súbor), Písmo.uložDoSúboru(Súbor), Písmo.čítajZoSúboru(Súbor), registrujRobot(), registrujRobot(GRobot), registrujRobot(GRobot, String), použiKonfiguráciu(), použiKonfiguráciu(String), použiKonfiguráciu(String, int, int, int, int), použiKonfiguráciu(int, int, int, int), čítajKonfiguráciuSveta(), overujPočiatočnúPolohuOkna()

registrujRobota

public static void registrujRobota(String meno)

Alias pre registrujRobot.

registrujRobot
```
public static void registrujRobot(GRobot robot)
```
Registruje robot v konfigurácii. Registrácia je vykonaná podľa jeho mena. To znamená, že údaje o robote (poloha, smer, veľkosť, farba pera a tak ďalej) budú automaticky ukladané do a čítané z konfiguračného súboru. Ak robot nie je pomenovaný a nejde o hlavný robot, tak vznikne výnimka.

Pred registráciou je vhodné vypnúť automatické prekresľovanie a po dokončení registrácie ho opätovne zapnúť. I tak nemusí byť garantovaná bezproblémová aktualizácia obrazovky, preto je vhodné vykonať registráciu podľa nasledujúcej schémy:
```
import knižnica.*;

public class UkážkaKonfigurácie extends GRobot
{
    private UkážkaKonfigurácie()
    {
        // Inicializácia
        // ...

        Svet.registrujRobot(this);
        // Prípadne sa dá použiť aj verzia metódy
        // bez argumentu: Svet.registrujRobot();
    }

    public static void main(String[] args)
    {
        Svet.použiKonfiguráciu();
        Svet.nekresli();
        new UkážkaKonfigurácie();
        Svet.kresli();
    }
}
```
Poznámka: Čítanie údajov o robote je vykonané pri spustení tohto príkazu a zápis je vykonaný automaticky pri ukončení aplikácie. V prípade kombinácie registrácie robota s vlastnou konfiguráciou (pozri príklad TestKonfigurácie v triede ObsluhaUdalostí) je vhodné tieto fakty zvážiť.
Parametre:

robot – robot, ktorý má byť zaregistrovaný

Výnimky:

GRobotException – ak zadaný robot nemá definované meno

Pozri tiež:

ObsluhaUdalostí.konfiguráciaZmenená(), GRobot.uložDoSúboru(Súbor), GRobot.čítajZoSúboru(Súbor), Písmo.uložDoSúboru(Súbor), Písmo.čítajZoSúboru(Súbor), GRobot.registrujVKonfigurácii(), GRobot.registrujVKonfigurácii(String), GRobot.jeRegistrovaný(), registrujRobot(), registrujRobot(String), registrujRobot(GRobot, String), dajRobot(String), použiKonfiguráciu(), použiKonfiguráciu(String), použiKonfiguráciu(String, int, int, int, int), použiKonfiguráciu(int, int, int, int), čítajKonfiguráciuSveta(), overujPočiatočnúPolohuOkna()

registrujRobota

public static void registrujRobota(GRobot robot)

Alias pre registrujRobot.

registrujRobot
```
public static void registrujRobot(GRobot robot,
                                  String meno)
```
Registruje robot v konfigurácii podľa zadaného mena. Pozri aj informácie pri metóde registrujRobot(robot).

Parametre:

meno – meno robota

Pozri tiež:

ObsluhaUdalostí.konfiguráciaZmenená(), GRobot.uložDoSúboru(Súbor), GRobot.čítajZoSúboru(Súbor), registrujRobot(), registrujRobot(String), registrujRobot(GRobot), dajRobot(String), použiKonfiguráciu(), použiKonfiguráciu(String), použiKonfiguráciu(String, int, int, int, int), použiKonfiguráciu(int, int, int, int), overujPočiatočnúPolohuOkna()

registrujRobota

public static void registrujRobota(GRobot robot,
                                   String meno)

Alias pre registrujRobot.

dajRobot
```
public static GRobot dajRobot(String menoRobota)
```
Vráti inštanciu robota podľa jeho mena. Pomenovanie robotov je nepovinné a dá sa vykonať rôznymi spôsobmi. Napríklad pri registrácii robota v konfigurácii sveta alebo priamo jeho pomenovaním.

Hodnota parametra null vráti hlavný robot bez ohľadu na jeho aktuálne meno. V prípade, že hlavný robot nemá priradené špeciálne meno, je táto hodnota ekvivalentá hodnote "robot", ktorá vráti hlavný robot len v prípade, že nemá špeciálne pomenovanie.

Parametre:

meno – meno robota, ktorého inštanciu chceme vrátiť alebo null

Návratová hodnota:

inštancia robota so zadaným menom alebo null, ak taký robot nejestvuje

Pozri tiež:

GRobot.meno(String), registrujRobot(GRobot, String)

dajRobota

public static GRobot dajRobota(String menoRobota)

Alias pre dajRobot.

čítajKonfiguráciuSveta
```
public static void čítajKonfiguráciuSveta()
```
Prečíta konfiguráciu sveta (a plátien). Konfigurácia sveta ukladá viaceré informácie, napríklad: farbu pozadia, písma podlahy a stropu, hodnotu časovača, aktiváciu interaktívneho režimu a podobne. Spustenie tejto metódy spôsobí automatické uloženie údajov o svete (a plátnach) do konfigurácie pri (korektnom) ukončení aplikácie.

Vhodné je použiť nasledujúcu schému:
```
import knižnica.*;

public class UkážkaKonfigurácie extends GRobot
{
    private UkážkaKonfigurácie()
    {
        // Inicializácia
        // ...

        Svet.registrujRobot(this, "robot");
        Svet.čítajKonfiguráciuSveta();
    }

    public static void main(String[] args)
    {
        Svet.použiKonfiguráciu();
        Svet.nekresli();
        new UkážkaKonfigurácie();
        Svet.kresli();
    }
}
```
Parametre:

meno – meno robota

Pozri tiež:

ObsluhaUdalostí.konfiguráciaZmenená(), GRobot.uložDoSúboru(Súbor), GRobot.čítajZoSúboru(Súbor), Písmo.uložDoSúboru(Súbor), Písmo.čítajZoSúboru(Súbor), registrujRobot(), registrujRobot(String), registrujRobot(GRobot), registrujRobot(GRobot, String), dajRobot(String), použiKonfiguráciu(), použiKonfiguráciu(String), použiKonfiguráciu(String, int, int, int, int), použiKonfiguráciu(int, int, int, int), overujPočiatočnúPolohuOkna()

citajKonfiguraciuSveta
```
public static void citajKonfiguraciuSveta()
```
Alias pre čítajKonfiguráciuSveta.

prečítajKonfiguráciuSveta
```
public static void prečítajKonfiguráciuSveta()
```
Alias pre čítajKonfiguráciuSveta.

precitajKonfiguraciuSveta
```
public static void precitajKonfiguraciuSveta()
```
Alias pre čítajKonfiguráciuSveta.

vykonaťNeskôr
```
public static void vykonaťNeskôr(Runnable vykonať)
```
Táto metóda slúži na zadanie príkazov Javy, ktoré majú byť vykonané „neskôr“ – asynchrónne vzhľadom na reťaz čakajúcich správ (udalostí) aktívneho vlákna. To znamená, že zadané príkazy budú vykonané v čase, kedy je zásobník správ (to jest udalostí) aktívneho vlákna prázdny.

Príklad:
```
// Výpis veľkého množstva textov – na niekoľko strán…

Svet.čakaj(0.05);
Svet.vykonaťNeskôr(() ->
    strop.posunutieTextovY(
        strop.poslednáVýškaTextu()));
```
Príkazy v príklade sú vykonané nielen s päťdesiatmilisekundovým oneskorením (spôsobeným príkazom čakaj), ale aj až po vykonaní spracovania všetkých čakajúcich udalostí, čo by v tomto prípade mala byť prinajmenšom udalosť prekreslenia sveta, ktorá vznikla ako dôsledok výpisu textov (ktoré nie sú v tomto príklade uvedené).
Parametre:

vykonať – inštancia Runnable alebo funkcionálny blok príkazov Javy na vykonanie

vykonatNeskor

public static void vykonatNeskor(Runnable vykonať)

Alias pre vykonaťNeskôr.

vykonaťNeskôr
```
public static void vykonaťNeskôr(Runnable vykonať,
                                 boolean samostatnéVlákno)
```
Táto metóda slúži na zadanie príkazov Javy, ktoré majú byť vykonané „neskôr“ – pozri opis metódy vykonaťNeskôr(vykonať). Toto je verzia metódy, ktorá umožňuje určiť, či má byť vytvorené samostatné vlákno, ktoré bude vykonávať blok zadaných príkazov.

Parametre:

vykonať – inštancia Runnable alebo funkcionálny blok príkazov Javy na vykonanie

samostatnéVlákno – určuje, či má byť spustené samostatné vlákno vykonávajúce zadané príkazy

vykonatNeskor

public static void vykonatNeskor(Runnable vykonať,
                                 boolean samostatnéVlákno)

Alias pre vykonaťNeskôr.

nespi
```
public static void nespi()
```
Spustí aktivitu pravidelného generovania udalostí pohybu kurzorom myšky, aby sa zabránilo prechodu počítača do režimu spánku. Táto verzia automaticky spustí časovač a zachová pôvodný interval generovania udalostí (prípadne predvolený, ktorý má hodnotu 1 000 tikov časovača). Viac podrobností nájdete v opise nasledujúcej verzie metódy: nespi(novýInterval, ajČasovač).

Pozri tiež:

nespi(int), nespi(int, boolean), spi()

nespi
```
public static void nespi(int novýInterval)
```
Spustí aktivitu pravidelného generovania udalostí pohybu kurzorom myšky, aby sa zabránilo prechodu počítača do režimu spánku. Táto verzia automaticky spustí časovač. Viac podrobností nájdete v opise nasledujúcej verzie metódy: nespi(novýInterval, ajČasovač).

Parametre:

novýInterval – celé číslo určujúce počet tikov časovača, po uplynutí ktorých sa budú generovať nové udalosti pohybu kurzora myši; nulová alebo záporná hodnota zastaví generovanie

Pozri tiež:

nespi(), nespi(int, boolean), spi()

nespi
```
public static void nespi(int novýInterval,
                         boolean ajČasovač)
```
Spustí aktivitu pravidelného generovania udalostí pohybu kurzorom myšky, aby sa zabránilo prechodu počítača do režimu spánku.

Toto je dôležité najmä pri aplikáciách, ktoré niečo samostatne prezentujú. Bez tejto možnosti by po určitom čase počítač mohol „zaspať“ (a prezentovanie by stratilo efekt).

Udalosti, ktoré budú generované sú systémom považované za reálne udalosti, ktoré spôsobil používateľ. Keďže virtuálny stroj Javy nemá priamy prístup k nastaveniam súvisiacim so správou a šetrením energie, toto je jediná možnosť ako je možné túto záležitosť ovplyvniť.

Prvý parameter určuje interval generovania udalostí v jednotkách počtu tikov (pozri aj napríklad: intervalČasovača) a druhý parameter umožňuje potlačiť automatické spustenie časovača – zadaním hodnoty false.

Parametre:

novýInterval – celé číslo určujúce počet tikov časovača, po uplynutí ktorých sa budú generovať nové udalosti pohybu kurzora myši; nulová alebo záporná hodnota zastaví generovanie

ajČasovač – ak je true, tak je automaticky spustený časovač (v prípade, že je nečinný); bez spusteného časovača nebude táto aktivita fungovať – dôvodom na použitie hodnoty false môže byť spustenie v prípravnej fáze aplikácie s tým, že časovač bude spustený neskôr, keď bude aplikácie korektne inicializovaná (pripravená na činnosť)

Pozri tiež:

nespi(), nespi(int), spi()

spi
```
public static void spi()
```
Zastaví aktivitu pravidelného generovania udalostí pohybu kurzorom myšky, ktorá slúžila na to, aby sa zabránilo prechodu počítača do režimu spánku.

Pozri tiež:

nespi(), nespi(int), nespi(int, boolean)

otvorWebovýOdkaz
```
public static boolean otvorWebovýOdkaz(String uri)
```
Pokúsi sa použiť zadaný textový reťazec ako webovú adresu a otvoriť ju v predvolenom prehliadači operačného systému.

Parametre:

uri – reťazec s webovou adresou, ktorá má byť otvorená v predvolenom prehliadači OS

Návratová hodnota:

true ak metóda uspela, false v opačnom prípade

otvorWebovyOdkaz

public static boolean otvorWebovyOdkaz(String uri)

Alias pre otvorWebovýOdkaz.

pošliEmail
```
public static boolean pošliEmail(String... údajeSprávy)
```
Otvorí okno na napísanie novej správy elektronickej pošty predvoleného e-mailového klienta OS.

Voliteľné parametre údajeSprávy môžu byť vynechané alebo môže byť zadaný nepárny počet prvkov. V tom prípade je prvý prvok adresa primárneho adresáta a zvyšné dvojice parametrov určujú ďalšie údaje správy. Prvý z páru je názov údaja a druhý jeho hodnota. Metóda podporuje tieto názvy:
- "komu" alebo "to" – adresa ďalšieho primárneho adresáta
- "kópia" alebo "cc" – adresa adresáta v kópii
- "skrytá", "skrytá kópia" alebo "bcc" – adresa adresáta v skrytej kópii
- "predmet" alebo "subject" – predmet správy
- "telo", "telo správy" alebo "body" – telo správy
Parametre:

údajeSprávy – údaje súvisiace s novou správou (pozri vyššie)

Návratová hodnota:

true ak metóda uspela, false v opačnom prípade

Pozri tiež:

otvorWebovýOdkaz(String), vytlač(String), otvorVPredvolenejAplikácii(String), otvorVPredvolenejAplikácii(String, boolean)

posliEmail

public static boolean posliEmail(String... údajeSprávy)

Alias pre pošliEmail.

vytlač
```
public static boolean vytlač(String súbor)
```
Ak je pre zadaný súbor asociovaný príkaz na tlač dokumentu, tak otvorí prislúchajúci tlačový dialóg operačného systému, pomocou ktorého bude možné súbor (dokument) vytlačiť.

Parametre:

súbor – súbor (dokument), ktorý má byť vytlačený podľa predvoleného nastavenia OS

Návratová hodnota:

true ak metóda uspela, false v opačnom prípade

vytlac

public static boolean vytlac(String súbor)

Alias pre vytlač.

otvor
```
public static boolean otvor(String súbor)
```
Pokúsi sa otvoriť zadaný súbor v predvolenej aplikácii podľa nastavení operačného systému.

Parametre:

súbor – súbor (dokument), ktorý má byť otvorený v predvolenej aplikácie (podľa nastavení OS)

Návratová hodnota:

true ak metóda uspela, false v opačnom prípade

otvorVPredvolenejAplikácii

public static boolean otvorVPredvolenejAplikácii(String súbor)

Alias pre otvorVPredvolenejAplikácii.

otvorVPredvolenejAplikacii

public static boolean otvorVPredvolenejAplikacii(String súbor)

Alias pre otvorVPredvolenejAplikácii.

otvor
```
public static boolean otvor(String súbor,
                            boolean naÚpravu)
```
Pokúsi sa otvoriť (spustiť) alebo otvoriť na úpravy zadaný súbor v predvolenej aplikácii podľa nastavení operačného systému. Spôsob otvorenia určuje druhý parameter: naÚpravu. Ak je false, tak sa metóda správa rovnako ako jej verzia bez tohto parametra (otvor), čiže pokúsi sa súbor (dokument) otvoriť v zmysle jeho spustenia (čo nadobúda lepší význam napríklad v prípade skriptov). Ak sa hodnota parametra rovná true, tak sa metóda pokúsi zadaný súbor (dokument) otvoriť v predvolenom editore. (Ak tento nie je definovaný, tak je pravdepodobné, že operačný systém súbor otvorí/spustí rovnakým spôsobom ako v prvom prípade.)

Príklad:

Porovnajte nasledujúce dva príkazy:
```
Svet.otvor("uprav.bat");
Svet.otvor("uprav.bat", true);
```
Obidva sa pokúšajú „otvoriť“ naledujúci skript (uložený v súbore uprav.bat s kódovaním UTF-8), ale každá iným spôsobom:
Parametre:

súbor – súbor (dokument), ktorý má byť otvorený v predvolenej aplikácie (podľa nastavení OS)

naÚpravu – ak je true, tak sa metóda pokúsi otvoriť zadaný súbor (dokument) v predvolenom editore (ak je definovaný); ak je false, tak sa metóda správa rovnako ako jej verzia bez tohto parametra (otvor)

Návratová hodnota:

true ak metóda uspela, false v opačnom prípade

Pozri tiež:

otvorWebovýOdkaz(String), pošliEmail(String...), vytlač(String), otvor(String), otvor(String, boolean)

otvorVPredvolenejAplikácii

public static boolean otvorVPredvolenejAplikácii(String súbor,
                                                 boolean naÚpravu)

Alias pre otvorVPredvolenejAplikácii.

otvorVPredvolenejAplikacii

public static boolean otvorVPredvolenejAplikacii(String súbor,
                                                 boolean naÚpravu)

Alias pre otvorVPredvolenejAplikácii.

spracujPríkaz
```
public static void spracujPríkaz(String príkaz)
```
Spracuje jeden príkaz príkazového riadka. Táto metóda je jednoduchou implementáciou príkazového riadka operačného systému s úzkou množinou vnútorných príkazov vymenovaných nižšie. Metóda používa funkcie implementované v statickej inštancii príkazovýRiadok (pozri triedu PríkazovýRiadok). Napríklad metódu execute na spustenie externého procesu. Štandardný výstup procesov je presmerovaný na vnútornú konzolu sveta (stropu – pozri napríklad metódu vypíšRiadok).

Vnútorne spracúvané príkazy (neposielané do OS):
- CD/CHDIR – zmení vnútorné nastavenie aktuálnej cesty, v ktorej má byť spustený nasledujúci proces. (Doplňujúce informácie v anglickom jazyku sú v opise metódy ExecuteShellCommand.changePath(String).)
- CLS – vymaže obsah vnútornej konzoly sveta (stropu).
- ECHO – vypíše zadané argumenty na vnútornú konzolu sveta (stropu). Obsahy premenných prostredia sú rozvinuté.
- CHCP – zmení kódovanie inštancie príkazového riadka alebo konfiguruje vnútornú mapu kódovaní príkazov podrobnosti v anglickom jazyku sú v opise metódy ExecuteShellCommand.changeEncoding(String).
- MAPCMD – upraví alebo overí mapovanie zadaného príkazu, prípadne vypíše zoznam všetkých mapovaní. (Doplňujúce informácie v anglickom jazyku sú v opise metódy ExecuteShellCommand.mapCommand(String).)
- PROMPT – zmení definíciu náveste príkazového riadka. (Použitie náveste je nepovinné. Doplňujúce informácie v anglickom jazyku sú v opise metódy ExecuteShellCommand.setPrompt(String).)
- SET – nastaví, vymaže, vypíše zoznam premenných prostredia príkazového riadka alebo si vyžiada doplňujúci vstup. Príkaz dokáže vyhodnocovať výrazy (Doplňujúce informácie v anglickom jazyku sú v opise metódy ExecuteShellCommand.setVariable(String).)
- TITLE – upraví definíciu titulku okna konzoly, ktorá sa automaticky prenesie do titulku okna sveta. (Doplňujúce informácie v anglickom jazyku sú v opise metódy ExecuteShellCommand.setTitle(String).)
- PAUSE, EXIT – tieto dva príkazy sú vypnuté. Metóda ich rozpoznáva, pretože sú relatívne bežné a aby neboli omylom poslané operačnému systému ako žiadosť o spustenie procesu, ktorá by sa skončila s chybou.
Parametre:

príkaz – reťazec obsahujúci jediný príkaz príkazového riadka na vykonanie

spracujPrikaz

public static void spracujPrikaz(String príkaz)

Alias pre spracujPríkaz.

zadajReťazec

public static String zadajReťazec(String výzva)

Otvorí štandardný dialóg so zadanou výzvou a zadávacím poľom na zadanie údajov.

Príklad:

String meno = Svet.zadajReťazec("Zadaj svoje meno:");

if (meno != null)
{
    if (meno.equals(""))
    // Prípadne lepšie: if (!meno.isEmpty())
    {
        Svet.správa("Nezadal si svoje meno…");
    }
    else
    {
        Svet.správa("Vitaj, " + meno + "!");
    }
}
else
{
    Svet.správa("Zrušil si zadanie svojho mena…");
}

Ukážky možného vzhľadu dialógov zobrazených
počas vykonávania tohto príkladu (Windows).

Ukážky možného vzhľadu dialógov zobrazených
počas vykonávania tohto príkladu (macOS).

Parametre:: výzva – text výzvy
Návratová hodnota:: objekt String s textom, ktorý zadal používateľ, alebo null ak používateľ dialóg zrušil
Pozri tiež:: zadajReťazec(String, String), zadajHeslo(String), zadajHeslo(String, String), zadajCeléČíslo(String), zadajCeléČíslo(String, String), zadajReálneČíslo(String), zadajReálneČíslo(String, String), upravReťazec(String, String), dialóg(String[], Object[]), dialóg(String[], Object[], String)

zadajRetazec

public static String zadajRetazec(String výzva)

Alias pre zadajReťazec.

zadajReťazec
```
public static String zadajReťazec(String výzva,
                                  String titulok)
```
Otvorí štandardný dialóg so zadanou výzvou a zadávacím poľom na zadanie údajov.

Parametre:

výzva – text výzvy

titulok – text titulku dialógového okna

Návratová hodnota:

objekt String s textom, ktorý zadal používateľ, alebo null ak používateľ dialóg zrušil

Pozri tiež:

zadajReťazec(String), zadajHeslo(String), zadajHeslo(String, String), zadajCeléČíslo(String), zadajCeléČíslo(String, String), zadajReálneČíslo(String), zadajReálneČíslo(String, String), upravReťazec(String, String, String), dialóg(String[], Object[]), dialóg(String[], Object[], String)

zadajRetazec

public static String zadajRetazec(String výzva,
                                  String titulok)

Alias pre zadajReťazec.

zadajHeslo
```
public static String zadajHeslo(String výzva)
```
Otvorí štandardný dialóg so zadanou výzvou a zadávacím poľom na zadanie hesla.

Poznámka: Táto metóda je určená na tvorbu príkladov na vzdelávacie účely. Riadi sa princípom jednoduchosti. Vyššiu bezpečnosť pri zadávaní hesla poskytuje metóda dialóg(popisy, údaje, titulok) a jej klony.

Parametre:

výzva – text výzvy

Návratová hodnota:

objekt String s heslom, ktoré zadal používateľ, alebo null ak používateľ dialóg zrušil

Pozri tiež:

zadajReťazec(String), zadajReťazec(String, String), zadajHeslo(String, String), zadajCeléČíslo(String), zadajCeléČíslo(String, String), zadajReálneČíslo(String), zadajReálneČíslo(String, String), dialóg(String[], Object[]), dialóg(String[], Object[], String)

zadajHeslo
```
public static String zadajHeslo(String výzva,
                                String titulok)
```
Otvorí štandardný dialóg so zadanou výzvou a zadávacím poľom na zadanie hesla.

Poznámka: Táto metóda je určená na tvorbu príkladov na vzdelávacie účely. Riadi sa princípom jednoduchosti. Vyššiu bezpečnosť pri zadávaní hesla poskytuje metóda dialóg(popisy, údaje, titulok) a jej klony.

Parametre:

výzva – text výzvy

titulok – text titulku dialógového okna

Návratová hodnota:

objekt String s heslom, ktoré zadal používateľ, alebo null ak používateľ dialóg zrušil

Pozri tiež:

zadajReťazec(String), zadajReťazec(String, String), zadajHeslo(String), zadajCeléČíslo(String), zadajCeléČíslo(String, String), zadajReálneČíslo(String), zadajReálneČíslo(String, String), dialóg(String[], Object[]), dialóg(String[], Object[], String)

zadajCeléČíslo
```
public static Long zadajCeléČíslo(String výzva)
```
Otvorí štandardný dialóg so zadanou výzvou a zadávacím poľom na zadanie údajov (očakávaný je celočíselný údaj). Pozri príklad pri zadajCeléČíslo.
Ukážka dialógu (macOS).

Ukážka dialógu (Windows).

Parametre:

výzva – text výzvy

Návratová hodnota:

objekt Long s celočíselnou hodnotou, ktorú zadal používateľ, alebo null ak používateľ dialóg zrušil alebo zadal reťazec, ktorý nebolo možné previesť na celé číslo

Pozri tiež:

zadajReťazec(String), zadajReťazec(String, String), zadajHeslo(String), zadajHeslo(String, String), zadajCeléČíslo(String, String), zadajReálneČíslo(String), zadajReálneČíslo(String, String), upravCeléČíslo(long, String), dialóg(String[], Object[]), dialóg(String[], Object[], String), formát

zadajCeleCislo

public static Long zadajCeleCislo(String výzva)

Alias pre zadajCeléČíslo.

zadajCeléČíslo

public static Long zadajCeléČíslo(String výzva,
                                  String titulok)

Otvorí štandardný dialóg so zadanou výzvou a zadávacím poľom na zadanie údajov (očakávaný je celočíselný údaj).

Príklad:

Long l = Svet.zadajCeléČíslo("Počet:", "Zadaj celé číslo");

if (l != null)
{
    int i = l.intValue();
    Svet.správa("Zadané: " + F(i, 0));
}
else
    Svet.správa("Vstup bol zrušený alebo nesprávny.");

Ukážky možného vzhľadu dialógov zobrazených
počas vykonávania tohto príkladu (Windows).

Ukážky možného vzhľadu dialógov zobrazených
počas vykonávania tohto príkladu (macOS).

Parametre:: výzva – text výzvy; titulok – text titulku dialógového okna
Návratová hodnota:: objekt Long s celočíselnou hodnotou, ktorú zadal používateľ, alebo null ak používateľ dialóg zrušil alebo zadal reťazec, ktorý nebolo možné previesť na celé číslo
Pozri tiež:: zadajReťazec(String), zadajReťazec(String, String), zadajHeslo(String), zadajHeslo(String, String), zadajCeléČíslo(String), zadajReálneČíslo(String), zadajReálneČíslo(String, String), upravCeléČíslo(long, String, String), dialóg(String[], Object[]), dialóg(String[], Object[], String), formát

zadajCeleCislo

public static Long zadajCeleCislo(String výzva,
                                  String titulok)

Alias pre zadajCeléČíslo.

zadajReálneČíslo
```
public static Double zadajReálneČíslo(String výzva)
```
Otvorí štandardný dialóg so zadanou výzvou a zadávacím poľom na zadanie údajov (očakávaný je číselný údaj). Pozri príklad pri zadajReálneČíslo.
Ukážka dialógu (macOS).

Ukážka dialógu (Windows).

Parametre:

výzva – text výzvy

Návratová hodnota:

objekt Double s celočíselnou hodnotou, ktorú zadal používateľ, alebo null ak používateľ dialóg zrušil alebo zadal reťazec, ktorý nebolo možné previesť na reálne číslo

Pozri tiež:

zadajReťazec(String), zadajReťazec(String, String), zadajHeslo(String), zadajHeslo(String, String), zadajCeléČíslo(String), zadajCeléČíslo(String, String), zadajReálneČíslo(String, String), upravReálneČíslo(double, String), dialóg(String[], Object[]), dialóg(String[], Object[], String), formát

zadajRealneCislo

public static Double zadajRealneCislo(String výzva)

Alias pre zadajReálneČíslo.

zadajReálneČíslo

public static Double zadajReálneČíslo(String výzva,
                                      String titulok)

Otvorí štandardný dialóg so zadanou výzvou a zadávacím poľom na zadanie údajov (očakávaný je číselný údaj).

Príklad:

Double d = Svet.zadajReálneČíslo("Hodnota:", "Zadaj reálne číslo");

if (d != null)
{
    double a = d.doubleValue();
    Svet.správa("Zadané: " + F(a, 2));
}
else
    Svet.správa("Vstup bol zrušený alebo nesprávny.");

Ukážky možného vzhľadu dialógov zobrazených
počas vykonávania tohto príkladu (Windows).

Ukážky možného vzhľadu dialógov zobrazených
počas vykonávania tohto príkladu (macOS).

Parametre:: výzva – text výzvy; titulok – text titulku dialógového okna
Návratová hodnota:: objekt Double s celočíselnou hodnotou, ktorú zadal používateľ, alebo null ak používateľ dialóg zrušil alebo zadal reťazec, ktorý nebolo možné previesť na reálne číslo
Pozri tiež:: zadajReťazec(String), zadajReťazec(String, String), zadajHeslo(String), zadajHeslo(String, String), zadajCeléČíslo(String), zadajCeléČíslo(String, String), zadajReálneČíslo(String), upravReálneČíslo(double, String, String), dialóg(String[], Object[]), dialóg(String[], Object[], String), formát

zadajRealneCislo

public static Double zadajRealneCislo(String výzva,
                                      String titulok)

Alias pre zadajReálneČíslo.

upravReťazec
```
public static String upravReťazec(String reťazec,
                                  String výzva)
```
Otvorí štandardný dialóg so zadanou výzvou a zadávacím poľom na úpravu údajov. Funguje podobne ako metóda zadajReťazec, ibaže vyžaduje zadanie reťazca určeného na úpravu.
Ukážka dialógu (macOS).

Ukážka dialógu (Windows).

Parametre:

reťazec – reťazec určený na úpravu

výzva – text výzvy

Návratová hodnota:

objekt String s textom, ktorý používateľ upravil alebo null ak používateľ dialóg zrušil

Pozri tiež:

upravReťazec(String, String, String), upravCeléČíslo(long, String), upravCeléČíslo(long, String, String), upravReálneČíslo(double, String), upravReálneČíslo(double, String, String), zadajReťazec(String), dialóg(String[], Object[]), dialóg(String[], Object[], String)

upravRetazec

public static String upravRetazec(String reťazec,
                                  String výzva)

Alias pre upravReťazec.

upravReťazec
```
public static String upravReťazec(String reťazec,
                                  String výzva,
                                  String titulok)
```
Otvorí štandardný dialóg so zadanou výzvou a zadávacím poľom na úpravu údajov. Funguje podobne ako metóda zadajReťazec, ibaže vyžaduje zadanie reťazca určeného na úpravu.
Ukážka dialógu (macOS).

Ukážka dialógu (Windows).

Parametre:

reťazec – reťazec určený na úpravu

výzva – text výzvy

titulok – text titulku dialógového okna

Návratová hodnota:

objekt String s textom, ktorý používateľ upravil alebo null ak používateľ dialóg zrušil

Pozri tiež:

upravReťazec(String, String), upravCeléČíslo(long, String), upravCeléČíslo(long, String, String), upravReálneČíslo(double, String), upravReálneČíslo(double, String, String), zadajReťazec(String, String), dialóg(String[], Object[]), dialóg(String[], Object[], String)

upravRetazec

public static String upravRetazec(String reťazec,
                                  String výzva,
                                  String titulok)

Alias pre upravReťazec.

upravCeléČíslo
```
public static Long upravCeléČíslo(long celéČíslo,
                                  String výzva)
```
Otvorí štandardný dialóg so zadanou výzvou a zadávacím poľom na úpravu údajov (očakávaný je celočíselný údaj). Funguje podobne ako metóda zadajCeléČíslo, ibaže vyžaduje zadanie celého čísla určeného na úpravu.
Ukážka dialógu (macOS).

Ukážka dialógu (Windows).

Parametre:

celéČíslo – celé číslo určené na úpravu

výzva – text výzvy

Návratová hodnota:

objekt Long s celočíselnou hodnotou, ktorú používateľ upravil, alebo null ak používateľ dialóg zrušil alebo zadal reťazec, ktorý nebolo možné previesť na celé číslo

Pozri tiež:

upravReťazec(String, String), upravReťazec(String, String, String), upravCeléČíslo(long, String, String), upravReálneČíslo(double, String), upravReálneČíslo(double, String, String), zadajCeléČíslo(String), formát

upravCeleCislo

public static Long upravCeleCislo(long celéČíslo,
                                  String výzva)

Alias pre upravCeléČíslo.

upravCeléČíslo
```
public static Long upravCeléČíslo(long celéČíslo,
                                  String výzva,
                                  String titulok)
```
Otvorí štandardný dialóg so zadanou výzvou a zadávacím poľom na úpravu údajov (očakávaný je celočíselný údaj). Funguje podobne ako metóda zadajCeléČíslo, ibaže vyžaduje zadanie celého čísla určeného na úpravu.
Ukážka dialógu (macOS).

Ukážka dialógu (Windows).

Parametre:

celéČíslo – celé číslo určené na úpravu

výzva – text výzvy

titulok – text titulku dialógového okna

Návratová hodnota:

objekt Long s celočíselnou hodnotou, ktorú používateľ upravil, alebo null ak používateľ dialóg zrušil alebo zadal reťazec, ktorý nebolo možné previesť na celé číslo

Pozri tiež:

upravReťazec(String, String), upravReťazec(String, String, String), upravCeléČíslo(long, String), upravReálneČíslo(double, String), upravReálneČíslo(double, String, String), zadajCeléČíslo(String, String), formát

upravCeleCislo

public static Long upravCeleCislo(long celéČíslo,
                                  String výzva,
                                  String titulok)

Alias pre upravCeléČíslo.

upravReálneČíslo
```
public static Double upravReálneČíslo(double reálneČíslo,
                                      String výzva)
```
Otvorí štandardný dialóg so zadanou výzvou a zadávacím poľom na úpravu údajov (očakávaný je číselný údaj). Funguje podobne ako metóda zadajReálneČíslo, ibaže vyžaduje zadanie reálneho čísla určeného na úpravu.
Ukážka dialógu (macOS).

Ukážka dialógu (Windows).

Parametre:

reálneČíslo – reálne číslo určené na úpravu

výzva – text výzvy

Návratová hodnota:

objekt Double s celočíselnou hodnotou, ktorú používateľ upravil, alebo null ak používateľ dialóg zrušil alebo zadal reťazec, ktorý nebolo možné previesť na reálne číslo

Pozri tiež:

upravReťazec(String, String), upravReťazec(String, String, String), upravCeléČíslo(long, String), upravCeléČíslo(long, String, String), upravReálneČíslo(double, String, String), zadajReálneČíslo(String), formát

upravRealneCislo

public static Double upravRealneCislo(double reálneČíslo,
                                      String výzva)

Alias pre upravReálneČíslo.

upravReálneČíslo
```
public static Double upravReálneČíslo(double reálneČíslo,
                                      String výzva,
                                      String titulok)
```
Otvorí štandardný dialóg so zadanou výzvou a zadávacím poľom na úpravu údajov (očakávaný je číselný údaj). Funguje podobne ako metóda zadajReálneČíslo, ibaže vyžaduje zadanie reálneho čísla určeného na úpravu.
Ukážka dialógu (macOS).

Ukážka dialógu (Windows).

Parametre:

reálneČíslo – reálne číslo určené na úpravu

výzva – text výzvy

titulok – text titulku dialógového okna

Návratová hodnota:

objekt Double s celočíselnou hodnotou, ktorú používateľ upravil, alebo null ak používateľ dialóg zrušil alebo zadal reťazec, ktorý nebolo možné previesť na reálne číslo

Pozri tiež:

upravReťazec(String, String), upravReťazec(String, String, String), upravCeléČíslo(long, String), upravCeléČíslo(long, String, String), upravReálneČíslo(double, String), zadajReálneČíslo(String, String), formát

upravRealneCislo

public static Double upravRealneCislo(double reálneČíslo,
                                      String výzva,
                                      String titulok)

Alias pre upravReálneČíslo.

dialóg
```
public static boolean dialóg(String[] popisy,
                             Object[] údaje)
```
Otvorí prispôsobiteľný dialóg s prvkami vytvorenými podľa poľa údaje. Táto metóda funguje rovnako ako metóda dialóg(popisy, údaje, titulok), ale namiesto zadaného titulku dialógu je zobrazený predvolený text ("Dialóg"). Dalšie podrobnosti a príklad použitia nájdete v opise uvedenej metódy.

Parametre:

popisy – pole popisov komponentov

údaje – pole hodnôt komponentov, ktoré zároveň určuje typ komponentu

Návratová hodnota:

true znamená, že používateľ dialóg potvrdil

Pozri tiež:

zadajReťazec(String), zadajReťazec(String, String), zadajHeslo(String), zadajHeslo(String, String), zadajCeléČíslo(String), zadajCeléČíslo(String, String), zadajReálneČíslo(String), zadajReálneČíslo(String, String), upravReťazec(String, String), upravCeléČíslo(long, String), upravCeléČíslo(long, String, String), upravReálneČíslo(double, String), upravReálneČíslo(double, String, String), dialóg(String[], Object[], String)

dialog

public static boolean dialog(String[] popisy,
                             Object[] údaje)

Alias pre dialóg.

dialóg
```
public static boolean dialóg(String[] popisy,
                             Object[] údaje,
                             String titulok)
```
Vytvorí a otvorí prispôsobiteľný dialóg s prvkami vytvorenými podľa obsahu poľa údaje. Metóda akceptuje v poli prvkov údaje osem údajových typov (resp. v poslednom prípade špeciálnu hodnotu null) prvkov tohto poľa:
1. hodnota údajového typu String, ktorá spôsobí, že na určenej pozícii v dialógu sa bude nachádzať textové vstupné pole s predvolenou zadanou hodnotou (môže to byť aj prázdny reťazec "", ale údajový typ musí byť String),
2. hodnota údajového typu Double, ktorá spôsobí, že na určenej pozícii v dialógu sa bude nachádzať textové vstupné pole s predvolenou zadanou číselnou hodnotou; funguje podobne ako typ String, ale výsledok je automaticky prevedený na reálne číslo metódou reťazecNaReálneČíslo; ak pri prevode nastane chyba, v objekte bude uložená hodnota Double.NaN,
3. hodnota údajového typu Boolean, ktorá spôsobí, že na určenej pozícii v dialógu sa bude nachádzať prvok začiarkavacieho políčka s predvolenou zadanou hodnotou,
4. hodnota údajového typu Farba (čo je trieda programovacieho rámca GRobot), ktorá spôsobí, že na určenej pozícii dialógu bude zobrazený panel na výber farby s predvolenou zadanou farbou, pričom zmenu môže používateľ vykonať výberom z paletoy predvolených farieb programovacieho rámca alebo prostredníctvom preddefinovaného dialógu Javy, ktorý je dostupný cez prislúchajúce tlačidlo,
5. hodnota údajového typu Bod (čo je trieda programovacieho rámca GRobot), ktorá spôsobí, že na určenej pozícii dialógu bude zobrazený panel na grafickú voľbu polohy s predvolenou polohou podľa hodnôt v inštancii Bod a s možnosťou zadania súradníc do vstupných polí,
6. hodnota údajového typu Uhol (čo je trieda programovacieho rámca GRobot), ktorá spôsobí, že na určenej pozícii dialógu bude zobrazený panel na grafickú voľbu uhla (smeru) s predvolenou hodnotou podľa zadanej inštancie Uhol a s možnosťou zadania (zmeny) uhla prostredníctvom vstupného poľa,
7. hodnota údajového typu Rozmery (čo je trieda programovacieho rámca GRobot), ktorá spôsobí, že na určenej pozícii dialógu bude zobrazený panel na grafickú voľbu rozmerov s predvolenou šírkou a výškou podľa hodnôt uložených v inštancii Rozmery a s možnosťou zadania (zmeny) rozmerov do vstupných polí,
8. hodnota inštancie údajového typu Enum – čiže prvok enumeračného údajového typu; ktorý spôsobí, že na určenej pozícii dialógu bude zobrazený panel so zoznamom rádiových tlačidiel vytvorený podľa všetkých položiek dotknutého údajového typu, pričom zadaná hodnota bude použitá na určenie aktuálne zvoleného rádiového tlačidla (aktuálne zvolenej hodnoty v rámci skupiny týchto tlačidiel),
  - pozn.: texty položiek sú vytvárané automaticky pravidlami definovanými statickými inštanciami pomocnej triedy podpora.EnumRadioPanel.ConvertString, ktoré sú použiteľné v statickom atribúte podpora.EnumRadioPanel.convertString, prípadne z výstupov metód inštancií prvkov enumerácie Enum.toString(), z ktorých aspoň jeden musí byť rôzny od mena elementu enumerácie (inak bude použitý vyššie spomenutý mechanizmus automatickej konverzie),
9. inštancia netriedeného zoznamu Javy (Vector, resp. odvodeného, napr. Zoznam), ktorá spôsobí, že na určenej pozícii bude zobrazený zoznam položiek vytvorený z objektov zoznamu (okrem prvej položky) prevedených na reťazce; výnimku tvorí typový zoznam objektov Image (resp. odvodených, napr. Obrázok; opäť, okrem prvej položky), ktorý spôsobí zobrazenie obrázkového zoznamu; pozor, prvá položka zoznamu je rezervovaná na zadanie a prevzatie voľby zoznamu; táto položka je pri tvorbe zoznamu použitá na výber predvolenej položky zoznamu spomedzi ostatných položiek a po návrate je zmenená podľa voľby používateľa, čiže jej hodnota (ktorá je zmenená/nahradená aj v pôvodnom zozname) určuje používateľom zvolenú položku (hodnota null znamená, že používateľ nezvolil žiadnu položku alebo výber zrušil),
10. inštancia tably rolovania JScrollPane, ktorá je (prirodzene, že spolu s jej obsahom) do dialógu iba vložená; nie je nijako dodatočne spracovaná a je ponechaná na svojom mieste aj vo vrátených údajoch; programátor môže na tomto mieste s výhodou využiť pripravenú triedu podpora.ScrollTextPane, ktorá obsahuje niečo ako „odľahčenú verziu“ triedy PoznámkovýBlok (pretože poznámkový blok by v dialógu nebol použiteľný z dôvodu jeho úzkej viazanosti na komponent sveta),
11. hodnota údajového typu Character, ktorá má špeciálny význam – je rezervovaná na vkladanie riadiacich znakov – v súčasnosti sú platné tri hodnoty:
  znak nového riadka ('\n' – dá sa použiť znaková konštanta riadok) – táto hodnota prepne dialóg zo stĺpcového do riadkového režimu a všetky komponenty dialógu (zodpovedajúce jednotlivým prvkom vstupného poľa – zdrojovým prvkom), ktorých zdrojové prvky sú umiestnené medzi prvkami nového riadka (to znamená, že každý nový riadok musí byť samostatným prvkom vstupného poľa údaje), budú umiestnené na samostatnom neviditeľnom paneli dialógu – akoby v jednom riadku (k tomuto znaku musí v poli popisy párovať hodnota null);
  znak návratu vozíka ('\r' – dá sa použiť znaková konštanta návrat) – táto hodnota použije párujúci reťazec poľa popisy ako text bez párujúceho komponentu, čo sa dá využiť na vkladanie rôznych textov pomedzi komponenty (pozri aj príklad v opise metódy odpoveďDialógu)
  znak posunu formulára ('\f' – dá sa použiť znaková konštanta strana) – táto hodnota prepne dialóg do režimu viacerých stĺpcov; výskyt tohto znaku bude znamenať začiatok nového stĺpca vkladania komponentov dialógu (aj k tomuto znaku musí v poli popisy párovať hodnota null);
  (pozn.: od verzie 2.22 sa spolu s pridaním konštanty strana zmenila v dialógoch ešte jedna vec: predtým boli popisy komponentov v riadkovom rozložení pred nimi, od verzie 2.22 zostávajú nad nimi, ako je očakávané)
12. a hodnotu null, ktorá spôsobí, že na určenej pozícii bude umiestnený vstupný prvok na zadanie hesla.
Ku každému prvku poľa údaje musí byť zadaný korešpondujúci prvok poľa popisy, ktorý určí popis komponentu. Výnimku tvoria znaky nových riadkov (pozri bod s hodnotou údajového typu Character vyššie), ktoré nesmú mať zadaný korešpondujúci reťazec – pri ňom treba zadať namiesto platného reťazca hodnotu null, pretože platný reťazec by sa automaticky priradil k ďalšiemu komponentu v dialógu, čím by sa významovo posunul na nesprávne miesto a to by sa reťazovo premietlo do celého dialógu.

Poznámka: Pozor na rozdiel významov hodnoty null v poliach popisy a údaje. V poli popisy hodnota null páruje so „zalomením riadka“ ('\n') – akoby „vynecháva“ popis, aby počty prvkov v oboch poliach sedeli. V poli údaje prikazuje hodnota null vytvoriť komponent hesla (vrátane párujúceho popisu prečítaného z poľa popisy).

Posledný argument metódy – reťazec titulok určí titulok dialógu.

Pravdivá návratová hodnota vypovedá o tom, že používateľ dialóg skutočne potvrdil. (Texy tlačidiel dialógu je možné upraviť metódou textTlačidla.)

Príklad:
```
// Predpokladajme, že v premenných „meno“ a „heslo“ sú prihlasovacie
// údaje, pričom heslo môže byť zašifrované alebo zahešované…
String meno = "Mundos";
char[] heslo = {'a', 'b', 'c', 'd'};

// Pripravíme si pole údajov, s ktorými budeme pracovať:
Object[] údaje = {"", null, false};

// Tento príznak zabezpečí ukončenie aplikácie v prípade zlyhania
// prihlasovacieho procesu:
boolean prihlásenieZlyhalo = false;

// Spustíme dialóg a len v prípade, že ho používateľ potvrdil,
// overíme správnosť prihlasovacích údajov:
if (Svet.dialóg(new String[] {"Meno:", "Heslo:",
    "Zapamätaj si ma"}, údaje, "Prihlásenie sa…"))
{
    // Najprv overujeme prihlasovacie meno:
    if (null != údaje[0] && údaje[0] instanceof String &&
        meno.equalsIgnoreCase((String)údaje[0]))
    {
        // Potom heslo:
        if (null != údaje[1] && údaje[1] instanceof char[])
        {
            char porovnaj[] = (char[])údaje[1];

            // Niekde na tomto mieste by mohlo byť vykonané hešovanie
            // hesla, ale pozor, pôvodné aj hešlované heslo treba
            // po použití vyčistiť v súlade s tým, čo je vysvetlené
            // nižšie… (Hľadaj text začínajúci sa „Oracle odporúča“…)

            if (porovnaj.length == heslo.length)
            {
                for (int i = 0; i < porovnaj.length; ++i)
                    if (porovnaj[i] != heslo[i])
                    {
                        prihlásenieZlyhalo = true;
                        break;
                    }

                // Na tomto mieste by sme mohli zužitkovať voľbu
                // „Zapamätaj si ma“ (ktorá je v tomto príklade
                // použitá v podstate len na demonštráciu možností
                // metódy „dialóg“):
                if (!prihlásenieZlyhalo && null != údaje[2] &&
                    údaje[2] instanceof Boolean && (Boolean)údaje[2])
                {
                    //...
                    Svet.správa("Zvolili ste voľbu „Zapamätaj si ma“…");
                    //...
                }
            }
            else prihlásenieZlyhalo = true;
        }
        else prihlásenieZlyhalo = true;
    }
    else prihlásenieZlyhalo = true;
}
else prihlásenieZlyhalo = true;

// Oracle odporúča po použití hesla nastaviť každý jeho znak na nulu,
// aby nezostávalo uložené a vystopovateľné v pamäti RAM (tam by
// mohlo zostať aj po ukončení aplikácie, napr. v dôsledku
// nekorektného prihlásenia sa, preto toto čistenie vykonávame
// v každom prípade):
if (null != údaje[1] && údaje[1] instanceof char[])
{
    char vymaž[] = (char[])údaje[1];
    for (int i = 0; i < vymaž.length; ++i) vymaž[i] = 0;
}

// To isté urobíme aj so vzorom hesla…
for (int i = 0; i < heslo.length; ++i) heslo[i] = 0;

// V prípade zlyhania prihlasovacieho procesu aplikáciu ukončíme:
if (prihlásenieZlyhalo)
{
    Svet.správa("Prihlasovanie zlyhalo!");
    Svet.koniec();
    return; // (Volanie metódy „koniec“ nie je to isté ako okamžité
            // ukončenie aplikácie – „upratovacie procesy“ ešte môžu chvíľu trvať,
            // preto sem pridávame aj príkaz „return.“)
}

// ...
Svet.správa("Prihlásenie je v poriadku. Vitajte!");
```
Výsledok:

Po spustení aplikácie sa používateľovi zobrazí dialóg na obrázku nižšie.

Vyplnený dialóg príkadu (Windows).

Vyplnený dialóg príkadu (macOS).

Ak používateľ zadal správne údaje, tak pri zvolení voľby „Zapamätaj si ma“ (ako na obrázku) sa najprv zobrazí správa ‚Zvolili ste voľbu „Zapamätaj si ma“…‘ a po potvrdení správa „Prihlásenie je v poriadku. Vitajte!“
Parametre:

popisy – pole popisov komponentov

údaje – pole hodnôt komponentov, ktoré zároveň určuje typ komponentu

titulok – titulok dialógu

Návratová hodnota:

true znamená, že používateľ dialóg potvrdil

Pozri tiež:

zadajReťazec(String), zadajReťazec(String, String), zadajHeslo(String), zadajHeslo(String, String), zadajCeléČíslo(String), zadajCeléČíslo(String, String), zadajReálneČíslo(String), zadajReálneČíslo(String, String), upravReťazec(String, String), upravCeléČíslo(long, String), upravCeléČíslo(long, String, String), upravReálneČíslo(double, String), upravReálneČíslo(double, String, String), dialóg(String[], Object[])

dialog

public static boolean dialog(String[] popisy,
                             Object[] údaje,
                             String titulok)

Alias pre dialóg.

mojeOdpovede
```
public static void mojeOdpovede(Object[] odpovede)
```
Zmení predvolené odpovede komunikačných dialógov programovacieho rámca na vlastné. Predvolené odpovede sú len dve: OK a Zrušiť. Ich znenie sa dá zmeniť metódou textTlačidla, ale nie ich počet. Touto metódou sa dá zmeniť nielen ich znenie, ale aj ich počet. Tým sa dá navýšiť počet volieb, ktoré môže vykonať používateľ.

Z dôvodu sprístupnenia ďalších volieb programátorovi a zároveň zachovania spätnej kompatibility dialógov, bola definovaná nová metóda: odpoveďDialógu. Jej návratová hodnota určuje voľbu používateľa pri zavretí posledného zobrazeného komunikačného dialógu.

Vlastné odpovede budú platné do okamihu, kým nie je táto metóda volaná s parametrom null.

Trochu to mení spôsob práce s dialógmi. Prakticky to ukazuje nasledujúci príklad.

Príklad:
```
Svet.mojeOdpovede(new String[]{"Áno", "Nie", "Vždy", "Nikdy"});

Svet.dialóg(new String[]{"Chcete naozaj vykonať túto operáciu?"},
    new Object[]{'\r'}, "Otázka…");

Svet.vypíš(Svet.odpoveďDialógu(), ' ');


Svet.mojeOdpovede(new String[]{"Áno", "Nie", "Zrušiť"});

Svet.dialóg(new String[]{"Chcete naozaj vykonať túto operáciu?",
    "Zapamätať si moju voľbu"}, new Object[]{'\r', false}, "Otázka…");

Svet.vypíš(Svet.odpoveďDialógu(), ' ');


Svet.mojeOdpovede(null);
```
Parametre:

odpovede – zoznam vlastných odpovedí dialógov

Pozri tiež:

odpoveďDialógu()

mojeOdpovede
```
public static Object[] mojeOdpovede()
```
Vráti pole vlastných odpovedí komunikačných dialógov programovacieho rámca alebo hodnotu null, ak sú aktívne predvolené odpovede. Podrobnosti nájdete v opise príbuznej metódy mojeOdpovede.

Návratová hodnota:

aktuálne pole vlastných odpovedí alebo null

odpoveďDialógu
```
public static int odpoveďDialógu()
```
Vráti číslo (index) voľby v poslednom dialógu, ktorý bol zobrazený používateľovi. Klasicky (historicky) boli v dialógoch k dispozícii len dve možné odpovede (voľby/tlačidlá; ak nerátame zavretie dialógu „krížikom“ – tlačidlom zavretia okna OS): OK a Zrušiť.

Poznámka: Voľba systémového tlačidla zavretia dialógu („krížika“ na ráme dialógového okna) vráti kód −1 a jednotlivé tlačidlá umiestnené v spodnej časti dialógu vracajú kódy od indexu 0 po hodnotu počtu tlačidiel mínus jedna.

Obmedzenie dvoch tlačidiel sa zmenilo implementovaním metódy mojeOdpovede, ktorá dovoľuje pridať prakticky ľubovoľné množstvo tlačidiel odpovedí. Bolo by zbytočné mať k dispozícii množstvo volieb a nemať možnosť zistiť, ktorá z nich bola zvolená. Preto vznikla táto metóda, ktorá dovoľuje po zavretí dialógu zistiť, ktorá z možností bola používateľom vybraná.

Príklad použitia je v opise metódy mojeOdpovede.

Návratová hodnota:

voľba používateľa v naposledy potvrdenom (zavretom) komunikačnom dialógu

Pozri tiež:

mojeOdpovede(Object[])

odpovedDialogu
```
public static int odpovedDialogu()
```
Alias pre odpoveďDialógu.

správa
```
public static void správa(String správa)
```
Zobrazí štandardný dialóg so zadanou textovou správou.

Ukážka vzhľadu dialógu s informačnou správou (Windows).

Ukážka vzhľadu dialógu s informačnou správou (macOS).

Parametre:

správa – text správy

Pozri tiež:

správa(String, String), varovanie(String), chyba(String), otázka(String), otázka(String, String), otázka(String, Object[]), otázka(String, String, Object[]), otázka(String, Object[], int), otázka(String, String, Object[], int)

sprava

public static void sprava(String správa)

Alias pre správa.

správa
```
public static void správa(String správa,
                          String titulok)
```
Zobrazí štandardný dialóg so zadanou textovou správou.

Ukážka vzhľadu dialógu s informačnou správou (Windows).

Ukážka vzhľadu dialógu s informačnou správou (macOS).

Parametre:

správa – text správy

titulok – text titulku dialógového okna správy

Pozri tiež:

správa(String), varovanie(String, String), chyba(String, String), otázka(String), otázka(String, String), otázka(String, Object[]), otázka(String, String, Object[]), otázka(String, Object[], int), otázka(String, String, Object[], int)

sprava

public static void sprava(String správa,
                          String titulok)

Alias pre správa.

varovanie
```
public static void varovanie(String varovanie)
```
Zobrazí štandardný dialóg so zadanou textovou správou a ikonou varovania.

Ukážka vzhľadu dialógu s varovaním (Windows).

Ukážka vzhľadu dialógu s varovaním (macOS).

Parametre:

varovanie – text s obsahom varovania

Pozri tiež:

správa(String), správa(String, String)

varovanie
```
public static void varovanie(String varovanie,
                             String titulok)
```
Zobrazí štandardný dialóg so zadanou textovou správou a ikonou varovania.

Ukážka vzhľadu dialógu s varovaním (Windows).

Ukážka vzhľadu dialógu s varovaním (macOS).

Parametre:

varovanie – text s obsahom varovania

titulok – text titulku dialógového okna varovania

Pozri tiež:

správa(String), správa(String, String)

chyba
```
public static void chyba(String chyba)
```
Zobrazí štandardný dialóg so zadanou textovou správou a ikonou chyby.

Ukážka vzhľadu dialógu s chybovým hlásením (Windows).

Ukážka vzhľadu dialógu s chybovým hlásením (macOS).

Parametre:

chyba – text s obsahom chyby

Pozri tiež:

správa(String), správa(String, String)

chyba
```
public static void chyba(String chyba,
                         String titulok)
```
Zobrazí štandardný dialóg so zadanou textovou správou a ikonou chyby.

Ukážka vzhľadu dialógu s chybovým hlásením (Windows).

Ukážka vzhľadu dialógu s chybovým hlásením (macOS).

Parametre:

chyba – text s obsahom chyby

titulok – text titulku dialógového okna chyby

Pozri tiež:

správa(String), správa(String, String)

otázka

public static int otázka(String otázka)

Zobrazí štandardný dialóg s otázkou na používateľa (odpoveď používateľ volí stlačením tlačidla).

Príklad:

int i = Svet.otázka("Dobre?");
if (ÁNO == i) Svet.vypíš("Odpoveď: áno");
if (NIE == i) Svet.vypíš("Odpoveď: nie");
if (ZAVRETÉ == i) Svet.vypíš("Nechceš odpovedať…");




Ukážky možného vzhľadu dialógov a odpovedí zobrazených počas vykonávania tohto príkladu.

Parametre:: otázka – text otázky
Návratová hodnota:: celé číslo označujúce „poradové číslo“ (index) tlačidla zvoleného ako odpoveď alebo ZAVRETÉ, keď používateľ zavrel dialóg
Pozri tiež:: správa(String), správa(String, String), otázka(String, String), otázka(String, Object[]), otázka(String, String, Object[]), otázka(String, Object[], int), otázka(String, String, Object[], int)

otazka

public static int otazka(String otázka)

Alias pre otázka.

otázka

public static int otázka(String otázka,
                         String titulok)

Zobrazí štandardný dialóg s otázkou na používateľa (odpoveď používateľ volí stlačením tlačidla).

Príklad:

int i = Svet.otázka("Dobre?", "Otázočka na teba…");
if (ÁNO == i) Svet.vypíš("Odpoveď: áno");
if (NIE == i) Svet.vypíš("Odpoveď: nie");
if (ZAVRETÉ == i) Svet.vypíš("Nechceš odpovedať…");




Ukážky možného vzhľadu dialógov a odpovedí zobrazených počas vykonávania tohto príkladu.

Parametre:: otázka – text otázky; titulok – text titulku okna s otázkou
Návratová hodnota:: celé číslo označujúce „poradové číslo“ (index) tlačidla zvoleného ako odpoveď alebo ZAVRETÉ, keď používateľ zavrel dialóg
Pozri tiež:: správa(String), správa(String, String), otázka(String), otázka(String, Object[]), otázka(String, String, Object[]), otázka(String, Object[], int), otázka(String, String, Object[], int)

otazka

public static int otazka(String otázka,
                         String titulok)

Alias pre otázka.

otázka

public static int otázka(String otázka,
                         Object[] tlačidlá)

Zobrazí štandardný dialóg s otázkou na používateľa (odpoveď používateľ volí stlačením tlačidla).

Príklad:

int i = Svet.otázka("Ako?", new String[]{"Zle", "Dobre"});
// Spracovanie… Pozri príklad pri: otázka(otázka, titulok, tlačidlá, predvolenéTlačidlo)

Ukážka možného vzhľadu dialógu
zobrazeného počas vykonávania tohto príkladu (Windows).

Ukážka dialógu (macOS).

Parametre:: otázka – text otázky; tlačidlá – zoznam popisov tlačidiel
Návratová hodnota:: celé číslo označujúce „poradové číslo“ (index) tlačidla zvoleného ako odpoveď alebo ZAVRETÉ, keď používateľ zavrel dialóg
Pozri tiež:: správa(String), správa(String, String), otázka(String), otázka(String, String), otázka(String, String, Object[]), otázka(String, Object[], int), otázka(String, String, Object[], int)

otazka

public static int otazka(String otázka,
                         Object[] tlačidlá)

Alias pre otázka.

otázka

public static int otázka(String otázka,
                         String titulok,
                         Object[] tlačidlá)

Zobrazí štandardný dialóg s otázkou na používateľa (odpoveď používateľ volí stlačením tlačidla).

Príklad:

int i = Svet.otázka("Ako?", "Otázočka na teba…", new String[]{"Zle", "Dobre"});
// Spracovanie… Pozri príklad pri: otázka(otázka, titulok, tlačidlá, predvolenéTlačidlo)

Ukážka možného vzhľadu dialógu
zobrazeného počas vykonávania tohto príkladu (Windows).

Ukážka dialógu (macOS).

Parametre:: otázka – text otázky; titulok – text titulku okna s otázkou; tlačidlá – zoznam popisov tlačidiel
Návratová hodnota:: celé číslo označujúce „poradové číslo“ (index) tlačidla zvoleného ako odpoveď alebo ZAVRETÉ, keď používateľ zavrel dialóg
Pozri tiež:: správa(String), správa(String, String), otázka(String), otázka(String, String), otázka(String, Object[]), otázka(String, Object[], int), otázka(String, String, Object[], int)

otazka

public static int otazka(String otázka,
                         String titulok,
                         Object[] tlačidlá)

Alias pre otázka.

otázka

public static int otázka(String otázka,
                         Object[] tlačidlá,
                         int predvolenéTlačidlo)

Zobrazí štandardný dialóg s otázkou na používateľa (odpoveď používateľ volí stlačením tlačidla).

Príklad:

int i = Svet.otázka("Ako?", new String[]{"Zle", "Dobre"}, 1);
// Spracovanie… Pozri príklad pri: otázka(otázka, titulok, tlačidlá, predvolenéTlačidlo)

Ukážka možného vzhľadu dialógu
zobrazeného počas vykonávania tohto príkladu (Windows).

Ukážka dialógu (macOS).

Parametre:: otázka – text otázky; tlačidlá – zoznam popisov tlačidiel; predvolenéTlačidlo – „poradové číslo“ (index) predvoleného tlačidla
Návratová hodnota:: celé číslo označujúce „poradové číslo“ (index) tlačidla zvoleného tlačidla ako odpoveď alebo ZAVRETÉ, keď používateľ zavrel dialóg
Pozri tiež:: správa(String), správa(String, String), otázka(String), otázka(String, String), otázka(String, Object[]), otázka(String, String, Object[]), otázka(String, String, Object[], int)

otazka

public static int otazka(String otázka,
                         Object[] tlačidlá,
                         int predvolenéTlačidlo)

Alias pre otázka.

otázka

public static int otázka(String otázka,
                         String titulok,
                         Object[] tlačidlá,
                         int predvolenéTlačidlo)

Zobrazí štandardný dialóg s otázkou na používateľa (odpoveď používateľ volí stlačením tlačidla).

Príklad:

int i = Svet.otázka("Ako?", "Otázočka na teba…", new String[]{"Zle", "Dobre"}, 1);
if (0 == i) Svet.vypíš("Zle, vravíš? Škoda…");
if (1 == i) Svet.vypíš("Dobre, vravíš? Výborne!");
if (ZAVRETÉ == i) Svet.vypíš("Nechceš odpovedať…");





Ukážky možného vzhľadu dialógov (Windows a macOS) a odpovedí zobrazených počas vykonávania tohto príkladu.

Parametre:: otázka – text otázky; titulok – text titulku okna s otázkou; tlačidlá – zoznam popisov tlačidiel; predvolenéTlačidlo – „poradové číslo“ (index) predvoleného tlačidla
Návratová hodnota:: celé číslo označujúce „poradové číslo“ (index) tlačidla zvoleného ako odpoveď alebo ZAVRETÉ, keď používateľ zavrel dialóg
Pozri tiež:: správa(String), správa(String, String), otázka(String), otázka(String, String), otázka(String, Object[]), otázka(String, String, Object[]), otázka(String, Object[], int)

otazka

public static int otazka(String otázka,
                         String titulok,
                         Object[] tlačidlá,
                         int predvolenéTlačidlo)

Alias pre otázka.

textTlačidla
```
public static String textTlačidla(String tlačidlo)
```
Umožňuje overiť aktuálne definované znenie textu tlačidla konkrétnej odpovede na otázku (pozri napríklad metódu otázka) alebo zadania/zmeny údaju (pozri napríklad metódu zadajReťazec). Predvolené znenie textov tlačidiel sa dá zmeniť metódou textTlačidla(tlačidlo, text). Táto metóda prijíma text, ktorý považuje za univerzálny identifikátor tlačidla a vráti skutočný text tlačidla.

Parametre:

tlačidlo – musí byť jeden z nasledujúcich predvolených textov: "áno", "nie", "ok", "zrušiť", "reset farby", "miešanie farby", "reset polohy", "reset smeru" alebo "reset rozmeru" (na veľkosti písmen nezáleží; programovací rámec prijme aj predvolené texty bez diakritiky alebo bez medzier, ale v tom prípade je potrebné ju/ich vynechať v celom slove/texte)

Návratová hodnota:

aktuálny text určeného tlačidla alebo null ak je hodnota argumentu neplatná

Pozri tiež:

mojeOdpovede(Object[])

textTlacidla

public static String textTlacidla(String tlačidlo)

Alias pre textTlačidla.

textTlačidla
```
public static void textTlačidla(String tlačidlo,
                                String text)
```
Umožňuje upraviť text tlačidla odpovede na otázku (pozri napríklad metódu otázka) alebo zadania údaju (pozri napríklad metódu zadajReťazec).

Parametre:

tlačidlo – musí byť jeden z nasledujúcich predvolených textov: "áno", "nie", "ok", "zrušiť", "reset farby", "miešanie farby", "reset polohy", "reset smeru" alebo "reset rozmeru" (na veľkosti písmen nezáleží; programovací rámec prijme aj predvolené texty bez diakritiky alebo bez medzier, ale v tom prípade je potrebné ju/ich vynechať v celom slove/texte)

text – nový text určeného tlačidla (ak je hodnota prvého argumentu neplatná, nebude mať volanie tejto metódy žiadny efekt)

textTlacidla

public static void textTlacidla(String tlačidlo,
                                String text)

Alias pre textTlačidla.

textMenovky
```
public static String textMenovky(String menovka)
```
Umožňuje overiť aktuálne definované znenie textu menovky na niektorých paneloch volieb (pozri napríklad metódu dialóg). Predvolené znenie textov menoviek sa dá zmeniť metódou textMenovky(menovka, text). Táto metóda prijíma text, ktorý považuje za univerzálny identifikátor menovky a vráti skutočný text menovky.

Parametre:

menovka – musí byť jeden z nasledujúcich predvolených textov: "menovka x", "menovka y", "menovka šírky" alebo "menovka výšky" (na veľkosti písmen nezáleží; programovací rámec prijme aj predvolené texty bez diakritiky alebo bez medzier, ale v tom prípade je potrebné ju/ich vynechať v celom slove/texte)

Návratová hodnota:

aktuálny text určenej menovky alebo null ak je hodnota argumentu neplatná

textMenovky
```
public static void textMenovky(String menovka,
                               String text)
```
Umožňuje upraviť text menovky na niektorých paneloch volieb (pozri napríklad metódu dialóg).

Parametre:

menovka – musí byť jeden z nasledujúcich predvolených textov: "menovka x", "menovka y", "menovka šírky" alebo "menovka výšky" (na veľkosti písmen nezáleží; programovací rámec prijme aj predvolené texty bez diakritiky alebo bez medzier, ale v tom prípade je potrebné ju/ich vynechať v celom slove/texte)

text – nový text určenej menovky (ak je hodnota prvého argumentu neplatná, nebude mať volanie tejto metódy žiadny efekt)

zobrazÚvodnúObrazovku

public static void zobrazÚvodnúObrazovku(Image obrázok)

Zobrazí úvodnú obrazovku so zadaným obrázkom. Úvodná obrazovka (splash screen) je dekoračný obrázok zobrazovaný počas inicializácie aplikácie. Má upozorniť používateľa, že aplikácia sa práve spúšťa a potrebuje čas na svoju úplnú inicializáciu. Volanie tejto metódy zároveň spôsobí skrytie hlavného okna aplikácie (sveta), nezabudnite preto po skončení inicializácie použiť metódu skryÚvodnúObrazovku na skrytie úvodnej obrazovky a zobrazenie hlavného okna sveta…

Poznámka: Java má vlastný mechanizmus definovania úvodnej obrazovky (SplashScreen), avšak takúto úvodnú obrazovku nie je možné vytvoriť programovo, preto používa programovací rámec GRobot svoj vlastný spôsob.

Obrázok pre túto verziu metódy musíte definovať sami. Nie je predpísaný spôsob, ale priam sa ponúka využitie triedy Obrázok a mechanizmu kreslenia na obrázok pomocou robota. Treba pri tom zvážiť viacero okolností. Zobrazenie úvodnej obrazovky je očakávané v čase, keď ešte hlavné okno nie je zobrazené. V podstate v čase, keď ešte nejestvuje žiadny robot. Preto, ak chceme používať kreslenie pomocou robota, musíme jedného na tento účel vytvoriť. Prvý vytvorený robot je zároveň hlavný robot zodpovedný za vytvorenie a zobrazenie hlavného okna. Preto musíme pred jeho vytvorením volať metódu Svet.skry(). Najlepšie je celý kód umiestniť do hlavnej metódy (main).

Príklad:

import knižnica.*;

public class HlavnáTrieda extends GRobot
{
    private HlavnáTrieda()
    {
        Svet.čakaj(3.0);
    }

    public static void main(String[] args)
    {
        Svet.skry();

        GRobot kreslič = new GRobot();
        Obrázok obrázok = new Obrázok(300, 200);
        kreslič.kresliNaObrázok(obrázok);

        // Kreslenie
        obrázok.vyplň(svetlošedá);

        // Chceli sme orámovať plochu obrázka. Robot pracuje s odlišným
        // súradnicovým priestorom, preto bolo na nájdenie vhodných hodnôt
        // potrebné trochu experimentovať:
        kreslič.skoč(-0.5, 0.5);
        kreslič.obdĺžnik(149.5, 99.5);

        kreslič.písmo("Arial", 32);
        kreslič.text("Čakajte…");

        // kreslič.skry(); // ← týmto spôsobom by sme v podstate zamedzili,
            // aby sa inštancia hlavnej triedy stala hlavným robotom (čo
            // by nebolo podľa nášho očakávania) a hlavným robotom by zostal
            // skrytý kreslič; preto urobíme toto:
        Svet.uvoľni(kreslič);

        // Zobrazenie
        Svet.zobrazÚvodnúObrazovku(obrázok);
        new HlavnáTrieda();
        Svet.skryÚvodnúObrazovku();
    }
}

Vidíme, že tento spôsob prináša určité komplikácie (pozri text pred príkladom), preto odporúčame obrázok určený na zobrazenie počas inicializácie uložiť do súboru v niektorom z podporovaných súborových formátov a použiť ďalšiu verziu metódy zobrazÚvodnúObrazovku prijímajúcu názov súboru: zobrazÚvodnúObrazovku(názovSúboru).

Vhodný obrázok si môžeme vyrobiť aj sami. Nasledujúci príklad nahrádza obsah metódy main predchádzajúceho príkladu. Využíva obe verzie metódy zobrazÚvodnúObrazovku. Ak súbor s obrázkom jestvuje, zobrazí ho, inak ho najskôr vyrobí a potom zobrazí jeho vyrobenú verziu uloženú v pamäti:

if (Súbor.jestvuje("môjObrázok.png"))
    Svet.zobrazÚvodnúObrazovku("môjObrázok.png");
else
{
    Svet.skry();

    GRobot kreslič = new GRobot();
    Obrázok obrázok = new Obrázok(300, 200);
    kreslič.kresliNaObrázok(obrázok);

    // Kreslenie
    kreslič.farba(199, 201, 203, 9);
    for (double i = 1; i > 0; i -= 0.03)
        kreslič.vyplňElipsu(150.0 * i, 100.0 * i);

    kreslič.farba(99, 101, 103);
    kreslič.písmo("Arial", 32);
    kreslič.text("Čakajte…");

    obrázok.ulož("môjObrázok.png");

    // Tento robot bol doteraz hlavným robotom. Aby bolo vykonávanie
    // programu konzistetné v oboch prípadoch – keď obrázok úvodnej
    // obrazovky nejestvuje a keď obrázok už bol vytvorený – odstránime
    // v tejto vetve kresliča z pamäte počítača. Hlavným robotom sa
    // potom stane inštancia triedy HlavnáTrieda – rovnako ako po
    // vykonaní hlavnej vetvy tohto vetvenia.
    // (Poznámka: Nastavenie farby robota na červenú je len
    //  ilustračné – aby bolo vidno, že robot naozaj nejestvuje.)
    kreslič.farba(červená);
    Svet.uvoľni(kreslič);

    // Zobrazenie
    Svet.zobrazÚvodnúObrazovku(obrázok);
}

new HlavnáTrieda();
Svet.skryÚvodnúObrazovku();

// Ak by sme vo vedľajšej vetve vyššie uvedeného vetvenia neodstránili
// robot (kresliča), tak pri prvom spustení (keby ešte nejestvoval
// obrázok) by sa nasledujúca kružnica nenakreslila a pod robotom
// inštancie HlavnáTrieda by bolo vidno (aspoň presvitajúc) ďalší
// červený robot. Kružnica by sa v skutočnosti nakreslila –
// červenou farbou, ale do inštancie obrázok, do ktorej má kreslič
// presmerované kreslenie. (Obrázok je v tom čase už uložený, takže
// v ňom by ste ju nenašli.) Pri každom ďalšom spustení by sa
// nakreslila kružnica inštanciou triedy HlavnáTrieda (predvolene
// čiernou farbou). Uvoľnenie kresliča z pamäte túto nekonzistenciu
// odstraňuje.
Svet.hlavnýRobot().kružnica(50);

O niečo zdokonalenú verziu môžete vidieť na nasledujúcom obrázku:

Obrázok zobrazený pri
spustení aplikácie (príkladu).

Obrázok úvodnej obrazovky – „uvodnaObrazovka1.png.“

Obrázok je pre demonštráciu polopriehľadný. Zobrazenie priehľadnosti okna závisí od platformy a verzie Javy.

Upozornenie: Robot (kresliča) síce odstránime z pamäti počítača, svet sa však už zrušiť nedá. Rovnako platí, že svet je vytvorený i pri vykonaní príkazu zobrazÚvodnúObrazovku(názovSúboru). Z týchto dôvodov nie je možné po použití príkazov na zobrazenie úvodnej obrazovky použiť v konštruktore hlavnej triedy príkaz super na nastavenie rozmerov plátna. Program by sa zrútil so vznikom výnimky „Svet už jestvuje!“ Dá sa však použiť príkaz zmeňRozmeryPlátien.

Parametre:: obrázok – objekt obrázka; môže byť použitý aj objekt typu Obrázok
Pozri tiež:: zobrazÚvodnúObrazovku(String), skryÚvodnúObrazovku()

zobrazUvodnuObrazovku

public static void zobrazUvodnuObrazovku(Image úvodnýObrázok)

Alias pre zobrazÚvodnúObrazovku.

zobrazÚvodnúObrazovku
```
public static void zobrazÚvodnúObrazovku(String názovSúboru)
```
Zobrazí úvodnú obrazovku so zadaným obrázkom prečítaným zo súboru. Úvodná obrazovka (splash screen) je dekoračný obrázok zobrazovaný počas inicializácie aplikácie. Má upozorniť používateľa, že aplikácia sa práve spúšťa a potrebuje čas na svoju úplnú inicializáciu. Volanie tejto metódy zároveň spôsobí skrytie hlavného okna aplikácie (sveta), nezabudnite preto po skončení inicializácie použiť metódu skryÚvodnúObrazovku na skrytie úvodnej obrazovky a zobrazenie hlavného okna sveta…

Poznámka: Java má vlastný mechanizmus definovania úvodnej obrazovky (SplashScreen), avšak takúto úvodnú obrazovku nie je možné vytvoriť programovo, preto používa programovací rámec GRobot svoj vlastný spôsob.

Príklad:
```
import knižnica.*;

public class HlavnáTrieda extends GRobot
{
    private HlavnáTrieda()
    {
        Svet.čakaj(1.0);
    }

    public static void main(String[] args)
    {
        Svet.zobrazÚvodnúObrazovku("môjObrázok.png");
        new HlavnáTrieda();
        Svet.skryÚvodnúObrazovku();
    }
}
```
Upozornenie: Vykonanie tohto príkazu má za následok inicializáciu sveta. Z toho dôvodu nie je možné po jeho použití použiť v konštruktore hlavnej triedy príkaz super na nastavenie rozmerov plátna. Program by sa zrútil so vznikom výnimky „Svet už jestvuje!“ Dá sa však použiť príkaz zmeňRozmeryPlátien.

Obrázok prečítaný zo súboru je chápaný ako zdroj a po prečítaní zostane uložený vo vnútornej pamäti sveta. Z nej môže byť v prípade potreby (napríklad ak sa obsah súboru na disku zmenil) odstránený metódou Svet.uvoľni(názovZdroja). (Táto informácia je platná pre všetky metódy pracujúce s obrázkami alebo zvukmi, ktoré prijímajú názov súboru ako parameter.)
Parametre:

názovSúboru – názov súboru s obrázkom (prípona súboru musí byť .gif, .png alebo .jpg (resp. .jpeg))

Výnimky:

GRobotException – ak súbor s obrázkom nebol nájdený

Pozri tiež:

zobrazÚvodnúObrazovku(Image), skryÚvodnúObrazovku(), priečinokObrázkov(String)

zobrazUvodnuObrazovku

public static void zobrazUvodnuObrazovku(String názovSúboru)

Alias pre zobrazÚvodnúObrazovku.

skryÚvodnúObrazovku
```
public static void skryÚvodnúObrazovku()
```
Skryje úvodnú obrazovku a zobrazí hlavné okno aplikácie. Viac informácií nájdete v opisoch metód zobrazÚvodnúObrazovku(obrázok) a zobrazÚvodnúObrazovku(názovSúboru)…

Pozri tiež:

zobrazÚvodnúObrazovku(Image), zobrazÚvodnúObrazovku(String)

skryUvodnuObrazovku
```
public static void skryUvodnuObrazovku()
```
Alias pre skryÚvodnúObrazovku.

začniVstup
```
public static boolean začniVstup()
```
Zobrazí vstupný riadok v spodnej časti okna. Aplikácia pokračuje v činnosti. Ak bol vstupný riadok zobrazený (t. j. už prebieha iný vstup), metóda sa predčasne ukončí a vráti false. Riadok je možné zrušiť klávesom Escape alebo potvrdiť klávesom Enter. Ak bola použitá metóda neskrývajVstupnýRiadok, kláves Escape iba vymaže obsah vstupného riadka, ale neskryje ho. Po potvrdení vstupu klávesom Enter aplikácia vyvolá metódu počúvadla potvrdenieÚdajov. V nej môže programátor získať zadané údaje metódami prevezmiReťazec, prevezmiCeléČíslo alebo prevezmiReálneČíslo. V prípade, že potvrdené údaje nie sú v správnom tvare (platí pre celé alebo reálne číslo), vrátia metódy prevezmiCeléČíslo a prevezmiReálneČíslo hodnotu null.

Poznámka: Táto metóda je použitá v príklade „Hra na ozvenu,“ ktorý sa nachádza v úvode dokumentácie tejto triedy…

Návratová hodnota:

true ak bol pred volaním metódy vstupný riadok skrytý, false ak bol vstupný riadok zobrazený (čiže ak vstup už prebieha)

Pozri tiež:

začniVstup(String), potvrďVstup(), zrušVstup(), vstupnýRiadokZobrazený(), vstupnýRiadok(), panelVstupnéhoRiadka(), prevezmiReťazec(), históriaVstupnéhoRiadka()

zacniVstup
```
public static boolean zacniVstup()
```
Alias pre začniVstup.

začniVstup
```
public static boolean začniVstup(String výzva)
```
Funguje rovnako ako začniVstup(), s tým rozdielom, že pred vstupným riadkom je zobrazená návesť s výzvou.

Parametre:

výzva – text výzvy zobrazenej vo forme náveste pred vstupným riadkom

Návratová hodnota:

true ak bol pred volaním metódy vstupný riadok skrytý, false ak bol vstupný riadok zobrazený (čiže ak už vstup prebieha)

Pozri tiež:

začniVstup(), potvrďVstup(), zrušVstup(), vstupnýRiadokZobrazený(), vstupnýRiadok(), panelVstupnéhoRiadka(), prevezmiReťazec(), históriaVstupnéhoRiadka()

zacniVstup

public static boolean zacniVstup(String výzva)

Alias pre začniVstup.

potvrďVstup
```
public static void potvrďVstup()
```
Vykoná pre vstupný riadok rovnakú akciu ako pri stlačení klávesu Enter.

Pozri tiež:

začniVstup(), začniVstup(String), zrušVstup(), vstupnýRiadokZobrazený(), vstupnýRiadok(), panelVstupnéhoRiadka(), prevezmiReťazec(), históriaVstupnéhoRiadka()

potvrdVstup
```
public static void potvrdVstup()
```
Alias pre potvrďVstup.

zrušVstup
```
public static void zrušVstup()
```
Vykoná pre vstupný riadok rovnakú akciu ako pri stlačení klávesu Escape.

Pozri tiež:

začniVstup(), začniVstup(String), potvrďVstup(), vstupnýRiadokZobrazený(), vstupnýRiadok(), panelVstupnéhoRiadka(), prevezmiReťazec()

zrusVstup
```
public static void zrusVstup()
```
Alias pre zrušVstup.

vstupnýRiadokZobrazený
```
public static boolean vstupnýRiadokZobrazený()
```
Overí, či je zobrazený panel vstupného riadka.

Návratová hodnota:

true – áno; false – nie

Pozri tiež:

neskrývajVstupnýRiadok(), neskrývajVstupnýRiadok(boolean), skrývajVstupnýRiadok(), skrývajVstupnýRiadok(boolean), aktivujVstupnýRiadok(), začniVstup(), vstupnýRiadok(), panelVstupnéhoRiadka(), prevezmiReťazec()

vstupnyRiadokZobrazeny
```
public static boolean vstupnyRiadokZobrazeny()
```
Alias pre vstupnýRiadokZobrazený.

neskrývajVstupnýRiadok
```
public static void neskrývajVstupnýRiadok()
```
Prikáže vstupnému riadku, aby sa neskrýval po potvrdení klávesom Enter. Ak je v čase spustenia tejto metódy skrytý, je ho potrebné zobraziť metódou začniVstup alebo použiť alternatívnu metódu neskrývajVstupnýRiadok(boolean začniVstup).

Poznámka: Táto metóda je použitá v príklade „Hra na ozvenu,“ ktorý sa nachádza v úvode dokumentácie tejto triedy…

Pozri tiež:

vstupnýRiadokZobrazený(), neskrývajVstupnýRiadok(boolean), skrývajVstupnýRiadok(), skrývajVstupnýRiadok(boolean), aktivujVstupnýRiadok(), začniVstup(), vstupnýRiadok(), panelVstupnéhoRiadka(), prevezmiReťazec(), históriaVstupnéhoRiadka()

neskryvajVstupnyRiadok
```
public static void neskryvajVstupnyRiadok()
```
Alias pre neskrývajVstupnýRiadok.

neskrývajVstupnýRiadok
```
public static boolean neskrývajVstupnýRiadok(boolean začniVstup)
```
Prikáže vstupnému riadku, aby sa neskrýval po potvrdení klávesom Enter. Táto metóda je alternatívou metódy neskrývajVstupnýRiadok, pričom poskytuje rozšírenú funkcionalitu opísanú nižšie…

Parametre:

začniVstup – ak je true, vykoná sa zároveň metóda začniVstup; ak je false, vstupný riadok zostane v pôvodnom stave

Návratová hodnota:

ak má parameter začniVstup hodnotu true, tak návratová hodnota je návratovou hodnotou metódy začniVstup; ak má parameter začniVstup hodnotu false, tak návratová hodnota je true ak je vstupný riadok zobrazený a false v opačnom prípade

Pozri tiež:

vstupnýRiadokZobrazený(), neskrývajVstupnýRiadok(), skrývajVstupnýRiadok(), skrývajVstupnýRiadok(boolean), aktivujVstupnýRiadok(), začniVstup(), vstupnýRiadok(), panelVstupnéhoRiadka(), prevezmiReťazec(), históriaVstupnéhoRiadka()

neskryvajVstupnyRiadok

public static boolean neskryvajVstupnyRiadok(boolean začniVstup)

Alias pre neskrývajVstupnýRiadok.

skrývajVstupnýRiadok
```
public static void skrývajVstupnýRiadok()
```
Umožní vstupnému riadku, aby sa skryl po potvrdení klávesom Enter alebo po zrušení vstupu klávesom Escape. Toto je predvolené správanie vstupného riadka.

Pozri tiež:

vstupnýRiadokZobrazený(), neskrývajVstupnýRiadok(), neskrývajVstupnýRiadok(boolean), skrývajVstupnýRiadok(boolean), aktivujVstupnýRiadok(), začniVstup(), vstupnýRiadok(), panelVstupnéhoRiadka(), prevezmiReťazec(), históriaVstupnéhoRiadka()

skryvajVstupnyRiadok
```
public static void skryvajVstupnyRiadok()
```
Alias pre skrývajVstupnýRiadok.

skrývajVstupnýRiadok
```
public static void skrývajVstupnýRiadok(boolean zrušVstup)
```
Umožní vstupnému riadku, aby sa skryl po potvrdení klávesom Enter alebo po zrušení vstupu klávesom Escape. Toto je predvolené správanie vstupného riadka. Táto metóda je alternatívou metódy skrývajVstupnýRiadok, pričom poskytuje rozšírenú funkcionalitu opísanú nižšie…

Parametre:

zrušVstup – ak je true, vykoná sa zároveň metóda zrušVstup; ak je false, vstupný riadok zostane v pôvodnom stave

Pozri tiež:

vstupnýRiadokZobrazený(), neskrývajVstupnýRiadok(), neskrývajVstupnýRiadok(boolean), skrývajVstupnýRiadok(), aktivujVstupnýRiadok(), začniVstup(), vstupnýRiadok(), panelVstupnéhoRiadka(), prevezmiReťazec(), históriaVstupnéhoRiadka()

skryvajVstupnyRiadok

public static void skryvajVstupnyRiadok(boolean zrušVstup)

Alias pre skrývajVstupnýRiadok.

aktivujVstupnýRiadok
```
public static void aktivujVstupnýRiadok()
```
V prípade, že vstupný riadok je stále viditeľný, môžeme do neho touto metódou presmerovať vstup – v riadku sa aktivuje blikajúci kurzor.

Pozri tiež:

vstupnýRiadokZobrazený(), neskrývajVstupnýRiadok(), neskrývajVstupnýRiadok(boolean), skrývajVstupnýRiadok(), skrývajVstupnýRiadok(boolean), začniVstup(), vstupnýRiadok(), panelVstupnéhoRiadka(), prevezmiReťazec(), históriaVstupnéhoRiadka()

aktivujVstupnyRiadok
```
public static void aktivujVstupnyRiadok()
```
Alias pre aktivujVstupnýRiadok.

vstupnýRiadok
```
public static JTextField vstupnýRiadok()
```
Vráti komponent vstupného riadka, aby s ním mohlo byť manipulované na nižšej úrovni (úrovni bližšej k systému).

Tento komponent je hlavným, ale nie jediným komponentom panela vstupného riadka. Okrem neho sa v ňom nachádza aj prvok popisu, ku ktorému nie je sprostredkovaný priamy prístup – dá sa len nastavovať a čítať text popisu. Ak chcete vstupný riadok zobrazovať alebo skrývať bez ovplyvnenia jeho ďalších vlastností, tak treba meniť viditeľnosť panela, nie viditeľnosť tohto komponentu. Tento komponent je vhodný najmä na jemnejšie ovplyvňovanie textového obsahu vstupného riadka.

Návratová hodnota:

objekt typu JTextField reprezentujúci vstupný riadok

Pozri tiež:

panelVstupnéhoRiadka(), popisVstupnéhoRiadka(), popisVstupnéhoRiadka(String), textVstupnéhoRiadka(), textVstupnéhoRiadka(String), pripojTextVstupnéhoRiadka(String), začniVstup(), vstupnýRiadokZobrazený(), prevezmiReťazec(), históriaVstupnéhoRiadka()

vstupnyRiadok

public static JTextField vstupnyRiadok()

Alias pre vstupnýRiadok.

panelVstupnéhoRiadka
```
public static JMenuBar panelVstupnéhoRiadka()
```
Vráti komponent panela vstupného riadka, aby s ním mohlo byť manipulované na nižšej úrovni (úrovni bližšej k systému).

Panel obsahuje popis a textové pole – samotný vstupný riadok. K popisu nie je sprostredkovaný priamy prístup – dá sa len nastavovať a čítať jeho text. K textovému poľu je prístup sprostredkovaný metódou vstupnýRiadok. Tá je vhodná najmä na jemnejšie ovplyvňovanie textového obsahu vstupného riadka. Ale ak chcete napríklad ovplyvňovať viditeľnosť vstupného riadka, tak treba meniť viditeľnosť práve tohto panela, nie viditeľnosť samotného textového poľa riadka.

Návratová hodnota:

objekt typu JMenuBar reprezentujúci panel vstupného riadka

Pozri tiež:

vstupnýRiadok(), popisVstupnéhoRiadka(), popisVstupnéhoRiadka(String), textVstupnéhoRiadka(), textVstupnéhoRiadka(String), pripojTextVstupnéhoRiadka(String), začniVstup(), vstupnýRiadokZobrazený(), prevezmiReťazec(), históriaVstupnéhoRiadka()

panelVstupnehoRiadka

public static JMenuBar panelVstupnehoRiadka()

Alias pre panelVstupnéhoRiadka.

popisVstupnéhoRiadka
```
public static String popisVstupnéhoRiadka()
```
Získa text popisu vstupného riadka. Ak je popis vstupného riadka skrytý, metóda vráti hodnotu null.

Návratová hodnota:

aktuálny text popisu vstupného riadka alebo null

Pozri tiež:

vstupnýRiadok(), panelVstupnéhoRiadka(), popisVstupnéhoRiadka(String), textVstupnéhoRiadka(), textVstupnéhoRiadka(String), pripojTextVstupnéhoRiadka(String), začniVstup(), vstupnýRiadokZobrazený(), prevezmiReťazec(), históriaVstupnéhoRiadka()

popisVstupnehoRiadka
```
public static String popisVstupnehoRiadka()
```
Alias pre popisVstupnéhoRiadka.

popisVstupnéhoRiadka
```
public static void popisVstupnéhoRiadka(String výzva)
```
Nastaví text popisu vstupného riadka. Ak bola na zobrazenie vstupného riadka použitá metóda bez určenia výzvy (začniVstup()), popis bude po volaní tejto metódy zobrazený. Ak je táto metóda volaná s argumentom null, popis bude skrytý.

Parametre:

výzva – nový text popisu vstupného riadka

Pozri tiež:

vstupnýRiadok(), panelVstupnéhoRiadka(), popisVstupnéhoRiadka(), textVstupnéhoRiadka(), textVstupnéhoRiadka(String), pripojTextVstupnéhoRiadka(String), začniVstup(), vstupnýRiadokZobrazený(), prevezmiReťazec(), históriaVstupnéhoRiadka()

popisVstupnehoRiadka

public static void popisVstupnehoRiadka(String výzva)

Alias pre popisVstupnéhoRiadka.

textVstupnéhoRiadka
```
public static String textVstupnéhoRiadka()
```
Získa text aktuálne zadaný do vstupného riadka. Touto metódou je možné overiť obsah vstupného riadka ešte pred jeho potvrdením klávesom Enter.

Návratová hodnota:

aktuálny text vstupného riadka

Pozri tiež:

vstupnýRiadok(), panelVstupnéhoRiadka(), popisVstupnéhoRiadka(), popisVstupnéhoRiadka(String), textVstupnéhoRiadka(String), pripojTextVstupnéhoRiadka(String), začniVstup(), vstupnýRiadokZobrazený(), prevezmiReťazec(), históriaVstupnéhoRiadka()

textVstupnehoRiadka
```
public static String textVstupnehoRiadka()
```
Alias pre textVstupnéhoRiadka.

textVstupnéhoRiadka
```
public static void textVstupnéhoRiadka(String text)
```
Nastaví text vstupného riadka na zadanú hodnotu. Pozor, metóda začniVstup() vždy pred zobrazením panela so vstupným riadkom vyčistí vstupný riadok (vymaže jeho obsah).

Parametre:

text – nový text vstupného riadka

Pozri tiež:

vstupnýRiadok(), panelVstupnéhoRiadka(), popisVstupnéhoRiadka(), popisVstupnéhoRiadka(String), textVstupnéhoRiadka(), pripojTextVstupnéhoRiadka(String), začniVstup(), vstupnýRiadokZobrazený(), prevezmiReťazec(), históriaVstupnéhoRiadka()

textVstupnehoRiadka

public static void textVstupnehoRiadka(String text)

Alias pre textVstupnéhoRiadka.

pripojTextVstupnéhoRiadka
```
public static void pripojTextVstupnéhoRiadka(String naPripojenie)
```
Pripojí zadaný text na koniec vstupného riadka. Volanie metódy má význam len keď je vstupný riadok zobrazený.

Parametre:

naPripojenie – text na pripojenie

Pozri tiež:

vstupnýRiadok(), panelVstupnéhoRiadka(), popisVstupnéhoRiadka(), popisVstupnéhoRiadka(String), textVstupnéhoRiadka(), textVstupnéhoRiadka(String), začniVstup(), vstupnýRiadokZobrazený(), prevezmiReťazec()

pripojTextVstupnehoRiadka

public static void pripojTextVstupnehoRiadka(String naPripojenie)

Alias pre pripojTextVstupnéhoRiadka.

históriaVstupnéhoRiadka
```
public static Zoznam<String> históriaVstupnéhoRiadka()
```
Vráti zoznam reťazcov histórie vstupného riadka. Na to, aby sa zoznam automaticky plnil (počas činnosti aplikácie), musí byť história aktívna. Vrátený zoznam je autentický. Môžete ho upravovať podľa vlastných potrieb (to jest jeho vymazanie skutočne spôsobí vymazanie histórie a podobne). Históriu je tiež možné nechať automaticky uchovať v konfiguračnom súbore, avšak musí byť aktívna aj samotná konfigurácia.

Poznámky: Najnovšie položky sú v zozname histórie umiestnené na konci. Správa histórie vstupného riadka automaticky maže staré duplikáty každého potvrdeného riadka. To znamená, že ak by história obsahovala riadky: x, x, y, y, x, y, z a používateľ by potvrdil riadok x, tak by sa história zmenila na: y, y, y, z, x. Po ďalšom potvrdení y by v histórii zostalo: z, x, y. Najjednoduchší spôsob overenia umožňuje príklad nižšie.

Príklad:

Tento príklad umožňuje overenie informácií uvedených v poznámkach vyššie.
```
import knižnica.*;
import static knižnica.Svet.*;

public class OverHistóriu extends GRobot
{
    private final static Zoznam<String> história = históriaVstupnéhoRiadka();

    private OverHistóriu()
    {
        začniVstup();
        neskrývajVstupnýRiadok();
        história.pridaj("x");
        história.pridaj("x");
        história.pridaj("y");
        história.pridaj("y");
        história.pridaj("x");
        história.pridaj("y");
        história.pridaj("z");
        vypíšHistóriu();
    }

    private void vypíšHistóriu()
    {
        vymažTexty();
        vypíš(história);
    }

    @Override public void potvrdenieVstupu()
    {
        vypíšHistóriu();
    }

    public static void main(String[] args)
    {
        aktivujHistóriuVstupnéhoRiadka();
        new OverHistóriu();
        zbaľ(); vystreď();
    }
}
```
Návratová hodnota:

zoznam reťazcov (história vstupného riadka)

Pozri tiež:

začniVstup(), aktívnaHistóriaVstupnéhoRiadka(), aktivujHistóriuVstupnéhoRiadka(), deaktivujHistóriuVstupnéhoRiadka(), uchovávaSaHistóriaVstupnéhoRiadka(), uchovajHistóriuVstupnéhoRiadka(), neuchovajHistóriuVstupnéhoRiadka()

historiaVstupnehoRiadka

public static Zoznam<String> historiaVstupnehoRiadka()

Alias pre históriaVstupnéhoRiadka.

aktívnaHistóriaVstupnéhoRiadka
```
public static boolean aktívnaHistóriaVstupnéhoRiadka()
```
Zistí, či je automatické uchovávanie potvrdených vstupných riadkov aktívne. Tento stav vypovedá len o tom, či budú potvrdené vstupné riadky uchovávané počas aktuálnej činnosti aplikácie. Na to, aby boli tieto údaje dostupné aj pri ďalšom spustení aplikácie, musí byť aktivované uchovávanie histórie v konfiguračnom súbore a musí byť aktívna aj samotná konfigurácia.

Návratová hodnota:

stav aktivovania automatického uchovávania histórie vstupného riadka počas činnosti aplikácie

Pozri tiež:

začniVstup(), históriaVstupnéhoRiadka(), aktivujHistóriuVstupnéhoRiadka(), deaktivujHistóriuVstupnéhoRiadka(), uchovávaSaHistóriaVstupnéhoRiadka(), uchovajHistóriuVstupnéhoRiadka(), neuchovajHistóriuVstupnéhoRiadka()

aktivnaHistoriaVstupnehoRiadka
```
public static boolean aktivnaHistoriaVstupnehoRiadka()
```
Alias pre aktívnaHistóriaVstupnéhoRiadka.

aktivujHistóriuVstupnéhoRiadka
```
public static void aktivujHistóriuVstupnéhoRiadka()
```
Aktivuje automatické uchovávanie potvrdených vstupných riadkov. Ak je navyše aktivované uchovávanie histórie v konfiguračnom súbore (pričom konfigurácia musí byť tiež aktívna), tak budú uchované potvrdené riadky dostupné aj pri ďalšom spustení aplikácie.

Pozri tiež:

začniVstup(), históriaVstupnéhoRiadka(), aktívnaHistóriaVstupnéhoRiadka(), deaktivujHistóriuVstupnéhoRiadka(), uchovávaSaHistóriaVstupnéhoRiadka(), uchovajHistóriuVstupnéhoRiadka(), neuchovajHistóriuVstupnéhoRiadka()

aktivujHistoriuVstupnehoRiadka
```
public static void aktivujHistoriuVstupnehoRiadka()
```
Alias pre aktivujHistóriuVstupnéhoRiadka.

deaktivujHistóriuVstupnéhoRiadka
```
public static void deaktivujHistóriuVstupnéhoRiadka()
```
Deaktivuje automatické uchovávanie potvrdených vstupných riadkov počas činnosti aplikácie.

Pozri tiež:

začniVstup(), históriaVstupnéhoRiadka(), aktívnaHistóriaVstupnéhoRiadka(), aktivujHistóriuVstupnéhoRiadka(), uchovávaSaHistóriaVstupnéhoRiadka(), uchovajHistóriuVstupnéhoRiadka(), neuchovajHistóriuVstupnéhoRiadka()

deaktivujHistoriuVstupnehoRiadka
```
public static void deaktivujHistoriuVstupnehoRiadka()
```
Alias pre deaktivujHistóriuVstupnéhoRiadka.

uchovávaSaHistóriaVstupnéhoRiadka
```
public static boolean uchovávaSaHistóriaVstupnéhoRiadka()
```
Zistí, či je aktívne automatické uchovanie histórie potvrdených vstupných riadkov do konfiguračného súboru. Na to, aby táto vlastnosť fungovala, musí byť aktívna aj samotná konfigurácia a na to, aby sa história riadkov automaticky plnila, musí byť aktívne automatické uchovávanie histórie počas činnosti aplikácie.

Návratová hodnota:

stav aktivovania automatického uchovávania histórie vstupného riadka do konfiguračného súboru

Pozri tiež:

začniVstup(), históriaVstupnéhoRiadka(), aktívnaHistóriaVstupnéhoRiadka(), aktivujHistóriuVstupnéhoRiadka(), deaktivujHistóriuVstupnéhoRiadka(), uchovajHistóriuVstupnéhoRiadka(), neuchovajHistóriuVstupnéhoRiadka()

uchovavaSaHistoriaVstupnehoRiadka
```
public static boolean uchovavaSaHistoriaVstupnehoRiadka()
```
Alias pre uchovávaSaHistóriaVstupnéhoRiadka.

uchovajHistóriuVstupnéhoRiadka
```
public static void uchovajHistóriuVstupnéhoRiadka()
```
Aktivuje automatické uchovávanie potvrdených vstupných riadkov do konfiguračného súboru. Na to, aby táto vlastnosť fungovala, musí byť aktívna aj samotná konfigurácia a na to, aby sa história riadkov automaticky plnila, musí byť aktívne automatické uchovávanie histórie počas činnosti aplikácie.

Pozri tiež:

začniVstup(), históriaVstupnéhoRiadka(), aktívnaHistóriaVstupnéhoRiadka(), aktivujHistóriuVstupnéhoRiadka(), deaktivujHistóriuVstupnéhoRiadka(), uchovávaSaHistóriaVstupnéhoRiadka(), neuchovajHistóriuVstupnéhoRiadka()

uchovajHistoriuVstupnehoRiadka
```
public static void uchovajHistoriuVstupnehoRiadka()
```
Alias pre uchovajHistóriuVstupnéhoRiadka.

neuchovajHistóriuVstupnéhoRiadka
```
public static void neuchovajHistóriuVstupnéhoRiadka()
```
Deaktivuje automatické uchovávanie histórie vstupných riadkov do konfiguračného súboru.

Pozri tiež:

začniVstup(), históriaVstupnéhoRiadka(), aktívnaHistóriaVstupnéhoRiadka(), aktivujHistóriuVstupnéhoRiadka(), deaktivujHistóriuVstupnéhoRiadka(), uchovávaSaHistóriaVstupnéhoRiadka(), uchovajHistóriuVstupnéhoRiadka()

neuchovajHistoriuVstupnehoRiadka
```
public static void neuchovajHistoriuVstupnehoRiadka()
```
Alias pre neuchovajHistóriuVstupnéhoRiadka.

prevezmiReťazec
```
public static String prevezmiReťazec()
```
Vráti reťazec zadaný do vstupného riadka po potvrdení klávesom Enter. Vstup pomocou vstupného riadka sa zahajuje metódou začniVstup.

Návratová hodnota:

objekt typu String obsahujúci text zadaný používateľom

Pozri tiež:

prevezmiZrušenéÚdaje(), prevezmiCeléČíslo(), prevezmiReálneČíslo(), začniVstup(), vstupnýRiadokZobrazený(), vstupnýRiadok()

prevezmiRetazec

public static String prevezmiRetazec()

Alias pre prevezmiReťazec.

prevezmiZrušenéÚdaje
```
public static String prevezmiZrušenéÚdaje()
```
Vráti reťazec, ktorý obsahoval vstupný riadok tesne pred zrušením klávesom Escape.

Návratová hodnota:

objekt typu String obsahujúci text vstupného riadka pred zrušením

Pozri tiež:

prevezmiReťazec(), prevezmiCeléČíslo(), prevezmiReálneČíslo(), začniVstup(), vstupnýRiadokZobrazený(), vstupnýRiadok()

prevezmiZruseneUdaje
```
public static String prevezmiZruseneUdaje()
```
Alias pre prevezmiZrušenéÚdaje.

prevezmiCeléČíslo
```
public static Long prevezmiCeléČíslo()
```
Vráti celé číslo zadané do vstupného riadka po potvrdení klávesom Enter. Metóda vráti hodnotu null v prípade, že do vstupného riadka nebolo zadané celé číslo. Vstup pomocou vstupného riadka sa zahajuje metódou začniVstup.

Návratová hodnota:

objekt typu Long obsahujúci zadané celé číslo, alebo null v prípade chyby

Pozri tiež:

prevezmiReťazec(), prevezmiReálneČíslo(), začniVstup(), vstupnýRiadokZobrazený(), vstupnýRiadok(), formát

prevezmiCeleCislo
```
public static Long prevezmiCeleCislo()
```
Alias pre prevezmiCeléČíslo.

prevezmiReálneČíslo
```
public static Double prevezmiReálneČíslo()
```
Vráti reálne číslo zadané do vstupného riadka po potvrdení klávesom Enter. Metóda vráti hodnotu null v prípade, že do vstupného riadka nebolo zadané reálne číslo. Vstup pomocou vstupného riadka sa zahajuje metódou začniVstup.

Návratová hodnota:

objekt typu Double obsahujúci zadané reálne číslo alebo null v prípade chyby

Pozri tiež:

prevezmiReťazec(), prevezmiCeléČíslo(), začniVstup(), vstupnýRiadokZobrazený(), vstupnýRiadok(), formát

prevezmiRealneCislo
```
public static Double prevezmiRealneCislo()
```
Alias pre prevezmiReálneČíslo.

reťazecNaCeléČíslo
```
public static Long reťazecNaCeléČíslo(String reťazec)
```
Pokúsi sa previesť zadaný reťazec na celé číslo. V prípade chyby pri prevode vráti metóda hodnotu null.

Parametre:

reťazec – reťazec s údajom na prevedenie

Návratová hodnota:

objekt typu Long obsahujúci prevedené celé číslo, alebo null v prípade chyby

Pozri tiež:

reťazecNaReálneČíslo(String), formát

retazecNaCeleCislo

public static Long retazecNaCeleCislo(String reťazec)

Alias pre reťazecNaCeléČíslo.

reťazecNaReálneČíslo
```
public static Double reťazecNaReálneČíslo(String reťazec)
```
Pokúsi sa previesť zadaný reťazec na reálne číslo. V prípade chyby pri prevode vráti metóda hodnotu null.

Parametre:

reťazec – reťazec s údajom na prevedenie

Návratová hodnota:

objekt typu Double obsahujúci prevedené reálne číslo alebo null v prípade chyby

Pozri tiež:

reťazecNaCeléČíslo(String), formát

retazecNaRealneCislo

public static Double retazecNaRealneCislo(String reťazec)

Alias pre reťazecNaReálneČíslo.

celéNaRímske
```
public static String celéNaRímske(long celé)
```
Prevedie zadané celé číslo na reťazec s rímskou reprezentáciou celých čísiel. Metóda umožňuje vykonať reverzný proces k metóde rímskeNaCelé, pričom výsledok nijako neoptimalizuje (v zmysle, že jej cieľom nie je dosiahnuť čo najkratšiu reprezentáciu celočíselnej hodnoty). Naopak, prevod je značne priamočiary s použitím vnútornej zotriedenej tabuľky obsahujúcej predpísané hodnoty použité pri prevode ako napríklad: M (1000), CM (900), D (500), CD (400) atď. Použité sú len veľké písmená.

Nulu reprezentuje predvolene písmeno N, skoršie to bolo písmeno O. Tento reťazec sa dá konfigurovať metódou rímskaNula. Viac o rímskej nule je napísané v opisoch metód rímskeNaCelé a rímskaNula.

Záporné hodnoty sú vyjadrené uvedením Unicode znaku mínus (−) na začiatku prevedeného reťazca. Hodnoty vyššie od tisíc (písmeno M) sú reprezentované s použitím Unicode kombinačných znakov, ktoré však 2D stroj Javy nevie korektne zobraziť – viac o tomto probléme je napísané v opise metódy rímskeNaCelé.

Parametre:

celé – celé číslo určené na prevod

Návratová hodnota:

rímska reprezentácia hodnoty

Pozri tiež:

rímskeNaCelé(String)

celeNaRimske

public static String celeNaRimske(long celé)

Alias pre celéNaRímske.

rímskaNula
```
public static String rímskaNula()
```
Vráti aktuálny reťazec nuly používaný pri prevode z celých čísiel na rímske.

Rimania nulu nepoužívali, ale neskôr sa začali vyskytovať zápisy nuly, napríklad slovom nulla, prípadne nihil, alebo písmenom N. Pri prevode z rímskych čísel sú rozpoznávané štyri znaky ako nula: N, n, O a o. Je to z dôvodu spätnej kompatibility. Táto vlastnosť (a metóda) sa vzťahuje na reťazec, ktorý je použitý pri prevode nuly metódou celéNaRímske.

Ďalšie zdroje:

Viljanen, Susanna. (2021). Answer to What’s zero in the Roman numerical system? From: Quora. Dostupné z: ⟨https://qr.ae/pymPgP⟩. Naposledy pristúpené: 15. 8. 2023.

Why Roman numerals don’t have the number zero? From: Expert Maths Tutoring in the UK – Boost Your Scores with Cuemath. Dostupné z: ⟨https://www.cuemath.com/questions/why-roman-numerals-dont-have-number-zero/⟩. Naposledy pristúpené: 15. 8. 2023.

Zero in Roman numerals. (2023). In Wikipedia. Dostupné z: ⟨https://en.wikipedia.org/wiki/Roman_numerals#Zero⟩. Naposledy pristúpené: 15. 8. 2023.

Návratová hodnota:

aktuálny reťazec reprezentujúci nulu pri prevode z celých čísiel na rímske.

Pozri tiež:

rímskaNula(String), celéNaRímske(long), rímskeNaCelé(String)

rimskaNula
```
public static String rimskaNula()
```
Alias pre rímskaNula.

rímskaNula
```
public static void rímskaNula(String rímskaNula)
```
Nastaví hodnotu reťazca nuly používaného pri prevode z celých čísiel na rímske.

Rimania nulu nepoužívali, ale neskôr sa začali vyskytovať zápisy nuly, napríklad slovom nulla, prípadne nihil, alebo písmenom N. Pri prevode z rímskych čísel sú rozpoznávané štyri znaky ako nula: N, n, O a o. Je to z dôvodu spätnej kompatibility. Táto vlastnosť (a metóda) sa vzťahuje na reťazec, ktorý je použitý pri prevode nuly metódou celéNaRímske.

Ďalšie zdroje:

Viljanen, Susanna. (2021). Answer to What’s zero in the Roman numerical system? From: Quora. Dostupné z: ⟨https://qr.ae/pymPgP⟩. Naposledy pristúpené: 15. 8. 2023.

Why Roman numerals don’t have the number zero? From: Expert Maths Tutoring in the UK – Boost Your Scores with Cuemath. Dostupné z: ⟨https://www.cuemath.com/questions/why-roman-numerals-dont-have-number-zero/⟩. Naposledy pristúpené: 15. 8. 2023.

Zero in Roman numerals. (2023). In Wikipedia. Dostupné z: ⟨https://en.wikipedia.org/wiki/Roman_numerals#Zero⟩. Naposledy pristúpené: 15. 8. 2023.

Parametre:

rímskaNula – nový reťazec, ktorý bude reprezentovať nulu pri prevode z celých čísiel na rímske.

Pozri tiež:

rímskaNula(), celéNaRímske(long), rímskeNaCelé(String)

rimskaNula

public static void rimskaNula(String rímskaNula)

Alias pre rímskaNula.

rímskeNaCelé
```
public static Long rímskeNaCelé(String rímske)
```
Prevedie zadaný reťazec obsahujúci číslo reprezentované v rímskej číselnej sústave na celé číslo.

Metóda je značne liberálna. Znak mínus na začiatku reťazca spôsobí, že analyzované číslo bude prevedené na záporné, písmená O a N sú považované za nulu (malé aj veľké)^[1] a metóda rozpoznáva aj dva Unicode modifikátory, ktoré násobia hodnotu rímskeho znaku tisícom alebo miliónom. Ide o kombinačné znaky jednoduchej a dvojitej čiary nad predchádzajúcim znakom: ̅, ̿. Jednoduchá čiara násobí hodnotu predchádzajúceho písmena tisícom a dvojitá miliónom. Nevýhodou týchto špeciálnych znakov je to, že vnútorná konzola plátien a pečiatkové texty programovacieho rámca ich nevedia korektne zobraziť z dôvodu predvoleného spôsobu vykresľovania textov 2D strojom jazyka Java a tiež to, že v niektorých softvéroch sú tieto znaky zobrazované nad nasledujúcim znakom namiesto predchádzajúceho. Ak sú však v zadanom reťazci prítomné, tak ich táto metóda berie do úvahy a priraďuje ich vždy k predchádzajúcemu symbolu.

[1] – Do 14. 8. 2023 to bolo len písmeno O, ale autor rámca zistil, že Rimania v skutočnosti nulu nepoužívali vôbec a neskôr sa používalo písmeno N, čo mohlo znamenať nulla (nula) alebo nihil (nič). Z dôvodu spätnej kompatibility (a tiež z dôvodu jeho výskytu v niektorých menej informovaných zdrojoch) bolo ponechané aj písmeno O.

Platné rímske číslice sú malé alebo veľké písmená: I (1), V (5), X (10), L (50), C (100), D (500) a M (1000). Ak je séria znakov s nižšou hodnotou uvedená pred znakom s vyššou hodnotou, tak je súčet hodnôt znakov s nižšou hodnotou od výsledku odrátaný a hodnota znaku s vyššou je okamžite spracovaná tak, že je k výsledku prirátaná bez ohľadu na to, či za ňou nasledujú ďalšie znaky s rovnakou hodnotou alebo znak s ešte vyššou hodnotou. To znamená, že napríklad reťazec IIIVVX má hodnotu 7 (čiže je oddelene spracovaná séria IIIV = 2 a VX = 5), pričom samostatný reťazec VVX má hodnotu 0.

Parametre:

rímske – rímska reprezentácia celého čísla

Návratová hodnota:

prevedená hodnota alebo null, ak prevod zlyhal

Pozri tiež:

celéNaRímske(long)

rimskeNaCele

public static long rimskeNaCele(String reťazec)

Alias pre rímskeNaCelé.

jePrvočíslo

public static boolean jePrvočíslo(long číslo)

Overí, či zadané číslo je prvočíslo.

Metóda berie do úvahy aj záporné čísla. Tie si vnútorne prevedie na kladné, pretože záporné čísla sú považované za združené (angl. associates) a v tomto zmysle je prvočíslom každé záporné číslo, ktorého kladný „súrodenec“ je prvočíslom [1, 2, 3].

Poznámka: Vnútorný mechanizmus sveta zabezpečuje dynamické vyhľadávanie potrebného množstva (kladných) prvočísiel podľa najvyššieho naposledy overeného čísla. Nájdené prvočísla vnútorne uchováva a používa na overovanie ostatných zadávaných čísiel.

[1]	Can negative numbers be prime? PrimePages. Citované: 16. 12. 2020.
[2]	Gud, Git (asker) – Tanner, J. W. (answerer), et al. Do we have negative prime numbers? Mathematics Stack Exchange. 2014. Citované: 16. 12. 2020.
[3]	Jagielski, Matthew – Cheng, Yuanyou F a.k.a. Fred) (answerers). Can negative numbers be prime? Quora. 2013, 2016. Citované: 16. 12. 2020.

Parametre:: číslo – celé číslo, ktorého prvočíselnosť chceme overiť
Návratová hodnota:: true ak je zadané číslo prvočíslo; false v opačnom prípade
Pozri tiež:: dajPrvočíslo(int), rozložNaPrvočísla(long)

jePrvocislo

public static boolean jePrvocislo(long číslo)

Alias pre jePrvočíslo.

dajPrvočíslo
```
public static long dajPrvočíslo(int n)
```
Vráti n-té prvočíslo. Metóda vráti kladné alebo záporné prvočíslo podľa zadaného poradového čísla v rámci parametra n. Ak je zadaná nula, metóda vráti nulu, čo je nezmysel, ale aspoň sa vďaka tomu dá prejsť celá (dostupná) celočíselná os bez vzniku výnimy.

Príklad:
```
for (int i = 1; i <= 10; ++i)
    System.out.print(i + ": " + Svet.dajPrvočíslo(i) + "; ");
System.out.println();
```
Výsledok:
1: 2; 2: 3; 3: 5; 4: 7; 5: 11; 6: 13; 7: 17; 8: 19; 9: 23; 10: 29;
Parametre:

n – poradové číslo – určuje, ktoré prvočíslo v poradí má byť vrátené

Návratová hodnota:

n-té prvočíslo s jedinou výnimkou – ak je zadaná nula, metóda nevráti prvočíslo, ale nulu – dôvod je ozrejmený vyššie v opise

Pozri tiež:

jePrvočíslo(long), rozložNaPrvočísla(long)

dajPrvocislo

public static long dajPrvocislo(int n)

Alias pre dajPrvočíslo.

rozložNaPrvočísla
```
public static long[] rozložNaPrvočísla(long číslo)
```
Rozloží zadané celé číslo na prvočísla, ak je to možné. Ak rozklad nie je možný, tak metóda vráti prázdne pole (pole s nulovou dĺžkou). V podstate rozklad nie je možný len pre tie celé čísla, ktoré nie sú prvočíslami: ⟨−1; 1⟩. Ak je zadané číslo záporné, tak metóda vráti rovnaký rozklad ako pre kladné združené číslo, len prvý prvok prevedie na zápornú hodnotu.

Parametre:

číslo – celé číslo, ktoré chceme rozložiť na prvočísla

Návratová hodnota:

pole prvočísiel alebo prázdne pole

Pozri tiež:

jePrvočíslo(long), dajPrvočíslo(int)

rozlozNaPrvocisla

public static long[] rozlozNaPrvocisla(long číslo)

Alias pre rozložNaPrvočísla.

číselnýKoreň
```
public static long číselnýKoreň(long číslo)
```
Vypočíta číselný koreň (digital root; alebo opakovaný digitálny súčet) absolútnej hodnoty zadaného čísla v desiatkovej číselnej sústave.

Ćíselný koreň čísla 13 (v desiatkovej číselnej sústave) je 4, lebo 1 + 3 je 4. Číselný koreň čísla 29 je 2, lebo 2 + 9 je 11 a 1 + 1 je 2.

Parametre:

číslo – číslo, ktorého koreň má byť vypočítaný

Návratová hodnota:

číselný koreň zadaného čísla vypočítaný podľa zadaného koreňa číselnej sústavy

Pozri tiež:

číselnýKoreň(long, long)

ciselnyKoren

public static long ciselnyKoren(long číslo)

Alias pre číselnýKoreň.

číselnýKoreň
```
public static long číselnýKoreň(long číslo,
                                long základ)
```
Vypočíta číselný koreň (digital root; alebo opakovaný digitálny súčet) absolútnej hodnoty zadaného čísla podľa zadaného číselného základu.

Parametre:

číslo – číslo, ktorého koreň má byť vypočítaný

základ – číselný základ (číselnej sústavy, v ktorej je číslo vyjadrené)

Návratová hodnota:

číselný koreň zadaného čísla vypočítaný podľa zadaného koreňa číselnej sústavy

Pozri tiež:

číselnýKoreň(long)

ciselnyKoren

public static long ciselnyKoren(long číslo,
                                long základ)

Alias pre číselnýKoreň.

pomerHviezdy
```
public static double pomerHviezdy(int p)
```
Vypočíta pomer polomerov kružníc, ktoré prechádzajú vnútornými a vonkajšími bodmi pravidelnej polygónovej hviezdy. Hviezda má mať p cípov a polygón má prechádzať každým druhým bodom cípu ležiaceho na vonkajšej kružnici.

(Pozri aj: pomerHviezdy(int p, int q))

Parametre:

p – počet cípov hviezdy

Návratová hodnota:

pomer polomerov kružníc, ktoré prechádzajú vonkajšími a vnútornými bodmi hviezdy

pomerHviezdy
```
public static double pomerHviezdy(int p,
                                  int q)
```
Vypočíta pomer polomerov kružníc, ktoré prechádzajú vnútornými a vonkajšími bodmi pravidelnej polygónovej hviezdy. Hviezda má mať p cípov a polygón má prechádzať každým q-tym bodom cípu ležiaceho na vonkajšej kružnici. q sa nazýva aj hustota.

(Pomery s hustotou 2 sú ukladané do vyrovnávacej pamäte na opakované použitie. Pomery iných hustôt treba uchovávať externe.)

Zdroje:

Weisstein, Eric W. Star Polygon. From MathWorld – A Wolfram Web Resource. https://mathworld.wolfram.com/StarPolygon.

Wikipedia contributors. (2024, January 3). Star polygon. In Wikipedia, The Free Encyclopedia. Retrieved 11:45, February 29, 2024, from https://en.wikipedia.org/w/index.php?title=Star_polygon&oldid=1193397803.

Parametre:

p – počet cípov hviezdy

q – hustota (o koľko bodov neskôr leží ďalší bod úsečky tvoriacej časti hrán hviezdy)

Návratová hodnota:

pomer polomerov kružníc, ktoré prechádzajú vonkajšími a vnútornými bodmi hviezdy

aktivujŠtandardnýVstup
```
public static boolean aktivujŠtandardnýVstup()
```
Táto metóda vykoná jednorazovú akciu aktivovania štandardného vstupu s predvoleným kódovaním UTF-8. Jej volanie má zmysel len v prípade, že vstup ešte nebol úspešne aktivovaný. (Vstup nesmie byť aktívny, ani ukončený.) Skrytá inštancia prijímajúca údaje zo vstupu funguje asynchrónne v samostatnom vlákne. Pri prijatí údajov volá reakciu spracujRiadokVstupu a z toho vyplýva, že v čase aktivovania štandardného vstupu by mala byť aktívna obsluha udalostí, inak môže nastať strata prijatých údajov, najmä ak je štandardný vstup pripojený k externému prúdu vstupných údajov (napríklad z iného procesu alebo zo súboru). V prípade konečného vstupného prúdu je po dosiahnutí jeho konca spustená reakcia koniecVstupu. Overiť to, či je štandardný vstup (stále) aktívny sa dá pomocou metódy štandardnýVstupAktívny. Určiť iné kódovanie údajov zo štandardného vstupu sa dá volaním inej verzie tejto metódy: aktivujŠtandardnýVstup(kódovanie).

Príklad:
```
import knižnica.*;

public class ŠtandardnýVstupNaVnútornúKonzolu extends GRobot
{
    private ŠtandardnýVstupNaVnútornúKonzolu()
    {
        Svet.aktivujŠtandardnýVstup();
    }

    @Override public void spracujRiadokVstupu(String riadokVstupu)
    {
        Svet.farbaTextu(tmavohnedá);
        Svet.vypíšRiadok(riadokVstupu);
    }

    @Override public void koniecVstupu()
    {
        Svet.farbaTextu(oranžová);
        Svet.vypíšRiadok("koniec");
    }

    public static void main(String[] args)
    {
        Svet.použiKonfiguráciu("ŠtandardnýVstupNaVnútornúKonzolu.cfg");
        new ŠtandardnýVstupNaVnútornúKonzolu();
    }
}
```
Výsledok:

Výsledok. (Ako vidno, nastavenie správneho kódovania môže byť problém – nepodarilo sa to ani po viacerých pokusoch…)
Návratová hodnota:

ak bol štandardný vstup bezchybne aktivovaný, tak táto metóda vráti hodnotu true

Pozri tiež:

aktivujŠtandardnýVstup(String), štandardnýVstupAktívny(), čakajNaVstup(), ObsluhaUdalostí.spracujRiadokVstupu(String), ObsluhaUdalostí.koniecVstupu()

aktivujStandardnyVstup
```
public static boolean aktivujStandardnyVstup()
```
Alias pre aktivujŠtandardnýVstup.

aktivujŠtandardnýVstup
```
public static boolean aktivujŠtandardnýVstup(String kódovanie)
```
Táto metóda vykoná jednorazovú akciu aktivovania štandardného vstupu so zadaným kódovaním. Platia pre ňu rovnaké pravidlá ako pre jej verziu bez parametra: aktivujŠtandardnýVstup().

Parametre:

kódovanie – kódovanie, ktoré má byť použité na dekódovanie údajov prijímaných zo štandardného vstupu

Návratová hodnota:

ak bol štandardný vstup bezchybne aktivovaný, tak táto metóda vráti hodnotu true

Pozri tiež:

aktivujŠtandardnýVstup(), štandardnýVstupAktívny(), čakajNaVstup(), ObsluhaUdalostí.spracujRiadokVstupu(String), ObsluhaUdalostí.koniecVstupu()

aktivujStandardnyVstup

public static boolean aktivujStandardnyVstup(String kódovanie)

Alias pre aktivujŠtandardnýVstup.

štandardnýVstupAktívny
```
public static boolean štandardnýVstupAktívny()
```
Overí, či je štandardný vstup, ktorý bol aktivovaný metódou aktivujŠtandardnýVstup (alebo niektorou jej verziou) stále aktívny.

Návratová hodnota:

ak je štandardný vstup stále aktívny, tak táto metóda vráti hodnotu true

Pozri tiež:

aktivujŠtandardnýVstup(), aktivujŠtandardnýVstup(String), čakajNaVstup()

standardnyVstupAktivny
```
public static boolean standardnyVstupAktivny()
```
Alias pre štandardnýVstupAktívny.

čakajNaVstup

public static String čakajNaVstup()

Táto metóda implementuje mechanizmus blokovania pri čakaní údajov zo štandardného vstupu (v samostatnom vlákne). Ak nie je vstup aktívny, tak ho aktivuje (s použitím predvoleného kódovania UTF-8). Ak už nie je možné prijať žiadne ďalšie údaje (vstupný prúd bol konečný a už sa skončil – napríklad keď prichádzal cez rúru (pipe) operačného systému), tak táto metóda bez ďalšieho čakania vráti hodnotu null.

Príklad:

System.out.print("Zadaj svoje meno: ");
String meno = Svet.čakajNaVstup();
System.out.println("Ahoj, " + meno + "!");

Výsledok:

Zadaj svoje meno: Adam
Ahoj, Adam!

Príklad:

import knižnica.*;

public class ČakanieNaVstup extends GRobot
{
    public static void main(String[] args)
    {
        // Dôležitá poznámka:
        // ------------------
        // 
        // Tento komentár obsahuje Java kód ukazujúci štandardný postup pri
        // čítaní údajov zo štandardného vstupu bez použitia programovacieho
        // rámca GRobot:
        // 
        // try (java.io.BufferedReader čítač = new java.io.BufferedReader(
        // 	new java.io.InputStreamReader(System.in)))
        // {
        // 	String riadokVstupu = čítač.readLine();
        // 	System.out.println("Riadok vstupu: " + riadokVstupu);
        // }
        // catch (java.io.IOException e)
        // {
        // 	e.printStackTrace();
        // }
        // System.out.println("Vstupný prúd bol automaticky zavretý.");
        // 
        // Tento spôsob nie je kompatibilný so spôsobom čítania vstupu
        // programovacím rámcom GRobot. Ak by sme sa pokúsili použiť oboje,
        // vznikla by výnimka.
        // 
        // Nasleduje príklad použitia čítania štandardného vstupu
        // s použitím programovacieho rámca GRobot…
        
        // Počet určíme pomocou reťazca zadaného do prvého argumentu
        // aplikácie, pričom najmenší povolený počet je 1.
        int počet = 1;
        if (args.length > 0)
        {
            Long číslo = Svet.reťazecNaCeléČíslo(args[0]);
            if (null != číslo) počet = číslo.intValue();
        }
        if (počet <= 0) počet = 1;
        System.out.println("(Počet reťazcov: " + počet + ")");

        // Prečítame zo štandardného vstupu určený počet reťazcov.
        for (int i = 1; i <= počet; ++i)
        {
            System.out.print("Zadaj reťazec " + i + ": ");
            String vstup = Svet.čakajNaVstup();
            System.out.println("> " + vstup);
        }

        // Aplikáciu musíme „násilne“ uzavrieť, pretože z dôvodu prítomnosti
        // automaticky vytváraných objektov programovacieho rámca v pamäti,
        // by sa nebola schopná ukončiť spontánne. Fungovala by naďalej
        // na pozadí.
        Svet.koniec(0);
    }
}

Výsledok:

Ak neprijímame vstup zo systémovej rúry (pipe), aplikácia prečíta len jeden riadok:

(Počet reťazcov: 1)
Zadaj reťazec 1: «niečo, čo som zadal a potvrdil na vstupe»
> «niečo, čo som zadal a potvrdil na vstupe»

Ukážka čítania vstupu
v režime príkazového riadka.

Ukážka čítania vstupu v režime príkazového riadka operačného systému Windows.

Návratová hodnota:: reťazec prečítaný zo štandardného vstupu alebo null
Pozri tiež:: aktivujŠtandardnýVstup(), aktivujŠtandardnýVstup(String), štandardnýVstupAktívny(), čakaj(double), čakajNaKláves(), čakajNaKlik(), čakajNaKlikAleboKláves()

cakajNaVstup
```
public static String cakajNaVstup()
```
Alias pre čakajNaVstup.

čakajNaKláves
```
public static KeyEvent čakajNaKláves()
```
Slúži na pozastavenie (blokovanie) programu s cieľom čakania na stlačenie klávesu. Ide o čakanie na zadanie znaku (z toho vyplýva, že napríklad funkčné klávesy nie sú brané do úvahy). Znak je týmto procesom skonzumovaný (a vrátený v návratovej hodnote tejto metódy). To znamená, že prislúchajúce reakcie zadanieZnaku nie sú spustené. Na to, aby bola táto metóda použiteľná, musí byť Svet inicializovaný, inak metóda vráti hodnotu null.

Tip: Návratovou hodnotou je udalosť KeyEvent. Použite jej metódu getKeyChar na získanie stlačeného znaku.

Pozor! Použitie tejto metódy (a jej príbuzných) je kritické! Metóda slúži výhradne na pozastavenie činnosti veľmi jednoduchého (synchrónne vykonávaného) programu, ktorého činnosť je prakticky úplne dokončená v rámci konštruktora hlavnej triedy (t. j. v rámci inicializácie aplikácie). Metóda síce môže slúžiť na pozastavenie inicializácie akejkoľvek aplikácie, ale môže byť použitá výhradne týmto spôsobom! (To jest, počas inicializácie.) Dôvodom je, že metóda musí byť spustená len v hlavnom vlákne aplikácie a nejestvuje prakticky žiadny iný spôsob, ktorým sa toto dá zaručiť, len ten, že metóda bude vykonaná počas inicializácie. Všetky ďalšie aktivity aplikácie sú už totiž realizované prostredníctvom vlákna slúžiaceho na obsluhu udalostí, ktoré vykonanie tejto metódy (a jej príbuzných) zablokuje!

Návratová hodnota:

udalosť klávesnice alebo hodnota null

Pozri tiež:

čakaj(double), čakajNaVstup(), čakajNaKlik(), čakajNaKlikAleboKláves()

cakajNaKlaves

public static KeyEvent cakajNaKlaves()

Alias pre čakajNaKláves.

čakajNaKlik
```
public static MouseEvent čakajNaKlik()
```
Slúži na pozastavenie (blokovanie) programu s cieľom čakania na kliknutie ľubovoľným tlačidlom myši. Udalosť je týmto procesom skonzumovaná (a vrátená v návratovej hodnote tejto metódy). To znamená, že prislúchajúce reakcie klik nie sú spustené. Na to, aby bola táto metóda použiteľná, musí byť Svet inicializovaný, inak metóda vráti hodnotu null.

Tip: Návratovou hodnotou je udalosť MouseEvent. Môžete použiť jej metódy getButton, getX, getY a podobne na získanie podrobností o udalosti.

Pozor! Použitie tejto metódy (a jej príbuzných) je kritické! Metóda slúži výhradne na pozastavenie činnosti veľmi jednoduchého (synchrónne vykonávaného) programu, ktorého činnosť je prakticky úplne dokončená v rámci konštruktora hlavnej triedy (t. j. v rámci inicializácie aplikácie). Metóda síce môže slúžiť na pozastavenie inicializácie akejkoľvek aplikácie, ale môže byť použitá výhradne týmto spôsobom! (To jest, počas inicializácie.) Dôvodom je, že metóda musí byť spustená len v hlavnom vlákne aplikácie a nejestvuje prakticky žiadny iný spôsob, ktorým sa toto dá zaručiť, len ten, že metóda bude vykonaná počas inicializácie. Všetky ďalšie aktivity aplikácie sú už totiž realizované prostredníctvom vlákna slúžiaceho na obsluhu udalostí, ktoré vykonanie tejto metódy (a jej príbuzných) zablokuje!

Návratová hodnota:

udalosť myši alebo hodnota null

Pozri tiež:

čakaj(double), čakajNaVstup(), čakajNaKláves(), čakajNaKlikAleboKláves()

cakajNaKlik

public static MouseEvent cakajNaKlik()

Alias pre čakajNaKlik.

čakajNaKlikAleboKláves
```
public static InputEvent[] čakajNaKlikAleboKláves()
```
Slúži na pozastavenie (blokovanie) programu s cieľom čakania na stlačenie ľubovoľného klávesu alebo kliknutie ľubovoľným tlačidlom myši. Návratovou hodnotou je dvojprvkové pole udalostí všeobecného typu: InputEvent. Prvý prvok je rezervovaný pre udalosť klávesnice (KeyEvent) a druhý pre udalosť myši (MouseEvent). Tá udalosť, ktorá vznikne skôr, je týmto procesom skonzumovaná a vrátená v prislúchajúcom prvku návratovej hodnoty tejto metódy. (To znamená, že prislúchajúce reakcie zadanieZnaku a klik nie sú spustené.) Ten prvok návratovej hodnoty, ktorého udalosť nevznikla, bude nastavený na hodnotu null. Na to, aby bola táto metóda použiteľná, musí byť Svet inicializovaný, inak bude pole návratovej hodnoty obsahovať dve hodnoty null.

Tip: Pozri aj opisy metód čakajNaKláves a čakajNaKlik.

Pozor! Použitie tejto metódy (a jej príbuzných) je kritické! Metóda slúži výhradne na pozastavenie činnosti veľmi jednoduchého (synchrónne vykonávaného) programu, ktorého činnosť je prakticky úplne dokončená v rámci konštruktora hlavnej triedy (t. j. v rámci inicializácie aplikácie). Metóda síce môže slúžiť na pozastavenie inicializácie akejkoľvek aplikácie, ale môže byť použitá výhradne týmto spôsobom! (To jest, počas inicializácie.) Dôvodom je, že metóda musí byť spustená len v hlavnom vlákne aplikácie a nejestvuje prakticky žiadny iný spôsob, ktorým sa toto dá zaručiť, len ten, že metóda bude vykonaná počas inicializácie. Všetky ďalšie aktivity aplikácie sú už totiž realizované prostredníctvom vlákna slúžiaceho na obsluhu udalostí, ktoré vykonanie tejto metódy (a jej príbuzných) zablokuje!

Príklad:

Tento príklad ukazuje možné využitie návratovej hodnoty tejto metódy na získanie podrobností o udalosti, ktorá čakanie ukončila. Aplikácia opakuje príkaz čakania (so zisťovaním a vypisovaním detailov o vzniknutej udalosti), dokedy nie je stlačené ľavé tlačidlo myši (na ploche aplikácie).
```
import knižnica.GRobot;
import knižnica.Svet;

import java.awt.event.InputEvent;
import java.awt.event.KeyEvent;
import java.awt.event.MouseEvent;

public class TestČakania extends GRobot
{
    private KeyEvent kláves;
    private MouseEvent klik;
    private InputEvent[] udalosti;

    private TestČakania()
    {
        Svet.vypíšRiadok("Stlačte ľubovoľný kláves alebo kliknite " +
            "ľubovoľným tlačidlom myši.");
        Svet.vypíšRiadok("(Kliknutie ľavého tlačidla myši " +
            "ukončí aplikáciu.)");

        do
        {
            // Získanie a výpis podrobností o udalosti:

            udalosti = Svet.čakajNaKlikAleboKláves();
            kláves = (KeyEvent)udalosti[0];
            klik = (MouseEvent)udalosti[1];

            if (null != kláves)
                Svet.vypíšRiadok("ASCII (", (int)kláves.getKeyChar(),
                    ")", kláves.getKeyChar());

            if (null != klik)
                Svet.vypíšRiadok(klik.getButton() + ": " +
                    klik.getX() + ", " + klik.getY());
        }
        while (null == klik || 1 != klik.getButton());
    }

    public static void main(String[] args)
    {
        Svet.použiKonfiguráciu("TestČakania.cfg");
        new TestČakania();
        Svet.vypíšRiadok("Koniec.");
        Svet.čakaj(1.5);
        Svet.koniec();
    }
}
```
Výsledné výpisy na obrazovke (konzole programovacieho rámca) môžu vyzerať napríklad takto:
```
Stlačte ľubovoľný kláves alebo kliknite ľubovoľným tlačidlom myši.
(Kliknutie ľavého tlačidla myši ukončí aplikáciu.)
ASCII (116)t
ASCII (101)e
ASCII (115)s
ASCII (116)t
ASCII (10)

ASCII (32) 
ASCII (32) 
3: 364, 275
ASCII (32) 
2: 332, 104
ASCII (32) 
1: 217, 339
Koniec.
```
Návratová hodnota:

dvojprvkové pole vstupných udalostí všeobecného typu (InputEvent; pričom v prvom prvku je očakávaná udalosť klávesnice KeyEvent, ak vznikla, a v druhom udalosť myši MouseEvent – rovnako, ak vznikla)

Pozri tiež:

čakaj(double), čakajNaVstup(), čakajNaKláves(), čakajNaKlik()

cakajNaKlikAleboKlaves
```
public static InputEvent[] cakajNaKlikAleboKlaves()
```
Alias pre čakajNaKlikAleboKláves.

čakajNaKlávesAleboKlik
```
public static InputEvent[] čakajNaKlávesAleboKlik()
```
Alias pre čakajNaKlikAleboKláves.

cakajNaKlavesAleboKlik
```
public static InputEvent[] cakajNaKlavesAleboKlik()
```
Alias pre čakajNaKlikAleboKláves.

režimLadenia
```
public static void režimLadenia(boolean zapniLadenie)
```
Zapne alebo vypne režim ladenia programovacieho rámca GRobot. V režime ladenia sú vypisované rôzne chybové hlásenia na štandardný chybový výstup (systémový terminál) a informácie o vykonávaní príkazov interaktívneho režimu alebo skriptu na vnútornú konzolu programovacieho rámca (na strop). Tiež je pravidelne spúšťaná reakcia obsluhy udalostí ladenie, ak je definovaná obsluha udalostí.

Poznámka: Zapnutie výpisu chybových hlásení na štandardný chybový výstup nemusí byť vždy žiaduce, preto vznikla ďalšia verzia tejto metódy: režimLadenia(zapniLadenie, vypíšChybovéHlásenia).

Parametre:

zapniLadenie – true alebo false

Pozri tiež:

režimLadenia(), lenRežimLadenia(), režimLadenia(boolean, boolean), interaktívnyRežim(boolean), vykonajPríkaz(String), vykonajSkript(String[]), ObsluhaUdalostí.ladenie(int, String, int)

rezimLadenia

public static void rezimLadenia(boolean zapniLadenie)

Alias pre režimLadenia.

režimLadenia
```
public static void režimLadenia(boolean zapniLadenie,
                                boolean vypíšChybovéHlásenia)
```
Zapne alebo vypne režim ladenia programovacieho rámca GRobot so spresnením zapnutia alebo vypnutia výpisu chybových hlásení programovacieho rámca. Vypnutie výpisu chybových hlásení na štandardný chybový výstup (systémový terminál) nevypne výpis informácií o vykonávaní príkazov interaktívneho režimu alebo skriptu na vnútornú konzolu programovacieho rámca (na strop). Toto správanie sa dá ovplyvniť v tele reakcie ladenie (pozri napríklad správy ladenia: VYPÍSAŤ_PRÍKAZ, VYPÍSAŤ_RIADOK alebo VYPÍSAŤ_MENOVKY).

Parametre:

zapniLadenie – true alebo false

vypíšChybovéHlásenia – true alebo false

Pozri tiež:

režimLadenia(), lenRežimLadenia(), režimLadenia(boolean), výpisChybovýchHlásení(), interaktívnyRežim(boolean), vykonajPríkaz(String), vykonajSkript(String[]), ObsluhaUdalostí.ladenie(int, String, int)

rezimLadenia

public static void rezimLadenia(boolean zapniLadenie,
                                boolean vypíšChybovéHlásenia)

Alias pre režimLadenia.

režimLadenia
```
public static boolean režimLadenia()
```
Zistí, či je zapnutý režim ladenia programovacieho rámca GRobot alebo aspoň výpis chybových hlásení programovacieho rámca. (Stačí, ak je aktívna aspoň jedna z vlastností. Pozri: režimLadenia. Táto metóda bola takto navrhnutá z dôvodu kompatibility s jej jednoparametrickou verziou: režimLadenia(zapniLadenie).)

Návratová hodnota:

true alebo false

Pozri tiež:

režimLadenia(boolean), režimLadenia(boolean, boolean)

rezimLadenia
```
public static boolean rezimLadenia()
```
Alias pre režimLadenia.

lenRežimLadenia
```
public static boolean lenRežimLadenia()
```
Zistí, či je zapnutý režim ladenia programovacieho rámca GRobot bez ohľadu na režim výpisu chybových hlásení rámca. (Pozri: režimLadenia.)

Návratová hodnota:

true alebo false

Pozri tiež:

režimLadenia(), režimLadenia(boolean), režimLadenia(boolean, boolean), výpisChybovýchHlásení()

lenRezimLadenia

public static boolean lenRezimLadenia()

Alias pre lenRežimLadenia.

výpisChybovýchHlásení
```
public static boolean výpisChybovýchHlásení()
```
Zistí, či je zapnutý výpis chybových hlásení programovacieho rámca. (Pozri: režimLadenia.)

Návratová hodnota:

true alebo false

Pozri tiež:

režimLadenia(), lenRežimLadenia(), režimLadenia(boolean), režimLadenia(boolean, boolean)

vypisChybovychHlaseni
```
public static boolean vypisChybovychHlaseni()
```
Alias pre výpisChybovýchHlásení.

premennáJestvuje
```
public static boolean premennáJestvuje(String názov,
                                       Class<?> typ)
```
Zistí, či premenná interaktívneho režimu so zadaným názvom a typom jestvuje (je definovaná).

Parametre:

názov – názov premennej

typ – typ premennej – povolené sú: Double.class, Color.class, Poloha.class alebo String.class

Návratová hodnota:

ak premenná zadaného údajového typu jestvuje, tak je návratovou hodnotou tejto metódy hodnota true; ak premenná nejestvuje alebo bol zadaný nepovolený údajový typ premennej, tak je návratovou hodnotou tejto metódy hodnota false

Pozri tiež:

PremennéSkriptu#jestvuje(String, Trieda)

premennaJestvuje

public static boolean premennaJestvuje(String názov,
                                       Class<?> typ)

Alias pre premennáJestvuje.

premennáExistuje

public static boolean premennáExistuje(String názov,
                                       Class<?> typ)

Alias pre premennáJestvuje.

premennaExistuje

public static boolean premennaExistuje(String názov,
                                       Class<?> typ)

Alias pre premennáJestvuje.

čítajPremennú
```
public static Object čítajPremennú(String názov,
                                   Class<?> typ)
```
Zistí hodnotu premennej zadaného údajového typu interaktívneho režimu. (Ak hodnota jestvuje.)

Parametre:

názov – názov premennej

typ – typ premennej – povolené sú: Double.class, Color.class, Poloha.class alebo String.class

Návratová hodnota:

ak premenná jestvuje, tak je návratovou hodnotou tejto metódy hodnota tejto premennej; ak premenná nejestvuje, prípadne bol zadaný nepovolený údajový typ premennej, tak je návratovou hodnotou tejto metódy hodnota null

Pozri tiež:

PremennéSkriptu#čítaj(String, Trieda)

citajPremennu

public static Object citajPremennu(String názov,
                                   Class<?> typ)

Alias pre čítajPremennú.

zapíšPremennú
```
public static boolean zapíšPremennú(String názov,
                                    Object hodnota)
```
Nastaví novú hodnotu premennej interaktívneho režimu. Ak je zadaná hodnota nepovoleného údajového typu, tak nebude nastavená hodnota žiadnej premennej. To isté platí pri pokuse o zapísanie hodnoty null. Úspešnosť (resp. neúspešnosť) nastavenia hodnoty premennej potvrdzuje návratová hodnota tejto metódy – true (úspech) / false (neúspech).

Poznámka: Táto metóda automaticky definuje nejestvujúce premenné.

Parametre:

názov – názov premennej

hodnota – hodnota premennej povoleného údajového typu – povolené sú: Double, Color, Poloha alebo String

Návratová hodnota:

kontrolná návratová hodnota (ide najmä o overenie toho, či zadaná hodnota naozaj bola niektorého povoleného typu); ak je návratová hodnota true, tak bola zadaná hodnota zapísaná do premennej prislúchajúceho údajového typu

Pozri tiež:

PremennéSkriptu#zapíš(String, Object)

zapisPremennu

public static boolean zapisPremennu(String názov,
                                    Object hodnota)

Alias pre zapíšPremennú.

vymažPremennú
```
public static void vymažPremennú(String názov,
                                 Class<?> typ)
```
Vymaže definíciu premennej zadaného údajového typu interaktívneho režimu. (Ak jestvuje.)

Parametre:

názov – názov premennej

typ – typ premennej – povolené sú: Double.class, Color.class, Poloha.class alebo String.class

Pozri tiež:

PremennéSkriptu#vymaž(String, Trieda)

vymazPremennu

public static void vymazPremennu(String názov,
                                 Class<?> typ)

Alias pre vymažPremennú.

vykonajSkript
```
public static int vykonajSkript(String[] riadky)
```
Vykoná skript uložený v poli reťazcov. Pozri triedu Skript.

Poznámka: Informácie o pravidlách vykonávania boli presunuté do opisu triedy Skript.

Parametre:

riadky – pole reťazcov reprezentujúcich riadky skriptu

Návratová hodnota:

riadok, na ktorom vznikla chyba (ak chyba nevznikla, tak je vrátená nula)

Výnimky:

GRobotException – ak bolo vykonávanie niektorého príkazu skriptu zrušené

IllegalAccessException – ak metóda, s ktorou súviselo vykonávanie niektorého príkazu skriptu nie je dostupná (verejná)

IllegalArgumentException – ak niektorý z argumentov metódy, s ktorou súviselo vykonávanie niektorého z príkazov skriptu nebol požadovaného typu, ani ho na taký typ nebolo možné previesť

InvocationTargetException – ak pri vykonávní metódy, s ktorou súviselo vykonávanie niektorého z príkazov skriptu vznikla výnimka

Pozri tiež:

interaktívnyRežim(boolean), režimLadenia(boolean), vykonajSkript(String), vykonajSkript(List), vykonajSkript(String, boolean), skriptJeSpustený(), spustiSkript(String[]), spustiSkript(String), spustiSkript(List), spustiSkript(String, boolean), kódPoslednejChyby(), riadokPoslednejChyby(), textPoslednejChyby(), textChyby(int)

vykonajSkript
```
public static int vykonajSkript(String skript)
```
Vykoná skript zadaný vo forme reťazca. Riadky musia byť oddelené znakom nového reťazca \n. Pravidlá vykonávania sú rovnaké ako pri metóde vykonajSkript(riadky).

Parametre:

skript – skript uložený v jednom reťazci

Návratová hodnota:

riadok, na ktorom vznikla chyba (ak chyba nevznikla, tak je vrátená nula)

Výnimky:

GRobotException – ak bolo vykonávanie niektorého príkazu skriptu zrušené

IllegalAccessException – ak metóda, s ktorou súviselo vykonávanie niektorého príkazu skriptu nie je dostupná (verejná)

IllegalArgumentException – ak niektorý z argumentov metódy, s ktorou súviselo vykonávanie niektorého z príkazov skriptu nebol požadovaného typu, ani ho na taký typ nebolo možné previesť

InvocationTargetException – ak pri vykonávní metódy, s ktorou súviselo vykonávanie niektorého z príkazov skriptu vznikla výnimka

Pozri tiež:

interaktívnyRežim(boolean), režimLadenia(boolean), vykonajSkript(String[]), vykonajSkript(List), vykonajSkript(String, boolean), skriptJeSpustený(), spustiSkript(String[]), spustiSkript(String), spustiSkript(List), spustiSkript(String, boolean), kódPoslednejChyby(), riadokPoslednejChyby(), textPoslednejChyby(), textChyby(int)

vykonajSkript
```
public static int vykonajSkript(List<String> skript)
```
Vykoná skript zadaný vo forme parametrického zoznamu. Metóda vytvorí zo zoznamu kópiu do poľa reťazcov, aby nenastal konflikt pri prípadnej paralelnej úprave zoznamu, čiže ak sa zoznam počas vykonávania skriptu zmení, vykonávanie tým nebude ovplyvnené, pretože sa v skutočnosti vykonáva kópia skriptu vytvorená v čase volania tejto metódy. Z toho vyplýva, že pravidlá vykonávania sú rovnaké ako pri metóde vykonajSkript(riadky).

Parametre:

skript – skript uložený v parametrickom zozname

Návratová hodnota:

riadok, na ktorom vznikla chyba (ak chyba nevznikla, tak je vrátená nula)

Výnimky:

GRobotException – ak bolo vykonávanie niektorého príkazu skriptu zrušené

IllegalAccessException – ak metóda, s ktorou súviselo vykonávanie niektorého príkazu skriptu nie je dostupná (verejná)

IllegalArgumentException – ak niektorý z argumentov metódy, s ktorou súviselo vykonávanie niektorého z príkazov skriptu nebol požadovaného typu, ani ho na taký typ nebolo možné previesť

InvocationTargetException – ak pri vykonávní metódy, s ktorou súviselo vykonávanie niektorého z príkazov skriptu vznikla výnimka

Pozri tiež:

interaktívnyRežim(boolean), režimLadenia(boolean), vykonajSkript(String[]), vykonajSkript(String, boolean), skriptJeSpustený(), spustiSkript(String[]), spustiSkript(String), spustiSkript(List), spustiSkript(String, boolean), kódPoslednejChyby(), riadokPoslednejChyby(), textPoslednejChyby(), textChyby(int)

vykonajSkript
```
public static int vykonajSkript(String skript,
                                boolean zoSúboru)
```
Vykoná skript zadaný vo forme reťazca alebo vo forme názvu súboru, z ktorého má byť prečítaný. Ak je druhý parameter rovný false, tak je prvý parameter považovaný za skript a metóda sa správa rovnako ako metóda vykonajSkript(skript). Ak je druhý parameter rovný true, tak prvý parameter je považovaný za názov súboru, z ktorého má byť skript prečítaný a vykonaný. Pravidlá vykonávania sú v oboch prípadoch rovnaké ako pri metóde vykonajSkript(riadky).

Príklad skriptu uloženého v súbore:

Poznámka: Skript musí byť uložený s kódovaním UTF-8.

skoč -72.5, -30
hrúbka čiary 3.2
farba žltá
začni cestu
nech i = 8

:opakuj
dopredu 60
vpravo 45
dokedy i, opakuj

vyplň cestu
farba červená
obkresli cestu

farba čierna
domov
farba textu purpurová
vypíš riadok "Hotovo!

Program:

Ak predchádzajúci skript uložíme do súboru s názvom „Skript.GRScript,“ tak na jeho spustenie môžeme použiť nasledujúci úryvok kódu:
```
interaktívnyRežim(true);
Svet.interaktívnyRežim(true);

int kód = Svet.vykonajSkript("Skript.GRScript", true);

if (0 > kód)
    Svet.vypíšRiadok("Chyba pri čítaní súboru (", kód, ").");
else
    if (0 < kód) Svet.vypíšRiadok("Chyba na riadku: ", kód);
```
Výsledok:

Výsledok vykonania skriptu vyššie uvedeným programom.
Parametre:

skript – názov súboru so skriptom alebo skript uložený v jednom reťazci

zoSúboru – ak je true, tak je prvý parameter považovaný za názov súboru so skriptom; ak je false, tak je prvý parameter považovaný za skript (rovnako ako pri metóde vykonajSkript(skript))

Návratová hodnota:

riadok, na ktorom vznikla chyba (ak chyba nevznikla, tak je vrátená nula); ak je návratová hodnota záporná, znamená to, že vznikla chyba pri čítaní súboru

Výnimky:

GRobotException – ak skript so zadaným menom nebol nájdený alebo ak bolo vykonávanie niektorého príkazu skriptu zrušené

IllegalAccessException – ak metóda, s ktorou súviselo vykonávanie niektorého príkazu skriptu nie je dostupná (verejná)

IllegalArgumentException – ak niektorý z argumentov metódy, s ktorou súviselo vykonávanie niektorého z príkazov skriptu nebol požadovaného typu, ani ho na taký typ nebolo možné previesť

InvocationTargetException – ak pri vykonávní metódy, s ktorou súviselo vykonávanie niektorého z príkazov skriptu vznikla výnimka

Pozri tiež:

interaktívnyRežim(boolean), režimLadenia(boolean), vykonajSkript(String[]), vykonajSkript(String), vykonajSkript(List), skriptJeSpustený(), spustiSkript(String[]), spustiSkript(String), spustiSkript(List), spustiSkript(String, boolean), kódPoslednejChyby(), riadokPoslednejChyby(), textPoslednejChyby(), textChyby(int)

nahrajSkript
```
public static Skript nahrajSkript(String názov,
                                  String súbor)
```
Nahrá skript zo súboru a uloží ho do vnútornej pamäte pod zadaným názvom. Ak počas nahrávania skriptu vznikne chyba, tak metóda vráti hodnotu null, v opačnom prípade vráti inštanciu triedy Skript na prípadné ďalšie spracovanie.

Parametre:

názov – názov skriptu, pod ktorým bude tento skript (v prípade úspešného nahratia) evidovaný vo vnútornom zozname skriptov

súbor – súbor, z ktorého bude skript nahraný

Návratová hodnota:

inštancia triedy Skript na ďalšie spracovanie, prípadne null

Pozri tiež:

nahrajSkript(String), vyrobSkript(String, boolean), vyrobSkript(String), vyrobSkript(List), vyrobSkript(String[]), registrujSkript(String, String), registrujSkript(String, List), registrujSkript(String, String[]), dajSkript(String), volajSkript(String)

nahrajSkript
```
public static Skript nahrajSkript(String súbor)
```
Toto je klon metódy nahrajSkript(názov, súbor), ktorý bol definovaný preto, aby bolo možné nahrávať zo súborov skripty aj v rámci iných skriptov. Metóda bude považovať za názov skriptu meno súboru, to jest časť medzi posledným oddeľovačom cesty (buď \, alebo /) a posledným oddeľovačom prípony (.).

Parametre:

súbor – súbor, z ktorého bude skript nahraný; názov skriptu je tiež odvodený z tohto reťazca

Návratová hodnota:

inštancia úspešne nahratého skriptu alebo hodnota null

Pozri tiež:

nahrajSkript(String, String)

vyrobSkript
```
public static Skript vyrobSkript(String skript,
                                 boolean zoSúboru)
```
Vyrobí skript (zo zadaného textového reťazca alebo zo súboru) a vráti ho v inštancii triedy Skript na ďalšie spracovanie. Ak je parameter zoSúboru rovný false, tak je v parametri skript očakávaný text skriptu. Ak je parameter zoSúboru rovný true, tak je v parametri skript očakávaný názov súboru, z ktorého má byť skript prečítaný. Ak vznikne počas čítania alebo spracovania (výroby) skriptu chyba, tak metóda vráti hodnotu null.

Parametre:

skript – názov súboru so skriptom alebo skript uložený v jednom reťazci

zoSúboru – ak je true, tak je prvý parameter považovaný za názov súboru so skriptom; ak je false, tak je prvý parameter považovaný za skript (rovnako ako pri metóde vyrobSkript(skript))

Návratová hodnota:

inštancia triedy Skript alebo null

Pozri tiež:

nahrajSkript(String, String), vyrobSkript(String), vyrobSkript(List), vyrobSkript(String[]), registrujSkript(String, String), registrujSkript(String, List), registrujSkript(String, String[]), dajSkript(String), volajSkript(String)

vyrobSkript
```
public static Skript vyrobSkript(String skript)
```
Vyrobí zo zadaného textového reťazca skript a vráti ho v inštancii triedy Skript na ďalšie spracovanie. Ak počas výroby skriptu vznikne chyba, tak metóda vráti hodnotu null.

Parametre:

skript – skript v textovom tvare (reťazec obsahujúci celý skript)

Návratová hodnota:

inštancia triedy Skript alebo null

Pozri tiež:

nahrajSkript(String, String), vyrobSkript(String, boolean), vyrobSkript(List), vyrobSkript(String[]), registrujSkript(String, String), registrujSkript(String, List), registrujSkript(String, String[]), dajSkript(String), volajSkript(String)

vyrobSkript
```
public static Skript vyrobSkript(List<String> skript)
```
Vyrobí zo zadaného zoznamu reťazcov reprezentujúcich riadky skriptu nový skript a vráti ho v inštancii triedy Skript na ďalšie spracovanie. Ak vznikne počas výroby skriptu chyba, tak metóda vráti hodnotu null.

Parametre:

skript – zoznam s riadkami skriptu

Návratová hodnota:

inštancia triedy Skript alebo null

Pozri tiež:

nahrajSkript(String, String), vyrobSkript(String, boolean), vyrobSkript(String), vyrobSkript(String[]), registrujSkript(String, String), registrujSkript(String, List), registrujSkript(String, String[]), dajSkript(String), volajSkript(String)

vyrobSkript
```
public static Skript vyrobSkript(String[] skript)
```
Vyrobí zo zadaného reťazcového poľa, ktorého prvky reprezentujú riadky skriptu, nový skript a vráti ho na ďalšie spracovanie v inštancii triedy Skript. Ak vznikne počas výroby skriptu chyba, tak metóda vráti hodnotu null.

Parametre:

skript – pole reťazcov reprezentujúcich riadky skriptu

Návratová hodnota:

inštancia triedy Skript alebo null

Pozri tiež:

nahrajSkript(String, String), vyrobSkript(String, boolean), vyrobSkript(String), vyrobSkript(List), registrujSkript(String, String), registrujSkript(String, List), registrujSkript(String, String[]), dajSkript(String), volajSkript(String)

registrujSkript
```
public static Skript registrujSkript(String názov,
                                     String skript)
```
Vyrobí zo zadaného reťazca nový skript, registruje ho pod zadaným názvom a vráti ho na prípadné ďalšie spracovanie. Metóda funguje podobne ako metóda nahrajSkript s tým rozdielom, že skript nie je čítaný zo súboru, ale je prijatý vo forme reťazca.

Parametre:

názov – názov skriptu, pod ktorým bude tento skript (v prípade úspešného vyrobenia) evidovaný vo vnútornom zozname skriptov

skript – skript v textovom tvare (reťazec obsahujúci celý skript)

Návratová hodnota:

inštancia triedy Skript na ďalšie spracovanie alebo null v prípade chyby

Pozri tiež:

nahrajSkript(String, String), vyrobSkript(String, boolean), vyrobSkript(String), vyrobSkript(List), vyrobSkript(String[]), registrujSkript(String, List), registrujSkript(String, String[]), dajSkript(String), volajSkript(String)

registrujSkript
```
public static Skript registrujSkript(String názov,
                                     List<String> skript)
```
Vyrobí zo zadaného zoznamu reťazcov nový skript, registruje ho pod zadaným názvom a vráti ho na prípadné ďalšie spracovanie. Metóda funguje podobne ako metóda vyrobSkript (ibaže skript navyše aj registruje vo vnútornej pamäti).

Parametre:

názov – názov skriptu, pod ktorým bude tento skript (v prípade úspešného vyrobenia) evidovaný vo vnútornom zozname skriptov

skript – zoznam s riadkami skriptu

Návratová hodnota:

inštancia triedy Skript na ďalšie spracovanie alebo null v prípade chyby

Pozri tiež:

nahrajSkript(String, String), vyrobSkript(String, boolean), vyrobSkript(String), vyrobSkript(List), vyrobSkript(String[]), registrujSkript(String, String), registrujSkript(String, String[]), dajSkript(String), volajSkript(String)

registrujSkript
```
public static Skript registrujSkript(String názov,
                                     String[] skript)
```
Vyrobí zo zadaného reťazcového poľa nový skript, registruje ho pod zadaným názvom a vráti ho na prípadné ďalšie spracovanie. Metóda funguje podobne ako metóda vyrobSkript (ibaže skript navyše aj registruje vo vnútornej pamäti).

Parametre:

názov – názov skriptu, pod ktorým bude tento skript (v prípade úspešného vyrobenia) evidovaný vo vnútornom zozname skriptov

skript – pole reťazcov reprezentujúcich riadky skriptu

Návratová hodnota:

inštancia triedy Skript na ďalšie spracovanie alebo null v prípade chyby

Pozri tiež:

nahrajSkript(String, String), vyrobSkript(String, boolean), vyrobSkript(String), vyrobSkript(List), vyrobSkript(String[]), registrujSkript(String, String), registrujSkript(String, List), dajSkript(String), volajSkript(String)

dajSkript
```
public static Skript dajSkript(String názov)
```
Vráti inštanciu skriptu registrovanú vo vnútornej pamäti programovacieho rámca pod zadaným menom.

Parametre:

názov – názov skriptu vopred registrovaného vo vnútornom zozname skriptov (napríklad metódou nahrajSkript)

Návratová hodnota:

inštancia triedy Skript alebo null

Pozri tiež:

nahrajSkript(String, String), vyrobSkript(String, boolean), vyrobSkript(String), vyrobSkript(List), vyrobSkript(String[]), registrujSkript(String, String), registrujSkript(String, List), registrujSkript(String, String[]), volajSkript(String)

volajSkript

public static int volajSkript(String názov)

Spustí skript registrovaný vo vnútornej pamäti rámca pod zadaným menom.

Poznámka: Rekurzívne spúšťanie skriptov nie je povolené.

Obmedzenie zákazu rekurzie platí najmä pre túto metódu, ale ak nie je hĺbka rekurzie príliš veľká, dá sa obísť metódami, ktoré každým volaním čítajú a vytvárajú nové inštancie skriptov (čo je pamäťovo náročné, práve preto nesmie byť hĺbka rekurzie príliš veľká). Ukazuje to nasledujúci príklad (nižšie; uložený v dvoch skriptoch), ktorý na svoje fungovanie potrebuje tento spúšťač skriptov:

import knižnica.*;
import knižnica.podpora.ExpressionProcessor;

public class SpustiSkript extends GRobot
{
    // Špeciálny príkaz (dostupný v skripte ako: list "name) slúžiaci na
    // deklaráciu premennej typu pole alebo vymazanie obsahu poľa. (Polia
    // sú súčasťou triedy ExpressionProcessor a sú dynamické.)
    public static void list(String name)
    {
        ExpressionProcessor.globalVariables.getOrCreate(name).clear();
    }

    // Špeciálny príkaz (dostupný v skripte ako: size "name) slúžiaci na
    // overenie aktuálnej veľkosti poľa.
    public static double size(String name)
    {
        ExpressionProcessor.Variable list =
            ExpressionProcessor.globalVariables.get(name);
        if (null == list) return -2;
        return list.size();
    }

    private SpustiSkript(String[] args)
    {
        // V skripte (nižšie) sú interaktívne inštancie vždy explicitne určené
        // pomocou riadkov začínajúcich sa zavináčom. Keby to tak nebolo,
        // museli by byť interaktívne inštancie zapnuté týmito príkazmi:
        // 
        // 	interaktívnyRežim(true);
        // 	Svet.interaktívnyRežim(true);

        // Spúšťanie skriptov zo súborov, ktorých názvy boli zadané ako
        // argumenty príkazového riadka procesu (príkazového riadka OS) a čo
        // najpresnejší výpis výsledku (najmä v súvislosti so zachytením
        // chybových stavov, ktoré sú kľúčové pri ladení skriptov; poznámka:
        // rekurzívne spustené skripty vracajú svoje chybové stavy priamo do
        // skriptov, ktoré ich volajú, preto nie je možné chyby, ktoré v nich
        // vzniknú vypísať tu, ale iba v rámci volajúceho skriptu, na čo
        // reflektuje skript stromB.GRScript).
        for (String arg : args)
        {
            if (!arg.endsWith(".GRScript")) arg += ".GRScript";
            int kód = Svet.vykonajSkript(arg, true);

            if (0 > kód)
                Svet.vypíšRiadok("Chyba pri čítaní súboru „", arg,
                    "“ (", kód, ").");
            else if (0 < kód)
            {
                Svet.vypíšRiadok("Chyba na riadku: ", kód);
                Svet.formulujChybuSkriptu(kód);
            }
            else
                Svet.vypíšRiadok("Skript „", arg, "“ bol vykonaný úspešne.");

            if (!GRobotException.denník.prázdny())
            {
                Svet.vypíšRiadok("Správy z denníka chýb:");

                for (GRobotException.Chyba chyba : GRobotException.denník)
                {
                    if (null != chyba.výnimka) Svet.vypíšRiadok(chyba.výnimka);
                    if (null != chyba.správa) Svet.vypíšRiadok(chyba.správa);
                }

                GRobotException.denník.vymaž();
            }
        }
    }

    public static void main(String[] args)
    {
        Svet.použiKonfiguráciu("SpustiSkript.cfg");
        new SpustiSkript(args);
    }
}

Príklad:

Tieto dva skripty (nižšie) vyžadujú na spustenie a správne fungovanie spúšťač uvedený vyššie, ktorý obsahuje definície dvoch nových príkazov list a size (čím je zároveň ukázaná možnosť rozširovania skriptov programovacieho rámca o nové príkazy).

Obsah súboru „PytagorovStrom.GRScript“:

@svet
nahraj skript "stromB.GRScript
nech dĺžka = 100
nech polovica = 50
nech odvesna = 70.7106781
nech počet = 0
	@robot
	list "dĺžky
	list "polovice
	list "odvesny
	odskoč 125

nekresli
nech parameter = 100
volaj skript "stromB
kresli

Obsah súboru „stromB.GRScript“:

@robot
; Počiatočné hodnoty:
; nech dĺžka = 100
; nech polovica = 50
; nech odvesna = 70.7106781
; nech počet = 0
; nech parameter = 100

ak #dĺžka >= 20
	#dĺžky[počet] = dĺžka
	#polovice[počet] = polovica
	#odvesny[počet] = odvesna
	nech počet + 1

	nech dĺžka = parameter
	nech polovica = #dĺžka * 0.5
	nech odvesna = #dĺžka * 0.707106781

	odskoč #polovica
	vpravo 90
	vpred #polovica

	vľavo 90
	vpred #dĺžka

	skoč #polovica
	vpravo 45

		@svet
		nech parameter = odvesna
		nech kód = vykonaj skript "stromB.GRScript", 1
		ak #0 <> kód
			vypíš "Chyba ", kód
			nech text = text chyby kód
			vypíš riadok ": ", text

	vľavo 45
	odskoč #polovica

	vľavo 90
	vpred #dĺžka

	vpravo 90
	skoč #polovica
	vľavo 45

		@svet
		nech parameter = odvesna
		nech kód = vykonaj skript "stromB.GRScript", 1
		ak #0 <> kód
			vypíš "Chyba ", kód
			nech text = text chyby kód
			vypíš riadok ": ", text

	vpravo 45
	odskoč #polovica
	vľavo 90

	vľavo 90
	vpred #dĺžka

	vľavo 90
	vpred #polovica

	vľavo 90
	skoč #polovica

	nech počet – 1
	nech dĺžka = #dĺžky[počet]
	nech polovica = #polovice[počet]
	nech odvesna = #odvesny[počet]

Po skompilovaní spúšťača a uloženia skriptov na lokalitu, z ktorej budú dostupné pre spúšťač treba zadať názov skriptu ako parameter spúšťača, napríklad takýmto príkazom do príkazového riadka konzoly (napr. príkazového riadka OS):

java -Dfile.encoding=UTF-8 -cp c:\_jEdit\GRobot.jar;.\ SpustiSkript PytagorovStrom.GRScript

Poznámky: Java musí byť dostupná na ceste (PATH) operačného systému. Umiestnenie c:\_jEdit musí obsahovať balíček programovacieho rámca GRobot.jar alebo musí byť táto cesta zmenená na také umiestnenie, ktoré tento balíček obsahuje. Skripty a spúšťač musia byť umiestnené na aktuálnej ceste konzoly OS (tzv. current path).

Výsledok vykonania
skriptov.

Výsledok vykonania skriptov.

Parametre:: názov – názov skriptu vopred registrovaného vo vnútornom zozname skriptov (napríklad metódou nahrajSkript)
Návratová hodnota:: CHYBA_ČÍTANIA_SKRIPTU (-1) v prípade, že skript nebol nájdený, ŽIADNA_CHYBA v prípade bezchybného vykonania skriptu alebo kladné číslo vyjadrujúce číslo riadka, na ktorom vznikla chyba
Pozri tiež:: nahrajSkript(String, String), vyrobSkript(String, boolean), vyrobSkript(String), vyrobSkript(List), vyrobSkript(String[]), registrujSkript(String, String), registrujSkript(String, List), registrujSkript(String, String[]), dajSkript(String)

skriptJeSpustený
```
public static boolean skriptJeSpustený()
```
Zistí, či je práve vykonávaný skript, ktorý bol spustený príkazom spustiSkript (alebo niektorou jeho modifikáciou).

Návratová hodnota:

true ak je skript spustený

Pozri tiež:

spustiSkript(String[]), spustiSkript(String), spustiSkript(List), spustiSkript(String, boolean)

skriptJeSpusteny
```
public static boolean skriptJeSpusteny()
```
Alias pre skriptJeSpustený.

spustiSkript
```
public static void spustiSkript(String[] riadky)
```
Funguje podobne ako vykonajSkript(riadky), ale spustí vykonávanie v samostatnom vlákne Javy, takže môže byť ladené. Keďže pri tomto spôsobe nie je možné získať návratovú hodnotu priamo, tak je v prípade vzniku chyby počas vykonávania skriptu spustená reakcia ladenie, ktorej je poslané číslo chybového riadka v parametri riadok, text chybového hlásenia v parametri príkaz a správa má kód UKONČENIE_CHYBOU. Ak chyba nevznikne, tak je tiež spustená reakcia ladenie, ale prvé dva parametre sú prázdne a správa má kód UKONČENIE_SKRIPTU. Dokedy nie je ukončená činnosť jedného skriptu, nie je možné spustiť vykonávanie ďalšieho, ale v priebehu jeho činnosti je možné (aj keď nie odporúčané) vykonať iný skript (metódou vykonajSkript alebo jej „klonmi“) alebo príkaz (metódou vykonajPríkaz alebo jej „klonmi“).

Poznámky: Komplexný príklad ladenia je v sekcii Príklad ladenia skriptov v opise triedy Skript.
Zabezpečenie spustenia príkazu spustiSkript je jednoduché (v spomínanom príklade sa nachádza v metóde spusti), ale zabezpečenie spracovania rôznych situácií (udalostí) počas ladenia si vyžaduje náročnejší prístup. V spomínanom príklade je v komentároch stručne opísaný účel jednotlivých častí programu s prípadnými návrhmi na ďalšie vylepšovanie.

Parametre:

riadky – pole reťazcov reprezentujúcich riadky skriptu

Výnimky:

GRobotException – ak bolo vykonávanie niektorého príkazu skriptu zrušené

IllegalAccessException – ak metóda, s ktorou súviselo vykonávanie niektorého príkazu skriptu nie je dostupná (verejná)

IllegalArgumentException – ak niektorý z argumentov metódy, s ktorou súviselo vykonávanie niektorého z príkazov skriptu nebol požadovaného typu, ani ho na taký typ nebolo možné previesť

InvocationTargetException – ak pri vykonávní metódy, s ktorou súviselo vykonávanie niektorého z príkazov skriptu vznikla výnimka

Pozri tiež:

interaktívnyRežim(boolean), režimLadenia(boolean), vykonajSkript(String[]), vykonajSkript(String), vykonajSkript(List), vykonajSkript(String, boolean), skriptJeSpustený(), spustiSkript(String), spustiSkript(List), spustiSkript(String, boolean), kódPoslednejChyby(), riadokPoslednejChyby(), textPoslednejChyby(), textChyby(int)

spustiSkript
```
public static void spustiSkript(String skript)
```
Funguje podobne ako vykonajSkript(skript), ale spustí vykonávanie v samostatnom vlákne Javy, takže môže byť ladené. Keďže pri tomto spôsobe nie je možné získať návratovú hodnotu priamo, tak je v prípade vzniku chyby počas vykonávania skriptu spustená reakcia ladenie, ktorej je poslané číslo chybového riadka v parametri riadok, text chybového hlásenia v parametri príkaz a správa má kód UKONČENIE_CHYBOU. Ak chyba nevznikne, tak je tiež spustená reakcia ladenie, ale prvé dva parametre sú prázdne a správa má kód UKONČENIE_SKRIPTU. Dokedy nie je ukončená činnosť jedného skriptu, nie je možné spustiť vykonávanie ďalšieho, ale v priebehu jeho činnosti je možné (aj keď nie odporúčané) vykonať iný skript (metódou vykonajSkript alebo jej „klonmi“) alebo príkaz (metódou vykonajPríkaz alebo jej „klonmi“).

Parametre:

skript – skript uložený v jednom reťazci

Výnimky:

GRobotException – ak bolo vykonávanie niektorého príkazu skriptu zrušené

IllegalAccessException – ak metóda, s ktorou súviselo vykonávanie niektorého príkazu skriptu nie je dostupná (verejná)

IllegalArgumentException – ak niektorý z argumentov metódy, s ktorou súviselo vykonávanie niektorého z príkazov skriptu nebol požadovaného typu, ani ho na taký typ nebolo možné previesť

InvocationTargetException – ak pri vykonávní metódy, s ktorou súviselo vykonávanie niektorého z príkazov skriptu vznikla výnimka

Pozri tiež:

interaktívnyRežim(boolean), režimLadenia(boolean), vykonajSkript(String[]), vykonajSkript(String), vykonajSkript(List), vykonajSkript(String, boolean), skriptJeSpustený(), spustiSkript(String[]), spustiSkript(List), spustiSkript(String, boolean), kódPoslednejChyby(), riadokPoslednejChyby(), textPoslednejChyby(), textChyby(int)

spustiSkript
```
public static void spustiSkript(List<String> skript)
```
Funguje podobne ako vykonajSkript(skript) a principiálne pre neho platia rovnaké pravidlá ako pre spustiSkript(skript). Pozri opisy oboch metód na získanie úplného prehľadu o fungovaní tejto metódy. V skrátenej forme: táto metóda vytvorí zo zadaného zoznamu reťazcov kópiu do poľa reťazcov, ktorú spustí ako skript v samostatnom vlákne. Ďalšie podrobnosti o činnosti skriptov sú v opisoch dotknutých metód.

Parametre:

skript – skript uložený v zozname reťazcov

Výnimky:

GRobotException – ak bolo vykonávanie niektorého príkazu skriptu zrušené

IllegalAccessException – ak metóda, s ktorou súviselo vykonávanie niektorého príkazu skriptu nie je dostupná (verejná)

IllegalArgumentException – ak niektorý z argumentov metódy, s ktorou súviselo vykonávanie niektorého z príkazov skriptu nebol požadovaného typu, ani ho na taký typ nebolo možné previesť

InvocationTargetException – ak pri vykonávní metódy, s ktorou súviselo vykonávanie niektorého z príkazov skriptu vznikla výnimka

Pozri tiež:

interaktívnyRežim(boolean), režimLadenia(boolean), vykonajSkript(String[]), vykonajSkript(String), vykonajSkript(List), vykonajSkript(String, boolean), skriptJeSpustený(), spustiSkript(String[]), spustiSkript(String, boolean), kódPoslednejChyby(), riadokPoslednejChyby(), textPoslednejChyby(), textChyby(int)

spustiSkript
```
public static void spustiSkript(String skript,
                                boolean zoSúboru)
```
Funguje podobne ako vykonajSkript(skript, zoSúboru), ale spustí vykonávanie v samostatnom vlákne Javy, takže môže byť ladené. Keďže pri tomto spôsobe nie je možné získať návratovú hodnotu priamo, tak je v prípade vzniku chyby počas vykonávania skriptu spustená reakcia ladenie, ktorej je poslané číslo chybového riadka v parametri riadok, text chybového hlásenia v parametri príkaz a správa má kód UKONČENIE_CHYBOU. Ak chyba nevznikne, tak je tiež spustená reakcia ladenie, ale prvé dva parametre sú prázdne a správa má kód UKONČENIE_SKRIPTU. Dokedy nie je ukončená činnosť jedného skriptu, nie je možné spustiť vykonávanie ďalšieho, ale v priebehu jeho činnosti je možné (aj keď nie odporúčané) vykonať iný skript (metódou vykonajSkript alebo jej „klonmi“) alebo príkaz (metódou vykonajPríkaz alebo jej „klonmi“).

Parametre:

skript – názov súboru so skriptom alebo skript uložený v jednom reťazci

zoSúboru – ak je true, tak je prvý parameter považovaný za názov súboru so skriptom (uloženom s použitím kódovania UTF-8); ak je false, tak je prvý parameter považovaný za skript (rovnako ako pri metóde spustiSkript(skript))

Výnimky:

GRobotException – ak skript so zadaným menom nebol nájdený alebo ak bolo vykonávanie niektorého príkazu skriptu zrušené

IllegalAccessException – ak metóda, s ktorou súviselo vykonávanie niektorého príkazu skriptu nie je dostupná (verejná)

IllegalArgumentException – ak niektorý z argumentov metódy, s ktorou súviselo vykonávanie niektorého z príkazov skriptu nebol požadovaného typu, ani ho na taký typ nebolo možné previesť

InvocationTargetException – ak pri vykonávní metódy, s ktorou súviselo vykonávanie niektorého z príkazov skriptu vznikla výnimka

Pozri tiež:

interaktívnyRežim(boolean), režimLadenia(boolean), vykonajSkript(String[]), vykonajSkript(String), vykonajSkript(List), vykonajSkript(String, boolean), skriptJeSpustený(), spustiSkript(String[]), spustiSkript(String), spustiSkript(List), kódPoslednejChyby(), riadokPoslednejChyby(), textPoslednejChyby(), textChyby(int)

vykonajPríkaz
```
public static boolean vykonajPríkaz(String príkaz)
```
Táto metóda má rovnaké jadro ako mechanizmus vykonávania príkazov v interaktívnom režime a umožňuje používať príkazy, ktoré sú dostupné v tomto režime aj za jeho hranicami (t. j. bez nevyhnutnosti jeho aktivácie).

Parametre:

príkaz – príkazový riadok spĺňajúci pravidlá uvedené v opise metódy interaktívnyRežim

Návratová hodnota:

true ak bol príkaz nájdený a podarilo sa ho vykonať

Výnimky:

GRobotException – ak bolo vykonávanie príkazu zrušené

IllegalAccessException – ak metóda, s ktorou súvisí vykonávanie príkazu nie je dostupná (verejná)

IllegalArgumentException – ak niektorý z argumentov metódy, s ktorou súvisí vykonávanie príkazu nie je požadovaného typu, ani ho na neho nie je možné previesť

InvocationTargetException – ak pri vykonávní metódy, s ktorou súvisí vykonávanie príkazu vznikla výnimka

Pozri tiež:

GRobot.vykonajPríkaz(String), Plátno.vykonajPríkaz(String), GRobot.interaktívnyRežim(boolean), interaktívnyRežim(boolean), Plátno.interaktívnyRežim(boolean), režimLadenia(boolean)

vykonajPrikaz

public static boolean vykonajPrikaz(String príkaz)

Alias pre vykonajPríkaz.

interaktívnyRežim

public static void interaktívnyRežim(boolean zapni)

Zapne alebo vypne interaktívny režim pre inštanciu sveta.

Informácia: Ďalšie podrobnosti súvisiace s témou vykonávania príkazov interaktívneho režimu a skriptov sú v opise triedy Skript.

Režim umožňuje pracovať so zvoleným robotom/robotmi, svetom a/alebo plátnom tak, že mnohé príkazy môžu byť spracúvané priamo počas činnosti programu a to buď zadaním do zobrazeného príkazového riadka, alebo spustením skriptu. Príkazy interaktívneho režimu môžu byť vykonávané aj bez jeho aktivácie a to volaním prislúchajúcej metódy – robot.vykonajPríkaz(príkaz), Svet.vykonajPríkaz(príkaz), podlaha.vykonajPríkaz(príkaz) alebo strop.vykonajPríkaz(príkaz).

Pôvodný úmysel pri implementácii tohto režimu (pred začatím implementácie skriptov) bolo využitie vo výučbe so zreteľom na to, že vykonávanie príkazov interaktívneho režimu síce nie je z pohľadu spracovania príliš efektívne, ale je názorné a začínajúci študent/programátor môže ľahko a rýchlo vidieť, ktorý zo základných príkazov (robota) má aký efekt (bez nevyhnutnosti častej a opakovanej rekompilácie programu). Po zapnutí interaktívneho príkazového režimu pre niektorého z robotov, svet a/alebo plátno, je automaticky zobrazený vstupný riadok, ktorý od tejto chvíle očakáva príkazy zadané v špecifickom tvare opísanom nižšie.

Po potvrdení vstupu alebo spustení skriptu je zahájené prehľadávanie tried s cieľom nájsť a vykonať takú metódu, ktorá sa (pri dodržaní určitých pravidiel) zhoduje so zadaným príkazom. Najprv sú prehľadávané všetky inštancie robota (alebo jeho potomkov), ktoré majú tento režim aktivovaný, v rámci toho je prehľadaná trieda Súbor prislúchajúcich robotov, potom (ak má trieda Svet zapnutý interaktívny režim) je prehľadná trieda Svet spolu s triedou Javy Math a statickou časťou tried Bod a Farba. Nakoniec sú prehľadané inštancie plátien podlaha a strop – opäť len plátna, ktoré majú aktivovaný interaktívny režim. (Schéma platných príkazov je opísaná nižšie.)

To znamená, že príkazy sú prioritne posielané inštanciám robotov (ktoré sú v interaktívnom režime) a až potom ostatným inštanciám (Svet, Math…). Prvý pozitívny výsledok v rámci spracovania príkazového riadka ukončuje ďalšie spracovanie. To znamená, že ak zareaguje aspoň jeden robot (môžu zareagovať aj všetky), tak sa spracovanie príkazu končí. Iba v prípade, že na zadaný príkaz nezareagoval žiadny robot, je príkaz poslaný svetu a ten v prípade svojho neúspechu dodatočne prehľadá ďalšie triedy (Math…). Ak nezareaguje ani jedna súčasť prehľadávaná svetom, tak sú na rade plátna. Ak majú interaktívny režim aktivované obe plátna, tak je príkaz poslaný obom, ak iba jedno, tak iba jednému z nich.

Ak je aktívna obsluha udalostí, tak je v prípade pozitívneho výsledku spracovania príkazu potvrdeného v príkazovom riadku spustená reakcia spracovaniePríkazu. V prípade negatívneho výsledku (t. j. ak potvrdený príkaz nebol rozpoznaný žiadnou z prehľadávaných súčastí) sú spustené reakcie na klasické potvrdenie vstupu (potvrdenieÚdajov, potvrdenieVstupu).

Po deaktivovaní interaktívneho príkazového režimu všetkých dotknutých entít (robotov/sveta/plátien), je vstupný riadok automaticky skrytý a to bez ohľadu na to, či bol pred aktiváciou režimu zobrazený, alebo nie.

Príkazy interaktívneho režimu nie sú zadávané v syntakticky identickom tvare ako pri volaní metódy Javy. Zápis príkazu musí byť ekvivalentný takej metóde robota (resp. sveta/plátna alebo metódy triedy Math), ktorá spĺňa jednu z nasledujúcich podmienok:

neprijíma žiadny argument,
prijíma jeden až štyri číselné argumenty (typ double alebo int),
prijíma jeden booleovský argument (typ boolean),
prijíma jeden argument určujúci farbu, ktorá musí byť v skripte alebo príkazovom riadku zapísaná slovne: červená, zelená, modrá… (tu sú dovolené len preddefinované farby, ale číselnými kombináciami argumentov (nasmerovaných do inej verzie tejto metódy) je možné namiešať ľubovoľnú farbu),
všetky vyššie uvedené možnosti s jedným reťazcovým parametrom navyše, ktorý môže originálna metóda prijímať buď na prvom mieste, alebo poslednom mieste (zápis reťazca v skripte alebo príkazovom riadku je povolený buď na poslednom mieste s jednou úvodzovkou, alebo na ľubovoľnom mieste s dvomi úvodzovkami).

Upozornenia: Príkazy sveta vypíš a vypíšRiadok sú sprístupnené nad rámec vyššie uvedených podmienok (nespĺňali by podmienky, pretože prijímajú variabilný počet argumentov). Sú dostupné vždy a vždy posielajú svoj výpis prostredníctvom sveta (t. j. na vnútornú konzolu stropu). No ich správanie je mierne pozmenené. Reťazcový argument je vždy vypísaný ako prvý a po ňom nasledujú ďalšie argumenty (jeden až štyri číselné alebo farba). V prípade potreby sa želaný výsledok dá dosiahnuť viacnásobným zadaním príkazov vypíš a vypíš riadok.

Okrem toho bolo podobne transformovaných niekoľko ďalších príkazov, aby lepšie zapadali do fungovania interaktívneho režimu, napríklad: zadaj číslo, uprav číslo, náhodné číslo, zadaj reťazec…

Počet argumentov konkrétneho príkazu musí byť rovnaký ako počet parametrov metódy, ktorej volanie má reprezentovať. To, že počet číselných argumentov sa môže pohybovať v rozsahu nula až štyri znamená, že interaktívny režim vyhľadáva iba také metódy, ktoré majú deklarovaný uvedený počet parametrov.

Jednotlivé slová príkazov interaktívneho režimu musia byť oddelené medzerou, na veľkosti písmen nezáleží a diakritika musí byť buď úplne uvedená, alebo úplne vynechaná. Argumenty musia byť od príkazu aj od seba navzájom oddelené medzerou alebo čiarkou. Ich údajový typ musí byť v súlade s vyššie uvedenými bodmi. Variant reťazcového argumentu s jednou úvodzovkou musí byť vždy uvedený ako posledný (aj keď ide o ekvivalent metódy, ktorá ho má v skutočnosti na začiatku). V tomto prípade je všetok zvyšný obsah príkazového riadka (nasledujúci za strojopisnou úvodzovkou ") považovaný za obsah reťazca. Ak sa na príkazovom riadku nachádza viacero úvodzoviek, tak je do úvahy vzatá prvá a posledná, obsah medzi nimi je považovaný za reťazec a zvyšok riadka je spracovaný tak, ako keby bol celý reťazec uvedený na konci (t. j. ako pri variante s jednou úvodzovkou).

Poznámka: Interaktívny režim (a skriptovanie) programovacieho rámca GRobot využíva mechanizmus reflexie Javy. Vďaka tomu sa všetky verejné metódy tried odvodených od triedy GRobot, ktoré spĺňajú podmienky uvedené vyššie, automaticky stávajú dostupnými na použitie v interaktívnom režime aj skriptoch ako platné príkazy.

Interaktívny režim umožňuje pracovať s vnútornými premennými. Premenná vzniká pri prvom vložení hodnoty do nej. Na to slúži príkaz nech, za ktorým musí nasledovať názov premennej. Za názvom premennej môže byť uvedený operátor a ak nejde o unárny operátor, tak ďalej musí byť uvedená buď hodnota, alebo príkaz spĺňajúci podmienky uvedené vyššie. Binárne operácie fungujú tak, že uvedená hodnota alebo výsledok príkazu sú spracované spolu s aktuálnou hodnotou premennej – to znamená, že ak ide o sčítanie, tak je hodnota pripočítaná k hodnote premennej, ak ide o logický súčet, tak výsledok v premennej bude nula v prípade, že je hodnota premennej aj výrazu napravo boli nulové a jedna v opačnom prípade atď. Návratová hodnota príkazu (originálnej metódy programovacieho rámca) musí byť číslo (prípadne logická hodnota), farba, poloha alebo reťazec. Ak sa pracuje s číslami, tak operátor môže byť jedným z nasledujúceho zoznamu:

`=`	–	priradenie
`+`	–	sčítanie
`-`	–	odčítanie
`*`	–	násobenie
`/`	–	delenie
`%`	–	zvyšok po delení
`_`	–	odseknutie – odstránenie desatinnej časti
`~`	–	zmena znamienka (z kladného na záporné alebo naopak)
`==`	–	zhoda
`!=`	–	nezhoda
`!`	–	logická negácia
`&&`	–	logické a súčasne
`\|\|`	–	logické alebo
`>`	–	väčší než
`<`	–	menší než
`>=`	–	väčší alebo rovný než
`<=`	–	menší alebo rovný než

Napríklad:

nech a = 10.0
nech a + 2.0
nech f = farba

Takýto spôsob výpočtov je nepraktický – aj pomerne jednoduchý výpočet by vyžadoval viacero riadkov skriptu, preto bol ku skriptovaciemu stroju pridružený rozpoznávač jednoduchých matematických výrazov (s programátorskou syntaxou a s bežne dostupnými operáciami; angl. expression parser reprezentovaný pomocnou triedou tohto rámca – ExpressionProcessor, ktorej zdrojový kód je tu; môže byť užitočné pozrieť si v ňom napríklad zoznam operátorov a zoznam funkcií). Na jeho aktiváciu slúži rezervovaný znak mriežky #. Všetko, čo na príkazovom riadku nasleduje za znakom mriežky (ak to nebolo súčasťou reťazca) je poslané do rozpoznávača výrazov a vyhodnotené pred spracovaním príkazu. Rozpoznávač je prepojený s rámcom a dokáže identifikovať viaceré metódy s číselnou návratovou hodnotou.

Napríklad:

nech v = #veľkosť * 2.5 + 1
opakuj i 5
nech x = #(i – 3) * veľkosť

Je dovolené pracovať aj s reťazcami a vyhodnocovať výrazy v rámci podmieneného spracovania (aj číselné, nielen reťazcové). Príklad:

nech x = "Reťazec"

ak #x == "Reťazec"
vypíš riadok "áno"
inak
vypíš riadok "nie"

Ak sa riadok skriptu začína znakom @, tak je neprázdny zvyšok riadka považovaný za názov interaktívnej inštancie. Ak je zvyšok riadka prázdny, tak je interaktívna inštancia zrušená.

Príklady príkazov uložených v skripte (pozri príkazy vykonajSkript(riadky), spustiSkript(riadky) a im príbuzné; okrem opakovania sú všetky príkazy nasledujúceho skriptu použiteľné aj v príkazovom riadku interaktívneho režimu):

nech dĺžka = uprav číslo 100, "Zadaj stranu
nech koľko = uprav číslo 72, "Zadaj počet opakovaní

skoč dĺžka, -50
farba zelená

nech i = koľko
:opakuj1
dopredu dĺžka
vpravo 145
dokedy i, opakuj1

nech dĺžka * 3
nech dĺžka ~
skoč dĺžka, 0
nech dĺžka ~
nech dĺžka / 3

zdvihni pero
začni cestu

nech i = 5
:opakuj2
dopredu dĺžka
vpravo 72
dokedy i, opakuj2

farba žltá
vyplň cestu
farba čierna
hrúbka čiary 3.2
kresli cestu

vypíš dĺžka, "Toto je výsledok kreslenia s dĺžkou
vypíš koľko, " a počtom opakovaní
vypíš riadok ":

nech veľkosť = uprav číslo 30, "Zadaj veľkosť
veľkosť veľkosť
nech text = "Veľkosť:
nech text + veľkosť

domov
dozadu veľkosť
dozadu 10
text text
zobraz
domov

Po potvrdení predvolených údajov (100, 72 a 30) bude výsledok takýto:

Výsledok vykonania
skriptu.

Výsledok vykonania skriptu.

Obidva príkazy spomenuté nad príkladom majú svoje varianty dovoľujúce jednoduché spustenie skriptu uloženého v súbore:

vykonajSkript(názovSúboru, true);
spustiSkript(názovSúboru, true);

Parametre:: zapni – ak je true, režim bude pre svet zapnutý, inak bude vypnutý
Pozri tiež:: GRobot.interaktívnyRežim(boolean), Plátno.interaktívnyRežim(boolean), GRobot.vykonajPríkaz(String), vykonajPríkaz(String), Plátno.vykonajPríkaz(String), vykonajSkript(String[]), vykonajSkript(String), vykonajSkript(List), vykonajSkript(String, boolean), interaktívnaInštancia(), zrušInteraktívnuInštanciu(), režimLadenia(boolean), ObsluhaUdalostí.ladenie(int, String, int), kódPoslednejChyby(), riadokPoslednejChyby(), textPoslednejChyby(), textChyby(int)

interaktivnyRezim

public static void interaktivnyRezim(boolean zapni)

Alias pre interaktívnyRežim.

interaktívnyRežim
```
public static boolean interaktívnyRežim()
```
Zistí stav interaktívneho režimu pre svet. Pozri: Svet.interaktívnyRežim(zapni).

Návratová hodnota:

stav režimu pre svet

interaktivnyRezim
```
public static boolean interaktivnyRezim()
```
Alias pre interaktívnyRežim.

interaktívnaInštancia
```
public static void interaktívnaInštancia(String inštancia)
```
Nastaví alebo zruší aktívnu inštanciu pre interaktívny režim. Keď je aktívna inštancia, tak príkazy odoslané v príkazovom riadku budú spracované len korektne rozpoznanou inštanciou.

Pozor! Táto inštancia ovplyvňuje len príkazy zadávané cez príkazový riadok. Neovplyvňuje príkazy vykonávané ako skript. Aktívnu inštanciu skriptu je možné ovplyvňovať len priamo v skripte riadkami so syntaxou: @«názov inštancie» (nastavenie inštancie) a @ (zrušenie inštancie). Rovnaký príkaz je použiteľný aj v príkazovom riadku interaktívneho režimu a táto metóda poskytuje nástroj na nastavenie aktívnej inštancie programátorom.

Medzi predvolené názvy inštancií patria: svet, podlaha, strop a robot. Ďalšou inštanciou môže byť ľubovoľný pomenovaný robot. Na zrušenie aktívnej inštancie treba zadať namiesto parametra inštancia null alebo zavolať metódu zrušInteraktívnuInštanciu.

Parametre:

inštancia – nová aktívna inštancia interaktívneho režimu alebo null

Pozri tiež:

interaktívnaInštancia(), zrušInteraktívnuInštanciu(), interaktívnyRežim(boolean), režimLadenia(boolean), ObsluhaUdalostí.ladenie(int, String, int)

interaktivnaInstancia

public static void interaktivnaInstancia(String inštancia)

Alias pre interaktívnaInštancia.

interaktívnaInštancia
```
public static String interaktívnaInštancia()
```
Vráti aktívnu inštanciu interaktívneho režimu alebo null.

Návratová hodnota:

aktívna inštancia interaktívneho režimu alebo null

Pozri tiež:

interaktívnaInštancia(String)

interaktivnaInstancia
```
public static String interaktivnaInstancia()
```
Alias pre interaktívnaInštancia.

zrušInteraktívnuInštanciu
```
public static void zrušInteraktívnuInštanciu()
```
Zruší interaktívnu inštanciu.

Pozri tiež:

interaktívnaInštancia(String)

zrusInteraktivnuInstanciu
```
public static void zrusInteraktivnuInstanciu()
```
Alias pre zrušInteraktívnuInštanciu.

kódPoslednejChyby
```
public static int kódPoslednejChyby()
```
Získa kód poslednej chyby, ktorá nastala počas vykonávania príkazov interaktívneho režimu alebo skriptu. Môže ísť o jeden z nasledujúcich kódov:
Poznámka: Tabuľka chýb je v opise metódy Skript.textChyby.
Návratová hodnota:

kód chyby – na získanie podrobností klikni na meno chyby v zozname vyššie

Pozri tiež:

riadokPoslednejChyby(), textPoslednejChyby(), textChyby(int)

kodPoslednejChyby
```
public static int kodPoslednejChyby()
```
Alias pre kódPoslednejChyby.

riadokPoslednejChyby
```
public static int riadokPoslednejChyby()
```
Ak posledná chyba vznikla na konkrétnom riadku skriptu, tak táto metóda vráti číslo tohto riadka.

Návratová hodnota:

číslo riadka, na ktorom vznikla posledná chyba

Pozri tiež:

kódPoslednejChyby(), textPoslednejChyby(), textChyby(int)

textPoslednejChyby
```
public static String textPoslednejChyby()
```
Vráti vysvetľujúci text ku kódu poslednej chyby, ktorá nastala počas vykonávania príkazov interaktívneho režimu alebo skriptu.

Poznámka: Tabuľka chýb je v opise metódy Skript.textChyby.

Návratová hodnota:

text ku kódu chyby

Pozri tiež:

kódPoslednejChyby(), riadokPoslednejChyby(), textChyby(int)

textChyby
```
public static String textChyby(int kódChyby)
```
Vráti vysvetľujúci text ku kódu chyby určenej parametrom kódChyby. Ide o kódy vnútorne definované a používané pri hláseniach o nesprávnych stavoch počas vykonávania príkazov interaktívneho režimu alebo skriptu.

Návratová hodnota:

text ku kódu chyby

Pozri tiež:

kódPoslednejChyby(), riadokPoslednejChyby(), textPoslednejChyby()

poslednáNávratováHodnota
```
public static Object poslednáNávratováHodnota()
```
Získa návratovú hodnotu naposledy vykonaného príkazu interaktívneho režimu alebo skriptu.

Návratová hodnota:

návratová hodnota naposledy vykonaného príkazu

poslednaNavratovaHodnota
```
public static Object poslednaNavratovaHodnota()
```
Alias pre poslednáNávratováHodnota.

formulujChybuSkriptu
```
public static void formulujChybuSkriptu(int kódSkriptu,
                                        String titulokChyby,
                                        int šírkaRiadka)
```
Sformuluje znenie chyby skriptu na základe zadaného kódu chyby a zobrazí dialóg s chybovým hlásením rozdeleným na riadky so zadaným počtom znakov a zadaným titulkom chybového dialógu. Kód chyby je návratová hodnota skriptu (pozri Skript.vykonaj()).

Poznámka: Táto metóda bola pôvodne vytvorená na vnútorné účely – pre skripty tlačidiel a položiek ponuky, ktoré by inak nemali žiadnu možnosť poskytnutia spätnej väzby používateľovi. Tieto skripty stále metódu používajú, ale medzičasom sa metóda stala verejnou a vznikli jej ďalšie verzie.

Parametre:

kódSkriptu – chybový kód, na základe ktorého metóda sformuluje a zobrazí chybové hlásenie v dialógovom okne

titulokChyby – text titulku dialógového okna chyby

šírkaRiadka – počet znakov na jednom riadku chybového hlásenia

formulujChybuSkriptu
```
public static void formulujChybuSkriptu(int kódSkriptu,
                                        String titulokChyby)
```
Sformuluje znenie chyby skriptu na základe zadaného kódu chyby a zobrazí dialóg s chybovým hlásením rozdeleným na riadky so predvoleným počtom znakov (60) a zadaným titulkom chybového dialógu. Kód chyby je návratová hodnota skriptu (pozri Skript.vykonaj()).

Parametre:

kódSkriptu – chybový kód, na základe ktorého metóda sformuluje a zobrazí chybové hlásenie v dialógovom okne

titulokChyby – text titulku dialógového okna chyby

formulujChybuSkriptu
```
public static void formulujChybuSkriptu(int kódSkriptu,
                                        int šírkaRiadka)
```
Sformuluje znenie chyby skriptu na základe zadaného kódu chyby a zobrazí dialóg s chybovým hlásením rozdeleným na riadky so zadaným počtom znakov a predvoleným titulkom chybového dialógu ("Chyba skriptu…"). Kód chyby je návratová hodnota skriptu (pozri Skript.vykonaj()).

Parametre:

kódSkriptu – chybový kód, na základe ktorého metóda sformuluje a zobrazí chybové hlásenie v dialógovom okne

šírkaRiadka – počet znakov na jednom riadku chybového hlásenia

formulujChybuSkriptu
```
public static void formulujChybuSkriptu(int kódSkriptu)
```
Sformuluje znenie chyby skriptu na základe zadaného kódu chyby a zobrazí dialóg s chybovým hlásením rozdeleným na riadky so predvoleným počtom znakov (60) a predvoleným titulkom chybového dialógu ("Chyba skriptu…"). Kód chyby je návratová hodnota skriptu (pozri Skript.vykonaj()).

Parametre:

kódSkriptu – chybový kód, na základe ktorého metóda sformuluje a zobrazí chybové hlásenie v dialógovom okne

zalamujeTexty
```
public static boolean zalamujeTexty()
```
Zistí stav/hodnotu vlastnosti zalamovania textov vnútornej konzoly stropu. Má rovnaký efekt ako keby sme volali metódu strop.zalamujeTexty().

Návratová hodnota:

true ak sú texty stropu presahujúce pravý okraj okna automaticky zalamované; false v opačnom prípade

zalamujTexty
```
public static void zalamujTexty(boolean zalamuj)
```
Nastaví vlastnosť zalamovania textov vnútornej konzoly stropu podľa hodnoty parametra. Má rovnaký efekt ako keby sme volali metódu strop.zalamujTexty(zalamuj).

Parametre:

zalamuj – true ak chceme, aby boli texty stropu presahujúce pravý okraj okna automaticky zalomené; false v opačnom prípade

zalamujTexty
```
public static void zalamujTexty()
```
Zapne zalamovanie textov vnútornej konzoly stropu. Má rovnaký efekt ako keby sme volali metódu strop.zalamujTexty().

nezalamujTexty
```
public static void nezalamujTexty()
```
Vypne zalamovanie textov vnútornej konzoly stropu. Má rovnaký efekt ako keby sme volali metódu strop.nezalamujTexty().

vypíšAktívneSlovo
```
public static void vypíšAktívneSlovo(String identifikátor,
                                     Object... argumenty)
```
Vypíše sériu argumentov v tvare textu na strope ako aktívne slová. Má rovnaký efekt ako keby sme volali metódu strop.vypíšAktívneSlovo(String, Object...).

Parametre:

identifikátor – identifikátor aktívneho slova, pomocou ktorého bude toto slovo odlišované od ostatných aktívnych slov

argumenty – zoznam argumentov rôzneho údajového typu oddelený čiarkami

vypisAktivneSlovo

public static void vypisAktivneSlovo(String identifikátor,
                                     Object... argumenty)

Alias pre vypíšAktívneSlovo.

vypíšAktívneSlová

public static void vypíšAktívneSlová(String identifikátor,
                                     Object... argumenty)

Alias pre vypíšAktívneSlovo.

vypisAktivneSlova

public static void vypisAktivneSlova(String identifikátor,
                                     Object... argumenty)

Alias pre vypíšAktívneSlovo.

bodVAktívnomSlove
```
public static String bodVAktívnomSlove(double x,
                                       double y)
```
Overí, či sa bod identifikovaný zadanými súradnicami nachádza v oblasti niektorého z aktívnych slov. Funguje rovnako ako keby sme volali metódu strop.bodVAktívnomSlove(double, double).

Parametre:

x – x-ová súradnica vyšetrovaného bodu

y – y-ová súradnica vyšetrovaného bodu

Návratová hodnota:

identifikátor aktívneho slova, v ktorom sa nachádza bod so zadanými súradnicami alebo null

bodVAktivnomSlove

public static String bodVAktivnomSlove(double x,
                                       double y)

Alias pre bodVAktívnomSlove.

bodVAktívnomSlove
```
public static String bodVAktívnomSlove(Poloha poloha)
```
Funguje rovnako ako metóda bodVAktívnomSlove, ale namiesto súradníc bodu je zadaný objekt, ktorý je implementáciou rozhrania Poloha.

Parametre:

poloha – poloha vyšetrovaného bodu zadaná prostredníctvom objektu implementujúceho rozhranie Poloha.

Návratová hodnota:

identifikátor aktívneho slova, v ktorom sa nachádza bod so zadanými súradnicami alebo null

bodVAktivnomSlove

public static String bodVAktivnomSlove(Poloha poloha)

Alias pre bodVAktívnomSlove.

myšVAktívnomSlove
```
public static String myšVAktívnomSlove()
```
Overí, či sa súradnice kurzora myši nachádzajú v oblasti niektorého z aktívnych slov. Funguje rovnako ako keby sme volali metódu strop.myšVAktívnomSlove().

Návratová hodnota:

identifikátor aktívneho slova, v ktorom sa nachádza kurzor myši alebo null

mysVAktivnomSlove

public static String mysVAktivnomSlove()

Alias pre myšVAktívnomSlove.

vypíš
```
public static void vypíš(Object... argumenty)
```
Vypíše sériu argumentov v tvare textu na strope. Má rovnaký efekt ako keby sme volali metódu strop.vypíš(Object...) – ďalšie podrobnosti sú v jej opise.

Parametre:

argumenty – zoznam argumentov rôzneho údajového typu oddelený čiarkami

Pozri tiež:

Plátno.vypíš(Object[]), formát

vypis

public static void vypis(Object... argumenty)

Alias pre vypíš.

vypíšRiadok
```
public static void vypíšRiadok(Object... argumenty)
```
Vypíše sériu argumentov v tvare textu na strope a posunie sa na ďalší riadok. Má rovnaký efekt ako keby sme volali metódu strop.vypíšRiadok(Object...).

Parametre:

argumenty – zoznam argumentov rôzneho údajového typu oddelený čiarkami

Pozri tiež:

vypíš(Object[])

vypisRiadok

public static void vypisRiadok(Object... argumenty)

Alias pre vypíšRiadok.

vypíšNa
```
public static void vypíšNa(double x,
                           double y,
                           Object... argumenty)
```
Vypíše sériu argumentov na zadaných súradniciach v tvare textu na strope. Má rovnaký efekt ako keby sme volali metódu strop.vypíšNa(double, double, Object...).

Parametre:

argumenty – zoznam argumentov rôzneho údajového typu oddelený čiarkami

vypisNa

public static void vypisNa(double x,
                           double y,
                           Object... argumenty)

Alias pre vypíšNa.

vypíšRiadokNa
```
public static void vypíšRiadokNa(double x,
                                 double y,
                                 Object... argumenty)
```
Vypíše sériu argumentov na zadaných súradniciach v tvare textu na strope a posunie sa na ďalší riadok. Má rovnaký efekt ako keby sme volali metódu strop.vypíšRiadokNa(double, double, Object...).

Parametre:

argumenty – zoznam argumentov rôzneho údajového typu oddelený čiarkami

vypisRiadokNa

public static void vypisRiadokNa(double x,
                                 double y,
                                 Object... argumenty)

Alias pre vypíšRiadokNa.

píšNa
```
public static void píšNa(double x,
                         double y,
                         Object... argumenty)
```
Vypíše sériu argumentov na zadaných súradniciach v tvare textu na strope. Má rovnaký efekt ako keby sme volali metódu strop.píšNa(double, double, Object...).

Parametre:

argumenty – zoznam argumentov rôzneho údajového typu oddelený čiarkami

pisNa

public static void pisNa(double x,
                         double y,
                         Object... argumenty)

Alias pre píšNa.

píšRiadokNa
```
public static void píšRiadokNa(double x,
                               double y,
                               Object... argumenty)
```
Vypíše sériu argumentov na zadaných súradniciach v tvare textu na strope a posunie sa na ďalší riadok. Má rovnaký efekt ako keby sme volali metódu strop.píšRiadokNa(double, double, Object...).

Parametre:

argumenty – zoznam argumentov rôzneho údajového typu oddelený čiarkami

pisRiadokNa

public static void pisRiadokNa(double x,
                               double y,
                               Object... argumenty)

Alias pre píšRiadokNa.

náhodnéCeléČíslo
```
public static long náhodnéCeléČíslo()
```
Generovanie náhodného celého čísla v celom rozsahu long. (Pozri: Long.MIN_VALUE a Long.MAX_VALUE.)

Poznámka: Táto metóda používa Mersennov twistr z CERNu (1999). Pozri aj poznámku v hlavnom opise tejto triedy.

Návratová hodnota:

vygenerované náhodné celé číslo

nahodneCeleCislo
```
public static long nahodneCeleCislo()
```
Alias pre náhodnéCeléČíslo.

náhodnéCeléČíslo
```
public static long náhodnéCeléČíslo(long hodnota)
```
Generovanie náhodného celého čísla v rozsahu od nula (vrátane) po zadanú hodnotu parametra (vrátane).

Poznámka: Táto metóda používa Mersennov twistr z CERNu (1999). Pozri aj poznámku v hlavnom opise tejto triedy.

Parametre:

hodnota – horná hranica generovania náhodných čísel

Návratová hodnota:

vygenerované náhodné celé číslo

nahodneCeleCislo

public static long nahodneCeleCislo(long hodnota)

Alias pre náhodnéCeléČíslo.

náhodnéCeléČíslo
```
public static long náhodnéCeléČíslo(long min,
                                    long max)
```
Generovanie náhodného celého čísla v zadanom rozsahu. Rozsah je chápaný ako uzavretý interval – ⟨min; max⟩. Ak je spodná hranica väčšia ako horná, tak sú metódou vnútorne prevrátené.

Poznámka: Táto metóda používa Mersennov twistr z CERNu (1999). Pozri aj poznámku v hlavnom opise tejto triedy.

Parametre:

min – spodná hranica generovania náhodných čísel (vrátane)

max – horná hranica generovania náhodných čísel (vrátane)

Návratová hodnota:

vygenerované náhodné celé číslo

nahodneCeleCislo

public static long nahodneCeleCislo(long min,
                                    long max)

Alias pre náhodnéCeléČíslo.

náhodnéReálneČíslo
```
public static double náhodnéReálneČíslo()
```
Generovanie náhodného reálneho čísla v rozsahu od nula (vrátane) po jeden (vynímajúc).

Poznámka: Táto metóda používa Mersennov twistr z CERNu (1999). Pozri aj poznámku v hlavnom opise tejto triedy.

Návratová hodnota:

vygenerované náhodné reálne číslo

nahodneRealneCislo
```
public static double nahodneRealneCislo()
```
Alias pre náhodnéReálneČíslo.

náhodnéReálneČíslo
```
public static double náhodnéReálneČíslo(double hodnota)
```
Generovanie náhodného reálneho čísla v rozsahu od nula (vrátane) po zadanú hodnotu parametra (vynímajúc).

Poznámka: Táto metóda používa Mersennov twistr z CERNu (1999). Pozri aj poznámku v hlavnom opise tejto triedy.

Parametre:

hodnota – horná (nezahrnutá) hranica generovania náhodných čísel

Návratová hodnota:

vygenerované náhodné reálne číslo

nahodneRealneCislo

public static double nahodneRealneCislo(double hodnota)

Alias pre náhodnéReálneČíslo.

náhodnéReálneČíslo
```
public static double náhodnéReálneČíslo(double min,
                                        double max)
```
Generovanie náhodného reálneho čísla v zadanom rozsahu. Zadaný interval je polovične otvorený – ⟨min; max). Ak je spodná hranica väčšia ako horná, tak sú metódou vnútorne prevrátené.

Poznámka: Táto metóda používa Mersennov twistr z CERNu (1999). Pozri aj poznámku v hlavnom opise tejto triedy.

Parametre:

min – spodná hranica generovania náhodných čísel (vrátane)

max – horná hranica generovania náhodných čísel (vynímajúc)

Návratová hodnota:

vygenerované náhodné reálne číslo

nahodneRealneCislo

public static double nahodneRealneCislo(double min,
                                        double max)

Alias pre náhodnéReálneČíslo.

perlin

public static double perlin(double x,
                            double y,
                            double z)

Vráti hodnotu 3D Perlinovho šumu z rozsahu ⟨−1; 1⟩ v bode so zadanými súradnicami.

Upozornenie: Generátor funguje korektne najmä v kladnej podmnožine všetkých troch hodnôt súradníc 3D priestoru. Keďže sa však dajú využiť aj hodnoty generované v zápornej (t. j. pre aspoň jednu zo súradníc zápornú) časti 3D priestoru (hoci neštandardným spôsobom a pri troche experimentovania), nebol vstup súradníc nijako ošetrovaný.

Upozornenie: Ak sú vstupom generátora výhradne (tri) celé čísla, výsledkom je nula. Ak chcete získať „pestrý“ rad hodnôt zariaďte, aby vstupom neboli samé celé čísla. Čím „menej celočíselné“ budú vstupy generátora, tým rôznorodejšie výsledky bude poskytovať.

Podrobnosti o Perlinovom šume:

Perlinov šum je druh gradientového generátora šumu, ktorý vyvinul Ken Perlin v rokoch 1982 – 1983. Generátor vznikol dôsledkom autorovej frustrácie z toho, že vtedajšie počítačom generované obrazy (CGI) vyzerali príliš „strojovo.“ Práca bola zároveň dôsledkom autorovej účasti na vývoji efektov v pracovnej skupine MAGI, ktorá pracovala pre Disneyho štúdium v kontexte produkcie sci-fi filmu Tron (1982). V roku 1997 (15 rokov po vydaní filmu Tron) získal Ken Perlin za svoj technický prínos, ktorý vznikol vytvorením tohto algoritmu cenu filmovej akadémie (Academy Awards u nás známej pod ľudovým pomenovaním Oskar).

Dobrý generátor (pseudo)náhodných čísel generuje také hodnoty, ktoré nevykazujú známky rozpoznateľného vzoru (čiže naoko vzájomne nesúvisia). Takáto náhodnosť však nemusí pôsobiť prirodzene, najmä keď potrebujeme generovať prírodne pôsobiaci vzhľad ako sú oblaky, krajinné reliéfy alebo textúry povrchov ako je mramor a podobne. Perlinov generátor dokáže generovať hodnoty ústiace do organickejšieho vzhľadu, pretože generovaná sekvencia pseudonáhodných čísel je „hladšia“ než sekvencie, ktoré generuje „bežný“ generátor.

Algoritmus použitý v tomto rámci generuje hodnoty šumu v trojrozmernom priestore. Perlinov šum však nemusí byť len troj- alebo dvojrozmerný. Vo všeobecnosti môže byť použitý na n rozmerov. Aj keď je programovací rámec zameraný na dvojrozmernú grafiku, bolo výhodnejšie použiť trojrozmerný priestor, aby bol generátor širšie využiteľný, napríklad na mapovanie hodnôt v trojsúradnicovom farebnom priestore RGB.

Táto metóda generuje predvolené hodnoty šumu podľa zadaných súradníc. Jemnejšie výsledky sa dajú dosiahnuť použitím metódy perlin(x, y, z, početOktáv) (alebo jej klonu), treba však upozorniť na to, že so zvyšujúcim počtom oktáv sa činnosť generátora výrazne spomaľuje. Generátor preto nie je vhodný na generovanie textúr v reálnom čase.

Zdroje:

Shiffman, Daniel: Perlin noise. Khan Academy. 2012. Citované: 18. januára 2020.
Biagioli, Adrian: A slightly modified implementation of Ken Perlin’s improved noise that allows for tiling the noise arbitrarily. 9. august 2014. Citované: 10. marca 2019.
Zucker, Matt: The Perlin noise math FAQ (glaringly outdated). 2001. Citované: 24. januára 2020.
Quilez, Inigo: Gradient noise derivatives. At its home page about fractals, computer graphics, mathematics, shaders, demoscene and more. 2017. Citované: 24. januára 2020.
Quilez, Inigo: Noise – Gradient – 3D – Deriv. At Shadertoy. 14. máj 2017. Citované: 24. januára 2020.
Ken Perlin’s homepage. Citované: 10. marca 2019.

Príklad:

import knižnica.*;

public class PerlinovŠum extends GRobot
{
    // Inštancia obrázka, ktorá bude slúžiť na uchovanie aktuálne
    // vygenerovanej verzie šumu (pozri súkromnú metódu prekresliŠum nižšie).
    private Obrázok o = new Obrázok(600, 600);

    // Parametre generátora (pozri súkromnú metódu prekresliŠum nižšie):
    //      k – počet (index) generovaných oktáv šumu;
    //      l – prepínanie štyroch rôznych verzií generovania:
    //          1 – použije sa len premenná dr a to ako úroveň šedej;
    //          2 – to isté ako 1, ale použije sa premenná dg;
    //          3 – to isté ako 1, ale použije sa premenná db;
    //          … – premenné dr, dg, db budú použité na určenie farebných
    //              zložiek r, g, b každého bodu generovaného šumu.
    private int k = 0, l = 0;

    // Aktuálne posunutie generovaného šumu.
    private double Δx = 0, Δy = 0;
    
    // Konštruktor.
    private PerlinovŠum()
    {
        super(602, 602); // (rozmer plátna 602 × 602 bodov)

        // Nastavenia sveta:
        Svet.farbaPozadia(snehová);
        Svet.farbaTextu(biela);
        Svet.nekresli();

        // Nastavenie kreslenia vypĺňaných tvarov na strop žltou farbou
        // (to sa použije na kreslenie orientačného prvku znázorňujúceho
        // aktuálne posunutie generátora Δx, Δy):
        kresliNaStrop();
        vypĺňajTvary();
        farba(žltá);

        // Prekreslenie šumu a zbalenie okna:
        prekresliŠum();
        Svet.zbaľ();
    }
    
    // Súkromná metóda na prekreslenie generovaného šumu:
    private void prekresliŠum()
    {
        Svet.vymažTexty();
        Svet.vypíš(k, l, '[', Δx, ',', Δy, ']');

        // V tomto cykle sa generuje šum vo štvorci 600 × 600 do obrázka
        // „o“ (čiže o jeden bod menej z každého okraja plátna) podľa
        // parametrov „k“ a „l“ (pozri vyššie).

        for (int j = -300; j <= 300; ++j) for (int i = -300; i <= 300; ++i)
        {
            // Najprv sa do premenných „a“ a „b“ prepočítajú súradnice
            // použité na získanie hodnoty šumu v určitom bode (treba si
            // uvedomiť, že každý generátor pseudonáhodných čísiel je
            // v skutočnosti funkcia so stálym tvarom – preto „pseudo-“
            // náhodné čísla; ibaže to obvykle nevidíme, pretože používame
            // premenlivé semienko na „zamiešanie“ generátora; obvykle
            // systémový čas).
            double a = (Δx + i + 300.0) / 100.0;
            double b = (Δy + j + 300.0) / 100.0;

            // Potom vygenerujeme tri rôzne hodnoty šumu. Keďže v tomto
            // programovacom rámci je použitý trojrozmerný Perlinov šum,
            // vygenerujeme každú z troch hodnôt z rôznej plochy 3D priestoru.
            // Na zjednodušenie zoberieme kolmé plochy – parametre „a“ a „b“
            // jednoducho vložíme vždy do inej kombinácie súradníc „perlina.“

            // V našom prípade by sme výsledok generátora museli upravovať
            // na polovičný rozsah napríklad takto:
            // double dr = (1.0 + Svet.perlin(b, 0, a, 1 + k)) / 2.0;
            // double dg = (1.0 + Svet.perlin(0, a, b, 1 + k)) / 2.0;
            // double db = (1.0 + Svet.perlin(a, b, 0, 1 + k)) / 2.0;

            // Namiesto toho použijeme verziu metódy polPerlina:
            double dr = Svet.polPerlina(b, 0, a, 1 + k);
            double dg = Svet.polPerlina(0, a, b, 1 + k);
            double db = Svet.polPerlina(a, b, 0, 1 + k);

            // *** Kópia informácií o význame atribútov „k“ a „l.“ ***
            // 
            // k – počet (index) generovaných oktáv šumu;
            // l – prepínanie štyroch rôznych verzií generovania:
            //     1 – použije sa len premenná dr a to ako úroveň šedej;
            //     2 – to isté ako 1, ale použije sa premenná dg;
            //     3 – to isté ako 1, ale použije sa premenná db;
            //     … – premenné dr, dg, db budú použité na určenie farebných
            //         zložiek r, g, b každého bodu generovaného šumu.
            // 
            // *** Kópia informácií o význame atribútov „k“ a „l.“ ***

            int rgb; switch (l)
            {
            case 1:
                rgb = 0xff000000 | ((int)(dr * 255) << 16) |
                    ((int)(dr * 255) << 8) | (int)(dr * 255);
                break;

            case 2:
                rgb = 0xff000000 | ((int)(dg * 255) << 16) |
                    ((int)(dg * 255) << 8) | (int)(dg * 255);
                break;

            case 3:
                rgb = 0xff000000 | ((int)(db * 255) << 16) |
                    ((int)(db * 255) << 8) | (int)(db * 255);
                break;

            default:
                rgb = 0xff000000 | ((int)(dr * 255) << 16) |
                    ((int)(dg * 255) << 8) | (int)(db * 255);
                break;
            }

            o.prepíšBod(i, j, rgb);
        }

        // Nakoniec nakreslíme orientačný prvok na znázornenie aktuálnej
        // polohy posunutia generátora (parametre kreslenia sú nastavené
        // v konštruktore):
        Svet.vymažGrafiku();
        podlaha.obrázok(o);
        skočNa(Δx / 10, Δy / 10);
        krúžok();
        Svet.prekresli();
    }
    
    // Reakcia na kliknutie ľubovoľným tlačidlom myši.
    @Override public void klik()
    {
        if (ÚdajeUdalostí.tlačidloMyši(ĽAVÉ))
        {
            // Ak bolo kliknuté ľavým, tak upravíme parameter „k“ tak,
            // aby sa jeho hodnota pohybovala (cyklicky – po
            // každom kliku) v rozmedzí 0 – 6:
            ++k;
            k %= 7;
        }
        else
        {
            // Ak bolo kliknuté ľubovoľným iným tlačidlom, tak upravíme
            // parameter „l“ tak, aby sa jeho hodnota pohybovala
            // (cyklicky – po každom kliku) v rozmedzí 0 – 3:
            ++l;
            l %= 4;
        }

        // Prekreslíme šum:
        prekresliŠum();
    }
    
    // Počiatočná poloha myši používaná na vypočítanie rozdielu určujúceho
    // mieru posunutia generovaného šumu.
    private Bod poloha1 = null;

    // Reakcia na stlačenie ľubovoľného tlačidla myši.
    @Override public void stlačenieTlačidlaMyši()
    {
        // Uloženie počiatočnej polohy.
        poloha1 = ÚdajeUdalostí.polohaMyši();
    }

    // Reakcia na pohyb kurzora myši počas držania
    // ľubovoľného tlačidla myši (ťahania).
    @Override public void ťahanieMyšou()
    {
        // Ak je počiatočná poloha neprázdna, […]
        if (null != poloha1)
        {
            // […] tak prevezmeme aktuálnu polohu (pre nás koncovú), […]
            Bod poloha2 = ÚdajeUdalostí.polohaMyši();

            // […] vypočítame z oboch polôh rozdiel,
            // o ktorý sa šum posunie, […]
            Δx += poloha2.polohaX() - poloha1.polohaX();
            Δy += poloha2.polohaY() - poloha1.polohaY();

            // […] uložíme aktuálnu polohu ako novú počiatočnú polohu […]
            poloha1 = poloha2;

            // […] a prekreslíme šum.
            prekresliŠum();
        }
    }

    // Reakcia na uvoľnenie ľubovoľného tlačidla myši.
    @Override public void uvoľnenieTlačidlaMyši()
    {
        // Vyprázdnenie počiatočnej polohy.
        poloha1 = null;
    }
    
    // Hlavná metóda.
    public static void main(String[] args)
    {
        new PerlinovŠum();
    }
}

Výsledok:

Jedna oktáva farebnej verzie generovaného šumu.

Sedem oktáv farebnej verzie generovaného šumu.

Parametre:: x – x-ová súradnica priestoru šumu; y – y-ová súradnica priestoru šumu; z – z-ová súradnica priestoru šumu
Návratová hodnota:: hodnota Perlinovho šumu (v rozsahu ⟨−1; 1⟩) v zadanom bode
Pozri tiež:: perlin(double, double, double, int), perlin(double, double, double, int, double), polPerlina(double, double, double), polPerlina(double, double, double, int), polPerlina(double, double, double, int, double), opakovaniePerlina(), opakovaniePerlina(int)

perlin
```
public static double perlin(double x,
                            double y,
                            double z,
                            int početOktáv)
```
Vráti hodnotu 3D Perlinovho šumu z rozsahu ⟨−1; 1⟩ v bode so zadanými súradnicami a so zadaným počtom obsiahnutých oktáv. (Metóda používa predvolenú hodnotu stability 0.5.)

Podrobnosti o Perlinovom šume nájdete v opise metódy perlin(x, y, z).

Táto metóda umožňuje generovať jemnejšie výsledky pre hodnoty Perlinovho šumu, treba však upozorniť na to, že so zvyšujúcim počtom oktáv sa činnosť generátora výrazne spomaľuje. Generátor preto nie je vhodný na generovanie textúr v reálnom čase.

Parametre:

x – x-ová súradnica priestoru šumu

y – y-ová súradnica priestoru šumu

z – z-ová súradnica priestoru šumu

početOktáv – počet generovaných oktáv šumu – vyššia hodnota generuje „jemnejšie“ hodnoty (akoby výsledky s vyšším rozlíšením)

Návratová hodnota:

hodnota Perlinovho šumu (v rozsahu ⟨−1; 1⟩) v zadanom bode

Pozri tiež:

perlin(double, double, double), perlin(double, double, double, int, double), polPerlina(double, double, double), polPerlina(double, double, double, int), polPerlina(double, double, double, int, double), opakovaniePerlina(), opakovaniePerlina(int)

perlin
```
public static double perlin(double x,
                            double y,
                            double z,
                            int početOktáv,
                            double stabilita)
```
Vráti hodnotu 3D Perlinovho šumu z rozsahu ⟨−1; 1⟩ v bode so zadanými súradnicami a so zadaným počtom obsiahnutých oktáv.

Podrobnosti o Perlinovom šume nájdete v opise metódy perlin(x, y, z).

Táto metóda umožňuje generovať jemnejšie výsledky pre hodnoty Perlinovho šumu, treba však upozorniť na to, že so zvyšujúcim počtom oktáv sa činnosť generátora výrazne spomaľuje. Generátor preto nie je vhodný na generovanie textúr v reálnom čase.

Parametre:

x – x-ová súradnica priestoru šumu

y – y-ová súradnica priestoru šumu

z – z-ová súradnica priestoru šumu

početOktáv – počet generovaných oktáv šumu – vyššia hodnota generuje „jemnejšie“ hodnoty (akoby výsledky s vyšším rozlíšením)

stabilita – hodnota vzťahujúca sa k rozbiehavosti generátora počas generovania vyšších oktáv

Návratová hodnota:

hodnota Perlinovho šumu (v rozsahu ⟨−1; 1⟩) v zadanom bode

Pozri tiež:

perlin(double, double, double), perlin(double, double, double, int), polPerlina(double, double, double), polPerlina(double, double, double, int), polPerlina(double, double, double, int, double), opakovaniePerlina(), opakovaniePerlina(int)

polPerlina
```
public static double polPerlina(double x,
                                double y,
                                double z)
```
Vráti hodnotu polovičného 3D Perlinovho šumu z rozsahu ⟨0; 1⟩ v bode so zadanými súradnicami.

Podrobnosti o Perlinovom šume nájdete v opise metódy perlin(x, y, z).

Parametre:

x – x-ová súradnica priestoru šumu

y – y-ová súradnica priestoru šumu

z – z-ová súradnica priestoru šumu

Návratová hodnota:

hodnota polovičného Perlinovho šumu (v rozsahu ⟨0; 1⟩) v zadanom bode

Pozri tiež:

perlin(double, double, double), perlin(double, double, double, int), perlin(double, double, double, int, double), polPerlina(double, double, double, int), polPerlina(double, double, double, int, double), opakovaniePerlina(), opakovaniePerlina(int)

polPerlina
```
public static double polPerlina(double x,
                                double y,
                                double z,
                                int početOktáv)
```
Vráti hodnotu polovičného 3D Perlinovho šumu z rozsahu ⟨0; 1⟩ v bode so zadanými súradnicami a so zadaným počtom obsiahnutých oktáv. (Metóda používa predvolenú hodnotu stability 0.5.)

Podrobnosti o Perlinovom šume nájdete v opise metódy perlin(x, y, z).

Táto metóda umožňuje generovať jemnejšie výsledky pre hodnoty Perlinovho šumu, treba však upozorniť na to, že so zvyšujúcim počtom oktáv sa činnosť generátora výrazne spomaľuje. Generátor preto nie je vhodný na generovanie textúr v reálnom čase.

Parametre:

x – x-ová súradnica priestoru šumu

y – y-ová súradnica priestoru šumu

z – z-ová súradnica priestoru šumu

početOktáv – počet generovaných oktáv šumu – vyššia hodnota generuje „jemnejšie“ hodnoty (akoby výsledky s vyšším rozlíšením)

Návratová hodnota:

hodnota polovičného Perlinovho šumu (v rozsahu ⟨0; 1⟩) v zadanom bode

Pozri tiež:

perlin(double, double, double), perlin(double, double, double, int), perlin(double, double, double, int, double), polPerlina(double, double, double), polPerlina(double, double, double, int, double), opakovaniePerlina(), opakovaniePerlina(int)

polPerlina
```
public static double polPerlina(double x,
                                double y,
                                double z,
                                int početOktáv,
                                double stabilita)
```
Vráti hodnotu polovičného 3D Perlinovho šumu z rozsahu ⟨0; 1⟩ v bode so zadanými súradnicami a so zadaným počtom obsiahnutých oktáv.

Podrobnosti o Perlinovom šume nájdete v opise metódy perlin(x, y, z).

Táto metóda umožňuje generovať jemnejšie výsledky pre hodnoty Perlinovho šumu, treba však upozorniť na to, že so zvyšujúcim počtom oktáv sa činnosť generátora výrazne spomaľuje. Generátor preto nie je vhodný na generovanie textúr v reálnom čase.

Parametre:

x – x-ová súradnica priestoru šumu

y – y-ová súradnica priestoru šumu

z – z-ová súradnica priestoru šumu

početOktáv – počet generovaných oktáv šumu – vyššia hodnota generuje „jemnejšie“ hodnoty (akoby výsledky s vyšším rozlíšením)

stabilita – hodnota vzťahujúca sa k rozbiehavosti generátora počas generovania vyšších oktáv

Návratová hodnota:

hodnota polovičného Perlinovho šumu (v rozsahu ⟨0; 1⟩) v zadanom bode

Pozri tiež:

perlin(double, double, double), perlin(double, double, double, int), perlin(double, double, double, int, double), polPerlina(double, double, double), polPerlina(double, double, double, int), opakovaniePerlina(), opakovaniePerlina(int)

opakovaniePerlina
```
public static int opakovaniePerlina()
```
Vráti hodnotu opakovania vzoru generátora Perlinovho šumu. Hodnoty menšie alebo rovné 0 znamenajú nekonečný vzor, čo je predvolený stav.

Podrobnosti o Perlinovom šume nájdete v opise metódy perlin(x, y, z).

Návratová hodnota:

hodnota opakovania vzoru generátora Perlinovho šumu

Pozri tiež:

perlin(double, double, double), perlin(double, double, double, int), perlin(double, double, double, int, double), polPerlina(double, double, double), polPerlina(double, double, double, int), polPerlina(double, double, double, int, double), opakovaniePerlina(int)

opakovaniePerlina
```
public static void opakovaniePerlina(int opakovanie)
```
Nastaví novú hodnotu opakovania vzoru generátora Perlinovho šumu. Hodnoty menšie alebo rovné 0 (čo je predvolený stav) znamenajú nekonečný vzor.

Podrobnosti o Perlinovom šume nájdete v opise metódy perlin(x, y, z).

Parametre:

opakovanie – nová hodnota opakovania vzoru generátora Perlinovho šumu

Pozri tiež:

perlin(double, double, double), perlin(double, double, double, int), perlin(double, double, double, int, double), polPerlina(double, double, double), polPerlina(double, double, double, int), polPerlina(double, double, double, int, double), opakovaniePerlina()

textyDoSchránky
```
public static boolean textyDoSchránky()
```
Vloží do schránky všetky texty vypísané na vnútorných konzolách podlahy a stropu.

Návratová hodnota:

true ak bola operácia úspešná

Pozri tiež:

Schránka.text(String)

textyDoSchranky

public static boolean textyDoSchranky()

Alias pre textyDoSchránky.

textDoSchránky

public static boolean textDoSchránky()

Alias pre textyDoSchránky.

textDoSchranky

public static boolean textDoSchranky()

Alias pre textyDoSchránky.

textyDoSchránky
```
public static boolean textyDoSchránky(boolean lenOznačené)
```
Vloží do schránky buď všetky texty vypísané na vnútorných konzolách podlahy a stropu, alebo len označené časti – v závislosti od hodnoty parametra lenOznačené.

Parametre:

lenOznačené – ak je hodnota tohto parametra rovná true, tak metóda skopíruje schránky len označené texty konzol, inak sa správa rovnako ako metóda textyDoSchránky()

Návratová hodnota:

true ak bola operácia úspešná

Pozri tiež:

Schránka.text(String)

textyDoSchranky

public static boolean textyDoSchranky(boolean lenOznačené)

Alias pre textyDoSchránky.

textDoSchránky

public static boolean textDoSchránky(boolean lenOznačené)

Alias pre textyDoSchránky.

textDoSchranky

public static boolean textDoSchranky(boolean lenOznačené)

Alias pre textyDoSchránky.

obrázokDoSchránky
```
public static boolean obrázokDoSchránky()
```
Vloží obrázok (grafiku) sveta do schránky. Grafika sveta je zlúčením grafík podlahy, robotov, stropu a textov vypísaných na vnútorné konzoly oboch plátien.

Upozornenie: Obrázok je uchovaný v schránke len počas činnosti aplikácie robota. Po zatvorení okna sveta, je obrázok zo schránky odstránený.

Návratová hodnota:

true ak bola operácia úspešná

Pozri tiež:

Schránka.obrázok(Image)

obrazokDoSchranky
```
public static boolean obrazokDoSchranky()
```
Alias pre obrázokDoSchránky.

grafikaDoSchránky
```
public static boolean grafikaDoSchránky()
```
Alias pre obrázokDoSchránky.

grafikaDoSchranky
```
public static boolean grafikaDoSchranky()
```
Alias pre obrázokDoSchránky.

ťahajSúbory
```
public static boolean ťahajSúbory(int ako,
                                  String... súbory)
```
Vytvorí operáciu ťahania súborov. Ide o akciu ťahania jedného alebo viacerých súborov z aktuálnej aplikácie – aktuálneho sveta. Operácia je implementovaná tak, že si všetky potrebné informácie zisťuje sama, takže všetko, čo treba zadať je: 1. typ akcie, čo môže byť:
- COPY – kopírovanie,
- COPY_OR_MOVE – kopírovanie alebo presun,
- LINK – vytvorenie prepojenia (odkazu…),
- MOVE – presun
- alebo NONE – žiadna akcia (ťahanie nebude fungovať)
Tip: Akcie by mali byť importované z triedy TransferHandler, ale jednotka (1) znamená „kopírovať“ a dá sa použiť, ak si nie ste istí, akú akciu máte použiť.

a 2. zoznam súborov (názvy s prípadnou cestou; parameter: súbory).

Upozornenie: Na správne fungovanie potrebuje spustenie tejto operácie udalosť myši. Táto metóda automaticky používa poslednú zapamätanú udalosť myši rámca. Ideálne je, aby to bola udalosť stlačenia tlačidla myši. Ak použijete túto metódu v reakcii na stlačenie tlačidla myši, nemali by ste zaznamenať žiadne problémy pri jej používaní.

Varovanie! Počas testovania nám z neznámeho dôvodu nefungovalo ťahanie s inou akciou než kopírovanie. Môžete skúsiť, či vám nebude fungovať aj iná akcia, ale nám to nešlo…
Parametre:

ako – typ akcie ťahania súborov – pozri vyššie

súbory – zoznam súborov, ktoré majú byť ťahané

Návratová hodnota:

false ak ťahanie nie je možné z dôvodu chýbajúcej udalosti myši, inak true

tahajSubory

public static void tahajSubory(int ako,
                               String... súbory)

Alias pre ťahajSúbory.

ťahajSúbory
```
public static boolean ťahajSúbory(String... súbory)
```
Vytvorí operáciu ťahania súborov. Toto je odľahčená verzia metódy ťahajSúbory(akcia, súbory). Do parametra akcia dopĺňa hodnotu COPY – kopírovanie. Ďalšie podrobnosti nájdete v opise širšej verzie tejto metódy.

Parametre:

súbory – zoznam súborov, ktoré majú byť ťahané

Návratová hodnota:

false ak ťahanie nie je možné z dôvodu chýbajúcej udalosti myši, inak true

tahajSubory

public static void tahajSubory(String... súbory)

Alias pre ťahajSúbory.

šírkaObrázka
```
public static int šírkaObrázka(String súbor)
```
Zistí šírku zadaného obrázka.

Táto metóda spôsobí prečítanie obrázka zo súboru a jeho uchovanie vo vnútornej pamäti sveta. Obrázok tam zostáva, pretože je chápaný ako zdroj. Môže však byť v prípade potreby (napríklad ak sa obsah súboru na disku zmenil) z vnútornej pamäte odstránený metódou Svet.uvoľni(názovZdroja). (Táto informácia je platná pre všetky metódy pracujúce s obrázkami alebo zvukmi, ktoré prijímajú názov súboru ako parameter.)

Parametre:

súbor – názov súboru s obrázkom

Návratová hodnota:

šírka zadaného obrázka

Výnimky:

GRobotException – ak súbor s obrázkom nebol nájdený

Pozri tiež:

priečinokObrázkov(String)

sirkaObrazka

public static int sirkaObrazka(String súbor)

Alias pre šírkaObrázka.

výškaObrázka
```
public static int výškaObrázka(String súbor)
```
Zistí výšku zadaného obrázka.

Táto metóda spôsobí prečítanie obrázka zo súboru a jeho uchovanie vo vnútornej pamäti sveta. Obrázok tam zostáva, pretože je chápaný ako zdroj. Môže však byť v prípade potreby (napríklad ak sa obsah súboru na disku zmenil) z vnútornej pamäte odstránený metódou Svet.uvoľni(názovZdroja). (Táto informácia je platná pre všetky metódy pracujúce s obrázkami alebo zvukmi, ktoré prijímajú názov súboru ako parameter.)

Parametre:

súbor – názov súboru s obrázkom

Návratová hodnota:

výška zadaného obrázka

Výnimky:

GRobotException – ak súbor s obrázkom nebol nájdený

Pozri tiež:

priečinokObrázkov(String)

vyskaObrazka

public static int vyskaObrazka(String súbor)

Alias pre výškaObrázka.

priečinokObrázkov
```
public static void priečinokObrázkov(String priečinok)
```
Ak sú všetky obrázky uložené v spoločnom priečinku, môžeme pre nich touto metódou nastaviť zdrojový priečinok čítania. Priečinok by sa mal nachádzať v hlavnom priečinku projektu alebo by k nemu mala viesť systémovo nezávislá relatívna cesta. Zadaním prázdneho reťazca alebo hodnoty null používanie priečinka zrušíme.

Cesta je používaná pri čítaní všetkých obrázkov, okrem čítania z archívu. Čiže napríklad pri čítaní metódou čítaj(súbor), vypĺňaní metódami GRobot.vyplňTvar(tvar, súbor), GRobot.vyplňOblasť(oblasť, súbor) (atď.), kreslení metódami GRobot.obrázok(súbor), Plátno.obrázok(súbor) (atď.), ale aj pri nastavovaní vlastného tvaru robota GRobot.vlastnýTvar(súbor) a v mnohých iných situáciách (pozri zoznam odkazov nižšie – nemusí byť úplný).

Parametre:

priečinok – názov priečinka, relatívna cesta, prípadne prázdny reťazec alebo null

Pozri tiež:

priečinokObrázkov(), GRobot.obrázok(String), GRobot.obrázok(String, double), GRobot.obrázok(String, double, double), GRobot.obrázok(String, double, double, double), GRobot.obrázok(String, int), GRobot.obrázok(String, int, double), GRobot.obrázok(String, int, double, double), GRobot.obrázok(String, int, double, double, double), GRobot.vyplňOblasť(Area, String), GRobot.vlastnýTvar(String), GRobot.vlastnýTvar(String, boolean), obrázok(String), vyplň(String), ikona(String), zobrazUvodnuObrazovku(String), šírkaObrázka(String), výškaObrázka(String), čítajObrázky(Object[]), čítajObrázky(String[]), čítajObrázok(String), Plátno.obrázok(String), Plátno.obrázok(double, double, String), Plátno.obrázok(Poloha, String), Plátno.vyplň(String), Obrázok.priečinokObrázkov(String), Obrázok.čítaj(String), Obrázok.vyplň(Shape, String), Obrázok.kresli(String), Obrázok.kresli(double, double, String), Obrázok.kresli(Poloha, String), Obrázok.vyplň(String), Oblasť.vyplň(String), Oblasť.vyplň(GRobot, String), PoložkaPonuky.ikona(String), KontextováPoložka.ikona(String)

priecinokObrazkov

public static void priecinokObrazkov(String priečinok)

Alias pre priečinokObrázkov.

priečinokObrázkov
```
public static String priečinokObrázkov()
```
Vráti reťazec s aktuálnym priečinkom, z ktorého sú obrázky prečítané. Reťazec je obohatený o oddeľovací znak priečinkov java.io.File.separatorChar (/ alebo \ – záleží na type operačného systému), ktorý automaticky pridáva metóda priečinokObrázkov(priečinok). Rovnako všetky oddeľovacie znaky priečinkov v relatívnej ceste sú nahradené podľa typu operačného systému.

Návratová hodnota:

aktuálny priečinok, z ktorého sú obrázky prečítané

Pozri tiež:

priečinokObrázkov(String), GRobot.obrázok(String), GRobot.obrázok(String, double), GRobot.obrázok(String, double, double), GRobot.obrázok(String, double, double, double), GRobot.obrázok(String, int), GRobot.obrázok(String, int, double), GRobot.obrázok(String, int, double, double), GRobot.obrázok(String, int, double, double, double), GRobot.vyplňOblasť(Area, String), GRobot.vlastnýTvar(String), GRobot.vlastnýTvar(String, boolean), obrázok(String), vyplň(String), ikona(String), zobrazUvodnuObrazovku(String), šírkaObrázka(String), výškaObrázka(String), čítajObrázky(Object[]), čítajObrázky(String[]), čítajObrázok(String), Plátno.obrázok(String), Plátno.obrázok(double, double, String), Plátno.obrázok(Poloha, String), Plátno.vyplň(String), Obrázok.priečinokObrázkov(), Obrázok.čítaj(String), Obrázok.vyplň(Shape, String), Obrázok.kresli(String), Obrázok.kresli(double, double, String), Obrázok.kresli(Poloha, String), Obrázok.vyplň(String), Oblasť.vyplň(String), Oblasť.vyplň(GRobot, String), PoložkaPonuky.ikona(String), KontextováPoložka.ikona(String)

priecinokObrazkov

public static String priecinokObrazkov()

Alias pre priečinokObrázkov.

čítajObrázky
```
public static void čítajObrázky(Object... súbory)
```
Táto metóda slúži na čítanie zadaných obrázkov do vnútornej pamäte sveta (napríklad pri štarte aplikácie). Svet ukladá do vnútornej pamäte každý obrázok, s ktorým sa pracovalo (ak tam už nie je). Z nej môže byť v prípade potreby (napríklad ak sa obsah súboru na disku zmenil) odstránený metódou Svet.uvoľni(názovZdroja). Táto metóda číta súbory s obrázkami vopred a tým môže prispieť k plynulejšej činnosti aplikácie po štarte (čas štartu sa predĺži, ale keďže súbory už nemusia byť čítané počas jej činnosti, pracuje plynulejšie).

Parametre:

súbory – ľubovoľný počet reťazcov označujúcich súbory

Výnimky:

GRobotException – ak niektorý súbor nebol nájdený; spracovanie sa v okamihu vzniku výnimky neskončí a vrhnutá je len posledná vzniknutá výnimka, to znamená, že všetky predchádzajúce výnimky sú ignorované

Pozri tiež:

priečinokObrázkov(String)

citajObrazky

public static void citajObrazky(Object... súbory)

Alias pre čítajObrázky.

prečítajObrázky

public static void prečítajObrázky(Object... súbory)

Alias pre čítajObrázky.

precitajObrazky

public static void precitajObrazky(Object... súbory)

Alias pre čítajObrázky.

čítajObrázky
```
public static void čítajObrázky(String[] súbory)
```
Táto metóda slúži na čítanie zadaných obrázkov do vnútornej pamäte sveta (napríklad pri štarte aplikácie). Svet ukladá do vnútornej pamäte ukladá každý obrázok, s ktorým sa pracovalo (ak tam už nie je). Z nej môže byť v prípade potreby (napríklad ak sa obsah súboru na disku zmenil) odstránený metódou Svet.uvoľni(názovZdroja). Táto metóda číta súbory s obrázkami vopred a tým môže prispieť k plynulejšej činnosti aplikácie po štarte (čas štartu sa predĺži, ale keďže súbory už nemusia byť čítané počas jej činnosti, pracuje plynulejšie).

Parametre:

súbory – pole reťazcov označujúcich súbory

Výnimky:

GRobotException – ak niektorý súbor nebol nájdený; spracovanie sa v okamihu vzniku výnimky neskončí a vrhnutá je len posledná vzniknutá výnimka, to znamená, že všetky predchádzajúce výnimky sú ignorované

Pozri tiež:

priečinokObrázkov(String)

citajObrazky

public static void citajObrazky(String[] súbory)

Alias pre čítajObrázky.

prečítajObrázky

public static void prečítajObrázky(String[] súbory)

Alias pre čítajObrázky.

precitajObrazky

public static void precitajObrazky(String[] súbory)

Alias pre čítajObrázky.

čítajObrázok
```
public static Image čítajObrázok(String súbor)
```
Prečíta do vnútornej pamäte sveta zadaný obrázok zo súboru a vráti ho v objekte typu Image. Obrázok nie je zobrazený. Podobnú úlohu plní metóda Svet.čítajObrázky(Object... súbory), ale pomocou nej nie je možné získať objekt typu Image na ďalšie spracovanie. Obrázok môže byť v prípade potreby (napríklad ak sa obsah súboru na disku zmenil) z vnútornej pamäte odstránený metódou Svet.uvoľni(názovZdroja).

Parametre:

súbor – názov súboru s obrázkom

Návratová hodnota:

obrázok v objekte typu Image

Výnimky:

GRobotException – ak súbor s obrázkom nebol nájdený

Pozri tiež:

Obrázok.čítaj(String), priečinokObrázkov(String)

citajObrazok

public static Image citajObrazok(String súbor)

Alias pre čítajObrázok.

prečítajObrázok

public static Image prečítajObrázok(String súbor)

Alias pre čítajObrázok.

precitajObrazok

public static Image precitajObrazok(String súbor)

Alias pre čítajObrázok.

obrázok
```
public static void obrázok(String súbor)
```
Nakreslí v strede podlahy zadaný obrázok. Má rovnaký efekt ako keby sme volali metódu podlaha.obrázok(String). Napríklad:
```
Svet.obrázok("obrázok.png");
```
Parametre:

súbor – názov súboru s obrázkom, ktorý má byť vykreslený

Pozri tiež:

priečinokObrázkov(String)

obrazok

public static void obrazok(String súbor)

Alias pre obrázok.

obrázok
```
public static void obrázok(double x,
                           double y,
                           String súbor)
```
Nakreslí na zadaných súradniciach na podlahe obrázok. Má rovnaký efekt ako keby sme volali metódu podlaha.obrázok(x, y, súbor).

Parametre:

x – x-ová súradnica polohy obrázka

y – y-ová súradnica polohy obrázka

súbor – názov súboru s obrázkom, ktorý má byť vykreslený

Pozri tiež:

priečinokObrázkov(String)

obrazok

public static void obrazok(double x,
                           double y,
                           String súbor)

Alias pre obrázok.

obrázok
```
public static void obrázok(Poloha objekt,
                           String súbor)
```
Nakreslí na súradniciach zadaného objektu na podlahe obrázok. Má rovnaký efekt ako keby sme volali metódu podlaha.obrázok(objekt, súbor).

Parametre:

objekt – objekt určujúci polohu kreslenia obrázka

súbor – názov súboru s obrázkom, ktorý má byť vykreslený

Pozri tiež:

priečinokObrázkov(String)

obrazok

public static void obrazok(Poloha objekt,
                           String súbor)

Alias pre obrázok.

obrázok
```
public static void obrázok(Image obrázok)
```
Nakreslí v strede podlahy zadaný obrázok. Má rovnaký efekt ako keby sme volali metódu podlaha.obrázok(obrázok).

Parametre:

obrázok – obrázok, ktorý má byť vykreslený

obrazok

public static void obrazok(Image obrázok)

Alias pre obrázok.

obrázok
```
public static void obrázok(double x,
                           double y,
                           Image obrázok)
```
Nakreslí na zadaných súradniciach na podlahe obrázok. Má rovnaký efekt ako keby sme volali metódu podlaha.obrázok(x, y, obrázok).

Parametre:

x – x-ová súradnica polohy obrázka

y – y-ová súradnica polohy obrázka

obrázok – obrázok, ktorý má byť vykreslený

obrazok

public static void obrazok(double x,
                           double y,
                           Image obrázok)

Alias pre obrázok.

obrázok
```
public static void obrázok(Poloha objekt,
                           Image obrázok)
```
Nakreslí na súradniciach zadaného objektu na podlahe obrázok. Má rovnaký efekt ako keby sme volali metódu podlaha.obrázok(objekt, obrázok).

Parametre:

objekt – objekt určujúci polohu kreslenia obrázka

obrázok – obrázok, ktorý má byť vykreslený

obrazok

public static void obrazok(Poloha objekt,
                           Image obrázok)

Alias pre obrázok.

uložObrázok
```
public static void uložObrázok(String súbor)
```
Uloží aktuálne zobrazený obsah sveta do súboru s obrázkom. Prípona súboru musí byť .gif, .png alebo .jpg (resp. .jpeg). Ak súbor jestvuje, tak vznikne výnimka oznamujúca, že súbor so zadaným menom už jestvuje. Ak chcete súbor prepísať, použite metódu uložObrázok(String súbor, boolean prepísať) s druhým parametrom rovným true.

Parametre:

súbor – názov súboru s požadovanou príponou

Výnimky:

GRobotException – ak súbor jestvuje alebo nebol zadaný názov súboru s platnou príponou

ulozObrazok

public static void ulozObrazok(String súbor)

Alias pre uložObrázok.

uložObrázok
```
public static void uložObrázok(String súbor,
                               boolean prepísať)
```
Uloží aktuálny obsah sveta do súboru s obrázkom. Prípona súboru musí byť .gif, .png alebo .jpg (resp. .jpeg).

Parametre:

súbor – názov súboru s požadovanou príponou

prepísať – ak je true, prípadný jestvujúci súbor bude prepísaný, inak sa správa rovnako ako metóda uložObrázok(String súbor)

Výnimky:

GRobotException – ak súbor jestvuje a parameter prepísať je false alebo ak bol zadaný názov súboru s neplatnou príponou

ulozObrazok

public static void ulozObrazok(String súbor,
                               boolean prepísať)

Alias pre uložObrázok.

farbaTextu
```
public static Farba farbaTextu()
```
Zistí aktuálnu farbu výpisu nových textov stropu. Má rovnaký efekt ako keby sme volali metódu strop.farbaTextu().

Návratová hodnota:

aktuálna farba textov stropu (objekt typu Farba)

farbaTextu
```
public static void farbaTextu(Color nováFarba)
```
Nastav farbu textov stropu. Má rovnaký efekt ako keby sme volali metódu strop.farbaTextu(Color).

Parametre:

nováFarba – objekt určujúci novú farbu pera

farbaTextu
```
public static void farbaTextu(Farebnosť objekt)
```
Nastav farbu textov stropu. Má rovnaký efekt ako keby sme volali metódu strop.farbaTextu(Color).

Parametre:

objekt – objekt určujúci novú farbu pera

farbaTextu
```
public static Farba farbaTextu(int r,
                               int g,
                               int b)
```
Nastav farbu textov stropu. Má rovnaký efekt ako keby sme volali metódu strop.farbaTextu(int, int, int).

Parametre:

r – červená zložka novej farby; celé číslo v rozsahu 0 – 255

g – zelená zložka novej farby; celé číslo v rozsahu 0 – 255

b – modrá zložka novej farby; celé číslo v rozsahu 0 – 255

Návratová hodnota:

objekt typu Farba – nová farba textov

farbaTextu
```
public static Farba farbaTextu(int r,
                               int g,
                               int b,
                               int a)
```
Nastav farbu textov stropu. Má rovnaký efekt ako keby sme volali metódu strop.farbaTextu(int, int, int, int).

Parametre:

r – červená zložka novej farby; celé číslo v rozsahu 0 – 255

g – zelená zložka novej farby; celé číslo v rozsahu 0 – 255

b – modrá zložka novej farby; celé číslo v rozsahu 0 – 255

a – úroveň (ne)priehľadnosti novej farby; celé číslo v rozsahu 0 – 255 (0 – neviditeľná farba; 255 – nepriehľadná farba)

Návratová hodnota:

objekt typu Farba – nová farba textov

predvolenáFarbaTextu
```
public static void predvolenáFarbaTextu()
```
Zmení farbu textov stropu na predvolenú. Má rovnaký efekt ako keby sme volali metódu strop.predvolenáFarbaTextu().

predvolenaFarbaTextu
```
public static void predvolenaFarbaTextu()
```
Alias pre predvolenáFarbaTextu.

farbaPozadiaTextu
```
public static Farba farbaPozadiaTextu()
```
Zistí aktuálnu farbu pozadia výpisu nových textov stropu. Má rovnaký efekt ako keby sme volali metódu strop.farbaPozadiaTextu().

Návratová hodnota:

aktuálna farba pozadia textov na strope (objekt typu Farba)

farbaPozadiaTextu
```
public static void farbaPozadiaTextu(Color nováFarba)
```
Nastav farbu pozadia textov stropu. Má rovnaký efekt ako keby sme volali metódu strop.farbaPozadiaTextu(Color).

Parametre:

nováFarba – objekt určujúci novú farbu pozadia textov

farbaPozadiaTextu
```
public static void farbaPozadiaTextu(Farebnosť objekt)
```
Nastav farbu pozadia textov stropu. Má rovnaký efekt ako keby sme volali metódu strop.farbaPozadiaTextu(Color).

Parametre:

objekt – objekt určujúci novú farbu pozadia textov

farbaPozadiaTextu
```
public static Farba farbaPozadiaTextu(int r,
                                      int g,
                                      int b)
```
Nastav farbu pozadia textov stropu. Má rovnaký efekt ako keby sme volali metódu strop.farbaPozadiaTextu(int, int, int).

Parametre:

r – červená zložka novej farby; celé číslo v rozsahu 0 – 255

g – zelená zložka novej farby; celé číslo v rozsahu 0 – 255

b – modrá zložka novej farby; celé číslo v rozsahu 0 – 255

Návratová hodnota:

objekt typu Farba – nová farba pozadia textov

farbaPozadiaTextu
```
public static Farba farbaPozadiaTextu(int r,
                                      int g,
                                      int b,
                                      int a)
```
Nastav farbu pozadia textov stropu. Má rovnaký efekt ako keby sme volali metódu strop.farbaPozadiaTextu(int, int, int, int).

Parametre:

r – červená zložka novej farby; celé číslo v rozsahu 0 – 255

g – zelená zložka novej farby; celé číslo v rozsahu 0 – 255

b – modrá zložka novej farby; celé číslo v rozsahu 0 – 255

a – úroveň (ne)priehľadnosti novej farby; celé číslo v rozsahu 0 – 255 (0 – neviditeľná farba; 255 – nepriehľadná farba)

Návratová hodnota:

objekt typu Farba – nová farba pozadia textov

predvolenáFarbaPozadiaTextu
```
public static void predvolenáFarbaPozadiaTextu()
```
Zmení farbu pozadia textov stropu na predvolenú. (Predvolenou farbou pozadia textov nie je žiadna farba – je to objekt farby s hodnotou null.) Volanie tejto metódy má rovnaký efekt ako keby sme volali metódu strop.predvolenáFarbaPozadiaTextu().

predvolenaFarbaPozadiaTextu
```
public static void predvolenaFarbaPozadiaTextu()
```
Alias pre predvolenáFarbaPozadiaTextu.

farbaPozadia
```
public static Farba farbaPozadia()
```
Čítaj farbu pozadia sveta. Ide o farbu podkladu, ktorá je použitá v prípade, že podlaha ani strop neboli vyplnené žiadnou konkrétnou farbou (pozri vymaž, vyplň).

Návratová hodnota:

aktuálna farba pozadia sveta (objekt typu Farba)

farbaPozadia
```
public static void farbaPozadia(Color nováFarba)
```
Nastav farbu pozadia sveta. Ide o farbu podkladu, ktorá je použitá v prípade, že podlaha ani strop neboli vyplnené žiadnou konkrétnou farbou (pozri vymaž, vyplň).

Poznámka: Farbu pozadia môže prekryť výplň plátna, ale keď je obsah plátien prázdny (vymazaný), je svet grafických robotov vyplnený farbou pozadia.

Parametre:

nováFarba – objekt určujúci novú farbu pozadia; jestvuje paleta predvolených farieb (pozri: biela, červená, čierna…)

Pozri tiež:

vymaž()

farbaPozadia
```
public static void farbaPozadia(Farebnosť objekt)
```
Nastaví farbu pozadia sveta podľa farby zadaného objektu. Farba pozadia je použitá v prípade, že podlaha ani strop neboli vyplnené žiadnou konkrétnou farbou (pozri vymaž, vyplň).

Poznámka: Farbu pozadia môže prekryť výplň plátna, ale keď je obsah plátien prázdny (vymazaný), je svet grafických robotov vyplnený farbou pozadia.

Parametre:

objekt – objekt určujúci novú farbu pozadia

Pozri tiež:

vymaž()

farbaPozadia
```
public static Farba farbaPozadia(int r,
                                 int g,
                                 int b)
```
Nastav farbu pozadia sveta. Ide o farbu podkladu, ktorá je použitá v prípade, že podlaha ani strop neboli vyplnené žiadnou konkrétnou farbou (pozri vymaž, vyplň).

Parametre:

r – červená zložka novej farby; celé číslo v rozsahu 0 – 255

g – zelená zložka novej farby; celé číslo v rozsahu 0 – 255

b – modrá zložka novej farby; celé číslo v rozsahu 0 – 255

Návratová hodnota:

objekt typu Farba – nová farba pozadia

Pozri tiež:

farbaPozadia(Color)

farbaPozadia
```
public static Farba farbaPozadia(int r,
                                 int g,
                                 int b,
                                 int a)
```
Nastav farbu a (ne)priehľadnosť pozadia sveta. Ide o farbu podkladu, ktorá je použitá v prípade, že podlaha ani strop neboli vyplnené žiadnou konkrétnou farbou (pozri vymaž, vyplň).

Parametre:

r – červená zložka novej farby; celé číslo v rozsahu 0 – 255

g – zelená zložka novej farby; celé číslo v rozsahu 0 – 255

b – modrá zložka novej farby; celé číslo v rozsahu 0 – 255

a – úroveň (ne)priehľadnosti novej farby; celé číslo v rozsahu 0 – 255 (0 – neviditeľná farba; 255 – nepriehľadná farba)

Návratová hodnota:

objekt typu Farba – nová farba pozadia

Pozri tiež:

farbaPozadia(Color)

predvolenáFarbaPozadia
```
public static void predvolenáFarbaPozadia()
```
Nastav predvolenú farbu pozadia. Ide o farbu podkladu, ktorá je použitá v prípade, že podlaha ani strop neboli vyplnené žiadnou konkrétnou farbou (pozri vymaž, vyplň).

predvolenaFarbaPozadia
```
public static void predvolenaFarbaPozadia()
```
Alias pre predvolenáFarbaPozadia.

farbaPlochy
```
public static Farba farbaPlochy()
```
Číta farbu plochy sveta. Ide o farbu základného komponentu okna aplikácie, na ktorom je umiestnené plátno a prípadne ďalšie komponenty.

Návratová hodnota:

aktuálna farba plochy sveta (objekt typu Farba)

farbaPlochy
```
public static void farbaPlochy(Color nováFarba)
```
Nastaví farbu plochy sveta. Ide o farbu základného komponentu okna aplikácie, na ktorom je umiestnené plátno a prípadne ďalšie komponenty.

Ukážka troch farieb plochy. Zľava doprava: systémom predvolená, papierová a antracitová.

Parametre:

nováFarba – objekt určujúci novú farbu plochy; jestvuje paleta predvolených farieb (pozri: biela, červená, čierna…)

Pozri tiež:

vymaž()

farbaPlochy
```
public static void farbaPlochy(Farebnosť objekt)
```
Nastaví farbu plochy sveta podľa farby zadaného objektu. Plochou je myslený základný komponent okna aplikácie, na ktorom je umiestnené plátno a prípadne ďalšie komponenty.

Parametre:

objekt – objekt určujúci novú farbu plochy

Pozri tiež:

farbaPlochy(Color)

farbaPlochy
```
public static Farba farbaPlochy(int r,
                                int g,
                                int b)
```
Nastaví farbu plochy sveta. Plochou je myslený základný komponent okna aplikácie, na ktorom je umiestnené plátno a prípadne ďalšie komponenty.

Parametre:

r – červená zložka novej farby; celé číslo v rozsahu 0 – 255

g – zelená zložka novej farby; celé číslo v rozsahu 0 – 255

b – modrá zložka novej farby; celé číslo v rozsahu 0 – 255

Návratová hodnota:

objekt typu Farba – nová farba plochy

Pozri tiež:

farbaPlochy(Color)

farbaPlochy
```
public static Farba farbaPlochy(int r,
                                int g,
                                int b,
                                int a)
```
Nastaví farbu a (ne)priehľadnosť plochy sveta. Plochou je myslený základný komponent okna aplikácie, na ktorom je umiestnené plátno a prípadne ďalšie komponenty.

Parametre:

r – červená zložka novej farby; celé číslo v rozsahu 0 – 255

g – zelená zložka novej farby; celé číslo v rozsahu 0 – 255

b – modrá zložka novej farby; celé číslo v rozsahu 0 – 255

a – úroveň (ne)priehľadnosti novej farby; celé číslo v rozsahu 0 – 255 (0 – neviditeľná farba; 255 – nepriehľadná farba)

Návratová hodnota:

objekt typu Farba – nová farba plochy

Pozri tiež:

farbaPlochy(Color)

predvolenáFarbaPlochy
```
public static void predvolenáFarbaPlochy()
```
Nastaví predvolenú farbu plochy. Ide o farbu základného komponentu okna aplikácie, na ktorom je umiestnené plátno a prípadne ďalšie komponenty. (Predvolenou farbou je obvykle šedá, ale farba sa môže líšiť v závislosti od operačného systému, jeho nastavení alebo podľa použitého dizajnu vzhľadu používateľského rozhrania – L&F.)

predvolenaFarbaPlochy
```
public static void predvolenaFarbaPlochy()
```
Alias pre predvolenáFarbaPlochy.

farbaBodu
```
public static Farba farbaBodu(double x,
                              double y)
```
Zistí farbu bodu (jedného pixela) na zadaných súradniciach. Ak sa zadané súradnice nachádzajú mimo plochy sveta, je vrátená inštancia farebnosti žiadna. So získanou farbou môžeme ďalej pracovať – napríklad ju upravovať alebo zisťovať jej vlastnosti (farebné zložky…). Testovať, či má bod konkrétnu farbu, môžeme napríklad pomocou metódy farbaBodu(x, y, farba).

Parametre:

x – x-ová súradnica vyšetrovaného bodu

y – y-ová súradnica vyšetrovaného bodu

Návratová hodnota:

farba bodu (objekt typu Farba) na zadanej pozícii alebo inštancia žiadna, ak sú zadané súradnice mimo rozmerov sveta

farbaBodu
```
public static Farba farbaBodu(Poloha objekt)
```
Zistí farbu bodu (jedného pixela) na pozícii zadaného objektu. Ak sa objekt nachádza mimo plochy sveta, je vrátená inštancia farebnosti žiadna farba. So získanou farbou môžeme ďalej pracovať – napríklad ju upravovať alebo zisťovať jej vlastnosti (farebné zložky…). Testovať, či má bod konkrétnu farbu môžeme napríklad pomocou metódy farbaBodu(objekt, farba).

Parametre:

objekt – objekt, na ktorého pozícii má byť zistená farba bodu

Návratová hodnota:

farba bodu (objekt typu Farba) na pozícii zadaného objektu alebo inštancia žiadna, ak sa súradnice zadaného objektu nachádzajú mimo rozmerov sveta

farbaBodu
```
public static boolean farbaBodu(double x,
                                double y,
                                Color farba)
```
Zistí, či sa farba bodu (jedného pixela) na zadaných súradniciach zhoduje so zadanou farbou. Ak sú zadané súradnice mimo plochy sveta, je vrátená hodnota false. Testovať farbu pomocou tejto metódy môžeme napríklad takto:
```
if (Svet.farbaBodu(3.0, 5.0, modrá)) …
```
Parametre:

x – x-ová súradnica vyšetrovaného bodu

y – y-ová súradnica vyšetrovaného bodu

farba – farba, ktorú chceme porovnať s farbou bodu na zadanej pozícii

Návratová hodnota:

true ak sú zadané súradnice v rámci rozmerov sveta a farba bodu na zadaných súradniciach sa zhoduje so zadanou farbou (musia sa zhodovať všetky farebné zložky aj úroveň priehľadnosti), inak false

farbaBodu
```
public static boolean farbaBodu(Poloha objekt,
                                Color farba)
```
Zistí, či sa farba bodu (jedného pixela) na súradniciach zadaného objektu zhoduje so zadanou farbou. Ak sú súradnice zadaného objektu mimo plochy sveta, je vrátená hodnota false. Testovať farbu pomocou tejto metódy môžeme napríklad takto:
```
if (Svet.farbaBodu(this, modrá)) …
```
Parametre:

objekt – objekt, na ktorého pozícii chceme overiť farbu bodu

farba – farba, ktorú chceme porovnať s farbou bodu na pozícii určeného objektu

Návratová hodnota:

true ak sa súradnice objektu nachádzajú v rámci rozmerov sveta a farba bodu na jeho mieste sa zhoduje so zadanou farbou (musia sa zhodovať všetky farebné zložky aj úroveň priehľadnosti), inak false

farbaBodu
```
public static boolean farbaBodu(double x,
                                double y,
                                Farebnosť objekt)
```
Zistí, či sa farba bodu (jedného pixela) na zadaných súradniciach zhoduje s farbou zadaného objektu. Ak sú zadané súradnice mimo plochy sveta, je vrátená hodnota false.

Parametre:

x – x-ová súradnica vyšetrovaného bodu

y – y-ová súradnica vyšetrovaného bodu

objekt – objekt, ktorého farbu chceme porovnať s farbou bodu na zadanej pozícii

Návratová hodnota:

true ak sú zadané súradnice v rámci rozmerov sveta a farba bodu na zadaných súradniciach sa zhoduje s farbou zadaného objektu (musia sa zhodovať všetky farebné zložky aj úroveň priehľadnosti), inak false

farbaBodu
```
public static boolean farbaBodu(Poloha objekt,
                                Farebnosť farebnosť)
```
Zistí, či sa farba bodu (jedného pixela) na zadaných súradniciach zhoduje s farbou zadaného objektu. Ak sú súradnice zadaného objektu mimo plochy sveta, je vrátená hodnota false.

Parametre:

objekt – objekt, na ktorého pozícii chceme overiť farbu bodu

farebnosť – objekt, ktorého farbu chceme porovnať s farbou bodu na pozícii predchádzajúceho objektu

Návratová hodnota:

true ak sa súradnice objektu nachádzajú v rámci rozmerov sveta a farba bodu na jeho mieste sa zhoduje s farbou druhého zadaného objektu (musia sa zhodovať všetky farebné zložky aj úroveň priehľadnosti), inak false

farbaBodu
```
public static boolean farbaBodu(double x,
                                double y,
                                int r,
                                int g,
                                int b)
```
Zistí, či sa farba bodu (jedného pixela) na zadaných súradniciach zhoduje s farbou zadanou prostredníctvom farebných zložiek. (Úroveň priehľadnosti je nastavená na hodnotu 255, čiže na úplne nepriehľadnú farbu.)

Parametre:

x – x-ová súradnica vyšetrovaného bodu

y – y-ová súradnica vyšetrovaného bodu

r – červená zložka farby, ktorú chceme porovnať s farbou bodu na zadanej pozícii

g – červená zložka farby, ktorú chceme porovnať s farbou bodu na zadanej pozícii

b – červená zložka farby, ktorú chceme porovnať s farbou bodu na zadanej pozícii

Návratová hodnota:

true ak sú zadané súradnice v rámci rozmerov sveta a farba bodu na zadaných súradniciach sa zhoduje so zadanou farbou (musia sa zhodovať všetky farebné zložky aj úroveň priehľadnosti), inak false

farbaBodu
```
public static boolean farbaBodu(double x,
                                double y,
                                int r,
                                int g,
                                int b,
                                int a)
```
Zistí, či sa farba bodu (jedného pixela) na zadaných súradniciach zhoduje s farbou zadanou prostredníctvom farebných zložiek a úrovne priehľadnosti.

Parametre:

x – x-ová súradnica vyšetrovaného bodu

y – y-ová súradnica vyšetrovaného bodu

r – červená zložka farby, ktorú chceme porovnať s farbou bodu na zadanej pozícii

g – červená zložka farby, ktorú chceme porovnať s farbou bodu na zadanej pozícii

b – červená zložka farby, ktorú chceme porovnať s farbou bodu na zadanej pozícii

a – úroveň priehľadnosti farby, ktorú chceme porovnať s farbou bodu na zadanej pozícii

Návratová hodnota:

true ak sú zadané súradnice v rámci rozmerov sveta a farba bodu na zadaných súradniciach sa zhoduje so zadanou farbou (musia sa zhodovať všetky farebné zložky aj úroveň priehľadnosti), inak false

farbaBodu
```
public static boolean farbaBodu(Poloha objekt,
                                int r,
                                int g,
                                int b)
```
Zistí, či sa farba bodu (jedného pixela) na súradniciach zadaného objektu zhoduje s farbou zadanou prostredníctvom farebných zložiek. (Úroveň priehľadnosti je nastavená na hodnotu 255, čiže na úplne nepriehľadnú farbu.)

Parametre:

objekt – objekt, ktorého poloha určuje súradnice vyšetrovaného bodu

r – červená zložka farby, ktorú chceme porovnať s farbou bodu na pozícii objektu

g – červená zložka farby, ktorú chceme porovnať s farbou bodu na pozícii objektu

b – červená zložka farby, ktorú chceme porovnať s farbou bodu na pozícii objektu

Návratová hodnota:

true ak je poloha objektu v rámci rozmerov sveta a farba bodu na jeho súradniciach sa zhoduje so zadanou farbou (musia sa zhodovať všetky farebné zložky aj úroveň priehľadnosti), inak false

farbaBodu
```
public static boolean farbaBodu(Poloha objekt,
                                int r,
                                int g,
                                int b,
                                int a)
```
Zistí, či sa farba bodu (jedného pixela) na súradniciach zadaného objektu zhoduje s farbou zadanou prostredníctvom farebných zložiek a úrovne priehľadnosti.

Parametre:

objekt – objekt, ktorého poloha určuje súradnice vyšetrovaného bodu

r – červená zložka farby, ktorú chceme porovnať s farbou bodu na pozícii objektu

g – červená zložka farby, ktorú chceme porovnať s farbou bodu na pozícii objektu

b – červená zložka farby, ktorú chceme porovnať s farbou bodu na pozícii objektu

a – úroveň priehľadnosti farby, ktorú chceme porovnať s farbou bodu na pozícii objektu

Návratová hodnota:

true ak je poloha objektu v rámci rozmerov sveta a farba bodu na jeho súradniciach sa zhoduje so zadanou farbou (musia sa zhodovať všetky farebné zložky aj úroveň priehľadnosti), inak false

farbaNaMyši

public static Farba farbaNaMyši()

Zistí farbu bodu (jedného pixela) na súradniciach myši. So získanou farbou môžeme ďalej pracovať – napríklad ju upravovať alebo zisťovať jej vlastnosti (farebné zložky…). Testovať, či má bod konkrétnu farbu, môžeme napríklad pomocou metódy farbaNaMyši(farba).

Poznámka: Ak by súradnice myši boli náhodou mimo plochy sveta, metóda by vrátila inštanciu farby žiadna.

Príklad:

Tento príklad demonštruje fungovanie metódy farbaNaMyši. Zistenú farbu zobrazí v elegantnom indikátore umiestnenom v ľavom hornom rohu (pozri zoznam zmien: poďakovanie uvedené pri verzii 1.35):

// Zaplňme kresbu množstvom farebných štvorcov

Svet.nekresli();

for (int j = 0; j < 1000; ++j)
{
    double rozmer = Svet.náhodnéReálneČíslo(20, 30);

    farba((int)Svet.náhodnéCeléČíslo(0, 255),
        (int)Svet.náhodnéCeléČíslo(0, 255),
        (int)Svet.náhodnéCeléČíslo(0, 255));

    náhodnáPoloha();
    náhodnýSmer();
    vyplňŠtvorec(rozmer);
}

Svet.kresli();

// Definujme všetko potrebné (obsluhu udalostí, vlastný tvar) na to,
// aby robot počas pohybu myšou nad plátnom v elegantnom kruhovom
// indikátore ukazoval aktuálnu farbu nad kurzorom myši…

skočNa(Svet.ľavýOkraj() + 35, Svet.hornýOkraj() - 35);

new ObsluhaUdalostí()
{
    @Override public void pohybMyši()
    {
        farba(Svet.farbaNaMyši());
    }
};

vlastnýTvar(new KreslenieTvaru()
{
    @Override public void kresli(GRobot r)
    {
        Farba mojaFarba = r.farba();
        farba(čierna);
        kruh(30);
        farba(biela);
        kruh(25);
        farba(mojaFarba);
        kruh(20);
    }
});

Výsledok:

Zisťovanie farby pixela na pozícii
kurzora myši.

Plátno je zaplnené farebnými štvorcami a farba pod kurzorom myši
je indikovaná v kruhovom indikátore v ľavom hornom rohu
(plátno na obrázku je zmenšené).

Návratová hodnota:: farba bodu (objekt typu Farba) na pozícii myši

farbaNaMysi
```
public static Farba farbaNaMysi()
```
Alias pre farbaNaMyši.

farbaNaMyši
```
public static boolean farbaNaMyši(Color farba)
```
Zistí, či sa farba bodu (jedného pixela) na súradniciach myši zhoduje so zadanou farbou. Testovať farbu pomocou tejto metódy môžeme napríklad takto:
```
if (Svet.farbaNaMyši(modrá)) …
```
Poznámka: Ak by súradnice myši boli náhodou mimo plochy sveta, metóda by vrátila hodnotu false.
Parametre:

farba – farba, ktorú chceme porovnať s farbou bodu na súradniciach myši

Návratová hodnota:

true ak je farba bodu na súradniciach myši zhodná so zadanou farbou (musia sa zhodovať všetky farebné zložky aj úroveň priehľadnosti), inak false

farbaNaMysi

public static boolean farbaNaMysi(Color farba)

Alias pre farbaNaMyši.

farbaNaMyši
```
public static boolean farbaNaMyši(Farebnosť objekt)
```
Zistí, či sa farba bodu (jedného pixela) na súradniciach myši zhoduje so zadanou farbou. Testovať farbu pomocou tejto metódy môžeme napríklad takto:
```
if (Svet.farbaNaMyši(modrá)) …
```
Poznámka: Ak by súradnice myši boli náhodou mimo plochy sveta, metóda by vrátila hodnotu false.
Parametre:

objekt – objekt, ktorého farbu chceme porovnať s farbou bodu na súradniciach myši

Návratová hodnota:

true ak je farba bodu na súradniciach myši zhodná so zadanou farbou (musia sa zhodovať všetky farebné zložky aj úroveň priehľadnosti), inak false

farbaNaMysi

public static boolean farbaNaMysi(Farebnosť objekt)

Alias pre farbaNaMyši.

farbaNaMyši
```
public static boolean farbaNaMyši(int r,
                                  int g,
                                  int b)
```
Zistí, či je farba bodu (jedného pixela) na súradniciach myši zhodná s farbou zadanou prostredníctvom farebných zložiek. (Úroveň priehľadnosti je nastavená na hodnotu 255, čiže na úplne nepriehľadnú farbu.)

Poznámka: Ak by súradnice myši boli náhodou mimo aktívneho kresliaceho plátna robota, metóda by vrátila hodnotu false.

Parametre:

r – červená zložka farby, ktorú chceme porovnať s farbou bodu na súradniciach myši

g – červená zložka farby, ktorú chceme porovnať s farbou bodu na súradniciach myši

b – červená zložka farby, ktorú chceme porovnať s farbou bodu na súradniciach myši

Návratová hodnota:

true ak je farba bodu na súradniciach myši zhodná so zadanou farbou (musia sa zhodovať všetky tri farebné zložky aj úroveň priehľadnosti), inak false

farbaNaMysi

public static boolean farbaNaMysi(int r,
                                  int g,
                                  int b)

Alias pre farbaNaMyši.

farbaNaMyši
```
public static boolean farbaNaMyši(int r,
                                  int g,
                                  int b,
                                  int a)
```
Zistí, či sa farba bodu (jedného pixela) na súradniciach myši zhoduje s farbou zadanou prostredníctvom farebných zložiek a úrovne priehľadnosti.

Poznámka: Ak by súradnice myši boli náhodou mimo plochy sveta, metóda by vrátila hodnotu false.

Parametre:

r – červená zložka farby, ktorú chceme porovnať s farbou bodu na súradniciach myši

g – červená zložka farby, ktorú chceme porovnať s farbou bodu na súradniciach myši

b – červená zložka farby, ktorú chceme porovnať s farbou bodu na súradniciach myši

a – úroveň priehľadnosti farby, ktorú chceme porovnať s farbou bodu na súradniciach myši

Návratová hodnota:

true ak je farba bodu na súradniciach myši zhodná so zadanou farbou (musia sa zhodovať všetky tri farebné zložky aj úroveň priehľadnosti), inak false

farbaNaMysi

public static boolean farbaNaMysi(int r,
                                  int g,
                                  int b,
                                  int a)

Alias pre farbaNaMyši.

písmo
```
public static Písmo písmo()
```
Čítaj aktuálny typ písma textov stropu. Má rovnaký efekt ako keby sme volali metódu strop.písmo().

pismo
```
public static Pismo pismo()
```
Alias pre písmo.

písmo
```
public static void písmo(Font novéPísmo)
```
Nastav nový typ písma textov stropu. Má rovnaký efekt ako keby sme volali metódu strop.písmo(Font). Písmo používajú metódy vypíš a vypíšRiadok.

Parametre:

novéPísmo – objekt typu Písmo alebo Font určujúci nový typ písma

pismo

public static void pismo(Font novéPísmo)

Alias pre písmo.

písmo
```
public static Písmo písmo(String názov,
                          double veľkosť)
```
Nastav nový typ písma textov stropu. Má rovnaký efekt ako keby sme volali metódu strop.písmo(String, double).

Parametre:

názov – názov písma; môže byť všeobecný názov logického písma (Dialog, DialogInput, Monospaced, Serif, SansSerif…) alebo názov konkrétneho písma (Times New Roman, Arial…)

veľkosť – veľkosť písma v bodoch (hodnota je zaokrúhlená na typ float)

Návratová hodnota:

objekt typu Písmo určujúci nový typ písma

pismo

public static Pismo pismo(String názov,
                          double veľkosť)

Alias pre písmo.

predvolenéPísmo
```
public static void predvolenéPísmo()
```
Nastav predvolený typ písma textov stropu. Má rovnaký efekt ako keby sme volali metódu strop.predvolenéPísmo().

predvolenePismo
```
public static void predvolenePismo()
```
Alias pre predvolenéPísmo.

priečinokZvukov
```
public static void priečinokZvukov(String priečinok)
```
Ak sú všetky zvuky uložené v spoločnom priečinku, môžeme pre nich touto metódou nastaviť zdrojový priečinok čítania. Priečinok by sa mal nachádzať v hlavnom priečinku projektu alebo by k nemu mala viesť systémovo nezávislá relatívna cesta. Zadaním prázdneho reťazca alebo hodnoty null používanie priečinka zrušíme.

Parametre:

priečinok – názov priečinka, relatívna cesta, prípadne prázdny reťazec alebo null

Pozri tiež:

priečinokZvukov(), čítajZvuky(Object[]), čítajZvuky(String[]), čítajZvuk(String), čítajZvuk(String, boolean), zvuk(String), zvukNaPozadí(String), zastavZvuky(Object[]), hlasitosťPreZvuky(double, Object[]), váhaPreZvuky(double, Object[]), zastavZvuky(String[]), hlasitosťPreZvuky(double, String[]), váhaPreZvuky(double, String[]), Zvuk

priecinokZvukov

public static void priecinokZvukov(String priečinok)

Alias pre priečinokZvukov.

priečinokZvukov
```
public static String priečinokZvukov()
```
Vráti reťazec s aktuálnym priečinkom, z ktorého sú zvuky čítané. Reťazec je obohatený o oddeľovací znak priečinkov java.io.File.separatorChar (/ alebo \ – záleží na type operačného systému), ktorý automaticky pridáva metóda priečinokZvukov(priečinok). Rovnako všetky oddeľovacie znaky priečinkov v relatívnej ceste sú nahradené podľa typu operačného systému.

Návratová hodnota:

aktuálny priečinok, z ktorého sú zvuky čítané

Pozri tiež:

priečinokZvukov(String), čítajZvuky(Object[]), čítajZvuky(String[]), čítajZvuk(String), čítajZvuk(String, boolean), zvuk(String), zvukNaPozadí(String), zastavZvuky(Object[]), hlasitosťPreZvuky(double, Object[]), váhaPreZvuky(double, Object[]), zastavZvuky(String[]), hlasitosťPreZvuky(double, String[]), váhaPreZvuky(double, String[]), Zvuk, Zvuk.čítaj(String), Zvuk.čítaj(String, boolean)

priecinokZvukov

public static String priecinokZvukov()

Alias pre priečinokZvukov.

čítajZvuky
```
public static void čítajZvuky(Object... súbory)
```
Táto metóda slúži na čítanie zadaných zvukových súborov do vnútornej pamäte sveta (napríklad pri štarte aplikácie). Svet ukladá do vnútornej pamäte každý prehrávaný zvuk (ak tam už nie je). Z nej môže byť v prípade potreby (napríklad ak sa obsah súboru na disku zmenil) odstránený metódou Svet.uvoľni(názovZdroja). Táto metóda číta zvukové súbory vopred a tým môže prispieť k plynulejšej činnosti aplikácie po štarte (čas štartu sa predĺži, ale keďže súbory už nemusia byť čítané počas jej činnosti môže pracovať plynulejšie).

Poznámka: Táto metóda a všetky také, ktoré pracujú so zvukmi identifikovanými podľa názvu súboru tak, že podľa potreby vytvára(jú) nové unikátne inštancie identifikovaných zvukov. Podrobnejšie vysvetlenie je v opise metódy čítajZvuk(súbor).

Parametre:

súbory – ľubovoľný počet reťazcov označujúcich súbory

Výnimky:

GRobotException – ak niektorý súbor nebol nájdený; spracovanie sa v okamihu vzniku výnimky neskončí a vrhnutá je len posledná vzniknutá výnimka, to znamená, že všetky predchádzajúce výnimky sú ignorované

Pozri tiež:

priečinokZvukov(String), čítajZvuky(String[]), čítajZvuk(String), čítajZvuk(String, boolean), zvuk(String), zvukNaPozadí(String), Zvuk, Zvuk.čítaj(String), Zvuk.čítaj(String, boolean)

citajZvuky

public static void citajZvuky(Object... súbory)

Alias pre čítajZvuky.

prečítajZvuky

public static void prečítajZvuky(Object... súbory)

Alias pre čítajZvuky.

precitajZvuky

public static void precitajZvuky(Object... súbory)

Alias pre čítajZvuky.

čítajZvuky
```
public static void čítajZvuky(String[] súbory)
```
Táto metóda slúži na čítanie zadaných zvukových súborov do vnútornej pamäte sveta (napríklad pri štarte aplikácie). Svet ukladá do vnútornej pamäte každý prehrávaný zvuk (ak tam už nie je). Z nej môže byť v prípade potreby (napríklad ak sa obsah súboru na disku zmenil) odstránený metódou Svet.uvoľni(názovZdroja). Táto metóda číta zvukové súbory vopred a tým môže prispieť k plynulejšej činnosti aplikácie po štarte (čas štartu sa predĺži, ale keďže súbory už nemusia byť čítané počas jej činnosti, pracuje plynulejšie).

Poznámka: Táto metóda a všetky také, ktoré pracujú so zvukmi identifikovanými podľa názvu súboru tak, že podľa potreby vytvára(jú) nové unikátne inštancie identifikovaných zvukov. Podrobnejšie vysvetlenie je v opise metódy čítajZvuk(súbor).

Parametre:

súbory – pole reťazcov označujúcich súbory

Výnimky:

GRobotException – ak niektorý súbor nebol nájdený; spracovanie sa v okamihu vzniku výnimky neskončí a vrhnutá je len posledná vzniknutá výnimka, to znamená, že všetky predchádzajúce výnimky sú ignorované

Pozri tiež:

priečinokZvukov(String), čítajZvuky(Object[]), čítajZvuk(String), čítajZvuk(String, boolean), zvuk(String), zvukNaPozadí(String), Zvuk, Zvuk.čítaj(String), Zvuk.čítaj(String, boolean)

citajZvuky

public static void citajZvuky(String[] súbory)

Alias pre čítajZvuky.

prečítajZvuky

public static void prečítajZvuky(String[] súbory)

Alias pre čítajZvuky.

precitajZvuky

public static void precitajZvuky(String[] súbory)

Alias pre čítajZvuky.

čítajZvuk
```
public static Zvuk čítajZvuk(String súbor)
```
Prečíta do vnútornej pamäte sveta zadaný zvuk zo súboru a vráti ho v objekte typu Zvuk. Zvuk nie je prehraný. Podobnú úlohu plní metóda Svet.čítajZvuky(Object... súbory) (pozri pre viac informácií), ale pomocou nej nie je možné získať objekt typu Zvuk na prípadné ďalšie spracovanie. Zvuk môže byť v prípade potreby (napríklad ak sa obsah súboru na disku zmenil) z vnútornej pamäte odstránený metódou Svet.uvoľni(názovZdroja).

Táto metóda funguje tak, že podľa potreby vytvára nové unikátne inštancie zvuku identifikovaného názvom súboru. Nová inštancia vznikne vždy, ak sa vo vnútornej pamäti sveta nenájde taká inštancia určeného zvuku, ktorá práve nie je prehrávaná (to znamená, že metóda musí nájsť zvuk, ktorý je ticho). Takto fungujú všetky metódy pracujúce so zvukom. Ak by sa toto nedialo, tak by vznikalo nežiaduce správanie – vždy pri pokuse prehrať ten istý zvuk počas jeho prehrávania, by sa tento reštartoval. (Nebolo by možné prehrať sériu rovnakých zvukov, ktoré sa časovo prekrývajú. To by pôsobilo neprirodzene – každé reštartovanie zvuku by bolo počuteľné tak, ako keby sa zo zvuku zrazu časť „odsekla.“)

Parametre:

súbor – názov súboru so zvukom

Návratová hodnota:

zvuk v objekte typu Zvuk

Výnimky:

GRobotException – ak súbor so zvukom nebol nájdený

Pozri tiež:

priečinokZvukov(String), čítajZvuky(Object[]), čítajZvuky(String[]), čítajZvuk(String, boolean), zvuk(String), zvukNaPozadí(String), Zvuk, Zvuk.čítaj(String), Zvuk.čítaj(String, boolean)

citajZvuk

public static Zvuk citajZvuk(String súbor)

Alias pre čítajZvuk.

prečítajZvuk

public static Zvuk prečítajZvuk(String súbor)

Alias pre čítajZvuk.

precitajZvuk

public static Zvuk precitajZvuk(String súbor)

Alias pre čítajZvuk.

čítajZvuk
```
public static Zvuk čítajZvuk(String súbor,
                             boolean unikátny)
```
Prečíta do vnútornej pamäte sveta zadaný zvuk zo súboru a vráti ho v objekte typu Zvuk. Zvuk nie je prehraný. Ak je parameter unikátny rovný false, tak táto metóda funguje rovnako ako metóda čítajZvuk(súbor).

V prípade, že je parameter unikátny rovný true, tak táto metóda vždy vráti unikátny objekt zvuku aj v prípade, že jestvuje aspoň jedna kópia tohto zvuku, ktorá sa práve neprehráva (t. j. je ticho).

Všetky kópie zvuku môžu byť v prípade potreby (napríklad ak sa obsah zvukového súboru na disku zmenil) z vnútornej pamäte odstránené metódou Svet.uvoľni(názovZdroja).

Parametre:

súbor – názov súboru so zvukom

unikátny – určuje, či objekt vrátený touto metódou musí byť unikátny

Návratová hodnota:

zvuk v objekte typu Zvuk

Výnimky:

GRobotException – ak súbor so zvukom nebol nájdený

Pozri tiež:

priečinokZvukov(String), čítajZvuky(Object[]), čítajZvuky(String[]), čítajZvuk(String), zvuk(String), zvukNaPozadí(String), Zvuk, Zvuk.čítaj(String), Zvuk.čítaj(String, boolean)

citajZvuk

public static Zvuk citajZvuk(String súbor,
                             boolean unikátny)

Alias pre čítajZvuk.

prečítajZvuk

public static Zvuk prečítajZvuk(String súbor,
                                boolean unikátny)

Alias pre čítajZvuk.

precitajZvuk

public static Zvuk precitajZvuk(String súbor,
                                boolean unikátny)

Alias pre čítajZvuk.

zvuk
```
public static void zvuk(String súbor)
```
Prehrá zvukový súbor (formát .wav, .au alebo .mp3).

Napríklad:
```
Svet.zvuk("zvuk.wav");
```
Zvuk „zvuk.wav“ na prevzatie.

Zvuk prečítaný zo súboru je chápaný ako zdroj a po prečítaní zostane uložený vo vnútornej pamäti sveta. Z nej môže byť v prípade potreby (napríklad ak sa obsah súboru na disku zmenil) odstránený metódou Svet.uvoľni(názovZdroja). (Táto informácia je platná pre všetky metódy pracujúce s obrázkami alebo zvukmi, ktoré prijímajú názov súboru ako parameter.)

Poznámka: Táto metóda a všetky také, ktoré pracujú so zvukmi identifikovanými podľa názvu súboru tak, že podľa potreby vytvára(jú) nové unikátne inštancie identifikovaného zvuku. Podrobnejšie vysvetlenie je v opise metódy čítajZvuk(súbor).
Parametre:

súbor – názov zvukového súboru, ktorý má byť prehraný

Výnimky:

GRobotException – ak súbor so zvukom nebol nájdený

Pozri tiež:

priečinokZvukov(String), zvukNaPozadí(String), Zvuk

zvukNaPozadí
```
public static void zvukNaPozadí(String súbor)
```
Začne alebo ukončí prehrávanie zvuku zo súboru na pozadí (formát .wav, .au alebo .mp3). Ak chceme prehrávanie zvuku zastaviť, zadáme do argumentu metódy null.

Zvuk prečítaný zo súboru je chápaný ako zdroj a po prečítaní zostane uložený vo vnútornej pamäti sveta. Z nej môže byť v prípade potreby (napríklad ak sa obsah súboru na disku zmenil) odstránený metódou Svet.uvoľni(názovZdroja). (Táto informácia je platná pre všetky metódy pracujúce s obrázkami alebo zvukmi, ktoré prijímajú názov súboru ako parameter.)

Poznámka: Táto metóda a všetky také, ktoré pracujú so zvukmi identifikovanými podľa názvu súboru tak, že podľa potreby vytvára(jú) nové unikátne inštancie identifikovaného zvuku. Podrobnejšie vysvetlenie je v opise metódy čítajZvuk(súbor).

Parametre:

súbor – názov zvukového súboru, ktorý má byť prehrávaný, alebo null na zastavenie prehrávania

Výnimky:

GRobotException – ak súbor so zvukom nebol nájdený

Pozri tiež:

priečinokZvukov(String), zvuk(String), Zvuk

zvukNaPozadi

public static void zvukNaPozadi(String súbor)

Alias pre zvukNaPozadí.

hráZvukNaPozadí
```
public static boolean hráZvukNaPozadí()
```
Zistí, či je aktívne prehrávanie zvuku na pozadí, ktoré bolo spustené metódou zvukNaPozadí.

Návratová hodnota:

true – áno; false – nie

hraZvukNaPozadi
```
public static boolean hraZvukNaPozadi()
```
Alias pre hráZvukNaPozadí.

zastavZvuky
```
public static void zastavZvuky(Object... súbory)
```
Zastaví všetky uvedené zvuky. Zoznam je treba uviesť v tvare objektov, ktorých prevody na textové reťazce budú označovať názvy súborov (prípadne zdrojov), z ktorých zvuky boli alebo majú byť prečítané. (Najlepšie použiť priamo reťazce.)

Pozor! Táto metóda zároveň spôsobí prečítanie všetkých dotknutých zvukov do vnútornej pamäte (ak tam už nie sú). Z nej môžu byť v prípade potreby (napríklad ak sa obsah súboru na disku zmenil) odstránené metódou Svet.uvoľni(názovZdroja). (Táto informácia je platná pre všetky metódy pracujúce s obrázkami alebo zvukmi, ktoré prijímajú názov súboru ako parameter.)

Poznámka: Táto metóda a všetky také, ktoré pracujú so zvukmi identifikovanými podľa názvu súboru tak, že podľa potreby vytvára(jú) nové unikátne inštancie identifikovaných zvukov. Podrobnejšie vysvetlenie je v opise metódy čítajZvuk(súbor).

Parametre:

súbory – ľubovoľný počet reťazcov označujúcich súbory

Výnimky:

GRobotException – ak niektorý súbor nebol nájdený; spracovanie sa v okamihu vzniku výnimky neskončí a vrhnutá je len posledná vzniknutá výnimka, to znamená, že všetky predchádzajúce výnimky sú ignorované

Pozri tiež:

priečinokZvukov(String), zastavZvuky(String[]), Zvuk

hlasitosťPreZvuky
```
public static void hlasitosťPreZvuky(double miera,
                                     Object... súbory)
```
Nastaví hromadne hlasitosť pre všetky uvedené zvuky. Zoznam je treba uviesť v tvare objektov, ktorých prevody na textové reťazce budú označovať názvy súborov (prípadne zdrojov), z ktorých zvuky boli alebo majú byť prečítané. (Najlepšie použiť priamo reťazce.)

Pozor! Táto metóda zároveň spôsobí prečítanie všetkých dotknutých zvukov do vnútornej pamäte (ak tam už nie sú). Z nej môžu byť v prípade potreby (napríklad ak sa obsah súboru na disku zmenil) odstránené metódou Svet.uvoľni(názovZdroja). (Táto informácia je platná pre všetky metódy pracujúce s obrázkami alebo zvukmi, ktoré prijímajú názov súboru ako parameter.)

Poznámka: Táto metóda a všetky také, ktoré pracujú so zvukmi identifikovanými podľa názvu súboru tak, že podľa potreby vytvára(jú) nové unikátne inštancie identifikovaných zvukov. Podrobnejšie vysvetlenie je v opise metódy čítajZvuk(súbor).

Parametre:

miera – miera hlasitosti v percentách – 0 % zodpovedá hodnote 0.0, 100 % hodnote 1.0

súbory – ľubovoľný počet reťazcov označujúcich súbory

Výnimky:

GRobotException – ak niektorý súbor nebol nájdený; spracovanie sa v okamihu vzniku výnimky neskončí a vrhnutá je len posledná vzniknutá výnimka, to znamená, že všetky predchádzajúce výnimky sú ignorované

Pozri tiež:

Zvuk.hlasitosť(double), priečinokZvukov(String), hlasitosťPreZvuky(double, String[]), Zvuk

hlasitostPreZvuky

public static void hlasitostPreZvuky(double miera,
                                     Object... súbory)

Alias pre hlasitosťPreZvuky

váhaPreZvuky
```
public static void váhaPreZvuky(double miera,
                                Object... súbory)
```
Nastaví hromadne stereováhu pre všetky uvedené zvuky. Zoznam je treba uviesť v tvare objektov, ktorých prevody na textové reťazce budú označovať názvy súborov (prípadne zdrojov), z ktorých zvuky boli alebo majú byť prečítané. (Najlepšie je použiť priamo reťazce.)

Pozor! Táto metóda zároveň spôsobí prečítanie všetkých dotknutých zvukov do vnútornej pamäte (ak tam už nie sú). Z nej môžu byť v prípade potreby (napríklad ak sa obsah súboru na disku zmenil) odstránené metódou Svet.uvoľni(názovZdroja). (Táto informácia je platná pre všetky metódy pracujúce s obrázkami alebo zvukmi, ktoré prijímajú názov súboru ako parameter.)

Poznámka: Táto metóda a všetky také, ktoré pracujú so zvukmi identifikovanými podľa názvu súboru tak, že podľa potreby vytvára(jú) nové unikátne inštancie identifikovaných zvukov. Podrobnejšie vysvetlenie je v opise metódy čítajZvuk(súbor).

Parametre:

miera – miera stereovyváženia – reálne číslo od -1.0 (ľavý kanál) po +1.0 (pravý kanál)

súbory – ľubovoľný počet reťazcov označujúcich súbory

Výnimky:

GRobotException – ak niektorý súbor nebol nájdený; spracovanie sa v okamihu vzniku výnimky neskončí a vrhnutá je len posledná vzniknutá výnimka, to znamená, že všetky predchádzajúce výnimky sú ignorované

Pozri tiež:

Zvuk.váha(double), priečinokZvukov(String), váhaPreZvuky(double, String[]), Zvuk

vahaPreZvuky

public static void vahaPreZvuky(double miera,
                                Object... súbory)

Alias pre váhaPreZvuky

zastavZvuky
```
public static void zastavZvuky(String[] súbory)
```
Zastaví všetky uvedené zvuky. Zoznam je tvorený poľom textových reťazcov označujúcich súbory, z ktorých boli zvuky prečítané.

Pozor! Táto metóda zároveň spôsobí prečítanie všetkých dotknutých zvukov do vnútornej pamäte (ak tam už nie sú). Z nej môžu byť v prípade potreby (napríklad ak sa obsah súboru na disku zmenil) odstránené metódou Svet.uvoľni(názovZdroja). (Táto informácia je platná pre všetky metódy pracujúce s obrázkami alebo zvukmi, ktoré prijímajú názov súboru ako parameter.)

Poznámka: Táto metóda a všetky také, ktoré pracujú so zvukmi identifikovanými podľa názvu súboru tak, že podľa potreby vytvára(jú) nové unikátne inštancie identifikovaných zvukov. Podrobnejšie vysvetlenie je v opise metódy čítajZvuk(súbor).

Parametre:

súbory – pole reťazcov označujúcich súbory

Výnimky:

GRobotException – ak niektorý súbor nebol nájdený; spracovanie sa v okamihu vzniku výnimky neskončí a vrhnutá je len posledná vzniknutá výnimka, to znamená, že všetky predchádzajúce výnimky sú ignorované

Pozri tiež:

priečinokZvukov(String), zastavZvuky(Object[]), Zvuk

hlasitosťPreZvuky
```
public static void hlasitosťPreZvuky(double miera,
                                     String[] súbory)
```
Nastaví hromadne hlasitosť pre všetky uvedené zvuky. Zoznam je tvorený poľom textových reťazcov označujúcich súbory, z ktorých boli zvuky prečítané.

Pozor! Táto metóda zároveň spôsobí prečítanie všetkých dotknutých zvukov do vnútornej pamäte (ak tam už nie sú). Z nej môžu byť v prípade potreby (napríklad ak sa obsah súboru na disku zmenil) odstránené metódou Svet.uvoľni(názovZdroja). (Táto informácia je platná pre všetky metódy pracujúce s obrázkami alebo zvukmi, ktoré prijímajú názov súboru ako parameter.)

Poznámka: Táto metóda a všetky také, ktoré pracujú so zvukmi identifikovanými podľa názvu súboru tak, že podľa potreby vytvára(jú) nové unikátne inštancie identifikovaných zvukov. Podrobnejšie vysvetlenie je v opise metódy čítajZvuk(súbor).

Parametre:

miera – miera hlasitosti v percentách – 0 % zodpovedá hodnote 0.0, 100 % hodnote 1.0

súbory – pole reťazcov označujúcich súbory

Výnimky:

GRobotException – ak niektorý súbor nebol nájdený; spracovanie sa v okamihu vzniku výnimky neskončí a vrhnutá je len posledná vzniknutá výnimka, to znamená, že všetky predchádzajúce výnimky sú ignorované

Pozri tiež:

Zvuk.hlasitosť(double), priečinokZvukov(String), hlasitosťPreZvuky(double, Object[]), Zvuk

hlasitostPreZvuky

public static void hlasitostPreZvuky(double miera,
                                     String[] súbory)

Alias pre hlasitosťPreZvuky

váhaPreZvuky
```
public static void váhaPreZvuky(double miera,
                                String[] súbory)
```
Nastaví hromadne stereováhu pre všetky uvedené zvuky. Zoznam je tvorený poľom textových reťazcov označujúcich súbory, z ktorých boli zvuky prečítané.

Pozor! Táto metóda zároveň spôsobí prečítanie všetkých dotknutých zvukov do vnútornej pamäte (ak tam už nie sú). Z nej môžu byť v prípade potreby (napríklad ak sa obsah súboru na disku zmenil) odstránené metódou Svet.uvoľni(názovZdroja). (Táto informácia je platná pre všetky metódy pracujúce s obrázkami alebo zvukmi, ktoré prijímajú názov súboru ako parameter.)

Poznámka: Táto metóda a všetky také, ktoré pracujú so zvukmi identifikovanými podľa názvu súboru tak, že podľa potreby vytvára(jú) nové unikátne inštancie identifikovaných zvukov. Podrobnejšie vysvetlenie je v opise metódy čítajZvuk(súbor).

Parametre:

miera – miera stereovyváženia – reálne číslo od -1.0 (ľavý kanál) po +1.0 (pravý kanál)

súbory – pole reťazcov označujúcich súbory

Výnimky:

GRobotException – ak niektorý súbor nebol nájdený; spracovanie sa v okamihu vzniku výnimky neskončí a vrhnutá je len posledná vzniknutá výnimka, to znamená, že všetky predchádzajúce výnimky sú ignorované

Pozri tiež:

Zvuk.váha(double), priečinokZvukov(String), váhaPreZvuky(double, Object[]), Zvuk

vahaPreZvuky

public static void vahaPreZvuky(double miera,
                                String[] súbory)

Alias pre váhaPreZvuky

pípni
```
public static void pípni()
```
Aplikácia vydá štandardný zvuk operačného systému. (To je využiteľné napríklad pri jednoduchom overení, či sa podarilo spustiť nejakú časť programu…)

pipni
```
public static void pipni()
```
Alias pre pípni.

pípni
```
public static void pípni(String názov)
```
Aplikácia vydá štandardný zvuk operačného systému Windows podľa vloženého pomenovania. Operačný systém Windows má definovaných viacero systémových zvukov, ktoré sú dostupné prostredníctvom tejto verzie metódy. Ak je metóda spustená na inom operačnom systéme alebo nastane iné zlyhanie, tak je prehraný rovnaký zvukový signál ako pri metóde pípni() (bez parametra).

Parametre:

názov – názov zvuku; tu sú niektoré názvy zvukov, ktoré sú podporované OS Windows: "asterisk", "close", "default", "exclamation", "exit", "hand", "maximize", "menuCommand", "menuPopup", "minimize", "open", "question", "restoreDown", "restoreUp" alebo "start".

pipni

public static void pipni(String názov)

Alias pre pípni.

frekvenciaNoty
```
public static double frekvenciaNoty(int nota,
                                    int oktáva)
```
Vypočíta harmonickú frekvenciu tónu na základe zadaného poradového čísla noty (odporúčané sú hodnoty 1 až 12) a oktávy (odporúčané sú hodnoty −1 až 9).

Poradové čísla nôt zodpovedajú nasledujúcim tónom:

1 C 4 E♭/D♯ 7 F♯/G♭ 10 A

2 C♯/D♭ 5 E 8 G 11 B♭/H♭/A♯

3 D 6 F 9 A♭/G♯ 12 B/H

Táto metóda vypočíta frekvenciu aj v prípade, že zadané hodnoty tónu a oktávy sú mimo odporúčaných rozsahov, ale v prípade výrazného prekročenia rozsahu nemusí byť výsledná frekvencia počuteľná.

Parametre:

nota – číslo noty v rámci oktávy (1 až 12 – pozri tabuľku vyššie)

otáva – číslo oktávy (−1 až 9, prípadne 10)

Návratová hodnota:

harmonická frekvencia tónu vypočítaná z čísla noty a oktávy

Pozri tiež:

hrajTón(double), hrajTón(double, double), hrajTón(double, double, double), zastavTón(), otvorSúborNaUloženieTónu(String), otvorSúborNaUloženieTónu(String, boolean), zavriSúborNaUloženieTónu(), generátorTónov(), Zvuk

hrajTón
```
public static void hrajTón(double frekvencia)
```
Spustí prehrávanie tónu tvoreného jedinou harmonickou frekvenciou. Hlasitosť tónu je automaticky nastavená na 80 % (0.8). Prehrávanie tónu zastaví volanie metódy zastavTón. Spustením tejto metódy sa zruší prípadný plán prehrávaných tónov vytvorený volaním metódy hrajTón(frekvencia, hlasitosť, trvanie).

Príklad:

Nasledujúci jednoduchý príklad vyrobí zvukový hvizd v rozmedzí frekvencií od 50 Hz do zhruba 15 kHz. Ukážka hvízdnutia je pod príkladom.
```
for (double f = 50.0; f <= 15_000.0; f += 150.0)
{
    Svet.hrajTón(f);
    Svet.čakaj(0.010);
}
Svet.zastavTón();
```
Ukážka hvízdnutia:

Zvuk „hvizd.wav“ na prevzatie.
Parametre:

frekvencia – harmonická frekvencia tónu v hertzoch

Pozri tiež:

frekvenciaNoty(int, int), hrajTón(double, double), hrajTón(double, double, double), zastavTón(), otvorSúborNaUloženieTónu(String), otvorSúborNaUloženieTónu(String, boolean), zavriSúborNaUloženieTónu(), generátorTónov(), Zvuk

hrajTon

public static void hrajTon(double frekvencia)

Alias pre hrajTón.

hrajTón
```
public static void hrajTón(double frekvencia,
                           double hlasitosť)
```
Spustí prehrávanie tónu tvoreného jedinou harmonickou frekvenciou so zadanou hlasitosťou (v rozsahu od 0.0 do 1.0). Prehrávanie tónu zastaví volanie metódy zastavTón. Spustením tejto metódy sa zruší prípadný plán prehrávaných tónov vytvorený volaním metódy hrajTón(frekvencia, hlasitosť, trvanie).

Parametre:

frekvencia – harmonická frekvencia tónu v hertzoch

hlasitosť – hlasitosť prehrávaného tónu (0.0 – 1.0)

Pozri tiež:

frekvenciaNoty(int, int), hrajTón(double), hrajTón(double, double, double), zastavTón(), otvorSúborNaUloženieTónu(String), otvorSúborNaUloženieTónu(String, boolean), zavriSúborNaUloženieTónu(), generátorTónov(), Zvuk

hrajTon

public static void hrajTon(double frekvencia,
                           double hlasitosť)

Alias pre hrajTón.

hrajTón
```
public static void hrajTón(double frekvencia,
                           double hlasitosť,
                           double trvanie)
```
Spustí prehrávanie tónu tvoreného jedinou harmonickou frekvenciou so zadanou hlasitosťou (v rozsahu od 0.0 do 1.0) a s dĺžkou trvania prehrávania v sekundách. To znamená, že prehrávanie tónu sa automaticky zastaví po uplynutí zadaného časového intervalu. Prehrávanie tónu tiež môže byť predčasne zastavené volaním metódy zastavTón. Viacnásobné volanie tejto metódy vytvorí časový plán prehrávania tónov so zadanými frekvenciami, hlasitosťami a trvaním. Tento plán však rušia volania všetkých ostatných metód v kategórii prehrávania tónov: hrajTón(frekvencia), hrajTón(frekvencia, hlasitosť) a zastavTón().

Príklad:

Nasledujúci príklad naplánuje a prehrá zvuk, ktorého ukážka je nižšie.
```
for (double n = 1.0; n >= 0.0; n -= 0.05)
    Svet.hrajTón(100.0 + n * 25.0, n, 0.025);
```
Ukážka výsledku:

Zvuk „brum.wav“ na prevzatie.
Parametre:

frekvencia – harmonická frekvencia tónu v hertzoch

hlasitosť – hlasitosť prehrávaného tónu (0.0 – 1.0)

trvanie – trvanie prehrávania tónu v sekundách

Pozri tiež:

frekvenciaNoty(int, int), hrajTón(double), hrajTón(double, double), zastavTón(), otvorSúborNaUloženieTónu(String), otvorSúborNaUloženieTónu(String, boolean), zavriSúborNaUloženieTónu(), generátorTónov(), Zvuk

hrajTon

public static void hrajTon(double frekvencia,
                           double hlasitosť,
                           double trvanie)

Alias pre hrajTón.

zastavTón
```
public static void zastavTón()
```
Okamžite zastaví prehrávanie generovaného harmonického signálu a vyčistí vnútorný zoznam tónov naplánovaných na prehranie.

Príklad použitia tejto metódy nájdete v opise metódy hrajTón(frekvencia).

Pozri tiež:

frekvenciaNoty(int, int), hrajTón(double), hrajTón(double, double), hrajTón(double, double, double), otvorSúborNaUloženieTónu(String), otvorSúborNaUloženieTónu(String, boolean), zavriSúborNaUloženieTónu(), generátorTónov(), Zvuk

zastavTon
```
public static void zastavTon()
```
Alias pre zastavTón.

otvorSúborNaUloženieTónu
```
public static boolean otvorSúborNaUloženieTónu(String názov)
```
Umožní začať záznam všetkých generovaných tónov, ktorý sa po zavolaní párovej metódy zavriSúborNaUloženieTónu uloží do súboru s požadovaným názvom. Podporované formáty súborov (určené prislúchajúcou príponou) sú: AIFF (.aiff, .aif), AU (.au), SND (.snd) a WAVE (.wav). Ak zadaný súbor jestvuje, tak vznikne výnimka (soundAlreadyExists – pozri opis triedy GRobotException). Príklad použitia nájdete v opise metódy otvorSúborNaUloženieTónu(názov, prepísať).

Parametre:

názov – názov súboru na uloženie generovaného tónu

Návratová hodnota:

ak bolo všetko vykonané bezchybne, tak je návratová hodnota true

Pozri tiež:

frekvenciaNoty(int, int), hrajTón(double), hrajTón(double, double), hrajTón(double, double, double), zastavTón(), otvorSúborNaUloženieTónu(String, boolean), zavriSúborNaUloženieTónu(), generátorTónov(), Zvuk

otvorSuborNaUlozenieTonu

public static boolean otvorSuborNaUlozenieTonu(String názov)

Alias pre otvorSúborNaUloženieTónu.

otvorSúborNaUloženieTónu
```
public static boolean otvorSúborNaUloženieTónu(String názov,
                                               boolean prepísať)
```
Umožní začať záznam všetkých generovaných tónov, ktorý sa po zavolaní párovej metódy zavriSúborNaUloženieTónu uloží do súboru s požadovaným názvom. Podporované formáty súborov (určené prislúchajúcou príponou) sú: AIFF (.aiff, .aif), AU (.au), SND (.snd) a WAVE (.wav). Parameter prepísať určuje, či má byť prípadný jestvujúci súbor prepísaný, alebo nie. (Pričom v prípade, že jestvuje, a nemá byť prepísaný, vznikne výnimka – soundAlreadyExists, pozri opis triedy GRobotException.)

Príklad:

Nasledujúci príklad vygeneruje nízky, mierne vibrujúci tón „gongu“ (v podsate iba zvuk s plynule klesajúcou hlasitosťou) a uloží ho do súboru gong.wav. (Ukážka zvuku je nižšie.)
```
// Návratové hodnoty metód otvorSúborNaUloženieTónu
// a zavriSúborNaUloženieTónu by sme mohli aj ignorovať.
// Celý príklad by sa vykonal aj v prípade ich zlyhania,
// len by sa nič neuložilo…
if (Svet.otvorSúborNaUloženieTónu("gong.wav", true))
{
    for (int i = 32; i >= 0; --i)
    {
        Svet.hrajTón(212.0 + 16 * (i % 2), i * 0.025);
        Svet.čakaj(0.020);
    }

    Svet.zastavTón();
    Svet.čakaj(0.200);

    if (!Svet.zavriSúborNaUloženieTónu())
        System.err.println("Súbor zvuku sa nepodarilo zapísať.");
}
else System.err.println("Súbor na zápis zvuku sa nepodarilo otvoriť.");

// Ak by sme nevykonali nasledujúci príkaz, inštancia sveta by
// zostala stále otvorená (bez okna umožňujúceho jej zavretie)…
Svet.koniec();
```
Výsledok:

Zvuk „gong.wav“ na prevzatie.
Parametre:

názov – názov súboru na uloženie generovaného tónu

prepísať – určuje, či sa má prípadný jestvujúci súbor prepísať

Návratová hodnota:

ak bolo všetko vykonané bezchybne, tak je návratová hodnota true

Pozri tiež:

frekvenciaNoty(int, int), hrajTón(double), hrajTón(double, double), hrajTón(double, double, double), zastavTón(), otvorSúborNaUloženieTónu(String), zavriSúborNaUloženieTónu(), generátorTónov(), Zvuk

otvorSuborNaUlozenieTonu

public static boolean otvorSuborNaUlozenieTonu(String názov,
                                               boolean prepísať)

Alias pre otvorSúborNaUloženieTónu.

zavriSúborNaUloženieTónu
```
public static boolean zavriSúborNaUloženieTónu()
```
Ukončí záznam generovaných tónov, ktorý bol začatý volaním niektorej verzie metódy otvorSúborNaUloženieTónu.

Návratová hodnota:

ak bolo všetko vykonané bezchybne, tak je návratová hodnota true

Pozri tiež:

frekvenciaNoty(int, int), hrajTón(double), hrajTón(double, double), hrajTón(double, double, double), zastavTón(), otvorSúborNaUloženieTónu(String), otvorSúborNaUloženieTónu(String, boolean), generátorTónov(), Zvuk

zavriSuborNaUlozenieTonu
```
public static boolean zavriSuborNaUlozenieTonu()
```
Alias pre zavriSúborNaUloženieTónu.

generátorTónov
```
public static knižnica.podpora.BeepChannel generátorTónov()
```
Táto metóda sprostredkúva prístup k vnútornej inštancii generátora tónov (BeepChannel). Vlastnosti tohto generátora nie sú opísané v tejto dokumentácii, ale dajú sa naštudovať v angličtine z komentárov uvedených priamo v triedach BeepChannel a Channel. Aspoň jednou z nich sa zaoberá príklad uvedený nižšie.

Príklad:

Jednou zo základných vlastností generátora je úprava hladkosti prechodov medzi generovanými frekvenciami tónov (smoothness).

Tento príklad ukazuje rozdiel medzi dvomi rôznymi hodnotami hladkosti. Kód používa primitívny generátor pseudonáhodných čísiel, ktorý na vygenerovanie postupnosti frekvencií, ktoré majú byť prehraté používa jednoduché prepočty s prvočíslami. Aj pri zbežnom pohľade na kód by malo byť zjavné, že v obidvoch prípadoch budú „vygenerované“ (vypočítané) a prehrané rovnaké pseudonáhodné sekvencie frekvencií. Rozdiel je len v hladkosti použitej pri generovaní.

Prvé prehrávanie sekvencie je vykonané s hladkosťou 1000 (čo je predvolená hodnota) a druhé s hladkosťou 1 (čo je približne najmenšia dovolená hodnota hladkosti). Rozdiel si môžete vypočuť v ukážkach obidvoch prípadov, ktoré sú zverejnené nižšie.
```
int n, n1, n2, n3;
Svet.generátorTónov().setSmoothness(1000.0);

n1 = 3; n2 = 5; n3 = 7;
for (n = 1; n <= 100; ++n)
{
    Svet.hrajTón((n1 + n2 + n3) * 100);
    Svet.čakaj(0.020);

    n1 += 7; n1 %= 11;
    n2 += 11; n2 %= 13;
    n3 += 13; n3 %= 17;
}

Svet.zastavTón();
Svet.čakaj(0.200);

Svet.generátorTónov().setSmoothness(1.0);

n1 = 3; n2 = 5; n3 = 7;
for (n = 1; n <= 100; ++n)
{
    Svet.hrajTón((n1 + n2 + n3) * 100);
    Svet.čakaj(0.020);

    n1 += 7; n1 %= 11;
    n2 += 11; n2 %= 13;
    n3 += 13; n3 %= 17;
}

Svet.zastavTón();
Svet.čakaj(0.200);
```
Ukážky vygenerovaných sekvencií:

Zvuk „nahoda-01.wav“ na prevzatie.

Zvuk „nahoda-02.wav“ na prevzatie.
Pozri tiež:

frekvenciaNoty(int, int), hrajTón(double), hrajTón(double, double), hrajTón(double, double, double), zastavTón(), otvorSúborNaUloženieTónu(String), otvorSúborNaUloženieTónu(String, boolean), zavriSúborNaUloženieTónu(), Zvuk

generatorTonov

public static knižnica.podpora.BeepChannel generatorTonov()

Alias pre generátorTónov.

spustiČasovač
```
public static void spustiČasovač(double čas)
```
Spustí časovač so zadaným časovým intervalom v sekundách. Pri viacnásobnom volaní tejto metódy je časovač vždy zastavený (to aj vtedy, keď je zadaný rovnaký časový interval ako naposledy) a opätovne spustený s novým časovým intervalom.

Ďalšie podrobnosti o časovači sú uvedené v opise metódy spustiČasovač().

Parametre:

čas – časový interval v sekundách; desatinná časť je zaokrúhlená na milisekundy

Pozri tiež:

spustiČasovač(), odložČasovač(double), časovačAktívny(), intervalČasovača(), zastavČasovač(), násobTiky(int), tik()

spustiCasovac

public static void spustiCasovac(double čas)

Alias pre spustiČasovač.

spustiČasovač
```
public static void spustiČasovač()
```
Spustí časovač s naposledy zadaným časovým intervalom (v sekundách) alebo s predvoleným intervalom 40 milisekúnd (ak nebol v činnosti). (Štyridsať milisekúnd zodpovedá snímkovacej frekvencii 25 snímok za sekundu.) Viacnásobné volanie tejto metódy po spustení časovača je (na rozdiel od verzie spustiČasovač(čas)) ignorované.

Časovač spúšťa v zadanom časovom intervale metódy (reakcie) prislúchajúce udalostiam súvisiacim s časom, čo je reakcia ObsluhaUdalostí.tik(), v ktorej je v prípade potreby možné s výhodou získať objekt s informáciami o poslednej udalosti časovača prostredníctvom metódy ÚdajeUdalostí.tik(). Ďalšími dvomi najčastejšie spúšťanými reakciami sú robotova aktivita() a pasivita(), podľa toho, či je robot aktívny alebo pasívny, ale okrem nich môžu byť spúšťané rôzne ďalšie reakcie, ktoré v prostredí programovacieho rámca vznikajú ako zastavenie, dosiahnutie cieľa a mnoho iných, z ktorých žiadna bez aktívneho časovača nemôže fungovať.

Práve z toho dôvodu mnoho metód programovacieho rámca spúšťa časovač automaticky, čo sa však vždy dá potlačiť. Pozri napríklad: rýchlosť, uhlováRýchlosť…

Pozor! Časovač môže byť uspatý. Vtedy všetky metódy, ktoré menia jeho parametre fungujú, ale samotný časovač nereaguje – správa sa, ako keby negeneroval tiky (ale v skutočnosti ich len vynecháva). Podrobnosti o užitočnosti spánku časovača nájdete v opise metódy uspiČasovač.

Pozri tiež:

spustiČasovač(double), odložČasovač(double), časovačAktívny(), intervalČasovača(), zastavČasovač(), násobTiky(int), uspiČasovač(), tik()

spustiCasovac
```
public static void spustiCasovac()
```
Alias pre spustiČasovač.

odložČasovač
```
public static void odložČasovač(double čas)
```
Odloží časovač o zadaný časový interval v sekundách. Ak časovač doteraz nebol spustený, tak funguje rovnako ako metóda spustiČasovač, inak iba odloží najbližšie spustenie časovača o zadaný časový údaj.

Pozor! Časovač môže byť uspatý. Vtedy všetky metódy, ktoré menia jeho parametre fungujú, ale samotný časovač nereaguje – správa sa, ako keby negeneroval tiky (ale v skutočnosti ich len vynecháva). Podrobnosti o užitočnosti spánku časovača nájdete v opise metódy uspiČasovač.

Parametre:

čas – časový interval v sekundách; desatinná časť je zaokrúhlená na milisekundy

Pozri tiež:

spustiČasovač(double), časovačAktívny(), intervalČasovača(), zastavČasovač(), násobTiky(int), uspiČasovač(), tik()

odlozCasovac

public static void odlozCasovac(double čas)

Alias pre odložČasovač.

časovačAktívny
```
public static boolean časovačAktívny()
```
Zistí, či je časovač aktívny.

Pozor! Časovač môže byť uspatý. Vtedy všetky metódy, ktoré menia jeho parametre fungujú, ale samotný časovač nereaguje – správa sa, ako keby negeneroval tiky (ale v skutočnosti ich len vynecháva). Podrobnosti o užitočnosti spánku časovača nájdete v opise metódy uspiČasovač.

Návratová hodnota:

true/false – podľa toho, či je časovač aktívny, alebo nie

Pozri tiež:

spustiČasovač(double), spustiČasovač(), odložČasovač(double), intervalČasovača(), zastavČasovač(), násobTiky(int), uspiČasovač(), tik()

casovacAktivny
```
public static boolean casovacAktivny()
```
Alias pre časovačAktívny.

časovačSpustený
```
public static boolean časovačSpustený()
```
Alias pre časovačAktívny.

casovacSpusteny
```
public static boolean casovacSpusteny()
```
Alias pre časovačAktívny.

intervalČasovača
```
public static double intervalČasovača()
```
Vráti časový interval časovača v sekundách.

Pozor! Časovač môže byť uspatý. Vtedy všetky metódy, ktoré menia jeho parametre fungujú, ale samotný časovač nereaguje – správa sa, ako keby negeneroval tiky (ale v skutočnosti ich len vynecháva). Podrobnosti o užitočnosti spánku časovača nájdete v opise metódy uspiČasovač.

Návratová hodnota:

časový interval v sekundách; desatinná časť je zaokrúhlená na milisekundy

Pozri tiež:

spustiČasovač(double), spustiČasovač(), odložČasovač(double), časovačAktívny(), zastavČasovač(), násobTiky(int), uspiČasovač(), tik()

intervalCasovaca
```
public static double intervalCasovaca()
```
Alias pre intervalČasovača.

zastavČasovač
```
public static void zastavČasovač()
```
Zastaví časovač, ktorý bol spustený metódou spustiČasovač.

Pozor! Časovač môže byť uspatý. Vtedy všetky metódy, ktoré menia jeho parametre fungujú, ale samotný časovač nereaguje – správa sa, ako keby negeneroval tiky (ale v skutočnosti ich len vynecháva). Podrobnosti o užitočnosti spánku časovača nájdete v opise metódy uspiČasovač.

Pozri tiež:

spustiČasovač(double), spustiČasovač(), odložČasovač(double), časovačAktívny(), intervalČasovača(), násobTiky(int), uspiČasovač(), tik()

zastavCasovac
```
public static void zastavCasovac()
```
Alias pre zastavČasovač.

násobTiky
```
public static int násobTiky()
```
Zistí aktuálnu hodnotu násobičky tikov časovača. Pozri: násobTiky(počet).

Pozor! Časovač môže byť uspatý. Vtedy všetky metódy, ktoré menia jeho parametre fungujú, ale samotný časovač nereaguje – správa sa, ako keby negeneroval tiky (ale v skutočnosti ich len vynecháva). Podrobnosti o užitočnosti spánku časovača nájdete v opise metódy uspiČasovač.

Návratová hodnota:

aktuálna hodnota násobičky tikov

Pozri tiež:

násobTiky(int), čísloTiku(), spustiČasovač(double), uspiČasovač(), tik()

násobTiky
```
public static void násobTiky(int počet)
```
Upraví hodnotu násobičky tikov časovača. Ak je časovač zapnutý, tak sa zmenou tejto hodnoty dá upraviť počet cyklov rôznych operácií vykonaných v rámci jedného tiku. Ide o množstvo rôznych záležitostí ako sú aktivity alebo aj pasitivy robotov, kofeín, samotné reakcie na tik, prípadne ďalšie.

Príklad: Hodnota násobiča 2 spôsobí, že všetky aktivity vykonávané v rámci jedného tiku časovača budú vykonané pri každom tiku dvakrát za sebou. Takže ak je časovač využívaný napríklad na riadenie (regulovanie) simulácie, tak sa simulácia zdanlivo (to totiž závisí od výpočtových nárokov a výpočtového výkonu) urýchli (na dvojnásobok).

Upozornenie: Príliš veľké hodnoty násobiča preťažia systém.

Pozor! Časovač môže byť uspatý. Vtedy všetky metódy, ktoré menia jeho parametre fungujú, ale samotný časovač nereaguje – správa sa, ako keby negeneroval tiky (ale v skutočnosti ich len vynecháva). Podrobnosti o užitočnosti spánku časovača nájdete v opise metódy uspiČasovač.

Parametre:

počet – nová hodnota násobičky tikov

Pozri tiež:

násobTiky(), čísloTiku(), spustiČasovač(double), tik()

nasobTiky
```
public static int nasobTiky()
```
Alias pre násobTiky.

nasobTiky

public static void nasobTiky(int násobTiky)

Alias pre násobTiky.

čísloTiku
```
public static int čísloTiku()
```
Overí, ktorý násobok tiku je práve vykonávaný. Toto overenie má zmysel vykonávať len v rámci reakcií na tik. Pozri aj: násobTiky(počet).

Pozor! Časovač môže byť uspatý. Vtedy všetky metódy, ktoré menia jeho parametre fungujú, ale samotný časovač nereaguje – správa sa, ako keby negeneroval tiky (ale v skutočnosti ich len vynecháva). Podrobnosti o užitočnosti spánku časovača nájdete v opise metódy uspiČasovač.

Návratová hodnota:

aktuálne číslo tiku

Pozri tiež:

násobTiky(), násobTiky(int), spustiČasovač(double), uspiČasovač(), tik()

cisloTiku
```
public static int cisloTiku()
```
Alias pre čísloTiku.

časovačSpí
```
public static boolean časovačSpí()
```
Zistí, či je časovač v „režime spánku.“ Podrobnosti o užitočnosti spánku časovača nájdete v opise metódy uspiČasovač.

Pozri tiež:

časovačSpí(), uspiČasovač(), prebuďČasovač(), spustiČasovač(), časovačAktívny(), násobTiky(int), tik()

casovacSpi
```
public static boolean casovacSpi()
```
Alias pre časovačSpí.

uspiČasovač

public static void uspiČasovač()

Uvedie časovač do „režimu spánku.“ Keď časovač spí, preskakuje tiky, čiže sa zdá, ako keby nefungoval. Tento režim je veľmi užitočné zapnúť počas inicializácie aplikácie. Zabráni sa tým neželanému predčasnému spúšťaniu časovača (respektíve vykonávaniu jeho tikov aj keby bol spustený) v období, keď ešte nie sú všetky objekty korektne inicializované, čo by s vysokou pravdepodobnosťou viedlo ku vzniku chýb.

Príklad:

public static void main(String[] args)
{
    Svet.použiKonfiguráciu("MojaAplikácia.cfg");
    try
    {
        // Ak by v tomto bloku vznikla chyba, okno aplikácie bude aj tak
        // zobrazené vďaka bloku finally. Používateľ ho vďaka tomu bude môcť
        // aspoň korektne zavrieť.
        Svet.skry();
        Svet.nekresli();
        Svet.uspiČasovač();
        new MojaAplikácia();
        Svet.kresli();
        Svet.prebuďČasovač();
        Svet.spustiČasovač(); // (Aj keď už je pravdepodobne spustený.)
    }
    finally
    {
        Svet.zobraz();
    }
}

Pozri tiež:: časovačSpí(), uspiČasovač(), prebuďČasovač(), spustiČasovač(), časovačAktívny(), násobTiky(int), tik()

uspiCasovac
```
public static void uspiCasovac()
```
Alias pre uspiČasovač.

prebuďČasovač
```
public static void prebuďČasovač()
```
Prebudí časovač z „režimu spánku.“ Podrobnosti o užitočnosti spánku časovača nájdete v opise metódy uspiČasovač.

Pozri tiež:

časovačSpí(), uspiČasovač(), prebuďČasovač(), spustiČasovač(), časovačAktívny(), násobTiky(int), tik()

prebudCasovac
```
public static void prebudCasovac()
```
Alias pre prebuďČasovač.

zobuďČasovač
```
public static void zobuďČasovač()
```
Alias pre prebuďČasovač.

zobudCasovac
```
public static void zobudCasovac()
```
Alias pre prebuďČasovač.

tik
```
public static void tik()
```
Simuluje vykonanie reakcie na tik časovača. Vykonanie tejto metódy má zmysel mimo reťaze udalostí vykonávaných v rámci tiku časovača. Dá sa použiť napríklad na krokovanie tikov pri zastavenom časovači.

Upozornenie: Nezamieňajte si túto metódu s reakciami na časovač alebo údajmi udalosti časovača.

Pozor! Ak je časovač uspatý, tak volanie tejto metódy nemá žiadny efekt.

Pozri tiež:

násobTiky(int), spustiČasovač(double), uspiČasovač(), ObsluhaUdalostí.tik(), GRobot.tik(), ÚdajeUdalostí.tik()

čakaj
```
public static void čakaj(double početSekúnd)
```
Pozdrží vykonávanie programu na zadaný počet sekúnd.

Táto metóda v skutočnosti uspí aktuálne (pravdepodobne hlavné) vlákno aplikácie. Jej použitie musí byť vždy dobre zvážené. Môže nájsť využitie napríklad pri odľahčení procesora spomalením programu (výpočtu) pri výpočtovo náročných operáciách, treba však rátať so značným znížením výkonu. Môže byť tiež použitá na pozastavenie synchrónne vykonávaného programu (t. j. programu v jednom vlákne, ktorého činnosť sa končí prakticky okamžite po ukončení hlavnej metódy, čo je hlavný rozdiel oproti asynchrónne vykonávaným, čiže udalosťami riadeným, programom/aplikáciám).

(Pozri aj opisy ostatných metód na čakanie, ktorých využitie je, s výnimkou metódy čakajNaVstup, možné len v hlavnom vlákne, len pri synchrónnej činnosti programu.)

Parametre:

početSekúnd – počet sekúnd, na ktorý sa má vykonávanie programu zastaviť

Pozri tiež:

čakajNaVstup(), čakajNaKláves(), čakajNaKlik(), čakajNaKlikAleboKláves()

cakaj

public static void cakaj(double početSekúnd)

Alias pre čakaj.

spustiČasomieru
```
public static void spustiČasomieru()
```
Táto metóda „spustí“ časomieru. V skutočnosti metóda pracuje tak, že do vnútorného atribútu uloží aktuálny čas virtuálneho stroja v nanosekundách, ktorý sa neskôr použije (metódou zastavČasomieru) na vypočítanie trvania merania (v sekundách). Príklad použitia je v opise metódy zastavČasomieru.

Pozri tiež:

zastavČasomieru()

spustiCasomieru
```
public static void spustiCasomieru()
```
Alias pre spustiČasomieru.

zastavČasomieru
```
public static double zastavČasomieru()
```
Táto metóda „zastaví“ časomieru a vráti výsledok merania v sekundách. V skutočnosti metóda pracuje tak, že odčíta od aktuálneho času virtuálneho stroja v nanosekundách čas, ktorý bol zapamätaný pri spustení merania metódou spustiČasomieru a výsledok prepočíta na reálne číslo vyjadrujúce čas v sekundách (s presnosťou, ktorá by nemala byť nižšia než tri desatinné miesta – teoreticky by mohla dosahovať presnosť deväť desatinných miest (presnosť nanosekúnd), avšak skutočná presnosť je nižšia).

Príklad:
```
Svet.spustiČasomieru();

// Časovo náročná operácia, ktorej trvanie chceme odmerať…

double čas = Svet.zastavČasomieru(); // Výsledok merania je uložený v premennej „čas“

Svet.vypíšRiadok("Výsledný čas: ", čas, "s");
```
Výsledok:

Výsledkom môže byť napríklad takýto výpis:
```
Výsledný čas: 6,475 s
```
Návratová hodnota:

nameraný čas v sekundách

Pozri tiež:

spustiČasomieru()

zastavCasomieru
```
public static double zastavCasomieru()
```
Alias pre zastavČasomieru.

lineárnaInterpolácia
```
public static final double lineárnaInterpolácia(double a,
                                                double b,
                                                double t)
```
Táto metóda slúži na parametrické vypočítanie hodnoty ležiacej medzi dvomi zadanými hodnotami.

Okrem lineárnej interpolácie podporuje rámec výpočet kvadratickej a kubickej interpolácie a aproximácie:
Hlavný rozdiel medzi interpoláciou a aproximáciou je, že (zjednodušene povedané) interpolácia prechádza všetkými bodmi, pomocou ktorých počíta „chýbajúce“ hodnoty a aproximácia vychádza z prvého bodu, vchádza do posledného bodu a hodnotami ostantných bodov sa iba riadi – môže, ale nemusí nimi prechádzať (zväčša ani neprechádza). Lineárnou aproximáciou sa tento rámec nezaoberá a všetky ostatné interpolácie a aproximácie počítajú hodnoty len medzi minimálnymi počtami vstupných hodnôt.

Ani jedna z metód neobmedzuje hodnoty parametra t, ktorý (ak hovoríme o interpolácii a aproximácii) by síce mal nadobúdať hodnoty v rozsahu od 0,0 do 1,0 (vrátane), ale ak tento rozsah prekročí, môžu byť všetky metódy (vo vhodnej miere) využité aj na extrapoláciu hodnôt mimo tohto intervalu. Ani jeden z algoritmov nepoužíva delenie, takže hodnota parametra môže byť ľubovoľná, no treba rátať s tým, že po príliš veľkom prekročení intervalu už nemôžeme hovoriť ani o extrapolácii.

S pomocou lineárnej interpolácie je možné získať ľubovoľnú „priamočiaru“ hodnotu ležiacu medzi hodnotami a a b a to pomocou parametra t. Parameter t by mal nadobúdať hodnoty medzi 0.0 a 1.0. Keď je lineárna interpolácia použitá napríklad so začiatočnými a koncovými súradnicami bodu (dva výpočty: jeden pre x1 až x2 a druhý pre y1 až y2 – s rovnakými hodnotami parametera t, ktoré by mali ležať v rozmedzí hodnôt 0.0 až 1.0), tak výsledkom výpočtov lineárnej interpolácie budú body ležiace na úsečke medzi určenými súradnicami bodov.

Body vypočítané pomocou lineárnej interpolácie ležiace na nakreslenej úsečke.

Poznámka: Podmieňovací spôsob („by mali“) použitý výššie v súvislosti hodnotou parametra t bol použitý úmyselne. Zamerajme sa na príklad kreslenia bodov (podľa súradníc vypočítaných pomocou lineárnej interpolácie) ležiacich na úsečke s počiatočným bodom A[x₁, y₁] a koncovým bodom B[x₂, y₂]. Ak sa hodnota parametra t bude nachádzať mimo povoleného (resp. odporúčaného) rozashu ⟨0; 1⟩, tak vypočítame bod ležiaci na priamke určenej hraničnými bodmi A a B, ktorý neleží na úsečke AB.

Príklad:

Nasledujúci príklad nakreslí body ležiace na úsečke vypočítané pomocou lineárnej interpolácie.
```
final Bod[] body = new Bod([2];
body[0] = new Bod(-160, -80);
body[1] = new Bod(130, 60);

for (double t = 0.0; t <= 1.0; t += 0.1)
{
    double x = Svet.lineárnaInterpolácia(
        body[0].polohaX(), body[1].polohaX(), t);
    double y = Svet.lineárnaInterpolácia(
        body[0].polohaY(), body[1].polohaY(), t);

    skočNa(x, y);
    kružnica(6);
}
```
Výsledok:

Výsledok príkladu lineárnej interpolácie.
Parametre:

a – prvá hodnota určujúca lineárnu interpoláciu

b – druhá hodnota určujúca lineárnu interpoláciu

t – parameter interpolácie – mal by ležať v rozmedzí hodnôt 0.0 až 1.0

Návratová hodnota:

výsledok interpolácie

Pozri tiež:

kvadratickáInterpolácia(double, double, double, double), kubickáInterpolácia(double, double, double, double, double), kvadratickáAproximácia(double, double, double, double), kubickáAproximácia(double, double, double, double, double)

linearnaInterpolacia

public static final double linearnaInterpolacia(double a,
                                                double b,
                                                double t)

Alias pre lineárnaInterpolácia.

kvadratickáInterpolácia
```
public static final double kvadratickáInterpolácia(double a,
                                                   double b,
                                                   double c,
                                                   double t)
```
Kvadratická interpolácia je počítaná z troch vstupných hodnôt (a parametra).

Pozri aj kvadratickú aproximáciu a zhrnutie rozdielu medzi interpoláciou a aproximáciou v opise metódy počítajúcej lineárnu interpoláciu.

Porovnanie kvadratickej interpolácie (body rôznych farieb tvoriace „vonkajšiu obálku“ lomenej čiary) a aproximácie (modré body).

Ukážka použitia na interpolovanie dvoch súradníc:
```
// …

for (double t = 0.0; t <= 1.05; t += 0.05)
{
    double x = Svet.kvadratickáInterpolácia(x1, x2, x3, t);
    double y = Svet.kvadratickáInterpolácia(y1, y2, y3, t);

    // …
}
```
Parametre:

a – prvá hodnota určujúca kvadratickú interpoláciu

b – druhá hodnota určujúca kvadratickú interpoláciu

c – tretia hodnota určujúca kvadratickú interpoláciu

t – parameter interpolácie – mal by ležať v rozmedzí hodnôt 0.0 až 1.0

Návratová hodnota:

výsledok interpolácie

Pozri tiež:

lineárnaInterpolácia(double, double, double), kubickáInterpolácia(double, double, double, double, double), kvadratickáAproximácia(double, double, double, double), kubickáAproximácia(double, double, double, double, double)

kvadratickaInterpolacia

public static final double kvadratickaInterpolacia(double a,
                                                   double b,
                                                   double c,
                                                   double t)

Alias pre kvadratickáInterpolácia.

kubickáInterpolácia
```
public static final double kubickáInterpolácia(double v0,
                                               double v1,
                                               double v2,
                                               double v3,
                                               double t)
```
Kubická interpolácia je počítaná zo štyroch vstupných hodnôt (a parametra).

Pozri aj kubickú aproximáciu a zhrnutie rozdielu medzi interpoláciou a aproximáciou v opise metódy počítajúcej lineárnu interpoláciu.

Body vypočítané s použitím dvojice kubických interpolácií.

Parametre:

v0 – prvá hodnota určujúca kubickú interpoláciu

v1 – druhá hodnota určujúca kubickú interpoláciu

v2 – tretia hodnota určujúca kubickú interpoláciu

v3 – štvrtá hodnota určujúca kubickú interpoláciu

t – parameter interpolácie – mal by ležať v rozmedzí hodnôt 0.0 až 1.0

Návratová hodnota:

výsledok interpolácie

Pozri tiež:

lineárnaInterpolácia(double, double, double), kvadratickáInterpolácia(double, double, double, double), kvadratickáAproximácia(double, double, double, double), kubickáAproximácia(double, double, double, double, double)

kubickaInterpolacia

public static final double kubickaInterpolacia(double v0,
                                               double v1,
                                               double v2,
                                               double v3,
                                               double t)

Alias pre kubickáInterpolácia.

kvadratickáAproximácia

public static final double kvadratickáAproximácia(double a,
                                                  double b,
                                                  double c,
                                                  double t)

Kvadratická aproximácia je počítaná z troch vstupných hodnôt (a parametra). Ak túto metódu použijeme na dve série vstupných hodnôt (dve súradnice), tak posúvaním parametra t získame polohy bodov na kvadratickej (v tomto prípade bézierovej) krivke.

Pozri aj kvadratickú interpoláciu a zhrnutie rozdielu medzi interpoláciou a aproximáciou v opise metódy počítajúcej lineárnu interpoláciu.

Príklad:

Nasledujúce dva riadky kódu vypočítajú súradnice bodu ([x, y]) na kvadratickej (bézierovej) krivke v mieste, kde je hodnota parametra aproximácie (t) rovná 0,5:

x = Svet.kvadratickáAproximácia(x1, x2, x3, 0.5);
y = Svet.kvadratickáAproximácia(y1, y2, y3, 0.5);

Ukážky možných výsledkov:

Ukážky znázorňujú krivky kreslené medzi bodmi A a B (so súradnicami x1, y1 a x3, y3), ktorých tvar upravuje poloha bodu C (so súradnicami x2, y2). Poloha bodu V (so súradnicami x, y) v mieste hodnoty parametra aproximácie t = 0,5, je znázornená zelenou farbou. Pod každým obrázkom je výpis všetkých hodnôt vzťahujúcich sa k obrázku.


Hodnoty súradníc kľúčových bodov: x1 = −100,0; y1 = −100,0 x2 = 0,0; y2 = 100,0 x3 = 100,0; y3 = 0,0 Vypočítané hodnoty súradníc v mieste parametra t = 0,5: x = 0,0; y = 25,0		Hodnoty súradníc kľúčových bodov: x1 = −100,0; y1 = −100,0 x2 = 0,0; y2 = 100,0 x3 = 100,0; y3 = 100,0 Vypočítané hodnoty súradníc v mieste parametra t = 0,5: x = 0,0; y = 50,0

Hodnoty súradníc kľúčových bodov: x1 = −100,0; y1 = −100,0 x2 = 100,0; y2 = 0,0 x3 = 100,0; y3 = 100,0 Vypočítané hodnoty súradníc v mieste parametra t = 0,5: x = 50,0; y = 0,0		Hodnoty súradníc kľúčových bodov: x1 = −100,0; y1 = 100,0 x2 = 0,0; y2 = −100,0 x3 = 100,0; y3 = 100,0 Vypočítané hodnoty súradníc v mieste parametra t = 0,5: x = 0,0; y = 0,0

Parametre:: a – prvá hodnota určujúca kvadratickú aproximáciu; b – druhá hodnota určujúca kvadratickú aproximáciu; c – tretia hodnota určujúca kvadratickú aproximáciu; t – parameter aproximácie – mal by ležať v rozmedzí hodnôt 0.0 až 1.0
Návratová hodnota:: výsledok aproximácie
Pozri tiež:: lineárnaInterpolácia(double, double, double), kvadratickáInterpolácia(double, double, double, double), kubickáInterpolácia(double, double, double, double, double), kubickáAproximácia(double, double, double, double, double)

kvadratickaAproximacia

public static final double kvadratickaAproximacia(double a,
                                                  double b,
                                                  double c,
                                                  double t)

Alias pre kvadratickáAproximácia.

kubickáAproximácia

public static final double kubickáAproximácia(double v0,
                                              double v1,
                                              double v2,
                                              double v3,
                                              double t)

Kubická aproximácia je počítaná zo štyroch vstupných hodnôt (a parametra). Význam parametrov sa lepšie vysvetľuje na príklade kreslenia krivky s použitím tejto aproximácie. Aproximujme dvojice súradníc štyroch kľúčových bodov ([x0, y0] až [x3, y3]). V takom prípade prvá a posledná dvojica súradníc určujú „smer“ kubickej krivky a prostredné dve určujú počiatočný a koncový bod krivky. Výsledkom takejto aproximácie sú body ležiace na kubickej krivke.

Pozri aj kubickú interpoláciu a zhrnutie rozdielu medzi interpoláciou a aproximáciou v opise metódy počítajúcej lineárnu interpoláciu.

Body vypočítané s použitím
kubickej aproximácie.

Body vypočítané s použitím kubickej aproximácie zo štyroch označených
kľúčových bodov – vypočítané body ležia na kubickej krivke.

Príklad:

Nasledujúci príklad ukazuje interaktívny test kubickej aproximácie (po preložení a spustení príkladu je klikaním a posúvaním bodov možné ovplyvňovať kresbu).

import knižnica.*;

public class TestAproximácie extends GRobot
{
    // Aktívny bod (predvolene je to prvý bod – s indexom nula).
    private int bod = 0;

    // Definícia štvorice kľúčových bodov.
    private Bod[] body = new Bod([4];
    {
        body[0] = new Bod(-100, -70);
        body[1] = new Bod(-100, 40);
        body[2] = new Bod(100, 40);
        body[3] = new Bod(100, -70);
    }

    // Konštruktor.
    private TestAproximácie()
    {
        zdvihniPero();
        skry();
        Svet.nekresli();
        prekresli();
    }

    // Prekresľovanie kresby.
    private void prekresli()
    {
        Svet.vymaž();

        farba(čierna);

        for (double t = 0.0; t <= 1.0; t += 0.1)
        {
            double x = Svet.kubickáAproximácia(body[0].polohaX(),
                body[1].polohaX(), body[2].polohaX(), body[3].polohaX(), t);
            double y = Svet.kubickáAproximácia(body[0].polohaY(),
                body[1].polohaY(), body[2].polohaY(), body[3].polohaY(), t);

            skočNa(x, y);
            kružnica(6);
        }

        farba(červená);

        for (int i = 0; i < 4; ++i)
        {
            skočNa(body[i]);
            kružnica(3);
        }

        Svet.prekresli();
    }

    // Vyhľadanie a aktivácia bodu, na ktorý bolo kliknuté
    // (ak nebolo kliknuté na žiadny konkrétny bod, zostane
    // aktívny posledný aktivovaný bod).
    // Aktívny bod je zároveň presunutý na myš.
    @Override public void stlačenieTlačidlaMyši()
    {
        for (int i = 0; i < 4; ++i)
        {
            skočNa(body[i]);
            if (myšVKruhu(10)) bod = i;
        }

        body[bod] = ÚdajeUdalostí.polohaMyši();
        prekresli();
    }

    // Presúvanie aktívneho bodu na súradnice myši.
    @Override public void ťahanieMyšou()
    {
        body[bod] = ÚdajeUdalostí.polohaMyši();
        prekresli();
    }

    // Hlavná metóda.
    public static void main(String[] args)
    {
        new TestAproximácie();
    }
}

Parametre:: v0 – prvá hodnota určujúca kubickú aproximáciu; v1 – druhá hodnota určujúca kubickú aproximáciu; v2 – tretia hodnota určujúca kubickú aproximáciu; v3 – štvrtá hodnota určujúca kubickú aproximáciu; t – parameter aproximácie – mal by ležať v rozmedzí hodnôt 0.0 až 1.0
Návratová hodnota:: výsledok aproximácie
Pozri tiež:: lineárnaInterpolácia(double, double, double), kvadratickáInterpolácia(double, double, double, double), kubickáInterpolácia(double, double, double, double, double), kvadratickáAproximácia(double, double, double, double)

kubickaAproximacia

public static final double kubickaAproximacia(double v0,
                                              double v1,
                                              double v2,
                                              double v3,
                                              double t)

Alias pre kubickáAproximácia.

prepočítajX
```
public static double prepočítajX(double x)
```
Prepočíta zadanú x-ovú (horizontálnu) súradnicu zo súradnicového priestoru programovacieho rámca GRobot do súradnicového priestoru používaného v oblasti 2D počítačovej grafiky.

Poznámka: Programovací rámec ako prostriedok primárne vyvíjaný na účely výučby pracuje s „klasickým“ karteziánskym súradnicovým systémom, pri používaní ktorého je počiatok súradnicovej sústavy („stred“ – bod so súradnicami [0, 0]) obvykle umiestňovaný do stredu kresliacej plochy, horizontálna súradnica (x-ová) rastie zľava doprava a vertikálna súradnica (y-ová) rastie zospodu nahor. Naproti tomu, v 2D počítačovej grafike je bežné umiestnenie počiatku súradnicovej sústavy v ľavom hornom rohu kresliacej plochy (obrazovky) a z toho dôvodu býva rast vertikálnej súradnice prevrátený – súradnica narastá smerom zhora nadol. (Tento rozdiel je diskutovaný na viacerých miestach tejto dokumentácie. Pozri napríklad opis metódy cesta.)

Parametre:

x – hodnota súradnice x v súradnicovom priestore programovacieho rámca GRobot

Návratová hodnota:

hodnota súradnice v súradnicovom priestore počítačovej grafiky (to jest v tom súradnicovom priestore, ktorý predvolene používa aj jazyk Java pri práci s 2D grafikou)

prepocitajX

public static double prepocitajX(double x)

Alias pre prepočítajX.

prepočítajY
```
public static double prepočítajY(double y)
```
Prepočíta zadanú y-ovú (vertikálnu) súradnicu zo súradnicového priestoru programovacieho rámca GRobot do súradnicového priestoru používaného v oblasti 2D počítačovej grafiky.

Poznámka: Programovací rámec ako prostriedok primárne vyvíjaný na účely výučby pracuje s „klasickým“ karteziánskym súradnicovým systémom, pri používaní ktorého je počiatok súradnicovej sústavy („stred“ – bod so súradnicami [0, 0]) obvykle umiestňovaný do stredu kresliacej plochy, horizontálna súradnica (x-ová) rastie zľava doprava a vertikálna súradnica (y-ová) rastie zospodu nahor. Naproti tomu, v 2D počítačovej grafike je bežné umiestnenie počiatku súradnicovej sústavy v ľavom hornom rohu kresliacej plochy (obrazovky) a z toho dôvodu býva rast vertikálnej súradnice prevrátený – súradnica narastá smerom zhora nadol. (Tento rozdiel je diskutovaný na viacerých miestach tejto dokumentácie. Pozri napríklad opis metódy cesta.)

Parametre:

y – hodnota súradnice y v súradnicovom priestore programovacieho rámca GRobot

Návratová hodnota:

hodnota súradnice v súradnicovom priestore počítačovej grafiky (to jest v tom súradnicovom priestore, ktorý predvolene používa aj jazyk Java pri práci s 2D grafikou)

prepocitajY

public static double prepocitajY(double y)

Alias pre prepočítajY.

prepočítajSpäťX
```
public static double prepočítajSpäťX(double x)
```
Prepočíta zadanú x-ovú (horizontálnu) súradnicu zo súradnicového priestoru používaného v oblasti 2D počítačovej grafiky do súradnicového priestoru programovacieho rámca GRobot.

Poznámka: Programovací rámec ako prostriedok primárne vyvíjaný na účely výučby pracuje s „klasickým“ karteziánskym súradnicovým systémom, pri používaní ktorého je počiatok súradnicovej sústavy („stred“ – bod so súradnicami [0, 0]) obvykle umiestňovaný do stredu kresliacej plochy, horizontálna súradnica (x-ová) rastie zľava doprava a vertikálna súradnica (y-ová) rastie zospodu nahor. Naproti tomu, v 2D počítačovej grafike je bežné umiestnenie počiatku súradnicovej sústavy v ľavom hornom rohu kresliacej plochy (obrazovky) a z toho dôvodu býva rast vertikálnej súradnice prevrátený – súradnica narastá smerom zhora nadol. (Tento rozdiel je diskutovaný na viacerých miestach tejto dokumentácie. Pozri napríklad opis metódy cesta.)

Parametre:

x – hodnota súradnice v súradnicovom priestore počítačovej grafiky (to jest v tom súradnicovom priestore, ktorý predvolene používa aj jazyk Java pri práci s 2D grafikou)

Návratová hodnota:

hodnota súradnice x v súradnicovom priestore programovacieho rámca GRobot

prepocitajSpatX

public static double prepocitajSpatX(double x)

Alias pre prepočítajSpäťX.

prepočítajSpäťY
```
public static double prepočítajSpäťY(double y)
```
Prepočíta zadanú y-ovú (vertikálnu) súradnicu zo súradnicového priestoru používaného v oblasti 2D počítačovej grafiky do súradnicového priestoru programovacieho rámca GRobot.

Poznámka: Programovací rámec ako prostriedok primárne vyvíjaný na účely výučby pracuje s „klasickým“ karteziánskym súradnicovým systémom, pri používaní ktorého je počiatok súradnicovej sústavy („stred“ – bod so súradnicami [0, 0]) obvykle umiestňovaný do stredu kresliacej plochy, horizontálna súradnica (x-ová) rastie zľava doprava a vertikálna súradnica (y-ová) rastie zospodu nahor. Naproti tomu, v 2D počítačovej grafike je bežné umiestnenie počiatku súradnicovej sústavy v ľavom hornom rohu kresliacej plochy (obrazovky) a z toho dôvodu býva rast vertikálnej súradnice prevrátený – súradnica narastá smerom zhora nadol. (Tento rozdiel je diskutovaný na viacerých miestach tejto dokumentácie. Pozri napríklad opis metódy cesta.)

Parametre:

y – hodnota súradnice v súradnicovom priestore počítačovej grafiky (to jest v tom súradnicovom priestore, ktorý predvolene používa aj jazyk Java pri práci s 2D grafikou)

Návratová hodnota:

hodnota súradnice y v súradnicovom priestore programovacieho rámca GRobot

prepocitajSpatY

public static double prepocitajSpatY(double y)

Alias pre prepočítajSpäťY.

rotovanéX
```
public static final double rotovanéX(double x,
                                     double y,
                                     double uhol)
```
Vráti výpočet x-ovej súradnice zadaného bodu pootočeného okolo stredu súradnicovej sústavy o zadaný uhol.

Parametre:

x – x-ová súradnica pôvodného bodu

y – y-ová súradnica pôvodného bodu

uhol – uhol pootočenia

Pozri tiež:

rotovanéY(double, double, double)

rotovaneX

public static final double rotovaneX(double x,
                                     double y,
                                     double uhol)

Alias pre rotovanéX.

rotovanéY
```
public static final double rotovanéY(double x,
                                     double y,
                                     double uhol)
```
Vráti výpočet y-ovej súradnice zadaného bodu pootočeného okolo stredu súradnicovej sústavy o zadaný uhol.

Parametre:

x – x-ová súradnica pôvodného bodu

y – y-ová súradnica pôvodného bodu

uhol – uhol pootočenia

Pozri tiež:

rotovanéX(double, double, double)

rotovaneY

public static final double rotovaneY(double x,
                                     double y,
                                     double uhol)

Alias pre rotovanéY.

priesečníkÚsečiek

public static final Bod priesečníkÚsečiek(double x0,
                                          double y0,
                                          double x1,
                                          double y1,
                                          double x2,
                                          double y2,
                                          double x3,
                                          double y3)

Hľadá priesečník dvoch úsečiek AB a CD. Úsečky sú určené súradnicami počiatočných a koncových bodov – AB: A[x0, y0], B[x1, y1] a CD: C[x2, y2], D[x3, y3]. Ak priesečník jestvuje, tak metóda vráti inštanciu triedy Bod so súradnicami priesečníka, inak metóda vráti hodnotu null.

Ukážka použitia:

// Keď máme k dispozícii polohy bodov, môžeme využiť inú verziu tejto metódy:
final Bod b1 = new Bod(-120, -40);
final Bod b2 = new Bod(110, 70);
final Bod b3 = new Bod(-120, 110);
final Bod b4 = new Bod(110, -110);

Bod p = Svet.priesečníkÚsečiek(b1, b2, b3, b4);

Parametre:: x0 – x-ová súradnica bodu A; y0 – y-ová súradnica bodu A; x1 – x-ová súradnica bodu B; y1 – y-ová súradnica bodu B; x2 – x-ová súradnica bodu C; y2 – y-ová súradnica bodu C; x3 – x-ová súradnica bodu D; y3 – y-ová súradnica bodu D
Návratová hodnota:: priesečník v inštancii triedy Bod alebo null

priesecnikUseciek

public static final Bod priesecnikUseciek(double x0,
                                          double y0,
                                          double x1,
                                          double y1,
                                          double x2,
                                          double y2,
                                          double x3,
                                          double y3)

Alias pre priesečníkÚsečiek.

priesečníkÚsečiek
```
public static final Bod priesečníkÚsečiek(Poloha A,
                                          Poloha B,
                                          Poloha C,
                                          Poloha D)
```
Hľadá priesečník dvoch úsečiek AB a CD. Úsečky sú určené polohami bodov v štyroch parametroch. Ak priesečník jestvuje, tak metóda vráti inštanciu triedy Bod so súradnicami priesečníka, inak metóda vráti hodnotu null.

Parametre:

A – poloha bodu A

B – poloha bodu B

C – poloha bodu C

D – poloha bodu D

Návratová hodnota:

priesečník v inštancii triedy Bod alebo null

priesecnikUseciek

public static final Bod priesecnikUseciek(Poloha A,
                                          Poloha B,
                                          Poloha C,
                                          Poloha D)

Alias pre priesečníkÚsečiek.

priesečníkÚsečiek
```
public static final Bod priesečníkÚsečiek(Poloha[] poleBodov)
```
Hľadá priesečník dvoch úsečiek AB a CD. Úsečky sú určené polohami bodov v poli parametra, ktoré musí obsahovať aspoň štyri prvky. Ak priesečník jestvuje, tak metóda vráti inštanciu triedy Bod so súradnicami priesečníka, inak metóda vráti hodnotu null.

Parametre:

poleBodov – polohy bodov úsečiek AB a CD

Návratová hodnota:

priesečník v inštancii triedy Bod alebo null

priesecnikUseciek

public static final Bod priesecnikUseciek(Poloha[] poleBodov)

Alias pre priesečníkÚsečiek.

priesečníkPriamkyAÚsečky
```
public static final Bod priesečníkPriamkyAÚsečky(double x0,
                                                 double y0,
                                                 double x1,
                                                 double y1,
                                                 double x2,
                                                 double y2,
                                                 double x3,
                                                 double y3)
```
Hľadá priesečník priamky AB a úsečky CD. Obidve čiary sú určené súradnicami dvoch bodov – AB: A[x0, y0], B[x1, y1] a CD: C[x2, y2], D[x3, y3], pričom pre úsečku ide zároveň o ohraničujúce body. Ak priesečník jestvuje, tak metóda vráti inštanciu triedy Bod so súradnicami priesečníka, inak metóda vráti hodnotu null.

Parametre:

x0 – x-ová súradnica bodu A

y0 – y-ová súradnica bodu A

x1 – x-ová súradnica bodu B

y1 – y-ová súradnica bodu B

x2 – x-ová súradnica bodu C

y2 – y-ová súradnica bodu C

x3 – x-ová súradnica bodu D

y3 – y-ová súradnica bodu D

Návratová hodnota:

priesečník v inštancii triedy Bod alebo null

priesecnikPriamkyAUsecky

public static final Bod priesecnikPriamkyAUsecky(double x0,
                                                 double y0,
                                                 double x1,
                                                 double y1,
                                                 double x2,
                                                 double y2,
                                                 double x3,
                                                 double y3)

Alias pre priesečníkPriamkyAÚsečky.

priesečníkPriamkyAÚsečky
```
public static final Bod priesečníkPriamkyAÚsečky(Poloha A,
                                                 Poloha B,
                                                 Poloha C,
                                                 Poloha D)
```
Hľadá priesečník priamky AB a úsečky CD. Čiary sú určené polohami bodov v štyroch parametroch. Ak priesečník jestvuje, tak metóda vráti inštanciu triedy Bod so súradnicami priesečníka, inak metóda vráti hodnotu null.

Parametre:

A – poloha bodu A

B – poloha bodu B

C – poloha bodu C

D – poloha bodu D

Návratová hodnota:

priesečník v inštancii triedy Bod alebo null

priesecnikPriamkyAUsecky

public static final Bod priesecnikPriamkyAUsecky(Poloha A,
                                                 Poloha B,
                                                 Poloha C,
                                                 Poloha D)

Alias pre priesečníkPriamkyAÚsečky.

priesečníkPriamkyAÚsečky
```
public static final Bod priesečníkPriamkyAÚsečky(Poloha[] poleBodov)
```
Hľadá priesečník priamky AB a úsečky CD. Čiary sú určené polohami bodov v poli parametra, ktoré musí obsahovať aspoň štyri prvky. Ak priesečník jestvuje, tak metóda vráti inštanciu triedy Bod so súradnicami priesečníka, inak metóda vráti hodnotu null.

Parametre:

poleBodov – polohy bodov patriacich čiaram AB a CD

Návratová hodnota:

priesečník v inštancii triedy Bod alebo null

priesecnikPriamkyAUsecky

public static final Bod priesecnikPriamkyAUsecky(Poloha[] poleBodov)

Alias pre priesečníkPriamkyAÚsečky.

priesečníkPriamok

public static final Bod priesečníkPriamok(double x0,
                                          double y0,
                                          double x1,
                                          double y1,
                                          double x2,
                                          double y2,
                                          double x3,
                                          double y3)

Hľadá priesečník dvoch priamok určených bodmi A, B a C, D. Ak priesečník jestvuje, tak metóda vráti inštanciu triedy Bod so súradnicami priesečníka, inak metóda vráti hodnotu null.

Ukážka použitia:

// Keď máme k dispozícii polohy bodov, môžeme využiť inú verziu tejto metódy:
final Bod b1 = new Bod(-80, -100);
final Bod b2 = new Bod(90, 100);
final Bod b3 = new Bod(-80, 100);
final Bod b4 = new Bod(90, -110);

Bod p = Svet.priesečníkPriamok(b1, b2, b3, b4);

Hľadanie priesečníka priamok je použité aj v príklade uvedenom v opise metódy mimoHraníc.

Parametre:: x0 – x-ová súradnica bodu A; y0 – y-ová súradnica bodu A; x1 – x-ová súradnica bodu B; y1 – y-ová súradnica bodu B; x2 – x-ová súradnica bodu C; y2 – y-ová súradnica bodu C; x3 – x-ová súradnica bodu D; y3 – y-ová súradnica bodu D
Návratová hodnota:: priesečník v inštancii triedy Bod alebo null

priesecnikPriamok

public static final Bod priesecnikPriamok(double x0,
                                          double y0,
                                          double x1,
                                          double y1,
                                          double x2,
                                          double y2,
                                          double x3,
                                          double y3)

Alias pre priesečníkPriamok.

priesečníkPriamok
```
public static final Bod priesečníkPriamok(Poloha A,
                                          Poloha B,
                                          Poloha C,
                                          Poloha D)
```
Hľadá priesečník dvoch priamok určených bodmi A, B a C, D. Ak priesečník jestvuje, tak metóda vráti inštanciu triedy Bod so súradnicami priesečníka, inak metóda vráti hodnotu null.

Hľadanie priesečníka priamok je použité aj v príklade uvedenom v opise metódy mimoHraníc.

Parametre:

A – poloha bodu A

B – poloha bodu B

C – poloha bodu C

D – poloha bodu D

Návratová hodnota:

priesečník v inštancii triedy Bod alebo null

priesecnikPriamok

public static final Bod priesecnikPriamok(Poloha A,
                                          Poloha B,
                                          Poloha C,
                                          Poloha D)

Alias pre priesečníkPriamok.

priesečníkPriamok
```
public static final Bod priesečníkPriamok(Poloha[] poleBodov)
```
Hľadá priesečník dvoch priamok určených polohami bodov v poli parametra. Pole musí obsahovať aspoň štyri prvky. Ak priesečník jestvuje, tak metóda vráti inštanciu triedy Bod so súradnicami priesečníka, inak metóda vráti hodnotu null.

Hľadanie priesečníka priamok je použité aj v príklade uvedenom v opise metódy mimoHraníc.

Parametre:

poleBodov – polohy bodov určujúce priamky

Návratová hodnota:

priesečník v inštancii triedy Bod alebo null

priesecnikPriamok

public static final Bod priesecnikPriamok(Poloha[] poleBodov)

Alias pre priesečníkPriamok.

priesečníkyKružníc

public static final Bod[] priesečníkyKružníc(double x1,
                                             double y1,
                                             double r1,
                                             double x2,
                                             double y2,
                                             double r2)

Hľadá priesečníky dvoch kružníc určených súradnicami ich stredov S1[x1, y1] a S2[x2, y2] a polomermi r1 a r2. Ak jestvuje aspoň jeden priesečník, tak metóda vráti jedno- alebo dvojprvkové pole bodov určujúcich súradnice priesečníkov. Ak nejestvuje ani jeden priesečník, tak metóda vráti hodnotu null.

Priesečníky
kružníc

Na obrázku sú štyri kružnice. Dve majú jediný priesečník, dve dva priesečníky a zvyšné žiadny priesečník. V prvom prípade vráti metóda priesečníkyKružníc jednoprvkové pole, v druhom dvojprvkové a v ostatných prípadoch hodnotu null.

Príklad:

Obrázok vyššie sa dá vykresliť pomocou nasledujúceho príkladu. Príklad ukazuje definíciu pomocnej triedy Kružnica, definíciu štyroch kružníc a nájdenie a zobrazenie všetkých ich priesečníkov. (Podrobnosti sú v komentároch.)

import knižnica.*;

public class PriesečníkyKružníc extends GRobot
{
    // Pomocná trieda slúžiaca na uloženie základných údajov o kružnici
    // (stredu a polomeru) a na nakreslenie kružnice.
    private final class Kružnica
    {
        // Atribúty kružnice:
        public final Bod S;
        public final double r;

        // Konštruktor kružnice:
        public Kružnica(double x, double y, double r)
        {
            S = new Bod(x, y);
            this.r = r;
        }

        // Metóda kreslenia kružnice:
        public void kresli()
        {
            skočNa(S);
            kružnica(r);
        }
    }

    // Konštruktor hlavnej triedy:
    private PriesečníkyKružníc()
    {
        // Úprava rozmerov plátna a skrytie robota:
        super(300, 300);
        skry();

        // Definícia poľa kružníc:
        final Kružnica[] kružnice = {new Kružnica(-50, 70, 50),
            new Kružnica(60, 70, 60), new Kružnica(-45, -70, 55),
            new Kružnica(55, -70, 65)};

        // Pole bodov slúžiace na uchovanie nájdených priesečníkov:
        Bod p[];

        // Nakreslenie kružníc:
        for (Kružnica k : kružnice) k.kresli();

        // Zväčšenie hrúbky pera, aby boli zobrazené priesečníky lepšie
        // viditeľné:
        hrúbkaČiary(1.75);

        // Hľadanie priesečníkov všetkých definovaných kružníc:
        for (int i = 0; i < kružnice.length; ++i)
        {
            for (int j = i + 1; j < kružnice.length; ++j)
            {
                // Pokus o nájdenie priesečníkov:
                p = Svet.priesečníkyKružníc(
                    kružnice[i].S, kružnice[i].r,
                    kružnice[j].S, kružnice[j].r);

                // Overenie, či bol nájdený aspoň jeden:
                if (null != p)
                {
                    // Zviditeľnenie prvého nájdeného priesečníka malým krúžkom:
                    if (p.length > 0)
                    {
                        skočNa(p[0]);
                        kružnica(3);
                    }

                    // Druhý priesečník bude zviditeľnený krúžkom, ktorý bude
                    // o niečo väčší (na ich odlíšenie):
                    if (p.length > 1)
                    {
                        skočNa(p[1]);
                        kružnica(6);
                    }
                }
            }
        }
    }

    public static void main(String[] args)
    {
        new PriesečníkyKružníc();
    }
}

(Výsledok je v tomto prípade na obrázku nad príkladom.)

Poznámka (pre zaujímavosť): Táto metóda (a jej klony) by mohla v prípade nenájdenia žiadneho priesečníka vrátiť namiesto hodnoty null pole s nulovou dĺžkou („prázdne“ pole), ale to by nebolo konzistentné s ostatnými metódami, ktoré hľadajú priesečníky. (A zachovanie konzistencie pri tvorbe balíkov akými sú programovacie rámce je dôležité. Niekedy sa ju nemusí podariť dosiahnuť z dôvodu rozsiahlosti balíkov a z dôvodu prijímania rôznych rozhodnutí v rôznych kontextoch, no prinajmenšom v prípadoch ako je tento by mala byť zachovaná.)

Parametre:: x1 – x-ová súradnica stredu prvej kružnice; y1 – y-ová súradnica stredu prvej kružnice; r1 – polomer prvej kružnice; x2 – x-ová súradnica stredu druhej kružnice; y2 – y-ová súradnica stredu druhej kružnice; r2 – polomer druhej kružnice
Návratová hodnota:: pole priesečníkov alebo null, ak nejestvujú

priesecnikyKruznic

public static final Bod[] priesecnikyKruznic(double x1,
                                             double y1,
                                             double r1,
                                             double x2,
                                             double y2,
                                             double r2)

Alias pre priesečníkyKružníc.

priesečníkyKružníc
```
public static final Bod[] priesečníkyKružníc(Poloha S1,
                                             double r1,
                                             Poloha S2,
                                             double r2)
```
Hľadá priesečníky dvoch kružníc určených polohami ich stredov S1 a S2 a polomermi r1 a r2. Ak jestvuje aspoň jeden priesečník, tak metóda vráti jedno- alebo dvojprvkové pole bodov určujúcich súradnice priesečníkov. Ak nejestvuje ani jeden priesečník, tak metóda vráti hodnotu null.

Parametre:

S1 – poloha stredu prvej kružnice

r1 – polomer prvej kružnice

S2 – poloha stredu druhej kružnice

r2 – polomer druhej kružnice

Návratová hodnota:

pole priesečníkov alebo null, ak nejestvujú

priesecnikyKruznic

public static final Bod[] priesecnikyKruznic(Poloha S1,
                                             double r1,
                                             Poloha S2,
                                             double r2)

Alias pre priesečníkyKružníc.

priesečníkyPriamkyAKružnice
```
public static final Bod[] priesečníkyPriamkyAKružnice(double x1,
                                                      double y1,
                                                      double x2,
                                                      double y2,
                                                      double x3,
                                                      double y3,
                                                      double r)
```
Hľadá priesečníky priamky AB a kružnice určenej súradnicami stredu S a polomeru r. Súradnice bodov priamky a stredu kružnice sú určené parametrami tejto metódy takto: A[x1, y1]; B[x2, y2]; S[x3, y3]. Parameter r je polomerom kružnice. Ak jestvuje aspoň jeden priesečník, tak metóda vráti pole bodov určujúcich súradnice priesečníkov (pole môže obsahovať jeden alebo dva prvky/body). Ak nejestvuje ani jeden priesečník, tak metóda vráti hodnotu null.

Príklad:
```
hrúbkaČiary(1.5);
skry();

for (int i = 0; i < 7; ++i)
{
    // Vygenerovanie súradníc:
    double x1 = Svet.náhodnéCeléČíslo(-150, 150);
    double y1 = Svet.náhodnéCeléČíslo(-150, 150);
    double x2 = Svet.náhodnéCeléČíslo(-150, 150);
    double y2 = Svet.náhodnéCeléČíslo(-150, 150);
    double x3 = Svet.náhodnéCeléČíslo(-150, 150);
    double y3 = Svet.náhodnéCeléČíslo(-150, 150);
    double r = Svet.náhodnéCeléČíslo(30, 120);

    // Nakreslenie situácie:
    farba(preddefinovanéFarby[
        preddefinovanéFarby.length - 1 - 4 * i]);
    skočNa(x1, y1);
    choďNa(x2, y2);
    skočNa(x3, y3);
    kružnica(r);

    // Výpočet priesečníkov:
    Bod[] pries = Svet.priesečníkyPriamkyAKružnice(
        x1, y1, x2, y2, x3, y3, r);

    // Vyznačenie priesečníkov (ak jestvujú):
    if (null != pries)
    {
        if (1 <= pries.length)
        {
            skočNa(pries[0]);
            kruh(3);
        }

        if (2 <= pries.length)
        {
            skočNa(pries[1]);
            kruh(3);
        }
    }
}
```
Výsledok:

Ukážky výsledkov.

Príklad je naprogramovaný tak, aby z priamok kreslil len úsečky medzi ich určujúcimi bodmi, ale na výsledku vidno, že priesečníky s kružnicami sú nájdené pre celé priamky.

Poznámka (pre zaujímavosť): Táto metóda (a jej klony) by mohla v prípade nenájdenia žiadneho priesečníka vrátiť namiesto hodnoty null pole s nulovou dĺžkou („prázdne“ pole), ale to by nebolo konzistentné s ostatnými metódami, ktoré hľadajú priesečníky. (A zachovanie konzistencie pri tvorbe balíkov akými sú programovacie rámce je dôležité. Niekedy sa ju nemusí podariť dosiahnuť z dôvodu rozsiahlosti balíkov a z dôvodu prijímania rôznych rozhodnutí v rôznych kontextoch, no prinajmenšom v prípadoch ako je tento by mala byť zachovaná.)

Užitočné zdroje:
- User:cobie – User:arne.b – and others: Circle line intersection points. Stack Overflow, 2012. Citované: 2016 – 2018.
- Weisstein, Eric W.: Circle-Line Intersection. Wolfram MathWorld, A Wolfram Web Resource. Citované: 2016 – 2018.
Parametre:

x1 – x-ová súradnica určujúceho bodu priamky A

y1 – y-ová súradnica určujúceho bodu priamky A

x2 – x-ová súradnica určujúceho bodu priamky B

y2 – y-ová súradnica určujúceho bodu priamky B

x3 – x-ová súradnica stredu kružnice

y3 – y-ová súradnica stredu kružnice

r – polomer kružnice

Návratová hodnota:

pole priesečníkov alebo null, ak nejestvujú

priesecnikyPriamkyAKruznice

public static final Bod[] priesecnikyPriamkyAKruznice(double x1,
                                                      double y1,
                                                      double x2,
                                                      double y2,
                                                      double x3,
                                                      double y3,
                                                      double r)

Alias pre priesečníkyPriamkyAKružnice.

priesečníkyPriamkyAKružnice
```
public static final Bod[] priesečníkyPriamkyAKružnice(Poloha A,
                                                      Poloha B,
                                                      Poloha S,
                                                      double r)
```
Hľadá priesečníky priamky AB a kružnice určenej polohou stredu S a polomeru r. Ak jestvuje aspoň jeden priesečník, tak metóda vráti pole bodov určujúcich súradnice priesečníkov (pole môže obsahovať jeden alebo dva prvky/body). Ak nejestvuje ani jeden priesečník, tak metóda vráti hodnotu null.

Parametre:

A – poloha určujúceho bodu priamky A

B – poloha určujúceho bodu priamky B

S – poloha stredu kružnice

r – polomer kružnice

Návratová hodnota:

pole priesečníkov alebo null, ak nejestvujú

priesecnikyPriamkyAKruznice

public static final Bod[] priesecnikyPriamkyAKruznice(Poloha A,
                                                      Poloha B,
                                                      Poloha S,
                                                      double r)

Alias pre priesečníkyPriamkyAKružnice.

priesečníkyÚsečkyAKružnice
```
public static final Bod[] priesečníkyÚsečkyAKružnice(double x1,
                                                     double y1,
                                                     double x2,
                                                     double y2,
                                                     double x3,
                                                     double y3,
                                                     double r)
```
Hľadá priesečníky úsečky AB a kružnice so stredom S a polomerom r. Ak jestvuje jeden priesečník, metóda vráti jednoprvkové pole. Ak jestvujú dva priesečníky, metóda vráti dvojprvkové pole bodov so súradnicami priesečníkov. Ak nejestvuje žiadny priesečník, tak metóda vráti hodnotu null.

Ukážka použitia:
```
// Keď máme k dispozícii polohy bodov, môžeme využiť inú verziu tejto metódy:
final Bod A = new Bod(-15, -30);
final Bod B = new Bod(75, 80);
final Bod S = new Bod(-15, -10);
final double r = 80;

Bod[] P = Svet.priesečníkyÚsečkyAKružnice(A, B, S, r);
```
Vizualizácia výsledku:

Obrázok nižšie zobrazuje úsečku AB, kružnicu k so stredom S a polomerom r a ich priesečník (v tejto situácii je len jeden) P.

Poznámka (pre zaujímavosť): Táto metóda (a jej klony) by mohla v prípade nenájdenia žiadneho priesečníka vrátiť namiesto hodnoty null pole s nulovou dĺžkou („prázdne“ pole), ale to by nebolo konzistentné s ostatnými metódami, ktoré hľadajú priesečníky. (A zachovanie konzistencie pri tvorbe balíkov akými sú programovacie rámce je dôležité. Niekedy sa ju nemusí podariť dosiahnuť z dôvodu rozsiahlosti balíkov a z dôvodu prijímania rôznych rozhodnutí v rôznych kontextoch, no prinajmenšom v prípadoch ako je tento by mala byť zachovaná.)
Parametre:

x1 – x-ová súradnica bodu A úsečky

y1 – y-ová súradnica bodu A úsečky

x2 – x-ová súradnica bodu B úsečky

y2 – y-ová súradnica bodu B úsečky

x3 – x-ová súradnica stredu kružnice

y3 – y-ová súradnica stredu kružnice

r – polomer kružnice

Návratová hodnota:

pole priesečníkov alebo null, ak nejestvujú

priesecnikyUseckyAKruznice

public static final Bod[] priesecnikyUseckyAKruznice(double x1,
                                                     double y1,
                                                     double x2,
                                                     double y2,
                                                     double x3,
                                                     double y3,
                                                     double r)

Alias pre priesečníkyÚsečkyAKružnice.

priesečníkyÚsečkyAKružnice
```
public static final Bod[] priesečníkyÚsečkyAKružnice(Poloha A,
                                                     Poloha B,
                                                     Poloha S,
                                                     double r)
```
Hľadá priesečníky úsečky AB a kružnice so stredom S a polomerom r. Ak jestvuje jeden priesečník, metóda vráti jednoprvkové pole. Ak jestvujú dva priesečníky, metóda vráti dvojprvkové pole bodov so súradnicami priesečníkov. Ak nejestvuje žiadny priesečník, tak metóda vráti hodnotu null.

Parametre:

A – poloha bodu A úsečky

B – poloha bodu B úsečky

S – poloha stredu S kružnice

r – polomer kružnice

Návratová hodnota:

pole priesečníkov alebo null, ak nejestvujú

priesecnikyUseckyAKruznice

public static final Bod[] priesecnikyUseckyAKruznice(Poloha A,
                                                     Poloha B,
                                                     Poloha S,
                                                     double r)

Alias pre priesečníkyÚsečkyAKružnice.

najbližšíBodNaPriamke
```
public static final Bod najbližšíBodNaPriamke(double x0,
                                              double y0,
                                              double x1,
                                              double y1,
                                              double x2,
                                              double y2)
```
Nájde najbližší bod na priamke určenej dvomi bodmi A[x1, y1] a B[x2, y2] k zadanému voľnému bodu V[x0, y0] a vráti jeho súradnice v objekte typu Bod.

Grafické znázornenie možnej situácie pri hľadaní najbližšieho bodu na priamke.

Príklad:

Pozrite sa na príklad v opise metódy najbližšíBodNaÚsečke a nahraďte v ňom volanie metódy najbližšíBodNaÚsečke metódou najbližšíBodNaPriamke. Priamka bude síce stále kreslená ako úsečka (riešenie tejto nedokonalosti ponechávame na čitateľoch), ale správanie príkladu sa zmení tak, že nájdený bod bude „opúšťať hranice úsečky“ a posúvať sa aj za hraničné body pôvodnej úsečky (pretože v skutočnosti bude ležať na priamke).

Výsledok:

Ukážka interaktívneho príkladu v činnosti po vyššie uvedenej úprave.

Užitočný zdroj:
- Michael Lloyd Lee: Snap point to a line. Stack Overflow, 2017. Citované: 2017 – 2018.
Parametre:

x0 – x-ová súradnica voľného bodu V

y0 – y-ová súradnica voľného bodu V

x1 – x-ová súradnica určujúceho bodu A priamky

y1 – y-ová súradnica určujúceho bodu A priamky

x2 – x-ová súradnica určujúceho bodu B priamky

y2 – y-ová súradnica určujúceho bodu B priamky

Návratová hodnota:

objekt so súradnicami najbližšieho bodu na priamke

najblizsiBodNaPriamke

public static final Bod najblizsiBodNaPriamke(double x0,
                                              double y0,
                                              double x1,
                                              double y1,
                                              double x2,
                                              double y2)

Alias pre najbližšíBodNaPriamke.

najbližšíBodNaPriamke
```
public static final Bod najbližšíBodNaPriamke(Poloha V,
                                              Poloha A,
                                              Poloha B)
```
Nájde najbližší bod na priamke AB k zadanému voľnému bodu V a vráti jeho súradnice v objekte typu Bod.

Parametre:

V – poloha voľného bodu V

A – poloha určujúceho bodu A priamky

B – poloha určujúceho bodu B priamky

Návratová hodnota:

objekt so súradnicami najbližšieho bodu na priamke

najblizsiBodNaPriamke

public static final Bod najblizsiBodNaPriamke(Poloha V,
                                              Poloha A,
                                              Poloha B)

Alias pre najbližšíBodNaPriamke.

najbližšíBodNaPriamke
```
public static final Bod najbližšíBodNaPriamke(Poloha[] poleBodov)
```
Nájde najbližší bod na priamke AB k zadanému voľnému bodu V a vráti jeho súradnice v objekte typu Bod. Bod a priamka sú určené polohami bodov v poli parametra, ktoré musí obsahovať aspoň tri prvky. Prvý prvok určuje bod V a ďalšie dva prvky body A a B.

Parametre:

poleBodov – polohy bodov určujúce bod V a priamku A, B

Návratová hodnota:

objekt so súradnicami najbližšieho bodu na priamke

najblizsiBodNaPriamke

public static final Bod najblizsiBodNaPriamke(Poloha[] poleBodov)

Alias pre najbližšíBodNaPriamke.

najbližšíBodNaÚsečke

public static final Bod najbližšíBodNaÚsečke(double x0,
                                             double y0,
                                             double x1,
                                             double y1,
                                             double x2,
                                             double y2)

Nájde najbližší bod na úsečke určenej dvomi bodmi A[x1, y1] a B[x2, y2] k zadanému voľnému bodu V[x0, y0] a vráti jeho súradnice v objekte typu Bod.

Hľadanie
najbližšieho bodu na
úsečke.

Grafické znázornenie možných situácií pri hľadaní najbližšieho bodu na úsečke.

Príklad:

Toto je krátky interaktívny príklad ukazujúci fungovanie metódy najbližšíBodNaÚsečke. Krajné body úsečky a samotný voľný bod sa dajú ťahať myšou a nájdený bod je vyznačený o niečo väčšou kružnicou, než sú vyznačené tri kľúčové body.

import knižnica.*;

public class BodNaÚsečke extends GRobot
{
    // Pole bodov. Prvý bod je voľný bod a ďalšie dva sú krajné body úsečky.
    private Bod[] body = {new Bod(), new Bod(), new Bod()};

    // Index aktuálne ťahaného bodu:
    private int aktívny = 0;

    // Konštruktor.
    private BodNaÚsečke()
    {
        // Zmena rozmerov plátna a inicializácia príkladu.

        super(400, 400);
        skry();
        Svet.zbaľ();
        Svet.vystreď();

        for (Bod bod : body)
        {
            náhodnáPoloha();
            bod.poloha(this);
        }

        prekreslenie();
    }

    // Reakcia na stlačenie tlačidla myši.
    @Override public void stlačenieTlačidlaMyši()
    {
        if (ÚdajeUdalostí.tlačidloMyši(ĽAVÉ))
        {
            // Ľavé tlačidlo vykoná vyhľadanie a aktiváciu bodu na polohe myši…
            skočNaMyš();
            for (int i = 0; i < body.length; ++i)
                if (bodVKruhu(body[i])) aktívny = i;
            body[aktívny].poloha(ÚdajeUdalostí.polohaMyši());
            prekreslenie();
        }
    }

    // Reakcia na ťahanie kurzora myši (ťahanie znamená pohyb myšou počas
    // držania ľubovoľného tlačidla).
    @Override public void ťahanieMyšou()
    {
        if (ÚdajeUdalostí.tlačidloMyši(ĽAVÉ))
        {
            // Ľavé tlačidlo premiestňuje aktívny bod.
            body[aktívny].poloha(ÚdajeUdalostí.polohaMyši());
            prekreslenie();
        }
    }

    // Reakcia na prekreslenie spôsobí prekreslenie scény.
    @Override public void prekreslenie()
    {
        podlaha.vymažGrafiku();

        skočNa(body[1]);
        choďNa(body[2]);

        for (int i = 0; i < body.length; ++i)
        {
            skočNa(body[i]);
            krúžok(3);
        }

        Bod bod = Svet.najbližšíBodNaÚsečke(body);
        skočNa(bod);
        krúžok(6);
    }

    // Hlavná metóda.
    public static void main(String[] args)
    {
        new BodNaÚsečke();
    }
}

Výsledok:

Výsledok príkladu.

Ukážka interaktívneho príkladu v činnosti.

Parametre:: x0 – x-ová súradnica voľného bodu V; y0 – y-ová súradnica voľného bodu V; x1 – x-ová súradnica krajného bodu A úsečky; y1 – y-ová súradnica krajného bodu A úsečky; x2 – x-ová súradnica krajného bodu B úsečky; y2 – y-ová súradnica krajného bodu B úsečky
Návratová hodnota:: objekt so súradnicami najbližšieho bodu na úsečke

najblizsiBodNaUsecke

public static final Bod najblizsiBodNaUsecke(double x0,
                                             double y0,
                                             double x1,
                                             double y1,
                                             double x2,
                                             double y2)

Alias pre najbližšíBodNaÚsečke.

najbližšíBodNaÚsečke
```
public static final Bod najbližšíBodNaÚsečke(Poloha V,
                                             Poloha A,
                                             Poloha B)
```
Nájde najbližší bod na úsečke AB k zadanému voľnému bodu V a vráti jeho súradnice v objekte typu Bod.

Parametre:

V – poloha voľného bodu V

A – poloha krajného bodu A úsečky

B – poloha krajného bodu B úsečky

Návratová hodnota:

objekt so súradnicami najbližšieho bodu na úsečke

najblizsiBodNaUsecke

public static final Bod najblizsiBodNaUsecke(Poloha V,
                                             Poloha A,
                                             Poloha B)

Alias pre najbližšíBodNaÚsečke.

najbližšíBodNaÚsečke
```
public static final Bod najbližšíBodNaÚsečke(Poloha[] poleBodov)
```
Nájde najbližší bod na úsečke AB k zadanému voľnému bodu V a vráti jeho súradnice v objekte typu Bod. Bod a úsečka sú určené polohami bodov v poli parametra, ktoré musí obsahovať aspoň tri prvky. Prvý prvok určuje bod V a ďalšie dva prvky body A a B.

Parametre:

poleBodov – polohy bodov určujúce bod V a úsečku A, B

Návratová hodnota:

objekt so súradnicami najbližšieho bodu na úsečke

najblizsiBodNaUsecke

public static final Bod najblizsiBodNaUsecke(Poloha[] poleBodov)

Alias pre najbližšíBodNaÚsečke.

najbližšíBodNaKružnici

public static final Bod najbližšíBodNaKružnici(double x0,
                                               double y0,
                                               double x1,
                                               double y1,
                                               double r)

Nájde najbližší bod na kružnici so stredom S[x1, y1] a polomerom r k zadanému voľnému bodu V[x0, y0] a vráti jeho polohu v objekte typu Bod. Úloha je neriešiteľná, ak sa voľný bod V nachádza v strede kružnice, pretože od stredu kružnice sú rovnako vzdialené všetky jej body. Ak nastane takáto situácia, tak metóda vráti hodnotu null.

Hľadanie
najbližšieho bodu na kružnici.

Grafické znázornenie hľadania najbližšieho bodu na kružnici.

Príklad:

import knižnica.*;

public class BodNaKružnici extends GRobot
{
    private Bod myš = null;

    private BodNaKružnici()
    {
        super(300, 300);
        hrúbkaČiary(3);
        farba(zelená);
        veľkosť(50);
        Svet.prekresli();
    }

    @Override public void kresliSeba()
    {
        krúžok();

        if (null == myš) return;
        Bod bod = Svet.najbližšíBodNaKružnici(myš, this, veľkosť());

        farba(červená);
        hrúbkaČiary(0.33);

        skočNaMyš(); kružnica(3.5);
        choďNa(bod); kružnica(3.5);
    }

    @Override public void pohybMyši()
    {
        myš = ÚdajeUdalostí.polohaMyši();
        Svet.prekresli();
    }

    public static void main(String[] args)
    {
        Svet.použiKonfiguráciu("BodNaKružnici.cfg");
        Svet.nekresli();
        new BodNaKružnici();
        Svet.zbaľ();
    }
}

Výsledok:

Pohyb myši spôsobí zmenu zapamätaných súradníc a prekreslenie. V kreslení vlastného tvaru sa po nakreslení tvaru krúžku nakreslia dve malé tenké červené kružnice s čiarou medzi ich stredmi, pričom prvá z nich je na naposledy zapamätanej pozícii pri pohybe myšou a je k tejto polohe najbližším bodom ležiacim na kružnici reprezentujúcej vlastný tvar robota.

Parametre:: x0 – x-ová súradnica voľného bodu; y0 – y-ová súradnica voľného bodu; x1 – x-ová súradnica stredu kružnice; y1 – y-ová súradnica stredu kružnice; r – polomer kružnice
Návratová hodnota:: poloha najbližšieho bodu na kružnici (v špeciálnom prípade null)

najblizsiBodNaKruznici

public static final Bod najblizsiBodNaKruznici(double x0,
                                               double y0,
                                               double x1,
                                               double y1,
                                               double r)

Alias pre najbližšíBodNaKružnici.

najbližšíBodNaKružnici
```
public static final Bod najbližšíBodNaKružnici(Poloha V,
                                               Poloha S,
                                               double r)
```
Nájde najbližší bod na kružnici so stredom S a polomerom r k zadanému voľnému bodu V a vráti jeho polohu v objekte typu Bod. Úloha je neriešiteľná, ak sa voľný bod V nachádza v strede kružnice. Ak nastane takáto situácia, tak metóda vráti hodnotu null.

Parametre:

V – poloha voľného bodu

S – poloha stredu kružnice

r – polomer kružnice

Návratová hodnota:

poloha najbližšieho bodu na kružnici (v špeciálnom prípade null)

najblizsiBodNaKruznici

public static final Bod najblizsiBodNaKruznici(Poloha V,
                                               Poloha S,
                                               double r)

Alias pre najbližšíBodNaKružnici.

vzdialenosťBodov
```
public static final double vzdialenosťBodov(double x1,
                                            double y1,
                                            double x2,
                                            double y2)
```
Vypočíta vzdialenosť medzi dvomi bodmi so súradnicami [x1, y1] a [x2, y2]. Táto metóda volá metódu jazyka Java Point2D.distance(x1, y1, x2, y2).

Poznámka: V skutočnosti by sme nemali hovoriť, že ide o „metódu jazyka Java.“ Je to statická metóda triedy Point2D štandardného balíčka java.awt.geom jazyka Java (a aj na tomto opise by sa dalo ešte niečo spresňovať), ale z dôvodu pedagogickej transformácie ponechávame v opise zjednodušené označenie.

Zdroj:
- Distance of Point2D (Java Platform SE 8). Oracle. Citované: 2016 – 2018.
Parametre:

x1 – x-ová súradnica prvého bodu

y1 – y-ová súradnica prvého bodu

x2 – x-ová súradnica druhého bodu

y2 – y-ová súradnica druhého bodu

Návratová hodnota:

vzdialenosť medzi určenými bodmi

vzdialenostBodov

public static final double vzdialenostBodov(double x1,
                                            double y1,
                                            double x2,
                                            double y2)

Alias pre vzdialenosťBodov.

vzdialenosťBodov
```
public static final double vzdialenosťBodov(Poloha A,
                                            Poloha B)
```
Vypočíta vzdialenosť medzi dvomi bodmi A a B. Pozri aj opis metódy vzdialenosťBodov, ktorej správanie táto metóda kopíruje.

Parametre:

A – poloha prvého bodu

B – poloha druhého bodu

Návratová hodnota:

vzdialenosť medzi určenými bodmi

vzdialenostBodov

public static final double vzdialenostBodov(Poloha A,
                                            Poloha B)

Alias pre vzdialenosťBodov.

vzdialenosťBodov
```
public static final double vzdialenosťBodov(Poloha[] poleBodov)
```
Vypočíta vzdialenosť medzi dvomi bodmi so súradnicami určenými polohami bodov v poli parametra. Pole musí obsahovať aspoň dva prvky. (V prípade vyššieho počtu prvkov sú brané do úvahy len prvé dva. Ostatné sú ignorované.) Pozri aj opis metódy vzdialenosťBodov, ktorej správanie táto metóda kopíruje.

Parametre:

poleBodov – polohy bodov

Návratová hodnota:

vzdialenosť medzi určenými bodmi (prípadne hodnota Double.NaN – v prípade chyby)

vzdialenostBodov

public static final double vzdialenostBodov(Poloha[] poleBodov)

Alias pre vzdialenosťBodov.

vzdialenosťBoduOdPriamky
```
public static final double vzdialenosťBoduOdPriamky(double x0,
                                                    double y0,
                                                    double x1,
                                                    double y1,
                                                    double x2,
                                                    double y2)
```
Vypočíta vzdialenosť od zadaného voľného bodu V[x0, y0] k priamke určenej dvomi bodmi A[x1, y1] a B[x2, y2]. (Ak bod leží na priamke, tak je vzdialenosť rovná nule.)

Metóda nepoužíva metódu jazyka Java Line2D.ptLineDist(x1, y1, x2, y2, x0, y0), ale vnútornú (rovnomennú) optimalizovanú verziu jednej z implementácií tejto metódy.

Súvisiaci zdroj:
- Horváth, Roman – Fialová, Jana: The Creation of Simulation with an Algorithm Optimisation in Java for the Teaching Process. ICETA 2020. Danvers : IEEE, 2020. ISBN 978-0-7381-2366-0. Pp. 160–166. [prevziať]
Poznámka: V skutočnosti by sme nemali hovoriť, že ide o „metódu jazyka Java.“ Je to statická metóda triedy Line2D štandardného balíčka java.awt.geom jazyka Java (a aj na tomto opise by sa dalo ešte niečo spresňovať), ale z dôvodu pedagogickej transformácie ponechávame v opise zjednodušené označenie.

Grafické znázornenie možnej situácie pri určovaní vzdialenosti bodu od priamky.

Príklad:

Pozrite sa na príklad v opise metódy vzdialenosťBoduOdÚsečky a upravte telo reakcie prekreslenie takto:
```
podlaha.vymažGrafiku();

skočNa(body[1]);
choďNa(body[2]);

// Tieto riadky pribudli:
skočNa(body[1]);
otočNa(body[2]);
vzad(2000);
skočNa(body[2]);
dopredu(2000);

for (int i = 0; i < body.length; ++i)
{
    skočNa(body[i]);
    krúžok(3);
}

skočNa(body[0]); uhol(90); skoč();

// Volanie metódy na tomto riadku sa zmenilo:
text(F(Svet.vzdialenosťBoduOdPriamky(body), 2));
```
Výsledok:

Ukážka interaktívneho príkladu v činnosti.

Zdroj:
- Point to line distance of Line2D (Java Platform SE 8). Oracle. Citované: 2016 – 2018.
Parametre:

x0 – x-ová súradnica voľného bodu

y0 – y-ová súradnica voľného bodu

x1 – x-ová súradnica určujúceho bodu A priamky

y1 – y-ová súradnica určujúceho bodu A priamky

x2 – x-ová súradnica určujúceho bodu B priamky

y2 – y-ová súradnica určujúceho bodu B priamky

Návratová hodnota:

vzdialenosť bodu od priamky

vzdialenostBoduOdPriamky

public static final double vzdialenostBoduOdPriamky(double x0,
                                                    double y0,
                                                    double x1,
                                                    double y1,
                                                    double x2,
                                                    double y2)

Alias pre vzdialenosťBoduOdPriamky.

vzdialenosťBoduOdPriamky
```
public static final double vzdialenosťBoduOdPriamky(Poloha V,
                                                    Poloha A,
                                                    Poloha B)
```
Vypočíta vzdialenosť od zadaného voľného bodu V k priamke AB. Pozri aj opis metódy vzdialenosťBoduOdPriamky, ktorej správanie táto metóda kopíruje.

Parametre:

V – poloha voľného bodu

A – poloha určujúceho bodu A priamky

B – poloha určujúceho bodu B priamky

Návratová hodnota:

vzdialenosť bodu od priamky

vzdialenostBoduOdPriamky

public static final double vzdialenostBoduOdPriamky(Poloha V,
                                                    Poloha A,
                                                    Poloha B)

Alias pre vzdialenosťBoduOdPriamky.

vzdialenosťBoduOdPriamky
```
public static final double vzdialenosťBoduOdPriamky(Poloha[] poleBodov)
```
Vypočíta vzdialenosť medzi voľným bodom a priamkou, ktoré sú určené určenými polohami bodov v poli parametra. Pole musí obsahovať aspoň tri prvky. Prvý prvok obsahuje súradnice voľného bodu a ďalšie dva prvky určujúce body priamky. Pozri aj opis metódy vzdialenosťBoduOdPriamky, ktorej správanie táto metóda kopíruje.

Parametre:

poleBodov – polohy voľného bodu a určujúcich bodov priamky

Návratová hodnota:

vzdialenosť bodu od priamky (prípadne hodnota Double.NaN – v prípade chyby)

vzdialenostBoduOdPriamky

public static final double vzdialenostBoduOdPriamky(Poloha[] poleBodov)

Alias pre vzdialenosťBoduOdPriamky.

vzdialenosťBoduOdÚsečky

public static final double vzdialenosťBoduOdÚsečky(double x0,
                                                   double y0,
                                                   double x1,
                                                   double y1,
                                                   double x2,
                                                   double y2)

Vypočíta vzdialenosť od zadaného voľného bodu V[x0, y0] k úsečke určenej dvomi bodmi A[x1, y1] a B[x2, y2]. (Ak bod leží na úsečke, tak je vzdialenosť rovná nule.)

Metóda nepoužíva metódu jazyka Java Line2D.ptSegDist(x1, y1, x2, y2, x0, y0), ale vnútornú (rovnomennú) optimalizovanú verziu jednej z implementácií tejto metódy.

Súvisiaci zdroj:

Horváth, Roman – Fialová, Jana: The Creation of Simulation with an Algorithm Optimisation in Java for the Teaching Process. ICETA 2020. Danvers : IEEE, 2020. ISBN 978-0-7381-2366-0. Pp. 160–166. [prevziať]

Poznámka: V skutočnosti by sme nemali hovoriť, že ide o „metódu jazyka Java.“ Je to statická metóda triedy Line2D štandardného balíčka java.awt.geom jazyka Java (a aj na tomto opise by sa dalo ešte niečo spresňovať), ale z dôvodu pedagogickej transformácie ponechávame v opise zjednodušené označenie. Podobne postupujeme na viacerých miestach tejto dokumentácie.

Určovanie
vzdialenosti bodu od úsečky.

Grafické znázornenie možnej situácie pri určovaní vzdialenosti bodu od úsečky.

Príklad:

Toto je krátky interaktívny príklad ukazujúci fungovanie metódy vzdialenosťBoduOdÚsečky. Krajné body úsečky a samotný voľný bod sa dajú ťahať myšou a nameraná vzdialenosť sa zobrazuje tesne nad bodom.

import knižnica.*;

public class BodOdÚsečky extends GRobot
{
    // Pole bodov. Prvý bod je voľný bod a ďalšie dva sú krajné body úsečky.
    private Bod[] body = {new Bod(), new Bod(), new Bod()};

    // Index aktuálne ťahaného bodu:
    private int aktívny = 0;

    // Konštruktor.
    private BodOdÚsečky()
    {
        // Zmena rozmerov plátna a inicializácia príkladu.

        super(400, 400);
        skry();
        Svet.zbaľ();
        Svet.vystreď();

        for (Bod bod : body)
        {
            náhodnáPoloha();
            bod.poloha(this);
        }

        prekreslenie();
    }

    // Reakcia na stlačenie tlačidla myši.
    @Override public void stlačenieTlačidlaMyši()
    {
        if (ÚdajeUdalostí.tlačidloMyši(ĽAVÉ))
        {
            // Ľavé tlačidlo vykoná vyhľadanie a aktiváciu bodu na polohe myši…
            skočNaMyš();
            for (int i = 0; i < body.length; ++i)
                if (bodVKruhu(body[i])) aktívny = i;
            body[aktívny].poloha(ÚdajeUdalostí.polohaMyši());
            prekreslenie();
        }
    }

    // Reakcia na ťahanie kurzora myši (ťahanie znamená pohyb myšou počas
    // držania ľubovoľného tlačidla).
    @Override public void ťahanieMyšou()
    {
        if (ÚdajeUdalostí.tlačidloMyši(ĽAVÉ))
        {
            // Ľavé tlačidlo premiestňuje aktívny bod.
            body[aktívny].poloha(ÚdajeUdalostí.polohaMyši());
            prekreslenie();
        }
    }

    // Reakcia na prekreslenie spôsobí prekreslenie scény.
    @Override public void prekreslenie()
    {
        podlaha.vymažGrafiku();

        skočNa(body[1]);
        choďNa(body[2]);

        for (int i = 0; i < body.length; ++i)
        {
            skočNa(body[i]);
            krúžok(3);
        }

        skočNa(body[0]); uhol(90); skoč();
        text(F(Svet.vzdialenosťBoduOdÚsečky(body), 2));
    }

    // Hlavná metóda.
    public static void main(String[] args)
    {
        new BodOdÚsečky();
    }
}

Výsledok:

Výsledok príkladu.

Ukážka interaktívneho príkladu v činnosti.

Zdroj:

Point to line segment distance of Line2D (Java Platform SE 8). Oracle. Citované: 2016 – 2018.

Parametre:: x0 – x-ová súradnica voľného bodu; y0 – y-ová súradnica voľného bodu; x1 – x-ová súradnica určujúceho bodu A úsečky; y1 – y-ová súradnica určujúceho bodu A úsečky; x2 – x-ová súradnica určujúceho bodu B úsečky; y2 – y-ová súradnica určujúceho bodu B úsečky
Návratová hodnota:: vzdialenosť bodu od úsečky

vzdialenostBoduOdUsecky

public static final double vzdialenostBoduOdUsecky(double x0,
                                                   double y0,
                                                   double x1,
                                                   double y1,
                                                   double x2,
                                                   double y2)

Alias pre vzdialenosťBoduOdÚsečky.

vzdialenosťBoduOdÚsečky
```
public static final double vzdialenosťBoduOdÚsečky(Poloha V,
                                                   Poloha A,
                                                   Poloha B)
```
Vypočíta vzdialenosť od zadaného voľného bodu V k úsečke AB. Pozri aj opis metódy vzdialenosťBoduOdÚsečky, ktorej správanie táto metóda kopíruje.

Parametre:

V – poloha voľného bodu

A – poloha určujúceho bodu A úsečky

B – poloha určujúceho bodu B úsečky

Návratová hodnota:

vzdialenosť bodu od úsečky

vzdialenostBoduOdUsecky

public static final double vzdialenostBoduOdUsecky(Poloha V,
                                                   Poloha A,
                                                   Poloha B)

Alias pre vzdialenosťBoduOdÚsečky.

vzdialenosťBoduOdÚsečky
```
public static final double vzdialenosťBoduOdÚsečky(Poloha[] poleBodov)
```
Vypočíta vzdialenosť medzi voľným bodom V a úsečkou AB, ktoré sú určené polohami bodov v poli parametra poleBodov. Pole musí obsahovať aspoň tri prvky. Prvý prvok obsahuje súradnice voľného bodu V a ďalšie dva prvky určujúce body úsečky AB. Pozri aj opis metódy vzdialenosťBoduOdÚsečky, ktorej správanie táto metóda kopíruje.

Parametre:

poleBodov – polohy voľného bodu a určujúcich bodov úsečky

Návratová hodnota:

vzdialenosť bodu od úsečky (prípadne hodnota Double.NaN – v prípade chyby)

vzdialenostBoduOdUsecky

public static final double vzdialenostBoduOdUsecky(Poloha[] poleBodov)

Alias pre vzdialenosťBoduOdÚsečky.

vzdialenosťBoduOdKružnice
```
public static final double vzdialenosťBoduOdKružnice(double x0,
                                                     double y0,
                                                     double x1,
                                                     double y1,
                                                     double r)
```
Vypočíta vzdialenosť od zadaného voľného bodu V ku kružnici určenej stredom S a polomerom r. Pozor! Ak sa bod nachádza vo vnútri kružnice, tak táto metóda vráti zápornú hodnotu – pozri vysvetlenie v poznámkach nižšie.

Výpočet, ktorý vykonáva táto metóda je v skutočnosti technicky veľmi jednoduchý. Stačí vypočítať vzdialenosť bodu od stredu kružnice a odpočítať polomer kružnice. (Na výpočet vzdialenosti je použitá funkcia (technicky metóda triedy Math) Math.hypot(x, y).)

Poznámky: Ak bod leží na kružnici, jeho vzdialenosť od stredu kružnice sa rovná polomeru kružnice, čiže vzdialenosť od kružnice je nulová. Ak bod leží vo vnútri kružnice, tak bez použitia absolútnej hodnoty vyjde vzdialenosť záporná, čo je technicky nezmysel, ale na rýchle odlíšenie tejto situácie (a tiež na zjednodušenie použitia pri niektorých algoritmoch) je tejto metóde ponechaná schopnosť vracania zápornej vzdialenosti. Podobný prístup volia viaceré metódy programovacieho rámca.

Parametre metódy určujú: V[x0, y0] – voľný bod; S[x1, y1] – stred kružnice; r – polomer kružnice.

Rôzne situácie pri meraní vzdialenosti bodu od kružnice touto metódou.

Parametre:

x0 – x-ová súradnica voľného bodu

y0 – y-ová súradnica voľného bodu

x1 – x-ová súradnica stredu S kružnice

y1 – y-ová súradnica stredu S kružnice

r – polomer kružnice

Návratová hodnota:

vzdialenosť bodu od kružnice; záporná hodnota signalizuje, že bod sa nachádza vo vnútri kružnice

vzdialenostBoduOdKruznice

public static final double vzdialenostBoduOdKruznice(double x0,
                                                     double y0,
                                                     double x1,
                                                     double y1,
                                                     double r)

Alias pre vzdialenosťBoduOdKružnice.

vzdialenosťBoduOdKružnice
```
public static final double vzdialenosťBoduOdKružnice(Poloha V,
                                                     Poloha S,
                                                     double r)
```
Vypočíta vzdialenosť od zadaného voľného bodu V ku kružnici určenej stredom S a polomerom r. Pozri aj opis metódy vzdialenosťBoduOdKružnice, ktorej správanie táto metóda kopíruje.

Parametre:

V – poloha voľného bodu

S – poloha stredu kružnice

r – polomer kružnice

Návratová hodnota:

vzdialenosť bodu od úsečky; záporná hodnota signalizuje, že bod sa nachádza vo vnútri kružnice

vzdialenostBoduOdKruznice

public static final double vzdialenostBoduOdKruznice(Poloha V,
                                                     Poloha S,
                                                     double r)

Alias pre vzdialenosťBoduOdKružnice.

vzdialenosťBoduOdKružnice
```
public static final double vzdialenosťBoduOdKružnice(Poloha[] poleBodov,
                                                     double polomer)
```
Vypočíta vzdialenosť medzi voľným bodom V a kružnicou, ktorá je určená stredom S a polomerom r, pričom body V a S sú prvkami poľa poleBodov a r je uložený v parametri polomer). Z uvedeného vyplýva, že pole musí obsahovať aspoň dva prvky. Prvý uchováva súradnice voľného bodu V a druhý stredu kružnice S. (Posledný parameter polomer určuje polomer kružnice.) Pozri aj opis metódy vzdialenosťBoduOdKružnice, ktorej správanie táto metóda kopíruje.

Parametre:

poleBodov – polohy voľného bodu a stredu kružnice

polomer – polomer kružnice

Návratová hodnota:

vzdialenosť bodu od kružnice (prípadne hodnota Double.NaN – v prípade chyby); záporná hodnota signalizuje, že bod sa nachádza vo vnútri kružnice

vzdialenostBoduOdKruznice

public static final double vzdialenostBoduOdKruznice(Poloha[] poleBodov,
                                                     double polomer)

Alias pre vzdialenosťBoduOdKružnice.

vzdialenosťKružníc
```
public static final double vzdialenosťKružníc(double x1,
                                              double y1,
                                              double r1,
                                              double x2,
                                              double y2,
                                              double r2)
```
Vypočíta vzdialenosť medzi dvomi kružnicami, ktoré sú určené svojími stredmi (S1, S2) a polomermi (r1, r2). Ak majú kružnice prienik, tak je vzdialenosť záporná. (Ak sa dotýkajú v jedinom bode, tak je nulová.)

Grafické znázornenie vzdialenosti medzi kružnicami (červenou), ktorú počíta táto metóda.

Parametre metódy určujú: S1[x1, y1] – stred prvej kružnice; r1 – polomer prvej kružnice; S2[x2, y2] – stred druhej kružnice; r2 – polomer druhej kružnice.

Parametre:

x1 – x-ová súradnica stredu S1 (prvej) kružnice

y1 – y-ová súradnica stredu S1 (prvej) kružnice

r1 – polomer prvej kružnice

x2 – x-ová súradnica stredu S2 (druhej) kružnice

y2 – y-ová súradnica stredu S2 (druhej) kružnice

r2 – polomer druhej kružnice

Návratová hodnota:

vzdialenosť kružníc; záporná hodnota signalizuje, že kružnice majú spoločný viac, než jeden bod (prekrývajú sa)

vzdialenostKruznic

public static final double vzdialenostKruznic(double x1,
                                              double y1,
                                              double r1,
                                              double x2,
                                              double y2,
                                              double r2)

Alias pre vzdialenosťKružníc.

vzdialenosťKružníc
```
public static final double vzdialenosťKružníc(Poloha S1,
                                              double r1,
                                              Poloha S2,
                                              double r2)
```
Vypočíta vzdialenosť medzi dvomi kružnicami, ktoré sú určené svojími stredmi (S1, S2) a polomermi (r1, r2). Pozri aj opis metódy vzdialenosťKružníc, ktorej správanie táto metóda kopíruje.

Parametre:

S1 – poloha stredu prvej kružnice

r1 – polomer prvej kružnice

S2 – poloha stredu druhej kružnice

r2 – polomer druhej kružnice

Návratová hodnota:

vzdialenosť kružníc; záporná hodnota signalizuje, že kružnice majú spoločný viac, než jeden bod (prekrývajú sa)

vzdialenostKruznic

public static final double vzdialenostKruznic(Poloha S1,
                                              double r1,
                                              Poloha S2,
                                              double r2)

Alias pre vzdialenosťKružníc.

vzdialenosťKružníc
```
public static final double vzdialenosťKružníc(Poloha[] poleBodov,
                                              double polomer1,
                                              double polomer2)
```
Vypočíta vzdialenosť medzi dvomi kružnicami určenými stredmi S1 a S2 a polomermi r1 a r2, pričom stredy S1 a S2 sú prvkami poľa poleBodov. To znamená, že pole musí obsahovať aspoň dva prvky. Prvý obsahuje súradnice stredu prvej kružnice S1 a druhý druhej kružnice S2. Parametre r1 a r2 určujú polomery kružníc. Pozri aj opis metódy vzdialenosťKružníc, ktorej správanie táto metóda kopíruje.

Parametre:

poleBodov – polohy stredov kružníc

polomer1 – polomer prvej kružnice

polomer2 – polomer druhej kružnice

Návratová hodnota:

vzdialenosť kružníc (prípadne hodnota Double.NaN – v prípade chyby); záporná hodnota signalizuje, že kružnice majú spoločný viac, než jeden bod (prekrývajú sa)

vzdialenostKruznic

public static final double vzdialenostKruznic(Poloha[] poleBodov,
                                              double polomer1,
                                              double polomer2)

Alias pre vzdialenosťKružníc.

vzdialenosťÚsečiek
```
public static final double vzdialenosťÚsečiek(double x1,
                                              double y1,
                                              double x2,
                                              double y2,
                                              double x3,
                                              double y3,
                                              double x4,
                                              double y4)
```
Vypočíta vzdialenosť medzi dvomi úsečkami AB a CD. Ak sa úsečky pretínajú, tak je vzdialenosť nulová. V opačnom prípade metóda nájde najbližšie body úsečiek a vypočíta vzdialenosť medzi nimi.

Parametre metódy vyjadrujú: A[x1, y1] – B[x2, y2] – krajné body prvej úsečky; C[x3, y3] – D[x4, y4] – krajné body druhej úsečky.

Poznámka: V kontexte informácie „ak sa úsečky pretínajú, tak je vzdialenosť nulová,“ nemá zmysel merať vzájomnú vzdialenosť priamok, okrem prípadu, keď sú vzájomne rovnobežné. Rovnobežnosť priamok sa dá overiť metódou priesečníkPriamok – ak sú rovnobežné, tak metóda vráti hodnotu null. Zistenie vzdialenosti rovnobežných priamok potom treba vykonať tak, že zvolíme ľubovoľný bod na jednej priamke, metódou najbližšíBodNaPriamke, získame bod ležiaci na druhej priamke a potom metódou vzdialenosť zistíme vzdialenosť týchto dvoch bodov.

Charakteristické situácie vzájomných polôh úsečiek a spôsob merania vzdialenosti úsečiek v nich.

Na prevzatie:

Interaktívny príklad vzdialenost-useciek.7z vizualizujúci princíp hľadania vzdialenosti úsečiek.

Užitočné zdroje:

Implementácia algoritmu v jazyku Visual Basic:
- Find the shortest distance between two line segments. Rocky Mountain Computer Consulting, Inc. 2010. Citované: 2020. (Filtrovaná kópia zdroja.)
Štrnásťstranová podrobná analýza a implementácia algoritmu v 3D priestore:
- Eberly, David: Robust Computation of Distance Between Line Segments. Geometric Tools, Redmond WA 98052. 2018–2020. Citované: 2020. (Kópia dokumentu na prevzatie.)
Parametre:

x1 – x-ová súradnica určujúceho bodu A prvej úsečky

y1 – y-ová súradnica určujúceho bodu A prvej úsečky

x2 – x-ová súradnica určujúceho bodu B prvej úsečky

y2 – y-ová súradnica určujúceho bodu B prvej úsečky

x3 – x-ová súradnica určujúceho bodu C druhej úsečky

y3 – y-ová súradnica určujúceho bodu C druhej úsečky

x4 – x-ová súradnica určujúceho bodu D druhej úsečky

y4 – y-ová súradnica určujúceho bodu D druhej úsečky

Návratová hodnota:

vzájomná vzdialenosť dvoch úsečiek

vzdialenostUseciek

public static final double vzdialenostUseciek(double x1,
                                              double y1,
                                              double x2,
                                              double y2,
                                              double x3,
                                              double y3,
                                              double x4,
                                              double y4)

Alias pre vzdialenosťÚsečiek.

vzdialenosťÚsečiek
```
public static final double vzdialenosťÚsečiek(Poloha A,
                                              Poloha B,
                                              Poloha C,
                                              Poloha D)
```
Vypočíta vzdialenosť medzi dvomi úsečkami AB a CD. Ak sa úsečky pretínajú, tak je vzdialenosť nulová. V opačnom prípade metóda nájde najbližšie body úsečiek a vypočíta vzdialenosť medzi nimi. Pozri aj opis metódy vzdialenosťÚsečiek, ktorej správanie táto metóda kopíruje.

Parametre:

A – poloha určujúceho bodu A prvej úsečky

B – poloha určujúceho bodu B prvej úsečky

C – poloha určujúceho bodu C druhej úsečky

D – poloha určujúceho bodu D druhej úsečky

Návratová hodnota:

vzájomná vzdialenosť dvoch úsečiek

vzdialenostUseciek

public static final double vzdialenostUseciek(Poloha A,
                                              Poloha B,
                                              Poloha C,
                                              Poloha D)

Alias pre vzdialenosťÚsečiek.

vzdialenosťÚsečiek
```
public static final double vzdialenosťÚsečiek(Poloha[] poleBodov)
```
Vypočíta vzdialenosť medzi dvomi úsečkami AB a CD, pričom ich určujúce body sú prvkami poľa poleBodov. To znamená, že pole musí obsahovať aspoň štyri prvky. Prvé dva prvky sú určujúce body prvej úsečky (A, B) a ďalšie dva druhej (C, D). Ak sa úsečky pretínajú, tak je vzdialenosť nulová. V opačnom prípade metóda nájde najbližšie body úsečiek a vypočíta vzdialenosť medzi nimi. Pozri aj opis metódy vzdialenosťÚsečiek, ktorej správanie táto metóda kopíruje.

Parametre:

poleBodov – polohy určujúcich bodov úsečiek

Návratová hodnota:

vzájomná vzdialenosť dvoch úsečiek (prípadne hodnota Double.NaN – v prípade chyby)

vzdialenostUseciek

public static final double vzdialenostUseciek(Poloha[] poleBodov)

Alias pre vzdialenosťÚsečiek.

vzdialenosťPriamkyOdKružnice
```
public static final double vzdialenosťPriamkyOdKružnice(double x1,
                                                        double y1,
                                                        double x2,
                                                        double y2,
                                                        double x3,
                                                        double y3,
                                                        double r)
```
Vypočíta vzdialenosť medzi určenou priamkou a kružnicou. Pozor! Ak sa priamka a kružnica pretínajú, tak vrátená vzdialenosť (v) je menšia od nuly, čo je z pohľadu zhody s realitou číry nezmysel, ale keďže aj táto hodnota sa dá využiť v praxi, bol tento spôsob v programovacom rámci ponechaný (dôvody tohto správania sú rovnaké ako pri metóde vzdialenosťÚsečkyOdKružnice – pozri jej opis), pričom absolútna hodnota tejto vzdialenosti je rovná vzdialenosti dvoch bodov určených takto:

Ide o body ležiace na kolmici (K) so zadanou priamkou (P), ktorá zároveň prechádza stredom zadanej kružnice (C). Prvý bod (B₁) je priesečníkom priamok K a P. Druhý bod (B₂) je taký priesečník kolmice K a kružnice C, ktorý leží bližšie k prvému priesečníku (porovnaj s priesečníkom B₂′):

Grafické znázornenie vyššie opisovanej situácie – určovania vzdialenosti priamky od kružnice, ktoré sa pretínajú.

Ak sa kružnica a priamka dotýkajú v jedinom bode, tak je vzdialenosť nulová.

Poznámka: Cieľom relatívne komplikovaného opisu vyššie (zahŕňajúceho priesečníky, kolmicu, priamku a kružnicu) je presné vysvetlenie analytického riešenia problému, ktoré bolo zvolené tak, aby bolo čo najmenej výpočtovo náročné. V skutočnosti je veľmi priamočiare. Je to skrátka rozdiel dvoch hodnôt, konkrétne:
• vzdialenosti stredu kružnice od priamky
• a polomeru kružnice.
(Pričom algoritmus výpočtu vzdialenosti bodu od priamky nie je príliš výpočtovo náročný a aj v triedach Javy sa nachádza metóda, ktorá tento algoritmus implementuje. Programovací rámec GRobot vnútorne implementuje vlastnú optimalizovanú verziu jednej z implementácií tejto metódy – pozri: vzdialenosťBoduOdPriamky.)

Grafické znázornenie vzdialenosti úsečky od kružnice (červenou), ktorú počíta táto metóda.
(Šedou farbou je znázornená vzdialenosť, ktorú by v tomto prípade vypočítala metóda vzdialenosťÚsečkyOdKružnice.)

S1[x1, y1] – S2[x2, y2] – určujúce body priamky; S3[x3, y3] – stred kružnice; r – polomer kružnice

Parametre:

x1 – x-ová súradnica určujúceho bodu A priamky

y1 – y-ová súradnica určujúceho bodu A priamky

x2 – x-ová súradnica určujúceho bodu B priamky

y2 – y-ová súradnica určujúceho bodu B priamky

x3 – x-ová súradnica stredu kružnice

y3 – y-ová súradnica stredu kružnice

r – polomer kružnice

vzdialenostPriamkyOdKruznice

public static final double vzdialenostPriamkyOdKruznice(double x1,
                                                        double y1,
                                                        double x2,
                                                        double y2,
                                                        double x3,
                                                        double y3,
                                                        double r)

Alias pre vzdialenosťPriamkyOdKružnice.

vzdialenosťPriamkyOdKružnice

public static final double vzdialenosťPriamkyOdKružnice(Poloha A,
                                                        Poloha B,
                                                        Poloha S,
                                                        double r)

Vypočíta vzdialenosť medzi určenou priamkou AB a kružnicou so stredom S a polomerom r. Pozri aj opis metódy vzdialenosťPriamkyOdKružnice, ktorej správanie táto metóda kopíruje.

Parametre:: A – poloha určujúceho bodu A priamky; B – poloha určujúceho bodu B priamky; S – poloha stredu kružnice; r – polomer kružnice

vzdialenostPriamkyOdKruznice

public static final double vzdialenostPriamkyOdKruznice(Poloha A,
                                                        Poloha B,
                                                        Poloha S,
                                                        double r)

Alias pre vzdialenosťPriamkyOdKružnice.

vzdialenosťPriamkyOdKružnice
```
public static final double vzdialenosťPriamkyOdKružnice(Poloha[] poleBodov,
                                                        double r)
```
Vypočíta vzdialenosť medzi určenou priamkou AB a kružnicou so stredom S a polomerom r, pričom body A, B a stred S sú určené prvkami poľa poleBodov. To znamená, že pole musí obsahovať aspoň tri prvky. Prvé dva prvky sú určujúce body priamky (A a B) a tretí prvok je stred kružnice (S). Pozri aj opis metódy vzdialenosťPriamkyOdKružnice, ktorej správanie táto metóda kopíruje.

Parametre:

poleBodov – polohy určujúcich bodov priamky a poloha stredu kružnice

r – polomer kružnice

vzdialenostPriamkyOdKruznice

public static final double vzdialenostPriamkyOdKruznice(Poloha[] poleBodov,
                                                        double r)

Alias pre vzdialenosťPriamkyOdKružnice.

vzdialenosťÚsečkyOdKružnice
```
public static final double vzdialenosťÚsečkyOdKružnice(double x1,
                                                       double y1,
                                                       double x2,
                                                       double y2,
                                                       double x3,
                                                       double y3,
                                                       double r)
```
Vypočíta vzdialenosť medzi určenou úsečkou a kružnicou. Pozor! Ak sa úsečka a kružnica pretínajú, tak vrátená vzdialenosť je menšia od nuly (bez ohľadu na nezmyselnosť tohto výsledku) a jej absolútna hodnota je vzdialenosťou najbližšieho bodu na úsečke od stredu kružnice. Technicky je v takom prípade vzdialenosť nulová, ale je užitočné mať možnosť rozlíšiť tento prípad. Najmä pri programovaní rôznych situácií. Preto vracia táto metóda aj záporné hodnoty, ktoré sa dajú v prípade potreby odfiltrovať vhodnou podmienkou.

Ak sa kružnica a úsečka dotýkajú v jedinom bode, tak je vzdialenosť nulová. Ak je niektorý krajný bod úsečky (S1 alebo S2) najbližším bodom úsečky k stredu kružnice, tak je vypočítaná vzdialenosť tohto bodu od kružnice.

Grafické znázornenie vzdialenosti úsečky od kružnice (červenou), ktorú počíta táto metóda.
(Pozri aj obrázok v opise metódy vzdialenosťPriamkyOdKružnice.)

S1[x1, y1] – S2[x2, y2] – krajné body úsečky; S3[x3, y3] – stred kružnice; r – polomer kružnice

Parametre:

x1 – x-ová súradnica určujúceho bodu A úsečky

y1 – y-ová súradnica určujúceho bodu A úsečky

x2 – x-ová súradnica určujúceho bodu B úsečky

y2 – y-ová súradnica určujúceho bodu B úsečky

x3 – x-ová súradnica stredu kružnice

y3 – y-ová súradnica stredu kružnice

r – polomer kružnice

vzdialenostUseckyOdKruznice

public static final double vzdialenostUseckyOdKruznice(double x1,
                                                       double y1,
                                                       double x2,
                                                       double y2,
                                                       double x3,
                                                       double y3,
                                                       double r)

Alias pre vzdialenosťÚsečkyOdKružnice.

vzdialenosťÚsečkyOdKružnice

public static final double vzdialenosťÚsečkyOdKružnice(Poloha A,
                                                       Poloha B,
                                                       Poloha S,
                                                       double r)

Vypočíta vzdialenosť medzi určenou úsečkou AB a kružnicou so stredom S a polomerom r. Pozri aj opis metódy vzdialenosťÚsečkyOdKružnice, ktorej správanie táto metóda kopíruje.

Parametre:: A – poloha určujúceho bodu A úsečky; B – poloha určujúceho bodu B úsečky; S – poloha stredu kružnice; r – polomer kružnice

vzdialenostUseckyOdKruznice

public static final double vzdialenostUseckyOdKruznice(Poloha A,
                                                       Poloha B,
                                                       Poloha S,
                                                       double r)

Alias pre vzdialenosťÚsečkyOdKružnice.

vzdialenosťÚsečkyOdKružnice
```
public static final double vzdialenosťÚsečkyOdKružnice(Poloha[] poleBodov,
                                                       double r)
```
Vypočíta vzdialenosť medzi určenou úsečkou AB a kružnicou so stredom S a polomerom r, pričom body A, B a stred S sú určené prvkami poľa poleBodov. To znamená, že pole musí obsahovať aspoň tri prvky. Prvé dva prvky sú určujúce body úsečky (A a B) a tretí prvok je stred kružnice (S). Pozri aj opis metódy vzdialenosťÚsečkyOdKružnice, ktorej správanie táto metóda kopíruje.

Parametre:

poleBodov – polohy určujúcich bodov úsečky a poloha stredu kružnice

r – polomer kružnice

vzdialenostUseckyOdKruznice

public static final double vzdialenostUseckyOdKruznice(Poloha[] poleBodov,
                                                       double r)

Alias pre vzdialenosťÚsečkyOdKružnice.

početZariadení
```
public static int početZariadení()
```
Zistí počet obrazovkových zariadení, ktoré sú dostupné na tomto počítači. Toto je vhodné overiť pred pokusom o prepnutie sveta do režimu celej obrazovky.

Návratová hodnota:

počet zariadení

Pozri tiež:

šírkaZariadenia(), šírkaZariadenia(int), výškaZariadenia(), výškaZariadenia(int), celáObrazovka(), celáObrazovka(int), celáObrazovka(boolean), celáObrazovka(int, boolean), premiestniNaZariadenie(int), zistiZariadenieOkna()

pocetZariadení
```
public static int pocetZariadení()
```
Alias pre početZariadení.

početObrazoviek
```
public static int početObrazoviek()
```
Alias pre početZariadení.

pocetObrazoviek
```
public static int pocetObrazoviek()
```
Alias pre početZariadení.

šírkaZariadenia
```
public static int šírkaZariadenia()
```
Zistí šírku dostupného obrazovkového zariadenia.

Návratová hodnota:

šírka obrazovkového zariadenia v pixeloch; hodnota -1 znamená chybu

Pozri tiež:

početZariadení(), šírkaZariadenia(int), výškaZariadenia(), výškaZariadenia(int), celáObrazovka(), celáObrazovka(int), celáObrazovka(boolean), celáObrazovka(int, boolean), zistiZariadenieOkna()

sirkaZariadenia
```
public static int sirkaZariadenia()
```
Alias pre šírkaZariadenia.

šírkaObrazovky
```
public static int šírkaObrazovky()
```
Alias pre šírkaZariadenia.

sirkaObrazovky
```
public static int sirkaObrazovky()
```
Alias pre šírkaZariadenia.

šírkaZariadenia
```
public static int šírkaZariadenia(int zariadenie)
```
Zistí šírku dostupného obrazovkového zariadenia. Zariadenie je určené jeho „poradovým číslom“ (indexom; čiže nula označuje prvé zariadenie).

Parametre:

zariadenie – číslo zariadenia, ktorého šírka má byť zistená

Návratová hodnota:

šírka obrazovkového zariadenia v pixeloch; hodnota -1 znamená chybu

Pozri tiež:

početZariadení(), šírkaZariadenia(), výškaZariadenia(), výškaZariadenia(int), celáObrazovka(), celáObrazovka(int), celáObrazovka(boolean), celáObrazovka(int, boolean), zistiZariadenieOkna()

sirkaZariadenia

public static int sirkaZariadenia(int zariadenie)

Alias pre šírkaZariadenia.

šírkaObrazovky

public static int šírkaObrazovky(int zariadenie)

Alias pre šírkaZariadenia.

sirkaObrazovky

public static int sirkaObrazovky(int zariadenie)

Alias pre šírkaZariadenia.

výškaZariadenia
```
public static int výškaZariadenia()
```
Zistí výšku dostupného obrazovkového zariadenia.

Návratová hodnota:

výška obrazovkového zariadenia v pixeloch; hodnota -1 znamená chybu

Pozri tiež:

početZariadení(), šírkaZariadenia(), šírkaZariadenia(int), výškaZariadenia(int), celáObrazovka(), celáObrazovka(int), celáObrazovka(boolean), celáObrazovka(int, boolean), zistiZariadenieOkna()

vyskaZariadenia
```
public static int vyskaZariadenia()
```
Alias pre výškaZariadenia.

výškaObrazovky
```
public static int výškaObrazovky()
```
Alias pre výškaZariadenia.

vyskaObrazovky
```
public static int vyskaObrazovky()
```
Alias pre výškaZariadenia.

výškaZariadenia
```
public static int výškaZariadenia(int zariadenie)
```
Zistí výšku dostupného obrazovkového zariadenia. Zariadenie je určené jeho „poradovým číslom“ (indexom; čiže nula označuje prvé zariadenie).

Parametre:

zariadenie – číslo zariadenia, ktorého výška má byť zistená

Návratová hodnota:

výška obrazovkového zariadenia v pixeloch; hodnota -1 znamená chybu

Pozri tiež:

početZariadení(), šírkaZariadenia(), šírkaZariadenia(int), výškaZariadenia(), celáObrazovka(), celáObrazovka(int), celáObrazovka(boolean), celáObrazovka(int, boolean), zistiZariadenieOkna()

vyskaZariadenia

public static int vyskaZariadenia(int zariadenie)

Alias pre výškaZariadenia.

výškaObrazovky

public static int výškaObrazovky(int zariadenie)

Alias pre výškaZariadenia.

vyskaObrazovky

public static int vyskaObrazovky(int zariadenie)

Alias pre výškaZariadenia.

celáObrazovka
```
public static boolean celáObrazovka()
```
Pokúsi sa prepnúť svet do režimu celej obrazovky.

Návratová hodnota:

informuje o úspešnosti operácie – hodnota true znamená úspech a false neúspech

Pozri tiež:

početZariadení(), šírkaZariadenia(), šírkaZariadenia(int), výškaZariadenia(), výškaZariadenia(int), celáObrazovka(int), celáObrazovka(boolean), celáObrazovka(int, boolean), oknoCelejObrazovky(), zistiZariadenieOkna()

celaObrazovka
```
public static boolean celaObrazovka()
```
Alias pre celáObrazovka.

celáObrazovka
```
public static boolean celáObrazovka(int zariadenie)
```
Pokúsi sa prepnúť svet do režimu celej obrazovky na určenom zobrazovacom zariadení. Zariadenie je určené jeho poradovým číslom (indexom; čiže nula označuje prvé zariadenie).

(Príklad použitia tejto metódy je pri opise metódy celáObrazovka(int zariadenie, boolean celáObrazovka).)

Parametre:

zariadenie – číslo zariadenia, ktoré má byť použité v režime celej obrazovky

Návratová hodnota:

informuje o úspešnosti operácie – hodnota true znamená úspech a false neúspech

Pozri tiež:

početZariadení(), šírkaZariadenia(), šírkaZariadenia(int), výškaZariadenia(), výškaZariadenia(int), celáObrazovka(), celáObrazovka(boolean), celáObrazovka(int, boolean), oknoCelejObrazovky(), zistiZariadenieOkna()

celaObrazovka

public static boolean celaObrazovka(int zariadenie)

Alias pre celáObrazovka.

celáObrazovka
```
public static boolean celáObrazovka(boolean celáObrazovka)
```
Pokúsi sa prepnúť svet do režimu celej obrazovky alebo späť.

Parametre:

celáObrazovka – ak je true, tak má byť režim celej obrazovky zapnutý, ak je false, tak má byť režim celej obrazovky vypnutý

Návratová hodnota:

informuje o úspešnosti operácie – hodnota true znamená úspech a false neúspech

Pozri tiež:

početZariadení(), šírkaZariadenia(), šírkaZariadenia(int), výškaZariadenia(), výškaZariadenia(int), celáObrazovka(), celáObrazovka(int), celáObrazovka(int, boolean), oknoCelejObrazovky(), zistiZariadenieOkna()

celaObrazovka

public static boolean celaObrazovka(boolean celáObrazovka)

Alias pre celáObrazovka.

celáObrazovka
```
public static boolean celáObrazovka(int zariadenie,
                                    boolean celáObrazovka)
```
Pokúsi sa prepnúť svet do režimu celej obrazovky alebo späť na určenom zobrazovacom zariadení. Zariadenie je určené jeho „poradovým číslom“ (indexom; čiže nula označuje prvé zariadenie).

Poznámka: V režime celej obrazovky nie je dostupná ponuka, pretože testovanie ukázalo, že v režime celej obrazovky spôsobujú všetky „ponukovo orientované“ prvky používateľského rozhrania (hlavná ponuka, rozbaľovací zoznam…) problémy. Nemali by ste ich preto v režime celej obrazovky používať.

Počas prechodu do režimu celej obrazovky sa však automaticky aktivuje klávesová skratka Ctrl + W, resp. ⌘ + W (Command + W), ktorá bola pôvodne naviazaná na položku ponuky a ktorá nesie význam príkazu ukončenia aplikácie.

Počas testovania sme tiež zistili, že pri použití hardvérového prechodu do režimu celej obrazovky je prinajmenšom na platforme Windows automaticky skrytý kurzor myši a jeho viditeľnosť nie je možné nijakým spôsobom obnoviť. Pri prechode späť do „normálneho“ režimu je viditeľnosť kurzora automaticky obnovená. V prípade potreby je možné použiť na zobrazenie polohy kurzora niektorý robot, ktorý bude sledovať polohu myši.

Príklad:
```
import knižnica.*;

public class TestCelejObrazovky extends GRobot
{
    // Ktoré zariadenie má byť použité v režime celej obrazovky?
    // Nula je predvolené. V hlavnej metóde je úprava tejto hodnoty…
    private static int zariadenie = 0;

    private TestCelejObrazovky()
    {
        // Nastavenie rozmerov plátna podľa rozmerov zariadenia.
        super(Svet.šírkaZariadenia(zariadenie),
            Svet.výškaZariadenia(zariadenie));

        Svet.upevni();
        Svet.celáObrazovka(zariadenie);
    }

    // Obsluha klávesnice (na ukončenie aplikácie).
    @Override public void uvoľnenieKlávesu()
    {
        // Kláves ESC spôsobí vypnutie aplikácie.
        if (ÚdajeUdalostí.kláves(Kláves.ESCAPE))
            Svet.zavrieť();
    }

    // Hlavná metóda.
    public static void main(String[] args)
    {
        // Je pravdepodobné, že druhé zariadenie je spätný projektor, preto
        // je tu tento test… Toto správanie odporúčame upraviť podľa potrieb.
        if (Svet.početZariadení() > 1) ++zariadenie;
        new TestCelejObrazovky();
    }
}
```
Parametre:

zariadenie – číslo zariadenia, ktoré má byť použité v režime celej obrazovky

celáObrazovka – ak je true, tak má byť režim celej obrazovky zapnutý, ak je false, tak má byť režim celej obrazovky vypnutý

Návratová hodnota:

informuje o úspešnosti operácie – hodnota true znamená úspech a false neúspech

Pozri tiež:

početZariadení(), šírkaZariadenia(), šírkaZariadenia(int), výškaZariadenia(), výškaZariadenia(int), celáObrazovka(), celáObrazovka(int), celáObrazovka(boolean), oknoCelejObrazovky(), zistiZariadenieOkna()

celaObrazovka

public static boolean celaObrazovka(int zariadenie,
                                    boolean celáObrazovka)

Alias pre celáObrazovka.

oknoCelejObrazovky
```
public static JFrame oknoCelejObrazovky()
```
Ak je svet v režime celej obrazovky, tak táto metóda vráti inštanciu okna celej obrazovky, inak metóda vráti hodnotu null.

Návratová hodnota:

inštancia okna alebo null

Pozri tiež:

celáObrazovka()

prenes
```
public static void prenes(JFrame inéOkno,
                          boolean tam)
```
Prenesie grafiku sveta do iného okna alebo späť. Toto je pokročilá funkcia, ktorá dovoľuje preniesť grafické komponenty sveta (zjednodušene kresliace plátna vrátane robotov) do iného, zákaznícky definovaného okna. Táto funkcia nájde využitie, ak chceme grafiku sveta preniesť do okna bez dekoru, pretože zmeniť tento stav pri jestvujúcom okne (svete) nie je v Jave možné.

Upozornenie: V súčasnosti nie je možné prenášať komponenty do (a z) inštancií triedy Okno. (Tieto okná majú vlastný hlavný panel s vlastnými obsluhami udalostí a pokus o prenos by (aj keď by bol zdanlivo úspešný) vyvolal množstvo kolíznych situácií.)

Na prevzatie:

Tento príklad: testPrenosuOkna.7z vytvorí okno bez dekoru a bez pozadia. Po spustení sa zobrazí klasické okno. Keď do neho používateľ klikne, okno zmizne a nad všetkými oknami sa zobrazí vlastné okno (bez dekoru a pozadia), čo vytvorí dojem zobrazenia aktuálneho robota (kresleného ako tyrkysovú kružnicu) „vo voľnom priestore“:

Prepnutie späť je možné kliknutím na kružnicu.

Upozornenie: Keďže vlastné okno nemá pozadie, musí byť pred každým prekreslením volaná metóda resetujRaster, inak by sa každé kreslenie pridalo k predchádzajúcemu nakreslenému obsahu.

Parametre:

inéOkno – okno, do ktorého alebo z ktorého majú byť prenesené grafické komponenty

tam – smer prenosu: true – komponenty sa prenesú do okna; false – komponenty sa prenesú späť

prenes
```
public static void prenes(JFrame inéOkno)
```
Prenesie grafiku sveta do iného okna. Táto metóda vykoná to isté ako keby sme volali metódu: prenes(inéOkno, true). Podrobnosti sú uvedené v jej opise.

Parametre:

inéOkno – okno, do ktorého majú byť prenesené grafické komponenty

Pozri tiež:

prenes(JFrame, boolean)

zachyťMyš

public static boolean zachyťMyš()

Zachytí kurzor myši v okne sveta. Zmení sa tým správanie udalostí pohybu myši a to tak, že od okamihu úspešného zachytenia myši v okne bude kurzor myši automaticky presúvaný do stredu okna po každej udalosti pohybu alebo ťahania myšou a aktuálne súradnice polohy kurzora myši budú indikovať posledný relatívny posun kurzora od tejto polohy (v súlade s tým budú súradnice poslednej polohy kurzora myši indikovať predposledný relatívny posun).

Upozornenie: Zachytenie kurzora myši vyžaduje permanentý nízkoúrovňový prístup ku kurzoru, aby aplikácia mohla viazať jeho polohu k stredu okna. V niektorých prípadoch (napríklad z dôvodu obmedzení operačným systémom alebo pri prístupe cez vzdialenú správu) aplikácia tento prístup nemá. V takom prípade nebude zachytenie kurzora myši fungovať správne.

Tip: Keďže kurzor myši je fixovaný do stredu okna sveta. Odporúčame kurzor súčasne s jeho zachytením skryť: zmeňKurzorMyši(null).

Príklad:

V tomto príklade je použité zachytenie kurzora myši. Prostredie je nastavené tak, že hlavný robot je ovládaný myšou, pričom vďaka ohraničeniu a zobrazeniu okna sveta na celej obrazovke prechádza cyklicky cez okraje obrazovky.

import knižnica.*;

public class ZachytenieMyši extends GRobot
{
    private ZachytenieMyši()
    {
        // Nastav rozmery plátna podľa rozmerov obrazovky (resp. tzv. prvého
        // zobrazovacieho zariadenia – prvého monitora):
        super(Svet.šírkaZariadenia(), Svet.výškaZariadenia());

        // Nastav vlastnosti robota:
        ohranič();
        vľavo(30);
        veľkosť(30);
        vypĺňajTvary();
        farba(papierová);

        // Nastav vlastnosti sveta (medzi inými aj zachytenie myši v okne):
        Svet.farbaPozadia(antracitová);
        Svet.zachyťMyš();
        Svet.celáObrazovka(true);
        Svet.zmeňKurzorMyši(null);
    }

    @Override public void pohybMyši()
    {
        // Pohyb robota podľa pohybu myši:
        if (Svet.myšJeZachytená())
            skoč(ÚdajeUdalostí.polohaMyšiX(), ÚdajeUdalostí.polohaMyšiY());
        else
            // Táto vetva zaručí, že keby zachytenie myši zlyhalo,
            // ovládanie bude fungovať relatívne správne:
            skočNa(ÚdajeUdalostí.polohaMyši());
    }

    public static void main(String[] args)
    {
        new ZachytenieMyši();
    }
}

Návratová hodnota:: true v prípade úspešnej operácie
Pozri tiež:: uvoľniMyš(), myšJeZachytená()

zachytMys
```
public static boolean zachytMys()
```
Alias pre zachyťMyš.

uvoľniMyš
```
public static boolean uvoľniMyš()
```
Zruší zachytenie kurzora myš v okne sveta. Pozri metódu zachyťMyš.

Návratová hodnota:

true v prípade úspešnej operácie

Pozri tiež:

zachyťMyš(), myšJeZachytená()

uvolniMys
```
public static boolean uvolniMys()
```
Alias pre uvoľniMyš.

myšJeZachytená
```
public static boolean myšJeZachytená()
```
Overí, či je myš zachytená v okne sveta. Pozri metódu zachyťMyš.

Návratová hodnota:

true ak je myš zachytená

Pozri tiež:

zachyťMyš(), uvoľniMyš()

mysJeZachytena

public static boolean mysJeZachytena()

Alias pre myšJeZachytená.

pridajKlávesovúSkratku
```
public static void pridajKlávesovúSkratku(String príkaz,
                                          int kódKlávesu)
```
Definuje novú klávesovú skratku s modifikátorom pre ponuky, ktorá bude previazaná so zadaným príkazom. Klávesové skratky sú spracúvané udalosťou ObsluhaUdalostí.klávesováSkratka(), ktorá používa metódu ÚdajeUdalostí.príkazSkratky() na identifikáciu príkazu.

Táto klávesová skratka je definovaná s predvoleným modifikátorom používaným pre klávesové skratky položiek ponuky. Ten je závislý od operačného systému, napríklad vo Windows je to kláves Ctrl, v macOS (predtým OS X a Mac OS) je to kláves ⌘ (Command). Ak chcete definovať klávesovú skratku bez modifikátora, použite metódu pridajKlávesovúSkratku(príkaz, kódKlávesu, modifikátor) s hodnotou modifikátora 0.

Poznámka: Príklad použitia nájdete napríklad v opise vnorenej triedy Svet.PríkazovýRiadok.

Parametre:

príkaz – príkaz, ktorý bude previazaný s touto klávesovou skratkou

kódKlávesu – kód klávesu, ktorý má byť použitý ako klávesová skratka (v kombinácii s modifikátorom pre ponuky); môže to byť ľubovoľný kód klávesu z triedy Kláves (Kláves.HORE, Kláves.VK_X…)

Pozri tiež:

pridajKlávesovúSkratku(String, int, int), pridajKlávesovúSkratku(String, int, int, boolean), pridajKlávesovúSkratkuVstupnéhoRiadka(String, int, int), odoberKlávesovúSkratku(String), skratkaPríkazu(String), reťazecSkratkyPríkazu(String), skratkyStropu(), skratkyStropu(boolean), skratkyPodlahy(), skratkyPodlahy(boolean)

pridajKlavesovuSkratku

public static void pridajKlavesovuSkratku(String príkaz,
                                          int kódKlávesu)

Alias pre pridajKlávesovúSkratku.

pridajKlávesovúSkratku
```
public static void pridajKlávesovúSkratku(String príkaz,
                                          int kódKlávesu,
                                          int modifikátor)
```
Definuje novú klávesovú skratku, ktorá bude previazaná so zadaným príkazom. Klávesové skratky sú spracúvané udalosťou ObsluhaUdalostí.klávesováSkratka(), ktorá používa metódu ÚdajeUdalostí.príkazSkratky() na identifikáciu príkazu.

Poznámka: Príklad použitia nájdete napríklad v opise vnorenej triedy Svet.PríkazovýRiadok.

Parametre:

príkaz – príkaz, ktorý bude previazaný s touto klávesovou skratkou

kódKlávesu – kód klávesu, ktorý má byť použitý ako klávesová skratka; môže to byť ľubovoľný kód klávesu z triedy Kláves (Kláves.HORE, Kláves.VK_X…)

modifikátor – klávesový modifikátor tejto skratky (napríklad kláves Ctrl – Kláves.CTRL_MASK, Shift – Kláves.SHIFT_MASK, Alt – Kláves.ALT_MASK…); klávesový modifikátor ponúk, ktorý je závislý od operačného systému definuje rezervovaný identifikátor Kláves.SKRATKA_PONUKY; klávesovú skratku bez modifikátora je možné definovať zadaním hodnoty 0

Pozri tiež:

pridajKlávesovúSkratku(String, int), pridajKlávesovúSkratku(String, int, int, boolean), pridajKlávesovúSkratkuVstupnéhoRiadka(String, int, int), odoberKlávesovúSkratku(String), skratkaPríkazu(String), reťazecSkratkyPríkazu(String), skratkyStropu(), skratkyStropu(boolean), skratkyPodlahy(), skratkyPodlahy(boolean)

pridajKlavesovuSkratku

public static void pridajKlavesovuSkratku(String príkaz,
                                          int kódKlávesu,
                                          int modifikátor)

Alias pre pridajKlávesovúSkratku.

pridajKlávesovúSkratku
```
public static void pridajKlávesovúSkratku(String príkaz,
                                          int kódKlávesu,
                                          int modifikátor,
                                          boolean ajVstupnýRiadok)
```
Definuje novú klávesovú skratku, ktorá bude previazaná so zadaným príkazom. Klávesové skratky sú spracúvané udalosťou ObsluhaUdalostí.klávesováSkratka(), ktorá používa metódu ÚdajeUdalostí.príkazSkratky() na identifikáciu príkazu.

Niektoré klávesové skratky by mohli spôsobiť obmedzenie funkčnosti vstupného riadka, preto táto verzia metódy umožňuje nepriradiť túto skratku vstupnému riadku. Naopak, v niektorých prípadoch je žiadúce definovať klávesovú skratku len pre vstupný riadok. Na tieto prípady je rezervovaná samostatná metóda pridajKlávesovúSkratkuVstupnéhoRiadka.

Poznámka: Príklad použitia nájdete napríklad v opise vnorenej triedy Svet.PríkazovýRiadok.

Parametre:

príkaz – príkaz, ktorý bude previazaný s touto klávesovou skratkou

kódKlávesu – kód klávesu, ktorý má byť použitý ako klávesová skratka; môže to byť ľubovoľný kód klávesu z triedy Kláves (Kláves.HORE, Kláves.VK_X…)

modifikátor – klávesový modifikátor tejto skratky (napríklad kláves Ctrl – Kláves.CTRL_MASK, Shift – Kláves.SHIFT_MASK, Alt – Kláves.ALT_MASK…); klávesový modifikátor ponúk, ktorý je závislý od operačného systému definuje rezervovaný identifikátor Kláves.SKRATKA_PONUKY; klávesovú skratku bez modifikátora je možné definovať zadaním hodnoty 0

ajVstupnýRiadok – ak si neželáme, aby táto skratka fungovala aj vo vstupnom riadku, zadáme false

Pozri tiež:

pridajKlávesovúSkratku(String, int), pridajKlávesovúSkratku(String, int, int), pridajKlávesovúSkratkuVstupnéhoRiadka(String, int, int), odoberKlávesovúSkratku(String), skratkaPríkazu(String), reťazecSkratkyPríkazu(String), skratkyStropu(), skratkyStropu(boolean), skratkyPodlahy(), skratkyPodlahy(boolean)

pridajKlavesovuSkratku

public static void pridajKlavesovuSkratku(String príkaz,
                                          int kódKlávesu,
                                          int modifikátor,
                                          boolean ajVstupnýRiadok)

Alias pre pridajKlávesovúSkratku.

pridajKlávesovúSkratkuVstupnéhoRiadka
```
public static void pridajKlávesovúSkratkuVstupnéhoRiadka(String príkaz,
                                                         int kódKlávesu,
                                                         int modifikátor)
```
Definuje novú klávesovú skratku pre vstupný riadok, ktorá bude previazaná so zadaným príkazom. Klávesové skratky sú spracúvané udalosťou ObsluhaUdalostí.klávesováSkratka(), ktorá používa metódu ÚdajeUdalostí.príkazSkratky() na identifikáciu príkazu.

Toto je doplnková metóda, ktorá umožňuje definovať skupinu klávesových skratiek, ktoré budú použiteľné len vo vstupnom riadku. Na definovanie klávesových skratiek hlavného okna slúži množina metód pridajKlávesovúSkratku.

Upozornenie: Táto metóda odoberie prípadnú skratku definovanú pre hlavné okno (t. j. prostredníctvom niektorej z metód pridajKlávesovúSkratku) a túto skratku je možné odobrať (rovnako ako skratky hlavného okna) volaním metódy odoberKlávesovúSkratku

Parametre:

príkaz – príkaz, ktorý bude previazaný s touto klávesovou skratkou

kódKlávesu – kód klávesu, ktorý má byť použitý ako klávesová skratka; môže to byť ľubovoľný kód klávesu z triedy Kláves (Kláves.HORE, Kláves.VK_X…)

modifikátor – klávesový modifikátor tejto skratky (napríklad kláves Ctrl – Kláves.CTRL_MASK, Shift – Kláves.SHIFT_MASK, Alt – Kláves.ALT_MASK…); klávesový modifikátor ponúk, ktorý je závislý od operačného systému definuje rezervovaný identifikátor Kláves.SKRATKA_PONUKY; klávesovú skratku bez modifikátora je možné definovať zadaním hodnoty 0

Pozri tiež:

pridajKlávesovúSkratku(String, int), pridajKlávesovúSkratku(String, int, int), pridajKlávesovúSkratku(String, int, int, boolean), odoberKlávesovúSkratku(String), skratkaPríkazu(String), reťazecSkratkyPríkazu(String), skratkyStropu(), skratkyStropu(boolean), skratkyPodlahy(), skratkyPodlahy(boolean)

pridajKlavesovuSkratkuVstupnehoRiadka

public static void pridajKlavesovuSkratkuVstupnehoRiadka(String príkaz,
                                                         int kódKlávesu,
                                                         int modifikátor)

Alias pre pridajKlávesovúSkratkuVstupnéhoRiadka.

odoberKlávesovúSkratku
```
public static void odoberKlávesovúSkratku(String príkaz)
```
Odoberie definovanú klávesovú skratku, ktorá je previazaná so zadaným príkazom. Príkaz odoberie skratky zo zoznamu skratiek hlavného okna aj vstupného riadka.

Parametre:

príkaz – príkaz, ktorý je previazaný s niektorou klávesovou skratkou

Pozri tiež:

pridajKlávesovúSkratku(String, int), pridajKlávesovúSkratku(String, int, int), pridajKlávesovúSkratku(String, int, int, boolean), pridajKlávesovúSkratkuVstupnéhoRiadka(String, int, int), skratkaPríkazu(String), reťazecSkratkyPríkazu(String), skratkyStropu(), skratkyStropu(boolean), skratkyPodlahy(), skratkyPodlahy(boolean)

odoberKlavesovuSkratku

public static void odoberKlavesovuSkratku(String príkaz)

Alias pre odoberKlávesovúSkratku.

skratkaPríkazu
```
public static KeyStroke skratkaPríkazu(String príkaz)
```
Táto metóda zistí, aká klávesová skratka je priradená zadanému príkazu. Ak taká skratka nejestvuje, metóda vráti hodnotu null.

Metóda nedokáže rozlíšiť, či je skratka platná pre hlavné okno a/alebo vstupný riadok, preto ak rozlišujete medzi skratkami definovanými pre vstupný riadok a hlavné okno, tak odporúčame pre nich zvoliť unikátne názvy.

Parametre:

príkaz – príkaz, ktorý by mal byť previazaný s niektorou klávesovou skratkou

Návratová hodnota:

objekt typu KeyStroke alebo null

Pozri tiež:

pridajKlávesovúSkratku(String, int), pridajKlávesovúSkratku(String, int, int), pridajKlávesovúSkratku(String, int, int, boolean), pridajKlávesovúSkratkuVstupnéhoRiadka(String, int, int), odoberKlávesovúSkratku(String), reťazecSkratkyPríkazu(String), skratkyStropu(), skratkyStropu(boolean), skratkyPodlahy(), skratkyPodlahy(boolean)

skratkaPrikazu

public static KeyStroke skratkaPrikazu(String príkaz)

Alias pre skratkaPríkazu.

reťazecSkratkyPríkazu
```
public static String reťazecSkratkyPríkazu(String príkaz)
```
Táto metóda prevedie definíciu klávesovej skratku, ktorá je priradená zadanému príkazu do textovej podoby. Ak taká skratka nejestvuje, tak metóda vráti hodnotu null.

Metóda nedokáže rozlíšiť, či je skratka platná pre hlavné okno a/alebo vstupný riadok, preto ak rozlišujete medzi skratkami definovanými pre vstupný riadok a hlavné okno, tak odporúčame pre nich zvoliť unikátne názvy.

Parametre:

príkaz – príkaz, ktorý by mal byť previazaný s niektorou klávesovou skratkou

Návratová hodnota:

text klávesovej skratky alebo null

Pozri tiež:

pridajKlávesovúSkratku(String, int), pridajKlávesovúSkratku(String, int, int), pridajKlávesovúSkratku(String, int, int, boolean), pridajKlávesovúSkratkuVstupnéhoRiadka(String, int, int), odoberKlávesovúSkratku(String), skratkaPríkazu(String), skratkyStropu(), skratkyStropu(boolean), skratkyPodlahy(), skratkyPodlahy(boolean)

retazecSkratkyPrikazu

public static String retazecSkratkyPrikazu(String príkaz)

Alias pre reťazecSkratkyPríkazu.

skratkyStropu
```
public static void skratkyStropu(boolean zapnúť)
```
Zapne alebo vypne fungovanie niekoľkých predvolených skratiek vnútornej konzoly stropu. Predvolene sú tieto skratky vypnuté. Ide o tieto skratky, z ktorých niektoré sú kombinované s predvoleným modifikátorom skratiek ponuky (Ctrl na Windows, ⌘/Command na macOS; tu označené ako C) a niektoré s modifikátorom Shift (tu označené ako S):
- Kláves.HOME – roluje texty stropu (t. j. jeho konzoly) na začiatok.
- Kláves.END – roluje texty stropu na koniec.
- Kláves.HORE – roluje texty stropu o riadok vyššie.
- Kláves.DOLE – roluje texty stropu o riadok nižšie.
- Kláves.PAGE_UP – roluje texty stropu o stránku vyššie.
- Kláves.PAGE_DOWN – roluje texty stropu o stránku nižšie.
- C + Kláves.VK_A – označí všetky texty konzoly (stropu).
- Kláves.ESCAPE alebo C + S + Kláves.VK_A – zruší označenie textov konzoly.
- C + Kláves.VK_C – skopíruje označené texty do schránky.
Spolu so skratkami je aktivoavané základné ovládanie myšou: kliknutím a ťahaním ľavého tlačidla myši sa dajú označovať texty stropu (v súčasnosti je označovanie implementované len po tzv. blokoch výpisu) a stlačenie pravého tlačidla myši skopíruje texty do schránky a zruší ich označenie (čo je sprevádzané pípnutím). Klasicky je staré označenie pri začatí nového ťahania myšou zrušené, ak je však pri tom držaný kláves Ctrl, nové označenie je pridané k starému.
Parametre:

zapnúť – true, ak majú byť skratky zapnuté, false v opačnom

Pozri tiež:

skratkyStropu(), skratkyPodlahy(), skratkyPodlahy(boolean), pridajKlávesovúSkratku(String, int), pridajKlávesovúSkratku(String, int, int), pridajKlávesovúSkratku(String, int, int, boolean), pridajKlávesovúSkratkuVstupnéhoRiadka(String, int, int), odoberKlávesovúSkratku(String), skratkaPríkazu(String)

skratkyStropu
```
public static boolean skratkyStropu()
```
Overí, či sú zapnuté preddefinované skratky stropu. Viac detailov je v opise metódy skratkyStropu(zapnúť).

Návratová hodnota:

true, ak sú skratky zapnuté, false v opačnom prípade

Pozri tiež:

skratkyStropu(boolean), skratkyPodlahy(), skratkyPodlahy(boolean), pridajKlávesovúSkratku(String, int), pridajKlávesovúSkratku(String, int, int), pridajKlávesovúSkratku(String, int, int, boolean), pridajKlávesovúSkratkuVstupnéhoRiadka(String, int, int), odoberKlávesovúSkratku(String), skratkaPríkazu(String)

skratkyPodlahy
```
public static void skratkyPodlahy(boolean zapnúť)
```
Zapne alebo vypne fungovanie niekoľkých predvolených skratiek vnútornej konzoly podlahy. Predvolene sú tieto skratky vypnuté. Ide o rovnaké skratky ako v prípade stropu – pozri metódu skratkyStropu.

Parametre:

zapnúť – true, ak majú byť skratky zapnuté, false v opačnom

Pozri tiež:

skratkyPodlahy(), skratkyStropu(), skratkyStropu(boolean)

skratkyPodlahy
```
public static boolean skratkyPodlahy()
```
Overí, či sú zapnuté preddefinované skratky podlahy. Viac detailov je v opise metódy skratkyPodlahy(zapnúť).

Návratová hodnota:

true, ak sú skratky zapnuté, false v opačnom prípade

Pozri tiež:

skratkyPodlahy(boolean), skratkyStropu(), skratkyStropu(boolean)

máVlnenie
```
public static boolean máVlnenie()
```
Overí, či má svet definovanú inštanciu vlnenia.

Návratová hodnota:

true ak je inštancia vlnenia definovaná; false v opačnom prípade

Pozri tiež:

vlnenie(), jestvujúceVlnenie(), pridajVlnenie(), pridajVlnenie(boolean), pridajVlnenie(int), pridajVlnenie(int, boolean), odstráňVlnenie()

maVlnenie
```
public static boolean maVlnenie()
```
Alias pre máVlnenie.

vlnenie
```
public static Vlnenie vlnenie()
```
Vráti inštanciu vlnenia sveta, aby s ňou bolo možné ďalej pracovať. Ak svet nemá definované vlnenie, tak metóda definuje nové neaktívne vlnenie s predvolenou úrovňou útlmu 26. (Overiť to, či je definovaná inštancia vlnenia, je možné pomocou metódy máVlnenie.) Naopak, metóda jestvujúceVlnenie vráti inštanciu vlnenia len v takom prípade, že jestvuje. (V opačnom prípade vráti metóda jestvujúceVlnenie hodnotu null.)

Poznámka: Aby mohlo byť vlnenie automaticky vykonávané, tak v prípade vytvorenia novej inštancie ju táto metóda automaticky registruje v prostredí grafického robota.

Upozornenie: Ak svet grafického robota nemá aktívny časovač, tak vlnenie nebude fungovať ani po jeho aktivácii. Táto metóda nespúšťa časovač (ani vlnenie) automaticky! Účelom automatického vytvorenia inštancie vlnenia touto metódou v prípade jej neprítomnosti je len zabránenie vzniku chýb. Táto metóda nemá nahradiť metódu pridajVlnenie.

Návratová hodnota:

metóda zaručuje vrátenie inštancie Vlnenie definovanej pre svet aj v takom prípade, že pred jej volaním nebola inštancia definovaná

Pozri tiež:

máVlnenie(), jestvujúceVlnenie(), pridajVlnenie(), pridajVlnenie(boolean), pridajVlnenie(int), pridajVlnenie(int, boolean), odstráňVlnenie()

jestvujúceVlnenie
```
public static Vlnenie jestvujúceVlnenie()
```
Táto metóda vráti inštanciu vlnenia len v prípade, že jestvuje. V opačnom prípade vráti hodnotu null, čo môže viesť ku vzniku výnimky, ak sa programátor pokúsi použiť vrátenú hodnotu bez overenia. Naopak, vrátenie inštancie vlnenia aj v prípade, že ešte nebolo definované zaručuje metóda vlnenie.

Návratová hodnota:

ak je definovaná inštancia vlnenia, tak ju metóda vráti; v opačnom prípade vráti hodnotu null

Pozri tiež:

máVlnenie(), vlnenie(), pridajVlnenie(), pridajVlnenie(boolean), pridajVlnenie(int), pridajVlnenie(int, boolean), odstráňVlnenie()

jestvujuceVlnenie

public static Vlnenie jestvujuceVlnenie()

Alias pre jestvujúceVlnenie.

existujúceVlnenie

public static Vlnenie existujúceVlnenie()

Alias pre jestvujúceVlnenie.

existujuceVlnenie

public static Vlnenie existujuceVlnenie()

Alias pre jestvujúceVlnenie.

definovanéVlnenie

public static Vlnenie definovanéVlnenie()

Alias pre jestvujúceVlnenie.

definovaneVlnenie

public static Vlnenie definovaneVlnenie()

Alias pre jestvujúceVlnenie.

pridajVlnenie
```
public static void pridajVlnenie()
```
Pridá alebo zresetuje vlnenie sveta. Ak svet nemá definované alebo aktívne vlnenie, tak volanie tejto metódy vytvorí a/alebo aktivuje novú inštanciu vlnenia s predvolenou úrovňou útlmu 26.

Poznámka: Aby mohlo byť vlnenie automaticky vykonávané, tak v prípade vytvorenia novej inštancie ju táto metóda automaticky registruje v prostredí grafického robota.

Ak by svet grafického robota nemal aktívny časovač, tak by vlnenie nemohlo fungovať, preto je časovač touto metódou spúšťaný automaticky.

Inštanciu vlnenia je možné získať a pracovať s ňou pomocou metódy vlnenie alebo jestvujúceVlnenie.

Pozor! Ak vlnenie nie je definované, tak metóda vlnenie definuje nové neaktívne vlnenie s predvolenou úrovňou útlmu 26. Overiť to, či je definovaná inštancia vlnenia, je možné pomocou metódy máVlnenie. Metóda jestvujúceVlnenie vráti inštanciu vlnenia len v prípade, že jestvuje. V opačnom prípade vráti hodnotu null, čo môže viesť ku vzniku výnimky, ak sa programátor pokúsi použiť vrátenú hodnotu bez overenia.

Ak už je definovaná inštancia vlnenia, tak ju volanie tejto metódy zresetuje upokojením hladiny a nastavením predvolenej úrovne útlmu 26. (Aktivácia je vykonaná v každom prípade.)

Pozri tiež:

máVlnenie(), vlnenie(), jestvujúceVlnenie(), pridajVlnenie(boolean), pridajVlnenie(int), pridajVlnenie(int, boolean), odstráňVlnenie()

pridajVlnenie
```
public static void pridajVlnenie(boolean ajČasovač)
```
Pridá alebo zresetuje vlnenie sveta. Ak svet nemá definované alebo aktívne vlnenie, tak volanie tejto metódy vytvorí a/alebo aktivuje novú inštanciu vlnenia s predvolenou úrovňou útlmu 26.

Poznámka: Aby mohlo byť vlnenie automaticky vykonávané, tak v prípade vytvorenia novej inštancie ju táto metóda automaticky registruje v prostredí grafického robota.

Pozor! Ak svet grafického robota nemá aktívny časovač, tak vlnenie nebude fungovať. Táto metóda dovoľuje určiť, či má alebo nemá byť časovač spustený automaticky. Umožňuje to parameter ajČasovač.

Inštanciu vlnenia je možné získať a pracovať s ňou pomocou metódy vlnenie alebo jestvujúceVlnenie.

Pozor! Ak vlnenie nie je definované, tak metóda vlnenie definuje nové neaktívne vlnenie s predvolenou úrovňou útlmu 26. Overiť to, či je definovaná inštancia vlnenia, je možné pomocou metódy máVlnenie. Metóda jestvujúceVlnenie vráti inštanciu vlnenia len v prípade, že jestvuje. V opačnom prípade vráti hodnotu null, čo môže viesť ku vzniku výnimky, ak sa programátor pokúsi použiť vrátenú hodnotu bez overenia.

Ak už je definovaná inštancia vlnenia, tak ju volanie tejto metódy zresetuje upokojením hladiny a nastavením predvolenej úrovne útlmu 26. (Aktivácia je vykonaná v každom prípade.)

Parametre:

ajČasovač – ak je hodnota tohto parametra rovná true, tak je v prípade jeho nečinnosti automaticky spustený časovač

Pozri tiež:

máVlnenie(), vlnenie(), jestvujúceVlnenie(), pridajVlnenie(), pridajVlnenie(int), pridajVlnenie(int, boolean), odstráňVlnenie()

pridajVlnenie
```
public static void pridajVlnenie(int útlm)
```
Pridá alebo zresetuje vlnenie sveta. Ak svet nemá definované alebo aktívne vlnenie, tak volanie tejto metódy vytvorí a/alebo aktivuje novú inštanciu vlnenia so zadanou úrovňou útlmu (pozri aj Vlnenie.útlm(útlm)).

Poznámka: Aby mohlo byť vlnenie automaticky vykonávané, tak v prípade vytvorenia novej inštancie ju táto metóda automaticky registruje v prostredí grafického robota.

Ak by svet grafického robota nemal aktívny časovač, tak by vlnenie nemohlo fungovať, preto je časovač touto metódou spúšťaný automaticky.

Inštanciu vlnenia je možné získať a pracovať s ňou pomocou metódy vlnenie alebo jestvujúceVlnenie.

Pozor! Ak vlnenie nie je definované, tak metóda vlnenie definuje nové neaktívne vlnenie s predvolenou úrovňou útlmu 26. Overiť to, či je definovaná inštancia vlnenia, je možné pomocou metódy máVlnenie. Metóda jestvujúceVlnenie vráti inštanciu vlnenia len v prípade, že jestvuje. V opačnom prípade vráti hodnotu null, čo môže viesť ku vzniku výnimky, ak sa programátor pokúsi použiť vrátenú hodnotu bez overenia.

Ak už je definovaná inštancia vlnenia, tak ju volanie tejto metódy zresetuje upokojením hladiny a nastavením zadanej úrovne útlmu. (Aktivácia je vykonaná v každom prípade.)

Parametre:

útlm – požadovaná úroveň útlmu vlnenia; odporúčané sú hodnoty v rozmedzí 0 – 30; pozri aj Vlnenie.útlm(útlm)

Pozri tiež:

máVlnenie(), vlnenie(), jestvujúceVlnenie(), pridajVlnenie(), pridajVlnenie(boolean), pridajVlnenie(int, boolean), odstráňVlnenie(), Vlnenie.útlm(int)

pridajVlnenie
```
public static void pridajVlnenie(int útlm,
                                 boolean ajČasovač)
```
Pridá alebo zresetuje vlnenie sveta. Ak svet nemá definované alebo aktívne vlnenie, tak volanie tejto metódy vytvorí a/alebo aktivuje novú inštanciu vlnenia so zadanou úrovňou útlmu (pozri aj Vlnenie.útlm(útlm))

Poznámka: Aby mohlo byť vlnenie automaticky vykonávané, tak v prípade vytvorenia novej inštancie ju táto metóda automaticky registruje v prostredí grafického robota.

Pozor! Ak svet grafického robota nemá aktívny časovač, tak vlnenie nebude fungovať. Táto metóda dovoľuje určiť, či má alebo nemá byť časovač spustený automaticky. Umožňuje to parameter ajČasovač.

Inštanciu vlnenia je možné získať a pracovať s ňou pomocou metódy vlnenie alebo jestvujúceVlnenie.

Pozor! Ak vlnenie nie je definované, tak metóda vlnenie definuje nové neaktívne vlnenie s predvolenou úrovňou útlmu 26. Overiť to, či je definovaná inštancia vlnenia, je možné pomocou metódy máVlnenie. Metóda jestvujúceVlnenie vráti inštanciu vlnenia len v prípade, že jestvuje. V opačnom prípade vráti hodnotu null, čo môže viesť ku vzniku výnimky, ak sa programátor pokúsi použiť vrátenú hodnotu bez overenia.

Ak už je definovaná inštancia vlnenia, tak ju volanie tejto metódy zresetuje upokojením hladiny a nastavením zadanej úrovne útlmu. (Aktivácia je vykonaná v každom prípade.)

Parametre:

útlm – požadovaná úroveň útlmu vlnenia; odporúčané sú hodnoty v rozmedzí 0 – 30; pozri aj Vlnenie.útlm(útlm)

ajČasovač – ak je hodnota tohto parametra rovná true, tak je v prípade jeho nečinnosti automaticky spustený časovač

Pozri tiež:

máVlnenie(), vlnenie(), jestvujúceVlnenie(), pridajVlnenie(), pridajVlnenie(boolean), pridajVlnenie(int), odstráňVlnenie(), Vlnenie.útlm(int)

odstráňVlnenie
```
public static void odstráňVlnenie()
```
Ukončí vlnenie sveta a úplne odstráni inštanciu vlnenia, ktorá bola pre neho definovaná z prostredia programovacieho rámca GRobot.

Pozri tiež:

máVlnenie(), vlnenie(), jestvujúceVlnenie(), pridajVlnenie(), pridajVlnenie(boolean), pridajVlnenie(int), pridajVlnenie(int, boolean)

odstranVlnenie
```
public static void odstranVlnenie()
```
Alias pre odstráňVlnenie.

osvetlenie
```
public static Obrazok osvetlenie()
```
Overí, či má svet aktívne osvetlenie. Ak je osvetlenie aktívne, tak metóda vráti inštanciu obrázka, ktorý je vnútorne používaný ako mapa osvetlenia – pozri aj opis metód osvetlenie a Obrázok.svetlo(…), inak vráti null.

Návratová hodnota:

inštancia obrázka používaného ako svetelná mapa alebo null

osvetlenie
```
public static Obrazok osvetlenie(boolean osvetli)
```
Zapne alebo vypne osvetlenie sveta. Pri zmene stavu: Ak je osvetlenie aktivované, tak sú vytvorené potrebné inštancie a zároveň táto metóda vráti inštanciu obrázka, ktorý bude vnútorne používaný ako mapa osvetlenia – pozri aj opis metódy Obrázok.svetlo(…). Ak je osvetlenie deaktivované alebo jeho aktivácia zlyhá, tak metóda vráti null.

Parametre:

osvetli – ak je true tak má byť osvetlenie aktivované, ak je false tak má byť osvetlenie deaktivované

Návratová hodnota:

inštancia obrázka používaného ako svetelná mapa alebo null


Niekoľko obrázkov zobrazujúcich priebeh zapĺňania plátna bodmi počas vykonávania tohto príkladu.

1	C	4	E♭/D♯	7	F♯/G♭	10	A
2	C♯/D♭	5	E	8	G	11	B♭/H♭/A♯
3	D	6	F	9	A♭/G♯	12	B/H


Charakteristické situácie vzájomných polôh úsečiek a spôsob merania vzdialenosti úsečiek v nich.

Trieda Svet

Prehľad vnorených tried

Vnorené triedy/rozhrania odvodené od triedy javax.swing.JFrame

Vnorené triedy/rozhrania odvodené od triedy java.awt.Frame

Vnorené triedy/rozhrania odvodené od triedy java.awt.Window

Vnorené triedy/rozhrania odvodené od triedy java.awt.Container

Vnorené triedy/rozhrania odvodené od triedy java.awt.Component

Prehľad atribútov

Atribúty zdedené z triedy javax.swing.JFrame

Atribúty zdedené z triedy java.awt.Frame

Atribúty zdedené z triedy java.awt.Component

Atribúty zdedené z rozhrania javax.swing.WindowConstants

Atribúty zdedené z rozhrania java.awt.image.ImageObserver

Prehľad metód

Metódy zdedené z triedy javax.swing.JFrame

Metódy zdedené z triedy java.awt.Frame

Metódy zdedené z triedy java.awt.Window

Metódy zdedené z triedy java.awt.Container

Metódy zdedené z triedy java.awt.Component

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

Metódy zdedené z rozhrania java.awt.MenuContainer

Podrobnosti atribútov

zmenaLAF

ukladajStavOknaNaVrchu

formát

format

svgExport

príkazovýRiadok

prikazovyRiadok

zmenaCelejObrazovky

Podrobnosti metód

zavrieť

zavriet

verzia

hlavnýRobot

hlavnyRobot

vyzviRoboty

vyzviRobotov

vyzviRoboty

vyzviRobotov

vyzviRoboty

vyzviRobotov

najmenšieX

najmensieX

minimálneX

minimalneX

najmenšieY

najmensieY

minimálneY

minimalneY

najväčšieX

najvacsieX

maximálneX

maximalneX

najväčšieY

najvacsieY

maximálneY

maximalneY

šírka

sirka

výška

vyska

viditeľnáŠírka

viditelnaSirka

viditeľnáVýška

viditelnaVyska

šírkaOkna

sirkaOkna

výškaOkna

vyskaOkna

titulok

titulok

ľavýOkraj

lavyOkraj

spodnýOkraj

spodnyOkraj

dolnýOkraj

dolnyOkraj

pravýOkraj

pravyOkraj