Simplify util_clip_region()
[geeqie.git] / doc / docbook / GuideOtherWindowsImageWindow.xml
1 <?xml version="1.0" encoding="utf-8"?>\r
2 <section id="GuideOtherWindowsImageWindow">\r
3   <title>Image Window</title>\r
4   <para>An image window is a window that displays only the image, without menus or sidebars.</para>\r
5   <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>\r
6   <para>\r
7     The image pane contained in an image window behaves and operates similar to the\r
8     <link linkend="GuideMainWindowImagePane" endterm="titleGuideMainWindowImagePane" />\r
9     of a Main Window, including the\r
10     <link linkend="InformationandhistogramOverlay" endterm="titleInformationandhistogramOverlay" />\r
11     . The keyboard shortcuts are the same, and the context menu is the same except\r
12     <emphasis>Hide file list</emphasis>\r
13     is replaced by\r
14     <emphasis>Close window</emphasis>\r
15     . The\r
16     <link linkend="GuideImagePresentationSlideshow">slide show</link>\r
17     and\r
18     <link linkend="GuideImagePresentationFullscreen">full screen</link>\r
19     functions are also available.\r
20   </para>\r
21   <para />\r
22   <section id="Navigation">\r
23     <title>Navigation</title>\r
24     <para>\r
25       When the image window is initiated from an image selection or from a collection window, the displayed image can be changed forward or backward in the list with the respective\r
26       <keycap>PageDown</keycap>\r
27       and\r
28       <keycap>PageUp</keycap>\r
29       keys. In addition, all navigation methods for the mouse and keyboard are similar to that of the\r
30       <link linkend="GuideMainWindowImagePane" endterm="titleGuideMainWindowImagePane" />\r
31       of a Main Window.\r
32     </para>\r
33     <para />\r
34   </section>\r
35   <section id="ImageWindowDragandDrop">\r
36     <title id="titleImageWindowDragandDrop">Drag and Drop</title>\r
37     <para>\r
38       Images can be dragged and dropped onto an image window, but the process is somewhat different to that of an\r
39       <link linkend="GuideMainWindowImagePane" endterm="titleGuideMainWindowImagePane" />\r
40       . If multiple images, a folder or an image from a collection window is dropped onto the image window, you can cycle through all these images using the navigation keys.\r
41     </para>\r
42     <para>The dropped item can be one or more files, folders, or an image from a collection window:</para>\r
43     <variablelist>\r
44       <varlistentry>\r
45         <term>\r
46           <guilabel>One or more files</guilabel>\r
47         </term>\r
48         <listitem>\r
49           <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>\r
50         </listitem>\r
51       </varlistentry>\r
52       <varlistentry>\r
53         <term>\r
54           <guilabel>One or more folders</guilabel>\r
55         </term>\r
56         <listitem>\r
57           <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>\r
58         </listitem>\r
59       </varlistentry>\r
60       <varlistentry>\r
61         <term>\r
62           <guilabel>Image from a collection</guilabel>\r
63         </term>\r
64         <listitem>\r
65           <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>\r
66         </listitem>\r
67       </varlistentry>\r
68     </variablelist>\r
69     <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>\r
70     <para>\r
71       To update the image display in the event that the source file has changed, press\r
72       <keycap>R</keycap>\r
73       .\r
74     </para>\r
75     <para />\r
76   </section>\r
77 </section>\r