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