<?xml version="1.0" ?>
<!DOCTYPE book PUBLIC "-//KDE//DTD DocBook XML V4.2-Based Variant V1.1//EN" "dtd/kdex.dtd" [
  <!ENTITY kappname "&ksnapshot;">
  <!ENTITY package "kdegraphics">
  <!ENTITY % addindex "IGNORE">
  <!ENTITY % French "INCLUDE"
> <!-- change language only here -->
]>

<book lang="&language;">

<bookinfo>
<title
>Manuel de &ksnapshot;</title>

<authorgroup>
<author
><firstname
>Richard</firstname
> <othername
>J.</othername
> <surname
>Moore</surname
> <affiliation
> <address
>&Richard.J.Moore.mail;</address>
</affiliation>
</author>

<author
><firstname
>Robert</firstname
> <othername
>L.</othername
> <surname
>McCormick</surname
> <affiliation
> <address
>&Robert.L.McCormick.mail;</address>
</affiliation>
</author>

<author
><firstname
>Brad</firstname
> <surname
>Hards</surname
> <affiliation
> <address
>&Brad.Hards.mail;</address>
</affiliation>
</author>

<othercredit role="reviewer"
><firstname
>Lauri</firstname
> <surname
>Watts</surname
> <affiliation
> <address
>&Lauri.Watts.mail;</address>
</affiliation>
<contrib
>Relecteur</contrib>
</othercredit>

<othercredit role="developer"
><firstname
>Richard</firstname
> <othername
>J</othername
> <surname
>Moore</surname
> <affiliation
> <address
>&Richard.J.Moore.mail;</address>
</affiliation>
<contrib
>Développeur</contrib>
</othercredit>

<othercredit role="developer"
><firstname
>Matthias</firstname
> <surname
>Ettrich</surname
> <affiliation
> <address
>&Matthias.Ettrich.mail;</address>
</affiliation>
<contrib
>Développeur</contrib>
</othercredit>

&traducteurYvesDessertine; &traducteurGoneriLeBouder;&relecteurLudovicGrossard; 
</authorgroup>

<copyright>
<year
>1997-2000</year>
<holder
>&Richard.J.Moore;</holder>
</copyright>

<copyright>
<year
>2000</year>
<holder
>&Matthias.Ettrich;</holder>
</copyright>

<legalnotice
>&FDLNotice;</legalnotice>

<date
>2006-07-05</date>
<releaseinfo
>0.7</releaseinfo>

<abstract>
<para
>&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.</para>
</abstract>

<keywordset>
<keyword
>KDE</keyword>
<keyword
>KSnapshot</keyword>
<keyword
>kdegraphics</keyword>
<keyword
>capture d'écran</keyword>
<keyword
>capture d'écran</keyword>
</keywordset>

</bookinfo>

<chapter id="introduction">
<title
>Introduction</title>

<para
>&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.</para>

<para
>Veuillez signaler tous problèmes ou demandes de fonctionnalités au <ulink url="http://bugs.kde.org/wizard.cgi"
>système de suivi de bogue KDE</ulink
></para>

</chapter>

<chapter id="using-ksapshot">
<title
>Utiliser &ksnapshot;</title>

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

<sect1 id="starting">
<title
>Lancer &ksnapshot;</title>

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

<itemizedlist>
<listitem>
<para
>Vous pouvez lancer &ksnapshot; en le sélectionnant dans le <menuchoice
> <guimenu
>Menu K</guimenu
><guisubmenu
>Applications</guisubmenu
><guisubmenu
>Graphisme</guisubmenu
> <guimenuitem
>Logiciel de capture d'écran &ksnapshot;</guimenuitem
></menuchoice
>. </para
></listitem>
<listitem>
<para
>Vous pouvez lancer &ksnapshot; en saisissant ceci à l'invite d'une console :</para>
<screen width="40"
><prompt
>%</prompt
> <command
>ksnapshot &amp;</command
>
</screen>
</listitem>
<listitem
><para
>La mini ligne de commande &krunner;(invoqué par <keycombo action="simul"
>&Alt;<keycap
>F2</keycap
></keycombo
>) peut aussi être utilisé pour lancer &ksnapshot;</para
></listitem>
</itemizedlist>

<para
>Une fois &ksnapshot; lancé, vous verrez une fenêtre comme celle-ci : <mediaobject>
<imageobject>
<imagedata fileref="window.png" format="PNG"/>
</imageobject>
<textobject
><phrase
>Fenêtre d'aperçu de &ksnapshot;</phrase>
</textobject>
</mediaobject>
</para>

</sect1>

<sect1 id="taking-snapshot">
<title
>Prendre une capture d'écran</title>

