# Priročnik za &kgraphviewer;

## Uvod

&kgraphviewer; je &graphviz; ˙ pregledovalnik grafov. Programi, ki jih ustvari &graphviz; so prosta programska oprema za razporeditev grafov. &kgraphviewer; prikaže grafe v modernem, uporabniku prijaznem &GUI; (grafičnem vmesniku). Ima naslednje lastnosti: Tu je posnetek zaslona &kgraphviewer; Glavno okno &kgraphviewer;-ja prikazuje enega od primerov &graphviz;-a

- Povečevanje;

- Nalaganje več grafov v zavihkih hkrati;

- Shranjevanje seznama nedavnih datotek;

- Pogled iz ptičje perspektive na graf;

- Premikanje grafa z miško;

- Tiskanje z vsemi lastnostmi;

- Popolno risanje vseh &graphviz;-ovih primerov grafov;

- Podprte so vse barve in oblike vozlišč in povezav;

- Samodejna izbira ˙-a za usmerjene grafe in &neato;-a za neusmerjene;

- Ročno ali samodejno ponovno nalaganje s potrdilom uporabnika (zunanje) spremenjenih datotek (nastavljivo);

- Na novo odpiranje programa kot novih zavihkov v obstoječem oknu (nastavljivo);

- Sistem pomoči;

- Internacionalizacija.

Načrtovane funkcije so:

- Sčasoma bomo uporabljali knjižnico &qanava;, da podpiramo predstavitev notranjih grafov;

- Shraniti podatke seje o grafih (uporabljen program za razpored, faktor povečave &etc;)

- Integracija v &kate; in &konqueror; (da bo sprememba v &kate;-ovem pogledu na graf ponovno razporedila in naložila datoteko v &kgraphviewer;);

- Meni za odpiranje datoteke v programu &kate; ali za odpiranje dela katepart v oknu &kgraphviewer;;

- Nalaganje velikih grafov (trenutno se pojavijo težave pri približno 1000 vozliščih in obstaja hek, da program prezre vozlišča čez določeno mejo);

- Progresivna podpora vedno večih ˙ lastnosti in vrednosti;

- Postavitev v ozadju (z nitenjem, da ne blokira vmesnika, z vrstico napredka).

Upoštevajte, da ta program vsebuje kodo GPL-jevega orodja &kcachegrind; od Josef Weidendorfer, z njegovim pooblastilom.

Upoštevajte tudi, da je sistem za tiskanja od &calligra;-ve &kexi; aplikacije za podatkovne baze.

Ostala potrebna programska oprema: &kgraphviewer; je program, ki uporablja orodje &graphviz;-a ˙ za razporeditev grafov. Njegove odvisnosti so:

- Knjižnice &Qt; in &kde-frameworks; verzije 5.x;

- &graphviz;-ova orodja kot zunanji programi (testirano z verzijo 2.8);

- Knjižnica &boost; verzije 1.36.

## Uporaba &kgraphviewer;

### Glavno Okno

Glavno okno prikazuje naložene grafe, vsakega v svojem zavihku. Če zaženete &kgraphviewer; brez argumentov, bo glavno okno prazno, kot je prikazano na spodnjem posnetku zaslona. V tem primeru bo orodna vrstica vsebovala le gumbe Odpri... in (prazen) Odpri nedavno. Kliknite na prvega, da odprete standardno pogovorno okno za Odpiranje Datoteke.

Začetno glavno okno pri prvem odpiranju &kgraphviewer;-ja Začetno glavno okno pri prvem odpiranju &kgraphviewer;-ja

Začetno glavno okno pri prvem odpiranju &kgraphviewer;-ja

Potem ko izberete eno od datotek ˙, bo glavno okno izgledalo, kot na spodnjem posnetku zaslona:

Glavno okno &kgraphviewer;-ja z nekaj odprtimi datotekami Glavno okno &kgraphviewer;-ja z nekaj odprtimi datotekami

