# Manuel de &ksnapshot;

## Introduction

&ksnapshot; est une application simple permettant d'effectuer 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 tous problèmes ou demandes 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 Menu K Applications Graphisme Logiciel de capture d'écran &ksnapshot;.

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

      % ksnapshot &

- La mini ligne de commande &krunner;(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;

La capture peut être enregistrée en cliquant sur le bouton Enregistrer sous.... Ceci ouvre la boîte de dialogue d'enregistrement de &kde; où vous pouvez choisir le nom, le dossier de destination, et le format de votre capture. Si vous prenez plusieurs captures d'écran, le nom du fichier est automatiquement incrémenté de 1 pour vous éviter d'écraser les captures précédentes. Vous pouvez toutefois saisir le nom de fichier que vous voulez, y compris celui d'une capture existante.

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 lorsque vous cliquerez 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 réaliser une nouvelle capture de l'ensemble du bureau, sélectionnez l'entrée Plein écran dans la liste déroulante puis cliquez sur le bouton Nouvelle capture. &ksnapshot; capturera maintenant la totalité du bureau si vous cliquez sur Nouvelle capture.

De la même façon, pour capturer une zone, choisissez l'entrée Zone dans la liste déroulante et mettez le Délai de capture sur Aucun délai, puis cliquez sur le bouton Nouvelle capture. Le pointeur de la souris se transformera alors en croix et vous pourrez utiliser la souris pour sélectionner la zone à capturer.

Pour effectuer une nouvelle capture d'une section de fenêtre, sélectionnez l'entrée Section de fenêtre dans la liste déroulante et cliquez sur le bouton Nouvelle capture. Avec Aucun délai vous obtenez une croix comme pointeur de la souris et vous cliquerez une fois avec le &BGS; dans la fenêtre. La section de la fenêtre sous le curseur sera mise en évidence avec un liséré rouge. Déplacez la souris vers la section souhaitée et cliquez avec le &BGS; pour lancer la capture.

### 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 avec le mode La fenêtre sous le curseur.

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.

#### Copier vers le presse-papiers

Lorsque vous voulez modifier votre capture à l'aide d'un éditeur d'images sans l'enregistrer, cliquez juste sur Copier vers le presse-papiers et insérez l'image dans votre programme d'affichage ou d'édition d'images.

#### Boutons

Il y a deux boutons supplémentaires localisés en 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 pourrez ouvrir le Manuel de &ksnapshot;, signaler un bogue, changer la langue de &ksnapshot; ou obtenir plus d'informations À propos de &ksnapshot; et À propos de &kde;.

Quitter

- Quitte l'application &ksnapshot;.

## Interface &DBus;

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

Comme avec tous les appels &DBus;, vous devez préciser l'application avec laquelle vous voulez communiquer, ainsi que l'interface correspondante. Pour &ksnapshot;, l'instance du programme se présente sous la forme suivante : `ksnapshot-` suivi du numéro du processus.

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;.

Vous pouvez obtenir le mode de capture courant en utilisant `grabMode`, comme indiqué ci-dessous :

    $ dcop ksnapshot-23151 interface grabMode

En retour, vous obtenez `0` pour le mode plein écran, `1` pour le mode fenêtre seule, et `2` pour le mode capture d'une zone.

Vous pouvez définir le mode de capture en utilisant `setGrabMode`, suivi de l'argument correspondant au mode désiré (identique à `grabMode`). Ainsi, vous pouvez passer en mode fenêtre seule (`1`) en utilisant :

    $ dcop ksnapshot-23151 interface setGrabMode 1

Vous pouvez obtenir le délai courant (le Délai de capture de l'interface graphique) en utilisant `timeout` comme indiqué ci-dessous :

    $ dcop ksnapshot-23151 interface timeout

En retour vous obtiendrez le délai en secondes, ou zéro s'il n'y a pas de délai (capture après le clic).

Vous pouvez fixer le délai en utilisant `setTime` suivi de l'argument correspondant à la durée de ce délai. Ainsi, vous pouvez fixer un délai de 4 secondes en utilisant :

    $ dcop ksnapshot-23151 interface setTime 4

Vous pouvez obtenir l'emplacement du dossier de destination des captures en utilisant `url` comme indiqué ci-dessous :

    $dcop ksnapshot-23151 interface url

En retour, vous obtiendrez l'emplacement du fichier sous forme d'URL (par exemple `file:///home/bradh/test2.png`).

Vous pouvez définir l'emplacement en utilisant `setURL` suivi d'un argument de type chaîne de caractères correspondant au nouvel emplacement. Ainsi, vous pouvez indiquer l'emplacement `file:///home/bradh/snapshot.jpg` en utilisant :

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

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

Prendre une capture d'écran avec &DCOP; se résume à utiliser `slotGrab` comme indiqué ci-dessous :

    $ dcop ksnapshot-23151 interface slotGrab

Ceci a pour effet de prendre une capture d'écran en suivant les options de mode de capture et de délai (décrites ci-dessus). Pour enregistrer l'image, il existe plusieurs appels possibles. Si vous voulez juste enregistrer l'image dans le dossier courant (celui retourné par `url` ou défini par `setURL`), vous pouvez utiliser `slotSave` comme indiqué ci-dessous :

    $ 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 sous un nom différent (ou dossier) sans pour autant changer l'emplacement avec `setURL`, vous pouvez utiliser `save`, en fournissant l'&URL;de destination comme argument. 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, l'utilisateur pourra décider d'écraser ou non celui-ci à l'aide du boîte de dialogue &kde; standard.

En plus d'enregistrer la capture, vous pouvez la copier dans le presse-papiers en utilisant `slotCopy` comme indiqué ci-dessous :

    $ dcop ksnapshot-23151 interface slotCopy

Si vous devez sélectionner une fenêtre qui n'est pas sous le curseur de la souris, vous pouvez utiliser `slotMovePointer` suivi de la position selon les x (en pixels) et selon les y (en pixels). Ainsi, pour déplacer la souris dans le coin en haut à gauche de l'écran (0,0), vous pouvez saisir :

    $ dcop ksnapshot-23151 interface slotMoveMouse 0 0

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

Vous pouvez imprimer la capture courante (qu'elle soit enregistrée ou non) en utilisant `printSlot` comme indiqué ci-dessous :

    $ 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;

Vous pouvez quitter &ksnapshot; en utilisant `exit` comme indiqué ci-dessous :

    $ dcop ksnapshot-23151 interface exit

## Remerciements et licence

Copyright du programme

- 1997-2000 &Richard.J.Moore; &Richard.J.Moore.mail;

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

Documentation fondée sur l'originale, copyright 1997-2000 &Richard.J.Moore; &Richard.J.Moore.mail;

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

&underFDL; &underGPL;
&documentation.index;