# Het handboek van &kgraphviewer;

## Inleiding

&kgraphviewer; is een &graphviz; ˙ graph viewer. De &graphviz; programma's is vrije-software voor opmaak-engines voor grafieken. &kgraphviewer; toont de grafieken met behulp van een modern gebruikersvriendelijke &GUI; Het heeft de volgende mogelijkheden: Hier is een schermafdruk van &kgraphviewer; Het hoofdvenster van &kgraphviewer; die een van de voorbeelden van &graphviz; toont

- Zoomen;

- Laden van verschillende grafen in tabbladen op dezelfde tijd;

- Opslag van een lijst met recente bestanden;

- Een vogelvlucht weergave van een graaf;

- Wandelen door grafieken door verslepen met de muis:

- Afdrukken met alle mogelijkheden;

- Perfecte weergave van alle &graphviz;-voorbeelden;

- De ondersteuning van alle node-vormen en gekleurde nodes en lijnen

- Automatische keus van ˙ voor evenwijdige schema´s en &neato; voor diegene die niet evenwijdig lopen.

- Handmatig of automatisch herladen (na bevestiging van de gebruiker) van extern gewijzigde bestanden (instelbaar);

- Openen van nieuwe programma-instanties als nieuwe tabs in een bestaande instantie (instelbaar);

- Help systeem;

- Internationalisatie

Mogelijke toekomstige toevoegingen:

- Eventueel het gebruik van de bibliotheek &qanava; voor de ondersteuning van van interne grafische voorstellingen;

- Het opslaan van sessiebeheer (grafische indeling, gebruikte zoomfactor. &etc;)

- Integratie in &kate; en &konqueror; (zodat een wijziging van de weergave in &kate; van het schema zal resulteren in het opnieuw laden van het bestand in de &kgraphviewer;);

- Menu voor het openen van het bestand in &kate; of voor het openen van een katepart in het &kgraphviewer;-venster;

- Laden van grote en enorme grafieken (op dit moment treden er problemen op met de performance bij ongeveer 1000 nodes, en een hack voor het negeren van nodes boven een opgegeven limiet);

- Verdergaande ondersteuning van meer en meer ˙ attributen en waarden;

- Berekening van de opmaak in achtergrond (met threading om de gebruikersinterface niet te blokkeren, met voortgang-indicatie).

Merk op dat dit programma met toestemming code heeft overgenomen van het GPL programma &kcachegrind; geschreven door Josef Weidendorfer.

Merk ook op dat het printsysteem afkomstig is uit het &kexi; database programma in &calligra;.

Andere benodigde software: &kgraphviewer; is een programma dat gebruik maakt van het &graphviz; hulpmiddel ˙ voor de grafische opmaak. Zijn afhankelijkheden van:

- De &Qt; en &kde-frameworks; bibliotheken met versie 5.x;

- Het &graphviz; hulpmiddel als extern programma (getest met versie 2.8);

- De &boost; bibliotheek versie 1.36.

## &kgraphviewer; gebruiken

### Het hoofdvenster

Het hoofdvenster toont de geladen grafieken, elk in zijn eigen tab. In het begin, als u &kgraphviewer; zonder argumenten start, dan is het hoofdvenster leeg zoals in het schermafdruk hieronder is te zien. In dat geval heeft de werkbalk alleen de items Openen... en de (lege) Recent geopend. Klik op de eerste om de standaard dialoog Open Bestand te openen.

Het hoofdvenster bij het de eerste keer openen van &kgraphviewer; Het hoofdvenster bij het de eerste keer openen van &kgraphviewer;

Het hoofdvenster bij het de eerste keer openen van &kgraphviewer;

Na het selecteren van een of meerdere ˙-bestanden, ziet het hoofdvenster eruit zoals in het schermafbeelding hieronder:

Het hoofdvenster van &kgraphviewer; met verschillende geopende bestanden Het hoofdvenster van &kgraphviewer; met verschillende geopende bestanden

Het hoofdvenster van &kgraphviewer; met verschillende geopende bestanden