<para
>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.</para>

<para
>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.</para>

<mediaobject>
<imageobject>
<imagedata fileref="preview.png" format="PNG"/>
</imageobject>
<textobject
><phrase
>Fenêtre d'aperçu de &ksnapshot;</phrase>
</textobject>
</mediaobject>

<para
>La capture peut être enregistrée en cliquant sur le bouton <guibutton
>Enregistrer sous...</guibutton
>. 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. </para>

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

<para
>En fonction du réglage du <guilabel
>Délai de capture</guilabel
>, vous obtenez soit une croix comme pointeur de souris (dans le cas <guilabel
>Aucun délai</guilabel
>), 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é.</para>

<para
>Avec <guilabel
>Aucun délai</guilabel
>, la capture est prise immédiatement lorsque vous cliquerez sur une fenêtre.</para>

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

<para
>Pour réaliser une nouvelle capture de l'ensemble du bureau, sélectionnez l'entrée <guilabel
>Plein écran</guilabel
> dans la liste déroulante puis cliquez sur le bouton <guibutton
>Nouvelle capture</guibutton
>. &ksnapshot; capturera maintenant la totalité du bureau si vous cliquez sur <guibutton
>Nouvelle capture</guibutton
>.</para>

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

<para
>Pour effectuer une nouvelle capture d'une section de fenêtre, sélectionnez l'entrée <guilabel
>Section de fenêtre</guilabel
> dans la liste déroulante et cliquez sur le bouton <guibutton
>Nouvelle capture</guibutton
>. Avec <guilabel
>Aucun délai</guilabel
> 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. </para>

</sect1>

<sect1 id="additional-features">
<title
>Options supplémentaires</title>

<sect2 id="delay">
<title
>Délai de capture</title>

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

<para
>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.</para>

</sect2>

<sect2 id="window-decoration">
<title
>Exclure la décoration des fenêtres</title>

<para
><guilabel
>Inclure la décoration des fenêtres</guilabel
> est activée par défaut avec le mode <guilabel
>La fenêtre sous le curseur</guilabel
>.</para>

<para
>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.</para>

</sect2>
<!-- not in 4.1
<sect2 id="print-snapshot">
<title
>Print</title>

<para
>When you want to print your snapshot from the preview, just click
<guibutton
>Print...</guibutton
> and you get the standard &kde; Print dialog, from
where you can directly print your snapshot.</para>
</sect2>
-->
<sect2 id="copy-snapshot">
<title
>Copier vers le presse-papiers</title>

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


<sect2 id="bottom-buttons">
<title
>Boutons</title>

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

<variablelist>
<varlistentry>
<term
><guibutton
>Aide</guibutton
></term>
<listitem
><para
>Vous donne accès à un menu grâce auquel vous pourrez ouvrir le <guimenuitem
>Manuel de &ksnapshot;</guimenuitem
>, signaler un bogue, changer la langue de &ksnapshot; ou obtenir plus d'informations <guimenuitem
>À propos de &ksnapshot;</guimenuitem
> et <guimenuitem
>À propos de &kde;</guimenuitem
>. </para
></listitem>
</varlistentry>

<varlistentry>
<term
><guibutton
>Quitter</guibutton
></term>
<listitem
><para
>Quitte l'application &ksnapshot;.</para
></listitem>
</varlistentry>
</variablelist>

</sect2>
</sect1>
</chapter>

<chapter id="dcop">

<title
>Interface &DBus;</title>
<!--
kdedev@rebutia:~/svn$ qdbus org.kde.ksnapshot-10484
/
/KDebug
/KSnapshot
/MainApplication
kdedev@rebutia:~/svn$ qdbus org.kde.ksnapshot-10484 /
method QString org.freedesktop.DBus.Introspectable.Introspect()

kdedev@rebutia:~/svn$ qdbus org.kde.ksnapshot-10484 /KSnapshot
method void org.kde.ksnapshot.slotGrab()
method void org.kde.ksnapshot.slotOpen(QString application)
method void org.kde.ksnapshot.slotSave()
method QDBusVariant org.freedesktop.DBus.Properties.Get(QString interface_name, QString property_name)
method void org.freedesktop.DBus.Properties.Set(QString interface_name, QString property_name, QDBusVariant value)
method QString org.freedesktop.DBus.Introspectable.Introspect()

