# Manuel de &ksnapshot;

Richard J. Moore

    rich@kde.org

Robert L. McCormick

    c0029131@airmail.net

Brad Hards

    bradh@frogmouth.net

Lauri Watts

    lauri@kde.org

Relecture
Richard J Moore

    rich@kde.org

Développeur
Matthias Ettrich

    ettrich@kde.org

Développeur
&traducteurYvesDessertine; &traducteurGoneriLeBouder;&relecteurLudovicGrossard;
1997-2000 Richard J. Moore
2000 Matthias Ettrich
&FDLNotice;
2005-02-02
1.02.00

&ksnapshot; est une application simple permettant de prendre des captures d'écran. Il est possible de capturer l'ensemble du bureau, une seule fenêtre ou une zone sélectionnée. Les images peuvent être enregistrées dans plusieurs formats.

KDE KSnapshot kdegraphics capture d'écran capture d'écran

## Introduction

&ksnapshot; est une application simple permettant de prendre des captures d'écran. Il est possible de capturer l'ensemble du bureau, une seule fenêtre ou une zone sélectionnée. Les images peuvent être enregistrées dans plusieurs formats.

Veuillez signaler tout problème ou demande de fonctionnalités au système de suivi de bogue KDE.

## Utiliser &ksnapshot;

Ce chapitre décrit l'utilisation de &ksnapshot; pour capturer des images d'écran.

### Lancer &ksnapshot;

&ksnapshot; peut être lancé de l'une des façons décrites ci-dessous.

- Vous pouvez lancer &ksnapshot; en le sélectionnant dans le sous-menu Graphisme du tableau de bord.

- Vous pouvez lancer &ksnapshot; en saisissant ceci à l'invite d'une console :

      % ksnapshot &

- « Exécuter une commande » (invoqué par &Alt;F2) peut aussi être utilisé pour lancer &ksnapshot;

Une fois &ksnapshot; lancé, vous verrez une fenêtre comme celle-ci :

Fenêtre d'aperçu de &ksnapshot;

### Prendre une capture d'écran

Au démarrage, l'ensemble de votre bureau est capturé tel qu'il était juste avant que &ksnapshot; ne s'affiche lui-même à l'écran. Cela vous permet de réaliser rapidement des captures de l'ensemble du bureau.

L'image prise par &ksnapshot; est affichée dans la fenêtre d'aperçu, qui est localisée en haut à gauche de la fenêtre de &ksnapshot;. Ci-dessous, se trouve un exemple de la fenêtre d'aperçu de &ksnapshot;. Votre aperçu sera différent, car il dépend de ce qui est affiché sur votre bureau.

Fenêtre d'aperçu de &ksnapshot;

The snapshot can be saved by clicking on the Save As... button. If multiple snapshots are taken, the filename is automatically incremented to prevent you from overwriting previous snapshots. You may however edit the filename to anything you wish, including the name of a previously saved snapshot.

Pour prendre une capture d'une seule fenêtre, choisissez l'option La fenêtre sous le pointeur de la liste déroulante (à côté du champ Mode de capture) et cliquez sur le bouton Nouvelle capture.

En fonction du réglage du Délai de capture, vous obtenez soit une croix comme pointeur de souris (dans le cas Aucun délai), soit le pointeur standard, que vous pouvez alors utiliser pour travailler avec d'autres programmes jusqu'à ce que la capture soit prise lorsque le délai est écoulé.

Avec Aucun délai, la capture est prise immédiatement quand vous cliquez sur une fenêtre.

&ksnapshot; affiche la nouvelle capture dans la zone d'aperçu. Vous pouvez alors choisir d'enregistrer la capture (en cliquant sur Enregistrer sous...) ou d'en faire une nouvelle en cliquant sur le bouton Nouvelle capture.

Pour prendre une nouvelle capture de l'ensemble du bureau, sélectionnez l'entrée Plein écran dans la liste déroulante (à côté du champ Mode de capture) et cliquez sur le bouton Nouvelle capture.

De la même façon, pour capturer une zone, choisissez l'entrée Zone dans la liste déroulante (à côté du champ Mode de capture), positionnez le Délai de capture sur Aucun délai, puis cliquez sur le bouton Nouvelle capture. Le pointeur de la souris devient une croix. Utilisez alors la souris pour sélectionner la zone de l'écran à capturer.

### Options supplémentaires

#### Délai de capture

La zone Délai de capture : vous permet de définir un délai quelconque, en secondes, entre le moment ou vous appuyez sur le bouton Nouvelle capture et le moment où la capture est réalisée.

Lorsqu'un délai a été spécifié, vous n'avez pas à appuyer sur le bouton de la souris pour prendre une capture. Cela vous permet d'ouvrir un menu déroulant et d'en prendre une image.

#### Exclure la décoration des fenêtres

Inclure la décoration des fenêtres est activée par défaut.

Quand vous ne voulez capturer que l'application elle-même sans la décoration environnante de la fenêtre, désactivez cette option et prenez une nouvelle capture.

#### Imprimer

When you want to print your snapshot from the preview, just click Print... and you get the standard KDE Print dialog, from where you can directly print your snapshot.

#### Boutons

Il y a deux boutons supplémentaires localisés dans le bas de la fenêtre de &ksnapshot;. Leur fonction est décrite ci-dessous.