Zoals u ziet, is het in vogelvlucht in een venster in de hoek te zien als de grafiek groter is dan het beschikbare ruimte. U kunt met het contextmenu instellen of de optimale positie van dit overzicht automatisch berekent wordt of dat u het zelf plaatst.

#### Het grafiek in het venster verplaatsen

Om de grafiek te verplaatsen, kunt u:

- Klikken en verslepen;

- De schuifbalken gebruiken;

- Op de navigatietoetsen drukken;

- Ergens in het vogelvlucht-overzicht klikken;

- Het muiswiel gebruiken (zonder modifier omhoog en omlaag, met de &Alt;-toets ingedrukt naar links en rechts);

- of Klikken en verslepen in het vogelvlucht-overzicht.

#### Zoomen

Om in of uit te zoomen, kunt u naar keuze de knoppen of uit de werkbalk gebruiken om IN en UIT te zoomen, of u houd de &Shift;-toets ingedrukt terwijl u met uw muiswiel rolt. Tijdens het inzoomen zal in het vogelvlucht-overzicht het rode rechthoek dat het getoonde vlak voorstelt, kleiner en kleiner worden. Als het aan de korte kant kleiner wordt dan 10 pixels, dan is het als gevuld rood rechthoekje zodat het beter zichtbaar blijft. U kunt dat op het schermafbeelding hieronder zien.

Een grafiek maximaal ingezoomd Een grafiek maximaal ingezoomd

Een grafiek maximaal ingezoomd

Zooming is gelimiteerd in beide richtingen met een factor 10. U kunt hieronder een grafiek zien met de maximale uitzoom-factor.

Een grafiek maximaal uitgezoomd Een grafiek maximaal uitgezoomd

Een grafiek maximaal uitgezoomd

#### Het hanteren van grafiek-bestanden

##### Op de harde schijf gewijzigde bestanden

Als een op dit moment in &kgraphviewer; geladen bestand is gewijzigd door een ander programma dan krijgt u het volgende dialoog te zien:

Dialoog voor het opnieuw laden van een op de harde schijf gewijzigd bestand Dialoog voor het opnieuw laden van een op de harde schijf gewijzigd bestand

Dialoog voor het opnieuw laden van een op de harde schijf gewijzigd bestand

U kunt de keuze maken om de grafiek opnieuw te laden of om de wijziging te negeren. U kunt ook &kgraphviewer; uw keuze laten onthouden, zodat het de volgende keer hetzelfde uitvoert. Als u later uw keuze wilt wijzigen, open dan het menu-item Instellingen&kgraphviewer; configureren.... Lees kgraphviewer-configuration voor meer informatie.

##### Bestanden en Vensters

Als u een grafiek-bestand wilt openen van buiten een gestarte &kgraphviewer;-sessie, ⪚ vanuit een bestandsverkenner of van de commandoregel, dan heeft u de keuze om een nieuw &kgraphviewer; venster te openen of om de grafiek in een nieuwe tab in het bestaande venster te openen. Dit kunt u doen in het dialoog hieronder.

Dialoog voor het openen van een nieuw venster Dialoog voor het openen van een nieuw venster

Dialoog voor het openen van een nieuw venster

Zoals voor de vorige keuzemogelijkheid, kunt u uw keuze als standaard opslaan en later weer wijzigen in het configuratievenster.

##### Sessie beheer

Bij het opstarten kunt u kiezen om de grafieken die in de laatste sessie geopend waren opnieuw te openen. Ook hier kunt u uw keuze opslaan en later weer wijzigen.

Dialoog voor het bij het starten opnieuw laden van de grafiek die in de laatste sessie geopend was Dialoog voor het bij het starten opnieuw laden van de grafiek die in de laatste sessie geopend was

Dialoog voor het bij het starten opnieuw laden van de grafiek die in de laatste sessie geopend was

### Grafieken afdrukken

Probeer de knoppen Afdrukvoorbeeld of de Pagina instellingen uit om de print-mogelijkheden te verkennen.