kdedev@rebutia:~/svn$ qdbus org.kde.ksnapshot-10484 /MainApplication
method void org.kde.KApplication.quit()
method void org.kde.KApplication.reparseConfiguration()
method void org.kde.KApplication.updateUserTimestamp()
method void org.kde.KApplication.updateUserTimestamp(int time)
property readwrite int com.trolltech.Qt.QApplication.cursorFlashTime
property readwrite int com.trolltech.Qt.QApplication.doubleClickInterval
property readwrite QSize com.trolltech.Qt.QApplication.globalStrut
property readwrite int com.trolltech.Qt.QApplication.keyboardInputInterval
property readwrite bool com.trolltech.Qt.QApplication.quitOnLastWindowClosed
property readwrite int com.trolltech.Qt.QApplication.startDragDistance
property readwrite int com.trolltech.Qt.QApplication.startDragTime
property readwrite QString com.trolltech.Qt.QApplication.styleSheet
property readwrite int com.trolltech.Qt.QApplication.wheelScrollLines
property readwrite QString com.trolltech.Qt.QCoreApplication.applicationName
property readwrite QString com.trolltech.Qt.QCoreApplication.applicationVersion
property readwrite QString com.trolltech.Qt.QCoreApplication.organizationDomain
property readwrite QString com.trolltech.Qt.QCoreApplication.organizationName
method QDBusVariant org.freedesktop.DBus.Properties.Get(QString interface_name, QString property_name)
method void org.freedesktop.DBus.Properties.Set(QString interface_name, QString property_name, QDBusVariant value)
method QString org.freedesktop.DBus.Introspectable.Introspect()

kdedev@rebutia:~/svn$ qdbus org.kde.ksnapshot-10484 /KDebug
method void org.kde.KDebug.notifyKDebugConfigChanged()
method void org.kde.KDebug.printBacktrace()
method QDBusVariant org.freedesktop.DBus.Properties.Get(QString interface_name, QString property_name)
method void org.freedesktop.DBus.Properties.Set(QString interface_name, QString property_name, QDBusVariant value)
method QString org.freedesktop.DBus.Introspectable.Introspect()
-->
<para
>&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.</para>

<para
>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 : <literal
>ksnapshot-</literal
> suivi du numéro du processus.</para>
<!-- dbus-launch ksnapshot-->
<!-- ksnapshot qdbus org.kde.ksnapshot-20985-->
<para
>Pour démarrer &ksnapshot; et obtenir l'argument correspondant, utilisez <command
>dcopstart ksnapshot</command
>, qui affiche l'argument (par exemple <computeroutput
>ksnapshot-20594</computeroutput
>) sur la sortie standard.</para>

<para
>Vous pouvez obtenir une liste de toutes les interfaces &DCOP; disponibles. Utilisez l'argument correspondant, comme indiqué dans cet exemple : <screen width="60"
><prompt
>$</prompt
> <command
>dcop `dcopstart ksnapshot` interface</command
><computeroutput>
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()
</computeroutput
>
</screen>
</para>

<para
>Dans les exemples suivants, le processus reste toujours <computeroutput
>ksnapshot-23151</computeroutput
>. </para>

<sect1 id="dcop-settings">

<title
>Accès à la configuration &DCOP;</title>

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

<para
>Vous pouvez obtenir le mode de capture courant en utilisant <literal
>grabMode</literal
>, comme indiqué ci-dessous : <screen width="60">
<prompt
>$</prompt
> <command
>dcop ksnapshot-23151 interface grabMode</command>
</screen
> En retour, vous obtenez <computeroutput
>0</computeroutput
> pour le mode plein écran, <computeroutput
>1</computeroutput
> pour le mode fenêtre seule, et <computeroutput
>2</computeroutput
> pour le mode capture d'une zone. </para>

<para
>Vous pouvez définir le mode de capture en utilisant <literal
>setGrabMode</literal
>, suivi de l'argument correspondant au mode désiré (identique à <literal
>grabMode</literal
>). Ainsi, vous pouvez passer en mode fenêtre seule (<command
>1</command
>) en utilisant : <screen width="60"
><prompt
>$</prompt
> <command
>dcop ksnapshot-23151 interface setGrabMode 1</command
>
</screen>
</para>

<para
>Vous pouvez obtenir le délai courant (le <guilabel
>Délai de capture</guilabel
> de l'interface graphique) en utilisant <literal
>timeout</literal
> comme indiqué ci-dessous : <screen width="60">
<prompt
>$</prompt
> <command
>dcop ksnapshot-23151 interface timeout</command>
</screen
> 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). </para>

<para
>Vous pouvez fixer le délai en utilisant <literal
>setTime</literal
> suivi de l'argument correspondant à la durée de ce délai. Ainsi, vous pouvez fixer un délai de 4 secondes en utilisant : <screen width="60"
><prompt
>$</prompt
> <command
>dcop ksnapshot-23151 interface setTime 4</command
>
</screen>
</para>

