# &ksnapshot;-håndbogen

## Indledning

&ksnapshot; er et simpelt program til at tage skærmbilleder. Det kan indfange billeder, enten af hele desktoppen, et enkelt vindue eller et 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.

- Du kan starte &ksnapshot; ved at vælge det fra menuen K-menuen Grafik&ksnapshot; (Tag et skærmaftryk).

- 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

Billedet kan gemmes ved at klikke på knappen Gem som.... Det viser &kde;'s sædvanlige dialog for at gemme, hvor du kan vælge filnavn, mappested og formatet som billedet skal gemmes med. Hvis flere billeder tages, øges filnavnet automatisk for at forhindre at du overskriver tidligere billeder. Du kan imidlertid redigere filnavnet til hvad du vil, inklusive navnet på en tidligere gemt bild.

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 desktoppen, vælges punktet Fuldskærm i dropned-feltet og klik derefter på knappen Nyt skærmaftryk. &ksnapshot; indfanger nu hele desktoppen når du klikker på Nyt skærmaftryk.

På lignende måde, for at tage et skærmaftryk af et område, vælges Område i dropned-feltet (udfor påtegning Skærmaftryktllstand), indstil Forsinkelse for skærmaftryk til Ingen forsinkelse, og klik derefter på knappen Nyt skærmaftryk. Musemarkøren ændres til et kryds, og derefter kan du bruge musen til at markere området du vil indfange.

For at tage et nyt skærmaftryk af en del af et vindue, vælges indgangen Del af vindue i dropned-feltet og klik derefter på knappen Nyt skærmaftryk. Med Ingen forsinkelse får du et kors som musemarkør og du skal klikke en gang med venstre museknap i vinduet. Delen af vinduet under musemarkøren er nu markeret med en rød grænselinje. Flyt musen til det ønskede sted og klik med venstre museknap for at tage skærmaftrykket.

### Ø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.

#### Kopiér til klippebordet

Når du vil redigere skærmaftrykket i et grafikprogram uden at gemme skærmaftrykket, klikkes blot på Kopiér til klippebord og indsæt billedet i visningen eller grafikprogrammet.

#### Knapper

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

Hjælp

- Giver en menu hvor du kan vise &ksnapshot;-håndbog, rapportere en fejl eller få mere information 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()
    TQString url()
    void slotGrab()
    void slotPrint()
    void slotSave()
    bool save(TQString filename)
    void slotSaveAs()
    void slotCopy()
    void setTime(int newTime)
    int timeout()
    void setURL(TQString 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ærmaftryk 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; &Richard.J.Moore.mail;

- 2000 &Matthias.Ettrich; &Matthias.Ettrich.mail;

Dokumentation baseret på den oprindelige, ophavsret 1997-2000 &Richard.J.Moore; &Richard.J.Moore.mail;

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