<!--
SPDX-FileCopyrightText: 2003-2006 Jesper K. Pedersen <jesper.pedersen@kdab.com>
SPDX-FileCopyrightText: 2012 Miika Turkia <miika.turkia@gmail.com>
SPDX-FileCopyrightText: 2012 Yuri Chornoivan <yurchor@ukr.net>
SPDX-FileCopyrightText: 2020 Johannes Zarl-Zierl <johannes@zarl-zierl.at>

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

<chapter id="chp-options">
  <title>Configuring &kphotoalbum;</title>
  <para>Selecting
<menuchoice><guimenu>Settings</guimenu><guimenuitem>Configure
KPhotoAlbum...</guimenuitem></menuchoice> from the menu
bar will bring up the options dialog. This chapter will tell you about the
configuration option available there.</para>


<sect1 id="opt-general">
  <title>General Settings</title>

<para>Below you can see the configuration page for general options. Some of
these options are briefly described here and you can also access an
informational menu while doing configurations by right clicking any option and
selecting the <guimenuitem>What's This?</guimenuitem> menu item.</para>

<figure id="fig-options-general">
<title>General Options</title>
<mediaobject>
<imageobject>
<imagedata fileref="options-general.png" format="PNG"/>
</imageobject>
</mediaobject>
</figure>

<para>Use EXIF orientation information will automatically rotate images as
shot. Most digital cameras embed a thumbnail on RAW format files and quite
often this thumbnail is actually of sufficient size, might be even full sized.
Selecting to use this embedded thumbnail will fasten up all image operations as
decoding raw files is very time consuming but the thumbnail is many times
faster. You can also specify the minimum size for the thumbnail so that the RAW
image is decoded if the thumbnail is of useless size.</para>
</sect1>

<sect1 id="opt-search-new">
  <title>New Image Finder Settings</title>
<para>The left pane gives you access to other settings like <guimenuitem>File Searching
&amp; Versions</guimenuitem>. These settings define &kphotoalbum;'s behavior when new images
are found. These can be searched for automatically on start-up or manually from
the <guimenu>Maintenance</guimenu> menu. Again the options are well described in the online help
menu but a few should probably be given a brief introduction here.</para>

<figure id="fig-options-file-versions">
<title>File Searching &amp; Versions</title>
<mediaobject>
<imageobject>
<imagedata fileref="options-file-versions.png" format="PNG"/>
</imageobject>
</mediaobject>
</figure>

<para>
<itemizedlist mark='opencircle'>
    <listitem><para>You probably want to skip searching for some directories
    that are generated by different image viewers or file browsers. This is a comma
    separated list and new directories can easily be added when
    needed.</para></listitem>
    <listitem>
        <para>New versions of same files can be automatically detected to
	some extent. If you want to &eg; automatically stack new versions of same image
	to a stack you can configure regular expression to be used to look whether the
	new file is a new version of an original file. Following settings where first
	is the search regexp and second original file test should get you
	started, but might need some tuning to suit your naming convention:</para>
    <orderedlist>
    <listitem><para>(_(v){0,1}([0-9]){1,2}){0,1}\.(jpg|JPG|tif|TIF|png|PNG)</para></listitem>
    <listitem><para>.CR2;.NEF;.JPG;.jpg</para></listitem>
    </orderedlist>
    </listitem>
</itemizedlist>
Note that the Original file replacement text can have multiple suffixes
separated by semicolon and reference to regexp match can be used in the format
of \1. Original file is being searched from the same directory as the new file.
Oh, and the example regexp will match &eg; the following files: example_v1.jpg,
example_12.tif, example.PNG.
</para>
</sect1>

<sect1 id="opt-thumbnails">
  <title>Thumbnail Viewer Settings</title>
  <para>There isn't much you should configure for Thumbnail Viewer.
  Mainly Thumbnail Size and Tooltip Size (if you plan on using the
  tooltip feature that can be enabled from
  <menuchoice><guimenu>Settings</guimenu><guimenuitem>Show Tooltips
  in Thumbnail Window</guimenuitem></menuchoice> or
  <keycombo>&Ctrl;<keycap>T</keycap></keycombo>). You can also select to
  view additional information like labels and categories with the
  thumbnails.
  </para>
<figure>
<title>Options for Thumbnail View</title>
<mediaobject>
<imageobject>
<imagedata fileref="options-thumbnailview.png" format="PNG"/>
</imageobject>
</mediaobject>
</figure>
</sect1>

<sect1 id="opt-viewer">
  <title>Viewer Settings</title>
  <para>Another rather simple configuration. Mainly you can select the
  preferred size of Viewer or SlideShow window or to display them in
  full screen mode. Basic SlideShow interval can be set here.
  The scaling algorithm can be <emphasis>Best</emphasis> or
  <emphasis>Fastest</emphasis>. If your
  computer is fast enough for Best scaling use that otherwise go for the
  speed.
  </para>
<figure>
<title>Options for the Viewer</title>
<mediaobject>
<imageobject>
<imagedata fileref="options-viewer.png" format="PNG"/>
</imageobject>
</mediaobject>
</figure>
</sect1>




<sect1 id="sec-specifying-categories">
  <title>Categories</title>
  <para>In <xref linkend="chp-typingIn"/> it was described how you could
specify different properties for each image, these included
<literal>People</literal>, <literal>Places</literal> and
<literal>Keywords</literal>. It is possible to specify your own categories, so
if you prefer you could get an <literal>Items</literal>, a
<literal>Animals</literal>, or a <literal>Albums</literal> category your self.</para>

<para>In <xref linkend="fig-options-group"/> below you can see the dialog
used to configure which categories exists. For each category you specify a
label and an icon.</para>

<figure id="fig-options-group">
<title>Configuring Categories</title>
<mediaobject>
<imageobject>
<imagedata fileref="options-groups.png" format="PNG"/>
</imageobject>
</mediaobject>
</figure>
</sect1>




<sect1 id="sec-member-groups-in-options-dialog">
<title>Sub-categories</title>

<para>In <xref linkend="sec-member-groups-in-property-editor"/> we
discussed sub categories. From the settings dialog, it is possible to configure
entire member groups, &ie; configure all members of a group in one go rather
than configure all groups for a member as was the situation in <xref
linkend="sec-member-groups-in-property-editor"/>.</para>

<para>In <xref linkend="fig-options-member"/> you can see the configuration
page for specifying member groups. At the top there is a combo box, where you
can specify which category you are currently configuring. On the left side you
see a list box with the current category, and on the right side you see a list
box with the sub categories.</para>

<figure id="fig-options-member">
<title>Configuring Member Groups</title>
<mediaobject>
<imageobject>
<imagedata fileref="options-member.png" format="PNG"/>
</imageobject>
</mediaobject>
</figure>

</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:
-->
