# Arbeta med vyer

## Översikt av vyobjekt

### Begrepp för vyobjekt

Vi kallar objekt i &kst; som ritas upp på skärmen vyobjekt. De omfattar fönster, kommentarer, diagram, kurvor och bilder. En figur som beskriver förhållandet mellan dessa objekt visas nedan.

Förhållanden mellan fönster, diagram och kurvor i &kst;

Som framgår av figuren är de mest grundläggande objekten fönster, som fungerar som behållare av diagram och kommentarobjekt. Diagram är dock de viktigaste vyobjekten i &kst;, eftersom de utför dess huvudsakliga funktion att visa data.

Kommentarobjekt är objekt som texter, pilar, etc. som kan användas för att visa information om diagram, eller markera intressanta områden. Kommentarobjekt som för närvarande är implementerade i &kst; är texter, rutor, ellipser, linjer, pilar, bilder och förklaringar. De är mycket användbara när diagram förbereds för presentationer eller publicering.

Instanser av de olika vyobjekten i &kst; grupperas hierarkiskt, till exempel anses kommentarer ofta vara underliggande ett specifikt diagram beroende på deras plats. Att flytta och ändra storlek på diagrammet ändrar då också storlek på kommentarerna. Ett bra sätt att direkt arbeta med vyobjektens hierarki är att använda vyhanteringen. Den kan kommas åt genom att välja Data Vyhantering.

Alla vyobjekt kan skapas genom att välja motsvarande ritverktyg. Du kan redigera deras alternativ genom att dubbelklicka på dem i layoutläge.

Här är ett exempel på användning av vyobjekt i &kst;, där vi har använt ett diagram, texter, pilar, linjer och en genomskinlig PNG-bild för att illustrera ett färgmagnituddiagram.

Exempel på vyobjekt
Exempel på vyobjekt

### Vyhantering

Vyhanteringen är en trädlistvy som låter dig kopiera och ta bort vyobjekt. Den låter dig också komma åt deras redigeringsdialogrutor.

Vyhantering
Vyhantering

- Redigera eller Ta bort vyobjekt: Markera ett vyobjekt (fönster, diagram, kurva, etc.) som ska redigeras, och klicka på knappen Redigera, eller högerklicka på vyobjektets post och välj alternativet Redigera... i den sammanhangsberoende menyn som visas.

- Kopiera vyobjekt: Markera vyobjektet du skulle vilja kopiera, klicka på det och dra det till namnet på det överliggande objektet som du vill kopiera det till.

Vyhanteringen kan kommas åt genom att klicka på Vyhanteringsikon i verktygsraden.

### Sammanhangsberoende menyer

Vid arbete med diagram och andra vyobjekt, visas en sammanhangsberoende meny som tillhandahåller ofta använda funktioner genom att högerklicka. I allmänhet beror den sammanhangsberoende menyn som visas på vilket musläge som är aktivt och vilket objekt som är centrerat, men det finns fyra grundläggande alternativ gemensamma för alla vyobjekt. Rubriken i den sammanhangsberoende menyn som visas anger namnet på vyobjektet som du har klickat på.

Redigera...

  Visar redigeringsdialogrutan för underliggande vyobjekt. Se avsnittet Typer av vyobjekt för mer information om inställningarna.

Ta bort

  Tar bort vyobjektet.

Byt namn

  Visar en dialogruta för att ändra det unika namnet som är tilldelat till vyobjektet.

Rensa layout

  Arrangerar diagrammen i nuvarande fönster i ett mönster sida vid sida, utan någon överlappning mellan diagram. Genom att välja Förvald sida vid sida i undermenyn arrangeras diagrammen om enligt en estetiskt tilltalande algoritm. Genom att välja alternativet Egen kan du manuellt ange hur många kolumner diagrammen ska visas med. Alternativet gäller för alla diagram i det nuvarande fönstret.

Det finns ytterligare alternativ i den sammanhangsberoende menyn specifika för muszoomlägen och datalayoutläget.

### Byta mellan olika lägen

Kst har olika lägesval. Varje läge har sitt eget specifika användning. Följande lägen är tillgängliga i Kst:

- Muszoomläge

- Grafikläge

- Layoutläge

- Dataläge

Du kan aktivera alla lägen i menyn Diagram. Diagrammeny Diagrammeny Observera att när en ny Kst-session startas, är den normalt i XY-muszoomläge. Följande lista sammanfattar huvudanvändningen av varje läge.

Muszoomlägen

  Den huvudsakliga användningen av muszoomläge är att komma åt diverse zoomfunktioner som tillhandahålls i den sammanhangsberoende menyn. Se avsnittet Sammanhangsberoende meny för zoomlägen för detaljinformation. Det finns tre muszoomlägen tillgängliga i Kst.

  - XY-muszoom

  - X-muszoom

  - Y-muszoom

Grafikläge

  Grafikläge används för att infoga diverse vyobjekt, inklusive alla kommentarobjekt, diagram och förklaringar. Välj objekten du vill infoga med menyalternativet Grafikläge i menyn Diagram, för att aktivera grafikläge. Se bilden nedan. Grafikläge Grafikläge När ett vyobjekt väl har valts i menyn Grafikläge kan du infoga det var som helst i aktuellt fönster. Dessutom kan du infoga hur många du vill av denna typ av objekt, till du väljer ett annat vyobjekt eller byter till ett annat läge. Den sammanhangsberoende menyn för grafikläge är samma som för dataläge.

Layoutläge

  Layoutläge väljes så snart du vill ändra storlek eller flytta objekt. Se Flytta och ändra storlek på vyobjekt.

  Du kan också ändra objektets lager eller gruppera ihop fler objekt via en sammanhangsberoende meny i layoutläge. Se Sammanhangsberoende meny i layoutläge för detaljinformation.

Dataläge

  Dataläge har redan introducerats i kapitel 3. Se information i motsvarande avsnitt. Observera att dataläge bara kan aktiveras när Kst är i ett muszoomläge.

Ikonen längst till höger på verktygsraden anger vilket läge den aktuella &kst;-sessionen använder. Klicka på ikonen för att snabbt byta till ett annat läge. Menyn som visas nedan dyker upp, och du kan välja läget du vill använda.

