# Het handboek van &ksnapshot;

Richard J. Moore

    rich@kde.org

Robert L. McCormick

    c0029131@airmail.net

Brad Hards

    bradh@frogmouth.net

Lauri Watts

    lauri@kde.org

Nalezer
Richard J Moore

    rich@kde.org

Ontwikkelaar
Matthias Ettrich

    ettrich@kde.org

Ontwikkelaar
&Niels.Reedijk;&Sander.Koning;
1997-2000 Richard J. Moore
2000 Matthias Ettrich
&FDLNotice;
2005-04-01
1.02.02

&ksnapshot; is een eenvoudig applet voor het maken van schermafdrukken. Het kan afbeeldingen van het gehele bureaublad, een enkel venster of een geselecteerd gebied maken. De afbeeldingen kunnen dan in een aantal formaten worden opgeslagen.

KDE KSnapshot kdegraphics schermafdruk schermafbeelding

## Inleiding

&ksnapshot; is een eenvoudig applet voor het maken van schermafdrukken. Het kan afbeeldingen van het gehele bureaublad, een enkel venster of een geselecteerd gebied maken. De afbeeldingen kunnen dan in een aantal formaten worden opgeslagen.

Rapporteer problemen of verzoeken aan het KDE-bug-opsporingssysteem

## &ksnapshot; gebruiken

Dit hoofdstuk beschrijft het gebruik van &ksnapshot; voor het maken van schermafdrukken.

### &ksnapshot; starten

&ksnapshot; kan op diverse manieren gestart worden, zoals hieronder beschreven.

- U kunt &ksnapshot; starten door het uit het submenu Grafisch van het paneel te kiezen.

- U kunt &ksnapshot; starten door het volgende op de opdrachtregel in te voeren:

      % ksnapshot &

- De mini-opdrachtregel (opgeroepen met &Alt;F2) kan ook gebruikt worden om &ksnapshot; te starten

Als &ksnapshot; start, ziet u een venster als het onderstaande:

Voorbeeldvenster van &ksnapshot;

### Een schermafdruk maken

&ksnapshot; maakt een schermafdruk van uw gehele bureaublad direct nadat het gestart is, maar voordat het zichzelf op uw scherm toont. Hiermee kunt u snel schermafdrukken van uw volledige bureaublad maken.

De schermafdruk die door &ksnapshot; gemaakt is wordt in het voorbeeldvenster getoond, dat zich in de linkerbovenhoek van het toepassingsvenster van &ksnapshot; bevindt. Hieronder ziet u een voorbeeld van het voorbeeldvenster van &ksnapshot;. Uw voorbeeldweergave zal verschillen, afhankelijk van wat u op uw bureaublad heeft.

Voorbeeldvenster van &ksnapshot;

De schermafdruk kan opgeslagen worden door op de knop Opslaan als... te klikken. Dit opent het standaardvenster voor het opslaan van bestanden, waarin u de bestandsnaam, map, en formaat voor het bestand kunt kiezen. Als er meerdere schermafdrukken worden gemaakt, wordt de bestandsnaam automatisch opgehoogd om te voorkomen dat u vorige schermafdrukken overschrijft. U kunt echter de bestandsnaam wijzigen in alles dat u wilt, ook in de naam van een vorige schermafdruk.

Om een schermafdruk van een enkel venster te maken, kiest uVenster onder muiscursor uit de lijst Hoe de afdruk te nemen en maakt u daarna een Nieuwe schermafdruk.

Afhankelijk van uw instellingen voor Vertraging voor schermafdruk krijgt u een kruis als muispijl (bij Geen vertraging) of kunt u doorwerken met een programma totdat de vertragingsperiode voorbij is en de schermafdruk gemaakt wordt.

Met Geen vertraging wordt de schermafdruk onmiddellijk gemaakt zodra u in een venster klikt.

&ksnapshot; toont de nieuwe schermafdruk in de voorbeeldweergave, waarna u kunt kiezen om de nieuwe afbeelding op te slaan (met de knop Opslaan als...) of een nieuwe afbeelding te maken, met de knop Nieuwe schermafdruk.

