doc/main_window_menus.html

   1 <?xml version="1.0" encoding="iso-8859-1"?>
   2 <!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
   3     "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
   4
   5 <html xmlns="http://www.w3.org/1999/xhtml">
   6 <head>
   7   <meta http-equiv="CONTENT-TYPE" content="text/html; charset=iso-8859-1" />
   8
   9   <title>Menus - Geeqie User Manual</title>
  10   <meta name="CREATED" content="20040805;23590500" />
  11   <meta name="CHANGED" content="20050131;8375900" />
  12 <style type="text/css">
  13 /*<![CDATA[*/
  14  p.gq-menus-11 {margin-bottom: 0in}
  15  p.gq-menus-10 {font-weight: bold; text-align: center}
  16  p.gq-menus-9 {text-decoration: none}
  17  span.gq-menus-8 {text-decoration: none}
  18  p.gq-menus-7 {margin-left: 1.58in}
  19  p.gq-menus-6 {margin-left: 0.79in; font-weight: medium}
  20  p.gq-menus-5 {margin-left: 0.79in}
  21  div.gq-menus-4 {text-align: center}
  22  table.gq-menus-3 {page-break-before: always}
  23  p.gq-menus-2 {text-align: right}
  24  p.gq-menus-1 {text-align: center}
  25 /*]]>*/
  26 </style>
  27 </head>
  28
  29 <body lang="en-US" dir="ltr" xml:lang="en-US">
  30   <div class="gq-menus-4">
  31     <table width="100%" border="0" cellpadding="4" cellspacing="0" class="gq-menus-3">
  32       <col width="85*" />
  33       <col width="85*" />
  34       <col width="85*" />
  35
  36       <thead>
  37         <tr valign="top">
  38           <td width="33%">
  39             <p><a href="main_window_navigation.html">Previous</a>
  40             </p>
  41           </td>
  42
  43           <td width="33%">
  44             <p class="gq-menus-1">Menus &ndash; Main Window</p>
  45           </td>
  46
  47           <td width="33%">
  48             <p class="gq-menus-2"><a href="main_window_layout.html">Next</a>
  49             </p>
  50           </td>
  51         </tr>
  52       </thead>
  53     </table>
  54   </div>
  55
  56   <hr />
  57
  58   <h1>2.2 Menus</h1>
  59
  60   <p>This section describes the functions of each item on the menu bar in the Geeqie main window.</p>
  61
  62   <p><br />
  63   <br />
  64   </p>
  65
  66   <p><u>File Menu</u>
  67   </p>
  68
  69   <p class="gq-menus-5"><b>New window</b>: Opens a new main window, with the initial path set to the current folder.</p>
  70
  71   <p class="gq-menus-6"><b>New collection</b>: Opens a new collection window, the new collection will be empty.</p>
  72
  73   <p class="gq-menus-6"><b>Open collection</b>: Displays a dialog to open a collection stored on disk, the selected collection will then appear in a new window.</p>
  74
  75   <p class="gq-menus-5"><b>Open recent</b>: This menu item lists the recently active collections, selecting an item from the list will open that collection in a new window. The most recent item will appear at the top of the list.</p>
  76
  77   <p class="gq-menus-6"><b>Search...</b>: Opens a new Search window.</p>
  78
  79   <p class="gq-menus-6"><b>Find duplicates...</b>: Opens a new Find Duplicates window.</p>
  80
  81   <p class="gq-menus-6"><b>Print..</b>: Opens a print dialog.</p>
  82
  83   <p class="gq-menus-5"><b>New folder...</b>: Creates a new folder in the current path.</p>
  84
  85   <p class="gq-menus-6"><b>Copy...</b>: Opens a dialog to select a destination to copy the currently selected files.</p>
  86
  87   <p class="gq-menus-6"><b>Move...</b>: Opens a dialog to select a destination to move currently selected files.</p>
  88
  89   <p class="gq-menus-5"><b>Rename...</b>: Renames the current file selection.</p>
  90
  91   <p class="gq-menus-5"><b>Delete...</b>: Deletes the current file selection.</p>
  92
  93   <p class="gq-menus-5"><b>Close window</b>: Closes the window containing the menu, if the window is the last main window Geeqie will quit.</p>
  94
  95   <p class="gq-menus-5"><b>Quit</b>: Quits the Geeqie application, if collections have been changed but not saved, the user will be prompted for confirmation.</p>
  96
  97   <p><u>Edit menu</u>
  98   </p>
  99
 100   <p class="gq-menus-5"><b>in &lt;command name&gt;...</b>: This will execute the external command associated with &lt;command name&gt;, these can be changed edited on the <a href="options_editor_commands.html">Editors tab</a> of the Option dialog.</p>
 101
 102   <p class="gq-menus-5"><b>Adjust</b> sub menu:</p>
 103
 104   <p class="gq-menus-7"><b>Rotate clockwise</b>: Rotates the current image clockwise 90 degrees, does not effect the file on disk.</p>
 105
 106   <p class="gq-menus-7"><b>Rotate counterclockwise</b>: Rotates the current image counterclockwise 90 degrees, does not effect the file on disk.</p>
 107
 108   <p class="gq-menus-7"><b>Rotate 180</b>: Rotates the current image 180 degrees, does not effect the file on disk.</p>
 109
 110   <p class="gq-menus-7"><b>Mirror</b>: Swaps the left and right sides of the image so that the result is similar to that of looking at the image in a mirror, does not effect the file on disk.</p>
 111
 112   <p class="gq-menus-7"><b>Flip</b>: Swaps the top and bottom sides of the image, does not effect the file on disk.</p>
 113
 114   <p class="gq-menus-5"><b>Properties</b>: Opens a Properties Window for the currently selected files.</p>
 115
 116   <p class="gq-menus-5"><b>Select all</b>: Selects all files displayed in the file list.</p>
 117
 118   <p class="gq-menus-5"><b>Select none</b>: Clears the current file selection.</p>
 119
 120   <p class="gq-menus-5"><b>Preferences...</b>: Opens the <a href="options.html">Preferences Dialog</a> for changing of user preferences.</p>
 121
 122   <p class="gq-menus-5"><b>Thumbnail maintenance</b>: Opens a dialog with utilities to manage cached thumbnails and keywords data.</p>
 123
 124   <p class="gq-menus-5"><b>Set as wallpaper</b>: Renders the current image to the root window (desktop). The resulting image will be tiled to fit the root window if zoom is not set to <u>fit to window</u>; when zoom is set to <u>fit to window</u>, the image will be scaled to fill the root window.</p>
 125
 126   <p><u>View menu</u>
 127   </p>
 128
 129   <p class="gq-menus-5"><b>Zoom in</b>: Increases the zoom by one increment, resulting in a larger image.</p>
 130
 131   <p class="gq-menus-5"><b>Zoom out</b>: Decreases the zoom by one increment, resulting in a smaller image.</p>
 132
 133   <p class="gq-menus-5"><b>Zoom 1:1</b>: Resets the zoom to the original size of the image.</p>
 134
 135   <p class="gq-menus-5"><b>Zoom to fit</b>: Automatically adjusts the zoom so that the image will fit within the display pane. The effect on images with an original size smaller than the display pane can be changed with the <u>Allow enlargement of image for zoom to fit</u> <span class="gq-menus-8">option located on the <a href="options_image.html">Image tab</a> of the preferences dialog</span>.</p>
 136
 137   <p class="gq-menus-5"><b>Thumbnails</b>: Toggles the display of image thumbnails in the file list, this item is not available when the file list is in icon view mode. A check appears next to this item when thumbnails are enabled.</p>
 138
 139   <p class="gq-menus-5"><b>List</b>: Changes the file list to display files in list format.</p>
 140
 141   <p class="gq-menus-5"><b>Icons</b>: Changes the file list to display files as icons.</p>
 142
 143   <p class="gq-menus-5"><b>Tree</b>: Toggles the folder list between simple and tree modes. A check appears next to this item when the folder is in tree mode.</p>
 144
 145   <p class="gq-menus-5"><b>Full screen</b>: Toggles the full screen window display.</p>
 146
 147   <p class="gq-menus-5"><b>Float file list</b>: Toggles the location of the menu bar, tool bar, status bar, and file lists between the main window and a second window. A check appears next to this item when the location is the second window.</p>
 148
 149   <p class="gq-menus-5"><b>Hide file list</b>: Toggles visibility of the menu bar, tool bar, status bar, and file lists.</p>
 150
 151   <p class="gq-menus-5"><b>Hide toolbar</b>: Toggles visibility of the tool bar. A check appears next to this item when the tool bar is not visible.</p>
 152
 153   <p class="gq-menus-5"><b>Keywords</b>: Toggles display of the Keywords sidebar.</p>
 154
 155   <p class="gq-menus-5"><b>Exif data</b>: Toggles display of the EXIF sidebar.</p>
 156
 157   <p class="gq-menus-5"><b>Sort manager</b>: Toggles display of the Sort Manager sidebar.</p>
 158
 159   <p class="gq-menus-5"><b>Toggle slideshow</b>: Begins or ends a slide show, the slide show status is displayed in the status bar.</p>
 160
 161   <p class="gq-menus-5"><b>Refresh</b>: Updates the contents of the folder and file lists to match what is currently on disk, the current image will also be reread from disk.</p>
 162
 163   <p><u>Help menu</u>
 164   </p>
 165
 166   <p class="gq-menus-5"><b>Contents</b>: Open the Geeqie user manual in a new browser window.</p>
 167
 168   <p class="gq-menus-5"><b>Keyboard shortcuts</b>: Displays a window listing the default keyboard shortcuts.</p>
 169
 170   <p class="gq-menus-5"><b>Release notes</b>: Displays a window containing the release notes for the version of Geeqie in use.</p>
 171
 172   <p class="gq-menus-5"><b>About</b>: Opens a window containing the Geeqie version, credits, website, and email contact information.</p>
 173
 174   <p><br />
 175   <br />
 176   </p>
 177
 178   <p><u>Tear off menus</u>
 179   </p>
 180
 181   <p>Menus can be permanently displayed by selecting the dotted line item at the top of each menu category. A tear off menu will behave the same as an ordinary window. To close a tear off menu, select the dotted line item at the top of the menu.</p>
 182
 183   <p><br />
 184   <br />
 185   </p>
 186
 187   <p><u>Keyboard shortcuts</u>
 188   </p>
 189
 190   <p>The keyboard sequence associated to each menu entry is listed within the main window menu bar. For reference, the complete list of default keyboard shortcuts can be found in section <a href="reference_keyboard_shortcuts.html">11.2 Keyboard Shortcuts</a>.</p>
 191
 192   <p><br />
 193   <br />
 194   </p>
 195
 196   <p><u>Changing the main window menu bar keyboard shortcuts</u>
 197   </p>
 198
 199   <p class="gq-menus-9">The keyboard shortcuts associated with the menu bar items can be changed by editing the accels file located in the Geeqie configuration folder <b>while the Geeqie application is not running</b>:</p>
 200
 201   <p class="gq-menus-5"><code><span class="gq-menus-8">($HOME)/.geeqie/accels</span></code>
 202   </p>
 203
 204   <p><span class="gq-menus-8">To change a menu item, first find the line corresponding to the menu item</span> to change. For example the File menu Quit line originally looks like this:</p>
 205
 206   <p class="gq-menus-5"><code><span class="gq-menus-8">; (gtk_accel_path "&lt;main&gt;/File/Quit" "&lt;Control&gt;q")</span></code>
 207   </p>
 208
 209   <p class="gq-menus-9">To change this menu's keyboard shortcut, first remove the leading semicolon (;), removing the semicolon will tell Geeqie that this menu item has been customized. Then change the keyboard shortcut defined by the text in quotes at the end of the line, be sure to only change the text within the quotes; in this case the text &ldquo;&lt;control&gt;q&rdquo;. For example changing the shortcut associated with Quit to the Q key will result in this line:</p>
 210
 211   <p class="gq-menus-5"><code><span class="gq-menus-8">(gtk_accel_path "&lt;main&gt;/File/Quit" "q")</span></code>
 212   </p>
 213
 214   <p class="gq-menus-9">Please note the removed semicolon and the change of &ldquo;&lt;control&gt;q&rdquo; to &ldquo;q&rdquo;, be careful not to change any of the other text on the line or Geeqie may ignore the customization. The keyboard modifiers and their respective text are listed below:</p>
 215
 216   <dl>
 217     <dd>
 218       <dl>
 219         <dd>
 220           <table width="60%" border="0" cellpadding="4" cellspacing="0">
 221             <col width="128*" />
 222             <col width="128*" />
 223
 224             <tr valign="top">
 225               <td width="50%">
 226                 <p class="gq-menus-10">Key</p>
 227               </td>
 228
 229               <td width="50%">
 230                 <p class="gq-menus-10">Text to use in accels file</p>
 231               </td>
 232             </tr>
 233
 234             <tr valign="top">
 235               <td width="50%">
 236                 <p class="gq-menus-1">[Shift]</p>
 237               </td>
 238
 239               <td width="50%">
 240                 <p class="gq-menus-1">&lt;shift&gt;</p>
 241               </td>
 242             </tr>
 243
 244             <tr valign="top">
 245               <td width="50%">
 246                 <p class="gq-menus-1">[Control]</p>
 247               </td>
 248
 249               <td width="50%">
 250                 <p class="gq-menus-1">&lt;control&gt;</p>
 251               </td>
 252             </tr>
 253
 254             <tr valign="top">
 255               <td width="50%">
 256                 <p class="gq-menus-1">[Alt]</p>
 257               </td>
 258
 259               <td width="50%">
 260                 <p class="gq-menus-1">&lt;alt&gt;</p>
 261               </td>
 262             </tr>
 263           </table>
 264         </dd>
 265       </dl>
 266     </dd>
 267   </dl>
 268
 269   <p><br />
 270   <br />
 271   </p>
 272
 273   <p>Modifiers can be combined, for example in the exit line above, the text would be &ldquo;&lt;control&gt;&lt;shift&gt;q&rdquo; to set the exit shortcut to [Control] + [Shift] + Q.</p>
 274
 275   <p><br />
 276   <br />
 277   </p>
 278
 279   <p><br />
 280   <br />
 281   </p>
 282
 283   <hr />
 284
 285   <div class="gq-menus-4">
 286     <table width="100%" border="0" cellpadding="4" cellspacing="0">
 287       <col width="85*" />
 288       <col width="85*" />
 289       <col width="85*" />
 290
 291       <thead>
 292         <tr valign="top">
 293           <td width="33%">
 294             <p><a href="main_window_navigation.html">Previous</a>
 295             </p>
 296           </td>
 297
 298           <td width="33%">
 299             <p class="gq-menus-1"><a href="index.html">Contents</a>
 300             </p>
 301           </td>
 302
 303           <td width="33%">
 304             <p class="gq-menus-2"><a href="main_window_layout.html">Next</a>
 305             </p>
 306           </td>
 307         </tr>
 308       </thead>
 309
 310       <tbody>
 311         <tr valign="top">
 312           <td width="33%">
 313             <p><br />
 314             </p>
 315           </td>
 316
 317           <td width="33%">
 318             <p class="gq-menus-1"><br />
 319             </p>
 320           </td>
 321
 322           <td width="33%">
 323             <p class="gq-menus-2">Geeqie User Manual</p>
 324           </td>
 325         </tr>
 326       </tbody>
 327     </table>
 328   </div>
 329
 330   <p class="gq-menus-11"><br />
 331   </p>
 332 </body>
 333 </html>