Lägesmeny Lägesmeny

I exemplet ovan använder Kst XY-muszoom, och det kommer att ändras till Layoutläge.

## Typer av vyobjekt

### Diagram

Diagram låter dig visa kurvor och bilder i &kst;. Dialogrutan för att redigera diagram ändrar diagrammets innehåll, utseende,, axlar och markörer. Högerklicka på ett diagram och välj menyalternativet Redigera... i den sammanhangsberoende menyn, eller använd vyhanteringen för att visa den. Det finns flera flikar:

- Innehåll

- Utseende

- X- och Y-axel

- Intervall

- Markörer

#### Innehållsflik

Fliken låter dig välja vilka av de tillgängliga diagramobjekten (kurvor, bilder, etc.) som ska visas i diagrammet. Flytta objekt mellan objektlistorna Tillgängliga och Visade med knapparna vänsterpil och högerpil. Ändra ordning som objekten ritas upp med knapparna uppåtpil och neråtpil.

Redigera diagram - Innehållsflik
Redigera diagram - Innehållsflik

#### Utseendefliken

Fliken låter dig justera färger, teckensnitt, förklaring och texter i ett diagram.

Redigera diagram - Utseendeflik
Redigera diagram - Utseendeflik

##### Färger och linjebredder

Axlar och bakgrund

  Färgerna för axlarna (förgrunden) och bakgrunden i diagrammet.

Linjebredd

  Linjebredden i bildpunkter.

Större och mindre rutnät

  Linjebredd och -färg för linjer som större och mindre rutnät består av. Använd flikarna X- och Y-axel för att aktivera rutnät för axlarna.

##### Texter

Skalärlista

  En lista med skalärer som för närvarande är definierade i &kst;. Listan används i huvudsak för att snabbt infoga värden i texten. Genom att välja ett objekt i listan infogas det på textmarkörens nuvarande position.

Rubrik

  Texten placerad lägst upp i diagrammet. Välj en teckenstorlek och skriv in rubrikens text med komponenterna på raden. Texten kan använda alla formateringsalternativ för verkliga textobjekt.

Justering

  Kombinationsrutan styr om rubriken placeras till vänster, höger eller centreras i diagrammets rubrikområde. X- och Y-axlarnas texter i ett diagram är alltid centrerade.

X- och Y-axlar

  Texten placerad vertikalt intill X- och Y-axeln i diagrammet. Välj en teckenstorlek och skriv in texten med komponenterna på raden. Texterna kan använda alla formateringsalternativ för verkliga textobjekt.

Siffror, Rotation: X och Rotation: Y

  Siffror som används för att markera både X- och Y-axeln i diagrammet. Storlek och vinkel kan anges för siffrorna. Positiva vinklar roterar texten medurs, medan negativa vinklar roterar texten moturs.

Automatisk text

  Klicka på den här knappen för att automatiskt skapa textvärden för alla texter i diagrammet. Texten för Rubrik blir en lista med sökvägar till datafilerna som används i diagrammet. Texten för Y-axel blir en lista med beskrivningar av beroende variabler (t.ex. Antal i område för ett histogram). Texten för X-axel blir namnet på vektorn som används som oberoende variabel.

Teckensnitt

  Teckensnittet som används för all text i diagrammet. Välj ett tillgänglig teckensnitt genom att använda kombinationsrutan.

##### Förklaring

Visa

  Markera rutan om du vill att diagrammet ska visa en förklaring.

Anpassa innehåll till diagram

  Markera rutan om du vill att diagrammet automatiskt ska justera förklaringen så att den motsvarar innehållet.

Redigera...

  Den här knappen öppnar dialogrutan Redigera förklaring, som visas nedan.

  Redigera förklaring

  Tillgängliga alternativ är:

  Titel

    Texten längst upp i förklaringen.

  Tillgängliga och visade objekt

    Det här låter dig välja en uppsättning objekt att visa i förklaringen, som skiljer sig från de som verkligen visas.

  Tillåt diagramdialogruta att återställa innehåll i förklaringar

    Om Anpassa innehåll till diagram inte markerades i dialogrutan Redigera diagram, och det här alternativet markeras, kan diagrammet genomdriva att förklaringen motsvarar dess verkliga innehåll.

  Teckensnitt, storlek, färg

    Formateringsalternativen för förklaringstexten.

  Rutan (Genomskinlig, Färger, Marginal, Kantbredd)

    Egenskaper för förklaringens kontur och ifyllnad.

##### Redigera flera

Klicka på Redigera flera, för en dialogruta som låter dig utföra ändringar av markerat diagram också i andra diagram. Förutom att välja objekt du vill redigera manuellt i dialogrutan, kan du skriva in namn på objekten i textrutan Filter. Jokertecken stöds.

#### X- och Y-axelflikar

Redigera diagram: X-axelflik
Redigera diagram: X-axelflik

##### Placering

Visa inte övre eller undre kant och text

  Markera rutan för att ta bort tomrummet längst upp eller längst ner i diagrammet.

##### Skala

Logaritmisk

  Markera kryssrutan om du vill använda logaritmisk skala för axeln.

Bas- och avståndsläge

  Aktiveras alternativet gör det att axlarnas texter läggs till med en förskjutning från en ursprunglig position, där den ursprungliga positionen visas lägst ner till vänster i diagrammet. De förskjutna texterna visas inom hakparenteser för att undvika förvirring.

Omvänd

  Gör att axlarnas riktning byts.

