<chapter id="chp-viewer">
  <title
>De viewer</title>
  <para
>De reden voor u om al uw afbeeldingen in &kphotoalbum; te stoppen en uren en uren om ze te beschrijven, is natuurlijk dat u op een gegeven moment naar ze wilt kijken. Daarvoor heeft &kphotoalbum; een viewer die in staat is om uw afbeeldingen en video's te laten zien. U opent de viewer vanuit de miniaturenweergave zoals beschreven in <xref linkend="chp-thumbnail-view"/>.</para>

  <para
>The viewer can be seen in <xref linkend="fig-viewer"/>. The viewer does of course show you the image, but in addition to that it also shows you the information you specified for each image, including, who is on the images, where and when it was takes, &etc; </para>

  <figure id="fig-viewer">
    <title
>De viewer</title>
    <mediaobject>
      <imageobject>
        <imagedata fileref="viewer.png" format="PNG"/>
      </imageobject>
    </mediaobject>
  </figure>

  <para
>In case the info box is located on top of part of the images you actually want to see, you can simply grab it with the mouse, and move it elsewhere on the image. It is possible to configure what should be shown in the info box, and of course whether it should be shown at all. All these options are available by right clicking your mouse on the viewer. The context menu can be seen in <xref linkend="fig-viewer-contextmenu"/> below.</para>

  <figure id="fig-viewer-contextmenu">
    <title
>Het contextmenu van de viewer</title>
    <mediaobject>
      <imageobject>
        <imagedata fileref="viewer-contextmenu.png" format="PNG"/>
      </imageobject>
    </mediaobject>
  </figure>

  <para
>Some of the words in the info box is underlines. If you click the mouse on one of these words the browser (see <xref linkend="chp-browsing"/>) will go into scope of that item. Thus if you click on <literal
>Anne Helene</literal
> the browser will show you all images of Anne Helene, just as it would have done if you selected <literal
>People</literal
> from the root of the browser, and next selected <literal
>Anne Helene</literal
>.</para>

<para
>In the info box you can see a small button with the &kphotoalbum; logo. Pressing that button will get you to the thumbnail viewer. The thumbnail view will display all images, and the image you just had in the viewer will be selected. The idea behind this is the following: you browse to a given person, and look at the images of that person. One of the images is from say your high school time, and now you want to see images from that period of time. Using the <guilabel
>Jump to Context</guilabel
> button, you are brought to the thumbnail view showing all images, with the current one being in focus, and likely all your high school pictures around it.</para>

  <para
>In case you have loaded several images into the viewer, you can go forth and back using <keycap
>Page Up</keycap
> and <keycap
>Page Down</keycap
>. You can go to the first and last images using <keycap
>Home</keycap
> and <keycap
>End</keycap
>. These functions are of course also available from the context menu.</para>

  <para
>If several images was loaded into the viewer, you can ask it to run them as a slide show, which means that &kphotoalbum; loads a new image every few second. How often it loads a new image is configure by pressing the control key and respective plus (for go faster) or minus (go slower). Starting and stopping the slide show is done simply by pressing <keycombo
>&Ctrl;<keycap
>S</keycap
></keycombo
>.</para>

  <para
>A very useful feature of the &kphotoalbum; viewer is it ability to go into full screen mode. In this mode, the viewer is using the complete screen space, simply press the return key to make it go into and out of full screen mode.</para>

  <para
>Using the viewer, you may zoom in and out of your image, simply by dragging out a rectangle with the mouse. Pressing the minus key will zoom out again. Pressing the plus key will zoom in at the center of the image. <xref linkend="fig-marking-zoom-rectangle"/> below shows how a zoom rectangle is marked, and <xref linkend="fig-zoomed-view"/> shows the result of the zoom.</para>

<para
>Indrukken van de punt, laat u het zoomen resetten, zodat de afbeelding zonder zoom getoond wordt. Op het is-teken drukken stelt het zoomniveau in zodat elk pixel op het scherm correspondeert met een pixel in de afbeelding.</para>

<para
>Notice, for technical the only zooming operation that works when watching videos are zoom in and out (the plus and minus key).</para>

  <figure id="fig-marking-zoom-rectangle">
    <title
