<para>&ksnapshot; is een eenvoudig applet voor het maken van schermafdrukken. Het kan afbeeldingen van het gehele bureaublad, een enkel venster of een geselecteerd gebied maken. De afbeeldingen kunnen dan in een aantal formaten worden opgeslagen.</para>
<para>&ksnapshot; is een eenvoudig applet voor het maken van schermafdrukken. Het kan afbeeldingen van het gehele bureaublad, een enkel venster of een geselecteerd gebied maken. De afbeeldingen kunnen dan in een aantal formaten worden opgeslagen.</para>
<listitem><para>De mini-opdrachtregel (opgeroepen met <keycombo action="simul">&Alt;<keycap>F2</keycap></keycombo>) kan ook gebruikt worden om &ksnapshot; te starten</para></listitem>
<para>&ksnapshot; maakt een schermafdruk van uw gehele bureaublad direct nadat het gestart is, maar voordat het zichzelf op uw scherm toont. Hiermee kunt u snel schermafdrukken van uw volledige bureaublad maken.</para>
<para>De schermafdruk die door &ksnapshot; gemaakt is wordt in het voorbeeldvenster getoond, dat zich in de linkerbovenhoek van het toepassingsvenster van &ksnapshot; bevindt. Hieronder ziet u een voorbeeld van het voorbeeldvenster van &ksnapshot;. Uw voorbeeldweergave zal verschillen, afhankelijk van wat u op uw bureaublad heeft.</para>
<para>De schermafdruk kan opgeslagen worden door op de knop <guibutton>Opslaan als...</guibutton> te klikken. Dit opent het standaardvenster voor het opslaan van bestanden, waarin u de bestandsnaam, map, en formaat voor het bestand kunt kiezen. Als er meerdere schermafdrukken worden gemaakt, wordt de bestandsnaam automatisch opgehoogd om te voorkomen dat u vorige schermafdrukken overschrijft. U kunt echter de bestandsnaam wijzigen in alles dat u wilt, ook in de naam van een vorige schermafdruk. </para>
<para>Om een schermafdruk van een enkel venster te maken, kiest u<guilabel>Venster onder muiscursor</guilabel> uit de lijst <guilabel>Hoe de afdruk te nemen</guilabel> en maakt u daarna een <guibutton>Nieuwe schermafdruk</guibutton>.</para>
<para>Afhankelijk van uw instellingen voor <guilabel>Vertraging voor schermafdruk</guilabel> krijgt u een kruis als muispijl (bij <guilabel>Geen vertraging</guilabel>) of kunt u doorwerken met een programma totdat de vertragingsperiode voorbij is en de schermafdruk gemaakt wordt.</para>
<para>Met <guilabel>Geen vertraging</guilabel> wordt de schermafdruk onmiddellijk gemaakt zodra u in een venster klikt.</para>
<para>&ksnapshot; toont de nieuwe schermafdruk in de voorbeeldweergave, waarna u kunt kiezen om de nieuwe afbeelding op te slaan (met de knop <guibutton>Opslaan als...</guibutton>) of een nieuwe afbeelding te maken, met de knop <guibutton>Nieuwe schermafdruk</guibutton>.</para>
<para>Om een schermafdruk van het gehele bureaublad te maken, kiest u de optie <guilabel>Volledig scherm</guilabel> bij <guilabel>Hoe de afdruk te nemen</guilabel>, en klikt u op <guibutton>Nieuwe schermafdruk</guibutton>. &ksnapshot; zal dan het gehele bureaublad in de schermafdruk plaatsen als u op de knop <guibutton>Nieuwe schermafdruk</guibutton> klikt.</para>
<para>Analoog hieraan maakt u een schermafdruk van een gebied door <guilabel>Bepaald gebied</guilabel> uit de lijst (<guilabel>Hoe de afdruk te nemen</guilabel>) te kiezen, en de <guilabel>Vertraging voor schermafdruk</guilabel> op <guilabel>Geen vertraging</guilabel> in te stellen, en dan op de knop <guibutton>Nieuwe schermafdruk</guibutton> te klikken. De muiscursor verandert in een kruis en u kunt de muis gebruiken om het gebied voor de schermafdruk te selecteren. </para>
<para>In het veld <guilabel>Vertraging voor schermafdruk</guilabel> kunt u een vertragingstijd invullen, in seconden, tussen het moment dat u de knop <guibutton>Nieuwe schermafdruk</guibutton> klikt en het moment dat de schermafdruk gemaakt wordt.</para>
<para>Als er een vertraging is ingesteld, hoeft u niet op de muisknop te klikken om een schermafdruk te maken. Hiermee kunt u een afrolmenu openen om daar een afbeelding van te maken.</para>
<para>Als u alleen de toepassing zelf en niet de omringende vensterdecoratie wilt opnemen, schakelt u deze optie uit en maakt u een nieuwe schermafdruk.</para>
<para>Als u uw schermafdruk vanuit de voorbeeldweergave wilt afdrukken, klikt u <guibutton>Afdrukken...</guibutton> en krijgt u het standaard &kde;-venster Afdrukken, waarvanuit u direct uw schermafdruk kunt afdrukken.</para>
<listitem><para>Geeft u een menu waaruit u het <guimenuitem>Handboek van &ksnapshot;</guimenuitem> kunt openen, een bug kunt rapporteren, of meer informatie kunt krijgen over &kde; en &ksnapshot;. </para></listitem>
<para>&ksnapshot; kan aangeroepen worden via de &DCOP;-interface. Dit hoofdstuk legt de diverse &DCOP;-aanroepen uit die u kunt gebruiken, en geeft een paar voorbeelden van hoe u ze kunt gebruiken.</para>
<para>Zoals met elke DCOP-aanroep dient u de toepassing op te geven waarmee u wilt communiceren, en de specifieke interface. Bij &ksnapshot; dient u de specifieke toepassing op te geven met <literal>ksnapshot-</literal>, gevolgd door het procesnummer.</para>
<para>Om &ksnapshot; te starten en het goede argument te verkrijgen, gebruikt u <command>dcopstart ksnapshot</command>, dat het goede argument (bijvoorbeeld <computeroutput>ksnapshot-20594</computeroutput>) op de standaarduitvoer weergeeft.</para>
<para>U kunt een lijst van beschikbare &DCOP;-interfaces verkrijgen, gebruik de goede argumenten, zoals in dit voorbeeld getoond: <screen width="60"><prompt>$</prompt> <command>dcop `dcopstart ksnapshot` interface</command><computeroutput>
</screen> Dit retourneert <computeroutput>0</computeroutput> voor een afdruk van het volledige scherm, <computeroutput>1</computeroutput> voor een afdruk van het venster, en <computeroutput>2</computeroutput> voor een afdruk van een regio. </para>
<para>U kunt deze manier instellen met <literal>setGrabMode</literal>, dat een argument vereist om de gewenste modus in te stellen (zoals bij de aanroep <literal>grabMode</literal>). Dus u stelt afdrukken van een venster (<command>1</command>) in met: <screen width="60"><prompt>$</prompt> <command>dcop ksnapshot-23151 interface setGrabMode 1</command>
<para>U kunt de huidige <guilabel>Vertraging voor schermafdruk</guilabel>verkrijgen met <literal>timeout</literal>, zoals hieronder getoond: <screen width="60">
</screen> Dit retourneert de vertraging in seconden, waarbij een waarde van nul betekent dat de afdruk direct na het klikken gemaakt wordt. </para>
<para>U kunt de vertraging instellen met <literal>setTime</literal>, die een argument vereist om de vertragingstijd in te stellen. Een vertraging van 4 seconden stelt u als volgt in: <screen width="60"><prompt>$</prompt> <command>dcop ksnapshot-23151 interface setTime 4</command>
</screen> Dit retourneert de bestandsnaam als een URL-adres, bijvoorbeeld <computeroutput>file:///home/gebruiker/test2.png</computeroutput>. </para>
<para>U kunt het pad instellen met <literal>setURL</literal>, die een tekenreeks vereist die aangeeft wat het nieuwe pad wordt.U kunt dus het pad instellen op <literal>file:///home/gebruiker/afdruk4.jpg</literal> met: <screen width="60"><prompt>$</prompt> <command>dcop ksnapshot-23151 interface setURL file:///home/gebruiker/afdruk4.jpg</command>
<para>Om &DCOP; te gebruiken voor het gebruiken van schermafdrukken, gebruikt u de opdracht <literal>slotGrab</literal>, zoals hieronder getoond: <screen width="60"><prompt>$</prompt> <command>dcop ksnapshot-23151 interface slotGrab</command>
<para>Dit neemt een afdruk met gebruikmaking van de huidige afdrukinstellingen (manier en vertraging). Als u de afdruk wilt opslaan, kunt u gebruik maken van een aantal aanroepen. Als u de afbeelding slechts wilt opslaan naar het huidige pad (zoals aangegeven door <literal>url</literal> of veranderd door <literal>setURL</literal>), kunt u <literal>slotSave</literal> aanroepen, zoals hieronder getoond: <screen width="60"><prompt>$</prompt> <command>dcop ksnapshot-23151 interface slotSave</command>
<para>Als u wilt dat de gebruiker een bestandsnaam en pad kan opgeven, gebruikt u <literal>slotSaveAs</literal>, dat een standaard &kde;-venster "Opslaan" toont.</para>
<para>Als u de afbeelding onder een andere naam (of een ander pad) wilt opslaan zonder het pad met <literal>setURL</literal> te hoeven veranderen, kunt u <literal>save</literal> gebruiken, waaraan u de URL opgeeft waaronder u de afbeelding wilt opslaan. Dus als u de afdruk wilt opslaan als <filename>file:///tmp/afdruk.png</filename>, kunt u het volgende doen:<screen width="60">
<prompt>$</prompt> <command>dcop ksnapshot-23151 interface save file:///tmp/afdruk.png</command>
</screen> Merk op dat dit de waarheidswaarde "waar" retourneert als de schermafdruk succesvol is opgeslagen, en anders "onwaar". Merk ook op dat, als het bestand al bestaat, de gebruiker een standaard &kde;-venster krijgt met de vraag of hij het bestand wil overschrijven. </para>
<para>Naast opslaan, kunt u de schermafdruk ook naar het klembord kopiëren, met de opdracht <literal>slotCopy</literal>, zoals hieronder getoond: <screen width="60"><prompt>$</prompt> <command>dcop ksnapshot-23151 interface slotCopy</command>
<para>Als u een venster wilt selecteren dat zich niet onder de muiscursor bevindt, kunt u <literal>slotMovePointer</literal> gebruiken, waaraan u de x-en y-positie in schermpixels meegeeft als argumenten. Dus om de muis naar de linkerbovenhoek van het scherm (0,0) te verplaatsen, kunt u het volgende doen: <screen width="60"><prompt>$</prompt> <command>dcop ksnapshot-23151 interface slotMoveMouse 0 0</command>
<title>Schermafdrukken afdrukken met &DCOP;</title>
<para>U kunt de huidige (al dan niet opgeslagen) schermafdruk op de printer afdrukken met <literal>printSlot</literal>, zoals hieronder getoond: <screen width="60"><prompt>$</prompt> <command>dcop ksnapshot-23151 interface slotPrint</command>