Tolka som: och Visa som:

  Om axlarna innehåller datum- eller tidsinformation kodat på ett svårläst sätt (t.ex. Julianskt datum), gör alternativet det möjligt att låta &kst; automatiskt konvertera det till något mer läsbart.

  ###### Datumformat i &kst;

  Datumformat | Beskrivning | Direktreferens
  Julianskt år | ett tidsintervall i astronomi bestående av exakt 365.25 dagar | Se definitionen i Wikipedia
  Standard C-tid | Tid som har förflutit sedan midnatt i början av 1:a januari 1970 |
  JD | Julianskt datum | Se definitionen av Julianskt datum
  MJD | Modifierat Julianskt dygn: Antal dygn som har förflutit sedan midnatt i början av onsdag 17 november 1858 | Se mer information i Wikipedia
  RJD | Reducerat Julianskt dygn | Se detaljinformation i Wikipedia
  TAI | Temps Atomique International (Internationell atomtid) | För mer information, se följande webbsida
  KDE:s korta datum och tid | Det har följande format: ÅÅÅÅ-MM-DD TT:MM:SS[sekunder]. t.ex. 1958-01-29 10:05:58[sekunder] |
  KDE:s långa datum och tid | Det har följande format: dag datum månad år TT:MM:SS[sekunder]. t.ex. onsdag 29 Januari 1958 10:05:58[sekunder] |

Transformera övre axel

  Att markera rutan gör att diagrammets övre axel betecknas enligt innehållet i uttrycksfältet. Variabeln X kan användas i uttrycksfältet för att ange värden i den undre X-axeln. För att till exempel rita upp den övre axeln som den undre axeln skalad med faktorn 2, skriv in `2*x` i uttrycksfältet.

##### Streckmarkeringar

Mellanrum

  Välj Grov, Fin, Normal, Mycket fin i kombinationsrutan för att bestämma vilken algoritm som &kst; använder för att bestämma antal större och mindre streckmarkeringar som ritas upp.

Små streck: och Automatiska små streck

  Genom att avmarkera Automatiska små streck, kan du tala om för &kst; hur många små streck som ska placeras mellan varje par av större streck. Antal större streck kan inte ställas in för hand.

Placera streck:

  Välj Inne i diagram, Utanför diagram eller Inne i och utanför diagram för att bestämma plats för strecken i förhållande till axlarna.

##### Rutmönster

Visa stora linjer och Visa små

  Markera rutorna om du vill att linjer ska ritas över diagrammet som sammanbinder stora och små streck på motsatta axlar.

##### Redigera Flera

#### Intervallfliken

Diagramaxlarnas inställningar anges under den här fliken. Axelinställningarna delas i två identiska delar: en X-axeldel och en Y-axeldel.

Redigera diagram: Intervallfliken
Redigera diagram: Intervallfliken

##### X- och Y-axel

Automatisk

  Markera det här alternativet för att låta &kst; automatiskt välja en skala för axeln baserat på högsta och lägsta värdena för axeln som hittas i de uppritade objekten.

Automatisk kant

  Alternativet beter sig på liknande sätt som Automatisk men axeln fylls ut med ett litet extra mellanrum. Det kan ibland förbättra utseendet hos diagram, och göra det enklare att se egenskaper nära intervallgränser.

Automatiskt uppåt

  Alternativet beter sig liknande som Automatisk men axelns övre gräns ökar bara, och axelns undre gräns minskar bara.

Automatisk skalning utan hänsyn till toppar

  Markera alternativet för att låta &kst; automatiskt välja skala för axeln baserat på värden som hittas i uppritade objekt. I allmänhet ignoreras toppar, eller plötsliga korta ökningar eller minskningar av värdet, när skalan bestäms. Alternativet är ofta för den beroende axeln (Y-axeln).

Centrerat medelvärde

  Välj alternativet för att centrera axlarna omkring medelvärdet för de värden som finns i diagrammet (X-värden används för att beräkna medelvärdet för X-axeln, och Y-värden används för att beräkna medelvärdet för Y-axeln). Ange axlarnas längd i textrutan Intervall.

Uttryck

  Ange undre och övre gräns för axlarna manuellt. Skriv in uttrycket för gränserna i textrutorna Från: och Till:. De kan vara numeriska värden eller ekvationer baserade på skalärerna som tillhandahålls av &kst;. Skalärerna kan snabbt läggas till i ett uttryck genom att välja dem i kombinationsrutorna till höger om textrutorna.

##### Redigera flera

#### Markörer

Nedan finns en skärmbild av fliken Markörer.

Redigera diagram: Markörfliken
Redigera diagram: Markörfliken

Diagrammarkörer tillhandahåller ett enkelt sätt att markera intressanta områden i ett diagram. Fliken Markörer ger möjlighet till fullständig hantering av diagrammarkörer och deras inställningar. Navigeringsfunktioner för diagrammarkörer beskrivs i avsnittet Menyn Panorera.

Placera muspekaren i diagrammet och tryck på tangenten Insert för att snabbt skapa diagrammarkörer i ett diagram. En vertikal linje ska visas som anger diagrammarkörens plats.

Ny och Lägg till

  Använd textfältet Ny för att manuellt skriva in ett diagrammarkörvärde. Värden kan skrivas in med på flyttalsform eller exponentform. Värden med exponentform måste skrivas in som `mEx` eller `mex`, där `m` är mantissan och `x` är exponenten. Ett sätt att skriva in värdet 15000 på exponentform är till exempel genom att mata in `1.5e4`.

  Klicka på knappen Lägg till för att skapa en ny diagrammarkör med angivet värde. Du blir varnad om en duplicerad diagrammarkör redan finns, eller om det inmatade värdet inte är giltigt. Observera att tillägg och borttagande av diagrammarkörer som görs under fliken Markörer inte verkställs om inte diagramdialogrutans inställningar verkställs.

Angivna diagrammarkörer, Ta bort och Ta bort alla

  Listan över befintliga diagrammarkörer för det här diagrammet listas under Angivna diagrammarkörer. För att ta bort diagrammarkörer, markera önskad markör i listan och klicka på knappen Ta bort. Flera markörer kan markeras för att tas bort genom att klicka och dra i listan, eller genom att hålla nere tangenterna Skift eller Ctrl och klicka på rader i listan. För att ta bort alla diagrammarkörer i diagrammet, klicka på knappen Ta bort alla. Observera att tillägg och borttagning av diagrammarkörer som görs under fliken Markörer inte verkställs om inte diagramdialogrutans inställningar verkställs.