Om een schermafdruk van het gehele bureaublad te maken, kiest u de optie Volledig scherm bij Hoe de afdruk te nemen, en klikt u op Nieuwe schermafdruk. &ksnapshot; zal dan het gehele bureaublad in de schermafdruk plaatsen als u op de knop Nieuwe schermafdruk klikt.

Analoog hieraan maakt u een schermafdruk van een gebied door Bepaald gebied uit de lijst (Hoe de afdruk te nemen) te kiezen, en de Vertraging voor schermafdruk op Geen vertraging in te stellen, en dan op de knop Nieuwe schermafdruk te klikken. De muiscursor verandert in een kruis en u kunt de muis gebruiken om het gebied voor de schermafdruk te selecteren.

### Verdere mogelijkheden

#### Vertraging voor schermafdruk

In het veld Vertraging voor schermafdruk kunt u een vertragingstijd invullen, in seconden, tussen het moment dat u de knop Nieuwe schermafdruk klikt en het moment dat de schermafdruk gemaakt wordt.

Als er een vertraging is ingesteld, hoeft u niet op de muisknop te klikken om een schermafdruk te maken. Hiermee kunt u een afrolmenu openen om daar een afbeelding van te maken.

#### Vensterdecoratie niet opnemen

Vensterdecoratie ook opnemen is standaard ingeschakeld.

Als u alleen de toepassing zelf en niet de omringende vensterdecoratie wilt opnemen, schakelt u deze optie uit en maakt u een nieuwe schermafdruk.

#### Afdrukken

Als u uw schermafdruk vanuit de voorbeeldweergave wilt afdrukken, klikt u Afdrukken... en krijgt u het standaard &kde;-venster Afdrukken, waarvanuit u direct uw schermafdruk kunt afdrukken.

#### Knoppen

Er bevinden zich twee andere knoppen onderaan het venster van &ksnapshot;. Deze worden hieronder beschreven.

Help

  Geeft u een menu waaruit u het Handboek van &ksnapshot; kunt openen, een bug kunt rapporteren, of meer informatie kunt krijgen over &kde; en &ksnapshot;.

Afsluiten

  Sluit &ksnapshot; af.

## &DCOP;-interface

&ksnapshot; kan aangeroepen worden via de &DCOP;-interface. Dit hoofdstuk legt de diverse &DCOP;-aanroepen uit die u kunt gebruiken, en geeft een paar voorbeelden van hoe u ze kunt gebruiken.

Zoals met elke DCOP-aanroep dient u de toepassing op te geven waarmee u wilt communiceren, en de specifieke interface. Bij &ksnapshot; dient u de specifieke toepassing op te geven met `ksnapshot-`, gevolgd door het procesnummer.

Om &ksnapshot; te starten en het goede argument te verkrijgen, gebruikt u `dcopstart ksnapshot`, dat het goede argument (bijvoorbeeld `ksnapshot-20594`) op de standaarduitvoer weergeeft.

U kunt een lijst van beschikbare &DCOP;-interfaces verkrijgen, gebruik de goede argumenten, zoals in dit voorbeeld getoond:

    $ 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()

In de volgende voorbeelden is het proces altijd `ksnapshot-23151`.

### Toegang tot instellingen via &DCOP;

Van elke instelling die u met de GUI kunt bewerken, kunt u met &DCOP; de huidige waarde opvragen en deze bewerken.

De huidige manier van het maken van schermafdrukken kunt u met `grabMode` opvragen, zoals hier getoond:

    $ dcop ksnapshot-23151 interface grabMode

Dit retourneert `0` voor een afdruk van het volledige scherm, `1` voor een afdruk van het venster, en `2` voor een afdruk van een regio.

U kunt deze manier instellen met `setGrabMode`, dat een argument vereist om de gewenste modus in te stellen (zoals bij de aanroep `grabMode`). Dus u stelt afdrukken van een venster (`1`) in met:

    $ dcop ksnapshot-23151 interface setGrabMode 1

U kunt de huidige Vertraging voor schermafdrukverkrijgen met `timeout`, zoals hieronder getoond:

    $ dcop ksnapshot-23151 interface timeout

