# Handbok &kgraphviewer;

## Inledning

&kgraphviewer; är ett grafvisningsverktyg av &graphviz; ˙-grafer. Programmen i &graphviz; är fri programvara för layout av grafer. &kgraphviewer; visar graferna i ett modernt användarvänligt grafiskt gränssnitt. Det har följande funktioner: Här är en skärmbild av &kgraphviewer; Huvudfönstret i &kgraphviewer; som visar ett av exemplen från &graphviz;

- Zoomning,

- Samtidig laddning av flera grafer under flikar,

- Lagring av en lista med senaste öppnade filer,

- En översiktsvy av grafen,

- Panorering av grafen genom att dra musen,

- Utskrift med fullständig funktion,

- Perfekt uppritning av alla exempelgrafer från &graphviz;,

- Färger på noder och bågar samt alla nodformer stöds,

- Automatiskt val av ˙ för riktade grafer och &neato; för oriktade,

- Manuell eller automatisk inläsning med bekräftelse av användaren för (externt) ändrade filer (anpassningsbart),

- Öppnar nya instanser som nya flikar i den tidigare (anpassningsbart),

- Hjälpsystem,

- Översättning av programmet.

Planerade funktioner är:

- Framtida användning av &qanava;-biblioteket för att stödja intern representation av grafer,

- Spara sessionsdata om grafer (layout som programmet använde, zoomfaktor, etc.)

- Integrering i &kate; och &konqueror; (så att en ändring i &kate;s visning av grafen skulle göra en ny layout och inläsning av filen i &kgraphviewer;),

- Meny för att öppna filen i &kate; eller öppna ett Kate-delprogram inne i &kgraphviewer;s fönster,

- Laddning av stora och mycket stora grafer (för närvarande finns prestandaproblem omkring 1000 noder, och en fix för att ignorera noder över en angiven gräns),

- Stöd för fler och fler egenskaper och värden från ˙ efter hand,

- Layout i bakgrunden (tråd för att inte blockera gränssnittet, med förloppsrad),

Observera att programmet innehåller kod från GPL-verktyget &kcachegrind; av Josef Weidendorfer, med hans tillstånd.

Observera också att utskriftssystemet kommer från &calligra;sdatabasprogram &kexi;.

Annan programvara som krävs: &kgraphviewer; är ett program som använder &graphviz;-verktyget ˙ för layout av grafer. Dess beroenden är:

- &Qt;- och &kde; Ramverk-biblioteken version 5.x,

- &graphviz;-verktygen som externa program (testat med version 2.8),

- &boost;-biblioteket version 1.36.

## Använda &kgraphviewer;

### Huvudfönstret

Huvudfönstret visar inlästa grafer, var och en under sin flik. Om du startar &kgraphviewer; utan väljare är huvudfönstret tomt som visas på skärmbilden nedan. I detta fall innehåller verktygsraden bara ikonerna Öppna... och (den tomma) Öppna senaste. Klicka på den första för att visa den vanliga dialogrutan Öppna fil.

Det ursprungliga huvudfönstret när &kgraphviewer; startas för första gången Det ursprungliga huvudfönstret när &kgraphviewer; startas för första gången

Det ursprungliga huvudfönstret när &kgraphviewer; startas för första gången

Efter att ha valt en eller flera ˙-filer, ser huvudfönstret ut som nästa skärmbild nedan:

Huvudfönstret i &kgraphviewer; med flera öppna filer Huvudfönstret i &kgraphviewer; med flera öppna filer

Huvudfönstret i &kgraphviewer; med flera öppna filer

Som du kan se visas en översiktsvy i ett hörn om grafen är större än tillgänglig yta. Du kan välja om den bästa platsen för översikten ska beräknas automatiskt åt dig, eller om du ska placera den där du vill ha den själv, med den sammanhangsberoende menyn.

#### Flytta grafen inne i fönstret

För att flytta en graf kan du:

- Klicka och dra den,

- Använda rullningslisterna,

- Trycka på piltangenterna,

- Klicka någonstans i översiktsvyn,

- Använda mushjulet (uppåt och neråt utan väljartangent, vänster och höger med &Alt;-tangenten nertryckt),

- eller klicka och dra inne i översiktsvyn.

#### Zoomning