>Zoomen in de viewer</title>
    <mediaobject>
      <imageobject>
        <imagedata fileref="marking-zoom-rectangle.png"
          format="PNG"/>
      </imageobject>
    </mediaobject>
  </figure>

  <figure id="fig-zoomed-view">
    <title
>Zoomen in de viewer</title>
    <mediaobject>
      <imageobject>
        <imagedata fileref="zoomed-view.png"
          format="PNG"/>
      </imageobject>
    </mediaobject>
  </figure>

  <para
>Choosing the rotate operations from the context menu, you may rotate the image (Does not work for videos). You can annotate the current image, simply by choosing <guimenuitem
>Annotate</guimenuitem
> in the context menu.</para>





<sect1 id="tokens">
<title
>Tokens instellen vanuit de viewer</title>
<para
>Bij het bekijken van de afbeeldingen kunt een afbeelding tegen komen die een persoon bevat waarvan u de naam vergeten bent om aan de afbeelding te hangen. Op dat moment kunt u het bekijken afbreken en u haasten naar de dialoog om deze persoon er aan te hangen. u kunt echter de voorkeur geven om de afbeelding van een markering te voorzien en door te gaan met het bekijken.</para>

<para
>An alternative situation is if you want to sent a number of images to a printer to get them developed on paper. To see which you want, you start the viewer on the images, and tag them as good or bad while by inspecting see each one.</para>

<para
>For the above two examples the viewer offers you to set tokens on the images when viewing them. Tokens are named from A to Z, and you set a token simply by pressing its letter. In <xref linkend="fig-images-with-tokens"/> you may see an image where the tokens A, B and C are set.</para>

  <figure id="fig-images-with-tokens">
    <title
>Een afbeelding met tokens</title>
    <mediaobject>
      <imageobject>
        <imagedata fileref="images-with-tokens.png"
          format="PNG"/>
      </imageobject>
    </mediaobject>
  </figure>

<para
>Once you've set tokens on your images, they will be available for regular browsing in the browser, as can be seen in <xref linkend="fig-tokens-in-browser"/>. So when you've marked images that needs to be edited, printed, or whatever, simply browse to the images, and annotate all images at a time (as described in <xref linkend="sect-specifying-properties-for-all-images-simultaneously"/>), use a plugin to copy the selected images to a CD, or whatever you need to do.</para>

  <figure id="fig-tokens-in-browser">
    <title
>Tokens te zien in de browser</title>
    <mediaobject>
      <imageobject>
        <imagedata fileref="tokens-in-browser.png"
          format="PNG"/>
      </imageobject>
    </mediaobject>
  </figure>

<para
>Categories (and esp tokens) may be displayed in the thumbnail viewer. When Showing the categories in the thumbnail viewer, you may also add tokens to images, simply by pressing the letter for the token when the image is selected, this can be seen in <xref linkend="fig-tokens-in-thumbnail-viewer"/></para>

  <figure id="fig-tokens-in-thumbnail-viewer">
    <title
>Tokens te zien in de miniaturenviewer</title>
    <mediaobject>
      <imageobject>
        <imagedata fileref="tokens-in-thumbnail-viewer.png"
          format="PNG"/>
      </imageobject>
    </mediaobject>
  </figure>



</sect1>

<sect1 id="category-selectors-in-viewer">
    <title
>Categorieën instellen vanuit de viewer</title>
    <para
>Categorieën kunnen worden geselecteerd in de viewer door te beginnen met het invoeren van de naam van de categorie. Selectie wordt onmiddellijk gedaan wanneer er slechts één overeenkomende categorie is overgebleven.</para>

    <para
>To switch to category selection mode simply type slash (/). Possible options are shown after Assigning: text in curly brackets and it is immediately revised once more letters are typed. When a category is selected you can keep on typing to select the item value. Following image shows this in action and below it is explanation how this all works. </para>


<figure id="category-selectors">
<title
>Categorieën selecteren in de viewer</title>
<mediaobject>
<imageobject>
<imagedata fileref="category-selectors.png" format="PNG"/>
</imageobject>
</mediaobject>
</figure>