Dit retourneert de vertraging in seconden, waarbij een waarde van nul betekent dat de afdruk direct na het klikken gemaakt wordt.

U kunt de vertraging instellen met `setTime`, die een argument vereist om de vertragingstijd in te stellen. Een vertraging van 4 seconden stelt u als volgt in:

    $ dcop ksnapshot-23151 interface setTime 4

U kunt het pad waarnaar de schermafdruk wordt opgeslagen, verkrijgen met `url`, zoals hieronder getoond:

    $ dcop ksnapshot-23151 interface url

Dit retourneert de bestandsnaam als een URL-adres, bijvoorbeeld `file:///home/gebruiker/test2.png`.

U kunt het pad instellen met `setURL`, die een tekenreeks vereist die aangeeft wat het nieuwe pad wordt.U kunt dus het pad instellen op `file:///home/gebruiker/afdruk4.jpg` met:

    $ dcop ksnapshot-23151 interface setURL file:///home/gebruiker/afdruk4.jpg

### Schermafdrukken maken met &DCOP;

Om &DCOP; te gebruiken voor het gebruiken van schermafdrukken, gebruikt u de opdracht `slotGrab`, zoals hieronder getoond:

    $ dcop ksnapshot-23151 interface slotGrab

Dit neemt een afdruk met gebruikmaking van de huidige afdrukinstellingen (manier en vertraging). Als u de afdruk wilt opslaan, kunt u gebruik maken van een aantal aanroepen. Als u de afbeelding slechts wilt opslaan naar het huidige pad (zoals aangegeven door `url` of veranderd door `setURL`), kunt u `slotSave` aanroepen, zoals hieronder getoond:

    $ dcop ksnapshot-23151 interface slotSave

Als u wilt dat de gebruiker een bestandsnaam en pad kan opgeven, gebruikt u `slotSaveAs`, dat een standaard &kde;-venster "Opslaan" toont.

Als u de afbeelding onder een andere naam (of een ander pad) wilt opslaan zonder het pad met `setURL` te hoeven veranderen, kunt u `save` gebruiken, waaraan u de URL opgeeft waaronder u de afbeelding wilt opslaan. Dus als u de afdruk wilt opslaan als `file:///tmp/afdruk.png`, kunt u het volgende doen:

    $ dcop ksnapshot-23151 interface save file:///tmp/afdruk.png

Merk op dat dit de waarheidswaarde "waar" retourneert als de schermafdruk succesvol is opgeslagen, en anders "onwaar". Merk ook op dat, als het bestand al bestaat, de gebruiker een standaard &kde;-venster krijgt met de vraag of hij het bestand wil overschrijven.

Naast opslaan, kunt u de schermafdruk ook naar het klembord kopiëren, met de opdracht `slotCopy`, zoals hieronder getoond:

    $ dcop ksnapshot-23151 interface slotCopy

Als u een venster wilt selecteren dat zich niet onder de muiscursor bevindt, kunt u `slotMovePointer` gebruiken, waaraan u de x-en y-positie in schermpixels meegeeft als argumenten. Dus om de muis naar de linkerbovenhoek van het scherm (0,0) te verplaatsen, kunt u het volgende doen:

    $ dcop ksnapshot-23151 interface slotMoveMouse 0 0

### Schermafdrukken afdrukken met &DCOP;

U kunt de huidige (al dan niet opgeslagen) schermafdruk op de printer afdrukken met `printSlot`, zoals hieronder getoond:

    $ dcop ksnapshot-23151 interface slotPrint

Merk op dat dit het standaard dialoogvenster "Afdrukken" van &kde; toont, waarin de gebruiker actie dient te ondernemen.

### Toepassingsbesturing met &DCOP;

U kunt &ksnapshot; laten afsluiten met `exit`, zoals hieronder getoond.

    $ dcop ksnapshot-23151 interface exit

## Dankbetuigingen en licentie

Programma copyright

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

- 2000 Matthias Ettrich ettrich@kde.org

Documentatie gebaseerd op het origineel, copyright 1997-2000 Richard J. Moore rich@kde.org

&meld.fouten;&vertaling.niels;&vertaling.sander; &underFDL; &underGPL;
&documentation.index;