České vysoké učení technické v Praze Fakulta elektrotechnická Uživatelská příručka Prezentační applet Bc. Břach Jakub prosinec 2007
1 Uživatelská příručka 1.1 Funkce ukázkového editoru Applet, který představuje jednoduchý vektorový grafický editor, slouží především k tomu, aby ukázal možnosti a způsob použití grafické knihovny BPSGraphics2D pro převod grafických objektů z programovacího jazyka Java do postscriptového dokumentu. Označení ukázkového editoru je prezentační applet. Vytvořený obrázek je možné uložit i v běžných rastrových formátech (PNG, JPG, BMP a GIF). Nejdůležitějším je samozřejmě vektorový formát EPS. 1.2 Adresa prezentačního appletu Applet v podobě jednoduchého vektorového editoru je k dispozici na adresách: http://www.volny.cz/jakubbrach/applet/appletcz.htm http://www.volny.cz/jakubbrach/applet/appleten.htm Grafická knihovna BPSGraphics2D je dále k dispozici na adrese: http://www.volny.cz/jakubbrach/library/library.htm Technické potíže můžete řešit na e-mailové adrese brachj@seznam.cz nebo na mobilním telefoním čísle +420 777 877 530. 1.3 Lokalizace Applet je k dispozici jak v českém, tak anglickém jazyce. V případě většího zájmu není problém jej lokalizovat do dalšího jazyka. 1.4 Změny a aktualizace Tato uživateslká příručka popisuje stav appletu na konci prosince roku 2007. Autor appletu si vyhrazuje právo změn oproti stavu popsaném v této příručce. Aktuální verzi naleznete na adrese uvedené v kapitole 1.2. 1.5 Systémové požadavky Pro spuštění appletu je potřeba mít přístup do celosvětové sítě Internet a nainstalovaný plug-in Java Runtime (JRE či JDK) verze 1.6.0 nebo vyšší. Pokud máte tento modul nainstalovaný, tak je možné applet spouštět jak v Internet Exploreru, který je součástí každé instalace operačního systému Windows, tak i v prohližeči Mozzila Firefox nebo Opera. Applet je optimalizován pro rozlišení 1024 768. 2
1.6 Popis uživatelského rozhraní prezentačního appletu 1.6.1 Spuštění appletu Po spuštění appletu se v uživatelově prohlížeči zobrazí dialog, který obsahuje informaci, že applet je bezpečný pro podepsaného a uživateli dává možnost jej označit jako důvěryhodného. Pokud uživatel souhlasí s důvěryhodností podepsaného, tak může provádě operace se soubory, jako například načítání obrázků pro vykreslování a ukládání již nakreslených na pevný, případně jiný disk. Pokud s důvěryhodností uživatel nesouhlasí, tak výše uvedené akce nebude moci provádět. 1.6.2 Hlavní obrazovka Hlavní obrazovka prezentačního appletu (viz obr. 1.1) je rozdělena do pěti částí: (1) oblast v levém horním rohu slouží pro výběr nástrojů a pro možnost změny stylu právě kreslených grafických objektů. Tlačítka pro výběr nástrojů zůstavají po jejich zvolení stisknuta. (2) oblast v levém spodním rohu slouží pro rychlou navigaci mezi již vykreslenými objekty, přístup k jednotlivým objektům je realizován pomocí stromu. Pokud uživatel na některou položku v této oblasti klikne, tak je příslušný grafický objekt vybrán a jsou zobrazeny jeho citlivé body. Dále dojde k zobrazení příslušného panelu a zdrojového textu v oblastech (4) a (5). Prostřednictvím tohoto stromu je možné přistupovat i k nastavení parametrů pozadí grafické oblasti. (3) oblast uprostřed grafického rozhraní slouží pro vlastní vykreslování grafickýho objektů. (4) oblast v pravém horním rohu slouží pro zobrazení zdrojového kódu, prostřednictvím nějž je možné právě kreslený objekt vytvořit v programovacím jazyce Java. (5) oblast v pravém dolním rohu slouží pro modifikaci klíčových bodů a dalších parametrů právě kresleného objektu nebo k modifikaci parametrů popředí a pozadí. 1.6.3 Menu V horní části grafického rozhraní je menu (viz obr. 1.1), které slouží pro výběr funkcí, které prezentační applet nabízí. Na obrázku 1.2 jsou zobrazeny jeho položky. Po výběru libovolné položky je zpřístupněna nabídka, pomocí níž je možné provádět příslušné operace nebo vstupovat do dalších nabídek. Jednotlivé položky jsou následující a umožňují: Soubor vytvoření nové kreslící plochy nebo uložení aktuální. Úpravy přístup k operacím, kterými lze modifikovat právě vykreslovaný objekt nebo jej například vymazat či kopírovat. Dále je možné provádět operaci zpět nebo znovu (známé též jako Undo a Redo) a přesouvat grafické objekty mezi úrovněmi (používá se pro ovlivnění vzájemného překrývaní grafických objektů). Nástroje výběr grafického nástroje, který určuje typ příštího vykreslovaného grafického objektu. Styl zobrazení nabídky pro změnu barvy, parametrů fontu a čáry. Obrázek načítání obrázků pro vykreslování a nebo výběr z již načtených. Lupa přiblížení nebo oddálení kreslící oblasti. 3
Obrázek 1.1: Obrazovka appletu Obrázek 1.2: Menu pro výběr operací Nápověda zobrazení informací o aplikaci a odkazu na manuál. V dalších kapitolách je podrobněji popsán obsah všech výše uvedených položek. Některé položky jsou přístupné prostřednictvím klávesových zkratek. U příslušných položek jsou klávesové zkratky zobrazeny. Soubor Položky obsažené v nabídce Soubor jsou následující a umožňují (viz obr. 1.3): Nový vytvoření nové kreslící plochy (viz kap. 1.6.4 a obr. 1.11). Překreslení překreslení, chcete-li refresh, aktuální kreslící oblasti. Ulož uložení vytvořeného obrázku. Export výstup v podobě zdrojového kódu appletu v jazyce Java. Po přeložení v programu javac (překladač Javy) a následném spuštění zobrazuje applet to, co bylo v době vytvoření tohoto výstupu zobrazeno v kreslící oblasti appletu. Tato možnost slouží pro srovnání zdrojového kódu Java a výstupu v PostScriptu (soubor formátu EPS). Prostřednictvím této položky je dále možné vytvořit výstup v podobě zdrojového kódu v jazyce Java, který obsahuje příklad použití grafické 4
knihovny BPSGraphics2D. Po jeho přeložení a následném spuštění je do konzole zobrazen postscriptový dokument. Dokument obsahuje všechny grafické objekty, které byly v době vytvoření tohoto typu výstupu zobrazeny v kreslící oblasti appletu. Před uložením zdrojového kódu, který obsahuje příklad použití grafické knihovny, je možné zvolit si barevné provedení dokumentu (RGB, šedá škála, černobílý). Tisk vytisknutí obsahu kreslící oblasti na formát papíru A4. Obrázek 1.3: Položka v menu Soubor Úpravy Položky obsažené v nabídce Úpravy jsou následující a umožňují (viz obr. 1.4): Zpět odstranění posledního nakresleného nebo modifikovaného grafického objektu. Znovu obnovení odstraněného grafického objektu. Vybrat aktivaci nástroje pro výběr grafického objektu. Kopírovat uložení vybraného grafického objektu do pamět ového bufferu. Vložit aktivaci nástroje pro vložení grafického objektu uloženého v pamět ovém bufferu. Po kliknutí do grafické oblasti je na místo kurzoru grafický objekt vložen. Smazat aktivaci nástroje pro smazání grafického objektu. Smazat výběr smazání vybraného grafického objektu. PostScriptový výstup zobrazení dialogového okna, které obsahuje výstup v podobě postscriptových příkazů. Tyto postscriptové příkazy představují postscriptový dokument. Takto získaný postscriptový dokument osahuje právě vykreslovaný grafický objekt (viz kap. 1.6.4). K zobrazení dochází pouze tehdy, pokud je některý grafický objekt vybrán. Změna zdrojového kódu zobrazení dialogového okna (viz obr. 1.12), ve kterém je možné editovat hodnoty zdrojového kódu. Zdrojový kód je zobrazen v oblasti (4) hlavní obrazovky appletu (viz obr. 1.1) Nástroje Položky obsažené v nabídce Nástroje jsou následující a umožňují (viz obr. 1.5): Úsečka nastavení aktuálního nástroje na kreslení úsečky, Obdélník nastavení aktuálního nástroje na kreslení obdélníku, Zaoblený obdélník nastavení aktuálního nástroje na kreslení zaobleného obdélníku, 5
Obrázek 1.4: Položka v menu Úpravy Trojúhelník nastavení aktuálního nástroje na kreslení trojúhelníku, Kružnice nastavení aktuálního nástroje na kreslení kružnice, Elipsa nastavení aktuálního nástroje na kreslení elipsy, Oblouk nastavení aktuálního nástroje na kreslení oblouku, Beziérova křivka nastavení aktuálního nástroje na kreslení Beziérovy křivky, Text nastavení aktuálního nástroje na kreslení textu, Obrázek nastavení aktuálního nástroje na kreslení obrázku. Pro rychlejší způsob nastavení jednotlivých nástrojů je možné použít klávesy F1 F10. Obrázek 1.5: Položka v menu Nástroje Styl Prostřednictvím nabídky Styl je možné měnit různé parametry, které mají vliv na výsledný vzhled grafických objektů. Položky v této nabídce jsou následující a umožňují (viz obr. 1.6): Vyplnit nastavení parametru na jehož základě jsou kresleny obrysy grafického objektu nebo je grafický objekt vyplněn. Vybrat barvu zobrazení dialogu pro výběr barvy, která je použita pro vykreslení grafického objektu. Vzhled dialogového okna je zobrazen na obrázku 1.13 a popis uveden v kapitole 1.6.4. 6
Barva přístup do další nabídky, která obsahuje přednastavené barvy. Vybraná barva je použita pro vykreslení grafického objektu. Barva pozadí přístup do nabídky, která obsahuje přednastavené barvy použitelné pro změnu pozadí. Součástí této nabídky je i položka, po jejímž vybrání je zobrazeno dialogové okno. Pomocí tohoto dialogu je možné vybrat další barvy pro změnu pozadí. Pořadí zobrazení nabídky, která umožňuje přenést grafický objekt do popředí, pozadí nebo na původní pozici ve vykreslovací oblasti. Pero zobrazení dialogu pro nastavení parametrů čáry, která je použita pro vykreslení obrysů grafického objektu. Vzhled dialogového okna je zobrazen na obrázku 1.14 a popis uveden v kapitole 1.6.4. Font zobrazení dialogu pro nastavení parametrů fontu, který je použit pro zobrazení textových řetězců. Vzhled okna je zobrazen na obrázku 1.17 a jeho popis uveden v kapitole 1.6.4. Obrázek 1.6: Položka v menu Styl Obrázek Nabídka Obrázek slouží pro načítání a vybírání obrázků, které jsou použity po aktivaci nástroje Obrázek (viz obr. 1.5). Položky v této nabídce jsou následující a umožňují (viz obr. 1.7): Načti zobrazení dialogového okna, které slouží k načtení obrázku. Po aktivaci nástroje Obrázek (viz kap. 1.6.3) je při vykreslování použit poslední načtený obrázek. Vyber zobrazení dialogového okna, které slouží pro výběr z již načtených obrázků. Vzhled tohoto dialogového okna je k dispozici na obrázku 1.18 a jeho popis uveden v kapitole 1.6.4. Vybraný obrázek je použit pro kreslení v kombinaci s nástrojem Obrázek (viz obr. 1.5). Původní rozměry nastavení původních rozměrů obrázku s nulovým úhlem rotace. Interpolace v PostScriptu zobrazení dialogového okna, které slouží pro nastavení typu interpolace obrazu používané při změně rozměrů obrázku. Vzhled tohoto dialogového okna je k dispozici na obrázku 1.19 a jeho popis uveden v kapitole 1.6.4. Typ interpolace má vliv na vzhled obrázku, který je součástí výstupního souboru formátu EPS. Lupa Nabídka Lupa slouží pro přiblížení a oddálení grafické oblasti (viz obr. 1.8). Je možné vybrat si z několika přednastavených variant, které způsobí zvětšení nebo zmenšení grafické oblasti. 7
Obrázek 1.7: Položka v menu Obrázek Obrázek 1.8: Položka v menu Lupa Nápověda Nabídka Nápověda slouží pro zobrazení různých dialogových oken. Položky v této nabídce jsou následující a umožňují (viz obr. 1.9): Obsah nápovědy zobrazení dialogu, který obsahuje emailovou adresu na autora a odkaz na uživatelskou příručku k appletu. Vzhled tohoto dialogu je zobrazen na obrázku 1.20 a popis uveden v kapitole 1.6.4. Testeři zobrazení dialogu, který obsahuje seznam lidí, kteří se podíleli na testování appletu. Vzhled tohoto dialogu je zobrazen na obrázku 1.21 a popis uveden v kapitole 1.6.4. O programu zobrazení dialogu, který obsahuje základní údaje o appletu. Vzhled tohoto dialogu je zobrazen na obrázku 1.22 a popis uveden v kapitole 1.6.4. Obrázek 1.9: Položka v menu Nápověda Pořadí Nabídka Pořadí slouží pro přesun právě kresleného grafického objektu mezi vrstvami kreslícího plátna, které je umístěno v oblasti (4) hlavní obrazovky appletu (viz obr. 1.1). Jednotlivými vrstvami chápejme každý grafický objekt, který je obsažen v kreslící oblasti. Přesun mezi vrstvami spočívá v prohazování pořadí, ve kterém jsou grafické objekty postupně vykreslovány. Nabídka Pořadí je dostupná prostřednictvím položky Styl v menu (viz obr. 1.2). Položky v této nabídce jsou následující a umožňují (viz obr. 1.10): 8
Dopředu posunutí grafického objektu na nejvyšší úroveň grafické oblasti. Tj. jakoby překrýval ostatní. Dopředu o jednu úroveň posunutí grafického objektu o jednu úroveň směrem k pozorovateli. Původní úroveň posunutí grafického objektu na původní úroveň. Tato nabídka funguje pouze tehdy, pokud již u právě vybraného grafického objektu došlo k přesunům mezi vrstvami. Dozadu o jednu úroveň posunutí grafického objektu o jednu úroveň směrem od pozorovatele. Dozadu posunutí grafického objektu na nejnižší úroveň. Obrázek 1.10: Podpoložka v menu Pořadí 1.6.4 Dialogová okna Tato kapitola popisuje některá dialogová okna, se kterými se uživatel může v appletu setkat. Nový soubor Prostřednictvím dialogového okna Nový soubor (viz obr. 1.11) může uživatel vytvořit novou kreslící oblast s vlastními specifikovanými rozměry a nebo využít přednastavených formátů A4 nebo B5. Dialogové okno je zobrazeno pomocí položky Nový v nabídce Soubor (viz obr. 1.3 a 1.2). Obrázek 1.11: Dialogové okno pro vytvoření nové kreslící oblasti 9
Změna zdrojového kódu Prostřednictvím dialogového okna Modifikace hodnot ve zdrojovém kódu (viz obr. 1.17) může uživatel měnit hodnoty ve zdrojovém kódu jazyka Java. Po modifikaci hodnot je možné provést test pomocí tlačítka Test. Pokud jsou hodnoty nastaveny dobře, je zobrazeno dialogové okno s informací o správném vstupu. V opačném případě je zobrazeno dialogové okno s chybovou hláškou. Pomocí tlačítka Obnovit se do dialogového okna vloží původní nezměněný zdrojový kód. Po stisku tlačítka Potvrzení jsou v případě správně vložených hodnot provedeny změny ve vykreslovací oblasti (3) (viz obr. 1.1). Dialogové okno je zobrazeno pomocí položky Změna zdrojového kódu v nabídce Úpravy (viz obr. 1.4 a 1.2) a nebo pomocí dvoukliku v oblasti (4) (viz obr. 1.1). Obrázek 1.12: Dialogové okno pro editaci zdrojového kódu Výběr barvy Prostřednictvím dialogového okna Výb r barvy (viz obr. 1.13) může uživatel zvolit barvu, která je použita při vykreslování grafických objektů do kreslící oblasti. Uživatel může zvolit některou z přednastavených barev v první záložce a nebo ji určit pomocí jednotlivých složek barevných modelů RGB nebo HSB. Dialogové okno je zobrazeno pomocí položky Výběr barvy v nabídce Styl (viz obr. 1.6 a 1.2). Toto nastavení je přístupné i z panelu stylů v oblasti (1) (viz obr. 1.1). Změna vlastností čáry Prostřednictvím dialogového okna Výb r pera (viz obr. 1.14) může uživatel nastavit vlastnosti čáry, která bude použita při vykreslování grafických objektů do kreslící oblasti. Parametr MiterLimit určuje 10
Obrázek 1.13: Dialogové okno pro výběr barvy mezní hodnotu pro zkosení. Jako standartní hodnota se doporučuje číslo 10. Dialogové okno je zobrazeno pomocí položky Pero v nabídce Styl (viz obr. 1.6 a 1.2). Toto nastavení je přístupné i z panelu stylů v oblasti (1) (viz obr. 1.1). Obrázek 1.14: Dialogové okno pro výběr vlastností čáry Uživatel může zvolit šířku čáry a určit délku mezery pro přerušovaný typ čáry. Dále může zvolit typ zakončení čáry a typ spojení dvou různých čar. Typy spojení čar se označují pomocí konstant JOIN_BEVEL, JOIN_MITER a JOIN_ROUND. Na obrázku 1.15 jsou zobrazeny jednotlivé konstanty používané pro nastavení a vzhled daného spojení. V případě umístění kurzoru myši nad některou konstantu je zobrazen popisek obsahující její vysvělení. Typy zakončení čar se označují pomocí konstant CAP_BUTT, CAP_ROUND a CAP_SQUARE. Na obrázku 1.16 jsou zobrazeny jednotlivé konstanty používané pro nastavení a vzhled daného zakončení. Konstanta CAP_SQUARE určuje prodloužení čáry o polovinu její šířky na obou koncích. Podobně je tomu u konstanty CAP_ROUND. V případě umístění kurzoru myši nad některou konstantu je zobrazen popisek obsahující její vysvělení. 11
Obrázek 1.15: Typy spojení čar a příslušné konstanty nastavení Obrázek 1.16: Typy zakončení čar a příslušné konstanty nastavení Výběr fontu Prostřednictvím dialogového okna Výb r fontu (viz obr. 1.17) může uživatel nastavit velikost a typ fontu. Seznam dostupných fontů je zjišt ován ze systémových informací. I přesto může dojít ke špatnému zobrazení některého fontu. Dále je možné zvolit styl fontu pomocí konstant PLAIN, BOLD a ITALIC známé též jako normální, tučný a kurzíva. Dialogové okno je zobrazeno pomocí položky Font v nabídce Styl (viz obr. 1.6 a 1.2). Toto nastavení je přístupné i z panelu stylů v oblasti (1) (viz obr. 1.1). Obrázek 1.17: Dialogové okno pro výběr fontu a jeho vlastností Vybrat obrázek Prostřednictvím dialogového okna Vybrat obrázek (obr. 1.18) se uživatel dostane k seznamu již načtených obrázků a může si vybrat ten, který bude přednastaven pro nástroj Obrázek (viz 1.6.3). Dialogové okno je zobrazeno pomocí položky Vyber v nabídce Obrázek (viz obr. 1.7 a 1.2). 12
Obrázek 1.18: Dialogové okno se seznamem dosud načtených obrázků Nastavení interpolace Prostřednictvím dialogového okna Nastavení interpolace (viz obr. 1.19) je možné nastavit typ interpolace, která je používána při změně rozměrů obrázku. Interpolace se liší podle množství bodů nutných pro výpočet barvy bodu nového a mají vliv pouze na obrázky, které budou obsažené ve výstupním postscriptovém dokumentu. Uživatel si může zvolit z hodnot TYPE_NEAREST_NEIGHBOR, TYPE_BILI- NEAR a TYPE_BICUBIC. Tyto hodnoty určují typy interpolací, které jsou dostupné v programovacím jazyce Java. Po použití hodnoty TYPE_NEAREST_NEIGHBOR je získán obrázek s ostrými hranami. V případě ostatních typů jsou ostré hrany v obrázcích rozmázávány, je použit anti-aliasing. Rozdíl mezi jednotlivými typy interpolací je na první pohled zřejmý v případě zvětšování obrázků. Dialogové okno je zobrazeno pomocí položky Interpolace v PostScriptu v nabídce Obrázek (viz obr. 1.7 a 1.2). Obrázek 1.19: Dialogové okno pro změnu interpolace Obsah nápovědy Prostřednictvím dialogového okna Obsah nápov dy (obr. 1.20) je zobrazen odkaz na uživatelskou příručku k appletu a emailová adresa na autora. Na emailovou adresu prosím zasílejte objevené chyby i s výpisem z konzole. Dialogové okno je zobrazeno pomocí položky Obsah nápovědy v nabídce Nápověda (viz obr. 1.9 a 1.2). 13
Obrázek 1.20: Dialogové okno s nápovědou Testeři Prostřednictvím dialogového okna Testeri (obr. 1.21) se uživatel dostane k seznamu lidí, kteří se podíleli na vývoji appletu díky jeho testování. Dialogové okno je zobrazeno pomocí položky Testeři v nabídce Nápověda (viz obr. 1.9 a 1.2). O programu Prostřednictvím dialogového okna O programu (obr. 1.22) se uživatel dostane k základním informacím o appletu. Dialogové okno je zobrazeno pomocí položky O programu v nabídce Nápověda (viz obr. 1.9 a 1.2). PostScriptový výstup Prostřednictvím tohoto dialogového okna (obr. 1.23) si uživatel může prohlédnout zdrojový kód postscriptového dokumentu, který obsahuje pouze právě kreslený objekt. Toto dialogové okno je přístupné vybráním položky PostScriptový výstup v nabídce Úpravy (viz obr. 1.4 a 1.2). 1.6.5 Nastavení parametrů grafických objektů K nastavení parametrů grafických objektů slouží panely, které jsou umístěné v oblasti (5) hlavní obrazovky appletu (viz obr. 1.1). Tyto panely se mění na základě toho, který nástroj je aktivní. Na obrázku 1.24 je panel, který je zobrazen tehdy, pokud je aktivní nástroj Obrázek (viz obr. 1.5). Vstupní hodnoty pro změnu polohy a rozměrů grafických objektů jsou omezeny na základě rozměrů kreslící oblasti (4). Ve stejné oblasti, jako je zobrazován panel pro změnu parametrů grafických objektů, může být zobrazen panel pro změnu aktuálního nastavení popředí nebo pozadí. Mezi parametry pozadí patří barva a 14
Obrázek 1.21: Dialogové okno se seznamem testovacích osob rozměry kreslící oblasti. Pokud dojde ke změně rozměrů kreslící oblasti, tak je vytvořena nová. V panelu popředí je možné měnit barvu a vlastnosti čáry a fontu. V horní části obrázku 1.25 u popisku Barva se vyskytuje rámeček a jeho obsah je vyplněn aktuální barvou používanou pro kreslení grafických objektů. Pokud na tento rámeček uživatel dvakrát klikne, tak se zobrazí dialog pro změnu barvy (viz obrázek 1.26). Obdobný rámeček pro zobrazení a změnu barvy je i v panelu pozadí. 15
Obrázek 1.22: Dialogové okno s informacemi o appletu Obrázek 1.23: Dialogové okno s postscriptovým výstupem 16
Obrázek 1.24: Panel pro nastavení parametrů obrázků Obrázek 1.25: Panel pro nastavení parametrů popředí 17
Obrázek 1.26: Dialog pro změnu barvy popředí 18