Glavno okno &kgraphviewer;-ja z nekaj odprtimi datotekami

Kot lahko vidite, če je graf večji od dodeljenega območja, se v enem od kotov prikaže pogled iz ptičje perspektive. S kontekstnim menijem lahko izberete, ali naj se optimalni položaj tega pregleda samodejno izračuna za vas ali pa ga postavite, kamor želite sami.

#### Premikanje Grafa v Oknu

Graf lahko premaknete tako, da:

- Ga kliknete in povlečete;

- Uporabite drsne trakove;

- Pritisnete na tipke s puščicami;

- Kliknete nekam na pogled iz ptičje perspektive;

- Uporabite kolesce miške (gor in dol, če niste spremenili, ter levo in desno, če pritisnete tipko &Alt;);

- ali kliknete in povlečete v pogledu iz ptičje perspektive.

#### Povečevanje

Da povečate, lahko uporabite gumbe iz orodne vrstice in , da povečate in pomanjšate, ali pa držite tipko &Shift; med vrtenjem kolesca miške. Medtem ko povečujete, se bo rdeči pravokotnik v pogledu iz ptičje perspektive, ki označuje prikazano območje, vedno bolj manjšal. Če se bo zmanjšal na manj kot 10 pikslov na krajši strani, bo namesto njega prikazan poln rdeč pravokotnik, da bo ostal viden. To lahko vidite na posnetku zaslona spodaj.

Graf pri največji stopnji povečave Graf pri največji stopnji povečave

Graf pri največji stopnji povečave

Povečevanje je omejeno v obe smeri s faktorjem 10. Spodaj lahko vidite največji faktor pomanjševanja na grafu.

Graf pri največji stopnji pomanjšave Graf pri največji stopnji pomanjšave

Graf pri največji stopnji pomanjšave

#### Obdelava Datotek z Grafi

##### Datoteke spremenjene na Disku

Če je datoteka, ki je trenutno naložena v &kgraphviewer;, spremenjena iz drugega programa, se bo prikazalo naslednje pogovorno okno:

Pogovorno okno za ponovno nalaganje datoteke, ki je bila spremenjena na disku Pogovorno okno za ponovno nalaganje datoteke, ki je bila spremenjena na disku

Pogovorno okno za ponovno nalaganje datoteke, ki je bila spremenjena na disku

Odločite se lahko, ali boste graf ponovno naložili ali boste ignorirali spremembe. &kgraphviewer; lahko prav tako prilagodite, da si bo zapomnil vašo odločitev in naslednjič naredil isto. Če želite kasneje spremeniti svojo odločitev, izberite element menija Nastavitve Konfiguriraj &kgraphviewer;... točko menija. Glejte kgraphviewer-configuration.

##### Datoteke in Okna

Ko odprete datoteko z grafom izven &kgraphviewer;-ja, ⪚ iz brskalnika datotek ali ukazne vrstice, imate na izbiro, da odprete novo okno &kgraphviewer;-ja ali da odprete graf v novem zavihku že odprtega okna. To je narejeno s spodnjim pogovornim oknom.

Pogovorno okno za odpiranje novega okna Pogovorno okno za odpiranje novega okna

Pogovorno okno za odpiranje novega okna

Kot pri prejšnji možnosti, lahko svojo izbiro shranite kot privzeto in jo pozneje spremenite v nastavitvenem pogovornem oknu.

##### Obdelava Seje

Ob zagonu lahko ponovno odprete grafe, ki ste jih imeli odprte nazadnje. Tudi tu lahko shranite svojo izbiro in jo spremenite kasneje.

Pogovorno okno ob zagonu za ponovno nalaganje grafa iz prejšnje seje Pogovorno okno ob zagonu za ponovno nalaganje grafa iz prejšnje seje

Pogovorno okno ob zagonu za ponovno nalaganje grafa iz prejšnje seje

### Tiskanje Grafov

