<?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 % German "INCLUDE"
> <!-- change language only here -->
]>

<book lang="&language;">

<bookinfo>
<title
>Das Handbuch zu &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
>Korrektur</contrib>
</othercredit>

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

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

<othercredit role="translator"
><firstname
>Robert</firstname
><surname
>Gogolok</surname
> <affiliation
><address
><email
>robertgogolok@gmx.de</email
></address
></affiliation
> <contrib
>Übersetzung des Handbuchs</contrib
></othercredit
> <othercredit role="translator"
><firstname
>Kilian</firstname
><surname
>Kluge</surname
> <affiliation
><address
><email
>kilian@klugeworld.de</email
></address
></affiliation
> <contrib
>Übersetzung des Handbuchs</contrib
></othercredit
> <othercredit role="translator"
><firstname
>Stefan</firstname
><surname
>Winter</surname
> <affiliation
><address
><email
>swinter@kde.org</email
></address
></affiliation
> <contrib
>Übersetzung der Programmoberfläche</contrib
></othercredit
> 
</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; ist ein einfaches Programm, um Bildschirmfotos zu erstellen . Es kann entweder den ganzen Bildschirm, ein einzelnes Fenster, einen Bereich in einem Fenster oder einen ausgewählten Bereich aufnehmen. Die daraus entstandenen Bilder lassen sich in einer Vielzahl von Formaten abspeichern.</para>
</abstract>

<keywordset>
<keyword
>KDE</keyword>
<keyword
>KSnapshot</keyword>
<keyword
>kdegraphics</keyword>
<keyword
>Bildschirm fotografieren</keyword>
<keyword
>Bildschirm fotografieren</keyword>
</keywordset>

</bookinfo>

<chapter id="introduction">
<title
>Einführung</title>

<para
>&ksnapshot; ist ein einfaches Programm, um Bildschirmfotos zu erstellen . Es kann entweder den ganzen Bildschirm, ein einzelnes Fenster, einen Bereich in einem Fenster oder einen ausgewählten Bereich aufnehmen. Die daraus entstandenen Bilder lassen sich in einer Vielzahl von Formaten abspeichern.</para>

<para
>Bei Problemen und für Verbesserungsvorschläge wenden Sie sich bitte an das <ulink url="http://bugs.kde.org/wizard.cgi"
>&kde;-Fehlerverfolgungs-System</ulink
>.</para>

</chapter>

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

<para
>Dieses Kapitel beschreibt, wie Sie &ksnapshot; benutzen können, um Bildschirmfotos zu erstellen.</para>

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

<para
>Sie können &ksnapshot; wie unten gezeigt, auf verschiedene Weise starten.</para>

<itemizedlist>
<listitem>
<para
>Sie können &ksnapshot; starten, indem Sie im <menuchoice
><guimenu
> K-Menü</guimenu
><guisubmenu
>Grafik</guisubmenu
><guimenuitem
> &ksnapshot; (Bildschirmfotos)</guimenuitem
></menuchoice
> wählen. </para
></listitem>
<listitem>
<para
>Sie können &ksnapshot; aber auch von der Befehlszeile aus mit dem folgenden Befehl starten:</para>
<screen width="40"
><prompt
>%</prompt
> <command
>ksnapshot &amp;</command
>
</screen>
</listitem>
<listitem
><para
>Der Dialog <quote
>Befehl ausführen</quote
> (über <keycombo action="simul"
>&Alt; <keycap
>F2</keycap
></keycombo
>) kann ebenfalls zum Aufrufen von &ksnapshot; benutzt werden.</para
></listitem>
</itemizedlist>

<para
>Wenn &ksnapshot; gestartet ist, erscheint ein Fenster ähnlich wie dieses: <mediaobject>
<imageobject>
<imagedata fileref="window.png" format="PNG"/>
</imageobject>
<textobject
><phrase
>Das Vorschaufenster von &ksnapshot;</phrase>
</textobject>
</mediaobject>
</para>

</sect1>

<sect1 id="taking-snapshot">
<title
>Das Erstellen eines Bildschirmfotos</title>

<para
>&ksnapshot; erstellt beim Starten, noch bevor es selbst auf dem Bildschirm erscheint, automatisch ein Foto des gesamten Bildschirms. Dies erlaubt Ihnen das schnelle Erstellen von Bildschirmabbildungen.</para>

