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

<book lang="&language;">

<bookinfo>
<title
>&ksnapshot;-håndbogen</title>

<authorgroup>
<author
><firstname
>Richard</firstname
> <othername
>J.</othername
> <surname
>Moore</surname
> <affiliation
> <address
><email
>rich@kde.org</email
></address>
</affiliation>
</author>

<author
><firstname
>Robert</firstname
> <othername
>L.</othername
> <surname
>McCormick</surname
> <affiliation
> <address
><email
>c0029131@airmail.net</email
></address>
</affiliation>
</author>

<author
><firstname
>Brad</firstname
> <surname
>Hards</surname
> <affiliation
> <address
><email
>bradh@frogmouth.net</email
></address>
</affiliation>
</author>

<othercredit role="reviewer"
><firstname
>Lauri</firstname
> <surname
>Watts</surname
> <affiliation
> <address
><email
>lauri@kde.org</email
></address>
</affiliation>
<contrib
>Tester</contrib>
</othercredit>

<othercredit role="developer"
><firstname
>Richard</firstname
> <othername
>J</othername
> <surname
>Moore</surname
> <affiliation
> <address
><email
>rich@kde.org</email
></address>
</affiliation>
<contrib
>Udvikler</contrib>
</othercredit>

<othercredit role="developer"
><firstname
>Matthias</firstname
> <surname
>Ettrich</surname
> <affiliation
> <address
><email
>ettrich@kde.org</email
></address>
</affiliation>
<contrib
>Udvikler</contrib>
</othercredit>

&erik.kjaer.pedersen.role; 
</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
>2005-02-02</date>
<releaseinfo
>1.02.00</releaseinfo>

<abstract>
<para
>&ksnapshot; er et simpelt program til at tage skærmbilleder. Det kan indfange billeder, enten af hele desktoppen eller blot et enkelt vindue eller valgt område. Billederne kan så gemmes i forskellige formater.</para>
</abstract>

<keywordset>
<keyword
>KDE</keyword>
<keyword
>KSnapshot</keyword>
<keyword
>kdegraphics</keyword>
<keyword
>skærmaftryk</keyword>
<keyword
>grib skærm</keyword>
</keywordset>

</bookinfo>

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

<para
>&ksnapshot; er et simpelt program til at tage skærmbilleder. Det kan indfange billeder, enten af hele desktoppen eller blot et enkelt vindue eller valgt område. Billederne kan så gemmes i forskellige formater.</para>

<para
>Rapportér venligst problemer eller ønsker om nye egenskaber til <ulink url="http://bugs.kde.org/wizard.cgi"
>KDE's fejlretningssystem</ulink
></para>

</chapter>

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

<para
>Dette kapitel beskriver brugen af &ksnapshot; til at indfange skærmbilleder.</para>

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

<para
>&ksnapshot; kan startes på en af adskillige måder beskrevet nedenfor.</para>

<itemizedlist>
<listitem>
<para
>Man kan starte &ksnapshot; ved at vælge det fra <guisubmenu
>Grafik</guisubmenu
> undermenuen i panelet.</para
></listitem>
<listitem>
<para
>Man kan starte &ksnapshot; ved at indtaste følgende på kommandolinjen:</para>
<screen width="40"
><prompt
>%</prompt
> <command
>ksnapshot &amp;</command
>
</screen>
</listitem>
<listitem
><para
>Mini kommandolinjen (der hentes med <keycombo action="simul"
>&Alt;<keycap
>F2</keycap
></keycombo
>) kan også bruges til at starte &ksnapshot;</para
></listitem>
</itemizedlist>

<para
>Når &ksnapshot; starter, ser du et vindue som dette: <mediaobject>
<imageobject>
<imagedata fileref="window.png" format="PNG"/>
</imageobject>
<textobject
><phrase
>&ksnapshot; Forhåndsvisningsvindue</phrase>
</textobject>
</mediaobject>
</para>

</sect1>

<sect1 id="taking-snapshot">
<title
>Tag et øjebliksbillede</title>

<para
>&ksnapshot; griber et billede af hele din desktop lige efter den er startet, men før den viser sig selv på skærmen. Dette tillader dig hurtigt at  lave billeder af hele skærmen.</para>

<para
>Øjebliksbilleder taget af  &ksnapshot; vises i forhåndsvisningsvinduet, som er placeret foroven i midten af &ksnapshot; vinduet. Nedenfor er et eksempel på et &ksnapshot; forhåndsvisningsvindue. Din forhåndsvisning vil være anderledes afhængig af hvad du har på desktoppen.</para>