Aide

  Vous donne accès à un menu grâce auquel vous pouvez ouvrir le Manuel de &ksnapshot;, signaler un bogue ou obtenir plus d'informations sur &kde; et &ksnapshot;.

Quitter

  Quitte l'application &ksnapshot;.

## Interface &DCOP;

&ksnapshot; peut être contrôlé par un script en utilisant son interface &DCOP;. Ce chapitre explique le fonctionnement des divers appels &DCOP; que vous pouvez utiliser, et donne quelques exemples de leur utilisation.

As with all DCOP calls, you need to specify the application you want to interace with, and the particular interface. With &ksnapshot; you need to identify which particular application, which is `ksnapshot-` followed by the process number.

Pour démarrer &ksnapshot; et obtenir l'argument correspondant, utilisez `dcopstart ksnapshot`, qui affiche l'argument (par exemple `ksnapshot-20594`) sur la sortie standard.

Vous pouvez obtenir une liste de toutes les interfaces &DCOP; disponibles. Utilisez l'argument correspondant, comme indiqué dans cet exemple :

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

Dans les exemples suivants, le processus reste toujours `ksnapshot-23151`.

### Accès à la configuration &DCOP;

Pour chaque option accessible depuis l'interface graphique, vous pouvez à la fois obtenir l'état courant de cette option et modifier son état en utilisant &DCOP;.

You can obtain the current capture mode using the `grabMode` call, as shown below:

    $ dcop ksnapshot-23151 interface grabMode

This will return `0` for full-screen capture, `1` for window capture, and `2` for region capture.

You can set the capture mode using the `setGrabMode`, which requires an argument to identify the mode required (as for the `grabMode` call). So you can set window capture mode (`1`), using:

    $ dcop ksnapshot-23151 interface setGrabMode 1

You can obtain the current timeout setting (the Snapshot delay: GUI item) using the `timeout` call, as shown below:

    $ dcop ksnapshot-23151 interface timeout

This will return the timeout setting in seconds, or zero if there is no delay (click on capture).

You can set the timeout using the `setTime`, which requires an argument to identify the timeout duration. So you can set a delay of 4 seconds using:

    $ dcop ksnapshot-23151 interface setTime 4

You can obtain the path that the snapshot will be saved to using the `url` call, as shown below:

    $ dcop ksnapshot-23151 interface url

This will return the filename, as a URL (eg as `file:///home/bradh/test2.png`).

You can set the path using the `setURL` command, which requires a string argument to identify the new path. So you can set the path to `file:///home/bradh/snapshot4.jpg` using:

    $ dcop ksnapshot-23151 interface setURL file:///home/bradh/snapshot.jpg

### Prendre des captures d'écran avec &DCOP;

The key to taking screenshots with &DCOP; is use of the `slotGrab` command, as shown below:

    $ dcop ksnapshot-23151 interface slotGrab

This will take a snapshot using the current snapshot mode and timeout settings (as described above). If you want to save the snapshot image, there are a number of calls you can use. If you just want to save the image to the current path (as returned by `url`) or changed by `setURL`), you can call `slotSave`, as shown below:

    $ dcop ksnapshot-23151 interface slotSave

Si vous voulez permettre à l'utilisateur de préciser un emplacement (nom de fichier et dossier), vous pouvez utiliser `slotSaveAs` qui fait apparaître la boîte de dialogue standard de &kde;.

Si vous voulez enregistrer l'image à un emplacement différent (nom de fichier ou dossier) sans pour autant changer l'emplacement par défaut avec `setURL`, vous pouvez utiliser `save` suivi de l'URL de destination. Ainsi, si vous voulez enregistrer la capture dans `file:///tmp/tempshot.png`, vous pouvez saisir :

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

Notez que cette commande retourne vrai si la capture a été enregistrée avec succès, et faux dans le cas contraire. Notez également que si le fichier existe déjà, la boîte de dialogue standard de &kde; s'affiche et permet à l'utilisateur de décider d'écraser ou non le fichier.

In addition to saving the snapshot, you can also copy it to the clipboard, using the `slotCopy` command, as shown below:

    $ dcop ksnapshot-23151 interface slotCopy

If you need to select a window that may not be under the mouse cursor, you can use the `slotMovePointer` call, passing the x position (in screen pixels) and the y position (also in screen pixels) as arguments. So to move the mouse to the top left hand corner of the screen (0,0), you can do the following:

    $ dcop ksnapshot-23151 interface slotMoveMouse 0 0

### Imprimer des captures d'écran avec &DCOP;

You can print the current screenshot (which may or may not have been saved) using the `printSlot` command, as shown below:

    $ dcop ksnapshot-23151 interface slotPrint

Notez que ceci fait apparaître la boîte de dialogue d'impression de &kde;, et peut donc nécessiter l'intervention de l'utilisateur.

### Contrôler l'application avec &DCOP;

You can cause &ksnapshot; to exit by using the `exit` command, as shown below.

    $ dcop ksnapshot-23151 interface exit

## Remerciements et licence

Copyright du programme

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

- 2000 Matthias Ettrich ettrich@kde.org

Documentation fondée sur l'originale, copyright 1997-2000 Richard J. Moore rich@kde.org

Traduction française par &YvesDessertine; et &GoneriLeBouder;, relecture par &LudovicGrossard;.

&underFDL; &underGPL;
&documentation.index;