Skapa markörer automatiskt

  Förutom individuellt definierade diagrammarkörer är det också möjligt att skapa diagrammarkörer baserade på en kurva. Markera kryssrutan Använd dataobjekt som källa för markörer och välj en kurva i kombinationsrutan för att använda ett kurvobjekt som diagrammarkör. Välj därefter kriterier att använda för att skapa diagrammarkörer. Att välja Stigande flank gör att diagrammarkörer skapas när den valda kurvans Y-värde ändras från noll till något annat. Att välja Fallande flank gör att diagrammarkörer skapas när den valda kurvans Y-värde ändras från något annat till noll. Att välja Båda gör att diagrammarkörer skapas både vid stigande och fallande flanker. I alla dessa fall används X-värdet för punkten i dataobjektet för att skapa en ny diagrammarkör, om det är skilt från noll.

  Om den valda kurvan senare uppdateras, skapas ytterligare diagrammarkörer om det behövs. Dock tas aldrig diagrammarkörer bort som en följd av ändringar av dataobjekt, så manuellt skapade diagrammarkörer påverkas aldrig.

  Det är också möjligt att skapa diagrammarkörer från en vektor. Aktivera kryssrutan Använd vektor som källa för markörer och välj en datavektor i kombinationsrutan. Denna vektors värden används nu som markörer.

Utseende

  Alternativen låter dig välja färg, linjetyp och bredd (tjocklek) för diagrammarkörer.

#### Använda klassen Plot i Kst-skript

Diagram i &kst; kan också hanteras av Kst-skript. Du kan ändra en diagramvy genom att ändra dess egenskaper definierade i klassen Plot, som förklaring, rubrik, X- och Y-axlar, etc.

Se klassen Plot i skriptkapitlet för detaljerad information. För att ändra en diagramvy måste du ofta använda klassen Plot tillsammans med andra klasser, som klassen Axis eller klassen Curve.

Exemplet nedan visar hur klassen Plot och klassen TimeInterpretation används för att tolka diverse datumformat i ett diagram.

##### Exempel på användning av klassen Plot för att tolka datumformat på X-axeln

    w = new Window();                 // skapa ett nytt fönster
    p = new Plot(w);                    // placera ett diagram i fönstret
    c = new Curve("tid","Y");         // använd vektorn tid och Y för att skapa en ny kurva
    c.tagName = "tid mot Y";
    p.curves.append(c);                            // för att visa kurvan i diagrammet
    p.xAxis.interpretation.input = 2;         // indatavektorn tid använder Julianskt datum.
                                              // 2 betyder Julianskt datum i klassen TimeInterpretation.
    p.xAxis.interpretation.output = 0;         // vektorn tid ska visa
                                               // formatet: DD/MM/ÅÅ TT:MM:SS.

    p.xAxis.interpretation.active = true;         // aktivera tolkningen

### Kommentarobjekt

Kommentarobjekt är Texter, Rutor, Ellipser, Linjer, Pilar och Bilder. De kan enkelt skapas genom att välja Grafikläge i menyn Diagram.

Kommentarmeny
Kommentarmeny

Högerklicka bara på ett kommentarobjekt och välj menyalternativet Redigera... i den sammanhangsberoende menyn, för att redigera ett kommentarobjekt.

Du måste vara i layoutläge för att flytta eller ändra storlek på ett kommentarobjekt.

### Texter

Egna texter att placeras på godtyckliga platser i &kst;s diagramfönster.

Redigera text
Redigera text

Det följande är förklaringar av dialogrutans element.

Skalärer

  En lista med skalärer som för närvarande är definierade i &kst;. Genom att välja ett objekt i kombinationsrutan infogas en referens till skalärens värde på markörens nuvarande plats i textvärdet.

Strängar

  En lista med strängar som för närvarande är definierade i &kst;. Genom att välja ett objekt i kombinationsrutan infogas en referens till strängens innehåll på markörens nuvarande plats i textvärdet.

Textvärde

  Textens värde som visas. Du kan skriva in text för hand i dialogrutan eller infoga referenser till den med kombinationsrutorna för skalärer och strängar. Texter i &kst; stöder många Latex formaterings- och symbolkommandon, inledda med det vanliga \. En lista med kommandon som stöds anges nedan:

  #### Latexkommandon som stöds i texter

  Kommando |  | Resultat
  --- | --- | ---
  \Greeklettername |  | Stora grekiska bokstäver, t.ex. \Gamma.
  \greeklettername |  | Små grekiska bokstäver, t.ex. \gamma, \delta.
  \approx |  | Ungefär lika med.
  \cdot |  | Centrerad punkt: produkt.
  \geq, \ge |  | Större än eller lika med.
  \leq, \le |  | Större än eller lika med.
  \t |  | Tabulatormellanrum.
  \n |  | Nyrad.
  \partial |  | Partiell derivata.
  \sqrt |  | Kvadratrot.
  \inf |  | Oändlighet.
  \int |  | Integral.
  \pm |  | Plus-minus tecken.
  \[, \] |  | Hakparentenser.
  \sum |  | Summatecken.
  \prod |  | N-vägs produkt.
  y^{x} |  | Skriver x som upphöjt.
  y_{x} |  | Skriver x som nersänkt.
  \textit{'text'} |  | Skriver 'text' med kursivstil.
  \textbf{'text'} |  | Skriver 'text' med fetstil.
  \underline{'text'} |  | Skriver 'text' understruken.
  \textcolor{'färg'}{'text'} |  | Skriver 'text' med 'färg'.

Teckensnitt

  Teckensnitt att använda för texten. Välj ett teckensnitt i kombinationsrutan.

Storlek

  Textens storlek. 0 (standardvärdet) motsvarar grovt en 12 bildpunkters storlek.

Rotation

  Antal grader som texten ska roteras. Positiva värden roterar texten medurs, medan negativa värden roterar texten moturs.

Teckenfärg

  Välj färg att använda för texten. Genom att klicka på knappen visas &kde;:s vanliga färgvalsdialogruta.

Precision

  När skalära variabler ingår i texter, anger precisionen antal siffror som visas.

Ruta

  Välj färg att använda för texten. Genom att klicka på knappen visas &kde;:s vanliga färgvalsdialogruta.