<mediaobject>
<imageobject>
<imagedata fileref="preview.png" format="PNG"/>
</imageobject>
<textobject
><phrase
>&ksnapshot; Forhåndsvisningsvindue</phrase>
</textobject>
</mediaobject>

<para
>Øjebliksbilledet kan gemmes ved at klikke på knappen <guibutton
>Gem som...</guibutton
>. Hvis der tages flere  øjebliksbilleder, vil filnavnet automatisk blive ændret for at forhindre dig  i at overskrive de tidligere øjebliksbilleder. Du kan imidlertid redigere  filnavnet til hvadsomhelst du har lyst til, inkluderende navnet på et tidligere gemt øjebliksbillede. </para>

<para
>For at tage et billede af et enkelt vindue, vælges punktet <guilabel
>Vindue under markør</guilabel
> i kombinationsfeltet (ved siden af  <guilabel
>Indfangningstilstand</guilabel
>) og derefter klikkes på knappen <guilabel
>Nyt skærmaftryk</guilabel
>.</para>

<para
>Afhængig af indstillingen af <guilabel
>Forsinkelse for skærmaftryk</guilabel
>, får du enten et kors som musemarkør (ved <guilabel
>Ingen forsinkelse</guilabel
>), eller en almindelig musemarkør som du kan bruge til at arbejde med et program indtil forsinkelsen er udløbet og et skærmaftryk tages.</para>

<para
>Med <guilabel
>Ingen forsinkelse</guilabel
>, tages øjebliksbilledet med det samme når du klikker i et vindue.</para>

<para
>&ksnapshot; vil vise det nye øjebliksbillede i forhåndsvisningsområdet, hvor efter du kan vælge at gemme det nye billede (ved at trykke på <guibutton
>Gem som ...</guibutton
>) eller du kan vælge at tage et nyt, ved at trykke på knappen <guibutton
>Nyt øjebliksbillede</guibutton
>.</para>

<para
>For at tage et nyt billede af hele skrivebordet, vælges punktet <guilabel
>Fuldskærm</guilabel
> i kombinationsfeltet (ved siden af  <guilabel
>Indfangningstilstand</guilabel
>) og derefter klikkes på knappen <guibutton
>Nyt skærmaftryk</guibutton
>. &ksnapshot; indfanger nu hele desktoppen når du klikker på <guibutton
>Nyt skærmaftryk</guibutton
>.</para>

<para
>På lignende vis, for at tage et skærmaftryk af et område, vælges punktet <guilabel
>Område</guilabel
> i kombinationsfeltet (ved siden af <guilabel
>Indfangningstilstand</guilabel
>), <guilabel
>Forsinkelse for skærmaftryk</guilabel
> indstilles til <guilabel
>Ingen forsinkelse</guilabel
>, og derefter klikkes på knappen <guibutton
>Nyt skærmaftryk</guibutton
>. Musemarkøren ændres til et kors, og derefter kan du bruge musen til at markere området du vil indfange. </para>

</sect1>

<sect1 id="additional-features">
<title
>Øvrige egenskaber</title>

<sect2 id="delay">
<title
>Øjebliksbillede-forsinkelse</title>

<para
>Feltet <guilabel
>Øjebliksbillede-forsinkelse:</guilabel
> tillader dig at indgive en vilkårlig tidsforsinkelse, i sekunder, mellem det tidspunkt hvor du trykker på <guibutton
>Nyt øjebliksbillede</guibutton
>-knappen og det tidspunkt hvor øjebliksbilledet bliver taget.</para>

<para
>Når en forsinkelse er sat, skal man ikke klikke med musen for at tage et billede. Dette tillader dig at åbne en dropned menu, og tage et billede af den.</para>

</sect2>

<sect2 id="window-decoration">
<title
>Uden vinduesdekorationer</title>

<para
><guilabel
>Inkludér vinduesdekorations</guilabel
> er aktivt som standard.</para>

<para
>Hvis du kun ønsker et indfange selve programmet uden de omgivende vinduesdekorationer, deaktiveres dette og et nyt billede tages.</para>

</sect2>

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

<para
>Hvis du ønsker at udskrive dit øjebliksbillede fra forhåndsvisningen, klikker du på <guibutton
>Udskriv...</guibutton
> hvorpå du får KDE's standard-udskriftsdialog, og derfra kan du udskrive dit billede direkte.</para>

</sect2>


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

<para
>Der er to yderligere knapper placeret i bunden af  &ksnapshot; vinduet. Deres funktion beskrives nedenfor.</para>