<para
>Das von &ksnapshot; erstellte Bildschirmfoto wird im Vorschaufenster in der Mitte des Anwendungsfensters von &ksnapshot; gezeigt. Unten sehen Sie ein Beispiel für die Vorschau eines typischen Bildschirmfotos. Das Aussehen bei Ihnen hängt natürlich davon ab, welche Anwendungen Sie gerade geöffnet haben.</para>

<mediaobject>
<imageobject>
<imagedata fileref="preview.png" format="PNG"/>
</imageobject>
<textobject
><phrase
>Das Vorschaufenster von &ksnapshot;</phrase>
</textobject>
</mediaobject>

<para
>Das Bildschirmfoto kann über den Knopf <guibutton
>Speichern als ...</guibutton
> gespeichert werden. Damit öffnen Sie den Standard-Druckdialog von &kde; in dem Sie den Dateinamen, den Ordner und das Format für das Bild eingeben können.Wenn mehrere Bildschirmfotos erstellt werden, wird der Dateiname jedes Mal geändert, um ein versehentliches Überschreiben älterer Fotos zu verhindern. Sie können den Dateinamen beliebig ändern, auch in den Dateinamen eines zuvor abgespeicherten Bildschirmfotos. </para>

<para
>Um nur das Bildschirmfoto eines einzelnen Fensters aufzunehmen, müssen Sie als <guilabel
>Bildschirmfoto-Modus:</guilabel
> die Option <guilabel
>Fenster unter dem Mauszeiger</guilabel
> auswählen und dann auf <guibutton
>Neues Bildschirmfoto</guibutton
> klicken.</para>

<para
>Je nach Einstellung der <guilabel
>Verzögerung für Bildschirmfoto:</guilabel
> erhalten Sie entweder ein Kreuz als Mauszeiger (bei <guilabel
>Keine Verzögerung</guilabel
>) oder den normalen Mauszeiger, mit dem Sie ein Programm bedienen können, bis die Verzögerung vorbei ist und das Bildschirmfoto aufgenommen wird.</para>

<para
>Mit der Einstellung <guilabel
>Keine Verzögerung</guilabel
> wird das Bildschirmfoto sofort aufgenommen, sobald sie einmal mit der Maus in ein Fenster klicken.</para>

<para
>&ksnapshot; zeigt das neue Bildschirmfoto in der Vorschau an. Wenn es Ihren Vorstellungen entspricht, können Sie es mit <guibutton
>Speichern als ...</guibutton
> sichern. Wenn Sie ein neues Bildschirmfoto aufnehmen wollen, klicken Sie einfach auf <guibutton
>Neues Bildschirmfoto</guibutton
>.</para>

<para
>Um ein neues Bildschirmfoto des gesamten Bildschirms aufzunehmen, müssen Sie die Einstellung <guilabel
>Vollbild</guilabel
> auswählen. &ksnapshot; wird beim nächsten Klick auf <guibutton
>Neues Bildschirmfoto</guibutton
> den gesamten Bildschirm aufnehmen. </para>

<para
>Um auf gleiche Art das Bildschirmfoto eines Bereichs aufzunehmen, wählen Sie den Eintrag <guilabel
>Bereich</guilabel
> und setzen die <guilabel
>Verzögerung für Bildschirmfoto:</guilabel
> auf <guilabel
>Keine Verzögerung</guilabel
>, klicken Sie dann auf den Knopf <guibutton
>Neues Bildschirmfoto</guibutton
>. Der Mauszeiger wird dann zum Kreuz und Sie können mit der Maus den Bildschirmbereich für das Foto auswählen. </para>

<para
>Um ein neues Bildschirmfoto des Bereichs in einem Fenster aufzunehmen, müssen Sie die Einstellung <guilabel
>Bereich in einem Fenster</guilabel
> auswählen und dann auf <guibutton
>Neues Bildschirmfoto</guibutton
> klicken. Mit der Einstellung <guilabel
>Keine Verzögerung</guilabel
> erhalten Sie ein Kreuz als Mauszeiger und Sie müssen einmal mit der &LMBn; in das Fenster klicken. Der Bereich des Fensters unter dem Mauszeiger wird dann durch einen roten Rahmen gekennzeichnet. Bewegen Sie den Mauszeiger zum gewünschten Bereich, um das Foto auszunehmen. </para>