Poskusite gumbe Predogled tiskanja ali Page setup, da raziščete možnosti tiskanja.

Pogovorno okno za postavitev strani Pogovorno okno za postavitev strani

Pogovorno okno za postavitev strani

Možnosti tiskanja lahko nastavite tako, da se bo graf prilegal točno eni strani, kot je prikazano spodaj:

Nastavitve predogleda strani, da se prilega eni strani Nastavitve predogleda strani, da se prilega eni strani

Nastavitve predogleda strani, da se prilega eni strani

Prav tako lahko izberete, kako boste graf razdelili na več strani. Število vodoravnih in navpičnih strani je lahko neodvisno določeno.

Nastavitve predogleda strani, da se graf prilega na več strani in jih zapolni Nastavitve predogleda strani, da se graf prilega na več strani in jih zapolni

Nastavitve predogleda strani, da se graf prilega na več strani in jih zapolni

In nazadnje, ko uporabljate več strani, lahko izberete, da se bo vsak del grafa prilegal svoji strani, kot zgoraj, tako, da ne ohranja razmerja, ali pa da ga ohranja. V zadnjem primeru se strani ne bodo zapolnile.

Velikost strani lahko spremenite z obrobami:

Velikost strani in pogovorno okno za obrobe Velikost strani in pogovorno okno za obrobe

Velikost strani in pogovorno okno za obrobe

Prav tako lahko spremenite vrsto pisave, glave ali noge:

Nastavitve predogleda strani, da se prilega na več strani brez glave in z različno pisavo Nastavitve predogleda strani, da se prilega na več strani brez glave in z različno pisavo

Nastavitve predogleda strani, da se prilega na več strani brez glave in z različno pisavo

### Konfiguriranje &kgraphviewer;

Stran Izgled vam omogoča, da spremenite privzeto barvo ozadja v &kgraphviewer;-ju, če graf nima že svoje barve ozadja.

Stran za spreminjanje izgleda grafa Stran za spreminjanje izgleda grafa

Stran za spreminjanje izgleda grafa

Stran za Razčlenjevanje (parsing) omogoča izbiro zunanjega ukaza ali notranje knjižnice za razčlenjevanje &graphviz;-ovih datotek ˙.

Stran v nastavitvenem oknu za ponovno nalaganje datotek, ki so bile spremenjene na disku Stran v nastavitvenem oknu za ponovno nalaganje datotek, ki so bile spremenjene na disku

Stran v nastavitvenem oknu za ponovno nalaganje datotek, ki so bile spremenjene na disku

Stran za Ponovno nalaganjeomogoča spremembo delovanja &kgraphviewer;-ja, ko neka druga aplikacija spremeni datoteko na disku. Izberete lahko samodejno dejanje (samodejno ponovno naloži ali ignoriraj spremembe) ali pa, da vas program vsakič znova vpraša.

Stran v nastavitvenem oknu za ponovno nalaganje datotek, ki so bile spremenjene na disku Stran v nastavitvenem oknu za ponovno nalaganje datotek, ki so bile spremenjene na disku

Stran v nastavitvenem oknu za ponovno nalaganje datotek, ki so bile spremenjene na disku

Stran Odpiranje omogoča spremembo delovanja &kgraphviewer;-ja, ko je datoteka z grafom odprta izven trenutne seje. Izberete lahko samodejno dejanje (odpri v obstoječem oknu ali v novem oknu) ali pa, da vas program vsakič znova vpraša.

Stran za odpiranje novih datotek v obstoječem oknu v nastavitvenem pogovoru Stran za odpiranje novih datotek v obstoječem oknu v nastavitvenem pogovoru

Stran za odpiranje novih datotek v obstoječem oknu v nastavitvenem pogovoru

Stran Upravljalnik Seje omogoča spremembo delovanja ob zagonu &kgraphviewer;-ja. Izberete lahko samodejno dejanje (ponovno odpri datoteke prejšnje seje ali ne) ali pa, da vas program vsakič znova vpraša.