<para
>Follow the category setup below to better understand this explanation. Starting by typing "/k" the input selection will shift from "Tokens" to "Keywords" (since K is unique). After that, typing "g" will assign the "good" keyword immediately to the image. Typing "b" will show B{ad,oring} in the info box and typing "a" or "o" next will complete the match and assign the result to the image. Typing "/p" will work similarly and show the partial category match "P{eople,laces} so you can type "e" or "l" to complete "People" or "Places" respectively. <itemizedlist mark='opencircle'>
    <listitem
><para
>Tokens</para>
    <itemizedlist mark='opencircle'>
        <listitem
><para
>A..Z</para
></listitem>
    </itemizedlist>
    </listitem>
    <listitem>
    <para
>Trefwoorden</para>
    <itemizedlist mark='opencircle'>
        <listitem
><para
>Goed</para
></listitem>
        <listitem
><para
>Slecht</para
></listitem>
        <listitem
><para
>Saai</para
></listitem>
    </itemizedlist>
    </listitem>
    <listitem>
    <para
>Mensen</para>
    <itemizedlist mark='opencircle'>
        <listitem
><para
>George</para
></listitem>
        <listitem
><para
>Fred</para
></listitem>
    </itemizedlist>
    </listitem>
    <listitem>
    <para
>Plaatsen</para>
    <itemizedlist mark='opencircle'>
        <listitem
><para
>Internet</para
></listitem>
    </itemizedlist>
    </listitem>
</itemizedlist>
</para>

<sect2>
    <title
>Exacte woorden</title>
<para
>If you want to insert a new word or have words like boa and board you need to be able to type in the exact word you want to insert or select. This can be achieved by starting the word with double quote (") and ending with comma (,). If we would select boa immediately when it is typed you could not select board and otherwise we would be waiting for more key presses and you could not select boa. <figure id="keyword-exact">
<title
>Exacte woorden selecteren in de viewer</title>
<mediaobject>
<imageobject>
<imagedata fileref="keyword-exact.png" format="PNG"/>
</imageobject>
</mediaobject>
</figure>
</para>
</sect2>

<sect2>
    <title
>Altijd beginnen met categorie selectie</title>
<para
>If you type two '/'s in a row it will toggle between two different modes. The default mode described above and a category selection mode. In the latter mode we go straight back to category selection after a match. That way you can continually select items within different categories. It'll still do the fastest match possible so that typing "kbo" will still match "Keywords/Boring" in the example set above. </para>
</sect2>
<sect2>
    <title
>Assigning shortcuts</title>
<para
>If the current input is blank (e.g. you're not in the middle of selecting anything) and you hit a function key F1 through F12 (or up to F35 if your keyboard supports), it will assign the last matched assignment to that key. You can apply the same assignment to new images just by hitting the shortcut key. To remove use shift modifier and the shortcut (<keycombo
>&Shift;<keycap
>F#</keycap
></keycombo
>). This is useful for quickly assigning frequently repeating items in your current set of images. It remembers both the category and the category item. These shortcuts are remembered until &kphotoalbum; is closed, there is currently no support for replacing the assigned shortcut. </para>
  </sect2>
</sect1>


<!-- Drawing on images feature has been dropped
  <sect1 id="drawing-on-images">
    <title
>Drawing on Images</title>
    <para
>Sometimes it might not be obvious what you want to show with a
given image, for that purpose &kphotoalbum; allows you to draw on the
images. </para>

<para
>The actual drawing is not saved to the image, but rather to the
database, that way you can undo your drawing at a later point.</para>

<para
>In <xref linkend="fig-draw-on-image"/> you can see an image drawn
on. To bring &kphotoalbum; in to drawing mode, select <guimenuitem
>Draw on
Image</guimenuitem
> from the context menu. To quit drawing, press the cross in
the toolbar at the top of the window.</para>

<figure id="fig-draw-on-image">
<title
>Drawing on Images</title>
<mediaobject>
<imageobject>
<imagedata fileref="draw-on-image.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:
-->