För att zooma kan du antingen använda verktygsradens knappar och eller hålla nere &Shift;-tangenten medan du rör mushjulet. Vid inzoomning blir den röda rektangeln i panoreringsvyn, som avbildar området som visas, mindre och mindre. Om den skulle bli mindre än 10 bildpunkter längs den kortaste sidan, ersätts den dock av en enkel röd rektangel för att förbli synlig. Du ser det på skärmbilden nedan.

En graf med maximal inzoomningsnivå En graf med maximal inzoomningsnivå

En graf med maximal inzoomningsnivå

Zoomning är begränsat till en faktor 10 i båda riktningar. Nedan kan du se den maximala zoomfaktorn för en graf.

En graf med maximal utzoomningsnivå En graf med maximal utzoomningsnivå

En graf med maximal utzoomningsnivå

#### Hantering av graffiler

##### Filer ändrade på disk

Om en fil som för närvarande är laddad i &kgraphviewer; ändras av ett annat program, visas följande dialogruta:

Dialogruta för inläsning av en fil ändrad på disk Dialogruta för inläsning av en fil ändrad på disk

Dialogruta för inläsning av en fil ändrad på disk

Du kan välja att läsa in grafen eller ignorera ändringen. Du kan också få &kgraphviewer; att komma ihåg ditt val och att göra samma sak följande gång. Om du senare vill ändra ditt val, välj menyalternativet Inställningar Anpassa &kgraphviewer;.... Se kgraphviewer-configuration.

##### Filer och fönster

När en graffil öppnas utanför en instans av &kgraphviewer; som kör, t.ex. i en filhanterare eller på kommandoraden, har du möjlighet att visa ett nytt &kgraphviewer;-fönster eller lägga till grafen under en ny flik i det befintliga fönstret. Det görs med dialogrutan nedan.

Dialogrutan för att öppna ett nytt fönster Dialogrutan för att öppna ett nytt fönster

Dialogrutan för att öppna ett nytt fönster

Liksom med det föregående alternativet kan du spara valet som förval och senare ändra det i inställningsdialogrutan.

##### Sessionshantering

Vid start kan du välja att öppna graferna som var öppna föregående gång eller inte. Kom ihåg ditt val och ändra det senare, om du vill.

Dialogruta för inläsning av grafer från tidigare session vid start Dialogruta för inläsning av grafer från tidigare session vid start

Dialogruta för inläsning av grafer från tidigare session vid start

### Utskrift av grafer

Prova med knapparna Förhandsgranskning av utskrift eller Sidinställning för att utforska utskriftsalternativen.

Dialogrutan för sidinställning Dialogrutan för sidinställning

Dialogrutan för sidinställning

Du kan ställa in utskriftsalternativ för att exakt passa in grafen på en sida, som nedan:

Inställning av förhandsgranskning för att få plats på en sida Inställning av förhandsgranskning för att få plats på en sida

Inställning av förhandsgranskning för att få plats på en sida

Du kan också välja hur grafen ska delas upp på flera sidor. Antal horisontella och vertikala sidor kan väljas oberoende.

Sidinställning gjord för att få plats på flera sidor och fylla dem Sidinställning gjord för att få plats på flera sidor och fylla dem

Sidinställning gjord för att få plats på flera sidor och fylla dem

Till sist, när flera sidor används, kan du välja att låta delen av grafen på varje sida att fylla sin sida som ovan, och inte behålla proportionen, eller att behålla den. I det senare fallet fylls inte sidorna.

Du kan ändra sidstorlek och marginaler:

Dialogrutan för sidstorlek och marginaler Dialogrutan för sidstorlek och marginaler

Dialogrutan för sidstorlek och marginaler

Du kan också ändra teckensnitt, sidhuvud och sidfot:

Sidinställning gjord för att få plats på flera sidor utan sidhuvud och med ett annat teckensnitt Sidinställning gjord för att få plats på flera sidor utan sidhuvud och med ett annat teckensnitt

Sidinställning gjord för att få plats på flera sidor utan sidhuvud och med ett annat teckensnitt

### Anpassa &kgraphviewer;

Sidan Utseende gör det möjligt att ändra den vanliga bakgrundsfärgen som används i &kgraphviewer; om en graf inte har sin egen bakgrundsfärg.

Sida för att ändra en grafs utseende Sida för att ändra en grafs utseende