Stran za ponovno odpiranje datotek iz prejšnje seje v nastavitvenem pogovoru Stran za ponovno odpiranje datotek iz prejšnje seje v nastavitvenem pogovoru

Stran za ponovno odpiranje datotek iz prejšnje seje v nastavitvenem pogovoru

### Razne funkcije

Kontekstni meni, ponavadi pridobljen z desnim klikom v pogledu na graf, ponuja nekaj drugih možnosti:

Razpored

- To omogoča izbiro med različnimi &graphviz;-ovimi algoritmi za razporejanje, lahko pa izberete svojega. Vnosi, kot je opisano na domači strani &graphviz;-a, so naslednji:

  ˙

- Algoritem ˙, privzet za usmerjene grafe. Proizvede hierarhične ali večplastne risbe usmerjenih grafov. Algoritem za razporejanje razporedi povezave v isto smer (od vrha proti dnu ali od leve proti desni) in se nato poizkuša izogniti prekrižanim povezavam in zmanjšati dolžino povezav.

&neato;

- Algoritem &neato;, privzet za neusmerjene grafe. Proizvede postavitve vzmetnega modela. Uporablja algoritem Kamada-Kawai, ki je enakovreden statističnemu večdimenzionalnem skaliranju.

&twopi;

- Algoritem &twopi; za usmerjene in neusmerjene grafe. Radialna postavitev, po Grahamu Willsu 1997.

&fdp;

- Algoritem &fdp; za neusmerjene grafe. Proizvede postavitve vzmetnega modela. Izvaja Fruchterman-Reingoldovo hevristiko, vključno z večmrežnim reševalnikom, ki obravnava večje grafe in gručaste neusmerjene grafe.

&circo;

- Algoritem &circo;. Proizvede krožno postavitev, po Six in Tollis 1999, Kaufman in Wiese 2002. Primeren za določene diagrame večih krožnih struktur.

Določi ukaz za postavitev…

- Odpre pogovorno okno, ki vam omogoča, da določite ukaz za postavitev, ki ga izvede lupina. Ta ukaz sprejme le en parameter, ime datoteke z grafom, in izpiše svojo razporeditev na standardni izhod v jeziku xdot. Na ta način lahko podate določene možnosti enemu prejšnjih ukazov ali uporabite filter, ki spremeni vaš graf preden ga poženete skozi ˙.

Ponastavi ukaz za postavitev na privzetega

- Določite vrsto grafa (usmerjeni ali neusmerjeni) in uporabite na njem privzeti algoritem, ki je trenutno ˙ ali &neato;.

Izvozi Graf

- Kot Sliko…

- Omogoča izvoz celotnega grafa v vse podprte slikovne formate.

Omogoči ogled iz Ptičje perspektive

- Ko je označeno, se bo prikazal pogled iz ptičje perspektive, ko je to potrebno. V nasprotnem primeru bo skrit, njegov meni za postavitev pa bo onemogočen.

Pozicija Ptičje Perspektive

- Nastavite, kam boste postavili pogled iz ptičje perspektive v pogledu na graf. Možne izbire so:

  Levo Zgoraj

- Postavi pogled iz ptičje perspektive v levi zgornji kot;

Desno Zgoraj

- Postavi pogled iz ptičje perspektive v desni zgornji kot;

Levo Spodaj

- Postavi pogled iz ptičje perspektive v levi spodnji kot;

Desno Spodaj

- Postavi pogled iz ptičje perspektive v desni spodnji kot;

Samodejno

- Samodejno izbere najboljšo postavitev, da prekrije čim manj grafa.

## Sklic na Ukaz

### Meniji &kgraphviewer;-ja

#### Meni Datoteka

&Ctrl;N Datoteka Nov

- Odpre novo okno &kgraphviewer;-ja.

&Ctrl;O Datoteka Odpri

- Prikaže pogovorno okno za Odpiranje Datotek.

Datoteka Odpri Nedavno