När du väl är nöjd med textinställningarna, klicka på Verkställ för att verkställa textinställningarna utan att stänga dialogrutan för textredigering. Klicka på Ok för att verkställa textinställningarna och stänga dialogrutan. Du kan istället klicka på Stäng för att stänga dialogrutan för textredigering utan att verkställa några textinställningar.

### Rutor och ellipser

Kommentarobjekten ruta och ellips används oftast för att markera viktiga egenskaper i ett diagram.

Det följande är förklaringar av dialogrutans element.

Kantfärg

  Färgen på kanten av rutan eller ellipsen. Genom att klicka på knappen visas &kde;:s vanliga färgvalsdialogruta.

Kantbredd

  Bredden på kommentarens linje eller kant (i bildpunkter).

Fyllfärg och Genomskinlig ifyllnad

  Färgen på innehållet i rutan eller ellipsen. Genom att klicka på knappen visas &kde;:s vanliga färgvalsdialogruta. Om du väljer Genomskinlig ifyllnad går det att se igenom rutan eller ellipsen.

X- och Y-rundning

  Alternativen gäller bara för rutor. De avgör bråkdelen rundning av rutans hörn. Värdet 0 ger vanliga hörn (rätvinkliga), medan värdet 99 ger en maximalt avrundad ruta (en ellips). För mer information om alternativen, se Qt-dokumentationen om QPainter::drawRoundRect.

### Linjer och Pilar

Linje- och pilobjekt används ofta för att markera viktiga egenskaper i ett diagram (genom att till exempel peka ut en viss topp).

Det följande är förklaringar av dialogrutans element.

Linjefärg

  Linje- eller pilobjektets färg. Genom att klicka på knappen visas &kde;:s vanliga färgvalsdialogruta.

Linjestil

  Här kan du välja att göra linjen heldragen, streckad, punkt-streckad, etc.

Linjebredd

  Linjens bredd (i bildpunkter). Den ändrar också huvudets storlek för pilobjekt.

Pil i början och Pil i slutet

  Bestämmer var pilhuvudet ska placeras. Huvuden pekar alltid bort från linjen.

Skalning för pil i början

  En skalfaktor för pilhuvudens storlekar. Det kan vara användbart om linjebredden leder till en huvudstorlek som är större än du skulle vilja ha.

### Bilder

Bildobjekt kan användas för att enkelt lägga till extern grafik i diagrammet. De flesta populära bildformat stöds, beroende på vilka bibliotek som är installerade på systemet.

Redigera linje
Redigera linje

Det följande är förklaringar av dialogrutans element.

Kantfärg

  Färgen på kanten av rutan eller ellipsen. Genom att klicka på knappen visas &kde;:s vanliga färgvalsdialogruta.

Kantbredd

  Bredden på kommentarens linje eller kant (i bildpunkter).

Behåll proportion

  Om rutan är markerad, behåller &kst; förhållandet mellan bildens bredd och höjd när bildobjektets storlek ändras. Du kan tillfälligt inaktivera (eller aktivera) alternativet genom att hålla nere skifttangenten medan bildens storlek ändras.

Filsökväg

  Platsen för bilden som du vill visa.

Uppdateringstid

  Ställ in det här till perioden (i sekunder) som du vill att &kst; ska använda för att kontrollera om bildfilen har uppdaterats, och ladda in den igen om det behövs. Om uppdateringstiden ställs in till 0, laddas bilden bara in igen när &kst; startas om eller bildobjektets redigeringsdialogruta öppnas och stängs.

### Att använda Kst-skript för att hantera kommentarobjekt

Du kan skapa och redigera kommentarobjekt med motsvarande klasser i Kst-skript. Se detaljinformation i

- Klassen Label

- Klassen Box

- Klassen Ellipse

- Klassen Line

- Klassen Arrow

- Klassen Picture

För att ändra en allmän egenskap hos ett kommentarobjekt kan du använda metoder och egenskaper definierade i klassen ViewObject, superklassen till alla kommentarobjekt.

#### Funktion för att skapa och ändra storlek på kommentarobjekt

Om du använder koden nedan för att skapa ett kommentarobjekt, till exempel en ruta i fliken W1:

    b = new Box("W1");

kanske du märker att ingenting syns i W1. Dock har den nya rutan skapats. Den har en mycket liten storlek, och finns på positionen (0,0), i &kst;-fönstrets övre vänstra hörn. Därför är det nödvändigt att flytta den och ändra storleken för att den ska bli synlig. Observera att du måste ändra förvalda inställningar för varje kommentarobjekt du skapar, så det kan vara bekvämare att göra det med en funktion i Kst-skript. Nedan visas ett exempel på en funktion som skapar ett användardefinierat kommentarobjekt, och därefter ändrar objektets storlek och flyttar det till position (250,250) i det användarspecificerade fönstret.

    // annotation.js
    // A(sträng) är namnet på ett kommentarobjekt
    // W(sträng) är namnet på ett fönster
    function createAnot(A, W)
    {
    // deklarera strängar för att lagra namn på möjliga kommentarobjekt
    lb = new String();
    lb.value = "Label";
    b  = new String();
    b.value = "Box";
    e = new String();
    e.value = "Ellipse";
    l = new String();
    l.value = "Line";
    a = new String();
    a.value = "Arrow";
    input = new String(); // deklarera en sträng för att lagra namnet på det användardefinierade kommentarobjektet
    input.value = A;
    // skapa det användardefinierade kommentarobjektet och ändra storlek på det för att göra det synligt
    if(input.value==lb.value)
    {
    anot = new Label(W);
    anot.tagName = "new Label";
    anot.resize(new Size(100,100));
    anot.text = "Skriv in text här";
    }

    else if(input.value==b.value)
    {
    anot = new Box(W);
    anot.tagName = "new Box";
    anot.resize(new Size(100,100));
    }
    else if(input.value==e.value)
    {
    anot = new Ellipse(W);
    anot.tagName = "new Ellipse";
    anot.resize(new Size(100,100));
    }
    else if(input.value==l.value)
    {
    anot = new Line(W);
    anot.tagName = "new Line";
    anot.to = new Point(100,100);
    anot.width = 2;
    }
    else
    {
    anot = new Arrow(W);
    anot.tagName = "new Arrow";
    anot.toArrow = true;
    anot.to= new Point(100,100);
    }
    // flytta kommentarobjektet till position (250,250)
    anot.move(new Point(250,250));
     }