Sida för att ändra en grafs utseende

Sidan Tolkning gör det möjligt att välja ett externt kommando eller det interna biblioteket för att tolka &graphviz; ˙-filer.

Sida i inställningsdialogrutan för att ladda om filer ändrade på disk Sida i inställningsdialogrutan för att ladda om filer ändrade på disk

Sida i inställningsdialogrutan för att ladda om filer ändrade på disk

Sidan Uppdatering låter dig ändra beteende hos &kgraphviewer; när en fil ändras på disk. Du kan välja en standardreaktion (automatisk inläsning eller inte) eller att bli tillfrågad varje gång.

Sida i inställningsdialogrutan för att ladda om filer ändrade på disk Sida i inställningsdialogrutan för att ladda om filer ändrade på disk

Sida i inställningsdialogrutan för att ladda om filer ändrade på disk

Sidan Öppna låter dig ändra beteende hos &kgraphviewer; när en graffil öppnas utanför den nuvarande sessionen. Du kan välja en standardreaktion (öppna i befintligt fönster eller i ett nytt) eller att bli tillfrågad varje gång.

Sida i inställningsdialogrutan för att öppna nya filer i befintligt fönster Sida i inställningsdialogrutan för att öppna nya filer i befintligt fönster

Sida i inställningsdialogrutan för att öppna nya filer i befintligt fönster

Sidan Sessionshantering låter dig ändra beteende hos &kgraphviewer; när det startar. Du kan välja en standardreaktion (öppna filer från föregående session eller inte) eller att bli tillfrågad varje gång.

Sida i inställningsdialogrutan för att öppna tidigare öppnade filer igen Sida i inställningsdialogrutan för att öppna tidigare öppnade filer igen

Sida i inställningsdialogrutan för att öppna tidigare öppnade filer igen

### Diverse funktioner

Sammanhangsberoende menyn (som oftast erhålls genom att högerklicka i grafvyn) erbjuder några andra möjligheter:

Layout

- Det här låter dig välja mellan diverse &graphviz; layoutalgoritmer eller välja en egen. Alternativen, som de beskrivs på &graphviz; hemsida, är följande:

  ˙

- Algoritmen ˙. Standardalternativ för riktade grafer. Den ritar hierarkiska bilder med lager av riktade grafer. Layoutalgoritmen riktar bågar åt samma håll (uppifrån och neråt, eller från vänster till höger) och försöker därefter undvika korsande bågar och reducera bågarnas längd.

&neato;

- Algoritmen &neato;, standardalternativ för oriktade grafer. Gör en layout enligt fjädermodellen. Den använder Kamada-Kawai algoritmen, vilken är ekvivalent med statistisk flerdimensionell skalning.

&twopi;

- Algoritmen &twopi;, för riktade och oriktade grafer. Radiell layout enligt Graham Wills 97.

&fdp;

- Algoritmen &fdp;. För oriktade grafer. Gör en layout enligt fjädermodellen. Den implementerar den heuristiska metoden enligt Fruchterman-Reingold, inklusive en flerdimensionell rutnätslösning som hanterar stora grafer och oriktade grafer med anhopningar.

&circo;

- Algoritmen &circo;. Den skapar en cirkulär layout, enligt Six och Tollis 99, Kauffman och Wiese 02. Lämplig för vissa diagram med flera cykliska strukturer.

Ange layoutkommando

- Öppnar en dialogruta som låter dig ange ett layoutkommando som körs i ett skal. Kommandot ska förvänta sig en parameter, som är grafens filnamn, och skriva ut layouten på standardutmatningen med språket xdot. På så sätt kan du till exempel ange särskilda väljare för ett av de tidigare kommandona eller använda ett filter som ändrar grafen innan den körs igenom ˙.

Återställ layoutkommando till normalvärden

- Bestäm återigen grafens typ (riktad eller inte) och använd standardalgoritmen på den, för närvarande ˙ respektive &neato;.

Exportera graf

- Som bild...

- Möjliggör export av hela grafen till alla bildformat som stöds.

Aktivera översiktsvy

- Om markerad, visas översiktsvyn om nödvändigt. Annars är den dold, och dess positioneringsmeny är inaktiverad.

Översiktsvy