Dialoog voor afdruk instellingen Dialoog voor afdruk instellingen

Dialoog voor afdruk instellingen

U kunt de afdruk-mogelijkheden zodanig instellen dat de grafiek precies op een pagina past, zoals u hieronder kun zien.

Afdrukvoorbeeld zodanig ingesteld dat het op een pagina past Afdrukvoorbeeld zodanig ingesteld dat het op een pagina past

Afdrukvoorbeeld zodanig ingesteld dat het op een pagina past

U kunt ook beslissen om de grafiek over meerdere pagina´s te verdelen. Horizontaal en verticaal is het aantal pagina´s onafhankelijk in te stellen.

Afdrukvoorbeeld zodanig ingesteld dat het meerdere pagina´s vult Afdrukvoorbeeld zodanig ingesteld dat het meerdere pagina´s vult

Afdrukvoorbeeld zodanig ingesteld dat het meerdere pagina´s vult

Tenslotte, bij het gebruik van meerdere pagina´s, kunt u ervoor kiezen dat het gedeelte van de grafiek op elke pagina de pagina geheel vult zoals hierboven, waarbij de beeldverhoudingen wordt genegeerd, of waarbij het wel wordt in acht genomen. In het laatste geval, kunnen pagina´s niet geheel gevuld zijn.

U kunt de paginagrootte en de marges wijzigen:

Dialoog voor de pagina-instellingen en de marges Dialoog voor de pagina-instellingen en de marges

Dialoog voor de pagina-instellingen en de marges

U kunt ook het lettertype, koptekst en voettekst wijzigen:

Afdrukvoorbeeld zodanig ingesteld dat het op meerdere pagina´s past zonder koptekst en met een ander lettertype Afdrukvoorbeeld zodanig ingesteld dat het op meerdere pagina´s past zonder koptekst en met een ander lettertype

Afdrukvoorbeeld zodanig ingesteld dat het op meerdere pagina´s past zonder koptekst en met een ander lettertype

### &kgraphviewer; instellen

De pagina Uiterlijk stelt u in staat om de standaard achtergrondkleur gebruikt in &kgraphviewer; te wijzigen als een grafiek zelf geen eigen achtergrondkleur heeft.

Pagina om het uiterlijk van een grafiek te wijzigen Pagina om het uiterlijk van een grafiek te wijzigen

Pagina om het uiterlijk van een grafiek te wijzigen

De pagina Ontleden stelt u in staat om een extern commando of de interne bibliotheek voor het ontleden van &graphviz; ˙ bestanden te selecteren.

Pagina in het configuratie dialoogvenster voor het herladen van op de harde schijf gewijzigde bestanden Pagina in het configuratie dialoogvenster voor het herladen van op de harde schijf gewijzigde bestanden

Pagina in het configuratie dialoogvenster voor het herladen van op de harde schijf gewijzigde bestanden

Op de pagina Opnieuw inlezen kunt u het gedrag aanpassen van &kgraphviewer; bij het wijzigen van een bestand op de harde schijf door een ander programma. U kunt een standaard reactie instellen (automatisch herladen of wijzigingen negeren), of iedere keer vragen.

Pagina in het configuratie dialoogvenster voor het herladen van op de harde schijf gewijzigde bestanden Pagina in het configuratie dialoogvenster voor het herladen van op de harde schijf gewijzigde bestanden

Pagina in het configuratie dialoogvenster voor het herladen van op de harde schijf gewijzigde bestanden

Op de pagina Openen kunt u het gedrag aanpassen van &kgraphviewer; als u een grafiek-bestand opent buiten de huidige sessie. U kunt een standaard reactie instellen (het openen in het bestaande venster of in een nieuw venster), of iedere keer vragen.

Pagina in het configuratie dialoogvenster met instellingen voor het openen van nieuwe bestanden in het bestaande venster Pagina in het configuratie dialoogvenster met instellingen voor het openen van nieuwe bestanden in het bestaande venster