</sect1>

<sect1 id="additional-features">
<title
>Zusätzliche Funktionen</title>

<sect2 id="delay">
<title
>Verzögerung für Bildschirmfotos</title>

<para
>Das Eingabefeld <guilabel
>Verzögerung für Bildschirmfoto:</guilabel
> ermöglicht es Ihnen, eine beliebige Zeitverzögerung (in Sekunden) zwischen dem Zeitpunkt, zu dem Sie den Knopf <guibutton
>Neues Bildschirmfoto</guibutton
> drücken und dem tatsächlichen Aufnehmen des Bildschirmfotos einzugeben.</para>

<para
>Wenn Sie eine Verzögerungszeit eingegeben haben, müssen Sie nicht mit der Maustaste klicken, um ein Bildschirmfoto zu erstellen. Das ermöglicht Ihnen das vorherige Aufrufen eines Menüs in einer Anwendung, von der Sie dann ein Foto machen können. </para>

</sect2>

<sect2 id="window-decoration">
<title
>Fensterdekoration einbeziehen</title>

<para
><guilabel
>Fensterdekoration einbeziehen</guilabel
> ist standardmäßig aktiviert.</para>

<para
>Wenn Sie nur die Anwendung selber ohne die umgebende Fensterdekoration abbilden wollen, schalten Sie diese Option ab und nehmen ein neues Bildschirmfoto auf.</para>

</sect2>

<sect2 id="print-snapshot">
<title
>Drucken</title>

<para
>Wenn Sie Ihr Bildschirmfoto direkt aus der Vorschau heraus drucken möchten, klicken Sie einfach auf <guibutton
>Drucken ...</guibutton
> und es öffnet sich der Standard KDE-Dialog Drucken, in dem Sie direkt Ihre Bildschirmfotos drucken können.</para>
</sect2>

<sect2 id="copy-snapshot">
<title
>In die Zwischenablage kopieren</title>

<para
>Wenn Sie das Bildschirmfoto in einem Grafikprogramm bearbeiten wollen, ohne es zu speichern, klicken Sie auf <guibutton
>In die Zwischenablage kopieren</guibutton
> und fügen dann das Bild in das Grafikprogramm ein.</para>
</sect2>


<sect2 id="bottom-buttons">
<title
>Knöpfe</title>

<para
>Es gibt am unteren Rand des &ksnapshot;-Fensters noch zwei weitere Knöpfe. Deren Funktion wird im Folgenden beschrieben.</para>

<variablelist>
<varlistentry>
<term
><guibutton
>Hilfe</guibutton
></term>
<listitem
><para
>Dieser Knopf zeigt ein Menü an, in dem Sie das <guimenuitem
>Handbuch zu &ksnapshot;</guimenuitem
> öffnen, Fehler berichten oder mehr <guimenuitem
>Über &ksnapshot;</guimenuitem
> und <guimenuitem
>Über &kde;</guimenuitem
> erfahren können. </para
></listitem>
</varlistentry>

<varlistentry>
<term
><guibutton
>Beenden</guibutton
></term>
<listitem
><para
>Beendet &ksnapshot;</para
></listitem>
</varlistentry>
</variablelist>

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

<chapter id="dcop">

<title
>Schnittstelle zu &DCOP;</title>

<para
>&ksnapshot; können Sie über dessen Schnittstelle zu &DCOP; steuern. Diese Kapitel erklärt die verschiedenen &DCOP;-Aufrufe, die Sie benutzen können, und zeigt einige Beispiele für die Anwendung.</para>

<para
>Wie bei allen &DCOP;-Aufrufen müssen Sie das Programm angeben, das Sie steuern wollen, und die zugehörige Schnittstelle. Mit &ksnapshot; müssen Sie das gewünschte Programm finden, und das ist <literal
>ksnapshot-</literal
> gefolgt von der Prozessnummer. </para>

<para
>Um &ksnapshot; zu starten und das richtige Argument zu erhalten, verwenden Sie den Befehl <command
>dcopstart ksnapshot</command
>, der das Argument (wie zum Beispiel <computeroutput
>ksnapshot-20594</computeroutput
>) auf der Standardausgabe zurückgibt.</para>