- Anpassa var översiktsvyn ska placeras i grafvyn. Möjliga val är:

  Uppe till vänster

- Placerar översiktsvyn i övre vänstra hörnet,

Uppe till höger

- Placerar översiktsvyn i övre högra hörnet,

Nere till vänster

- Placerar översiktsvyn i nedre vänstra hörnet,

Nere till höger

- Placerar översiktsvyn i nedre högra hörnet,

Automatisk

- Välj automatiskt bästa position för att dölja så litet som möjligt av grafen

## Kommandoreferens

### Menyerna i &kgraphviewer;

#### Menyn Arkiv

&Ctrl;N Arkiv Ny

- Öppnar ett nytt &kgraphviewer;-fönster.

&Ctrl;O Arkiv Öppna

- Visar dialogrutan Öppna fil.

Arkiv Öppna senaste

- Visar listan med de tio senast öppnade graffilerna.

Arkiv Exportera graf Som bild...

- Möjliggör export av hela grafen till alla bildformat som stöds.

&Ctrl;P Arkiv Skriv ut...

- Skriver ut nuvarande graf med utskriftsparametrarna som för närvarande är inställda.

&Ctrl;&Shift;P Arkiv Förhandsgranska utskrift...

- Öppnar fönstret för förhandsgranskning av utskrift för nuvarande graf.

Arkiv Sidinställning

- Öppnar dialogrutan för sidinställning av utskrift för nuvarande graf.

&Ctrl;Q Arkiv Avsluta

- Avslutar &kgraphviewer;.

#### Menyn Visa

&Ctrl;+ Visa Zooma in

- Zooma in i nuvarande graf med 10 %.

&Ctrl;- Visa Zooma ut

- Zooma ut i nuvarande graf med 10 %.

Visa Visa igen

- Laddar om nuvarande graf.

Visa Välj layoutalgoritm

- Visar en delmeny med diverse layoutalgoritmer från &graphviz; för aktuell graf.

&Ctrl;B Visa Aktivera översiktsvy

- Om markerad, visas översiktsvyn om nödvändigt. Annars är den dold, och dess positioneringsmeny är inaktiverad.

Visa Översiktsvy

- Anpassa var översiktsvyn ska placeras i grafvyn. Möjliga val är:

  Uppe till vänster

- Placerar översiktsvyn i övre vänstra hörnet,

Uppe till höger

- Placerar översiktsvyn i övre högra hörnet,

Nere till vänster

- Placerar översiktsvyn i nedre vänstra hörnet,

Nere till höger

- Placerar översiktsvyn i nedre högra hörnet,

Automatisk

- Välj automatiskt bästa position för att dölja så litet som möjligt av grafen

#### Menyerna Inställningar och Hjälp

&kgraphviewer; har de vanliga menyalternativen i &kde;, Inställningar och Hjälp. För mer information läs avsnitten om Menyn Inställningar och Menyn Hjälp i &kde;:s grunder.

### Verktygsraderna i &kgraphviewer;

#### Huvudverktygsraden

- Visar dialogrutan Öppna fil.

- Visar listan med senaste öppnade filer

- Visar dialogrutan Förhandsgranskning av utskrift.

#### Vyverktygsraden

- Redigerar layoutkommandot eller visar listan med förinställda layoutalgoritmer.

- Zooma in i nuvarande graf med 10 %.

- Zooma ut i nuvarande graf med 10 %.

#### Hjälpverktygsraden

- Visar muspekaren Vad är det här. Klicka med den på ett grafiskt element för att få hjälp med att använda det (om någon sådan hjälp finns tillgänglig).

## Tack till och licens

### Program

#### Huvudsakliga upphovsmän

Program copyright 2005-2006 Gaël de Chalendar kleag@free.fr

#### Bidragsgivare (kommer att kompletteras)

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

### Användarguide

Dokumentation copyright 2006 Gaël de Chalendar kleag@free.fr

#### Bidragsgivare

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

### Övriga erkännanden

Kod från följande fri programvara har återanvänts i detta program:

&kcachegrind;

- Ursprunglig grafmodell och visningsklasser,

&kexi;

- Utskriftsinställning och förhandsgranskningsklasser.

### Licenser

Översättning Stefan Asserhäll stefan.asserhall@bredband.net

&underFDL; &underGPL;
&documentation.index;