Efter att ha laddad funktionsskriptet i Kst, kan du skapa ett redigerat kommentarobjekt på detta sätt:

    createAnot("Label","W1");

## Zoomning och panorering

Zoomning och panorering i diagram är enkla och intuitiva med &kst;. Följande avsnitt beskriver de olika zoomnings- och panoreringslägena.

### Muszoomlägen

För att komma åt olika zoomlägen, välj något av alternativen XY-muszoom, X-muszoom eller Y-muszoom i menyn Diagram. De olika lägena beskrivs nedan.

#### XY-muszoom

Med XY-muszoomläge kan du zooma till ett särskilt rektangulärt område i diagrammet genom att helt enkelt klicka och dra en rektangel där du önskar. Diagrammets X- och Y-axlar ändras för att motsvara den nya skalan. Läget är ofta användbart för att snabbt titta på ett intressant område i diagrammet utan att exakt behöva ange skalan på axlarna.

#### X-muszoom

Med X-muszoomläge är Y-axeln fast. Inzoomning utförs genom att klicka och dra ett rektangulärt område, dock är övre och undre gränsen för rektangeln alltid lika med de nuvarande övre och undre gränserna för Y-axeln. Läget är ofta användbart för att titta på ett visst tidsområde, om X-axeln råkar representera en tidsvektor.

Du kan snabbt byta till X-muszoomläge genom att hålla nere Ctrl. Muspekaren ändras för att ange det nya läget. Genom att släppa Ctrl återgår du till föregående muszoomläge.

#### Y-muszoom

Med Y-muszoomläge är X-axeln fast. Inzoomning utförs genom att klicka och dra ett rektangulärt område, dock är övre och undre gränsen för rektangeln alltid lika med de nuvarande övre och undre gränserna för X-axeln. Läget är ofta användbart för att zooma in för data som är koncentrerat omkring en horisontell linje.

Du kan snabbt byta till Y-muszoomläge genom att hålla nere Skift. Muspekaren ändras för att ange det nya läget. Genom att släppa Skift återgår du till föregående muszoomläge.

### Sammanhangsberoende meny för zoomläge

I något av muszoomlägena, visas några särskilda zoomalternativ vid högerklick på ett diagram, förutom de vanliga alternativen i den sammanhangsberoende menyn.

Sammanhangsberoende zoommeny
Sammanhangsberoende zoommeny

Maximera

  Utökar tillfälligt diagrammet så att det upptar hela fönstrets yta. Avmarkera alternativet för att låta diagrammet återgå till sin tidigare storlek.

Paus

  Gör paus i automatisk uppdatering av realtidsdata. Menyalternativet duplicerar funktionen hos Paus i menyn Intervall.

Matcha axlar

  Alternativen låter dig snabbt ändra axlarna i ett diagram för att matcha dem i ett annat diagram. Skalorna för både X- och Y-axeln i det nuvarande diagrammet kommer att ändras för att matcha dem i diagrammet du väljer i undermenyn. Observera att det inte binder ihop axlarnas skalor permanent. Ändras zoomningen av endera diagrammet gör att skalorna inte lägre matchar. För att binda ihop axlarnas skalor i två eller flera diagram, använd funktionen Bunden zoom.

Matcha X-axel

  Alternativet låter dig snabbt ändra X-axeln i ett diagram för att den ska motsvara den i ett annat diagram, på liknande sätt som undermenyn Matcha axlar.

Zooma (undermeny)

  Undermenyn Zooma beskrivs i avsnittet som heter Menyn Zooma.

Panorera (undermeny)

  Menyn beskrivs i avsnittet som heter Menyn Panorera.

Redigera (undermeny)

  Undermenyn visar en lista med objekt som är tillgängliga för redigering i det underliggande diagrammet. Genom att klicka på ett objektnamn i undermenyn visas objektets redigeringsdialogruta.

Anpassning (undermeny)

  Undermenyn visar en lista med kurvor som kan anpassas. Genom att välja ett namn i undermenyn visas dialogrutan Nytt insticksprogram som låter dig välja ett insticksprogram för anpassning. Indatavektorerna är förbestämda baserat på kurvan som väljes.

Filtrera (undermeny)

  Undermenyn visar en lista med dataobjekt som kan filtreras. Genom att välja ett namn i undermenyn visas dialogrutan Nytt insticksprogram som låter dig välja ett insticksprogram för filtrering. Indatavektorerna som ska filtreras är förbestämda baserat på kurvan som väljes. Dessutom kan kurvans egenskaper för utseende ändras, eftersom funktionen Filtrera skapar vektorer, och kurvor baserade på vektorerna.

Ta bort (undermeny)

  Den här undermenyn visar en lista med kurvor som för närvarande finns i diagrammet. Att klicka på ett kurvnamn i undermenyn tar bort kurvan från diagrammet (själva kurvan tas dock inte bort som ett dataobjekt).

### Menyn Zooma

Menyn Zooma kan kommas åt genom att högerklicka på ett diagram och välja undermenyn Zooma i den sammanhangsberoende menyn. En lista med zoomalternativ och motsvarande snabbtangenter visas. Dessa alternativ beskrivs nedan.