<para
>Eine Liste der vorhandenen &DCOP;-Schnittstellen erhalten Sie, wenn Sie das richtige Argument wie im folgenden Beispiel verwenden. <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
>In den folgenden Beispielen ist der Prozess immer <computeroutput
>ksnapshot-23151</computeroutput
>. </para>

<sect1 id="dcop-settings">

<title
>Zugriff mit &DCOP; auf die Einstellungen</title>

<para
>Für jede Einstellung, die Sie über die grafische Oberfläche kontrollieren können, können Sie mit &DCOP; sowohl den aktuellen Status dieser Einstellung auslesen als auch diese Einstellung ändern. </para>

<para
>Den aktuellen Bildschirmfoto-Modus erfahren Sie mit dem Aufruf <literal
>grabMode</literal
>, wie unten gezeigt: <screen width="60">
<prompt
>$</prompt
> <command
>dcop ksnapshot-23151 interface grabMode</command>
</screen
> Dieser Aufruf gibt <computeroutput
>0</computeroutput
> für Vollbild, <computeroutput
>1</computeroutput
> für Fenster unter dem Mauszeiger und <computeroutput
>2</computeroutput
> für Bereich zurück. </para>

<para
>Mit <literal
>setGrabMode</literal
> können Sie den Bildschirmfoto-Modus einstellen, dies erfordert ein Argument für den gewünschten Modus (wie im Aufruf <literal
>grabMode</literal
>). So setzen Sie den Modus auf Fenster unter dem Mauszeiger (<command
>1</command
>) mit: <screen width="60"
><prompt
>$</prompt
> <command
>dcop ksnapshot-23151 interface setGrabMode 1</command
>
</screen>
</para>

<para
>Die aktuell eingestellte Verzögerung (der Eintrag <guilabel
>Verzögerung für Bildschirmfoto:</guilabel
> in der grafischen Oberfläche) erfahren Sie mit dem Aufruf <literal
>timeout</literal
>: <screen width="60">
<prompt
>$</prompt
> <command
>dcop ksnapshot-23151 interface timeout</command>
</screen
> Dies gibt als Wert die eingestellte Verzögerung in Sekunden zurück, der Wert Null bedeutet dabei keine Verzögerung (Foto sofort beim Klicken). </para>

<para
>Mit <literal
>setTime</literal
> können Sie die Verzögerung einstellen, dies erfordert ein Argument für die gewünschte Verzögerungsdauer. So setzen Sie die Verzögerung auf 4 Sekunden: <screen width="60"
><prompt
>$</prompt
> <command
>dcop ksnapshot-23151 interface setTime 4</command
>
</screen>
</para>

<para
>Den Pfad, unter dem das Bildschirmfoto gespeichert wird, erhalten Sie mit dem Aufruf <literal
>url</literal
>, wie hier gezeigt: <screen width="60">
<prompt
>$</prompt
> <command
>dcop ksnapshot-23151 interface url</command>
</screen
> Dies gibt den Dateinamen als &URL; (&eg; als <computeroutput
>file:///home/bradh/test2.png</computeroutput
>) zurück. </para>

<para
>Sie können mit dem Befehl <literal
>setURL</literal
> den Pfad einstellen, dies erfordert als Argument eine Zeichenkette mit dem neuen Pfad. So setzen Sie den Pfad auf <literal
>file:///home/bradh/snapshot.jpg</literal
>: <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
>Bildschirmfotos mit &DCOP; erstellen</title>

<para
>Bildschirmfotos können Sie mit &DCOP; erstellen, indem Sie den Befehl <literal
>slotGrab</literal
> verwenden, wie das folgende Beispiel zeigt: <screen width="60"
><prompt
>$</prompt
> <command
>dcop ksnapshot-23151 interface slotGrab</command
>
</screen>
</para>

