annotate doc/docbook/GuideOtherWindowsImageWindow.xml @ 1773:2ae81598b254

scripts for converting wiki documentation to docbook

<?xml version="1.0" encoding="utf-8"?>
<section id="GuideOtherWindowsImageWindow">
    <title>
      Image Window
    </title>
    <para>
      An image window is a window that displays only the image.
    </para>
    <para>
      An image window can always be opened from the context menu of all images and files. Keyboard shortcuts exist for most windows that display images or files, however the shortcut can vary dependent on the type of window containing them.
    </para>
    <para>
      The image pane contained in an image window behaves and operates similar to the image pane of a <link linkend="GuideMainWindowImagePane">Main Window</link>. The keyboard shortcuts are the same, and the context menu is the same except “Hide file list” is replaced by “Close window”. The <link linkend="GuideImagePresentationSlideshow">slide show</link> and <link linkend="GuideImagePresentationFullscreen">full screen</link> functions are also available.
    </para>
    <para/><section id="Navigation"><title>
      Navigation
    </title>
    <para>
      When the image window contains a list of images or is linked to a collection, the displayed image can be changed forward or backward in the list with the respective <ulink url="/wiki/PageDown">PageDown?</ulink> and <ulink url="/wiki/PageUp">PageUp?</ulink> keys. In addition, all navigation methods for the mouse and keyboard are similar to that of the image pane of a <link linkend="GuideMainWindowImagePane">Main Window</link>.
    </para>
    <para/></section><section id="Changingtheimage"><title>
      Changing the image
    </title>
    <para>
      To change the contents of an image window, drop the items onto the window with drag and drop. The dropped item can be one or more files, folders, or an image from a collection window:
    </para>
    <variablelist><varlistentry><term>
        One or more <emphasis role="strong">files</emphasis>
      </term><listitem><para>
        The image window will display the first image; the list of dropped images can be navigated similar to a main window's image pane.
      </para></listitem></varlistentry><varlistentry><term>
        One or more <emphasis role="strong">folders</emphasis>
      </term><listitem><para>
        When the dropped list of items includes a folder, a menu will appear allowing to skip the folders, add their contents, or add their contents recursively. After choosing from the menu the requested files will be added to the image window.
      </para></listitem></varlistentry><varlistentry><term>
        Image from a <emphasis role="strong">collection</emphasis>
      </term><listitem><para>
        The image window will change to display the image and become linked to the collection containing the image. Images in the collection can then be navigated and viewed from the image window.
      </para></listitem></varlistentry></variablelist>
    <para>
      Changing the image window by dropping a new item onto it will cause the previous list of images or linked collection to be discarded.
    </para>
    <para>
      To update the image display in the event that the source file has changed, press the R key.
    </para>
    <para/></section><section id="InformationandhistogramOverlay"><title>
      Information and histogram Overlay
    </title>
    <para>
      A small overlay can be turned on and off by pressing the I key. This overlay displays the image file name, dimensions, file date, and file size. The count of the current image and of all images contained by the window are also displayed in parenthesis. When the window is linked to a collection, the collection title will also appear in the overlay in italics above the file name.
    </para>
    <para>
      An histogram is displayed if I key is pressed twice, K key will modify the data displayed, and J key will toggle linear or logarithmic histogram.
    </para>
    <para>
      Overlay info is customizable through <link linkend="GuideOptionsAdvanced">Image Overlay Template?</link> option in Advanced tab in Preferences dialog.
    </para>
  <para/></section></section>