# Handbok Dumpa skärmen

## Inledning

Dumpa skärmen är ett enkelt miniprogram för att spara skärmbilder. Det kan antingen fånga bilder av hela skrivbordet, ett enda fönster eller ett markerat område. Bilderna kan därefter sparas med ett antal olika format.

Var snäll rapportera eventuella problem eller önskemål till KDE:s felhanteringssystem

## Att använda Dumpa skärmen

Det här kapitlet beskriver användning av Dumpa skärmen för att fånga skärmbilder.

### Att starta Dumpa skärmen

Dumpa skärmen kan startas på ett av flera olika sätt som beskrivs nedan.

- Du kan starta Dumpa skärmen genom att välja det från undermenyn Bild i panelen.

- Du kan starta Dumpa skärmen genom att skriva in följande kommando på kommandoraden.

      % ksnapshot &

- Minikommandoraden (som startas med &Alt;F2) kan också användas för att starta Dumpa skärmen.

När Dumpa skärmen startar, kommer du att se ett fönster som liknar det här: Dumpa skärmen förhandsgranskningsfönster

### Att dumpa skärmen

Dumpa skärmen fångar en bild av hela skrivbordet omedelbart efter den har startat, men innan den visas på skärmen. Det här låter dig snabbt skapa skärmbilder av hela skrivbordet.

Bilden som tagits av Dumpa skärmen visas i förhandsgranskningsfönstret, som är placerat i övre vänstra delen av Dumpa skärmens programfönster. Nedanför visas ett exempel av förhandsgranskningsfönstret i Dumpa skärmen. Förhandsgranskningen kommer att variera beroende på vad som visas på skrivbordet.

Dumpa skärmen förhandsgranskningsfönster

Bilden kan sparas genom att klicka på knappen Spara som.... Om flera bilder tas, ökas filnamnet automatiskt för att förhindra att du skriver över tidigare bilder. Du kan dock redigera filnamnet till vad du vill, inklusive namnet på en tidigare sparad bild.

För att ta en bild av ett ensamt fönster, välj alternativet Fönster under markör i kombinationsrutan (intill beteckningen Dumpläge) och klicka därefter på knappen Ny skärmdump.

Beroende på inställningen av Fördröjning för skärmdump, får du antingen ett kors som muspekare (vid Ingen fördröjning), eller en vanlig muspekare som du kan använda för att arbeta med ett program till fördröjningen har gått ut och en skärmdump sker.

Med Ingen fördröjning, sker skärmdumpen omedelbart när du klickar i ett fönster.

Dumpa skärmen visar den nya skärmdumpen i förhandsgranskningsområdet, då du kan välja att spara den nya bilden (genom att trycka på Spara som...) eller skapa en ny genom att trycka på knappen Ny skärmdump.

För att ta en ny bild av hela skrivbordet, välj alternativet Fullskärm i kombinationsrutan (intill beteckningen Dumpläge) och klicka därefter på knappen Ny skärmdump. Dumpa skärmen fångar nu hela skrivbordet när du klickar på Ny skärmdump.

På liknande sätt, för att ta en skärmdump av ett område, välj alternativet Område i kombinationsrutan (intill beteckningen Dumpläge), ställ in Fördröjning för skärmdump till Ingen fördröjning, och klicka därefter på knappen Ny skärmdump. Muspekaren ändras till ett kors, och därefter kan du använda musen för att markera området du vill fånga.

### Ytterligare funktioner

#### Fördröjning för skärmdump

Rutan Fördröjning för skärmdump låter dig skriva in en godtycklig tidsfördröjning i sekunder, från det tillfälle då du klickar på knappen Ny skärmdump till bilden tas.

När en fördröjning har ställts in, behöver du inte klicka med musknappen för att fånga en bild. Det här gör det möjligt att öppna en meny, och ta en bild av den.

#### Undanta fönsterram

Inkludera fönsterram är normalt aktiverad.

När du bara vill få med själva programmet utan omgivande fönsterram, inaktivera det här alternativet och gör en ny skärmdump.

#### Skriv ut

När du vill skriva ut skärmdumpen från förhandsgranskningen, klicka bara på Skriv ut..., så visas KDE:s vanliga utskriftsdialogruta, där du direkt kan skriva ut skärmdumpen.

#### Knappar

Det finns ytterligare två knappar placerade längst ner i Dumpa skärmens fönster. Deras funktion beskrivs nedan.

Hjälp

- Ger en meny där du kan visa &ksnapshot;-handbok, rapportera ett fel eller få mer information om &kde; och &ksnapshot;.

Avsluta

- Stänger Dumpa skärmen programmet.

## &DCOP;-gränssnitt

&ksnapshot; kan styras via skript med &DCOP;-gränssnittet. Det här kapitlet förklarar de olika &DCOP;-anropen som kan användas, och tillhandahåller några exempel på hur de används.

Som med alla DCOP-anrop, måste du ange programmet som du vill påverka, och det specifika gränssnittet. För Dumpa skärmen måste du ange det specifika programmet, som är `ksnapshot` följt av processnumret.

För att starta Dumpa skärmen och hämta rätt väljare, använd `dcopstart ksnapshot`, som returnerar väljaren (såsom `ksnapshot-20594`) på standardutmatningen.

