<!--
SPDX-FileCopyrightText: 2003-2006 Jesper K. Pedersen <jesper.pedersen@kdab.com>
SPDX-FileCopyrightText: 2012 Miika Turkia <miika.turkia@gmail.com>

SPDX-License-Identifier: GFDL-1.2-only
-->

<chapter id="chp-thumbnail-view">
  <title>Thumbnail viewer</title>
  <para>Selecting <guilabel>View Thumbnails</guilabel> in the browser, you get to
a thumbnail overview of the images currently in scope (or all images if no
scope have been selected). An example of this can be seen in <xref
      linkend="fig-thumbnailview"/> below. The size of the thumbnails can be
configure simply by dragging the mouse with the middle mouse button down
(try it is really cool).</para>

  <figure id="fig-thumbnailview">
    <title>Thumbnail View</title>
    <mediaobject>
      <imageobject>
        <imagedata fileref="thumbnailview.png" format="PNG"/>
        </imageobject>
      </mediaobject>
  </figure>

  <para>In the thumbnail overview you can reorder your pictures by dragging
them around with the mouse. For
the date bar to work properly you should, however, aim at keeping your
images sorted at all time. Sorting you images can be done by selecting all
images, and choosing <menuchoice><guimenu>Images</guimenu><guimenuitem>Sort Selected by
Date &amp; Time</guimenuitem></menuchoice>. The sorting will not reorder images which has
the same date and time, so if you have say 100 images with the date 1992
(i.e. no month, no day, only year), then you may move them around, and their individual order will stay unchanged after a sort.</para>

<para>Dragging an image from the viewer to the background will set
the image as the background image of your desktop.</para>

  <para>By clicking on an image you load it into the viewer, if no viewer
window is present, a viewer window will be created.</para>

  <para>If you select a number of images, and presses <keycombo>&Ctrl;<keycap>I</keycap></keycombo>
or chooses <menuchoice><guimenu>Images</guimenu><guimenuitem>View 
Selected</guimenuitem></menuchoice>, the images will be loaded into the 
existing viewer (if no viewer exists, one will be created). Alternatively you 
may choose <menuchoice><guimenu>Images</guimenu><guimenuitem>View 
(in new window)</guimenuitem></menuchoice> to get the images loaded into a 
new viewer. If you press <keycombo>&Ctrl;<keycap>R</keycap></keycombo> or choose
<menuchoice><guimenu>Images</guimenu><guimenuitem>Run Slide 
Show</guimenuitem></menuchoice> the selected images will be loaded into the viewer and a slide show will
start. Finally choosing <menuchoice><guimenu>Images</guimenu><guimenuitem>Run
Randomized Slide Show</guimenuitem></menuchoice> will show a slide show of the images
selected in random order.</para>


<sect1 id="sect-deleting-images">
  <title>Deleting Images</title>
  <para>From the thumbnail view it is also possible to delete images. To
  do so select the images you want to delete and press the delete key or
  select <menuchoice><guimenu>Edit</guimenu><guimenuitem>Delete 
  Selected</guimenuitem></menuchoice> from the menu bar. Doing so &kphotoalbum; 
  will show you the dialog in <xref linkend="fig-delete-images"/></para>

<figure id="fig-delete-images">
<title>Deleting Images</title>
<mediaobject>
<imageobject>
<imagedata fileref="delete-images.png" format="PNG"/>
</imageobject>
</mediaobject>
</figure>

  <para>There are three ways of deleting an image in &kphotoalbum;, namely
move to thrash, delete it from the disk - which means that it will be permanently gone - or
tell &kphotoalbum; not to include it. In the latter case, &kphotoalbum; will never
show the image again, but it will keep it on disk. This is useful if
there for example is <emphasis>thumbnail images</emphasis> stored among
your images. This thumbnail image would contain an overview of all the
other images, and would thus be useless in &kphotoalbum;, but for other
application, say a web browser, it might be needed.</para>
</sect1>


