# &ksnapshot;-håndbogen

## Indledning

&ksnapshot; er et simpelt program til at tage skærmbilleder. Det kan indfange billeder, enten af hele desktoppen eller blot et enkelt vindue eller valgt område. Billederne kan så gemmes i forskellige formater.

Rapportér venligst problemer eller ønsker om nye egenskaber til KDE's fejlretningssystem

## Brug af &ksnapshot;

Dette kapitel beskriver brugen af &ksnapshot; til at indfange skærmbilleder.

### Start af &ksnapshot;

&ksnapshot; kan startes på en af adskillige måder beskrevet nedenfor.

- Man kan starte &ksnapshot; ved at vælge det fra Grafik undermenuen i panelet.

- Man kan starte &ksnapshot; ved at indtaste følgende på kommandolinjen:

      % ksnapshot &

- Mini kommandolinjen (der hentes med &Alt;F2) kan også bruges til at starte &ksnapshot;

Når &ksnapshot; starter, ser du et vindue som dette: &ksnapshot; Forhåndsvisningsvindue

### Tag et øjebliksbillede

&ksnapshot; griber et billede af hele din desktop lige efter den er startet, men før den viser sig selv på skærmen. Dette tillader dig hurtigt at lave billeder af hele skærmen.

Øjebliksbilleder taget af &ksnapshot; vises i forhåndsvisningsvinduet, som er placeret foroven i midten af &ksnapshot; vinduet. Nedenfor er et eksempel på et &ksnapshot; forhåndsvisningsvindue. Din forhåndsvisning vil være anderledes afhængig af hvad du har på desktoppen.

&ksnapshot; Forhåndsvisningsvindue

Øjebliksbilledet kan gemmes ved at klikke på knappen Gem som.... Hvis der tages flere øjebliksbilleder, vil filnavnet automatisk blive ændret for at forhindre dig i at overskrive de tidligere øjebliksbilleder. Du kan imidlertid redigere filnavnet til hvadsomhelst du har lyst til, inkluderende navnet på et tidligere gemt øjebliksbillede.

For at tage et billede af et enkelt vindue, vælges punktet Vindue under markør i kombinationsfeltet (ved siden af Indfangningstilstand) og derefter klikkes på knappen Nyt skærmaftryk.

Afhængig af indstillingen af Forsinkelse for skærmaftryk, får du enten et kors som musemarkør (ved Ingen forsinkelse), eller en almindelig musemarkør som du kan bruge til at arbejde med et program indtil forsinkelsen er udløbet og et skærmaftryk tages.

Med Ingen forsinkelse, tages øjebliksbilledet med det samme når du klikker i et vindue.

&ksnapshot; vil vise det nye øjebliksbillede i forhåndsvisningsområdet, hvor efter du kan vælge at gemme det nye billede (ved at trykke på Gem som ...) eller du kan vælge at tage et nyt, ved at trykke på knappen Nyt øjebliksbillede.

For at tage et nyt billede af hele skrivebordet, vælges punktet Fuldskærm i kombinationsfeltet (ved siden af Indfangningstilstand) og derefter klikkes på knappen Nyt skærmaftryk. &ksnapshot; indfanger nu hele desktoppen når du klikker på Nyt skærmaftryk.

På lignende vis, for at tage et skærmaftryk af et område, vælges punktet Område i kombinationsfeltet (ved siden af Indfangningstilstand), Forsinkelse for skærmaftryk indstilles til Ingen forsinkelse, og derefter klikkes på knappen Nyt skærmaftryk. Musemarkøren ændres til et kors, og derefter kan du bruge musen til at markere området du vil indfange.

### Øvrige egenskaber

#### Øjebliksbillede-forsinkelse

Feltet Øjebliksbillede-forsinkelse: tillader dig at indgive en vilkårlig tidsforsinkelse, i sekunder, mellem det tidspunkt hvor du trykker på Nyt øjebliksbillede-knappen og det tidspunkt hvor øjebliksbilledet bliver taget.

Når en forsinkelse er sat, skal man ikke klikke med musen for at tage et billede. Dette tillader dig at åbne en dropned menu, og tage et billede af den.

#### Uden vinduesdekorationer

Inkludér vinduesdekorations er aktivt som standard.

Hvis du kun ønsker et indfange selve programmet uden de omgivende vinduesdekorationer, deaktiveres dette og et nyt billede tages.

#### Udskriv

Hvis du ønsker at udskrive dit øjebliksbillede fra forhåndsvisningen, klikker du på Udskriv... hvorpå du får KDE's standard-udskriftsdialog, og derfra kan du udskrive dit billede direkte.

#### Knapper

Der er to yderligere knapper placeret i bunden af &ksnapshot; vinduet. Deres funktion beskrives nedenfor.

Hjælp

- Giver dig en menu hvor du kan åbne &ksnapshot;-håndbogen, rapportere en fejl eller få nogle flere oplysninger om &kde; og &ksnapshot;.

Afslut

- Lukker for &ksnapshot;-programmet.

## &DCOP;-grænseflade

&ksnapshot; kan styres via scripter med &DCOP;-grænsefladen. Dette kapitel forklarer de forskellige &DCOP;-kald som kan bruges, og giver nogle eksempel på hvordan de bruges.

Som med alle DCOP-kald, skal du angive programmet som du vil påvirke, og den specifikke grænseflade. For &ksnapshot; skal du angive det specifikke program, som er `ksnapshot` efterfulgt af procesnummeret.

