# 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-04-01
1.02.02

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

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

Quand vous voulez imprimer votre capture d'écran à partir de l'aperçu, cliquez simplement sur Imprimer... et vous obtenez la boîte de dialogue standard de KDE, dans laquelle vous pouvez imprimer directement votre capture.

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

Comme pour tout appel DCOP, vous devez préciser l'application avec laquelle vous voulez communiquer, et l'interface particulière. Avec &ksnapshot;, vous devez préciser `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 obtenez le délai en secondes, ou bien zéro s'il n'y a pas de délai (capture après 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 le chemin du dossier de destination des captures en utilisant `url` comme indiqué ci-dessous :

    $ dcop ksnapshot-23151 interface url

En retour, vous obtenez l'emplacement du fichier sous forme d'une 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 à 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.

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