<variablelist>
<varlistentry>
<term
><guibutton
>Hjælp</guibutton
></term>
<listitem
><para
>Giver dig en menu hvor du kan åbne <guimenuitem
>&ksnapshot;-håndbogen</guimenuitem
>, rapportere en fejl eller få nogle flere oplysninger om &kde; og &ksnapshot;. </para
></listitem>
</varlistentry>

<varlistentry>
<term
><guibutton
>Afslut</guibutton
></term>
<listitem
><para
>Lukker for  &ksnapshot;-programmet.</para
></listitem>
</varlistentry>
</variablelist>

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

<chapter id="dcop">

<title
>&DCOP;-grænseflade</title>

<para
>&ksnapshot; kan styres via scripter med &DCOP;-grænsefladen. Dette kapitel forklarer de forskellige &DCOP;-kald som kan bruges, og giver nogle eksempel på hvordan de bruges.</para>

<para
>Som med alle DCOP-kald, skal du angive programmet som du vil påvirke, og den specifikke grænseflade. For &ksnapshot; skal du angive det specifikke program, som er <literal
>ksnapshot</literal
> efterfulgt af procesnummeret.</para>

<para
>For at starte &ksnapshot; og opnå de rigtige flag, bruges <command
>dcopstart ksnapshot</command
>, som returnerer flag (såsom <computeroutput
>ksnapshot-20594</computeroutput
>) på standardudskriften.</para>

<para
>Du kan få en liste med tilgængelige &DCOP;-grænseflader, for at bruge de rigtige flag, som vist i dette eksempel: <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
>I følgende eksempel er processen altid <computeroutput
>ksnapshot-23151</computeroutput
>. </para>

<sect1 id="dcop-settings">

<title
>&DCOP;'s adgang til opsætning</title>

<para
>For hver af indstillingerne som du kan ændre via den grafiske grænsefladen kan du både hente indstillingens nuværende værdi, og ændre indstillingen, via &DCOP;. </para>

<para
>Du kan hente nuværende indfangningstilstand med kaldet <literal
>grabMode</literal
>, som vises nedenfor: <screen width="60">
<prompt
>$</prompt
> <command
>dcop ksnapshot-23151 interface grabMode</command>
</screen
> Det returnerer <computeroutput
>0</computeroutput
> for fuldskærm, <computeroutput
>1</computeroutput
> for vindue og <computeroutput
>2</computeroutput
> for område. </para>

<para
>Du kan indstille indfangningstilstand med <literal
>setGrabMode</literal
>, som kræver et argument som identificerer tilstanden som ønskes (som i kaldet <literal
>grabMode</literal
>). Du kan altså indstille vinduesindfangningstilstand (<command
>1</command
>) med: <screen width="60"
><prompt
>$</prompt
> <command
>dcop ksnapshot-23151 interface setGrabMode 1</command
>
</screen>
</para>

<para
>Du kan hente nuværende forsinkelsesindstilling (det grafiske objekt <guilabel
>Forsinkelse for skærmaftryk:</guilabel
>) med kaldet <literal
>timeout</literal
>, som vises nedenfor: <screen width="60">
<prompt
>$</prompt
> <command
>dcop ksnapshot-23151 interface timeout</command>
</screen
> Det returnerer forsinkelsen i sekunder, eller nul hvis der ikke er nogen forsinkelse (klik for at indfange). </para>

<para
>Du kan indstille forsinkelsen med <literal
>setTime</literal
>, som kræver et argument som identificerer forsinkelsens længde. Du kan altså indstille forsinkelsen 4 sekunder med: <screen width="60"
><prompt
>$</prompt
> <command
>dcop ksnapshot-23151 interface setTime 4</command
>
</screen>
</para>

<para
>Du kan hente søgestien hvor skærmaftrykket gemmes med kaldet <literal
>url</literal
>, som vises nedenfor: <screen width="60">
<prompt
>$</prompt
> <command
>dcop ksnapshot-23151 interface url</command>
</screen
> Det returnerer filnavnet som en URL (f.eks. som <computeroutput
>file:///home/bradh/test2.png</computeroutput
>). </para>

<para
>Du kan indstille søgestien med kommandoen <literal
>setURL</literal
>, som kræver et strengargument som identificerer den nye søgesti. Du kan altså indstille søgestien til <literal
>file:///home/bradh/skærmaftryk.jpg</literal
> med: <screen width="60"
><prompt
>$</prompt
> <command
>dcop ksnapshot-23151 interface setURL file:///home/bradh/skærmaftryk.jpg</command
>
</screen>
</para>