Du kan få en lista med tillgängliga &DCOP;-gränssnitt, för att använda rätt väljare, som visas i exemplet:

    $ dcop `dcopstart ksnapshot` interface
    QCStringList interfaces()
    QCStringList functions()
    QString url()
    void slotGrab()
    void slotPrint()
    void slotSave()
    bool save(QString filename)
    void slotSaveAs()
    void slotCopy()
    void setTime(int newTime)
    int timeout()
    void setURL(QString newURL)
    void setGrabMode(int grab)
    int grabMode()
    void slotMovePointer(int x,int y)
    void exit()

I följande exempel är processen alltid `ksnapshot-23151`.

### Åtkomst av inställningarna med &DCOP;

För var och en av inställningarna som du kan ändra via det grafiska gränssnittet kan du både hämta inställningens nuvarande värde, och ändra inställningen, via &DCOP;.

Du kan hämta nuvarande dumpläge med anropet `grabMode`, som visas nedan:

    $ dcop ksnapshot-23151 interface grabMode

Det returnerar `0` för fullskärm, `1` för fönster och `2` för område.

Du kan ställa in dumpläget med `setGrabMode`, som kräver ett argument som identifierar läget som önskas (som i anropet `grabMode`). Du kan alltså ställa in fönsterdumpläge (`1`) med:

    $ dcop ksnapshot-23151 interface setGrabMode 1

Du kan hämta nuvarande fördröjningsinställning (det grafiska objektet Fördröjning för skärmdump:) med anropet `timeout`, som visas nedan:

    $ dcop ksnapshot-23151 interface timeout

Det returnerar fördröjningen i sekunder, eller noll om det inte finns någon fördröjning (klicka för att dumpa).

Du kan ställa in fördröjningen med `setTime`, som kräver ett argument som identifierar fördröjningens längd. Du kan alltså ställa in fördröjningen 4 sekunder med:

    $ dcop ksnapshot-23151 interface setTime 4

Du kan hämta sökvägen där skärmdumpen sparas med anropet `url`, som visas nedan:

    $ dcop ksnapshot-23151 interface url

Det returnerar filnamnet som en webbadress (t.ex. som `file:///home/bradh/test2.png`).

Du kan ställa in sökvägen med kommandot `setURL`, som kräver ett strängargument som identifierar den nya sökvägen. Du kan alltså ställa in sökvägen till `file:///home/bradh/skärmbild.jpg` med:

    $ dcop ksnapshot-23151 interface setURL file:///home/bradh/skärmbild.jpg

### Ta skärmdumpar med &DCOP;

Nyckeln till att ta en skärmdump med &DCOP; är att använda kommandot `slotGrab`, som visas nedan:

    $ dcop ksnapshot-23151 interface slotGrab

Det tar en skärmdump med de nuvarande inställningarna av dumpläge och fördröjning (som beskrivs ovan). Om du vill spara skärmdumpen som en bild finns det ett antal anrop du kan använda. Om du bara vill spara bilden med nuvarande sökväg (som returneras av `url` eller ändras av `setURL`), kan du anropa `slotSave`, som visas nedan:

    $ dcop ksnapshot-23151 interface slotSave

Om du vill att användaren ska kunna ange ett filnamn (och sökväg), kan du använda `slotSaveAs`, som visar &kde;:s vanliga dialogruta för att spara filen.

Om du vill spara bilden med ett annat namn (eller annan sökväg) utan att ändra sökvägen med `setURL`, kan du använda `save`, och ange webbadressen att spara till som ett argument. Om du alltså vill spara skärmdumpen som `file:///tmp/temporärbild.png`, kan du göra följande:

    $ dcop ksnapshot-23151 interface save file:///tmp/temporärbild.png

Observera att detta returnerar sant om skärmbilden sparades med lyckat resultat, och falskt annars. Du bör också vara medveten att om filen redan finns, visas &kde;:s vanliga dialogruta som kräver att användaren bestämmer om filen ska skrivas över eller inte.

Förutom att spara skämdumpen kan du också kopiera den till klippbordet med kommandot `slotCopy`, som visas nedan:

    $ dcop ksnapshot-23151 interface slotCopy

Om du behöver välja ett fönster som inte är under muspekaren, kan du använda anropet `slotMovePointer`, och skicka med x-position (i bildpunkter) och y-position (också i bildpunkter) som argument. För att flytta musen till skärmens övre vänstra hörn (0, 0), kan du använda följande:

    $ dcop ksnapshot-23151 interface slotMoveMouse 0 0

### Skriva ut skärmdumpar med &DCOP;

Du kan skriva ut nuvarande skärmdump (som antingen har sparats eller inte) med kommandot `printSlot`, som visas nedan:

    $ dcop ksnapshot-23151 interface slotPrint

Observera att detta visar &kde;:s normala utskriftsdialogruta, som kan kräva interaktion av användaren.

### Styrning av programmet med &DCOP;

Du kan få Dumpa skärmen att avslutas genom att använda kommandot `exit` som visas nedan.

    $ dcop ksnapshot-23151 interface exit

## Tack till och licens

Program copyright

- 1997-2000 Richard J. Moore rich@kde.org

- 2000 Matthias Ettrich ettrich@kde.org

Dokumentation baserad på originalet, copyright 1997-2000 Richard J. Moore rich@kde.org

Översättning Stefan Asserhäll stefan.asserhall@comhem.se

&underFDL; &underGPL;
&documentation.index;