- Prikaže seznam zadnjih deset datotek z grafi, ki so bile odprte.

Datoteka Izvozi Graf Kot Sliko…

- Omogoča izvoz celotnega grafa v vse podprte slikovne formate.

&Ctrl;P Datoteka Natisni...

- Natisne trenutni graf z uporabo parametrov, ki so trenutno nastavljeni.

&Ctrl;&Shift;P Datoteka Natisni Predogled...

- Odpreokno Natisni Predogled za trenutni graf.

Datoteka Nastavitev Strani…

- Odprepogovorno oknoNastavitve stravi za trenuten graf.

&Ctrl;Q Datoteka Končaj

- Zapre &kgraphviewer;.

#### Meni Pogled

&Ctrl;+Poled Približaj

- Približa trenuten graf za 10%.

&Ctrl;-Poled Oddalji

- Pomanjša trenuten graf za 10%.

Pogled Osveži

- Ponovno naloži trenutni graf.

Pogled Algoritem postavitve

- Odpre meni z različnimi razporeditvenimi algoritmi za trenutni graf.

&Ctrl;B Pogled Omogoči Pogled iz Ptičje Perspektive

- Ko je označeno, se bo prikazal pogled iz ptičje perspektive, ko je to potrebno. V nasprotnem primeru bo skrit, njegov meni za postavitev pa bo onemogočen.

Pogled Pozicija Ptičje Perspektive

- Konfigurirajte, kam naj se postavi pogled iz ptičje perspektive v pogledu na graf. Možnosti so:

  Levo Zgoraj

- Postavi pogled iz ptičje perspektive v levi zgornji kot;

Desno Zgoraj

- Postavi pogled iz ptičje perspektive v desni zgornji kot;

Levo Spodaj

- Postavi pogled iz ptičje perspektive v levi spodnji kot;

Desno Spodaj

- Postavi pogled iz ptičje perspektive v desni spodnji kot;

Samodejno

- Samodejno izbere najboljšo postavitev, da prekrije čim manj grafa.

#### Meni Nastavitve in Pomoč

&kgraphviewer; ima običajna &kde;-jeva elementa menija Nastavitve in Pomoč, za več informacij preberite razdelek o Meni Nastavitve in Meni Pomoč &kde;-jevih Osnov.

### Orodne Vrstice &kgraphviewer;-ja

#### Glavna Orodna Vrstica

- Prikaže pogovorno okno Odpri Datoteko.

- Prikaže seznam nedavno odprtih datotek.

- Prikaže pogovorno okno Natisni Predogled.

#### Orodna Vrstica Pogleda

- Uredi ukaz za postavitev ali prikaže seznam prednastavljenih algoritmov za razporejanje.

- Približa trenuten graf za 10%.

- Pomanjša trenuten graf za 10%.

#### Orodna Vrstica Pomoči

- Prikaže kazalec miške Kaj je to?. Kliknite z njim na element &GUI;-ja, da dobite informacije, kako uporabljati ta element (če take informacije obstajajo).

## Zasluge in Licenca

### Program

#### Glavni Avtor

Avtorske pravice programa 2005-2006 Gaël de Chalendar kleag@free.fr

#### Sodelavci (da se je dokončalo)

- Reimar Döffinger Reimar.Doeffinger@stud.uni-karlsruhe.de

### Navodila za Uporabnike

Avtorske pravice dokumentacije 2006 Gaël de Chalendar kleag@free.fr

#### Sodelavci

- Federico Zenith federico.zenith@member.fsf.org

### Ostale zasluge

Ta program vsebuje kodo, pridobljeno iz naslednjih Prostih Programskih Oprem:

&kcachegrind;

- Začetni model grafa in razredi pogledov;

&kexi;

- Nastavitve tiskanja in razredi predogledov.

### Licence

Prevod: Krištof Trček kt91536@student.uni-lj.si

&underFDL; &underGPL;
&documentation.index;