<sect1 id="sect-offline-mode">
<title>Offline Mode</title>
<para>There is a constant battle going on between data growing, and hard
disks getting bigger. If you have a large number of images, you might find
yourself in the middle of that battle, not having enough hard disk space to
store all your images. In that situation you might choose to put some of
the images on CD's. An alternative scenario might be that you are going on a
business trip, and want to bring your images with you, but do not have the
20GB disk space requires for that purpose.</para>

<para>&kphotoalbum; offers a solution to that problem, namely that it allows you
to use it, without having the images available on disk. You do of course
need to have them available at some point in time for &kphotoalbum; to realize
that there are new images for it to index. <xref
linkend="fig-offline-mode"/> shows &kphotoalbum; when it is not capable of
finding all needed images on the disk.</para>

<figure id="fig-offline-mode">
<title>&kphotoalbum; in Offline Mode</title>
<mediaobject>
<imageobject>
<imagedata fileref="offline-mode.png" format="PNG"/>
</imageobject>
</mediaobject>
</figure>

<para>Images which have the corner cut of (that is images 1-4) are not
available on disk. Thumbnails are, available for images 5-9, even though the
images are missing from disk.  Therefore &kphotoalbum; can show you the
thumbnails for these images but you cannot view them in the viewer. (We used to
cut of the corner of thumbnails to indicate the image is missing from disk but
that feature seems to be currently broken.)
</para>

<para>As you can see, this feature requires you to copy files in and out of
your directories, &kphotoalbum; does not have any support for asking you to
insert the CD you labeled blah blah. Thus please forget about this feature
if you are the kind of person who do not like messing with files etc, and
instead simply ensure to buy hard disks that is large enough to always
store all your images.</para>

</sect1>



<sect1 id="sect-privacy">
<title>Privacy</title>
<para>Some time ago my girlfriend and I brought my laptop with us on a visit to my parents in
law, to show them the images from our most recent holiday. &kphotoalbum; turned
out to be a great success, and it didn't last long before my girlfriends
little sister seized the laptop and started browsing around on her
own. Unfortunately it didn't take her long either to get to some, let say
unfortunate, images of me from my youth, and they all had quite a bit of
laugh on me. That episode inspired me to add a new feature to &kphotoalbum;,
namely privacy locking.</para>

<para>In the <guimenu>Images</guimenu> menu you will find a sub menu called
<guimenuitem>privacy</guimenuitem>. To get some privacy, browse - while you
are on your own - to the images that you want to keep private, and
select <guimenuitem>Lock Away Current Set of Images</guimenuitem> from the
privacy sub menu. Alternatively you may browse to the images you want to
limit your little sister to see, and select <guimenuitem>Lock Away All
Other Images</guimenuitem>.</para>

<para>Now you have specified what to hide away, and once you hand over your
laptop to your little sister, simply choose <guimenuitem>Lock
Images</guimenuitem>, and your sister will not be able to see the locked
images. When done you may unlock them again using
<guimenuitem>Unlock</guimenuitem>.</para>

<para>It is possible to specify a password that must be entered to unlock the
database. In the <guimenuitem>privacy</guimenuitem> menu, simply select
<guimenuitem>Change Password</guimenuitem> to set a password.</para>

<para>Don't get fooled to believe that this will help you hide away images
for good. First the images are still on the disk, second, anyone with
access to the <filename>index.xml</filename> file that &kphotoalbum; uses can read
the password in clear text and optionally delete it. This feature is only
meant as a protection against someone sitting with &kphotoalbum; unintentionally
getting to your private images.</para>

</sect1>
</chapter>


<!-- Keep this comment at the end of the file
Local variables:
mode: xml
sgml-namecase-general:t
sgml-general-insert-case:lower
sgml-always-quote-attributes:t
sgml-indent-step:2
sgml-parent-document: "index.docbook"
End:
-->