Pagina in het configuratie dialoogvenster met instellingen voor het openen van nieuwe bestanden in het bestaande venster

Op de pagina Sessiebeheer kunt u het opstartgedrag van &kgraphviewer; aanpassen. U kunt een standaard reactie instellen (het wel of niet opnieuw openen van de bestanden die in de laatste sessie geopend waren), of iedere keer vragen.

Pagina in het configuratie dialoogvenster met instellingen voor het opnieuw laden van de in de laatste sessie geopende bestanden Pagina in het configuratie dialoogvenster met instellingen voor het opnieuw laden van de in de laatste sessie geopende bestanden

Pagina in het configuratie dialoogvenster met instellingen voor het opnieuw laden van de in de laatste sessie geopende bestanden

### Diverse onderdelen

Het contextmenu, dat u meestal opent door met de &RMB; in het grafische venster te klikken, geeft nog enkele andere mogelijkheden:

Opmaak

- Hier kunt u een kiezen tussen verschillende &graphviz; opmaak algoritmes maar u kunt ook uw eigen opmaak selecteren. De items, waarvan u de beschrijving kunt vinden op de &graphviz; homepage, zijn de volgende:

  ˙

- ˙ algoritme, standaard voor directe schema´s. het produceert hiërarchische of gelaagde schema´s. Het opmaak algoritme laat de lijnen evenwijdig lopen (van boven naar beneden en van links naar rechts), en probeert vervolgens kruisende lijnen te vermijden en de lijnen zo kort mogelijk te houden.

&neato;

- &neato; algoritme, standaard voor schema´s die niet evenwijdig lopen. Het produceert springveer model indelingen. Het gebruikt het Kamada-Kawai algoritme, welke overeenkomt met statische multi-dimensionale verschalingen.

&twopi;

- &twopi; algoritme, voor evenwijdige en niet evenwijdige schema´s. Radiale opmaak, naar Graham Wills 1997.

&fdp;

- &fdp; algoritme, voor niet evenwijdige grafieken. het produceert een springveer opmaak. Het gebruikt het Fruchterman-Reingold heuristic dat een multidimensionale solver gebruikt die grotere grafieken kan hanteren en niet evenwijdige grafieken clustert.

&circo;

- &circo; algoritme. Het produceert een circulaire opmaak, naar Six en Tollis 1999, Kauffman en Wiese 2002. Geschikt voor bepaalde diagrammen van meerdere cyclische structuren.

Indelingscommando speciceren…

- Opent een dialoog waarin u een opmaak commando kunt opgeven dat vervolgens door de shell wordt uitgevoerd. Dit commando kan maar een parameter accepteren, Het grafiek-bestandsnaam, waarna het de opmaak via stout in de xdot-taal produceert. Op deze manier kunt u specifieke optie´s meegeven aan een van de vorige commando´s, of een filter toepassen dat uw grafiek aanpast voordat ˙ het gaat bewerken.

Indelingscommando terugzetten naar standaardwaarde

- Bepaal het soort grafiek (wel of niet evenwijdig) en pas de standaard algoritme er op toe, op dit moment respectievelijk ˙ en &neato;.

Grafiek exporteren

- Als afbeelding…

- Stelt in staat om de volledige grafiek naar alle ondersteunde afbeeldingsformaten te exporteren.

Vogelvlucht activeren

- Indien ingeschakeld, zal indien nodig het overzicht worden getoond. Anders blijft het verborgen en is zijn locatie-menu uitgeschakeld.

Positie van vogelvlucht

- Configureert waar het overzicht in de grafische weergave wordt geplaatst. De keuzemogelijkheden zijn:

  Linksboven

- Plaatst het overzicht in de linkerbovenhoek;

Rechtsboven

- Plaatst het overzicht in de rechterbovenhoek;

Linksonder

- Plaatst het overzicht in de linkeronderhoek;

Rechtsonder

- Plaatst het overzicht in de rechteronderhoek;

Automatisch

- Automatisch kiest de beste positie om zo weinig mogelijk van de grafiek te bedekken.