</sect1>

<sect1 id="dcop-snapshot">
<title
>Tag skærmaftryk med &DCOP;</title>

<para
>Nøglen til at tage en skærmdump med &DCOP; er at bruge kommandoen <literal
>slotGrab</literal
>, som vises nedenfor: <screen width="60"
><prompt
>$</prompt
> <command
>dcop ksnapshot-23151 interface slotGrab</command
>
</screen>
</para>

<para
>Det tager et skærmaftryk med de nuværende indstillinger af indfangningstilstand og forsinkelse (som beskrevet ovenfor). Hvis du vil gemme skærmaftrykket som et billede er der et antal kald du kan bruge. Hvis du kun vil gemme billedet med nuværende søgesti (som returneres af <literal
>url</literal
> eller ændres af <literal
>setURL</literal
>), kan du kalde <literal
>slotSave</literal
>, som vist nedenfor: <screen width="60"
><prompt
>$</prompt
> <command
>dcop ksnapshot-23151 interface slotSave</command
>
</screen>
</para>

<para
>Hvis du ønsker at brugeren skal kunne angive et filnavn (og søgesti), kan du bruge <literal
>slotSaveAs</literal
>, som viser &kde;'s sædvanlige dialog for at gemme filen.</para>

<para
>Hvis du vil gemme billedet med et andet navn (eller anden søgesti) uden at ændre søgestien med <literal
>setURL</literal
>, kan du bruge <literal
>save</literal
>, og angive url at gemme til som et argument. Hvis du altså vil gemme skærmaftrykket som <filename
>file:///tmp/temporærbillede.png</filename
>, kan du gøre følgende: <screen width="60">
<prompt
>$</prompt
> <command
>dcop ksnapshot-23151 interface save file:///tmp/temporærbillede.png</command>
</screen
> Bemærk at dette returnerer sandt hvis skærmaftrykket blev gemt med godt resultat, og falsk ellers. Du bør også være klar over at hvis filen allerede findes, vises &kde;'s sædvanlige dialog som kræver at brugeren bestemmer om filen skal skrives over eller ej. </para>

<para
>Foruden at gemme skærmaftrykket  kan du også kopiere det til klippebordet med kommandoen <literal
>slotCopy</literal
>, som vist nedenfor: <screen width="60"
><prompt
>$</prompt
> <command
>dcop ksnapshot-23151 interface slotCopy</command
>
</screen>
</para>

<para
>Hvis du behøver at vælge et vindue som ikke er under musemarkøren, kan du bruge kaldet <literal
>slotMovePointer</literal
>, og videresende x-position (i billedpunkter) og y-position (også i billedpunkter) som argument. For at flytte musen til skærmens øverste venstre hjørne (0, 0), kan du bruge følgende: <screen width="60"
><prompt
>$</prompt
> <command
>dcop ksnapshot-23151 interface slotMoveMouse 0 0</command
>
</screen>
</para>
</sect1>

<sect1 id="dcop-print">
<title
>Udskriv skærmaftryk med &DCOP;</title>

<para
>Du kan udskrive nuværende skærmaftryk (som enten er gemt eller ikke gemt) med kommandoen <literal
>printSlot</literal
>, som vist nedenfor: <screen width="60"
><prompt
>$</prompt
> <command
>dcop ksnapshot-23151 interface slotPrint</command
>
</screen>
</para>

<para
>Bemærk at dette viser &kde;'s normale udskriftsdialog, som kan kræve interaktion af brugeren. </para>

</sect1>

<sect1 id="dcop-exit">
<title
>Kontrol af programmet med &DCOP;</title>

<para
>Du kan få &ksnapshot; til at afslutte ved at bruge kommandoen <literal
>exit</literal
> som vist nedenfor. <screen width="60"
><prompt
>$</prompt
> <command
>dcop ksnapshot-23151 interface exit</command
>
</screen>
</para>

</sect1>

</chapter>

<chapter id="credits">

<title
>Medvirkende og licens</title>

<para
>Program ophavsret</para>
<itemizedlist>
<listitem
><para
>1997-2000 Richard J. Moore <email
>rich@kde.org</email
></para
></listitem>
<listitem
><para
>2000 Matthias Ettrich <email
>ettrich@kde.org</email
></para
></listitem>
</itemizedlist>

<para
>Dokumentation baseret på den oprindelige, ophavsret 1997-2000 Richard J. Moore <email
>rich@kde.org</email
></para>
&erik.kjaer.pedersen.credit; 
&underFDL; &underGPL; </chapter>

&documentation.index;
</book>

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




