<chapter id="acquireimages">
<chapterinfo>

<title>Acquire Images</title>

<authorgroup>
    <author>
        <firstname>Gilles</firstname><surname>Caulier</surname>
        <affiliation><address><email>caulier dot gilles at gmail dot com</email></address></affiliation>
    </author>
    
    <author>
        <firstname>Gerhard</firstname><surname>Kulzer</surname>
        <affiliation><address><email>gerhard at kulzer.net</email></address></affiliation>
    </author>    
</authorgroup>

<abstract>
<para>
The Kipi acquire images plugin provides tools to capture new images and save them
to the collections.
</para>
</abstract>

<keywordset>
<keyword>KDE</keyword>
<keyword>Kipi</keyword>
</keywordset>
</chapterinfo>

<title>Introduction</title>

<para>
This plugin can be used to capture and add new images to the host application from external sources.
Actually, two actions can be used:
</para>

<itemizedlist>

<listitem>
    <para>
    <guilabel>Scan images</guilabel>: use the Kooka interface for scanning images
    from either a flat scanner supported by the Sane project or a another capture
    source like video streams (for this to work you must have installed Kooka and Sane).
    </para>
</listitem>

<listitem>
    <para>
    <guilabel>Screenshots</guilabel>: take screenshots.
    </para>
</listitem>

</itemizedlist>

<sect1 id="using-plugin-acquirescan">
<title>Scan Image Dialog</title>

<para>
When you open the <guilabel>Scan images</guilabel> menu a dialog comes up that lets
you choose between the available acquisition sources on your computer. Choose the
one you want to capture from. You can also set the default source for the next time.
</para>

<para>
When the Kooka dialog window comes up, make your choices of acquisition settings
by altering the default values. Look at the preview and crop it before making the
final decision. The estimated file size is indicated in the lower right corner.
See the dedicated <ulink url="help:/kooka/index.html">Kooka manual</ulink> for
more information.
</para>

<note><para>
Make sure that the dialog is fully visible since some settings might be hidden
if the window is too narrow.
</para></note>

<para>
Press the scan button and wait until the scanning is finished and the
<guilabel>Save Target Option</guilabel> dialog appears. Here you can alter the
compression quality and the image file type (be aware that the BMP type is not
compressed and creates large files). The second item in that dialog let you choose
(or create) the folder the image will be saved to.
</para>

<figure id="acquireimages-save-target-dialog">
    <title>The Save Target Dialog in Action</title>
    <mediaobject><imageobject>
      <imagedata srccredit="The Save Target Dialog in Action" fileref="acquire-savetargetpreview.png"/>
    </imageobject></mediaobject>
</figure>

</sect1>

<sect1 id="using-plugin-acquirescreenshot">
<title>Screenshot Dialog</title>

<para>
You can choose the <guilabel>Screenshot</guilabel> acquisition mode from
<menuchoice><guimenu>Import</guimenu><guimenuitem>Screenshot</guimenuitem></menuchoice>
A dialog window comes up providing you with various snapshot modes:
</para>

<itemizedlist>
<listitem>
   <para>
   Deselect the <guilabel>Grab the entire desktop</guilabel> item to shoot a
   single window under the mouse cursor.
   </para>
</listitem>
<listitem>
   <para>
   When the <guilabel>Hide all host application windows</guilabel> item is selected
   the calling host application will disappear to give way to the other screens/windows.
   Otherwise you'll - after the delay - shoot the screen/window actually visible
   (if you've deselected <guilabel>Grab the entire desktop</guilabel> the window
   under the mouse pointer will be shot).
   </para>
</listitem>
</itemizedlist>

<para>
The delay control determines how long Screenshot will wait until the exposure is
happening. If you need to navigate to some other screens set the delay high enough
to give you the time for navigation.
</para>

<figure id="acquireimages-screenshot-dialog">
    <title>The Screenshot Dialog in Action</title>
    <mediaobject><imageobject>
      <imagedata srccredit="The Screenshot Dialog in Action" fileref="acquire-screenshotpreview.png"/>
    </imageobject></mediaobject>
</figure>

<para>
Once the screenshot has been taken the <guilabel>Save Target Option</guilabel>
dialog appears with the same options as described above.
</para>

</sect1>

</chapter>

<!--
Local Variables:
mode: sgml
sgml-omittag: nil
sgml-shorttag: t
End:
-->