For at starte &ksnapshot; og opnå de rigtige flag, bruges `dcopstart ksnapshot`, som returnerer flag (såsom `ksnapshot-20594`) på standardudskriften.

Du kan få en liste med tilgængelige &DCOP;-grænseflader, for at bruge de rigtige flag, som vist i dette eksempel:

    $ 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ølgende eksempel er processen altid `ksnapshot-23151`.

### &DCOP;'s adgang til opsætning

For hver af indstillingerne som du kan ændre via den grafiske grænsefladen kan du både hente indstillingens nuværende værdi, og ændre indstillingen, via &DCOP;.

Du kan hente nuværende indfangningstilstand med kaldet `grabMode`, som vises nedenfor:

    $ dcop ksnapshot-23151 interface grabMode

Det returnerer `0` for fuldskærm, `1` for vindue og `2` for område.

Du kan indstille indfangningstilstand med `setGrabMode`, som kræver et argument som identificerer tilstanden som ønskes (som i kaldet `grabMode`). Du kan altså indstille vinduesindfangningstilstand (`1`) med:

    $ dcop ksnapshot-23151 interface setGrabMode 1

Du kan hente nuværende forsinkelsesindstilling (det grafiske objekt Forsinkelse for skærmaftryk:) med kaldet `timeout`, som vises nedenfor:

    $ dcop ksnapshot-23151 interface timeout

Det returnerer forsinkelsen i sekunder, eller nul hvis der ikke er nogen forsinkelse (klik for at indfange).

Du kan indstille forsinkelsen med `setTime`, som kræver et argument som identificerer forsinkelsens længde. Du kan altså indstille forsinkelsen 4 sekunder med:

    $ dcop ksnapshot-23151 interface setTime 4

Du kan hente søgestien hvor skærmaftrykket gemmes med kaldet `url`, som vises nedenfor:

    $ dcop ksnapshot-23151 interface url

Det returnerer filnavnet som en URL (f.eks. som `file:///home/bradh/test2.png`).

Du kan indstille søgestien med kommandoen `setURL`, som kræver et strengargument som identificerer den nye søgesti. Du kan altså indstille søgestien til `file:///home/bradh/skærmaftryk.jpg` med:

    $ dcop ksnapshot-23151 interface setURL file:///home/bradh/skærmaftryk.jpg

### Tag skærmaftryk med &DCOP;

Nøglen til at tage en skærmdump med &DCOP; er at bruge kommandoen `slotGrab`, som vises nedenfor:

    $ dcop ksnapshot-23151 interface slotGrab

Det tager et skærmaftryk med de nuværende indstillinger af indfangningstilstand og forsinkelse (som beskrevet ovenfor). Hvis du vil gemme skærmaftrykket som et billede er der et antal kald du kan bruge. Hvis du kun vil gemme billedet med nuværende søgesti (som returneres af `url` eller ændres af `setURL`), kan du kalde `slotSave`, som vist nedenfor:

    $ dcop ksnapshot-23151 interface slotSave

Hvis du ønsker at brugeren skal kunne angive et filnavn (og søgesti), kan du bruge `slotSaveAs`, som viser &kde;'s sædvanlige dialog for at gemme filen.

Hvis du vil gemme billedet med et andet navn (eller anden søgesti) uden at ændre søgestien med `setURL`, kan du bruge `save`, og angive url at gemme til som et argument. Hvis du altså vil gemme skærmaftrykket som `file:///tmp/temporærbillede.png`, kan du gøre følgende:

    $ dcop ksnapshot-23151 interface save file:///tmp/temporærbillede.png

Bemærk at dette returnerer sandt hvis skærmaftrykket blev gemt med godt resultat, og falsk ellers. Du bør også være klar over at hvis filen allerede findes, vises &kde;'s sædvanlige dialog som kræver at brugeren bestemmer om filen skal skrives over eller ej.

Foruden at gemme skærmaftrykket kan du også kopiere det til klippebordet med kommandoen `slotCopy`, som vist nedenfor:

    $ dcop ksnapshot-23151 interface slotCopy

Hvis du behøver at vælge et vindue som ikke er under musemarkøren, kan du bruge kaldet `slotMovePointer`, og videresende x-position (i billedpunkter) og y-position (også i billedpunkter) som argument. For at flytte musen til skærmens øverste venstre hjørne (0, 0), kan du bruge følgende:

    $ dcop ksnapshot-23151 interface slotMoveMouse 0 0

### Udskriv skærmaftryk med &DCOP;

Du kan udskrive nuværende skærmaftryk (som enten er gemt eller ikke gemt) med kommandoen `printSlot`, som vist nedenfor:

    $ dcop ksnapshot-23151 interface slotPrint

Bemærk at dette viser &kde;'s normale udskriftsdialog, som kan kræve interaktion af brugeren.

### Kontrol af programmet med &DCOP;

Du kan få &ksnapshot; til at afslutte ved at bruge kommandoen `exit` som vist nedenfor.

    $ dcop ksnapshot-23151 interface exit

## Medvirkende og licens

Program ophavsret

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

- 2000 Matthias Ettrich ettrich@kde.org

Dokumentation baseret på den oprindelige, ophavsret 1997-2000 Richard J. Moore rich@kde.org

&erik.kjaer.pedersen.credit; &underFDL; &underGPL;
&documentation.index;