<para
>Dies erstellt ein Bildschirmfoto mit den aktuellen Einstellungen für den Bildschirmfoto-Modus und die Verzögerung (wie oben beschrieben). Um das Bildschirmfoto zu speichern, gibt es mehrere Aufrufe, die Sie benutzen können. Wollen Sie das Bild im aktuellen Pfad (wie der Rückgabewert von <literal
>url</literal
> oder wie mit <literal
>setURL</literal
> eingestellt) speichern, verwenden Sie wie im folgenden Beispiel den Aufruf <literal
>slotSave</literal
>:  <screen width="60"
><prompt
>$</prompt
> <command
>dcop ksnapshot-23151 interface slotSave</command
>
</screen>
</para>

<para
>Wenn der Nutzer Dateinamen (und Pfad) eingeben soll, verwenden Sie <literal
>slotSaveAs</literal
>, dies öffnet den KDE-Standarddialog Speichern.</para>

<para
>Wollen Sie das Bild unter einem anderen Namen (oder Pfad) speichern, ohne den Pfad mit <literal
>setURL</literal
> zu ändern, so benutzen Sie <literal
>save</literal
> mit der &URL; als Argument. Wenn Sie das Bildschirmfoto zum Beispiel unter <filename
>file:///tmp/tempshot.png</filename
> speichern wollen, geben Sie Folgendes ein: <screen width="60">
<prompt
>$</prompt
> <command
>dcop ksnapshot-23151 interface save file:///tmp/tempshot.png</command>
 </screen
> Dieser Befehl gibt den Wert Wahr zurück, wenn das Bildschirmfoto erfolgreich gespeichert wurde, ansonsten den Wert Falsch. Denken Sie außerdem daran, das der Benutzer dann einen Standard &kde;-Dialog erhält und, wenn die Datei bereits vorhanden ist, entscheiden muss, ob er sie überschreiben will. </para>

<para
>Zusätzlich zur Speicherung des Bildschirmfotos können Sie es auch in die Zwischenablage mit dem Befehl <literal
>slotCopy</literal
> kopieren, wie folgendes Beispiel zeigt:  <screen width="60"
><prompt
>$</prompt
> <command
>dcop ksnapshot-23151 interface slotCopy</command
>
</screen>
</para>

<para
>Wenn Sie ein Fenster auswählen wollen, das sich eventuell nicht unter dem Mauszeiger befindet, so können Sie den Aufruf <literal
>slotMovePointer</literal
> verwenden und die x-Position (in Bildschirmpixeln) und die y-Position (gleichfalls in Bildschirmpixeln) als Argument angeben. Um die Maus in die obere linke Ecke des Bildschirms (0,0) zu bewegen, können Sie Folgendes eingeben: <screen width="60"
><prompt
>$</prompt
> <command
>dcop ksnapshot-23151 interface slotMoveMouse 0 0</command
>
</screen>
</para>
</sect1>

<sect1 id="dcop-print">
<title
>Bildschirmfotos mit &DCOP; drucken</title>

<para
>Das aktuelle Bildschirmfoto (egal ob bereits gespeichert) können Sie mit dem Befehl <literal
>printSlot</literal
> drucken, wie hier gezeigt: <screen width="60"
><prompt
>$</prompt
> <command
>dcop ksnapshot-23151 interface slotPrint</command
>
</screen>
</para>

<para
>Beachten Sie, das dies den normalen &kde; Druckdialog anzeigt, der vielleicht eine Benutzereingabe erfordert. </para>

</sect1>

<sect1 id="dcop-exit">
<title
>Kontrolle des Programms mit &DCOP;</title>

<para
>Sie können &ksnapshot; mit dem Befehl <literal
>exit</literal
> beenden, wie das folgende Beispiel zeigt. <screen width="60"
><prompt
>$</prompt
> <command
>dcop ksnapshot-23151 interface exit</command
>
</screen>
</para>

</sect1>

</chapter>

<chapter id="credits">

<title
>Danksagungen und Lizenz</title>

<para
>Programm Copyright</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
>Copyright der Dokumentation 1997-2000 &Richard.J.Moore; &Richard.J.Moore.mail;</para>
<para
>Übersetzung des Handbuchs: Robert Gogolok <email
>robertgogolok@gmx.de</email
>Kilian Kluge <email
>kilian@klugeworld.de</email
></para
><para
>Übersetzung der Programmoberfläche: Stefan Winter <email
>swinter@kde.org</email
></para
> 
&underFDL; &underGPL; </chapter>

&documentation.index;
</book>

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