<para
>Vous pouvez obtenir l'emplacement du dossier de destination des captures en utilisant <literal
>url</literal
> comme indiqué ci-dessous : <screen width="60">
<prompt
>$</prompt
><command
>dcop ksnapshot-23151 interface url</command>
</screen
> En retour, vous obtiendrez l'emplacement du fichier sous forme d'URL (par exemple <computeroutput
>file:///home/bradh/test2.png</computeroutput
>). </para>

<para
>Vous pouvez définir l'emplacement en utilisant <literal
>setURL</literal
> suivi d'un argument de type chaîne de caractères correspondant au nouvel emplacement. Ainsi, vous pouvez indiquer l'emplacement <literal
>file:///home/bradh/snapshot.jpg</literal
> en utilisant : <screen width="60"
><prompt
>$</prompt
> <command
>dcop ksnapshot-23151 interface setURL file:///home/bradh/snapshot.jpg</command
>
</screen>
</para>

</sect1>

<sect1 id="dcop-snapshot">
<title
>Prendre des captures d'écran avec &DCOP;</title>

<para
>Prendre une capture d'écran avec &DCOP; se résume à utiliser <literal
>slotGrab</literal
> comme indiqué ci-dessous : <screen width="60"
><prompt
>$</prompt
> <command
>dcop ksnapshot-23151 interface slotGrab</command
>
</screen>
</para>

<para
>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 <literal
>url</literal
> ou défini par <literal
>setURL</literal
>), vous pouvez utiliser <literal
>slotSave</literal
> comme indiqué ci-dessous : <screen width="60"
><prompt
>$</prompt
> <command
>dcop ksnapshot-23151 interface slotSave</command
>
</screen>
</para>

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

<para
>Si vous voulez enregistrer l'image sous un nom différent (ou dossier) sans pour autant changer l'emplacement avec <literal
>setURL</literal
>, vous pouvez utiliser <literal
>save</literal
>, en fournissant l'&URL;de destination comme argument. Ainsi, si vous voulez enregistrer la capture dans <filename
>file:///tmp/tempshot.png</filename
>, vous pouvez saisir : <screen width="60">
<prompt
>$</prompt
> <command
>dcop ksnapshot-23151 interface save file:///tmp/tempshot.png</command>
</screen
> 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. </para>

<para
>En plus d'enregistrer la capture, vous pouvez la copier dans le presse-papiers en utilisant <literal
>slotCopy</literal
> comme indiqué ci-dessous : <screen width="60"
><prompt
>$</prompt
> <command
>dcop ksnapshot-23151 interface slotCopy</command
>
</screen>
</para>

<para
>Si vous devez sélectionner une fenêtre qui n'est pas sous le curseur de la souris, vous pouvez utiliser <literal
>slotMovePointer</literal
> 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 : <screen width="60"
><prompt
>$</prompt
> <command
>dcop ksnapshot-23151 interface slotMoveMouse 0 0</command
>
</screen>
</para>
</sect1>

<sect1 id="dcop-print">
<title
>Imprimer des captures d'écran avec &DCOP;</title>

<para
>Vous pouvez imprimer la capture courante (qu'elle soit enregistrée ou non) en utilisant <literal
>printSlot</literal
> comme indiqué ci-dessous : <screen width="60"
><prompt
>$</prompt
> <command
>dcop ksnapshot-23151 interface slotPrint</command
>
</screen>
</para>

<para
>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. </para>

</sect1>

<sect1 id="dcop-exit">
<title
>Contrôler l'application avec &DCOP;</title>

<para
>Vous pouvez quitter &ksnapshot; en utilisant <literal
>exit</literal
> comme indiqué ci-dessous : <screen width="60"
><prompt
>$</prompt
> <command
>dcop ksnapshot-23151 interface exit</command
>
</screen>
</para>

</sect1>

</chapter>

<chapter id="credits">

<title
>Remerciements et licence</title>

<para
>Copyright du programme</para>
<itemizedlist>
<listitem
><para
>1997-2000 &Richard.J.Moore; &Richard.J.Moore.mail;</para
></listitem>
<listitem
><para
>2000 &Matthias.Ettrich; &Matthias.Ettrich.mail;</para
></listitem>
</itemizedlist>

<para
>Documentation fondée sur l'originale, copyright 1997-2000 &Richard.J.Moore; &Richard.J.Moore.mail;</para>
<para
>Traduction française par &YvesDessertine;, &GoneriLeBouder; et &PierreBuard;relecture par &LudovicGrossard;.</para
> 
&underFDL; &underGPL; </chapter>

&documentation.index;
</book>

<!--
Local Variables:
sgml-minimize-attributes: nil
sgml-general-insert-case: lower
End:
-->