## Overzicht van de opdrachten

### De menu´s van &kgraphviewer;

#### Het menu Bestand

&Ctrl;N Bestand Nieuw

- Opent een nieuw &kgraphviewer;-venster.

&Ctrl;O Bestand Openen

- Toont het dialoog Bestand openen.

Bestand Recent geopend

- Toont de lijst met tien laatst geopende bestanden.

Bestand Grafiek exporteren Als afbeelding…

- Stelt in staat om de volledige grafiek naar alle ondersteunde afbeeldingsformaten te exporteren.

&Ctrl;P Bestand Afdrukken...

- Drukt de geselecteerde grafiek af met de huidige print-instellingen.

&Ctrl;&Shift;P Bestand Voorbeeld afdrukken

- Opent het afdrukvoorbeeld venster met de geselecteerde grafiek.

Bestand Pagina instellen…

- Opent het dialoog Pagina indeling voor de geselecteerde grafiek.

&Ctrl;Q Bestand Afsluiten

- Beëindigen van &kgraphviewer;.

#### Het menu Beeld

&Ctrl;+Beeld Inzoomen

- Zoomt in op de huidige grafiek met 10%.

&Ctrl;-Beeld Uitzoomen

- Zoomt uit op de huidige grafiek met 10%.

Weergave Verversen

- Haalt de huidige grafiek opnieuw uit het bestand.

Beeld Indelingsalgoritme

- Opent een submenu met verschillende &graphviz; indelingsalgorithmen voor de huidige grafiek.

&Ctrl;B Beeld Vogelvluchtweergave inschakelen

- Indien ingeschakeld, zal indien nodig het overzicht worden getoond. Anders blijft het verborgen en is zijn locatie-menu uitgeschakeld.

Beeld Positie van vogelvlucht

- Configureert waar de vogelvluchtweergave in de grafische weergave wordt geplaatst. De keuzemogelijkheden zijn:

  Linksboven

- Plaatst het overzicht in de linkerbovenhoek;

Rechtsboven

- Plaatst het overzicht in de rechterbovenhoek;

Linksonder

- Plaatst het overzicht in de linkeronderhoek;

Rechtsonder

- Plaatst het overzicht in de rechteronderhoek;

Automatisch

- Automatisch kiest de beste positie om zo weinig mogelijk van de grafiek te bedekken.

#### De menu's Instellingen en Help

&kgraphviewer; heeft de standaard &kde;-menu-items Instellingen en Help, lees voor meer informatie de secties over het Menu Instellingen en Help Menu van de &kde; Fundamentals.

### De werkbalken van &kgraphviewer;

#### De hoofdwerkbalk

- toont het dialoog Bestand openen.

- Toont de lijst met recent geopende bestanden.

- Toont het dialoog Afdrukvoorbeeld.

#### Beeldwerkbalk

- U kunt het opmaak commando hier Bewerken en toont de lijst met vooringestelde opmaak algoritmen.

- Zoomt in op de huidige grafiek met 10%.

- Zoomt uit op de huidige grafiek met 10%.

#### Helpwerkbalk

- Toont the What's This mouse pointer. Klik ermee op een &GUI;-onderdeel voor het verkrijgen van uitleg over het gebruik ervan (als de uitleg aanwezig is).

## Dankbetuiging en licentie

### Programma

#### Belangrijkste auteurs

Auteursrecht programma 2005-2006 Gaël de Chalendar kleag@free.fr

#### Met dank aan (nog niet volledig)

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

### Gebruikersgids

Auteursrecht documentatie 2006 Gaël de Chalendar kleag@free.fr

#### Met dank aan

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

### Andere dankbetuigingen

Dit programma bevat hergebruikte code uit de volgende Vrije Software projecten:

&kcachegrind;

- Startpunt grafisch model en weergave klasses;

&kexi;

- Printer instellingenvenster en voorbeeldweergave.

### Licenties

&meld.fouten;&vertaling.freek;&vertaling.ronald; &underFDL; &underGPL;
&documentation.index;