Zoomåtgärd | Snabbtangent | Beskrivning
--- | --- | ---
Zooma maximalt | M | Ställer in både X-axelns och Y-axelns skalor så att alla datapunkter visas. Det motsvarar inställningen Automatisk skalning i diagramdialogrutan.
Zooma maximalt utan hänsyn till toppar | S | Ställer in både X-axelns och Y-axelns skalor så att de flesta datapunkter visas. Toppar, eller snabba ökningar eller minskningar i X- eller Y-värden, undantas från diagramvisningen.
Föregående zoomning | R | Återgår till den senast använda zoominställningen.
Zooma centrerat medelvärde i Y-led | A | Ändrar Y-axeln så att medelvärdet för Y-värden i diagrammet centreras vertikalt. Själva zoomnivån ändras inte.
Zooma maximalt i X-led | Ctrl M | Ställer in X-axelns skala så att X-värden för alla datapunkter är mellan minimum och maximum för X-axeln. Y-axelns skala är oförändrad.
Zooma ut i X-led | Skift Högerpil | För en icke-logaritmisk X-axel, ökar X-axelns längd ungefär med faktorn 0,5, utan att ändra X-axelns mittpunkt. Y-axelns skala är oförändrad.
Zooma in i X-led | Skift Vänsterpil | För en icke-logaritmisk X-axel, minskar X-axelns längd ungefär med faktorn 0,5, utan att ändra X-axelns mittpunkt. Y-axelns skala är oförändrad.
Normalisera X-axeln till Y-axeln | N | Ställer in X-axelns längd så att den är lika lång som Y-axeln, och behåller nuvarande centrum.
Växla log för X-axel | G | Aktivera eller inaktivera en logaritmisk skala för X-axeln.
Zooma maximalt i Y-led | Skift M | Ställer in Y-axelns skala så att Y-värden för alla datapunkter är mellan minimum och maximum för Y-axeln. X-axelns skala är oförändrad.
Zooma ut i Y-led | Skift Uppåtpil | För en icke-logaritmisk Y-axel, ökar Y-axelns längd ungefär med faktorn 0,5, utan att ändra Y-axelns mittpunkt. X-axelns skala är oförändrad.
Zooma in i Y-led | Skift Neråtpil | För en icke-logaritmisk Y-axel, minskar Y-axelns längd ungefär med faktorn 0,5, utan att ändra Y-axelns mittpunkt. X-axelns skala är oförändrad.
Normalisera Y-axeln till X-axeln | Skift+N | Ställer in Y-axelns höjd så att den är lika lång som X-axeln, och behåller nuvarande centrum.
Växla log för Y-axel | L | Aktivera eller inaktivera en logaritmisk skala för Y-axeln.
Skala | I | Har bara effekt i avbilden. Gå igenom extremvärden i avbildsmatrisen cykliskt för att definiera om tröskelvärden i avbildens skala varje gång. Syftet är att låta användaren se avbildens mellanliggande värden.

Många av zoomåtgärderna används bäst tillsammans med diverse muszoomlägen.

### Menyn Panorera

Funktioner för att panorera ett diagram är tillgängliga genom att högerklicka i diagrammet och välja undermenyn Panorera i den sammanhangsberoende menyn. De flesta panoreringsfunktioner och deras snabbtangenter bör vara självförklarliga. För att snabbt gå till en diagrammarkör, välj Nästa markör (för att gå åt höger) eller Föregående markör (för att gå åt vänster). För mer information om diagrammarkörer, se avsnittet Markörer i dialogrutan Redigera diagram.

Med antagandet att icke-logaritmiska skalor används, panorerar varje funktion diagrammet i angiven riktning med 0,1 av X-axelns nuvarande längd (vid panorering åt vänster eller höger), eller 0,25 av Y-axelns nuvarande längd (vid panorering uppåt eller neråt).

Du kan också panorera vänster eller höger i ett diagram genom att använda mushjulet (om det är tillgängligt).

För att snabbt gå framåt eller bakåt längs X-axeln, välj Bakåt en skärm eller Framåt en skärm i menyn Intervall. Respektive snabbtangenter Ctrl Vänsterpil och Ctrl Högerpil kan också användas.

### Bunden zoom

När du tittar på två eller flera samhörande diagram (till exempel två kurvor i olika diagram som båda beror på samma tidsvektor), kan det ibland vara användbart att zooma eller panorera diagrammen samtidigt. Det är möjligt med funktionen bunden zoom i &kst;. För att aktivera bunden zoom, klicka på de små fyrkanterna i övre högra hörnet på diagrammen du vill binda ihop. Fyrkanterna ändrar färg för att ange att diagrammen är bundna, som visas nedan.

Överdelen av diagramdialogrutan
Överdelen av diagramdialogrutan

Zoomnings- och panoreringsåtgärder som utförs i ett diagram av en grupp med bundna diagram utförs för alla diagram i gruppen. För att ta bort ett diagram från den bundna gruppen, klicka helt enkelt på den lilla fyrkanten i diagrammets övre högra hörn igen. Fyrkanten blir genomskinlig för att ange att diagrammet inte är bundet.

För att snabbt binda eller lösgöra alla diagram (inklusive diagram i andra fönster), välj Bunden zoom i menyn Diagram, eller motsvarande ikon Bunden zoomikon i &kst;s verktygsrad.

## Hantera diagramlayout

Vyobjekt i ett &kst;-fönster är arrangerade i lager. Varje objekt placeras i ett lager, och varje lager innehåller bara ett objekt. På så sätt kan objekt överlappa, med diagram i högre lager har förtur i synlighet jämfört med de i undre lager. Layoutläge måste vara aktiverat för att ändra diagramlayout i &kst;. Layoutläge kan ändras genom att välja Layoutläge i menyn Diagram.

### Flytta och ändra storlek på vyobjekt

Att flytta och ändra storlek på vyobjekt i layoutläge görs på liknande sätt som man flyttar och ändrar storlek på vanliga fönster. För att flytta ett diagram, klicka helt enkelt var som helst på önskat diagram och dra diagrammet. En kontur av diagrammet visas, som anger var diagrammet kommer att placeras, som visas i följande bild.

flyttkontur

Man kan dra diagram var som helst inne i det aktuella fönstret. För att ändra storlek på ett diagram, flytta muspekaren till någon kant eller något hörn av diagrammet. Markören ändras för att ange att diagrammets storlek kan ändras. Klicka och dra diagrammets kontur till det har önskad form och storlek.

### Sammanhangsberoende meny i layoutläge

När layoutläge är aktiverat, visas den grundläggande sammanhangsberoende menyn vid högerklick på något vyobjekt, med flera ytterligare alternativ. Tillgängliga alternativ i menyn listas nedan.

Sammanhangsberoende layoutmeny
Sammanhangsberoende layoutmeny

Höj

  Höjer diagrammet ett lager uppåt.

Sänk

  Sänker diagrammet ett lager neråt.

Höj överst

  Höjer diagrammet till översta lagret, vilket garanterar att den är synlig.

Sänk underst

  Sänker diagrammet till det understa lagret.

Flytta till

  Genom att välja ett fönsternamn i den här undermenyn flyttas diagrammet till fönstret med motsvarande namn.

Kopiera till

  Genom att välja ett fönsternamn i undermenyn kopieras diagrammet till fönstret med motsvarande namn.

Om flera vyobjekt väljes i dataläge, blir ytterligare alternativ tillgängliga i den sammanhangsberoende menyn.

### Markera flera vyobjekt och gruppera

Två eller flera vyobjekt kan markeras tillsammans i layoutläge. Håll nere skifttangenten och klicka antingen i tur och ordning på objekten du vill markera, eller dra en rektangel omkring en grupp objekt, för att markera dem. De markerade objekten anges av hörnmarkeringar. Att markera flera objekt låter dig flytta dem samtidigt genom att dra något av de enskilda objekten som ingår i markeringen. Dessutom innehåller den sammanhangsberoende menyn i layoutläge tre ytterligare alternativ när flera objekt är markerade. Alternativen beskrivs nedan.

Välj flera
Välj flera

Kondensera markerade

  Alternativet är tillgängligt om vyobjekten som är markerade alla är diagram. Att välja alternativen X-axel eller Y-axel i undermenyn tar antingen bort X-axeln i det översta diagrammet eller de översta diagrammen, eller Y-axeln i diagrammet eller diagrammen längst till höger. Observera att alternativet inte ändrar skala på data i diagrammet, alltså måste hänsyn tas till att originalaxlarna är identiska om den enda kvarvarande axeln ska representera båda diagrammen.

Gör lika

  Ändrar storlek på alla markerade objekt i vald dimension eller valda dimensioner för att matcha dimensionerna för vyobjektet där den sammanhangsberoende menyn aktiverades. Genom att till exempel högerklicka på ett diagram i gruppen och välja Bredd i undermenyn Gör lika matchar bredden hos alla diagram med bredden hos det första diagrammet. Om Storlek väljes, ändras både bredd och höjd hos varje markerat objekt.

Justera

  Justerar alla markerade objekt till objektet direkt under den sammanhangsberoende menyn. Välj bland Vänster, Höger, Överst eller Underst.

Packa (undermeny)

  Undermenyn Packa innehåller två alternativ. Packa horisontellt delar upp objektgruppens hela bredd jämt mellan de enskilda objektens bredd, medan Packa vertikalt delar upp gruppens hela höjd jämnt mellan de enskilda höjderna. Att packa diagram ger oftast ett staplat eller rutigt mönster. Använd funktionen Rensa layout i layoutlägets sammanhangsberoende meny, för att arrangera diagrammen i ett rutnät.

Gruppera objekt

  Grupperar ihop alla markerade objekt. Storleken på en grupp vyobjekt kan ändras eller den kan flyttas som en helhet på samma sätt som ett objekt kan ändras. Grupperade diagram förblir grupperade även utanför layoutläge, så funktionerna Maximera eller Ta bort i diagrammets sammanhangsberoende meny kan användas för en hel diagramgrupp.

  För att dela upp en grupp, klicka helt enkelt på gruppen och välj Dela upp.

## Vyverktyg

### Fönsterflikar

&kst; tillåter att flikar används för att organisera diagram i separata fönster för effektiv visning och behandling.

För att byta mellan diagramfönster i fliksidläge, kan du klicka på flikarna som motsvarar varje fönster, som visas nedan.

Byta fönster i fliksidläge
Byta fönster i fliksidläge

- Välj Arkiv Ny flik eller högerklicka på flikraden och välj Ny... i den sammanhangsberoende menyn som visas, för att skapa en ny flik.

- Flikarnas sammanhangsberoende menyer låter dig skapa, ta bort och byta namn på flikar, samt ändra deras ordning.

  Byta fönster i fliksidläge

### Verktygsraden

Verktygsraden tillhandahåller snabbåtkomst till menyfunktioner som ofta används i &kst;. För att visa verktygsraden, välj Inställningar Visa verktygsrad.

Verktygsrad

Verktygsradens meny, som kan kommas åt genom att högerklicka var som helst i verktygsraden, innehåller alternativ för att ändra verktygsradens utseende och plats.

### Tilldela kurvfärg från fil

Dialogrutan låter dig tilldela färger till kurvor baserat på filen som data kommer ifrån. Du kan komma åt den genom att välja menyalternativet Verktyg Tilldela kurvfärg per fil....

Dialogrutan visar en lista med datafiler och färgval som för närvarande används. Välj färgerna du vill använda, och markera alternativknappen X-vektor eller Y-vektor baserat på om du vill att kurvorna ska färgläggas baserat på datafilen för deras X- eller Y-vektor, om X- och Y-vektorerna för en kurva kommer från två olika datafiler. Klicka därefter på Ok.

Om Använd för nya kurvor är markerad, används också det valda färgmönstret för kurvor som skapas senare från dessa datafiler.

### Skilj mellan kurvor

Dialogrutan låter dig enkelt göra uppritade kurvor visuellt urskiljbara genom att cykliskt gå igenom egenskaperna stil, färg och bredd. Du kan komma åt den genom att välja menyalternativet Verktyg Skilj mellan kurvor....

För att använda dialogrutan, flytta en delmängd av egenskaperna för kurvor till listan med valda egenskaper. De gås igenom i den ordning de visas i listan med valda egenskaper.

När linjebredd gås igenom, måste en maximal linjebredd anges. Kurvorna går därefter från bredd 1 till det maximala värdet.

Alternativet Upprepa över låter dig göra urskiljningen separat för varje diagram (Enstaka diagram), separat för varje fönster (Enstaka fönster), eller kontinuerligt för Alla fönster.

Alternativen under Verkställ för låter dig bestämma om urskiljningen ska utföras i Alla fönster, eller bara i Aktuellt fönster.

Klicka på Ok eller Verkställ för att utföra urskiljningen, eller Avbryt för att avbryta.